HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_PORT
The fqplu_name parameter contained a character that was not valid.
AP_INVALID_UNINT_PLU_NAME
The plu_un_name parameter contained a character that was not valid.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.38.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_PLU_ALIAS_CANT_BE_CHANGED
The plu_alias parameter of an existing partner LU cannot be changed.
AP_PLU_ALIAS_ALREADY_USED
The plu_alias parameter is already used for an existing partner LU with a different LU name.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_STATE_CHECK
, which
are common to all NOF verbs.
3.38.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.39 DEFINE_PORT
DEFINE_PORT is used to define a new port or modify an existing one. Before issuing this verb, you must issue
the DEFINE_DLC verb to define the DLC that this port uses.
You can modify an existing port only if it is not started. You cannot change the DLC used by an existing port; the
dlc_name specified when modifying an existing port must match the DLC that was specified on the initial definition
of the port.
If you are defining a port that will accept incoming calls, see Section 3.39.7, Incoming Calls.
3.39.1 VCB Structure
typedef struct define_port
{
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 port_name[8]; /* name of port */
PORT_DEF_DATA def_data; /* port defined data */
229