SNAX/HLS Management Programming Manual

Standard SNAX/HLS Definitions
Common Definitions
104708 Tandem Computers Incorporated 6–55
ZHLS–MAP–TRACE–CTL
This extensible structured token is used both to request tracing and to report the
current state of tracing. This token occurs in the TRACE command applied to the
SNAX/HLS process and in the response to the INFO command applied to the
SNAX/HLS process.
def ZHLS–DDL–TRACE–CTL.
05 ZSIZE type ZSPI–DDL–INT.
05 ZSTATE type ZSPI–DDL–BOOLEAN.
end.
ZSIZE
reports the size of the trace file currently in use.
In the TRACE command, a nonzero value causes an attempt to alter the existing
value. This value is set to 64 pages when SNAX/HLS is initiated. This value takes
effect the next time tracing is started.
ZSTATE
reports the status of tracing. The value ZSPI–VAL–TRUE means tracing is active
and ZSPI–VAL–FALSE means it is inactive.
Assigning ZSPI–VAL–TRUE to this field is meaningful only if tracing is not active
and a trace–file name has been assigned. If these conditions are met, tracing
begins.
Assigning ZSPI–VAL–FALSE to this field is meaningful at all times. If tracing is
active at the time the value is assigned ZSPI–VAL–FALSE, tracing stops, the trace
file is closed, and the trace–file name is cleared. You can analyze the results of the
trace with the HLSTAP program.