HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_COS
AP_FUNCTION_NOT_SUPPORTED
The local node is a LEN node. This verb is valid only at a network node or an end node.
3.13.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.14 DEFINE_COS
DEFINE_COS adds a class of service definition or modifies a previously defined COS. The definition specifies
TG “rows” and node “rows”, which associate a range of node and TG characteristics with weights used for route
calculation. The lower the weight the more favorable the route.
3.14.1 VCB Structure
The DEFINE_COS verb contains a variable number of
cos_tg_row and cos_node_row structures; the number of each
is specified by the num_of_node_rows and num_of_tg_rows parameters. The TG rows are included at the end of the
main DEFINE_COS structure, in ascending order of weight; they are followed by the node rows, again in ascending
order of weight.
typedef struct define_cos
{
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 cos_name[8]; /* class of service name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char transmission_priority; /* transmission priority */
unsigned char reserv3[9]; /* reserved */
unsigned char num_of_node_rows; /* number of node rows */
unsigned char num_of_tg_rows; /* number of TG rows */
} DEFINE_COS;
typedef struct cos_tg_row
{
TG_DEFINED_CHARS minimum; /* minimum */
TG_DEFINED_CHARS maximum; /* maximum */
unsigned char weight; /* weight */
unsigned char reserv1; /* reserved */
} COS_TG_ROW;
typedef struct tg_defined_chars
{
unsigned char effect_cap; /* effective capacity */
unsigned char reserve1[5]; /* reserved */
unsigned char connect_cost; /* cost per connect time */
unsigned char byte_cost; /* cost per byte */
unsigned char reserve2; /* reserved */
unsigned char security; /* security */
115