$D Job - Display information about specified jobs

Function

To display the following job information for a specified job:
  • Number
  • Name
  • Status
  • Class
  • Priority
  • Spool Volumes

Syntax

Read syntax diagramSkip visual syntax diagram$D JobJOBQJQStcTsu nn-mm*'job'(,nn*-mm*job'job'*) Selection limiting keywordsDisplay limiting keywords
Display limiting keywords
Read syntax diagramSkip visual syntax diagram,ABCMP,ABNORMAL,AFTER,ARM_element,BEFORE,BERTNUM,BUSY=,CARDS,CC=( ,ABENDCODEJOBRCRCTYPE),Class,CMDauth,CONjobs,CRTIME,AgeDAys,DELAY,DJC,DUBIOUS,DUPL_EXEMPT,EOM,HOLD,HOLDUNTL,Hours,INITASID,JC,JOBCORR,JOBGROUP,JMJOBMASK,JOEBERTS,JOENUM,LONG,NORMAL=,NHOLD=,NRCMP=,OFFS,OPHOLD=,Priority,PRIVILEGE,Queue,REBUILD,REQuires_zos,SCH_AFTER,SCH_BEFORE,SCHENV,SCHENV_AFF,SECLABEL,SECLABEL_AFF,SPINNABLE,SPLSPOOL=( %PercentTgsVolumes),SRVCLASS,STARTBY,STATUS,Sysaff,TYPE,USERID,WITH,XEQNode,XEQHours
Selection limiting keywords
Read syntax diagramSkip visual syntax diagram,ABCMP= KEEPNOKP,ABNORMAL= DFR,/ARM_element=¬=NoYes,/BERTNum=¬=><nn,BUSY=YESANYNONONE,/CANCEL=¬=NoYes,/CARDS=¬=><cards,/CC=( ,/ABEND=¬=system(system,user)/CODE=¬=><code),/Class=¬=><class,/CMDauth=¬=cmdauth(,cmdauth),/Age/DAys><days,/DELAY=¬=BUSY_ON_DEVICEHOLDJOBCLASSLIMIT(1)LIMIT(2)LOCKEDMEMBER_STATUSNoQUEUE_ERRORSCHENVSECLABELSPOOLS_NOT_AVAILABLESRVCLASSSYSAFFYesWITHZOS_LEVELGRP_HOLDGRP_SCHENVGRP_SECLABELGRP_SYSAFFGRP_MEMBER_STATUSSCH_DEPSET_CAPACITYSET_HOLDSET_INTERNAL_ERRORSET_JOBCLASSSET_LIMITSET_LOCKEDSET_SPOOLSET_SCHENVSET_SECLABELSET_STATUSSET_SYSAFFSET_WITHSET_ZOS_LEVEL,DJC= YESNO,/DUBIOUS=¬=YesNo,/DUPL_EXEMPT=¬=YesNo,/EOM=¬=YesNo,/HOLD=¬=ALLARMDUPJOBNONE,/Hours><hours,/JOBGROUP=^=><jobgroupname,/INITASID=¬=><initasid,/JC/JOBCORR=^=><job correlator,/JM/JOBMASK=¬=><jobmask,/JOEBerts=¬=><nn,/JOENum=¬=><nn,NORMAL= DFR,NHOLD= xx,NRCMP= HOLDNOHOFLSH,OPHOLD= YESNO,/OFFS=¬=offs(,offs),/Priority=¬=><priority,PRIVILEGE= YESNO,/PURGE=¬=NoYes,/Queue=¬=CNVINPUTOUTPPUPURGERCVSETUPSPINXEQXMT,/REBUILD=¬=NoYes,/SCH_AFTER=¬=><name,/SCH_BEFORE=¬=><name,/SCHENV=¬=><schenv,/SCHENV_AFF=¬=member(,member),/SECLABEL_AFF=¬=member(,member),/SECLABEL=¬=><seclabel,/SPINNABLE=¬=NoYes,/SPL/SPOOL=( ,/%/Percent><percent/Tgs><tgs/Volumes=¬=volume(,volume)),/WITH=¬=><name,/SRVCLASS=¬=><srvclass,/XEQHours><hours
Notes:
  • 1 cmdauth can be coded up to 2 times
  • 2 offs can be coded up to 8 times
  • 3 member can be coded up to 33 times
  • 4 member can be coded up to 33 times
  • 5 volume can be coded up to 253 times

