$Z I[vvvv]

Function

To temporarily halt initiator processing.

Syntax


>>-$Z--+-I----+--+--------------------------------------+------->
       '-Init-'  +-nn--+------------+-------------------+   
                 |     '- ---+-mm-+-'                   |   
                 |           '-*--'                     |   
                 +-'--init--'---------------------------+   
                 |    .-,--------------------------.    |   
                 |    V                            |    |   
                 '-(----+-+-nn-+--+------------+-+-+--)-'   
                        | '-*--'  '- ---+-mm-+-' |          
                        |               '-*--'   |          
                        +-init-------------------+          
                        '-'--init--'-------------'          

>--+------------------------------+----------------------------->
   '-,--+---+--ASID--+-=--+--asid-'   
        '-/-'        +-^=-+           
                     +->--+           
                     '-<--'           

>--+------------------------------------------+----------------->
   '-,--+---+--STATUS--+-=--+--+-ACTIVE-----+-'   
        '-/-'          '-^=-'  +-DRAINED----+     
                               +-DRAINING---+     
                               +-HALTED-----+     
                               +-HALTING----+     
                               +-INACTIVE---+     
                               +-RESTARTING-+     
                               '-STARTING---'     

>--+----------------------------+------------------------------><
   '-,--+---+--STC--+-=--+--stc-'   
        '-/-'       +-^=-+          
                    +->--+          
                    '-<--'

Parameters

I[nnmm[-nnmm]]

Specifies the subscript (1-9999) of the initiator(s) that are halted after completing their current activity. If you do not specify an initiator identifier (nnmm), JES2 halts all initiators.

Note: JES2 commands do not recognize JES2–controlled initiators that are numbered (with subscripts) greater than the PARTNUM= specification on the INITDEF initialization statement.

For information about naming initiators, see z/OS JES2 Initialization and Tuning Reference, SA32-0992.

ASID=asid

Specifies the ASID of the initiator to be halted.

STATUS{=ACTIVE|DRAINED|DRAINING|HALTED| HALTING|INACTIVE|RESTARTING|STARTING}

Displays the current state of the initiator.

Type: Meaning
ACTIVE: A job is active on the initiator.
DRAINED: The initiator is drained.
DRAINING: The initiator is transitioning to a DRAINED state.
HALTED: The initiator has been halted by a $Z I command.
HALTING: The initiator is transitioning to a HALTED state.
INACTIVE: The initiator has been started but has not selected a job.
RESTARTING: The initiator has terminated abnormally and is in the process of restarting automatically.
STARTING: The device has been started but has not fully initialized yet. Applies to FSS-owned devices only.

STC=stc

Displays the job id of the initiator to be halted.

Authority Required

This command requires system 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 control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

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.

Example

 1   $z i1-2

  $HASP892 INIT(1)   STATUS=HALTED,CLASS=A,NAME=1
  $HASP892 INIT(2)   STATUS=HALTED,CLASS=AB,NAME=2

JES2 halts initiators 1 and 2 after they complete their current activity.