Display Access Group (DSPACCGRP)

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

Parameters

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

Job name (JOB)

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:

*
Only the current job is selected.
*SEC
The secondary interactive job is selected (system request may be used to switch between two different jobs; of these, *SEC is the job opposite the current job).
*INT
All interactive jobs are selected.

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.

job-number
Specify the number of the job to select. This can be either *ALL (select all active jobs that meet the other selection values), or the 6-digit number that uniquely identifies the job in the system (all 6 digits must be entered; use leading zeros if necessary).
user-name
Specify the user name of the job to select. This may be *ALL, a specific user name, or a generic user name (a name ending in *). Because several jobs may be running with the same user name, this value may not uniquely identify a specific job.
job-name
Specify the name of the job to select. This may be *ALL, a specific job name, or a generic job name (a name ending in *). Because several jobs may be running with the same job name, this value may not uniquely identify a specific job.
Top

Report title (TITLE)

Specifies a short title that is printed in the heading at the top of each page of the report.

*BLANK
No title is used.
report-title
Specify a title of up to 30 characters enclosed in apostrophes.
Top

Output type (OUTPUT)

Specifies the type of output being produced. If * or *PRINT is specified on this parameter, the following parameters are ignored:

*
If parameter values are specified that result in several jobs being selected, such as *ALL or a generic job name on the Job name prompt (JOB parameter), this option is equivalent to specifying *PRINT. Otherwise, the job's process access group information is shown at the work station.
*PRINT
The output is written to the printer file QPPTPAG.
*FILE
The output is saved in the database file QAPTPAGD for later analysis with the Analyze Access Group (ANZACCGRP) command. This is useful when many jobs are selected.
*BOTH
The output is saved in the database file (*FILE option). It is also either shown or printed (* option).
Top

Output file member (MBR)

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).

QAPAGDTA
The standard member name, QAPAGDTA, is used.
member-name
Specify the name of an alternate member in which to save the data. This allows several sets of process access group data to be kept.
Top

Output file library (LIB)

Specifies the library where the object is saved. If the library does not contain a file named QAPTPAGD, one is created.

QPFRDATA
The process access group data is stored in the IBM-supplied performance data library, QPFRDATA.
library-name
Specify the name of an alternate library in which to record the process access group data. This is necessary if access to the default library is not allowed.
Top

Clear existing data (CLEAR)

Specifies whether existing data in the specified member is overwritten, or new data is added to the existing data.

*YES
Any existing data is erased before the new data is written (the new data overwrites the old).
*NO
Any existing data is kept, and the new data is added to it. This may be used to accumulate process access group data on multiple sets of jobs.
Top

Examples

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

Error messages

*ESCAPE Messages

CPF9801
Object &2 in library &3 not found.
CPF9802
Not authorized to object &2 in &3.
PFR5411
Job not found.
PFR5412
No secondary interactive job is active.
PFR9802
Unexpected message monitored.
Top