Parameters

ABCMP{KEEP|NOKP}
Is valid if DJC=Yes. KEEP or NOKP specifies the action to take if the job abnormally terminates.
KEEP
Indicates that the DJC network is to be kept in the system until:
  1. The job is resubmitted and completes normally or,
  2. The operator forces the network from the system.
Use KEEP to make sure that the network is not purged until the operator takes proper action.
Note: If the job abnormally terminates, resubmit the job to the DJC network, and the network is retained until the job completes.
NOKP
Indicates that JES2 is to purge the DJC network if the job abnormally terminates and was not resubmitted by the time the other jobs in the network completed. JES2 purges the network unless successor jobs or subnetworks are missing. If the ABCMP parameter is omitted, NOKP is the default.
ABNORMAL={D|F|R}

Is valid if DJC=Yes. Indicates that the action JES2 is to take for this job when any predecessor job completes execution abnormally. Abnormal is defined as anything other than (RUN & !ABEND). If the ABNORMAL parameter is omitted, the default is R.

D
Requests that JES2 decrease the NHOLD count of this job, which indicates the number of predecessors for this job. When the NHOLD count becomes zero, JES2 can schedule this job.
F
Requests that JES2 flush (cancel) this job and its successor jobs. JES2 cancels the job and cancels all successor jobs presently in the system, regardless of their normal or abnormal specifications.
R
Requests that JES2 retain this job in the system and not decrease the NHOLD count. R suspends the job and its successor jobs from scheduling until either the predecessor job is resubmitted or the operator decreases the NHOLD count.
AFTER
Display all of the jobs in the job group that need to run AFTER the selected job and display the status of their dependencies.
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.
Age is computed by subtracting the job's "begin time" from the current time. That is, the time that the job was initially added to its current queue is the "begin time" except:
  • The "begin time" for jobs that are actively running is the same as the time the command was entered. That is, the age for running jobs is always zero days and hours.
  • The "begin time" for jobs in the OUTPUT or HARDCPY queue is the time that the job ended execution. If the job does not run, then the time is the time that the job was placed in its prior queue.
ARM_element={No|Yes}
Displays whether (Yes) or not (No) the job is registered with the Automatic Restart Management (ARM).
BEFORE
Display all of the jobs in the job group that need to run BEFORE the selected job and display the status of their dependencies.
BERTNUM=[(nnnnn)]
Nnnnn is the count of BERTs that are used by this job queue element (JQE).
BUSY=
Specifies one of the following:
  • The system name or number on which the job is busy. You can specify a value of 0 to indicate that 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 that were canceled (Yes) or were not canceled (No).
