T_BRIDGE CLASS

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 1: 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 | 128 }

N/A

( k ) - GET key field
( * ) - GET/SET key, one or more required for SET operations

**Table 1: 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 \| 128 }	N/A
( k ) - `GET` key field ( * ) - `GET/SET` key, one or more required for `SET` operations

¹All attributes in Class T_BRIDGE are local attributes.

²The TA_LMID attribute must be fully specified for SET operations, that is, LMID1,LMID2.

³SET operation may only use TA_NETGROUP DEFAULTNET in 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.

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 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. States not listed will not be returned. 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 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 parameter 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 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|128}: The current encryption level for this link. The level is negotiated between machines when the link is established.

`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.

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` 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` parameter 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` 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.

Limitations

None.

[Top] [Prev] [Next] [Bottom]