Restarting the NJEROUT DSP *RESTART,NJEROUT
Function
Use the *RESTART,NJEROUT command to reroute a job or a job's SYSOUT data to a location other than its original destination. You can also reroute the output to a VM userid or RJP workstation.
The *RESTART,NJEROUT command ends any reroute operations that are currently active before processing work specified on the *RESTART command.
Syntax
>>-+-*RESTART-+--+-,--NJEROUT-----+-----------------------------> '-*R-------' +-,--J--=--jobno-+ '-,--RRT--nnnnn--' >--+-----------------------------------------------------------------------------------------------------------------+--> | .-,--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
- J=jobno
- Identifies the specific copy of the NJEROUT DSP to restart if more than one DSP is active. Use the *I,J=NJEROUT command to determine the DSP's job number if more than one NJEROUT DSP is active.
- RRTnnnnn
- Identifies the specific reroute DSP by its JES3-assigned job number.
- FDEST=nodename
- Specifies that all SNA/NJE network jobs that have the final destination which 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.
- JOBGROUP=(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. 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.
- 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 can use the short form J= as an abbreviation for the JOB= keyword.
- 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 all 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 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 using 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 valid *CALL or *START,NJEROUT command.
- NIP=ipaddr or NONE
- 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.
Example
You recently issued the command *S,NJEROUT,JOB=(7,8,9,10),TO=POK.
Enter the command that will override the previous command and send
jobs 7, 9, and 10, but not job 8 to nodename POK:
*R,NJEROUT,JOB=(7,9,10),TO=POK