$P OFFLOADn - Stop an offload device

Function

To stop an offload device when it completes its current work and then close and deallocate the offload data set.

Syntax

Read syntax diagramSkip visual syntax diagram$P ,OFFLOADn

Parameters

OFFLOADn
The offload device (1-8) that is stopped.

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

  • This command causes the associated active transmitters and receivers to stop selecting work.
  • If you issue this command for an offload device that has been halted ($Z) during the receive operation, you may need to issue the $S OFFLOADn command to finish reloading the job that was halted, before the device will stop.
  • During the receive operation, JES2 automatically stops the offload device when an end-of-file is encountered.

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 offload2

  $HASP000 OK
  $HASP097 OFFLOAD2 IS DRAINED

JES2 stops offload device 2 when it completes its current work and then closes and deallocates the offload data set. The associated transmitters and receivers that are currently active no longer select work.