ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaks_5.4.0.1/rzaksaboutroutingentries.htm

96 lines
7.7 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Routing entries" />
<meta name="abstract" content="The routing entry identifies the main storage subsystem pool to use, the controlling program to run (typically the system-supplied program QCMD), and additional run-time information (stored in the class object). Routing entries are stored in the subsystem description." />
<meta name="description" content="The routing entry identifies the main storage subsystem pool to use, the controlling program to run (typically the system-supplied program QCMD), and additional run-time information (stored in the class object). Routing entries are stored in the subsystem description." />
<meta name="DC.Relation" scheme="URI" content="rzakssbsd.htm" />
<meta name="DC.Relation" scheme="URI" content="rzaksrtentryclass.htm" />
<meta name="DC.Relation" scheme="URI" content="rzaksroutentrycompare.htm" />
<meta name="DC.Relation" scheme="URI" content="rzaksrtentrymaxact.htm" />
<meta name="DC.Relation" scheme="URI" content="rzaksrtentrymempool.htm" />
<meta name="DC.Relation" scheme="URI" content="rzaksaddroutentry.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakschgroutentry.htm" />
<meta name="DC.Relation" scheme="URI" content="rzaksrmvertngentry.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2004-2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004-2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzaksaboutroutingentries" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Routing entries</title>
</head>
<body id="rzaksaboutroutingentries"><a name="rzaksaboutroutingentries"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Routing entries</h1>
<div><p>The routing entry identifies the main storage subsystem pool to
use, the controlling program to run (typically the system-supplied program
QCMD), and additional run-time information (stored in the class object). Routing
entries are stored in the subsystem description.</p>
<p>A routing entry can be likened to a single entry in a shopping mall directory.
Customers that cannot find the store they need may use a directory to help
send them in the right direction. The same is true on the iSeries™ system.
Routing entries guide the job to the correct place. Routing entries in a subsystem
description specify the program to be called to control a routing step for
a job running in the subsystem, which memory pool the job will use, and from
which class to get the run-time attributes. Routing data identifies a routing
entry for the job to use. Together, routing entries and routing data provide
information about starting a job in a subsystem. </p>
<p>Routing entries consist of these parts; the subsystem description,
class, comparison data, maximum active routing steps, memory pool ID, program
to call, thread resources affinity, resources affinity group, and the sequence
number. </p>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="rzaksrtentryclass.htm">Class</a></strong><br />
Job run-time attributes are contained in the class object that
is specified in the (<span class="parmname">CLS</span>) parameter in the routing entry.
If a job consists of multiple routing steps, the class used by each subsequent
routing step is specified in the routing entry used to start the routing step.
If the class does not exist when the routing entry is added, a library qualifier
must be specified because the qualified class name is kept in the subsystem
description.</li>
<li class="ulchildlink"><strong><a href="rzaksroutentrycompare.htm">Comparison data</a></strong><br />
The comparison value (<span class="parmname">CMPVAL</span>) parameter of
the routing entry specifies data that is compared with routing data to determine
which routing entry to use. (The routing entry also specifies the starting
position for the comparison.) The routing data is compared with the comparison
value of each routing entry in sequence number order until a match is found.
The sequence number contained in a routing entry defines the order in which
the routing entries are scanned and can be used as the identifier of the routing
entry. </li>
<li class="ulchildlink"><strong><a href="rzaksrtentrymaxact.htm">Maximum active routing steps</a></strong><br />
The maximum active routing steps <span class="parmname">(MAXACT) </span>parameter
of the routing entry specifies the maximum number of routing steps (jobs)
that can be active at the same time through this routing entry. </li>
<li class="ulchildlink"><strong><a href="rzaksrtentrymempool.htm">Memory pool ID</a></strong><br />
The memory pool ID (<span class="parmname">POOLID</span>) parameter of the
routing entry specifies the pool identifier of the storage pool in which the
program runs. The pool identifier specified here relates to the storage pools
in the subsystem description. </li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakssbsd.htm" title="A subsystem description is a system object that contains information defining the characteristics of an operating environment controlled by the system. The system-recognized identifier for the object type is *SBSD. A subsystem description defines how, where, and how much work enters a subsystem, and which resources the subsystem uses to perform the work. An active subsystem takes on the simple name of the subsystem description.">Subsystem description</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="rzaksaddroutentry.htm" title="Each routing entry specifies the parameters used to start a routing step for a job. Routing entries identify the main storage subsystem pool to use, the controlling program to run (typically the system-supplied program QCMD), and additional run-time information (stored in the class object). To add a routing entry to a subsystem description, use the character-based interface.">Add routing entries</a></div>
<div><a href="rzakschgroutentry.htm" title="You can change a routing entry in the specified subsystem description by using the character-based interface. The routing entry specifies the parameters used to start a routing step for a job. The associated subsystem can be active when the changes are made.">Change routing entries</a></div>
<div><a href="rzaksrmvertngentry.htm" title="You can remove a routing entry from the specified subsystem description by using the character-based interface. The subsystem can be active at the time the command is run. However, the routing entry cannot be removed if there are any currently active jobs that were started using the entry.">Remove routing entries</a></div>
</div>
</div>
</body>
</html>