CARDS=cards
Displays the number of input cards that are associated with the job.
CC=(ABEND|ABENDED|CANcelled|CNVT_abend|CODE| COMPleted|ENDed_by_cc|EOM_failure|FLUSHED|JCLerror| JOBRC|RC|SECurity_failure|TYPE)
Displays the completion information that is associated with the job.
ABENDED
Display only jobs that ended abnormally.
ABEND
Displays the ABEND code that is associated with the job's termination.
CANcelled
Display only jobs that were canceled by the operator.
CNVT_abend
Display only jobs that ended abnormally during the conversion phase.
CNVT_ERROR
Specifies job that failed due to a converter error.
CODE
Displays the last (or highest) completion code of steps in the job.
COMPleted
Display only jobs that completed.
ENDed_by_cc
Display only jobs that were ended by a step completion code.
EOM_failure
Display only jobs that failed in end-of-memory processing.
FLUSHED
The job was cancelled (flushed) and is no longer eligible to run.
JCLerror
Display jobs that 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 that failed security validation.
SYSTEM_FAILURE
Specifies jobs that failed due to system failure.
Class=class
Specifies a job class that is 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 remotes or nodes are displayed. The valid specifications are as follows:
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.
CONjobs
Displays all jobs in the job group that need to run concurrently (at the same time) as the selected job.
CRTIME
Displays the creation date and time of the job.
DELAY={BUSY_ON_DEVICE|HOLD|JOBCLASS|LIMIT(2)|LOCKED|MEMBER_STATUS|No|
QUEUE_ERROR|SCH_DEP|SCHENV|SECLABEL|SPOOLS_NOT_AVAILABLE|SRVCLASS|SYSAFF|
WITH|Yes|ZOS_LEVEL|
GRP_HOLD|GRP_SCHENV|GRP_SECLABEL|GRP_SYSAFF|GRP_MEMBER_STATUS|
SET_BUSY|SET_CAPACITY|SET_HOLD|SET_INTERNAL_ERROR|SET_JOBCLASS|SET_LIMIT|
SET_LOCKED|SET_SPOOL|SET_SCHENV|SET_SECLABEL|SET_STATUS|SET_SYSAFF
SET_WITH|SET_ZOS_LEVEL}
Displays reasons why a pre-execution job does not enter execution:
BUSY_ON_DEVICE
The job does not execute because it is busy on a device (such as an offload job transmitter).
GRP_HOLD
Job registered to a job group does not execute because the job group is held.
GRP_MEMBER_STATUS
Applies to jobs registered to a job group. Same as MEMBER_STATUS but takes into account the state of the job group.
GRP_SCHENV
Applies to jobs registered to a job group. Same as SCHENV but takes into account the scheduling environment of the job group.
GRP_SECLABEL
Applies to jobs registered to a job group. Same as SECLABEL but takes into account the security label of the job group.
GRP_SYSAFF
Applies to jobs registered to a job group. Same as SYSAFF but takes into account the system affinity of the job group.
HOLD
The job does 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 does not execute because the job class execution limit was reached (as specified by JOBCLASS XEQCOUNT=(MAX=)).
LIMIT(2)
The job does not execute because the job class execution limit was 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 does not execute because it's being updated by JES2.
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 was issued.
  • $P XEQ command was issued.
  • BOSS=NO (used in a poly-JES environment only).

When used as a command filter, the string MEMBER_STATUS matches on jobs that were 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.

SCH_DEP
The job does not execute because the job is currently delayed because of SCHEDULE DELAY=YES or SCHEDULE AFTER=.
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 before conversion due to system affinity requirements, scheduling environments are not considered in determining delay status.

