$R

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 will note that.

Syntax


>>-$R--+-ALL--+----------------+-+------------------------------>
       |      |      .-------. | |   
       |      |      V       | | |   
       |      '-,Q=----class-+-' |   
       +-PRT---------------------+   
       '-PUN---------------------'   

>--+-,J=--+-J--|--JOB--n-+---------+---------------------------->
   |      +-S--|--STC--n-+         |   
   |      +-T--|--TSU--n-+         |   
   |      '-'jobname'----'         |   
   '-,R=--+----------------------+-'   
          +-LOCAL--|--ANYLOCAL---+     
          +-N--nnnn--|--nodename-+     
          +-destid---------------+     
          +-N--nnnn--R--mmmm-----+     
          +-U--mmmm--------------+     
          +-node--.--remote------+     
          +-node--.--destid------+     
          +-node--.--*-----------+     
          +-*--------------------+     
          +-remote---------------+     
          '-userid---------------'     

>--,D=--+-LOCAL--|--ANYLOCAL---+-------------------------------->
        +-N--nnnn--|--nodename-+   
        +-destid---------------+   
        +-N--nnnn--R--mmmm-----+   
        +-U--mmmm--------------+   
        +-node--.--remote------+   
        +-node--.--destid------+   
        +-node--.--*-----------+   
        +-*--------------------+   
        +-remote---------------+   
        '-userid---------------'   

>--+--------------------------------+--------------------------><
   '-,OUTD--isp=--(--outdisp,--…--)-'

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 the class(es) (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.

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 (in conjunction 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 will default 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 will resolve 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 the specified node(s). You can specify a node using the decimal node identifier or an EBCDIC nodename.

destid

Indicates that jobs are routed to 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.

node.*

Indicates that all output destined for the specified node, including userids, 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 will cause 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 (in conjunction 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 will default 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 will resolve 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.

For valid specifications, see the list for the R= parameter.

Note:

NODENAME=REQUIRED on the DESTDEF initialization statement will cause 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 will begin 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 will be 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, SA32-0991.

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 will change 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 will be 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) will be 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

JES2 reroutes output for batch job 3 to remote workstation 6 off the local node. JES2 transfers the job's default routing to remote workstation 6. Refer to Processing Considerations above for more details.

 2   $r all,r=r3,d=r6

  $HASP000 OK

JES2 reroutes output for remote workstation 3 to remote workstation 6 off the local node. If the job's default print and/or punch is remote workstation 3, JES2 transfers the job's default print and/or punch routing to remote workstation 6. Refer to Processing Considerations above for more details.

 3   $r all,r=r6,d=n3r1,q=a

  $HASP000 OK

JES2 reroutes all class A routed output destined for remote workstation 6 to node 3 remote workstation 1. The job's command authority is unchanged.

 4   $r all,r=local,outdisp=(w,k),d=n2

  $HASP000 OK

JES2 reroutes all ready local output to node 2. The job's command authority is unchanged.

 5   $r all,j=j894,outd=(h,l),d=r3

  $HASP000 OK

JES2 reroutes all held output for job number 894 to remote 3. The job's command authority is unchanged.

 6   $r all,r=n3.*,d=n5.*

  $HASP000 OK

JES2 reroutes all output for node N3 to node N5. At N5, the output retains the original remote specification.

 7   $r all,r=n3,d=n5

  $HASP000 OK

JES2 reroutes all local output for node N3 to node N5. At N5, the output will be LOCAL.

 8   $r all,r=n3.*,d=n5r6

  $HASP000 OK

JES2 reroutes all output for node N3 to node 5, remote workstation 6.