Displaying system activity

Use the DISPLAY JOBS (or J or A or TS) command to display information about current system activity. The descriptions of messages IEE114I and IEE115I show the resulting display. The syntax of this command is:

Start of change
 
D {JOBS|J|A}[,{LIST|L},[USERID=userid]]
or
D {TS}[,{LIST|L}]
                |,{ALL|A}
                |,{jobname[.identifier]|(jobname)}

   [,L={a|name|name-a}]
End of change

The parameters are:

JOBS or J or A or TS
The system is to display the following overview information about system activity:
  • Number of active batch jobs
  • Number of started tasks (MOUNT commands in execution are treated as started tasks)
  • Number of logged-on time-sharing users
  • Number or logged-on time-sharing users running under TSO/VTAM
  • The maximum number of time-sharing users allowed to be logged on under TSO/VTAM
  • Number of active system address spaces
  • Number of active initiators including Advanced Program-to-Program Communication/MVS (APPC/MVS) transaction initiators
  • Number of z/OS® UNIX System Services address spaces
LIST or L
The system is to display detailed information for active jobs and started tasks (JOBS or J), logged-on time-sharing users (TS), active APPC/MVS transaction programs, or all three (A).
ALL or A
The system is to display more detailed information for active jobs and started tasks, logged-on time-sharing users, active APPC/MVS transaction programs, active initiators, and active system address spaces than that supplied by LIST.
jobname[.identifier] or (jobname)
The system is to display detailed information for active jobs, started tasks, logged-on time-sharing users, active APPC/MVS transaction programs, active initiators, and active system address spaces with the specified name. This information includes the data space names associated with the address space. If the specified name is the same as a valid secondary operand, you must enclose it in parentheses. (See Example 7.)
The specified name can be the name of a job, started task, APPC/MVS transaction program, APPC/MVS scheduler initiator, time-sharing user, or system address space. For a job, started task, APPC/MVS transaction program, APPC/MVS scheduler initiator, or system address space, the name can be 1 to 8 alphanumeric or national characters or 1 to 7 alphanumeric or national characters followed by an asterisk. For a time-sharing user, the name can be 1 to 7 alphanumeric or national characters or 1 to 6 alphanumeric or national characters you use the asterisk format, all jobs, APPC/MVS transaction programs, APPC/MVS scheduler initiators, started tasks, or time-sharing users with names that begin with the specified characters are displayed. See Example 5.
Note:
  1. You can use asterisk notation to display information about more than one job or started task. See Using wildcards to display system activity for more information.
  2. The only time you may use an asterisk in the first position of a name is to specify the master scheduler address space: *MASTER*. For *MASTER*, the name must be the complete address space name.
  3. Started task names can come from a variety of sources. The name of a started task depends on whether the JOBNAME keyword was specified on the START command.

    If JOBNAME was specified, jobname is the name assigned to the started task.

    If JOBNAME was not specified and the source JCL for the started task is:
    • A job, the system uses the jobname provided with the JCL JOB statement.
    • A procedure, the system uses the member name as the jobname.

    Refer to Displaying started task status for information on determining the jobname and identifier of currently active started tasks.

identifier
The started task identifier. You can use asterisk notation to display information about more than one job or started task. See Using wildcards to display system activity for more information.
USERID=userid
A filter to display only the work executing on behalf of userid. This userid may be specified on the USER= keyword in JCL, or the userid that requested that a transaction occur.
L=a, name, or name-a
Specifies the display area (a), console name (name), or both (name-a) where the display is to appear.

If you omit this operand, the display is presented in the first available display area or the message area of the console through which you enter the command.

Parent topic: DISPLAY command