![]() |
![]() |
|
|
T_INTERFACE Class Definition
Overview
The T_INTERFACE MIB class represents configuration and run-time attributes of CORBA interfaces at both the domain and server group levels.
A domain-level T_INTERFACE object is one that is not associated with a Server Group. Its TA_SRVGRP attribute contains a null string (string of length 0, "").
A server group level T_INTERFACE object is one that has an associated server group (i.e., its TA_SRVGRP attribute contains a valid server group name for the domain). This Server Group level representation of an interface also provides a container for managing interface state (TA_STATE) and for collecting accumulated statistics.
An associated server group level T_INTERFACE object must exist for any CORBA interfaces that are activated in a server. The activation of interfaces in a server is controlled by the state of a T_IFQUEUE object for the interface. Activation of a T_IFQUEUE object causes its attributes to be initialized with the values specified for the associated server group level T_INTERFACE object. If such an object does not exist, then one will be dynamically created. This dynamically-created server group level T_INTERFACE object will be initialized with the attributes of the domain level T_INTERFACE object for the interface if one exists. If an associated domain level T_INTERFACE object does not exist, system specified default configuration values will be applied. Once activated, interfaces are always associated with a server group level T_INTERFACE object.
The specification of configuration attributes for interfaces at any level is completely optional, system defined defaults will be provided and run-time server group level T_INTERFACE objects will be created. Interfaces to be offered by a server are identified via the ICF file used to generate server skeletons and advertised automatically by the system at server activation time.
Attribute Table
Attribute |
Usage |
Type |
Permissions |
Values |
Default |
---|---|---|---|---|---|
TA_INTERFACENAME |
r* |
string |
ru-r--r-- |
string[1..128] |
N/A |
TA_SRVGRP |
r* |
string |
ru-r--r-- |
string[0..30] |
N/A |
TA_STATE |
k |
string |
rwxr-xr-- |
GET: "{ACT | INA | SUS | PAR}" SET: "{NEW | INV | ACT | REA | SUS}" |
N/A |
TA_AUTOTRAN |
|
string |
rwxr-xr-- |
"{Y|N}" |
"N" (See Note 1 below.) |
TA_LOAD |
|
long |
rwxr-xr-- |
1 <= num < 32K |
50 (See Note 1.) |
TA_PRIO |
|
long |
rwxr-xr-- |
1<= num < 101 |
50 (See Note 1.) |
TA_TIMEOUT |
|
long |
rwxr-xr-- |
0 <= num |
0 (See Note 1.) |
TA_TRANTIME |
|
long |
rwxr-xr-- |
0 <= num |
30 (See Note 1.) |
TA_FBROUTINGNAME |
|
string |
rwyr-yr-- |
string[1...15] |
(See Note 2.) |
TA_LMID |
k |
string |
R--R--R-- |
LMID |
N/A |
TA_NUMSERVERS |
|
long |
R--R--R-- |
0 <= num |
N/A |
TA_TPPOLICY |
|
string |
R--R--R-- |
"{method | transaction | process}" |
N/A |
TA_TXPOLICY |
|
string |
R-R-R-- |
"{always | never | optional | ignore}" |
N/A |
TA_NCOMPLETED |
l |
long |
R-XR-XR-- |
0 <= num |
N/A (See Note 3.) |
TA_NQUEUED |
l |
long |
R--R--R-- |
0 <= num |
N/A |
( k ) - GET key field |
Attribute Semantics
ACTive T_INTERFACE object is defined and at least one corresponding T_IFQUEUE entry is in the ACTive state. Note: For a group level T_INTERFACE object, corresponding T_IFQUEUE entries are those with matching TA_INTERFACENAME and TA_SRVGRP attributes. For a domain level T_INTERFACE object, corresponding T_IFQUEUE entries are those with matching TA_INTERFACENAME attributes regardless of their TA_SRVGRP value. INActive T_INTERFACE object is defined and there are no corresponding T_IFQUEUE entries in any ACTive equivalent state. SUSpended T_INTERFACE object is defined and amongst all corresponding T_IFQUEUE entries there are none in the ACTive state and at least one in the SUSpended state. This state is ACTive equivalent for the purpose of determining permissions. PARtitioned T_INTERFACE object is defined and amongst all corresponding T_IFQUEUE entries there are
NEW Create T_INTERFACE object for application. State change only allowed when in the INValid state. Successful return leaves object in INActive state. Creation of a domain level T_INTERFACE object will affect existing group level objects with the same TA_INTERFACENAME value by resetting all TA_FBROUTINGNAME values if a new value is explicitly specified. All other configuration attribute settings will not affect existing group level T_INTERFACE objects. INValid Delete T_INTERFACE object for application. State change only allowed when in the INActive state. Successful return leaves object in INValid state. ACTive Activate the T_INTERFACE object. Setting this state on the domain level object has the effect of activating all corresponding T_IFQUEUE entries that are currently SUSpended throughout the domain. Setting this state on the group level object will affect only servers within the group offering the interface. State change only allowed when in the SUSpended state. Successful return leaves object in ACTive state. REActivate Reactivate the T_INTERFACE object. Setting this state on the domain level object has the effect of activating all corresponding T_IFQUEUE entries that are currently SUSpended throughout the domain. Setting this state on the group level object will affect only servers within the group offering the interface. State change only allowed when in the ACTive or SUSpended states. Successful return leaves object in ACTive state. This state permits global activation of T_IFQUEUE entries suspended at the group level without having to individually activate each group level T_INTERFACE object. SUSpended Suspend the T_INTERFACE object. Setting this state on the domain level object has the effect of suspending all corresponding T_IFQUEUE entries that are currently ACTive throughout the domain. Setting this state on the group level object will affect only servers within the group offering the interface. State change only allowed when in the ACTive state. Successful return leaves object in SUSpended state.
always A value of N will have no effect at run time. Behavior will be as though the setting was Y. never A value of Y will have no effect. The interface will never be involved in a transaction. ignore A value of Y will have no effect. The interface will never be involved in a transaction.
Implementation Hint
The T_INTERFACE MIB is a mapping from an interface to a BEA Tuxedo service. The MIB server can implement some of the get/set operations for an interface by calling the existing logic for the associated T_SERVICE object.
![]() |
![]() |
![]() |
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|