HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
SET_TRACE_FILE
trace_file_size
The maximum size of the trace file, in bytes. To continue using the existing file size definition, specify zero.
If
dual_files is set to AP_YES, tracing will switch between the two files when the current file reaches this
size. If dual_files is set to AP_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 client-server
network, to allow for the volume of trace information generated in larger systems. In particular, consider
increasing the trace file size on a server to allow for large numbers of clients or users accessing the server.
file_name
Name of the trace file, or of the first trace file if dual_files is set to AP_YES. To continue using the file name
specified on a previous SET_TRACE_FILE verb, set this parameter to a null string.
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 relative to the application’s working
directory or a full path) on any computer to which this verb is issued.
This parameter is an ASCII string of 1–80 characters, followed by a NULL character (binary zero).
file_name_2
Name of the second trace file; this parameter is used only if dual_files is set to AP_YES. To continue using
the file name specified on a previous set_trace_file verb, set this parameter to a null string.
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 relative to the application’s working
directory or a full path) on any computer to which this verb is issued.
This parameter is an ASCII string of 1–80 characters, followed by a NULL character (binary zero).
3.183.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
secondary_rc
Not used.
3.183.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_FILE_NAME
The file_name or file_name_2 parameter was not set to a valid HP-UX file name, or file_name_2 was
not specified when changing from a single trace file to dual trace files.
AP_INVALID_FILE_TYPE
The trace_file_type parameter was not set to a valid value.
728