$D I[nnmm]

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


>>-$D--+-I----+--+--------------------------------------+------->
       '-Init-'  +-nn--+------------+-------------------+   
                 |     '- ---+-mm-+-'                   |   
                 |           '-*--'                     |   
                 +-'--init--'---------------------------+   
                 |    .-,--------------------------.    |   
                 |    V                            |    |   
                 '-(----+-+-nn-+--+------------+-+-+--)-'   
                        | '-*--'  '- ---+-mm-+-' |          
                        |               '-*--'   |          
                        +-init-------------------+          
                        '-'--init--'-------------'          

>--+---------------------------------+-------------------------->
   '-| Selection limiting keywords |-'   

>--+-------------------------------+---------------------------><
   '-| Display limiting keywords |-'   

Display limiting keywords

|--+-------------+--+---------+--+----------+------------------->
   '-,--ACTCLASS-'  '-,--ASID-'  '-,--Class-'   

>--+---------------------+--+----------+--+------------+-------->
   '-,--INELigible_class-'  '-,--JOBID-'  '-,--JOBNAME-'   

>--+---------+--+-----------+--+--------+-----------------------|
   '-,--Long-'  '-,--STATUS-'  '-,--STC-'   

Selection limiting keywords

|--+--------------------------------------+--------------------->
   '-,--+---+--ACTCLASS--+-=--+--actclass-'   
        '-/-'            +-^=-+               
                         +->--+               
                         '-<--'               

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

>--+-------------------------------------------+---------------->
   '-,--CLass--+-=--+--+-classlist-----------+-'   
               +-^=-+  |    .-,---------.    |     
               +->--+  |    V           |    |     
               '-<--'  '-( -----class---+--)-'     

>--+--------------------------------+--------------------------->
   '-,--+---+--JOBID--+-=--+--jobid-'   
        '-/-'         +-^=-+            
                      +->--+            
                      '-<--'            

>--+------------------------------------+----------------------->
   '-,--+---+--JOBNAME--+-=--+--jobname-'   
        '-/-'           +-^=-+              
                        +->--+              
                        '-<--'              

>--+------------------------------+----------------------------->
   '-,--+---+--NAME--+-=--+--name-'   
        '-/-'        +-^=-+           
                     +->--+           
                     '-<--'           

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

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

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). End of change

The classlist variable specifies a list of single character job classes A-Z and 0-9: for example, 'ABCDEF'. A maximum of 36 classes can be specified.

The class variable specifies a comma-separated list of job classes or job class groups (each 1-8 characters in length). A maximum of eight items can be specified in the list: for example, (CLASS1,CLASS2,CLASS3).

Wildcards can also be specified: see Using wildcards for details.

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

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.