$R XEQ

Function

To route the specified job(s) to another node for execution.

Syntax


>>-$R--XEQ--+-,J=--+-J--|--JOB--n-+---------+------------------->
            |      '-'jobname'----'         |   
            '-,R=--+-LOCAL--|--ANYLOCAL---+-'   
                   +-N--nnnn--|--nodename-+     
                   '-destid---------------'     

>--,D=--+-LOCAL--|--ANYLOCAL---+-------------------------------><
        +-N--nnnn--|--nodename-+   
        '-destid---------------'

Parameters

D=

The new execution node for the specified job(s). All specifications for the R= parameter are valid.

J=J|JOBn|‘jobname'

The job ID (Jn) or name (‘jobname') of the batch job that is routed for execution. If you specify ‘jobname', it 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.

R=

All jobs in the system that are supposed to execute on the specified node are routed to the node specified in the D= parameter for execution.

The following specifications are valid:

LOCAL|ANYLOCAL: Indicates that only jobs routed to the local node for execution can be selected.
Nnnnn|nodename: Indicates that only jobs routed to the specified location through a decimal node identifier from 1 to 32767 or an EBCDIC nodename can be selected for execution.
destid: Indicates that only jobs routed to the specified location through an alias for the name of a node can be selected for execution.

XEQ

JES2 routes the specified job(s) to the D= location for execution.

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

To be routed by this command, a job must be owned by the input console and must be on the queue awaiting either conversion, execution, or transmission to another node.
You cannot route remote message data sets, a special type of STC, with the $R command.

Scope

MAS-wide. This command has an effect across the entire MAS.

Messages

The $HASP000 message indicates the command was accepted.

Examples

 1     $r xeq,j='myjob',d=denver

       $HASP000 OK

JES2 routes the job named MYJOB to the node named DENVER for execution.

 2     $r xeq,r=n3,d=n4

       $HASP000 OK

JES2 routes all jobs in the local system currently scheduled to execute on node 3 to node 4 for execution.