$P I[nnmm]

Function

To stop the specified initiators and free associated resources.

Syntax


>>-$P--+-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[nn[-mm]]

Specifies the subscript (1-9999) of the initiator(s) that are stopped after completing their current activity.

Note:

If you omit the initiator identification (nnmm), JES2 stops all initiators.
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 stopped.

Displays information about JES2-managed devices. 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 initiator has been started but has not fully initialized yet.

STC=stc

Specifies the job id of the initiator to be stopped.

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.

Processing Considerations

If JES2 has not received verification of address space creation for the specified initiator, it stops the specified logical initiator; no MVS initiator job is cancelled.

Scope

Single member. The values supplied for this command will be in effect for this member only.

Depending on your installation's setup, however, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP395 message indicates the specified initiator is stopped.

Example

 1   $p i3-5

  STC00003 $HASP395 INIT ENDED
  STC00004 $HASP395 INIT ENDED
  STC00005 $HASP395 INIT ENDED

JES2 stops initiators in the EBCDIC range X'404040F3' to X'404040F5'. JES2 stops initiators 3, 4, and 5 after they complete processing their current jobs, and then frees the associated system resources.