HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (REGISTER_INDICATION_SINK to UNREGISTER_INDICATION_SINK)
SET_TRACE_FILE
Chapter 5 1065
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).
Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following
parameters:
primary_rc AP_OK
secondary_rc Not used.
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
wasnot specified when changing from
a single trace file to dual trace files.
AP_INVALID_FILE_TYPE