$T Init(nnmm) - Control initiators
Function
To control initiators.
Syntax
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.
- CLass=classlist | (class,class...)
- The job classes, in priority sequence, that the initiator processes.
- 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.
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.
Context
HASCSCAN and HASPSXIT are responsible for processing this command.
Examples
1 $t i1,c=abcde
$HASP892 INIT(1) STATUS=INACTIVE,CLASS=ABCDE,NAME=1,ASID=0017
2 $ti 2,c=VWXYZ
$HASP892 INIT(2) STATUS=INACTIVE,CLASS=XYZ,
$HASP892 INELIGIBLE_CLASS=(V-HELD,W-WLM),NAME=2,
$HASP892 ASID=0018
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).