Function

Parameters

job

Specifies 1 to 8 alphanumeric, special ($, #, or @) or wildcard characters (or a combination of them) that can be used to select a subset of jobs whose job name matches this combination of characters (mask).

‘job’

The name of the job that is displayed. This name must appear as coded on the JOB statement and must be enclosed in apostrophes. If more than one job exists with this name, no action is taken.

Job

A Batch job or range of batch jobs is to be displayed.

JOBQ|JQ

Specifies all jobs, STCs, and TSUs across the MAS for processing.

Stc

A started task or range of started tasks is to be displayed.

Tsu

A time-sharing user or range of time-sharing users is to be displayed.

Age|DAys<days | Age|DAys>days

Specifies the age of affected jobs in days. Only jobs more (with DAYS>nn) or less (with DAYS<nn) than the specified number of days in age are affected, The days are counted from the current hour.

ARM_element={No|Yes}

Displays whether (Yes) or not (No) the job is registered with the Automatic Restart Management (ARM).

BUSY=

Specifies one of the following:

• The system name or number on which the job is busy. Note that you can specify a value of 0 to indicate the job is not busy. You can also specify values above 32 to match systems with invalid values in the BUSY value (for example, $DJOBQ,BUSY>32)
• YES or ANY, indicating that all busy jobs are to match
• NO or NONE, indicating that all non-busy jobs are to match

CANCEL=[No|Yes]

Cancel only jobs which have been cancelled (Yes) or have not been cancelled (No).

CARDS=cards

Displays the number of input cards associated with the job.

CC=(ABEND|ABENDED|CANcelled|CNVT_abend|CODE| COMPleted|ENDed_by_cc|EOM_failure|JCLerror| JOBRC|RC|SECurity_failure|TYPE)

Displays the completion information associated with the job.

ABENDED

Display only jobs which have abnormally ended.

ABEND

Displays the ABEND code associated with the job's termination.

CANcelled

Display only jobs which were cancelled by the operator.

CNVT_abend

Display only jobs which have abnormally ended during the conversion phase.

CODE

Displays the last (or highest) completion code of steps in the job.

COMPleted

Display only jobs which completed.

ENDed_by_cc

Display only jobs which were ended by a step completion code.

EOM_failure

Display only jobs which failed in end-of-memory processing.

JCLerror

Display jobs which did not execute due to a JCL error.

JOBRC

Displays the return code of the last step that was executed.

RC

Displays the highest return code for any executed step.

SECurity_failure

Display jobs which failed security validation.

Class=class

Specifies a job class used to select a subset of jobs that have a matching job class. Wildcard characters can also be specified: see Using wildcards for details.

CMDauth=(cmdauth{,cmdauth})

Only the jobs that can be affected from the specified remote(s) or node(s) will be displayed. The valid specifications are:

LOCAL|ANYLOCAL

Only the local devices at the local node can affect the output.

Nnnnn|nodename

Only local devices at the specified node can affect the output.

Rnnnn

Only the specified remote device can affect the output.

NnnnnRnnnn|nodename.Rnnnn

Only the specified remote device at the specified remote node can affect the output.

destid

A destid corresponding to any of the above remote devices.

Note: Specification of the CMDAUTH filter does not override the authority of the console from which the command is issued; both the authority of the console and the specified CMDAUTH filter must match for the job to be affected.

CRTIME

Displays the creation date and time of the job.

DELAY={BUSY_ON_HOLD|HOLD|JOBCLASS|LIMIT|LOCKED| No|QUEUE_ERROR|SCHENV|SECLABEL|SPOOLS_NOT_AVAILABLE|SRVCLASS|SYSAFF| MEMBER_STATUS|Yes|ZOS_LEVEL}

Displays reasons why a pre-execution job will not enter execution:

BUSY_ON_DEVICE

The job will not execute because it is busy on a device (such as an offload job transmitter).

HOLD

The job will not execute because it is held, its job class is held, or another job with the same jobname is executing.

JOBCLASS

The QAFF for the job class is not selectable where the job has system affinity. SYSAFF for the job and QAFF for the job class have no member in common.

LIMIT(1)

The job will not execute because the job class execution limit has been reached (as specified by JOBCLASS XEQCOUNT=(MAX=)).

LIMIT(2)

The job will not execute because the job class execution limit has been reached for all members (as specified by JOBCLASS XEQMEMBER = (MAX=)) that are included in the intersection of job affinity, job class QAFF and SCHENV affinities.

LOCKED

The job will not execute because it's being updated by JES2.

SECLABEL

The security label (SECLABEL) assigned to the job is not defined as active on any member that is active.

SRVCLASS

The QAFF for the service class is not selectable where the job has system affinity. SYSAFF for the job and QAFF for the service class have no member in common.

SYSAFF

Each of the members for which the job has affinity (SYSAFF) is inactive, or the job has specified independent state, and the JES2 member is not independent (IND=NO).

SCHENV

The job's scheduling environment is not available on any member, or is available only on systems where JES2 is inactive. Use the $DJ'jobname',LONG command to find out what scheduling environment a job requires. Then use the D WLM,SCHENV=schenv-name command to find out the current status of the scheduling environment on each system in the sysplex.

The SCHENV state masks other reasons why the job might be ineligible to run, such as the $P and $P XEQ commands having been issued. Also, note that the SCHENV delay is detected only after a job goes through conversion. If a job is delayed prior to conversion due to system affinity requirements, scheduling environments are not considered in determining delay status.

MEMBER_STATUS

A combination of system affinity, scheduling environment, SECLABEL restrictions, job class QAFF, and service class QAFF (if WLM managed job class) are preventing the job from running, or, other member states prevent the job from running on systems where the job is otherwise eligible. These states include:

• $P command has been issued
• $P XEQ command has been issued
• BOSS=NO (used in a poly-JES environment only)

When used as a command filter, the string MEMBER_STATUS matches on jobs delayed for SYSAFF, SCHENV, SECLABEL, or MEMBER_STATUS. To get detail on why a job is delayed, display job status with the $DJ'jobname',LONG command or display member status with the $DMEMBER(member-name) command.

ZOS_LEVEL

The job will not execute because there is no JES2 member active in the MAS that is running the minimum or higher z/OS level that is required by the job.

Yes

Display only jobs which are delayed for any of the above reasons.

No

Display only jobs which are not delayed for any of the above reasons.

EOM={No|Yes}

Displays whether the job is currently queued to the JES2 address space for end of memory processing. EOM= is only displayed while the job is queued for processing. EOM=NO is never displayed.

HOLD

Displays the hold status of the job.

ALL

Display jobs held by the $H A command.

JOB

Display jobs held by the $H J command, TYPRUN=HOLD, TYPRUN=JCLHOLD, or held due to error.

DUP

Display jobs held for duplicate job name.

ARM

Display jobs which are held awaiting restart through ARM.

NONE

Display jobs which are not held.

Hours=hours

Specifies the age of affected jobs in hours. Only jobs more (with HOURS>nn) or less (with HOURS<nn) than the specified number of hours in age are affected.

INITASID=initasid

For initiator jobs, displays the address space identifier (ASID) associated with the initiator.

JC|JOBCORR=job correlator

Specifies a combination of 1-64 alphanumeric, special (colon, period or underscore) and wildcard characters that can be used to select a subset of jobs that have a matching job correlator. For a description of wildcard characters, refer to Using wildcards.

JOBMASK|JM=jobmask

Specifies 1 to 8 alphanumeric, special ($, #, or @) or wildcard characters (or a combination of them) that can be used to select a subset of jobs whose job name matches this combination of characters (mask). For a description of wild cards, see Using wildcards.

Note:

1. This is a positional parameter. Specify this following the job_id (JOB, STC, or TSU), or JOBQ parameter.
2. You must specify JOBMASK if you specified either the JOBQ parameter or an asterisk (n-*) on the job_id parameter.
3. The JOBMASK parameter is not valid with the ‘jobname ’ parameter.

LONG

If you specify the LONG operand, JES2 will display the following information:

• The userid of the job
• The spool volumes on which the specified jobs have space allocated
• The remote consoles or nodes that can enter commands that affect a job (CMDAUTH)
• whether the job uses the automatic restart management services.

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.

OFFS=offs

Displays offload device numbers on which the job has been archived.

Priority=priority

Displays the priority of the job.

PURGE={No|Yes}

Indicates that only jobs which are (Yes) or are not (No) pending purge processing should be displayed.

Queue={CNV|INPUT|OUT|PPU|PURGE|RCV| SETUP|SPIN|XEQ|XMT}

Only jobs on the specified job queue are to be displayed.

CNV

Only jobs awaiting conversion are to be displayed.

INPUT

Only jobs on the JES2 $INPUT queue are to be displayed.

OUT

Only jobs awaiting output processing are to be displayed.

PPU

Only jobs awaiting print/punch processing are to be displayed.

PURGE

Only jobs awaiting purge processing are to be displayed.

RCV

Only jobs on the JES2 $RECEIVE queue are to be displayed.

SETUP

Only jobs on the JES2 $SETUP queue are to be displayed.

SPIN

Only jobs awaiting spin processing are to be displayed.

XEQ

Only jobs awaiting or in execution are to be displayed.

XMT

Only jobs queued for network transmission are to be displayed.

REBUILD={No|Yes}

Jobs on the rebuild queue are to be displayed (Yes) or not displayed (No).

REQuires_zos

The minimum z/OS level that the job requires to run. This value is set by the system when the JCL specifies an option that is only supported by the z/OS level that is displayed, and later. This parameter can also be set based on the use of symbols at job submission time. If there are no systems available at this level of z/OS, the job is delayed until an eligible system becomes available.

SCHENV=schenv

Displays the scheduling environment associated with the job.

SCHENV_AFF=member

Displays the JES2 MAS members on which the scheduling environment for this job is available.

SECLABEL_AFF=member

Displays the JES2 MAS members on which the SECLABEL for this job is available but only if the RACF® SECLABEL_BY_SYS is also active.

SECLABEL=seclabel

Displays the security label associated with the job.

SPINNABLE=spinnable

Indicates that the JESLOG data sets can be spun (made available) while the job is executing.

SPL|SPOOL={Percent|%|Tgs|Volumes}

Only jobs with specific SPOOL characteristics are to be displayed:

Percent|%

Only jobs using more (with %>nn) or less (with %<nn) than the specified percentage of the total available spool space are to be displayed.

Tgs

Only jobs using more (with Tgs>nn) or less (with Tgs<nn) than the specified number of track groups are to be displayed.

Volumes=(v1,v2,...)

Only jobs which have allocated spool space on the specified spool volume(s) are to be displayed.

SRVCLASS=srvclass

Displays the service class of the job. The service class is available for batch jobs only. It is not available for started tasks or time-sharing users.

Note: The default workload manager (WLM) policy assigns a service class of blanks to all jobs, and WLM-managed initiators can then select such jobs for processing.

Sysaff=member

Displays the job's system affinity.

TYPE={JOB|STC|TSU}

Indicates whether only batch jobs (JOB), started tasks (STC), or time-sharing users (TSU) are to be displayed.

USERID=userid

Displays the userid associated with the job.

XEQNODE=xeqnode

Only jobs which are destined to execute at the specified node, or which have already executed at the specified node, are to be displayed. The node name may be specified using the decimal node number (Nnnnnn) or an EBCDIC node name.

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.

Processing Considerations

If you first specify the MVS command CONTROL S,MFORM=J, you can display the job number as well as the job name with the $D job command. For a description of the MVS CONTROL command, see z/OS MVS System Commands, SA38-0666.

Scope

MAS-wide. This command displays information about the entire MAS.

Messages

The $HASP890 message displays the current status of the indicated job.

Examples

 1   $d j'myjob'

  JOB00017  $HASP890 JOB(MYJOB)
  $HASP890 JOB(MYJOB)     STATUS=(AWAITING EXECUTION),CLASS=H,
  $HASP890                PRIORITY=9,SYSAFF=(ANY),HOLD=(JOB)

JES2 displays job information for all jobs with the name MYJOB (1 batch job, in hold status).

 2   $d j1-*,jm=ieb*

  JOB00009  $HASP890 JOB(IEBGENER)
  $HASP890 JOB(IEBGENER)  STATUS=(AWAITING EXECUTION),CLASS=9,
  $HASP890                PRIORITY=9,SYSAFF=(ANY),HOLD=(JOB)

JES2 displays job information for all batch jobs whose job name begins with the characters IEB.

 3   $d j1-*,q=ppu,cc

  JOB00008  $HASP890 JOB(J1)         CC=(COMPLETED,CODE=0)
  JOB00030  $HASP890 JOB(J2)         CC=(ABENDED,ABEND=(S0C4,U000))
  JOB00031  $HASP890 JOB(J3)         CC=(COMPLETED,CODE=4)
  JOB00034  $HASP890 JOB(J4)         CC=(ENDED_BY_CC,CODE=8)

JES2 displays job completion information (the CC parameter) for all batch job awaiting print/punch processing.

 4   $d jq,delay=yes,delay

  JOB00100  $HASP890 JOB(BATCH1)     DELAY=(HOLD)
  JOB00102  $HASP890 JOB(BATCH2)     DELAY=(HOLD)
  JOB00105  $HASP890 JOB(BATCH3)     DELAY=(HOLD,LIMIT,SCHENV)
  JOB00140  $HASP890 JOB(BATCH4)     DELAY=(MEMBER_STATUS)

For all delayed jobs in the system (DELAY=YES), JES2 displays the reason for the job not entering execution. In this example, jobs BATCH1 and BATCH2 are delayed because of some form of HOLD, job BATCH3 is delayed for multiple reasons, and BATCH4 is delayed because no system is eligible to select the job.

 5   $d jq,delay=schenv,schenv

  JOB00105  $HASP890 JOB(BATCH3)     SCHENV=DB2

JES2 displays the scheduling environment for all jobs which will not execute because the scheduling environment is unavailable. In this example, job BATCH3 will not execute because its scheduling environment, DB2®, is not available on any active member.

 6   $dj'myjob',long

  JOB00007  $HASP890 JOB(MYJOB)
  $HASP890 JOB(MYJOB)     STATUS=(EXECUTING/IBM1),CLASS=B,
  $HASP890                PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE),
  $HASP890                CMDAUTH=(LOCAL),OFFS=(),SECLABEL=,
  $HASP890                USERID=IBMUSER,SPOOL=(VOLUMES=(SPOOL1),
  $HASP890                TGS=6,PERCENT=1.1428),ARM_ELEMENT=NO,
  $HASP890                CARDS=185,REBUILD=NO,SRVCLASS=DISCRETN,
  $HASP890                SCHENV=,SCHENV_AFF=(IBM1),CC=()

JES2 displays extended attributes for the job named MYJOB.

 7   $d jq,spool=(v=spool1,percent>1)

  JOB00007  $HASP890 JOB(MYJOB)
  $HASP890 JOB(MYJOB)     STATUS=(EXECUTING/IBM1),CLASS=B,
  $HASP890                PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE),
  $HASP890                SPOOL=(VOLUMES=(SPOOL1),TGS=6,
  $HASP890                PERCENT=1.1428)
  JOB00018  $HASP890 JOB(MYJOB2)
  $HASP890 JOB(MYJOB2)    STATUS=(EXECUTING/IBM1),CLASS=B,
  $HASP890                PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE),
  $HASP890                SPOOL=(VOLUMES=(SPOOL1),TGS=6,
  $HASP890                PERCENT=1.1428)

