DSPACCGRP (Display Access Group) Command Description

Notes:

• This command is part of the 5722-PT1 (Performance Tools for iSeries) licensed program.
• You should not use this command because the Licensed Internal Code no longer uses process access groups for caching data used by a job.

DSPACCGRP Command syntax diagram

Purpose

The Display Access Group (DSPACCGRP) command shows, for each selected job, the process access group (PAG) size, the names and I/O counts for all open files, and the program data storage used. It also optionally writes this information to a database file for further analysis by the Analyze Process Access Group (ANZACCGRP) command.

Jobs can be selected for the report by using several criteria, including job type, job name, user name, and job number. The job and user names may be generic; only the first characters of the corresponding information for a job must match the specified value for selection of the job. Only jobs that match all specified criteria are selected.

Optional Parameters

JOB

Specifies the jobs being selected. 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:

*
*SEC
*INT
*ALL
job-name
user-name/job-name
job-number/user-name/job-name

*: Only the current job is selected.

*SEC: The secondary interactive job is selected (when system request is used to switch between two jobs, *SEC is the job opposite the current job).

*INT: All interactive jobs are selected.

If the value is other than one of the preceding values, it is interpreted as a three-part job identifier (although all three parts need not be specified).

*ALL: All of the jobs are selected.

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.

user-name: Specify the name of the user 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-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 six digits must be entered. Use leading zeros if necessary.

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.

OUTPUT

Specifies the type of output to produce. If OUTPUT(*) or OUTPUT(*PRINT) is specified, the MBR, LIB, and CLEAR parameters are ignored.

*: If parameter values are specified that result in more than one job being selected (such as JOB(*ALL) or a generic job name), this option is equivalent to specifying *PRINT. Otherwise, the job's process access group information is displayed at the workstation.

*PRINT: The output is written to the printer file QPPTPAG.

*FILE: The output is saved in the database file QAPTPAGD for later analysis with ANZACCGRP. This is useful when several jobs are selected.

*BOTH: The output is saved in the database file (*FILE option). It is also either displayed or printed (* option).

MBR

Specifies the member in file QAPTPAGD in which the process access group data is saved. If the member does not exist, it is added to the file. If the member exists, the new data extends or replaces the old contents, depending on the CLEAR parameter value.

QAPAGDTA: The standard member name, QAPAGDTA, is used.

member-name: Specify the name of an alternate member in which the data is saved. This allows you to keep more than one set of process access group data.

LIB

Specifies the name of the library where the object is saved. If the library does not contain a file name 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 where the process access group data is recorded. This is necessary if, for example, access to the default library is not allowed.

CLEAR

Specifies whether to overwrite or append existing data in the specified member.

*YES: Existing data is overwritten by the new data.

*NO: Existing data is kept, and the new data is appended to it. This may be used to accumulate process access group data on more than one set of jobs.

Examples for DSPACCGRP

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.

Error messages for DSPACCGRP

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