SECLABEL
The security label (SECLABEL) assigned to the job is not defined as active on any member that is active.
SET_BUSY
Applies to jobs that are part of a concurrent set. Job does not execute because one or more jobs in the concurrent set are busy on some device such as an offload job transmitter.
SET_CAPACITY
Applies to jobs that are part of a concurrent set. Job does not execute because no system in a SYSPLEX has sufficient capacity currently to run the jobs in the concurrent set.
SET_HOLD
Applies to jobs that are part of a concurrent set. Same as HOLD but takes into account the status of all jobs in the concurrent set.
SET_INTERNAL_ERROR
Applies to jobs that are part of a concurrent set. Job does not execute because of an internal error in managing jobs in the concurrent set.
SET_JOBCLASS
Applies to jobs that are part of a concurrent set. Same as JOBCLASS but takes into account the states of the job classes of all jobs in the concurrent set.
SET_LIMIT
Applies to jobs that are part of a concurrent set. Same as LIMIT but takes into account the states of the job classes of all jobs in the concurrent set.
SET_LOCKED
Applies to jobs that are part of a concurrent set. Job does not execute because one or more jobs in the concurrent set are locked (being updated by JES2).
SET_SCHENV
Applies to jobs that are a part of a concurrent set. Same as SCHENV but takes into account the scheduling environments of all jobs in the concurrent set.
SET_SECLABEL
Applies to jobs that are part of a concurrent set. Same as SECLABEL but takes into account the security labels of all jobs in the concurrent set.
SET_SPOOL
Applies to jobs that are part of a concurrent set. Same as SPOOLS_NOT_AVAILABLE but takes into account the SPOOL volumes of all jobs in the concurrent set.
SET_STATUS
Applies to jobs that are part of a concurrent set. Same as MEMBER_STATUS but takes into account the state of all jobs in the concurrent set.
SET_SYSAFF
Applies to jobs that are part of a concurrent set. Same as SYSAFF but takes into account the system affinity of all jobs in the concurrent set.
SET_WITH
Applies to jobs that are part of a concurrent set. Same as WITH but takes into account the status of all jobs in the concurrent set.
SET_ZOS_LEVEL
Applies to jobs that are part of a concurrent set. Same as ZOS_LEVEL but takes into account the minimum z/OS level requirements of all jobs in the concurrent set.
SPOOLS_NOT_AVAILABLE
Job does not execute because not all SPOOL volumes used by this job are available.
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).
WITH
The job does not execute because the reference job specified using the WITH keyword of the SCHEDULE JCL statement is not active.
ZOS_LEVEL
The job does 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 that are delayed for any of the above reasons.
No
Display only jobs that are not delayed for any of the above reasons.
DJC=YES|NO
Indicates whether the job belongs to a DJC network identified by JOBGROUP=. NETID corresponds to JOBGROUP= value.
YES
The job belongs to DJC.
NO
The job does not belong to DJC.
DUBIOUS=YES|NO
Indicates whether the job is considered dubious based on NJE path verification processing. A job is considered dubious if the job:
  • Was marked dubious by another node in the NJE network.
  • Arrived from NJE but claims to be from the local node.
  • Claims to originate from an unknown NJE node.
  • Violated the subnet routing rules.
  • Arrived by way of NJE store and forward but claims to be from a node that is defined as DIRECT=YES.
  • Specifies to run on the adjacent node from which it just arrived.
  • Has inconsistent origin node information (origin node in the NJE Header and SAF token do not match).
Start of changeDUPL_EXEMPT={No|Yes}End of change
Start of changeIndicates whether this job is exempt from processing for duplicate jobs (jobs with the same name).End of change
EOM={No|Yes}
Displays whether the job is 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.
HOLDUNTL
Displays date and time when the job is scheduled to be released according to HOLDUNTL parameter on SCHEDULE JCL statement. See details in z/OS MVS JCL Reference.
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.
JOBGROUP=jobgroupname
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 group name matches this combination of characters (mask).
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 wildcards, 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.
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.
JOEBERTS=[(nnnnn)]
Nnnnn is the count of BERTs that are used by the job output elements (JOEs) that are associated with this job.
JOENUM=[(nnnnn)]
Is the count of JOEs that are used by this job queue element (JQE).
LONG
If you specify the LONG operand, JES2 displays the following information:
  • The user ID of the job.
  • The spool volumes on which the specified jobs have space that is allocated.
  • The remote consoles or nodes that can enter commands that affect a job (CMDAUTH).
  • Whether the job uses the automatic restart management services.
  • The job group that is associated with the selected job.
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.
NORMAL={D|F|R}

Is valid if DJC=Yes. Indicates that the action JES2 is to take for this job when any predecessor job completes execution normally. Normal is defined as (RUN & !ABEND). If the NORMAL parameter is omitted, the default is D.

D
Requests that JES2 decrease the NHOLD count of this job, which indicates the number of predecessors for this job. When the NHOLD count becomes zero, JES2 can schedule this job.
F
Requests that JES2 flush (cancel) this job and its successor jobs. JES2 cancels the job and cancels all successor jobs presently in the system, regardless of their normal or abnormal specifications.
R
Requests that JES2 retain this job in the system and not decrease the NHOLD count. R suspends the job and its successor jobs from scheduling until either the predecessor job is resubmitted or the operator decreases the NHOLD count.
NHOLD=xx
Is valid if DJC=Yes.
Indicates the number of predecessor job completions that are required before this job is released for scheduling. The predecessor number can include jobs from another DJC network. n is a number from 0 through 32,767. When the predecessor number reaches 0, the job is scheduled for execution. The system reduces this number:
  • When each predecessor job completes execution.
  • By operator command.