JES2 displays all jobs which use more than 1% of spool which utilize spool space on volume SPOOL1.

 8 

  $dj36,days<1

 JOB00036  $HASP890 JOB(DEST10)
 $HASP890 JOB(DEST10)    STATUS=(AWAITING EXECUTION),CLASS=A,
 $HASP890                                PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)

JES2 displays any job 36 if age is less than one day.

 9 
 $dj36,hours

JOB00036  $HASP890 JOB(DEST10)    HOURS=0

JES2 displays hours for job 36.

 10 
$dj1-999,hours

JOB00036  $HASP890 JOB(DEST10)    HOURS=0
JOB00037  $HASP890 JOB(DEST11)    HOURS=0
JOB00038  $HASP890 JOB(DEST12)    HOURS=0
JOB00039  $HASP890 JOB(DEST13)    HOURS=0
JOB00040  $HASP890 JOB(DEST14)    HOURS=0
JOB00041  $HASP890 JOB(DEST15)    HOURS=0
JOB00042  $HASP890 JOB(DEST16)    HOURS=0
JOB00043  $HASP890 JOB(DEST17)    HOURS=0

JES2 displays hours for each job in range of 1 through 999.

 11 
$dj36,age<1

JOB00036  $HASP890 JOB(DEST10)
$HASP890  JOB(DEST10)  STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890         PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)

