HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
SET_TN_SERVER_TRACE
AP_NOT_AUTHORIZED
The NOF application cannot obtain read/write access to the file because it is running on a client, or
because it is running with a user ID that is not a member of the SNA administrators group
sna. If the
user ID is not a member of this group, the only valid processing mode is AP_MODE_READ_ONLY.
AP_NOT_MASTER
The processing mode cannot be changed to AP_MODE_READ_WRITE or AP_MODE_COMMIT because
the target handle specifies a file (either the domain configuration file or the SNA network data file) on
a backup server that is no longer acting as the master server. Changes to the running configuration
file can be made only to the copy of this file on the master (so that they will be distributed to other
servers); other copies of the file can be accessed only in read-only mode. If the application needs to
use read/write or commit mode, it should issue CLOSE_FILE for this target handle, and then reissue
OPEN_FILE to access the file on the new master server.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_STATE_CHECK
, which
are common to all NOF verbs.
3.181.6 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.182 SET_TN_SERVER_TRACE
This verb specifies tracing options for the SNAplus2 TN server component.
This verb must be issued to a running node.
3.182.1 VCB Structure
typedef struct set_tn_server_trace
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
AP_UINT16 trace_flags; /* trace flags */
unsigned char reserv3[6]; /* reserved */
} SET_TN_SERVER_TRACE;
3.182.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_SET_TN_SERVER_TRACE
trace_flags
The types of tracing required. To turn off all tracing, or to turn on tracing of all types, specify one of the
following values:
725