$Z I[vvvv] - Halt initiator activity

Function

To temporarily halt initiator processing.

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.

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.

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.