---

T_NETMAP CLASS

Overview

The T_NETMAP class associates TA_LMIDs frp, tje T_MACHINE class in the TM_MIB to a TA_NETGROUP object from the T_NETGROUP class. This class identifies which logical machines belong to which network group. A TA_LMID ,au be om ,amu TA_NETGROUP groups. When one LMID connects to another LMID, the BRIDGE process determines the subset of network groups to which the two LMIDs belong. When the apir of LMIDs are in several common groups, they are sorted in descending TA_NETPRIO order (TA_NETGRPNO is the secondary sort key). The Network groups with the same TA_NETPRIO will flow network data in parallel. Should a networking error prevent data from flowing through all the highest priority group(s), only then the next lower priority network group(s) are used for network traffic (failover). All network groups with a higher priority than the ones flowing data are retried periodically. Once a network connection is established with a higher TA_NETPRIO value, no further data is scheduled for the lower priority one. Once the lower priority connection is drained, it is disconnected in an orderly fashion (failback).

Attribute Table

T_NETMAP Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_NETGROUP( r )( * )	string	ru-------	string[1 . . . 30]	N/A
TA_LMID( r )( * )	string	ru-------	string[1 . . . 30]	N/A
TA_STATE	string	RW-------	GET:"{VALl}"	N/A
			SET:"{NEW|INV}"	N/A
TA_NADDR	string	rw-r--r--	string[1 . . . 78]	" "
TA_MINENCRYPTBIT	string	rwxrwx---	{0|40|128}	0
TA_MAXENCRYPTBIT	string	rwxrwx---	{0|40|128}	128
( r ) - Required field for object creation (SET TA_STATE NEW) ( * ) - GET/SET key, one or more required for SET operations

Attribute Semantics

TA_NETGROUP: string

This is the name of the associated network group found in the T_NETGROUP class.

TA_LMID: string

The logical machine name for the T_MACHINE class (in TM_MIB) for this network mapping.

TA_STATE:

GET: {VALid}

A GET operation will retrieve run-time information for the selected T_NETMAP object(s). The following states indicate the meaning of a TA_STATE returned in response to a GET request. States not listed will not be returned.

VALid

T_NETMAP object is defined. Note that this is the only valid state for this class. Network mappings are never ACTive

SET: {NEW|INValid}

A SET operation will update configuration information for the selected T_NETMAP object. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed cannot be set.

NEW	Create T_NETMAP object for application. State change allowed only when in the INValid state. Successful return leaves the object in the VALid state.
unset	Modify an existing T_NETMAP object. Successful return leaves the object state unchanged.
INValid	Deletes the given network mapping. If any network links were active as a result of the mapping, they will be disconnected. This disconnection may cause a state change in T_BRIDGE objects (in TM_MIB) associated with the network links.

TA_NADDR: string

Specifies the complete network address to be used by the BRIDGE process placed in the logical machines as its listening address. The listening address for a BRIDGE is the mains by which it is contacted by other BRIDGE processes participating in the application, that is, if the LAN option is set in the T_DOMAIN:TA_OPTIONS attribute value. If string has the form "0xhexa-digits," it must contain an even number of valid hex digits. These forms are translated internally into a character array containing the hexadecimal representations of the string specificd. For TCP/IP addresses either the

"//hostname:port"

or

"//#.#.#.#:port"

format is used

TA_MINENCRYPTBITS={0|40|128}

When establishing a network link to this machine, require at least this minimum level of encryption. 0 means no encryption, while 40 and 128 specify the encryption key length (in bits). If this minimum level of encryption cannot be met, link establishment will fail. The default is 0.

Limitation: Modifications to this attribute will not effect established network links.

TA_MAXENCRYPTBITS={0|40|128}

When establishing a network link, negotiate encryption up to this level. 0 means no encryption, whilc 40 and 128 specify the encryption length (in bits). The default is 128.

Limitation: Modifications to this attribute will not effect established network links.

When the 128-bit encryption package is installed, TA_ MAXENCRYPTBITS defaults to 128. When the 40-bit package is installed, the default is 40. When no encryption package is installed, the default is 0 bits. Note that when BRIDGE processes connect, they negotiate to the highest common TA_MAXENCRYPTBITS.

Limitations

None.

---

---