Using wildcards to display system activity

You can use the asterisk (*) wildcard to display information about more than one job or started task. A trailing asterisk (*) indicates that a DISPLAY command applies to all jobs or started tasks that match a leading character string. The DISPLAY JOBS, J, A, or TS command supports only a trailing asterisk. You cannot specify an asterisk in other character positions in job or started task names.

For example, you can enter the following command to display information about all jobs and started tasks beginning with the characters X11:
D A,X11*

You can also use the asterisk wildcard to specify both a job name and identifier. The system displays information about all jobs and started tasks that match the combinations of characters that precede one or more asterisks.

For example, you can enter the following command to pass a two-digit value to all jobs with names that begin with J22 and identifiers that begin with X11:
D A,J22*.X11*
Remember the following rules when using the asterisk wildcard in the DISPLAY JOBS, J, A, or TS command:
  • If you specify both the jobname and identifier values, you cannot specify a single asterisk for both values.
    For example, to display information about all jobs with names beginning with J22, you can specify a single asterisk on the identifier to indicate a wildcard:
    D A,J22*.*

    If you were to remove the J22 characters from the command, it would not be valid. You cannot specify *.* without a leading character string on the jobname parameter, the identifier parameter, or both.

  • A slash (/) cannot precede an identifier that contains an asterisk.

The following tables describe how the asterisk wildcard works with DISPLAY JOBS, J, A, or TS. Table 1 shows examples of START commands used to start jobs. The third and fourth columns show the associated jobnames and identifiers.

Table 1. Examples of START Commands to Start Jobs
Job Number START Command Jobname Identifier
1 START YZ YZ YZ
2 START WX.YZ WX YZ
3 START WX.YZ1 WX YZ1
4 START WX1.YZ1 WX1 YZ1
5 START WX, JOBNAME =WX1 WX1 WX1
6 START WX, JOBNAME =WX2 WX2 WX2
7 START WX, JOBNAME =YZ YZ YZ
8 START Q.YZ3 Q YZ3
9 START WX.R1 WX R1
10 START WX, JOBNAME =YZ4 YZ4 YZ4

Table 2 shows examples of DISPLAY commands. (The examples apply to DISPLAY JOBS, J, A, or TS, although only DISPLAY A commands are used in this figure.) The numbers in the second column indicate the jobs in Table 1 that apply to each DISPLAY command.

Table 2. Examples of DISPLAY Commands
DISPLAY Command Displayed Jobs
D A,YZ 1, 7
D A,WX.YZ 2
D A,WX.YZ* 2, 3
D A,YZ.* 1, 7
D A,WX* 2, 3, 4, 5, 6, 9
D A,YZ* 1, 7, 10
D A,WX*.YZ 2
D A,WX*.YZ* 2, 3, 4
D A,*.YZ* 1, 2, 3, 4, 7, 8, 10
D A,*.YZ 1, 2, 7
D A,WX*.* 2, 3, 4, 5, 6, 9
D A,WX.* 2, 3, 9
D A,* Not valid (can be done using D A,ALL)
D A,*.* Not valid (can be done using D A,ALL)

The following are examples of various forms of the DISPLAY JOBS, J, A, or TS command:

Example 1:

To display detailed information about all active units of work, enter:
D A,L
 

Example 2:

To display detailed information about active jobs, enter:
D J,L

Example 3:

To display more detailed information about active jobs, enter:
D J,A

Example 4:

To display detailed information about any active time-sharing user with the name WAGNERJ, enter:
D TS,WAGNERJ

Example 5:

To display detailed information about all active jobs, started tasks, time-sharing users, or address spaces with the name beginning with D96, enter:
D A,D96*

Example 6:

To display detailed information about the master scheduler address space, enter:
D A,*MASTER*

Example 7:

To display detailed information about any active time-sharing user with the name LIST, enter:
D TS,(LIST)

Example 8:

To display detailed information about all jobs or APPC/MVS transaction programs running for user WANDA, enter:
D J,L,USERID=WANDA

Example 9:

To display detailed information about any jobs or APPC/MVS transaction programs named PHONE running for user WANDA, enter:
D J,PHONE,USERID=WANDA

Example 10:

To display detailed information about all initiator address spaces beginning with INIT, enter:
D A,INIT*

Example 11:

To display detailed information about started task X11 which has a job name of AOR2, enter:
D A,AOR2.X11

Example 12:

To display detailed information about all started tasks with the job name AOR2, enter:
D A,AOR2.*

Example 13:

To display detailed information about all started tasks with a job name of AOR2 and identifiers that start with T1, enter:
D A,AOR2.T1*

Example 14:

To display detailed information about all started tasks with job names that start with AOR and identifiers that start with T1, enter:
D A,AOR*.T1*

Example 15:

To display detailed information about all started tasks with identifiers that start with T1, enter:
D A,*.T1*