z/OS JES2 Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Displaying job information

z/OS JES2 Commands
SA32-0990-00

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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014