HP-UX SNAplus2 CSV Programmer's Guide
Common Service Verbs Reference
COPY_TRACE_TO_FILE (HP-UX Systems Only)
Chapter 250
file_option
Possible values are:
SV_NEW Create a new file with the name
specified in
file_name
. An error is
returned if this file already exists.
SV_OVERWRITE Overwrite the file if it exists, or
create the file if it does not exist.
Returned Parameters
After the verb executes, SNAplus2 returns parameters to indicate
whether the execution was successful and, if not, to indicate the reason
the execution was unsuccessful.
Successful Execution
If the verb executes successfully, SNAplus2 returns the following
parameter:
primary_rc
SV_OK
Unsuccessful Execution
When a verb does not execute successfully, 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 verb does not execute because of a parameter
error, SNAplus2 returns the following parameters:
primary_rc
SV_PARAMETER_CHECK
secondary_rc
SV_INVALID_FILE_OPTION
The
file_option
parameter contained a value that
was not valid.
State Check If the verb does not execute successfully because of a state
error, the following parameters are returned:
primary_rc
SV_STATE_CHECK
secondary_rc
Possible values:
SV_TRACE_BUFFER_EMPTY