$P OFFn.xx

Function

To stop the specified offload transmitters and/or receivers after they complete their current activity.

Syntax


>>-$P--+-OFFn.JR-+--+----------+-------------------------------><
       +-OFFn.JT-+  +-,OFFn.JR-+   
       +-OFFn.SR-+  +-,OFFn.JT-+   
       '-OFFn.ST-'  +-,OFFn.SR-+   
                    '-,OFFn.ST-'

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, SA32-0991.

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.