HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
START_LS
Name of the link station to be started. This is an 8-byte ASCII string, padded on the right with spaces if the
name is shorter than 8 bytes, which must already have been defined by a DEFINE_LS verb.
enable
Specifies the action to be taken for the LS.
To start the LS, set this parameter to AP_ACTIVATE.
To leave the LS inactive but specify that it can be activated (either by SNAplus2 or by the remote system)
when required, specify one or both of the following values (combined using a logical OR):
AP_AUTO_ACT
The LS can be activated automatically by SNAplus2 when required for a session. This value should be
used only when the LS is defined to be auto-activatable (
auto_act_supp in the LS definition is set to
AP_YES); it re-enables auto-activation after the LS has been manually stopped using STOP_LS.
AP_REMOTE_ACT
The LS can be activated by the remote system. This value does not alter the defined value of
disable_remote_act in the LS definition; when the LS is next stopped, it will return to the defined
setting.
3.187.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
3.187.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_LINK_NAME_SPECIFIED
The ls_name parameter was not the name of a defined LS.
AP_INVALID_LINK_ENABLE
The enable parameter was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.187.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:
738