AM3270 and TR3271 Configuration and Management Manual

SCF Interface to AM3270 and TR3271
AM3270 and TR3271 Configuration and Management Manual—529993-001
4-48
Command Syntax for the TRACE Command
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:
{ keyword }
{ (keyword [ , keyword ]...) }
{ number }
{ (number [ , number ]... ) }
keyword
is subsystem-specific. See Table 3-2 for a list of the keywords that can be
used with AM3270.
number
is the numeric value represented by a keyword.
TO file-spec
specifies the file to which SCF writes trace information. SCF purges any old data
before it initiates a trace. If the file does not exist, SCF creates one with an extent
size of six pages for the primary extent and six pages for the secondary extents.