$D I[nnmm] - Display initiator information
Function
To display the status of an initiator and the job classes assigned to it.
This command has parameters you can use as a filtering technique to limit the type of information to search, or the amount of information to display. See Using filtering to control and display information for additional information.
Syntax
Parameters
- I[init[-init]]
- Specifies
the subscript (1-9999) of the initiator(s) that are displayed. Note: JES2 commands do not recognize JES2–controlled initiators that are numbered (with subscripts) greater than the PARTNUM= specification on the INITDEF initialization statement.
- ACTCLASS=actclass
- Displays the job class of the job being actively processed by the initiator.
- ASID=asid
- Displays the ASID of the address space in which the initiator is running.
- Class=classlist|(class,class)
- Displays the list of classes which are associated with the initiator. Classes associated with the initiator but ineligible to select work are not displayed in the list (but are matched on a filter).
- INELigible_class
- Displays those classes which are associated
with the initiator but ineligible to select work. Classes are displayed
with an indicator as to why the class is not eligible:
- HELD
- The initiator cannot select work in this job class because the job class is held.
- WLM
- The initiator cannot select work from this job class because it is a WLM-mode job class.
- QAFF
- The initiator cannot select work from this job class because the member is not in the queue affinity list (QAFF) for this job class.
- JOBID=jobid
- Displays the job id of the job active on this initiator.
- JOBNAME=jobname
- Displays the job name of the job active on this initiator.
- Long
- Specifies
the long form of the display. Note: Because LONG automatically triggers a "long" display, you cannot add additional display-limiting parameters to this command; however, you can add selection-limiting parameters.
- STATUS={ACTIVE|DRAINED|DRAINING|HALTED| HALTING|INACTIVE|RESTARTING|STARTING}
- Displays
the current state of the initiator.
- 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 through a $Z I command.
- 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
- Displays the job id of the initiator STC.
Authority Required
This command requires display 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 read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.
Scope
Single member. The response to this command will be a display of information about this member only. There is no need to issue this command for all members of the MAS.
Messages
The $HASP892 message displays the status of the specified initiators.
Examples
1
$d i1
$HASP892 INIT(1) STATUS=INACTIVE,CLASS=A,NAME=1,ASID=0017
JES2 displays the status of initiator 1 and its assigned job class.
2
$d i2,long
$HASP892 INIT(2) STATUS=ACTIVE,CLASS=A,NAME=1,ASID=0017,
$HASP892 JOBID=JOB00013,JOBNAME=JLNKCLW2,ACTCLASS=A
$HASP892 STC=STC00004
When you specify the LONG operand, additional information (JOBNAME, ACTCLASS, and STC) is displayed.
3
$d i3
$HASP892 INIT(3) STATUS=ACTIVE,CLASS=C,
$HASP892 INELIGIBLE_CLASS=(A-HELD,B-WLM),NAME=3,
$HASP892 ASID=0018
Initiator 3 is displayed. Job classes A, B, and C were all specified in the class list for initiator 3, but the initiator cannot select from class A because the job class is held and cannot select from class B because it is a WLM-mode job class.
4
$di
$HASP892 INIT(1) STATUS=INACTIVE,CLASS=A,NAME=1,ASID=012E
$HASP892 INIT(2) STATUS=DRAINED,CLASS=AB,NAME=1
$HASP892 INIT(3) STATUS=DRAINED,CLASS=ABC,NAME=44
$HASP892 INIT(4) STATUS=DRAINED,CLASS=ABC,NAME=44
$HASP892 INIT(5) STATUS=DRAINED,CLASS=JX,NAME=5
$HASP892 INIT(6) STATUS=DRAINED,CLASS=A,NAME=6
$HASP892 INIT(7) STATUS=DRAINED,CLASS=A,NAME=7
$HASP892 INIT(8) STATUS=DRAINED,CLASS=A,NAME=8
$HASP892 INIT(9) STATUS=DRAINED,CLASS=JX,NAME=9
$HASP892 INIT(10) STATUS=DRAINED,CLASS=A,NAME=10
5
$di4
$HASP892 INIT(4) STATUS=DRAINED,CLASS=ABC,NAME=44
Display initiator number 4.
6
$di44
$HASP003 RC=(03),I44 - INVALID PARAMETER STATEMENT
Display initiator number 44.
7
$di(44)
$HASP892 INIT(3) STATUS=DRAINED,CLASS=ABC,NAME=44
$HASP892 INIT(4) STATUS=DRAINED,CLASS=ABC,NAME=44
Display initiator, first as name of 44, then if not found, number of 44.
8
$di(4)
$HASP892 INIT(4) STATUS=DRAINED,CLASS=ABC,NAME=44
Display initiator, first as name 4, then if not found, number of 4.
9
$di'1'
$HASP892 INIT(1) STATUS=INACTIVE,CLASS=A,NAME=1,ASID=012E
$HASP892 INIT(2) STATUS=DRAINED,CLASS=AB,NAME=1
Display initiator with name of 1.
10
$di(1)
$HASP892 INIT(1) STATUS=INACTIVE,CLASS=A,NAME=1,ASID=012E
Display initiator with name of 1, then if not found, number of 1.