ATM Configuration and Management Manual

SCF Commands

ATM Configuration and Management Manual—522307-003

4-98

TRACE ADAPTER Command

The TRACE ADAPTER command executes a trace on the specified ADAPTER object.

Command Syntax

OUT file-spec

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

file.

ADAPTER adapter-name

specifies the adapter on which a trace is to be performed.

STOP

discontinues the trace currently in progress. If BACKUP is specified, only the

backup process trace is stopped.

BULKIO | NOBULKIO

designates whether or not TRACE 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, NOBULKIO should be

specified. Bulk I/O tracing is faster and should eliminate most data loss. The

default is BULKIO. BULKIO cannot be used with NOCOLL.

COUNT count

specifies the number of trace records to be captured. count is an integer in the

range -1 through 32767. If COUNT is omitted or if count equals -1, records are

accumulated until the trace is stopped.

TRACE [/OUT file-spec/ ] ADAPTER adapter-name

{ STOP }

{ [, BULKIO | NOBULKIO ]

[ , COUNT count ]

[ , NOCOLL ]

[ , PAGES pages ]

[ , RECSIZE size ]

[ , SELECT select-spec ]

[ , TO file-spec ]

[ , WRAP ] ... }