HP-UX SNAplus2 CSV Programmer's Guide
Common Service Verbs Reference
DEFINE_TRACE (HP-UX Systems Only)
Chapter 2 57
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
Possible values are:
SV_INVALID_SET
The
dt_set
parameter contained a
value that was not valid.
SV_INVALID_RESET_TRACE
The
reset_trc
parameter contained
a value that was not valid.
Other Conditions Other conditions canresult in the following primary
return codes (
primary_rc
):
SV_INVALID_VERB
The
opcode
parameter did not match the operation
code of any verb. No verb executed.
SV_UNEXPECTED_DOS_ERROR
The operating system has encountered an error while
processing the verb. The operating system return code
is returned through the
secondary_rc
. If the problem
persists, consult the System Administrator for
corrective action.
For the meaning of the operating system return code, refer to the file
/usr/include/errno.h.
SNACTL Environment Variable
The SNACTL environment variable is provided by SNAplus2 for
debugging application programs which use the DEFINE_TRACE verb. If
this variable is set, DEFINE_TRACE verbs issued by the program will
have no effect on tracing (although they will still return SV_OK unless an