z/OS JES2 Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$S I[vvvv] - Start an initiator

z/OS JES2 Commands
SA32-0990-00

Function

To start one or more initiators.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-$S--+-I----+--+--------------------------------------+------->
       '-Init-'  +-nn--+------------+-------------------+   
                 |     '- ---+-mm-+-'                   |   
                 |           '-*--'                     |   
                 +-'--init--'---------------------------+   
                 |    .-,--------------------------.    |   
                 |    V                            |    |   
                 '-(----+-+-nn-+--+------------+-+-+--)-'   
                        | '-*--'  '- ---+-mm-+-' |          
                        |               '-*--'   |          
                        +-init-------------------+          
                        '-'--init--'-------------'          

>--+------------------------------+----------------------------->
   '-,--+---+--ASID--+-=--+--asid-'   
        '-/-'        +-^=-+           
                     +->--+           
                     '-<--'           

>--+------------------------------------------+----------------->
   '-,--+---+--STATUS--+-=--+--+-ACTIVE-----+-'   
        '-/-'          '-^=-'  +-DRAINED----+     
                               +-DRAINING---+     
                               +-HALTED-----+     
                               +-HALTING----+     
                               +-INACTIVE---+     
                               +-RESTARTING-+     
                               '-STARTING---'     

>--+----------------------------+------------------------------><
   '-,--+---+--STC--+-=--+--stc-'   
        '-/-'       +-^=-+          
                    +->--+          
                    '-<--'          

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, SA32-0992.

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, SA32-0991.

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.

Example

 1   $s i3

  $HASP892 INIT(3)    STATUS=STARTING,CLASS=ABC,NAME=3

Initiator 3 (X'404040F3') begins processing jobs from the job classes assigned to it.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014