$R - Route job output
Function
To reroute SYSOUT that is on the output queue. This affects both ready and held SYSOUT.
One or more parameters on this command accepts wildcards. Parameter descriptions note that.
Syntax
Parameters
- ALL
- Specifies both print and punch output that is rerouted.
- PRT
- Specifies print output that is rerouted.
- PUN
- Specifies punch output that is rerouted.
- Q=c1[...c36]
- Specifies one or more classes (A-Z and 0-9) of output that is rerouted. You can specify a maximum of thirty-six classes. This parameter is valid only when ALL is specified.
- J=
- Specifies jobs for which output is rerouted.
- G|JOBGROUPn
- Specifies the batch jobgroup for which output is rerouted.
- J|JOBn
- Specifies the batch job for which output is rerouted.
- S|STCn
- Specifies the started task for which output is rerouted.
- T|TSUn
- Specifies the time-sharing user for which output is rerouted.
- ‘jobname'
- Specifies 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 more than one job exists with this name, no action is taken.
Note: If you do not code ALL,Q= or OUTDISP= with the J= parameter (along with the D= parameter), both the routing for that job's output and the command authority are transferred. - R=
- Specifies the current destination for output
that is rerouted. For routing specification requirements, see Route codes.
You can also specify wildcards on this parameter. See Using wildcards for additional information. For specification requirements, see Route codes.
If this command originates from another node in the network and the R= operand does not specify a node (first-level destination), the receiving node defaults the first-level destination to the node where the command originated.
If this command is sent to another node in the network using the $N command, be aware that the receiving node defaults the node (first-level destination) of the R= operand to the sending node. If another node is desired, specify a destination on the R= operand that resolves to the desired node (first-level destination) at the receiving node.- LOCAL|ANYLOCAL
- Indicates that jobs are routed to the local node.
- Nnnnn|nodename
- Indicates that jobs are routed to one or more specified nodes. You can specify a node using the decimal node identifier or an EBCDIC nodename.
- destid
- Indicates that jobs are routed to one or more specified nodes. 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 that is 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.
- node.*
- Indicates that all output destined for the specified node, including user IDs, special local, remotes, and destids, is rerouted.
- *
- Indicates that all output for the local node, including special local, userid, and a remote workstation are on the local 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.
- userid
- Indicates that output is destined to a valid TSO userid. If the userid ends in *, all output with userids beginning with any characters that precede the * will be rerouted. See Route codes for a description of how to specify a userid.
Note:- NODENAME=REQUIRED on the DESTDEF initialization statement causes JES2 to require that a userid be prefixed with a node name.
- If you do not code ALL,Q= or OUTDISP= with the R= parameter (along with the D= parameter), both the routing for that job's output and the command authority are transferred.
- D=
- Specifies the new destination to
which currently existing output is routed. This does not apply to output groups not yet created.
If this command originates from another node in the network and the D= operand does not specify a node (first-level destination), the receiving node defaults the first-level destination to the node where the command originated.
If this command is sent to another node in the network using the $N command, be aware that the receiving node defaults the node (first-level destination) of the D= operand to the sending node. If another node is desired, specify a destination on the D= operand that resolves to the desired node (first-level destination) at the receiving node.- *
- Indicates that all output for the local node, including special local, userid, and a remote workstation are on the local node.
Note:- NODENAME=REQUIRED on the DESTDEF initialization statement causes JES2 to require that a userid be prefixed with a node name.
- If an output group is interrupted while printing and the destination is changed, the output group begins printing from the top when it is printed at the new destination.
- OUTDisp=outdisp
- Specifies the disposition of output to be
rerouted. The valid output dispositions are W|WRITE, H|HOLD, K|KEEP, and
L|LEAVE. You can specify as many as four dispositions. Note: If you do not specify this parameter, all output with a disposition of WRITE, HOLD, KEEP, or LEAVE is rerouted.
For further information about this parameter, see Processing Considerations in this command.
Authority Required
This command requires job authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.
This command requires update security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.
Processing Considerations
- The $R command changes a job's output. This command does not apply to jobs on the input, SYSOUT
receiver, or purge queue since output has not been created. It changes only the destination of data
sets that have already been spun for a job in execution. The remote(s) or node(s) that can issue
commands that affect this job is updated by the $R command unless:
- You specify the Q= or the OUTDisp= parameter.
- If you specify the R= parameter and it does not match the job's current command authority.
- If you enter this command and the job output element is being processed, wait and reissue the command again.
- All output (held and non-held) is sent to the new network destination as soon as the $R command has been processed.
Scope
MAS-wide. This command has an effect across the entire MAS.
Messages
The $HASP000 message indicates the command was accepted.
Examples
1 $r all,j=j3,d=r6
$HASP000 OK
2 $r all,r=r3,d=r6
$HASP000 OK
3 $r all,r=r6,d=n3r1,q=a
$HASP000 OK
4 $r all,r=local,outdisp=(w,k),d=n2
$HASP000 OK
5 $r all,j=j894,outd=(h,l),d=r3
$HASP000 OK
6 $r all,r=n3.*,d=n5.*
$HASP000 OK
7 $r all,r=n3,d=n5
$HASP000 OK
8 $r all,r=n3.*,d=n5r6
$HASP000 OK
JES2 reroutes all output for node N3 to node 5, remote workstation 6.