$S I[vvvv] - Start an initiator

Function

To start one or more initiators.

Parameters

ASID=asid

The initiator associated with the specific address space is to be started.

I[init[-init]]

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

Note:

1. If you omit the initiator identification (vvvv), JES2 starts only those initiators stopped by a prior $Z I or $P I command that also did not specify an identifier. For example, note that if initiator 1 was stopped with the $P I1 command and is later to be restarted, you must issue $S I1; issuing $S I will return message $HASP000 OK, but initiator 1 is not restarted.

   If JES2 is started with the option START=NO on the INIT statement, a $SI will not be successful. In such case, the $SI command needs to be qualified with a specific or range of initiators like $SI (1–*) for example. $SI unqualified will only work if a previous $PI or $ZI was issued.

2. 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.

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

Initiators in the specified state are to be started. The following types of status can be displayed:

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 the $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

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

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 $HASP892 message indicates the command was accepted.

When the initiator starts processing a job from the job classes assigned to it, JES2 issues the $HASP373 message.