HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_CN
unsigned char effect_cap; /* effective capacity */
unsigned char reserve1[5]; /* reserved */
unsigned char connect_cost; /* connection cost */
unsigned char byte_cost; /* byte cost */
unsigned char reserve2; /* reserved */
unsigned char security; /* security */
unsigned char prop_delay; /* propagation delay */
unsigned char modem_class; /* reserved */
unsigned char user_def_parm_1; /* user-defined parameter 1 */
unsigned char user_def_parm_2; /* user-defined parameter 2 */
unsigned char user_def_parm_3; /* user-defined parameter 3 */
} TG_DEFINED_CHARS;
3.13.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_CN
fqcn_name
Fully qualified name of the connection network. The name is a 17-byte EBCDIC string, right-padded with
EBCDIC spaces. It consists of a network ID of up to 8 A-string characters, an EBCDIC dot (period) character,
and a network name of up to 8 A-string characters.
def_data.description
A null-terminated text string (0–31 characters followed by a null character) describing the connection network.
This string is for information only; it is stored in the node’s configuration file and returned on the QUERY_CN
verb, but SNAplus2 does not make any other use of it.
def_data.num_ports
Number of ports included on this verb; each DEFINE_CN verb can specify up to 8 ports. To define a CN
with more than 8 ports, issue multiple DEFINE_CN verbs for the same CN name; the maximum total number
of ports on a CN is 239.
def_data.tg_chars.effect_cap
Actual bits per second rate (line speed). The value is encoded as a 1-byte floating point number, represented
by the formula 0.1 mmm * 2
eeeee
where the bit representation of the byte is b’eeeeemmm’. Each unit of
effective capacity is equal to 300 bits per second.
def_data.tg_chars.connect_cost
Cost per connect time. Valid values are integer values in the range 0–255, where 0 is the lowest cost per
connect time and 255 is the highest.
def_data.tg_chars.byte_cost
Cost per byte. Valid values are integer values in the range 0–255, where 0 is the lowest cost per byte and
255 is the highest.
def_data.tg_chars.security
Security level of the network. Possible values are:
AP_SEC_NONSECURE
No security.
AP_SEC_PUBLIC_SWITCHED_NETWORK
112