SNAX/XF and SNAX/APN Configuration and Management Manual
SCF Commands for SNAX/XF and SNAX/APN
SNAX/XF and SNAX/APN Configuration and Management Manual—425836-006
13-129
TRACE Command
TRACE Command
The TRACE command requests the capture of certain information about the specified
SNAX/XF and SNAX/APN line or subsystem that can help in problem determination. It
also allows you to modify or stop the tracing activity previously specified for a line or
subsystem. After capturing information with the TRACE command, you can view the
information with the PTrace utility, as described in Section 15, PTrace Reference for
SNAX/XF and SNAX/APN.
When a TRACE command is issued to start a trace, the line-handler or service-
manager process associated with the specified object creates an extended data
segment in memory to collect the specified trace data. The trace data is written from
the data segment to disk in a manner determined by the settings of the NOCOLL and
WRAP options.
TRACE is a sensitive command.
/ OUT file-spec /
causes any SCF output generated for this command to be directed to the specified
file. file-spec must be a partially or fully qualified file name. If this option is not
specified, the output is sent to the home terminal.
object-name
is the name of the line handler (PROCESS object) or service manager (SUBSYS
object) to be traced, or for which the trace is to be modified or stopped.
TRACE [ / OUT file-spec / ] { LINE } object-name
{ SUBSYS }
{ , STOP [, BACKUP ] }
{ {, trace-option }... }
trace-option is:
{ BACKUP }
{ COUNT count }
{ LUSELECT { ALL | lu-name | ( lu-name [, lu-name]...) } }
{ NOCOLL }
{ OFF }
{ PAGES pages }
{ PUSELECT { ALL | pu-name | ( pu-name [, pu-name]...) } }
{ RECSIZE size }
{ SELECT select-spec }
{ SESSIONSELECT { ALL | s-name | (s-name [, s-name]...) }}
{ TO file-name }
{ WRAP }