Controlling offload transmitters and receivers

JES2 provides commands you can issue for:

Starting offload transmitters and receivers
Draining offload transmitters and receivers
Displaying the status of offload transmitters and receivers
Setting offload transmitter and receiver characteristics
Canceling jobs on offload transmitters and receivers
Restarting offload transmitters.

Starting offload transmitters and receivers: You can cause a specified offload transmitter or receiver to automatically start each time the corresponding offload device is started. If the offload device is already active, the transmitter or receiver will start immediately. Only one job transmitter and one SYSOUT transmitter can be started for a specific offload device and they must be specified with the corresponding device number. The same rule applies to job receivers and SYSOUT receivers. For example, if you issue the $T OFF1.JR and $T OFF1.SR commands, JES2 automatically starts the offload job and SYSOUT receivers for offload device 1 when you issue the $S OFFLOAD1,TYPE=RECEIVE command.
Note: If you issue the display command for the transmitters or receivers ($D OFFn.xx) before the associated offload device is started, it will display their status as “STARTABLE”.
Draining offload transmitters and receivers: When you issue the $P OFFn.xx command, the current job completes processing before the device is allowed to drain. Once drained, the transmitter or receiver will not be automatically started when the corresponding offload device is started; it must be individually started using the $S OFFn.xx command.
If both receivers have been drained while the corresponding offload device is still active, the offload device will be automatically halted. You can then terminate the reload operation by issuing the $P OFFLOADn command or continue loading by starting the offload receivers ($S OFFn.xR).
Displaying the status of offload transmitters and receivers: You can display detailed information about specific offload job transmitters and offload SYSOUT transmitters using the $D U,OFFn.XT command. The $D U,OFFn.xR does the same for offload job and SYSOUT receivers.
Setting offload transmitter and receiver characteristics: You can specify the work selection characteristics of an offload job transmitter or receiver by issuing the $T OFFn.xx,WS= command. You can do the same for offload SYSOUT transmitters and receivers. If you are uncertain of the characteristics in effect, you can display the characteristics for a particular offload transmitter or receiver by issuing the $D U,OFFn.xx command.
Canceling offload transmitters and receivers: The job currently active on a transmitter or receiver may be cancelled by issuing the $C OFFn.xx command. When canceling a job transmitter, the job will be terminated and deleted from the queue from which it was selected. The transmitter then selects the next job eligible for processing. When canceling a SYSOUT transmitter, the output groups for the job that were eligible to be offloaded according to the work selection criteria, will be terminated and deleted from the queues from which they were selected. The transmitter then selects the next job eligible for processing. When canceling a receiver, reception of job or SYSOUT data continues until the end-of-job indicator is recognized, at which time the received job is deleted from JES2 spool. The transmitter/receiver continues processing as long as the spool offload media device provides data.
Restarting offload transmitters: Processing of the job currently active on a transmitter may be interrupted by issuing the $E OFFn.xT command. Restarting an offload transmitter is similar to the cancel command with the exception that the job is not deleted from JES2 spool but remains on the queue from which it was selected. The transmitter continues by selecting the next job eligible for processing, which may be the same job that was interrupted. To prevent the interrupted JOB/SYSOUT from being re-selected, the job should be put in HOLD status prior to the $E OFFn.xT command.