AM3270 Management Programming Manual

COMMANDS AND RESPONSES

TRACE Command

The TRACE command allows your management application to capture

and store records that can be displayed using the PTRACE command.

The AM3270 subsystem does not support the TRACE command directly.

Instead, your management application issues the command to SCP,

which then invokes the CMP Trace Collector (CMPTC). The CMPTC

sends a CMP-format LCB to the AM3270 subsystem to start tracing

the selected records.

When your management application issues the TRACE command, the

specified line enters trace mode; normal operation cannot take

place. The trace parameters specified by your management

application in ZCOM-MAP-TRACE-MODIF control the initiation of

the trace file, the selection of the trace environment, and

termination of trace mode. To enter trace mode, the line must

be in the STARTED summary state. This fixed structure, along

with one or more ZCOM-TKN-TRACE-OPT tokens are sent to SCP. The

ZCOM-TKN-TRACE-OPT tokens are the trace options selected by your

management application.

From these trace options, which have enumerated type values, the

SCP creates a bit mask that is sent to the subsystem. The

subsystem uses this bit mask to determine the records that have

been selected by your management application. The bit mask is

32 bits long. However, the AM3270 does not support 32 trace

options. If your management application tries to select a trace

option that does not correspond to a recognized bit, the AM3270

subsystem ignores the bit, but continues to process the properly

selected trace options.

When the trace is to be terminated, the ZCOM-MAP-TRACE-MODIF

token is sent with the ZSTOP field containing the value ZSPI-VAL-

TRUE.

Once the trace ends, the line returns to normal operation and

remains in the STARTED summary state.

6-120