File Formats, Data Descriptions, MIBs, and System Processes Reference
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, 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.
50 1 |
|||||
(2 ) |
|||||
N/A 3 |
|||||
( k ) - |
The fully qualified interface name. The interface repository ID for the interface. The format of this name is dependent on the options specified in the IDL which generates the interface implementation. See CORBA 2.1 Specification Section 7.6 for details.
Server group name. Server group names cannot contain an asterisk, comma or colon. An explicitly specified 0 length string for this attribute is used to specify and query domain level configuration and run-time information for an interface. There are certain limitations and semantic differences noted in other attributes with respect to domain and group level objects in this class.
A GET
operation will retrieve configuration information for the selected T_INTERFACE
objects. The following states indicate the meaning of a TA_STATE
returned in response to a GET
request. States not listed will not be returned.
A SET
operation will update configuration and run-time information for the selected T_INTERFACE
object. Note that modifications may affect more than one server group when making domain level changes and run-time modifications may affect more than one server if multiple servers are currently offering an interface. The following states indicate the meaning of a TA_STATE
set in a SET
request. States not listed may not be set.
Signifies whether a transaction will be automatically started for invocations made outside a transaction context.
Limitations: Run-time updates to this attribute are not reflected in active equivalent T_INTERFACE
objects and TA_TXPOLICY
may override the value specified for this attribute in the UBBCONFIG
file. If TA_TXPOLICY
is:
This T_INTERFACE
object imposes the indicated load on the system. Interface loads are used for load balancing purposes, that is, queues with higher enqueued workloads are less likely to be chosen for a new request.
Limitation: Run-time updates to this attribute for domain level objects will not affect corresponding group level objects for the same interface.
This T_INTERFACE
object has the indicated dequeuing priority. If multiple interface requests are waiting on a queue for servicing, the higher priority requests will be handled first.
Limitation: Run-time updates to this attribute for domain level objects will not affect corresponding group level objects for the same interface.
Time limit (in seconds) for processing individual method invocations for this interface. Servers processing method invocations for this interface will be abortively terminated if they exceed the specified time limit in processing the request. A value of 0 for this attribute indicates that the server should not be abortively terminated.
Limitation: Run-time updates to this attribute for domain level objects will not affect corresponding group level objects for the same interface.
Transaction timeout value in seconds for transactions automatically started for this T_INTERFACE
object. Transactions are started automatically when a requests not in transaction mode is received and the T_INTERFACE: TA_AUTOTRAN
attribute value for the interface is "Y
".
Limitation: Run-time updates to this attribute for domain level objects will not affect corresponding group level objects for the same interface.
Note: Updating this value at run-time for domain level objects should cause a warning, since the only use would be to set the default for a subsequent boot of the application.
The factory-based routing criteria associated with this interface. The name FBROUTINGNAME
is used to allow for the future possibility of other routing criteria for message-based routing. This will be less confusing than trying to overload ROUTINGNAME
.
Limitation: This attribute may be set only for a domain level T_INTERFACE
object, i.e., TA_SRVGRP is ""
.
Current logical machine with which the active equivalent group level T_INTERFACE
object is associated. This attribute is blank, i.e., "" for domain level objects unless a local query is performed, i.e., TA_FLAGS
has the MIB_LOCAL
bit set. In the local case, multiple domain level objects will be returned for the same interface, one per machine, with the local values retrieved from each machine represented in the separate objects.
Used to mark an interface implementation as idempotent in the implementation configuration
file (ICF). An idempotent implementation can be repeated without any negative side-effects. For example, SET BALANCE
.
The TP framework deactivation policy. This reflects the policy registered with the framework at server startup. The first server to register the interface sets the value in T_INTERFACE
. This value cannot be changed.
The transaction policy for the interface. The setting in this attribute affects the effect of the TA_AUTOTRAN
attribute. See TA_AUTOTRAN
for further explanation. This attribute is always read-only. It is set by the developer when the server is built and registered at server startup.
Number of interface method invocations completed with respect to the corresponding T_IFQUEUE
objects since they were initially offered. Local queries (TA_FLAGS MIB_LOCAL
bit set) on domain level objects will return one object per machine with the statistics for the indicated interface on that machine.
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.