File Formats, Data Descriptions, MIBs, and System Processes Reference

 

---

T_NETMAP Class Definition

Overview

The T_NETMAP class associates TA_LMIDs from the T_MACHINE class in the TM_MIB to a TA_NETGROUP object from the T_NETGROUP class. In other words, this class contains assignments of logical machines to network groups. A TA_LMID may be included in many 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 pair 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

  ¹ Maximum string length for this attribute is 78 bytes for BEA Tuxedo 8.0 or earlier.
² Link-level encryption value of 40 bits is provided for backward compatibility.

Attribute Semantics

TA_NETGROUP: string[1..30]

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

TA_LMID: LMID

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.

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[1..256] (up to 78 bytes for BEA Tuxedo 8.0 or earlier)

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 means by which one Bridge process is contacted by others that are 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 "0xhex-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 specified.

For TCP/IP addresses one of the following formats is used:

• "//hostname:port"
• "//#.#.#.#:port"

TA_FADDR: string[0..256] (up to 78 bytes for BEA Tuxedo 8.0 or earlier)

Specifies the complete network address to which local processes such as tmboot, tmloadcf, and Bridge and can bind before making an outbound connection. This address must be a TCP/IP address. This attribute, along with the TA_FRANGE attribute, determines the range of TCP/IP ports to which a process attempts to bind before making an outbound connection. If this attribute is set to the NULL or empty string, the operating system randomly chooses a local port with which to bind.

If string has the form "0xhex-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 specified.

For TCP/IP addresses, one of the following formats is used:

• "//hostname:port"
• "//#.#.#.#:port"

TA_FRANGE: 1<= num <= 65,535

Specifies the range of TCP/IP ports to which local processes attempt to bind before making an outbound connection. The TA_FADDR attribute specifies the base address of the range.

TA_MINENCRYPTBITS: "{0 | 40 | 56 | 128}"

Specifies the minimum level of encryption required when a network link is being established. 0 means no encryption, while 40, 56, and 128 specify the encryption key length (in bits). If this minimum level of encryption cannot be met, link establishment fails. The default is 0.

Note: The link-level encryption value of 40 bits is provided for backward compatibility.

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

TA_MAXENCRYPTBITS: "{0 | 40 | 56 | 128}"

Specifies the maximum level of encryption allowed when a link is being established. 0 means no encryption, while 40, 56, and 128 specify the encryption length (in bits). The default is 128.

Note: The link-level encryption value of 40 bits is provided for backward compatibility.

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

When 128-bit encryption is licensed, TA_MAXENCRYPTBITS defaults to 128. When 56-bit encryption is licensed, the default is 56. When no encryption is licensed, the default is 0 bits. Note that when Bridge processes connect, they negotiate to the highest common TA_MAXENCRYPTBITS.

Limitations

None.

Contact BEA |  Feedback |  Privacy  |