If you specify NHOLD=0 or omit the NHOLD parameter, this job has no predecessor jobs. JES3 can schedule it for immediate execution.
NRCMP={HOLD|NOHO|FLSH}
Is valid if DJC=Yes. NRCMP=HOLD or NOHO or FLSH indicates that this job completed normally and is being resubmitted. The job does not enter the job net, and all references to the job are erased.
HOLD
Indicates to hold the job to be released by the operator. This is the default.
NOHO
Schedules the job as system resources become available.
FLSH
Flushes the job from the system without executing it.
OFFS=offs
Displays offload device numbers on which the job was archived.
OPHOLD={YES|NO}
Is valid if DJC=Yes.
YES
Holds the job until released by the operator.
NO
Does not hold the job. This is the default.
Priority=priority
Displays the priority of the job.
PRIVILEGE={YES|NO}
Indicates whether the job is privileged (YES) or not privileged (NO).
PURGE={No|Yes}
Indicates that only jobs that 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.
SCH_AFTER
Displays the name of the referenced job that is provided on the AFTER= parameter of the SCHEDULE JCL statement. For more information, see in z/OS MVS JCL Reference.
SCH_BEFORE
Displays the name of the referenced job that is provided on the BEFORE= parameter of the SCHEDULE JCL statement. For more information, see in z/OS MVS JCL Reference.
SCHENV=schenv
Displays the scheduling environment that is 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 that is 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 that have allocated spool space on the specified spool volume 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.
STARTBY
Displays the preferred date and time when job should enter execution according to STARTBY parameter on SCHEDULE JCL statement. See details in z/OS MVS JCL Reference.
Stc
A started task or range of started tasks is to be displayed.
Sysaff=member
Displays the job's system affinity.
Tsu
A time-sharing user or range of time-sharing users is to be displayed.
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 user ID that associated with the job.
WITH
Displays the name of the reference job that is provided on WITH parameter on SCHEDULE JCL statement. For more information, see z/OS MVS JCL Reference.
XEQNODE=xeqnode
Only jobs that are destined to execute at the specified node, or that have already executed at the specified node, are to be displayed. The node name can be specified using the decimal node number (Nnnnnn) or an EBCDIC node name.
XEQHours=hours
Specifies the number of hours that a job has been executing. Only jobs that run more (with XEQH>nn) or less (with XEQH<nn) than the specified number of hours are affected, with the restriction that requires that the jobs must be executing.

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.

Processing Considerations

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

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 that do not execute because the scheduling environment is unavailable. In this example, job BATCH3 does 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 that use more than 1% of spool, which uses 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 that 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.

JES2 displays the jobs that depend on the selected job.
 16   $dj10,after

JOB00010  $HASP890 JOB(JOBA)                                        
 $HASP890 JOB(JOBA)      DEPENDENCY LIST - JOB AS PARENT             
 $HASP890                PARENT    DEP JOB   DEP STAT  COMP ACT      
 $HASP890                --------  --------  --------  ---------     
 $HASP890                JOBA      JOBB      PENDING   SATISFY       
 $HASP890                JOBA      JOBC      PENDING   SATISFY                             

JES2 displays the jobs that the selected job depends on.
 17   $dj11,before

OB00011  $HASP890 JOB(JOBB)                                        
 $HASP890 JOB(JOBB)      DEPENDENCY LIST - JOB AS DEP JOB            
 $HASP890                PARENT    DEP JOB   DEP STAT  COMP ACT      
 $HASP890                --------  --------  --------  ---------     
 $HASP890                JOBA      JOBB      PENDING   SATISFY                      

JES2 displays the jobs that run concurrently (at the same time) as the selected job.
 18   $dj10,conjobs

OB00010  $HASP890 JOB(JOBA)                             
 $HASP890 JOB(JOBA)      JOB GROUP CONCURRENT JOB LIST    
 $HASP890                JOB NAME   CONC JOB              
 $HASP890                --------   --------              
 $HASP890                JOBA       JOBF                  
 $HASP890                JOBA       JOBG