PAM Configuration and Management Manual

SCF for PAM

PAM Configuration and Management Manual—523349-003

3-60

TRACE Command

The TRACE command is a sensitive command that can request the capture of

target-defined data items, alter trace parameters, and end tracing. An SCF trace

creates a trace file that can be displayed using the commands available in the PTrace

program. The PTrace program is described in the PTrace Reference Manual.

TRACE LINE Command

Use the TRACE LINE command to collect trace information about LINE objects. Issue

the TRACE command (without the STOP option) to specify trace options and start

tracing. While tracing is on, the TRACE command can be issued (without the STOP

option) to modify COUNT, RECSIZE, or any of the SELECT specifications. Issue the

TRACE command with the STOP option to stop any current tracing.

Command Syntax

OUT file-spec

directs any SCF output generated for this command to the specified file.

LINE line-name

is the name of the line to be traced.

STOP

discontinues the trace currently in progress.

BULKIO | NOBULKIO

designates whether or not PTrace should use bulk I/O for tracing. BULKIO

specifies that the TRACE collector use bulk I/O to write data to the disk file, thus

reducing the number of missing frame errors reported by PTrace.

A limitation of bulk I/O is that only one user can access the file at a time. If shared

access of the trace file is needed while the trace is active, specify NOBULKIO. Bulk

TRACE [ /OUT file-spec/ ] LINE line-name

{ , STOP [ , BACKUP ] }

{ [ , BULKIO | NOBULKIO ]

[ , BACKUP ]

[ , COUNT count ]

[ , NOCOLL ]

[ , PAGES pages ]

[ , RECSIZE size ]

[ , SELECT select-spec ]

[ , TO file-spec ]

[ , WRAP ] }