Section 5 - File Formats, Data Descriptions, MIBs, and System Processes Reference

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

T_BRIDGE Class Definition

Overview

The T_BRIDGE class represents run-time attributes pertaining to connectivity between logical machines making up an application. These attribute values represent connection status and statistics.

Attribute Table

Table 42 TM_MIB(5): T_BRIDGE Class Definition Attribute Table

Attribute¹	Type	Permissions	Values	Default
`TA_LMID`(*)2	string	`r--r--r--`	`"LMID1`[`,LMID2`]`"`	N/A
`TA_NETGROUP`(k)3	string	`R--R--R--`	`string`[1. . 30]	`"DEFAULTNET"`
`TA_STATE`(k)	string	`rwxrwxr--`	`GET`: `"`{`ACT` \| `INA` \| `SUS` \| `PEN`}`"` `SET`: `"`{`ACT` \| `INA` \| `SUS` \| `PEN`}`"`	N/A N/A
`TA_CURTIME`	long	`R--R--R--`	0 <= `num`	N/A
`TA_CONTIME`	long	`R-XR-XR--`	0 <= `num`	N/A
`TA_SUSPTIME`	long	`rwxrwxr--`	0 <= `num`	300 ⁴
`TA_RCVDBYT`	long	`R-XR-XR--`	0 <= `num`	N/A
`TA_SENTBYT`	long	`R-XR-XR--`	0 <= `num`	N/A
`TA_RCVDNUM`	long	`R-XR-XR--`	0 <= `num`	N/A
`TA_SENTNUM`	long	`R-XR-XR--`	0 <= `num`	N/A
`TA_FLOWCNT`	long	`R-XR-XR--`	0 <= `num`	N/A
`TA_CURENCRYPTBIT`	string	`R--R-----`	`"`{`0` \| `40` \| `56` \| `128`}`"` ⁵	N/A
(k)—`GET` key field (*)—`GET/SET` key, one or more required for `SET` operations

¹All attributes in the T_BRIDGE class are local attributes.
²TA_LMID attribute must be fully specified for SET operations, that is, LMID1,LMID2.
³SET operation may only use TA_NETGROUP DEFAULTNET in BEA Tuxedo release 6.4. GET operation may use any TA_NETGROUP defined for both LMID values.
⁴TA_SUSPTIME may be SET only if the TA_STATE is currently SUSPENDED or is being SET to SUSPENDED.
⁵Link-level encryption value of 40 bits is provided for backward compatibility.

Attribute Semantics

TA_LMID: "LMID1[,LMID2]"

Source logical machine identifier (LMID1) and destination logical machine identifier (LMID2) for network connection.

TA_NETGROUP: string[1 . .30]

Logical name of the network group.When both source and destination TA_LMID identifiers are in the same TA_NETGROUP, the T_BRIDGE class will present all instances of related fields per TA_NETGROUP. TA_NETGROUP may be used as a key field on GET requests. TA_NETGROUP values other than DEFAULTNET may not be used on SET operations in this BEA Tuxedo release (release 6.4).

TA_STATE:

GET: "{ACTive | INActive | SUSpended | PENding}"

A GET operation will retrieve run-time information for the selected T_BRIDGE object(s). A TA_LMID attribute value with only one logical machine identifier matches all active connections from LMID1 to other machines in the application. In this case, each retrieved record will contain an expanded TA_LMID attribute value with the destination LMID filled in. The following states indicate the meaning of a TA_STATE returned in response to a GET request.

`ACTive`	The connection is established and active.
`INActive`	The connection is inactive. This state is only returned when status is requested on a particular connection, that is, both Lands specified in the `TA_LMID` attribute and the source logical machine is reachable.
`SUSpended`	An established connection was terminated due to an error condition, and reconnection has been suspended for at least the amount of time indicated in the `TA_SUSPTIME` attribute value. This state is `ACTive` equivalent for the purpose of determining permissions.
`PENding`	An asynchronous connection has been requested, but has not yet been completed. The final outcome of the connection request has not been determined.

SET: "{ACTive | INActive | SUSpended | PENding}"

A SET operation will update run-time information for the selected T_BRIDGE object. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

`unset`	Modify an existing `T_BRIDGE` object. This combination is allowed only when in the `ACTive` or `SUSpended` state. Successful return leaves the object state unchanged.
`ACTive`	Activate the `T_BRIDGE` object by establishing a connection between the indicated logical machines. This operation will fail if only one logical machine is specified, if either of the two machines is not active, or if the source logical machine is not reachable. While the `T_BRIDGE` object is establishing the asynchronous connection, the Bridge process will do other work. Using the state change to `PENding` is recommended. State change allowed in the `INActive` and `SUSpended` states. For the purpose of determining permissions for this state transition, the active object permissions are considered (that is, --x--x--x). Successful return leaves the object in the `PENding` state.
`INActive`	Deactivate the `T_BRIDGE` object by closing the connection between the indicated logical machines. This operation will fail if only one logical machine is specified or if the two machines are not connected. State change allowed only when in the `ACTive` state. Successful return leaves the object in the `INActive` state.
`SUSpended`	Suspend the `T_BRIDGE` object by closing the connection between the indicated logical machines and by setting the `TA_SUSPTIME` attribute as indicated. State change allowed only when in the `ACTive` state. Successful return leaves the object in the `SUSpended` state. Limitation: Note that since the statistics reported are from the viewpoint of the source logical machine, resetting those statistics will cause them to be out of sync with the statistics reported by the destination logical machine for the same connection.
`PENding`	Activate the `T_BRIDGE` object by establishing an asynchronous connection between the indicated logical machines. This operation will fail if only one logical machine is specified, if either of the two machines is not active, or if the source machine is not reachable. When in the `PENding` state, the success or failure of the connection request has not yet been determined. However, the Bridge process may continue to process other events and data while the connection is outstanding. State change allowed in the `INActive` and `SUSpended` states. For the purpose of determining permissions for this state transition, the active object permissions are considered (that is, --x--x--x). Successful return leaves the object in the `PENding` state.

TA_CURTIME: 0 <= num

Current time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on T_BRIDGE:TA_LMID. This attribute can be used to compute elapsed time from the following attribute value.

TA_CONTIME: 0 <= num

Time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on T_BRIDGE:TA_LMID, when this connection was first established. Elapsed open time in seconds can be computed using TA_CURTIME - TA_CONTIME.

TA_SUSPTIME: 0 <= num

Time, in seconds, remaining in the suspension of this connection. After this amount of time, the connection will automatically change to a TA_STATE of INACTIVE and may be activated by normal application traffic.

TA_RCVDBYT: 0 <= num

Number of bytes sent from the destination logical machine to the source logical machine.

TA_SENTBYT: 0 <= num

Number of bytes sent from the source logical machine to the destination logical machine.

TA_RCVDNUM: 0 <= num

Number of messages sent from the destination logical machine to the source logical machine.

TA_SENTNUM: 0 <= num

Number of messages sent from the source logical machine to the destination logical machine.

TA_FLOWCNT: 0 <= num

Number of times flow control has been encountered over this connection.

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

The current encryption level for this link. The level is negotiated between machines when the link is established.

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

Limitations

None.