HP-UX SNAplus2 R7 NOF Programmer's Guide
NOF API Verbs
STOP_LS
3.190.5 Returned Parameters: State Check
If the verb does not execute because of a state error, SNAplus2 returns the following parameters.
primary_rc
AP_STATE_CHECK
secondary_rc
Possible values are:
AP_PU_NOT_DEFINED
The supplied PU name did not match the name of a defined internal PU.
AP_PU_ALREADY_DEACTIVATING
The PU is already in the process of being stopped.
AP_PU_NOT_ACTIVE
The PU is not active.
3.190.6 Returned Parameters: Function Not Supported
If the verb does not execute because the node’s configuration does not support it, SNAplus2 returns the following
parameter:
primary_rc
AP_FUNCTION_NOT_SUPPORTED
The node does not support DLUR; this is defined by the dlur_supported parameter on DEFINE_NODE.
3.190.7 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.191 STOP_LS
STOP_LS stops an active LS. Alternatively, it can be issued for an inactive LS, to specify that the LS cannot be
activated automatically by SNAplus2 when required or activated by the remote system; if both of these are disabled,
the LS can be activated only by issuing START_LS.
This verb must be issued to a running node.
3.191.1 VCB Structure
typedef struct stop_ls
{
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 stop_type; /* stop type */
unsigned char ls_name[8]; /* name of link station */
745