Administration Commands
set_trace_file
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 tracing is activated by the set_trace_type or add_dlc_trace 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 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.
LEAVE_UNCHANGED
Leave the dual_files setting unchanged from the existing definition. (When the SNAplus2 software is started, the initial default is to use two files.)
trace_file_size
The maximum size of the trace file, in bytes. To continue using the existing trace file size definition, specify 0.
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.
You may need to increase the size of the trace files according to the size of the SNAplus2
file_name
Name of the trace file, or the name of the first trace file if dual_files is set to YES. To continue using the file name specified on a previous set_trace_file command, do not specify this parameter.
To create the file in the default directory for diagnostics files, /var/opt/sna, specify the file name with no path. To create the file in a different directory, specify either a full path or the path relative to the default directory. If you include the path, ensure that it is a valid path (either a path relative to the application’s working directory or a full path) on any computer to which this command is issued.
file_name_2
Name of the second trace file; this parameter is used only if dual_files is set to YES. To continue using the file name specified on a previous set_trace_file command, do not specify this parameter.
To create the file in the default directory for diagnostics files, /var/opt/sna, specify the file name with no path. To create the file in a different directory, specify either a full path or the path relative to the default directory. If you include the path, ensure that it is a valid path (either a path relative to the application’s working directory or a full path) on any computer to which this command is issued.
2.192.2 Returned Parameters
No parameters are returned by SNAplus2 when this command executes successfully.