JES2 displays job 36 if age is less than one day.

 12 
$djq,q=xeq,busy=no

JOB00036  $HASP890 JOB(DEST10)
$HASP890 JOB(DEST10) STATUS=(AWAITING EXECUTION),CLASS=A,
$HASP890  PRIORITY=9,SYSAFF=(ANY),HOLD=(NONE)

JES2 displays all jobs which are awaiting execution.

 13  $dj(*),jc=*:ordernumber123456*

JOB00109  $HASP890 JOB(WIDGETS)                                         C
$HASP890 JOB(WIDGETS)   STATUS=(AWAITING HARDCOPY),CLASS=A,              
$HASP890                PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE)              
JOB00110  $HASP890 JOB(GADGETS)                                         C
$HASP890 JOB(GADGETS)   STATUS=(AWAITING HARDCOPY),CLASS=A,              
$HASP890                PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE)              
JOB00111  $HASP890 JOB(PARTS)                                           C
$HASP890 JOB(PARTS)     STATUS=(AWAITING HARDCOPY),CLASS=A,              
$HASP890                PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE)              
JOB00112  $HASP890 JOB(SUPPLIES)                                        C
$HASP890 JOB(SUPPLIES)  STATUS=(AWAITING HARDCOPY),CLASS=A,              
$HASP890                PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE)              

