Command Reference Guide

Administration Commands
set_trace_type
DGRM
Trace internal control messages between SNAplus2 components
truncation_length
The maximum length, in bytes, of the information written to the trace file for each message. If a message is
longer than this value, SNAplus2 writes only the start of the message to the trace file and discards the data
beyond
truncation_length. Truncation enables you to record the most important information for each message
but avoid filling up the file with long messages.
To specify no truncation (all the data from each message is written to the file), set this parameter to
0.
init_flags
Specifies whether to initialize tracing (define the tracing state at all interfaces) or to change the state of tracing
at one or more interfaces (leaving the others unchanged). Possible values are:
YES
Initialize tracing. The trace_flags parameter defines the required state of tracing at all interfaces.
NO
Change the state of tracing. The trace_flags parameter defines the interfaces where tracing is to be
activated or deactivated; other interfaces will not be affected.
set_flags
If init_flags is set to NO, this parameter specifies whether to activate or deactivate tracing at the requested
interfaces. Possible values are:
YES
Activate tracing at the interfaces specified by the trace_flags parameter.
NO
Deactivate tracing at the interfaces specified by the trace_flags parameter.
If init_flags is set to YES, this parameter is ignored.
2.193.2 Returned Parameters
No parameters are returned by SNAplus2 when this command executes successfully.
2.193.3 Error Return Codes
If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a
secondary return code to provide specific details about the reason for unsuccessful execution.
Parameter Check
If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
PARAMETER_CHECK
secondary_rc
INVALID_TRUNC_LEN
The truncation_length parameter specified a length of less than 256 bytes.
598