Command Reference Guide

Administration Commands
query_trace_file
CS
File contains tracing on data transferred across the SNAplus2 domain between the specified computer
and other nodes. This trace type is activated by the set_cs_trace command.
BCK_CS
File contains tracing on data transferred across the SNAplus2 domain between a current-level server
and back-level computers. This trace type is activated by the set_bck_cs_trace command.
TN_SERVER
File contains tracing on the SNAplus2 TN server component.
IPS
File contains tracing on kernel components for the specified node. This type of trace is activated by
the set_trace_type or add_dlc_trace command.
2.178.2 Returned Parameters
Parameter name Type Length
trace_file_type constant
dual_files constant
trace_file_size decimal
file_name character 80
file_name_2 character 80
If the command executes successfully, SNAplus2 returns the following parameters:
trace_file_type
The type of trace file for which information is required (as supplied on the query_trace_file command).
dual_files
Specifies whether tracing uses one file or to two files. Possible values are:
YES
Tracing uses two files. When the first file reaches the size specified by
trace_file_size, the second file is
cleared, and tracing continues to the second file. When this second file then reaches the size specified
by trace_file_size, the first file is cleared, and tracing continues to the first file. This ensures that
tracing can continue for long periods without using excessive disk space; the maximum space required
is approximately twice the value of trace_file_size.
NO
Tracing uses one file.
trace_file_size
The maximum size of the trace file. If dual_files is set to YES, tracing switches between the two files when
the current file reaches this size. If dual_files is set to NO, this parameter is ignored; the file size is not limited.
file_name
Name of the trace file, or name of the first trace file if dual_files is set to YES.
If no path is included, the file is stored in the default directory for diagnostics files, /var/opt/sna.Ifa
path is included, this path is either a detailed path (starting with a
[/] character) or the path relative to the
default directory.
file_name_2
Name of the second trace file; this parameter is used only if dual_files is set to YES.
567