Function

To control initiators.

Parameters

I(nn[-mm])

Specifies the subscript (1-9999) of the initiator(s) that you are controlling.

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.

CLass=classlist | (class,class...)

The job classes, in priority sequence, that the initiator processes.

The classlist variable specifies a list of single-character job classes A-Z and 0-9 (for example, 'ABCDEF'), in priority sequence, that the initiator processes. A range of 1-36 single-character job classes can be specified.

The class variable specifies a comma-separated list of 1-8 job classes or job class groups (each 1-8 characters in length), in priority sequence, that the initiator processes. A maximum of eight items can be specified in the list (for example, CLASS1,CLASS2,CLASS3). Work selection from job class groups occurs in a round robin fashion across the classes in the group.

NAME=name

The EBCDIC name associated with the initiator.

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

Only initiators in the specified state will be modified. The following types of status can be displayed:

Type

Meaning

ACTIVE

JES2 is using the initiator for job processing and will continue to do as long as jobs are both available and eligible for the device.

DRAINED

JES2 does not use the initiator until you start it with a $S command.

DRAINING

JES2 is using the initiator to process jobs, but will stop using this device once the current function has completed.

HALTED

JES2 has either requested operator assistance or an operator has entered the $Z command to halt the initiator. To start the initiator, you must enter a $S command.

HALTING

The initiator is transitioning to a HALTED state.

INACTIVE

JES2 is not using the initiator, but would do so if a job were both available and eligible for the initiator.

RESTARTING

The initiator has terminated abnormally and is in the process of restarting automatically.

STARTING

The initiator is being started. Applies to FSS-owned devices only.

STC=stc

The initiator associated with the specific STC that is to be controlled.

Related Commands

$D Init

Authority Required

This command requires device and 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. The $T NODE(nnnn) command sets the command authority for a node.

This command requires update security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

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.

Context

HASCSCAN and HASPSXIT are responsible for processing this command.

Initiator 2 is modified to select work from job classes V, W, X, Y, and Z. In this case, class V will not be selected because it is held (by JOBCLASS(V) QHELD=Y) and class W will not be selected because the job class is WLM-managed (by JOBCLASS(w) MODE=WLM).