HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_CN
secondary_rc
Possible values are:
AP_INVALID_CP_NAME
The specified CP name is already defined in a directory entry, and is not a LEN node.
AP_INVALID_LU_NAME
One or more of the specified LU names was already defined on a different parent node.
3.12.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.13 DEFINE_CN
DEFINE_CN defines a Connection Network (otherwise known as a Virtual Routing Node or VRN). The
verb provides the network qualified name of the connection network along with its Transmission Group (TG)
characteristics. Also provided is a list of the names of the local ports that can access this connection network.
DEFINE_CN can be used to redefine an existing Connection Network. In particular, new ports can be added to the
list of ports which access the connection network by issuing another DEFINE_CN. (Ports can be removed in the
same way by issuing the DELETE_CN verb).
This verb is valid only at a network node or an end node, and not at a LEN node.
3.13.1 VCB Structure
typedef struct define_cn
{
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 fqcn_name[17]; /* name of connection network */
CN_DEF_DATA def_data; /* CN defined data */
unsigned char port_name[8][8]; /* port names */
} DEFINE_CN;
typedef struct cn_def_data
{
unsigned char description[32]; /* resource description */
unsigned char reserve0[16]; /* reserved */
unsigned char num_ports; /* number of ports on CN */
unsigned char cn_type; /* reserved */
unsigned char reserve1[15]; /* reserved */
TG_DEFINED_CHARS tg_chars; /* TG characteristics */
} CN_DEF_DATA;
typedef struct tg_defined_chars
{
111