$P OFFn.xx - Stop an offload transmitter/receiver
Function
To stop the specified offload transmitters and/or receivers after they complete their current activity.
Syntax
Parameters
- n
- The subscript defining the offload job transmitters and receivers affected by this command. The subscript can specify a numeric value (1-8) or a range of values associating offload job transmitters and receivers with offload devices. For information about specifying a range of values for this subscript, see Command syntax conventions.
- OFFn.JR
- The offload job receiver that is stopped. n is the number (1-8) of the associated offload device.
- OFFn.JT
- The offload job transmitter that is stopped. n is the number (1-8) of the associated offload device.
- OFFn.SR
- The offload SYSOUT receiver that is stopped. n is the number (1-8) of the associated offload device.
- OFFn.ST
- The offload SYSOUT transmitter that is stopped. n is the number (1-8) of the associated offload device.
Authority Required
This command requires device 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.
Processing Considerations
- Once the device is stopped, JES2 does not automatically start it when the corresponding offload device (OFFLOADn) is started. You must use the $S command to individually start the device.
- If you stop both receivers while the corresponding offload device is still reloading data, JES2 automatically halts the offload device. To stop the reload operation, issue the $P OFFLOADn command. To continue loading, issue a $S OFFn.xR command and then restart the offload device ($S OFFLOADn).
Scope
Single member. This command will be in effect for this member only. There is no need to have this command issued to all members of the MAS.
Messages
The $HASP000 message indicates the command was accepted.
Upon completion, JES2 issues the $HASP097 message to indicate the device has been drained.
Example
1 $p off2.jt,off4.jt
$HASP000 OK
$HASP097 OFF2 IS DRAINED
$HASP097 OFF4 IS DRAINED
JES2 stops the offload job transmitters for offload devices 2 and 4 when they complete their current work.