Chapter 9: Performance Agent Commands › ADVISE COLLECT SYSTEM_PC

ADVISE COLLECT SYSTEM_PC

This command invokes the system Program Counter sampling utility.

Format

ADVISE COLLECT SYSTEM_PC

Description

Use the ADVISE COLLECT SYSTEM_PC command to record system-wide Program Counter (PC) and Processor Status Longword (PSL) usage metrics.

Qualifiers

/BEGINNING=time

Specifies the time when PC data collection starts. Specify an absolute time, a delta time, or combination. If the /BEGINNING qualifier is omitted or the time is omitted, data collection begins immediately.

/COMMENTS="string"

Specifies an optional comment string 1 to 80 bytes long written to the PC log file and printed on the first page of a report. If you enter the /COMMENT qualifier, you must specify a string. If you do not enter /COMMENT, an 80 byte blank comment string is recorded.

/ENDING=time

Specifies the time when PC data collection stops. Specify an absolute time, a delta time, or combination. If the /ENDING qualifier is omitted or the time is omitted, data collection terminates 15 minutes after starting.

/INTERVAL=ticks

Specifies the amount of elapsed time between PC data collection events. The /INTERVAL value must be in the range from 1 to 100 ten millisecond ticks. If the /INTERVAL qualifier is omitted or the value is omitted, the default value of one ten millisecond tick is used.

/IDENTIFICATION=pid

PC data is collected only for the process ID specified. If you enter the /IDENTIFICATION qualifier, you must specify a process identification value. If the /IDENTIFICATION qualifier is omitted, all PC data is collected regardless of the process that generated it.

/OUTPUT=file-spec

Specifies the name of the log file for the PC data. If the /OUTPUT is omitted or no file is specified, SYSTEM.PCS is used.