Function
To route normal output for a job
at another node to an alternate location.
Syntax
>>-$G--R--+---------+--,OUT--,'jobname'--+-,J--|--JOB--n-+------>
+-N--nnnn-+ +-,S--|--STC--n-+
+-name----+ '-,T--|--TSU--n-'
'-destid--'
>--,O=--+-LOCAL--|--ANYLOCAL---+-------------------------------->
+-N--nnnn--|--nodename-+
'-destid---------------'
>--,D=--+-LOCAL--|--ANYLOCAL---+-------------------------------->
+-N--nnnn--|--nodename-+
+-destid---------------+
+-N--nnnn--.--R--mmmm--+
+-U--mmmm--------------+
'-node--.--remote------'
>--,R=--+-R--nnnn--|--nodename-+-------------------------------><
'-destid---------------'
Parameters
- D=
- Specifies
a destination for a piece of output. Indicates that output sent to
the specified destinations can be selected. The value for all routing
numbers can range from 1 to 32767. Use parentheses if more than one
route code is specified. For specification requirements, see Route codes.
- LOCAL|ANYLOCAL
- Indicates that jobs are to be run at the local node.
- Nnnnn|nodename
- Indicates that jobs are to be run at the specified node(s). You
can specify a node using the decimal node identifier or an EBCDIC
nodename.
- destid
- Indicates that jobs are to be run at the specified node(s). You
can specify this location by an alias for the name of a node. If destid
is specified alone, it refers to both the node and the remote.
- NnnnnRmmmm|node.remote
- Indicates routing to the remote Rmmmm at the node Nnnnn. Rmmmm
can also be specified as RMmmmm or RMTmmmm.
- Ummmm
- Indicates special local routing.
- node.destid
- Indicates a destination at the specified node. The destid refers
to both the node and the remote. The node specified in the destid
must be the same as the node portion of the route code. If the number
of the remote is reassigned, you can use the destid to send to this
node.
- remote
- Indicates routing to a remote. Remote can be specified in any
of the following ways:
- LOCAL|ANYLOCAL
- Indicates that jobs are to be run at the local node.
- Rmmmm
- Indicates routing to the specified remote. Rmmmm can also be
specified as RMmmmm or RMTmmmm.
- destid
- Indicates routing to a destid referring to a remote.
For more information about specifying userids
as remotes, refer to Route codes.
If you specify Nnnnn[Rnnnn], Nnnnn is converted
to an 8-byte EBCDIC node name and, optionally, Rnnnn is right-padded
with blanks to create an 8-byte EBCDIC remote name (it is overridden
by the R= parameter, if specified). This destination name is placed
in the global route command record for the receiving node.
If
you specify an installation-defined name for a destination, the name
is right-padded with blanks and then placed in the global route command
record for the receiving node. The symbolic destination names are
validated and converted to internal route codes at the receiving node,
not the node at which the $G R command is entered.
- J|JOBn or S|STCn or T|TSUn
- The job ID (batch job (Jn), started task
(Sn), or time-sharing user (Tn)) assigned to the job by its originating
node. This operand is necessary only if more than one job exists
with the specified job name.
- ‘jobname'
- The
name of the job for which output is rerouted. The name must appear
as coded on the JOB statement and must be enclosed in apostrophes.
If the job did not originate at the sending node (or have default
print and/or punch output for the sending node), the destination node
must have the sending node flagged as having network authority.
- Nnnnn|name|destid
- The destination node to which JES2 sends this command. You can
specify this location through an alias for the name of a node. The
destination node must have the sending node flagged as having job
authority.
- O=
- The node
on which the job originated. You must specify this parameter if the
originating node is not the node at which this $G R command is entered.
If you fail to identify the originating node, JES2 issues the $HASP693
message which indicates the job was not found. In addition, the originating
node must have authorized this node for network commands or the $HASP693
message will be issued. For more information about authorizing nodes,
refer to the $T NODE command. The valid specifications:
- LOCAL|ANYLOCAL
- Indicates that jobs are to be run at the local node.
- Nnnnn|nodename
- Indicates that jobs are to be run at the specified node(s). You
can specify a node using a decimal node identifier from 1 to 32767
or an EBCDIC nodename.
- destid
- Indicates that jobs are to be run at the specified node(s). You
can specify this location by an alias for the name of a node.
Note: This parameter requires that the
destination node has the sending node flagged as having network authority.
- OUT
- Job output
is rerouted.
- R=Rnnnn|nodename|destid
- If you
specified a symbolic name for a node on the D= parameter, this parameter
allows you to specify a remote destination off that node. Whatever
is entered is right-padded with blanks to create an 8-byte EBCDIC
remote name, that is placed in the global route command record. Validation
and conversion to a remote destination route code is performed at
the receiving node.
Note: This parameter overrides a remote specification
on the D= parameter.
Processing Considerations
- The receiving node ignores the $G R command if the specified job
is currently being received on a reader, being received or transmitted
on an NJE or RJE line, or if its output is TSO held output.
- If you do not know the job ID of the job with this jobname, use
the $G D command to display the job IDs of all jobs with this jobname
at a specific node.
- The $T NODE,Auth= command sets the command authority for a specified
node.
Scope
Network-wide. This command
only needs to be issued from a single member; the command has an effect
across the entire MAS.
Messages
The $HASP000 message indicates
the command was accepted.
Examples
1 $g r n4,out,'myjob',d=n3r1
$HASP000 OK
JES2 sends a global route command record through the network
to node 4. Node 4 routes all normal output for the job named MYJOB
to node 3 remote workstation 1.
2 $g r denver,out,'joba', d=newyork, r=broadway
$HASP000 OK
JES2 sends a global route command record through the network
to the node named DENVER. That node routes all normal output for
the job named JOBA to the remote workstation with the installation-defined
name BROADWAY on the node with the installation-defined name NEWYORK.