AM3270 and TR3271 Configuration and Management Manual

SCF Interface to AM3270 and TR3271
AM3270 and TR3271 Configuration and Management Manual529993-001
4-86
Command Syntax for the TRACE Command
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
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 process. If you omit BACKUP, SCF assumes the primary process.
COUNT count
specifies the number of trace records that you want to capture. count is an integer
in the range -1 through 32767. If you omit COUNT or if count equals -1, records
accumulate until you stop the trace.
PAGES pages
designates how much space, in pages, that you want to allocate in the extended
data segment used for tracing. You can specify PAGES only when you initiate a
trace. pages is an integer in the range 4 through 1024 or equal to 0 (zero). If you
omit PAGES or if pages equals 0, SCF assumes the default value of 64 pages.
RECSIZE size
specifies the length of the data in the trace data records. size is an integer in the
range 1 through 4050 or equal to 0 (zero). The length of the trace header, which is
8 bytes, is not included in size. If RECSIZE is omitted or if size equals 0, the
default value of 120 bytes is assumed.
The maximum CLIP trace record size (RECSIZE) is 21. If the record exceeds the
record size, 10 bytes from the start of the message and 11 bytes from the end of
the message are included.
SELECT select-spec
select-spec is one of the following specifications: