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
Attribute1
|
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 4
|
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 }" 5
|
N/A
|
(k)—GET key field (*)—GET/SET key, one or more required for SET operations
|
1 All attributes in the
T_BRIDGE
class are local attributes.
2 TA_LMID
attribute must be fully specified for
SET
operations, that is,
LMID1,LMID2
.
3 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.
4 TA_SUSPTIME
may be
SET
only if the
TA_STATE
is currently
SUSPENDED
or is being
SET
to
SUSPENDED
.
5 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.