HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
PATH_SWITCH
• The SNAplus2 version number in the configuration file header does not match the version of the
SNAplus2 software you are using. Check that you have the correct file; if the file was created using
an earlier version of SNAplus2, refer to the
HP-UX SNAplus2 Migration Guide for information
about upgrading it.
• There was a version mismatch between components of the SNAplus2 software. If you have upgraded
your SNAplus2 license to include additional functions or users, check that you are using the correct
version of the licensing software.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_STATE_CHECK
, which
are common to all NOF verbs.
3.85.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.86 PATH_SWITCH
PATH_SWITCH requests that SNAplus2 switch a currently active Rapid Transport Protocol (RTP) connection to
another path. If SNAplus2 cannot find a better path, it leaves the connection unchanged.
3.86.1 VCB Structure
typedef struct path_switch
{
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 */
unsigned char rtp_connection_name[8]; /* RTP connection name */
} PATH_SWITCH;
3.86.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_PATH_SWITCH
rtp_connection_name
The RTP connection for which a change in path is requested. This is an 8-byte string in a locally displayable
character set. All eight bytes are significant and must be set.
3.86.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
329