ATM Configuration and Management Manual

Tracing for QIO
ATM Configuration and Management Manual—522307-003
C-2
TRACE ADAPTER Command
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.
NOCOLL
specifies that trace data from the extended segment is written to the disk file
specified in TO file-spec only when one of the following occurs:
•
The trace is stopped.
•
The number of trace records written to the extended data segment is equal to
the count specified in the TRACE command that started the trace. When the
trace facility detects this condition, the trace records from the extended data
segment are written to the disk file and the trace is automatically stopped. A
separate TRACE command does not need to be issued to stop the trace. If
NOCOLL is not specified, a trace collector process reads the trace records
from the extended data segment and writes them to the disk file as they
become available.
NOCOLL option cannot be used with the BULKIO option.
PAGES pages
designates how much space, in units of pages, is allocated in the extended data
segment used for tracing. PAGES can be specified only when a trace is being
initiated. pages is an integer in the range 4 through 1024 or is equal to 0. If
PAGES is omitted or pages equals zero, the default value of 64 pages is
assumed.