AM3270 and TR3271 Configuration and Management Manual

SCF Interface to AM3270 and TR3271

AM3270 and TR3271 Configuration and Management Manual—529993-001

4-47

TRACE Command

The TRACE command requests the capture of target-defined data items, alters trace

parameters, and ends tracing. This is a sensitive command.

An SCF trace produces a trace file that can be displayed using the commands

available in the PTrace utility. The trace file is created by SCF. The PTrace utility is

described in Section 7, PTrace for AM3270 and TR3271.

Considerations for the TRACE Command

•

For any CLIP tracing, the CLIP option (or the value 15) should be specified

together with any other desired trace options.

•

The NOCOLL option is not supported.

Command Syntax for the TRACE Command

The TRACE command has the following syntax:

OUT file-spec

causes any SCF output generated for this command to be directed to the specified

file.

LINE line-name

designates the line to be traced. If you omit line-name, SCF traces the assumed

line.

STOP [ , BACKUP ]

discontinues the trace currently in progress. If you specify BACKUP, SCF stops the

trace of the backup process only.

BACKUP

specifies that the backup process should receive the trace request. The object

must be running as a process pair if you use this syntax. If the primary process is

being traced when a takeover by the backup process occurs, the trace of the

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

{ , STOP [ , BACKUP ] }

{ [ , BACKUP ]

[ , COUNT count ]

[ , PAGES pages ]

[ , RECSIZE size ]

[ , SELECT select-spec ]

[ , TO file-spec ]

[ , WRAP ]... }