This chapter describes five MIB tables that are specific to the M3 product. To access these MIB objects, the M3 version of the Agent Connection should be running on the machine where M3 application resources are accessible. Table 6-1 lists the M3 groups. In addition to the objects in these M3 specific groups, the TUXEDO Core MIB contains the following M3 specific objects:
m3MaxObjects
The object
This table represents occurrences of factories registered with the FactoryFinder.
.1.3.6.1.4.1.140.300.48.1.1
.1.3.6.1.4.1.140.300.48.1.2
.1.3.6.1.4.1.140.300.48.1.3
.1.3.6.1.4.1.140.300.48.1.4
tuxTranGstate also has M3 specific states. For more information on these objects, refer to Chapter 4, "TUXEDO Core MIB."
m3FactoryTable
Variable Name
Object ID
m3FactorySerNo
m3FactoryId
m3FactoryIfName
m3FactoryState
m3FactorySerNo
Syntax
INTEGERAccess
read-only
Description
This object is the running number. This is used as the index to instances in this table.
Syntax
DisplayString(SIZE(1..256))Access
read-only
Description
The registered ID for the factory.
Syntax
DisplayString(SIZE(1..128))Access
read-only
Description
The fully qualified interface name for the factory. This is the interface repository ID for the factory. The format of this name is dependent on the options specified in the IDL which generates the interface implementation. Consult the CORBA 2.1 specification, section 7.6, for details.
Syntax
INTEGER { active(1) }Access
read-only
Description
A
GEToperation retrieves runtime information for the selectedm3FactoryTableinstance or instances. The returned value is 1 (active) if the instance is registered with the FactoryFinder.
The m3InterfaceTable represents configuration and runtime attributes of CORBA interfaces at both the domain and server-group levels.
There are certain semantic differences in the objects in the m3InterfaceTable between server-group and domain level instances.
A domain-level m3InterfaceTable instance is an instance that is not associated with a Server group. In this case, its m3IfSrvGrp attribute will have the invalid value *.
A server-group level instance is an instance that has an associated Server group. In this case, its m3IfSrvGroup attribute has a valid server group name for the domain. This server-group level representation of an interface also provides a container for managing the interface state (the m3IfState object) and for collecting accumulated statistics.
Every CORBA interface that is activated in a server must have a a server-group level m3InterfaceTable instance. The activation of interfaces in a server is controlled by the state of a m3IfQueue instance for the interface. Activation of an m3IfQueue instance causes its attributes to be initialized with values specified for the associated server-group level m3InterfaceTable instance. If such an instance does not already exist, then one will be dynamically created. This dynamically created server-group level m3InterfaceTable instance will be initialized with the attributes of the domain-level m3InterfaceTable instance for the interface if one exists. If an associated domain-level instance does not exist, system-specified default configuration values will be used. After they are activated, interfaces are always associated with a server-group level m3InterfaceTable instance.
The specification of configuration attributes for interfaces at any level is optional. Interfaces offered by a server are identified through the ICF file used for generating skeletons and advertised automatically by the system when the server is activated.
The following table lists the objects within the m3InterfaceTable.
Syntax
INTEGERAccess
read-only
Description
This is the running number. This object is used as an index to instances in this table.
Syntax
DisplayString(SIZE(1..128))Access
read-only
Description
The fully qualified interface name. This is the interface ID. The format of this name is one of the options specified in the IDL which generates the interface implementation. Consult the CORBA 2.1 specification, Section 7.6, for details.
Syntax
DisplayString(SIZE(1..30))Access
read-write
Description
The server group name. Server group names cannot contain an asterisk, comma, or colon. If an asterisk (
*)is specified as a value for this object, this specifies a domain level instance.Note: This object can be
SETonly during creation of a new row.
Syntax
INTEGER { active(1), inactive(2), suspended(3), partitioned(4), invalid(5), reactivate(6) }Access
read-write
Description
The semantics for
GETandSETrequests differ between server-group and domain level instances as noted in the following list.
GET:{active(1)|inactive(2)|suspended(3)|partitioned(4)}- A
GETrequest will retrieve configuration information for the selectedm3InterfaceTableinstance or instances. The only states that may be returned are:active,inactive,suspended,partitioned.
active(1)- The
m3InterfaceTableinstance is defined and at least one correspondingm3IfQueueTableinstance is in the active state. For a server-group levelm3InterfaceTableinstance, correspondingm3IfQueueTableinstances are those with matchingm3IfNameandm3IfSrvGrpobjects. For a domain-levelm3InterfaceTableinstance, correspondingm3IfQueueTableinstances are those with matchingm3IfNamevalue regardless of theirm3IfSrvGrpvalue.inactive(2)- The
m3InterfaceTableinstance is defined and there are no correspondingm3IfQueueTableinstances in any active state.suspended(3)- The
m3InterfaceTableinstance is defined and amongst all correspondingm3IfQueueTableinstances there are none in the active state and at least one in the suspended state.partitioned(4)- The
m3InterfaceTableinstance is defined and amongst all the correspondingm3IfQueueTableinstances, there are none in the active state, none in the suspended state, and at least one in the partitioned state.SET: {invalid(5)|active(1)|inactive(2)|reactivate(6)|suspended(3)}- A
SETrequest updates runtime and configuration information for the selectedm3InterfaceTableinstance. Modifications may affect more than one server group when making domain-level changes and runtime modifications may affect more than one server if multiple servers are currently offering an interface. Only the following values may be used in aSETrequest:invalid,active,reactivate, orsuspended.
invalid(5)- Delete the
m3InterfaceTableinstance for the application. This state change is allowed only when the instance is in the inactive state.active(1)- Activate the
m3InterfaceTableinstance for the application. Setting this state on a domain level instance has the effect of activating all correspondingm3IfQueueTableinstances that are currently suspended throughout the domain. Setting this state on a server-group level instance affects only servers within the group offering the interface. This state change is allowed only when the instance is in the suspended state. A successful return leaves the object in theactive(1)state.reactivate(6)- Reactivates the
m3InterfaceTableinstance. Setting this state on a domain level instance has the effect of activating all correspondingm3IfQueueTableinstances that are currently suspended throughout the domain. Setting this state on a server-group level instance affects only servers within the group offering the interface. This state change is allowed only when the instance is in theactive(1)orsuspended(3)states. Successful return leaves the instance in theactive(1)state. Setting this state permits global activation ofm3IfQueueTableinstances suspended at the server-group level without having to individually activate each server-group levelm3InterfaceTableinstance.suspended(3)- Suspend the
m3InterfaceTableinstance. Setting this state on the domain-level object has the effect of suspending all correspondingm3IfQueueTableinstances that are currently active throughout the domain. Setting this state on a server-group level instance affects only servers within the group offering the interface. This state change is permitted only when in theactive(1)state. Successful return leaves the object in thesuspended(3)state.Note: Dynamic advertisement of interfaces (that is, state change from
inactive(2)orinvalid(5)toactive(1)) is not supported, nor is removal of advertisement (that is, state change fromactive(1)toinactive(2)).
Syntax
INTEGER { yes(1), no(2) }Access
read-write
Description
Signifies whether a transaction will be automatically started for invocations made outside of a transaction context.
This object has the following limitations:
- Runtime updates to this attribute are not reflected in active equivalent
m3InterfaceTableinstances.
Syntax
INTEGER(1..32767)Access
read-write
Description
This object imposes the indicated load on the system. Inferface loads are used for load-balancing. That is, queues with higher enqueued workloads will be less likely to be chosen for a new request.
Note: Runtime updates to this attribute for domain level instances will not affect corresponding server-group level instances for the same interface.
Syntax
INTEGER(1..100)Access
read-write
Description
Dequeueing priority. If multiple interface requests are waiting on a queue for servicing, the higher priority requests are handled first.
Note: Runtime updates to this attribute for domain-level instances will not affect corresponding server-group level instances for the same interface.
Syntax
INTEGERAccess
read-write
Description
The time limit (in seconds) for processing individual method invocations for this interface. Servers processing method invocations for this interface will be terminated abortively 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 terminated abortively.
Note: Runtime updates to this attribute for domain-level instances will not affect corresponding server-group level instances for the same interface.
Syntax
INTEGERAccess
read-write
Description
Transaction timeout value in seconds for transactions automatically started for this
m3InterfaceTableinstance. Transactions are started automatically when a request not in transaction mode is received and them3IfAutoTranobject value for the interface isyes(1).Note: Runtime updates to this attribute for domain-level instances will not affect corresponding server-group level instances for the same interface.
Syntax
DisplayString (SIZE(1..15))Access
read-write
Description
The factory-based routing criteria associated with this interface.
Note: This attribute may be set only for a domain-level
m3InterfaceTableinstance, that is, only ifm3IfSrvGrpis*.
Syntax
DisplayString (SIZE(1..30))Access
read-only
Description
Current logical machine with which the active equivalent server-group level
m3InterfaceTableinstance is associated. This attribute isNULLfor domain-level instances.
Syntax
INTEGERAccess
read-only
Description
The number of corresponding servers offering this interface.
Syntax
INTEGER { method(1), transaction(2), process(3) }Access
read-only
Description
The TP framework deactivation policy. This reflects the policy registered with the framework at server startup. The first server to register with the interface sets the value in
m3InterfaceTable. This cannot be changed.
Syntax
INTEGER { always(1), never(2), optional(3), ignore(4) }Access
read-only
Description
The transaction policy for the interface. The setting in this attribute affects the
m3IfAutoTranobject. This policy is set by the application developer and is registered when the server starts.
The table returns values for the local host on which the Agent Connection is running. The following table lists the columnar objects that comprise each row (instance) in the table.
Syntax
INTEGERAccess
read-only
Description
This is the running number. This is used as an index into the table.
Syntax
DisplayString (SIZE(1..128))Access
read-only
Description
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 the CORBA 2.1 Specification Section 7.6 [CORBA] for details.
Syntax
DisplayString (SIZE(1..30))Access
read-only
Description
The server group name. Server group names cannot contain an asterisk, comma, or colon. A value of
*for this object indicates a domain-level interface.
Syntax
INTEGERAccess
read-only
Description
The number of method invocations completed for the corresponding
m3IfQueueTableinstances since they were initially offered. The values returned are for the indicated interface on the local host where the Agent Connection is running.Note: This attribute is returned only when
tuxTdomainLoadBalanceisyes(1).
Syntax
INTEGERAccess
read-only
Description
The number of requests currently enqueued for this interface. The values returned are for the indicated interface on the local host where the Agent Connection is running.
Note: This attribute is returned only when
tuxTdomainLoadBalanceisyes(1).
This table represents the runtime attributes of an interface for a particular server queue. This group provides access to the inherited configuration attributes of an interface as well as statistics relating to the interface on the queue. This class gives administrators finer granularity in suspending and activating interfaces. This group provides the link between the interface name and the server processes capable of processing method invocations on the interface. For example, m3IfQRqAddr can be used to identify the corresponding server in the tuxTsrvrTbl and tuxTsrvrTblExt groups.
Syntax
INTEGERAccess
read-only
Description
The running number used as an index into this table.
Syntax
DisplayString (SIZE(1..128))Access
read-only
Description
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 the CORBA 2.1 specification Section 7.6 for details.
Syntax
DisplayString (SIZE(1..30))Access
read-only
Description
The server group name. Server group names cannot contain an asterisk, comma, or colon.
Syntax
DisplayString (SIZE(1..30))Access
read-only
Description
The symbolic address of the request queue for an active server offering this interface. See
tuxTsrvrRqAddrfor more information about this attribute.
Syntax
INTEGER { active(1), suspended(2), partitioned(3), unknown(4) }Access
read-write
Description
The values for
GETandSEToperations are as follows:
GET:{active(1)|suspended(2)|partitioned(3)}- A
GETrequest will retrieve configuration information for the selectedm3IfQueueTableinstances. The meaning of the possible return values are as follows:
active(1)- Represents an available interface in the running system.
suspended(2)- Represents a currently suspended interface in the running system.
partitioned(3)- Represents a currently partitioned interface in the running system.
SET:{active(1)|suspended(2)}- The values for
SETare:
active(1)- Activates the
m3IfQueueTableinstance. This state change is allowed only when in thesuspended(2)state. A successful return leaves instances in theactive(1)state.suspended(2)- Suspends the
m3IfQueueTableinstance. This state change is allowed only when in theactive(1)state. A successful return leaves the object in thesuspended(2)state.Note: Dynamic advertisement of interfaces (i.e., a state change from inactive or invalid to active) is not supported, nor is unadvertisement (i.e., a state change from active to inactive).
Syntax
INTEGER { yes(1), no(2) }Access
read-only
Description
Signifies whether a transaction will be automatically started for invocations made outside a transaction context.
This object has the following limitations:
- Runtime updates to this attribute are not reflected in active equivalent
m3InterfaceTableinstances.
Syntax
INTEGER(1..32767)Access
read-only
Description
Load imposed on the system by this instance. Interface loads are used for load-balancing. Queues with higher enqueued workloads are less likely to be chosen for a new request.
Syntax
INTEGER(1..101)Access
read-only
Description
Dequeueing priority. If multiple interface requests are waiting on a queue for servicing, the higher priority requests will be handled first.
Syntax
INTEGERAccess
read-only
Description
The 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.
Syntax
INTEGERAccess
read-only
Description
The transaction timeout value in seconds for transactions automatically started for this instance. Transactions are started automatically when a request not in transaction mode is received and the
m3IfAutoTranattribute value for the interface isyes(1).
Syntax
DisplayString (SIZE(1..15))Access
read-only
Description
The factory-based routing criterion associated with this interface.
Syntax
DisplayString (SIZE(1..30))Access
read-only
Description
The current logical machine on which this queue is offering this interface.
Syntax
INTEGERAccess
read-only
Description
The number of corresponding servers offering this interface on this queue.
Syntax
INTEGER { method(1), transaction(2), process(3) }Access
read-only
Description
The TP framework deactivation policy. This reflects the policy registered with the framework at the server startup. The first server to register the interface sets the value. This value cannot be changed.
This table represents the local attributes of the m3IfQueueTable. These values are specific to the host on which the Agent Connection is running.
Syntax
INTEGERAccess
read-only
Description
The running number used as an index into this table.
Syntax
DisplayString(SIZE(1..128))Access
read-only
Description
The fully qualified interface name. The interface repository ID for this interface. The format of this name is dependent on the options specified in the IDL that generates the interface implementation. See the CORBA 2.1 specification Section 7.6 for details.
Syntax
DisplayString(SIZE(1..30))Access
read-only
Description
The server group name. Server group names cannot contain an asterisk, comma, or colon.
Syntax
DisplayString(SIZE(1..30))Access
read-only
Description
The symbolic address of the request queue for an active server offering this interface. See
tuxTsrvrRqAddrfor more information about this attribute.
Syntax
INTEGERAccess
read-only
Description
The number of interface method invocations completed since the interface was initially offered.
Note: This attribute is returned only when
tuxTdomainLoadBalanceis equal toyes(1).
Syntax
INTEGERAccess
read-only
Description
The number of requests currently enqueued for this interface.
Note: This attribute is returned only when
tuxTdomainLoadBalanceis equal toyes(1).
Syntax
INTEGERAccess
read-only
Description
The number of active objects for this interface for the associated queue. This number represents the number of entries in the active object table for this queue on the associated machine. This includes objects that are not in memory but were invoked within an active transaction.
Syntax
INTEGERAccess
read-only
Description
The number of active global transactions associated with this interface for its associated queue.