Rerouting network jobs to another destination *CALL,NJEROUT

Function

Use the NJE reroute DSP (NJEROUT) to reroute a network job to a remote location or back to its original destination. You can also reroute the output to a different VM userid or RJP workstation. The NJEROUT DSP is valid for rerouting work to both BSC/NJE, SNA/NJE, and TCP/IP/NJE nodes.

The NJEROUT DSP allows you to reroute:

A job that was sent to your node from a remote node
A job that was submitted locally
SYSOUT streams that are being routed through your node
SYSOUT streams (from JES3 jobs run at your node) that were originally destined for a remote node

Syntax


>>-+-*CALL-+--,--NJEROUT---------------------------------------->
   '-*X----'               

>--+-----------------------------------------------------------------------------------------------------------------+-->
   |                          .-,--Q--=--ALL-.                                                                       |   
   '-+-,--FDEST--=--nodename--+--------------+---------+--+--------------------------------------------------------+-'   
     |                        '-,--Q--=--SNA-'         |  '-,--TO--=--+-+-nodename-+--+------------------------+-+-'     
     |                       .-,--Q--=--ALL-----.      |              | '-HOME-----'  '-,--ID--=--+-vmuserid-+-' |       
     +-,--PATH--=--nodename--+------------------+------+              |                           '-wsname---'   |       
     |                       '-,--Q--=--+-BSC-+-'      |              '-*----------------------------------------'       
     |                                  +-SNA-+        |                                                                 
     |                                  '-TCP-'        |                                                                 
     |                                  .-,-------.    |                                                                 
     |                                  V         |    |                                                                 
     +-+-,--JOBGROUP--=-+--(--jobno--,----groupid-+--)-+                                                                 
     | '-,--JG--=-------'                              |                                                                 
     '-+-,--JOB--=-+--+-jobno-----------+--------------'                                                                 
       '-,--J--=---'  |    .-,-----.    |                                                                                
                      |    V       |    |                                                                                
                      '-(----jobno-+--)-'                                                                                

>--+------+--+------+--+-----------------------+---------------><
   '-,--S-'  '-,--T-'  '-,--NIP--=--+-NONE---+-'   
                                    '-ipaddr-'

Parameters

NJEROUT

Issuing the *CALL,NJEROUT command enables the DSP. You are required to issue the *START,NJEROUT command to begin the reroute process if you omit parameters on the *CALL,NJEROUT command.

JOB =(jobno[,jobno...])

Specifies the BSC/NJE job(s) that you want to reroute. Use the JOB parameter only when the job you are rerouting was originally destined for transmission on a BSC/NJE line. You may use J= as an abbreviation for the JOB= keyword parameter.

JOBGROUP | JG=(jobno,groupid,groupid,....)

Specifies the SNA/NJE or TCP/IP/NJE job and the group(s) of work (JES3 jobs or SYSOUT streams) within the selected job you want to reroute. You can specify more than one JOBGROUP parameter on a valid *CALL,NJEROUT command. Use the JOBGROUP parameter only when the job you are rerouting was originally destined for transmission to a SNA/NJE or TCP/IP/NJE node. You can use JG= as an abbreviation for the JOBGROUP= keyword parameter. Use the *I,U,Q=BDT command to display the group-id(s) associated with a SNA network job. Use the *I,U,Q=TCP command to display the group-id(s) associated with a TCP/IP network job.

FDEST=nodename

Specifies that all SNA/NJE network jobs that have the final destination that you supply (nodename) be rerouted to the location you supply on the TO= keyword. The final destination of a SNA/NJE network job is originally defined as a network node in a job's JCL. You can determine the final destination of one or more SNA/NJE network jobs by issuing an *I,U,Q=BDT command.

PATH=nodename

Specifies that network jobs (either SNA/NJE, BSC/NJE, or TCP/IP/NJE) that are scheduled for processing through the path that you supply (nodename), be rerouted to the final destination that you supply on the TO= keyword. Use the *I,A,D=NJESND command to determine the valid paths for BSC/NJE work and the *I,NJE,NAME= command to determine the valid paths for SNA/NJE or TCP/IP/NJE work.

Q=ALL or SNA or BSC or TCP

Specifies the networking queue that you want searched when using the FDEST= or PATH= keywords. If you omit the Q= keyword, all network queues are searched. Otherwise:

Q=ALL: Specifies that the SNA/NJE, BSC/NJE, and TCP/IP/NJE queues are searched. If you specify Q=ALL with the FDEST keyword, only the SNA/NJE work queue is searched.
Q=SNA: Specifies that only the SNA/NJE work queue is searched.
Q=BSC: Specifies that only the BSC/NJE work queue is searched. Q=BSC is not valid for use with the FDEST= keyword parameter because the FDEST= keyword only reroutes SNA/NJE network jobs.
Q=TCP: Specifies that only the TCP/IP/NJE work queue is searched. Q=TCP is not valid for use with the FDEST= keyword because the FDEST= keyword only reroutes SNA/NJE network jobs.