JES2 displays batch jobs with a job correlator user portion starting with ORDERNUMBER123456.

 14  $dj(*),jc=*:ordernumber123456*,jc

JOB00109  $HASP890 JOB(WIDGETS)                                         C
$HASP890 JOB(WIDGETS)   JOBCORR=J0000109POK.....C88BD3D2.......:         
$HASP890                ORDERNUMBER123456                                
JOB00110  $HASP890 JOB(GADGETS)                                         C
$HASP890 JOB(GADGETS)   JOBCORR=J0000110POK.....C88BD3D3.......:         
$HASP890                ORDERNUMBER123456                                
JOB00111  $HASP890 JOB(PARTS)                                           C
$HASP890 JOB(PARTS)     JOBCORR=J0000111POK.....C88BD3D4.......:         
$HASP890                ORDERNUMBER123456                                
JOB00112  $HASP890 JOB(SUPPLIES)                                        C
$HASP890 JOB(SUPPLIES)  JOBCORR=J0000112POK.....C88BD3D5.......:         
$HASP890                ORDERNUMBER123456                                

JES2 displays the job correlator for batch jobs with a job correlator user portion starting with ORDERNUMBER123456.

 15  $dj109,jc

JOB00109  $HASP890 JOB(WIDGETS)                                         C
$HASP890 JOB(WIDGETS)   JOBCORR=J0000109POK.....C88BD3D2.......:         
$HASP890                ORDERNUMBER123456                                

JES2 displays the job correlator for batch job 109.