You can display job information to monitor the JES2
system and control job processing. Displaying information such as
the amount of output for jobs in the held output class and the output
processing characteristics of designated output groups enables you
to plan job execution. You may wish to change some of this information
to process jobs more efficiently. (For information about the $T commands
you can specify to change output processing characteristics, see “Controlling
Job Output”).
Using the MVS™ CONTROL command, you can include the job
identifier in the message output. For example, you first enter the MVS command
CONTROL S,MFORM=(J)
Now, when you enter
JES2 commands such as:
$d jq'myjob'
JOB00017 $HASP890 JOB(MYJOB)
$HASP890 JOB(MYJOB) STATUS=(AWAITING EXECUTION),CLASS=H,
$HASP890 PRIORITY=9,SYSAFF=(ANY),HOLD=(JOB)
the
job identifier is displayed before the message number. For more information
about using the MVS CONTROL command see
z/OS MVS System Commands, SA38-0666.
JES2 allows you to display the following job information:
- Number of jobs on a queue
- The $D Q command displays the number of jobs on a particular queue.
The parameters on this command allow you to display detailed job information,
including the percentage of spool disk utilization for all jobs that
have data on the spool volume specified on the V=volser parameter.
- Number of jobs on the rebuild queue
- Use the $D REBLD command to display all job output elements (JOEs)
and job queue elements (JQEs) on the rebuild queue and the total number
of each. JES2 moves JOEs and JQEs to the rebuild queue when JES2
determined that particular element was not valid or corrupted. Typically
the rebuild queue is empty; however, you might find this command useful
if:
- You receive messages indicating that JOEs or JQEs are pending
discard and you require further information.
- In response to other display commands, JES2 indicates the job
is not found or found on the rebuild queue.
- Currently active jobs
- Use the $D A command to display information about currently active
jobs (batch jobs, started tasks, and time-sharing users). You can
also display information about jobs being processed on unit record
devices or spool offload devices. For example, issuing $D A,SYSA,DEV,L=4A
displays information on area A of console 4 for all jobs (batch,
STCs, and TSUs) active on unit record devices on the member whose
identifier is SYSA.
The MVS DISPLAY
ACTIVE command provides further information about active jobs. For
a description of this command, see z/OS MVS System Commands, SA38-0666
.
- For specific jobs
- To display information about a specific job or range of jobs,
issue the $D job command. The $HASP890 message displays number, name,
status, class, priority, and spool volume information for the specified
job(s).
- Job output forms queue
- Use the $D F command to display the number of data sets queued
for output. The $HASP621 message displays the destination and processing
requirements (such as forms, carriage, print train, bursting) of the
work on the output forms queue.
Note: The $D F command does not display
specific job information; it displays only the number of queued elements
according to their attributes.
- Job queue information
- Use the $D N command to display information about a specific job
or range of jobs:
- Whose affinities include that specified (member name)
- With affinities of ANY
- For all jobs in the MAS configuration (ALL)
- For all jobs whose affinity is for members operating in independent
mode (IND)
The $HASP890 message displays number, name, status, class,
priority, and affinity information. The $HASP646 message displays
the percentage of spool disk utilization for the specified jobs that
have data on the spool volume specified on the V=volser parameter.
- Output information
- Use the $L job command to display the number of held or non-held
data sets for a specified job or range of jobs. Use the $DO Job command
to display the output processing characteristics of specified output
groups or individual job output elements (JOEs).
- For a job at another node
- Issue
the $G D command to display information about jobs you previously
routed for execution at another node (by using the $R XEQ,D= command)
or to display information about any job at any node (subject
to your node's command authority at that node). You must specify the
O= parameter if the job did not originate at your node.
You can
also use the $G D command to locate a job. By omitting the destination
name, you are effectively issuing a global locate command that is
sent to all reachable nodes in the network. Each node responds individually
in this case.
- Display a message
- Issue the $D M command to display a message on a specified operator
console or a range of consoles. This includes remote workstations
at other nodes and consoles at other MAS members.
You may also use this
command to send a message to an executing job's JES2 job log. The
job can be on any member of the MAS, but must be currently executing
within the MAS, not awaiting execution or output.