TCP/IP TELNET Management Programming Manual

TRACE Command
Commands and Responses
53474 Tandem Computers Incorporated 6–71
TRACE Command The TRACE command allows your management application to capture and store
records that can be displayed using the PTRACE utility. The TELNET subsystem does
not support the TRACE command directly. Instead, your management application
issues the command to SCP, which then invokes the SCP trace facility. Once the
TRACE command has been issued for an object, that object enters trace mode and
normal operation cannot take place.
When your management application issues the TRACE command, the ZCOM-MAP-
TRACE-MODIF extensible structured token and one or more ZCOM-TKN-TRACE-
OPT tokens are sent to SCP. The trace parameters specified by your management
application in ZCOM-MAP-TRACE-MODIF control the initialization of the trace file,
the selection of the trace environment, and the termination of trace mode. The ZCOM-
TKN-TRACE-OPT token contains a trace option selected by the management
application.
Several trace options are available. Using these trace options, the SCP creates a bit
mask that is sent to the TELNET subsystem. The TELNET subsystem uses this bit
mask to determine the records that have been selected by the management application.
The bit mask is 32 bits long.
Although multiple trace options per command are allowed, each ZCOM-TKN-
TRACE-OPT token can contain only one trace option. More than one trace option per
command can be selected, but each trace option selected requires a separate ZCOM-
TKN-TRACE-OPT token. Duplicate occurrences per command are allowed.
Note The trace operation can significantly increase CPU use by the TELNET process. To avoid slowing down
other processes in the CPU, the priority of the TELNET process should be lowered before you issue the
TRACE command.
When the trace is to be terminated, the management application sends a TRACE
command in which the ZSTOP field of the ZCOM-MAP-TRACE-MODIF extensible
structured contains the value ZSPI-VAL-TRUE.
Object-name templates do not apply to this command.