ADVISE COLLECT REPORT SYSTEM

Chapter 9: Performance Agent Commands › ADVISE COLLECT REPORT SYSTEM_PC

ADVISE COLLECT REPORT SYSTEM_PC

This command generates reports for evaluating system CPU use.

Format

ADVISE COLLECT REPORT SYSTEM_PC

Description

Use the ADVISE COLLECT REPORT SYSTEM_PC command to summarize the data in the system PC file and produce a report of system PC and PSL information by process.

Parameters

pc-file-spec: This required parameter specifies the file containing the collected PC samples.

Qualifiers

CLASS =(item[,. . .])

Specifies which classes of statistics are included in the report. You can select any of the following class items:

Keyword	Meaning
ALL	All statistics (same as DEFAULT_STATISTICS)
DEFAULT_STATISTICS	Report PROCESS, MODULE, IMAGE, IPL, DRIVER, EXEC
DRIVER	Report Device Drivers and System Code
EXEC	Report OpenVMS Executive Layout
PROCESS[:(CPU_UTILIZATION, ALL)]	Report PC samples by PROCESS
MODULE	Report by MODULE name within EXEC
IMAGE	Report by IMAGE name within EXEC
IPL	Generate IPL usage graphs

All of the class item keywords are also available in the negated form to indicate that reporting of a particular class of data is not desired. In addition, support is provided for allowing:

/CLASS=(ALL[,negated-keyword])

This allows an “all but these” capability.

If the /CLASS keyword is omitted from the command line, then /CLASS=DEFAULT_STATISTICS is assumed.

/IDENTIFICATION=pid qualifier: Specifies the filter process identification (PID) for report generation purposes.

If the /IDENTIFICATION qualifier is present in the command line, then a process identification value must be specified.

If the /IDENTIFICATION qualifier is omitted from the command line, then /NOIDENTIFICATION is assumed and the interrupt stack is used as the filter for the report.

/OUTPUT=file-spec: Writes requested reports to the specified file name. If you do not specify the /OUTPUT qualifier, Performance Agent writes the report to the device defined by the logical SYS$OUTPUT.