HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
SET_BCK_CS_TRACE
A session could not be allocated because of a condition that requires corrective action. Check the
sense_data parameter and any logged messages to determine the reason for the failure, and take any
action required. Do not attempt to retry the verb until the condition has been corrected.
sense_data
The SNA sense data associated with the allocation failure.
3.172.7 Returned Parameters: CNOS Processing Errors
If the verb does not execute because of an error, SNAplus2 returns the following parameters.
primary_rc
AP_CONV_FAILURE_NO_RETRY
The session limits could not be changed because of a condition that requires action (such as a
configuration mismatch or a session protocol error). Check the SNAplus2 log file for information
about the error condition, and correct it before retrying this verb.
primary_rc
AP_CNOS_PARTNER_LU_REJECT
The verb failed because SNAplus2 failed to negotiate the session limits with the partner. Check
configuration at both the local LU and partner LU.
secondary_rc
AP_CNOS_COMMAND_RACE_REJECT
The verb failed because the specified mode was being accessed by another administration program
(or internally by the SNAplus2 software) for session activation or deactivation, or for session limit
processing. The application should retry the verb, preferably after a timeout to allow the race condition
to be cleared.
3.172.8 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.173 SET_BCK_CS_TRACE
This verb specifies options for back-level client-server tracing (tracing of data sent between a current-level SNAplus2
server and a back-level server or client). It is used only when you are in the processs of migrating a client-server
SNAplus2 system to a new release of the software, so that one or more servers are running the current-level software
and providing support for computers running the back-level software. For more information about the migration
process and on support for back-level computers, see the HP-UX SNAplus2 Migration Guide.
This verb must be issued to a running node on a computer where the back-level support software is running (for
more information, see the HP-UX SNAplus2 Migration Guide).
3.173.1 VCB Structure
typedef struct set_bck_cs_trace
{
AP_UINT16 opcode; /* verb operation code */
707