| Where allowed to run: All
environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display Access Group (DSPACCGRP) command shows, for each selected job, the process access group (PAG) size, the names and I/O counts for open files, and the program data storage used. It also optionally writes this information to a database file for further analysis by the Analyze Access Group (ANZACCGRP) command.
Jobs can be selected for the report using several selection values, including job type, job name, user name, and job number. The job name and user name may be generic; only the first characters of the corresponding information for a job need match the specified value for selection of the job. Only jobs that match all specified selection values are selected.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| JOB | Job name | Single values: *, *SEC, *INT Other values: Qualified job name |
Optional, Positional 1 |
| Qualifier 1: Job name | Generic name, name, *ALL | ||
| Qualifier 2: User | Generic name, name, *ALL | ||
| Qualifier 3: Number | 000000-999999, *ALL | ||
| TITLE | Report title | Character value, *BLANK | Optional |
| OUTPUT | Output type | *, *PRINT, *FILE, *BOTH | Optional |
| MBR | Output file member | Name, QAPAGDTA | Optional |
| LIB | Output file library | Name, QPFRDATA | Optional |
| CLEAR | Clear existing data | *YES, *NO | Optional |
| Top |
Specifies the jobs to select. The parameter value specified can be a special single value or a three-part job identifier. If no job qualifier is given, all of the jobs currently in the system are searched for the name of the job. If duplicates of the specified name are found, a qualified job name must be specified.
A job identifier is a special value or a qualified name with up to three elements. For example:
The special single values are:
If the value is other than one of the above special values, it is interpreted as a three-part job identifier (job-number/user-name/job-name). All three parts need not be specified.
| Top |
Specifies a short title that is printed in the heading at the top of each page of the report.
| Top |
Specifies the type of output being produced. If * or *PRINT is specified on this parameter, the following parameters are ignored:
| Top |
Specifies the member in file QAPTPAGD in which to save the process access group data. If the member does not exist, it is added to the file. If the member exists, the new data replaces or extends the old contents, depending on the value of the Clear existing data prompt (CLEAR parameter).
| Top |
Specifies the library where the object is saved. If the library does not contain a file named QAPTPAGD, one is created.
| Top |
Specifies whether existing data in the specified member is overwritten, or new data is added to the existing data.
| Top |
Example 1: Displaying Access Group Information
DSPACCGRP JOB(GL*)
This command selects all active jobs with names starting with GL. Because GL* is not one of the special single values, it is interpreted as a three-part job identifier. Because only one part is given, it is taken to be the job name, and the job number and user name default to *ALL. Because no OUTPUT value is specified, output is displayed if there is only one GL job. A report is spooled if there is more than one GL job.
Example 2: Writing Access Group Information to a Database File
DSPACCGRP JOB(*ALL) OUTPUT(*FILE) MBR(SAMPLE1)
This command writes the process access group information for all active jobs to member SAMPLE1 of the database file QPFRDATA/QAPTPAGD for later analysis by the ANZACCGRP command.
Example 3: Displaying All Access Group Information for a Job
DSPACCGRP JOB(001234/*ALL/*ALL)
This command displays the process access group information for job number 001234. Since the job number is guaranteed to uniquely identify the job, a report cannot be spooled (no more than one job can be selected).
Example 4: Displaying Access Group Information for a Job
DSPACCGRP JOB(WILLIAMS/AP*)
This command selects all jobs with a user name of WILLIAMS and a job name beginning with AP.
| Top |
*ESCAPE Messages
| Top |