TO=nodename or HOME, ID=vmuserid or wsname, or *

Specifies the name of the new destination node and, optionally, the VM userid or the name of the RJP workstation that is to receive the job or output data. You can specify HOME instead of using the home node name when rerouting jobs to your own system. Use the asterisk to send the network streams to their original destination with the appropriate networking protocol.

S

Specifies that JES3 display summation message IAT9202 to the issuing console in response to a reroute command. If you omit this parameter, JES3 issues individual messages for each job that you are rerouting.

T

Ends the DSP after completing the current request. This parameter cancels the DSP after a single transaction. A *RESTART,NJEROUT command overrides the terminate (T) parameter on a previous *CALL or *START,NJEROUT command.

NIP=NONE or ipaddr

Modifies or deletes an IP address. Specify ipaddr if an IP address needs to be added or changed. The IP variable (ipaddr) is case sensitive and must be enclosed in quotation marks. Specify IP=NONE if an IP address is to be deleted.

Controlling NJE transmission

When a job is NJESND(A), a *R command will end transmission and put the job in specialized rescheduling. The job will be transmitted unless it is in operator hold. (jobs in specialized rescheduling are considered active and scheduled). A *C command will end transmission and put the job in hold. A *F,j=xy,R command will release the job. The following table shows the use of the *R command and the *C command to control transmission.

Command	Result
*R J=jobno	NJESND specialized rescheduling
*C J=jobno	HOLD= (OP) NJESND

Rules

You can call as many as 255 NJEROUT DSPs to reroute network jobs.
The network job must be waiting on your node for transmission to another node at the time you issue the command.
You can reroute SNA/NJE jobs only when they are queued for transmission before MVS/BDT selects the work for processing.
To reroute data that is currently being transmitted on a BSC/NJE line, vary the logical sender offline, reroute the network job, and then vary the logical sender online (BSC/NJE only).
To obtain the JES3-assigned job number of the network job use the *I,J=jobname command specifying the name of the job to be rerouted.
To reroute a network job to your node (home node), you can code TO=HOME or TO=LOCAL instead of using the home node name.
If you specify the JOB= or JOBGROUP= keyword parameter, you must also specify the TO= keyword parameter.
JES3 will reject an *NJEROUT command if you specify both the JOB= and JOBGROUP= keyword parameters on the same *NJEROUT command.
The ID= keyword parameter is a VM user ID for rerouting job streams to a remote node. Do not use it for rerouting job streams to the home node; it is an RJP workstation for SYSOUT streams.

Note: Canceling line immediate (*C,linex,I) puts the job in specialized rescheduling. You can reroute the job at this time.

Results

JES3 enables the reroute DSP that reroutes the job stream or SYSOUT stream to the specified node and, if requested, the VM user or RJP workstation.
The NJEROUT DSP remains active unless you specify the T= parameter or until you issue a *CANCEL,NJEROUT command

Examples

Job WIP5 was sent to your node and is waiting for transmission to SNA/NJE node ATL. WIP5 has job number 12 and has group-ids of BDT00000, BDT00001, and BDT00002. Reroute the networking job to BSC/NJE node POK:

*CALL,NJEROUT,JG=(12,BDT00000,BDT00001,BDT00002),TO=POK

Job CORN was sent to your node and is waiting for transmission to TCP/IP/NJE node CLE. CORN has job number 901 and has group-ids of TCP00000, TCP00001, and TCP00002. Reroute the networking job to TCP/IP/NJE node RCH:

*CALL,NJEROUT,JG=(901,TCP00000,TCP00001,TCP00002),TO=RCH

Output data for job ABC was received from another node and is waiting for transmission to BSC/NJE node STL. Reroute the data to workstation 44444 at node SFO. The output data is contained in job 9999:

*CALL,NJEROUT,J=9999,TO=SFO,ID=44444

Job ABC was received from BSC/NJE node ATL and has finished executing. Reroute the output data to print on this node rather than on node ATL. The number of the job being used to transmit the output data is 7777:

*X,NJEROUT,J=7777,TO=HOME

The communication protocol between your node and a remote node (LA1) has changed from BSC/NJE to SNA/NJE. Migrate all jobs that are destined for node LA1 to the SNA/NJE format and request a summary message to avoid flooding your console with messages:

*X,NJEROUT,PATH=LA1,TO=*,S

Reroute all SNA/NJE network jobs that were queued for node HQ to node DIST. The reroute DSP should terminate after fulfilling your request:

*X,NJEROUT,FDEST=HQ,TO=DIST,T