$P I[nnmm] - Stop an initiator
Function
To stop the specified initiators and free associated resources.
Syntax
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.
- ASID=asid
- Specifies the ASID of the initiator to be stopped.
- STATUS[=ACTIVE|DRAINED|DRAINING|HALTED| HALTING|INACTIVE|RESTARTING|STARTING]
- 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.
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 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.