OSI/TS SCF Reference Manual

OSI/TS SCF Commands
OSI/TS SCF Reference Manual—424832-001
2-131
TRACE Command
file-spec
causes any SCF output generated for this command to be directed to the specified
file.
object-spec
designates the objects to be traced. If object-spec is omitted, the assumed object is
traced (see the SCF ASSUME command).
STOP
discontinues the trace currently in progress.
BACKUP
specifies that the backup process should receive the trace request. If BACKUP is
specified, the object must be running as a NonStop process pair. If the primary
process is being traced when a takeover by the backup process occurs, the trace of
the process continues. However, in this case, most events being traced before the
process switch are no longer traced, because the process being traced is no longer
the primary. If BACKUP is omitted, the primary process is assumed.
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. The default is -1. The trace will stop when
the trace file reaches EOF, unless WRAP has been specified.
NOCOLL
indicates that the trace collector process should not be initiated.
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 equal to 0 (zero). If
PAGES is omitted or if pages equals 0, the default value of 64 pages is assumed.
RECSIZE size
specifies the length of the data in the trace data records. size is an integer in the
range 16 through 4050 or equal to 0 (zero). The length of the trace header, which is
eight bytes, is not included in size. If RECSIZE is omitted or if size equals 0, the
default value of 120 bytes is assumed.
SELECT <select-spec>
specifies which records are collected and written to the trace file. Records are
identified by trace record type, using the descriptions that appear in PTrace display
formats. The select-spec is one or more of the following specifications: