SNMP Agent MIB Reference

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Core MIB

The Core MIB defines the groups through which the fundamental aspects of an application can be configured and managed. These MIB groups contain objects for managing machines, servers, networking, and load balancing.

The Core MIB defines the basic objects that form an Oracle Tuxedo application. It is the main information repository for controlling the operation and configuration of the application. When an application is active, the Core MIB contains groups related to the run-time activity of your application. You can use this information to monitor the behavior of your application.

The Core MIB consists of the following groups.

Group Name
Description
Network connection
Client
Conversation
Device
Domain information
Server group
Machine configuration objects
Run-time machine characteristics
Message queue
Server queue
Routing criteria
Server configuration objects
Server run-time characteristics
Service
Service-group configuration objects
Tuxedo listeners
Transaction
Userlog
Control filter MIB for tuxTulogTable
Maps logical machine IDs to network groups
Application objects of network groups
Configuration and run-time objects of individual server dispatch contexts
Used to define a subset of Tuxedo event notifications

 


tuxTBridgeTbl

The tuxTBridgeTbl group contains objects that represent run-time characteristics pertaining to connectivity between logical machines that make up an application. The object values represent connection status and statistics.

Objects in this table are accessible either through a Tuxedo SNMP agent installed on the local machine or using the -c option on the master machine. The index into the table consists of tuxTBridgeLmid and tuxTBridgeNetworkGrpNo. In Tuxedo 6.4, SET requests are allowed only for the DEFAULTNET network group, so all SET requests should use 0 for tuxTBridgeNetworkGrpNo in the SNMP index.

Object Name
Object ID
.1.3.6.1.4.1.140.300.16.1.1.1
.1.3.6.1.4.1.140.300.16.1.1.2
.1.3.6.1.4.1.140.300.16.1.1.3
.1.3.6.1.4.1.140.300.16.1.1.4
.1.3.6.1.4.1.140.300.16.1.1.5
.1.3.6.1.4.1.140.300.16.1.1.6
.1.3.6.1.4.1.140.300.16.1.1.7
.1.3.6.1.4.1.140.300.16.1.1.8
.1.3.6.1.4.1.140.300.16.1.1.9
.1.3.6.1.4.1.140.300.16.1.1.10
.1.3.6.1.4.1.140.300.16.1.1.11
.1.3.6.1.4.1.140.300.16.1.1.12
.1.3.6.1.4.1.140.300.16.1.1.13

 


tuxTBridgeLmid

Syntax

DisplayString (SIZE(1..61))

Access

read-only

Description

DisplayString is of the format: LMID1[,LMID2]

LMID1

Is the logical machine identifier for network connection and is in the range from one to 61 characters.

LMID2

Is the destination logical machine identifier for network connection and is in the range from one to 61 characters.

 


tuxTBridgeState

Syntax

INTEGER {active(1), inactive(2), suspended(3), pending(4)}

Access

read-write

Description

The values for GET and SET operations are as follows:

GET:{active(1)|inactive(2)|suspended(3)|pending(4)}

A GET operation retrieves run-time information for the selected tuxTBridgeTbl instance(s). A tuxTBridgeLmid object 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 contains an expanded tuxTBridgeLmid object value with the destination LMID filled in. The following states indicate the meaning of a tuxTBridgeState returned in response to a GET request. States not listed are not returned.

active(1)

The connection is established and active.

inactive(2)

The connection is inactive. This state is only returned when status is requested on a particular connection, that is, both LMIDs are specified in the tuxTBridgeLmid object and the source logical machine is reachable.

suspended(3)

An established connection has been terminated due to an error condition, and reconnection has been suspended for at least the amount of time indicated in the tuxTBridgeSuspTime object value.

pending(4)

An asynchronous connection has been requested but has not yet completed. The final outcome of the connection request has not been determined.

SET: {active(1)|inactive(2)|suspended(3)|pending(4)}

A SET operation updates run-time information for the selected tuxTBridgeTbl object. The following states indicate the meaning of a tuxTBridgeState set in a SET request. States not listed cannot be set.

active(1)

Activate the tuxTBridgeTbl instance by establishing an asynchronous connection between the indicated logical machines. This operation fails if only one machine is specified, if either of the machines is not active, or if the source machine is not reachable. When in the pending(4) state, the success or failure of the connection has not yet been determined. The BRIDGE can continue to process other events and data while the connection is outstanding. This state change is allowed in the inactive(2) and suspended(3) states. Successful return leaves the instance in the active(1) or pending(4) state.

inactive(2)

Deactivate the tuxTBridgeTbl object by closing the connection between the indicated logical machines. This operation fails if only one logical machine is specified or if the two machines are not connected. State change allowed only when in the active(1) state. Successful return leaves the object in the inactive(2) state.

suspended(3)

Suspend the tuxTBridgeTbl object by closing the connection between the indicated logical machines and by setting the tuxTBridgeSuspTime parameter as indicated. State change allowed only when in the active(1) state. Successful return leaves the object in the suspended(3) state.
Note: Since the statistics reported are from the source logical machine, resetting those statistics causes them to be out of sync with the statistics reported by the destination logical machine for the same connection.

pending(4)

Activate the tuxTBridgeTbl instance by establishing an asynchronous connection between the indicated logical machines. This operation fails if only one logical machine is specified, if either of the two machines is inactive, or if the source logical machine is not reachable. When in the pending(4) state, the success or failure of the connection request has not yet been determined. However, the BRIDGE can continue to process other events and data while the connection request is outstanding. State change allowed in inactive(2) and suspended(3) states. Successful return leaves the instance in the pending(4) state.

 


tuxTBridgeCurTime

Syntax

INTEGER

Access

read-only

Description

Current time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on tuxTBridgeLmid. This object can be used to compute elapsed time from the following “tuxTBridge” object values.

 


tuxTBridgeConTime

Syntax

INTEGER

Access

read-only

Description

Time, in seconds, that this connection has been active.

 


tuxTBridgeSuspTime

Syntax

INTEGER

Access

read-write

Description

Time, in seconds, remaining in the suspension of this connection. After this amount of time, the connection automatically changes to a tuxTBridgeState of inactive(2) and can be activated by normal application traffic.

 


tuxTBridgeRcvdByte

Syntax

INTEGER

Access

read-only

Description

Number of bytes sent from the destination logical machine to the source logical machine.

 


tuxTBridgeSentByte

Syntax

INTEGER

Access

read-only

Description

Number of bytes sent from the source logical machine to the destination logical machine.

 


tuxTBridgeRcvdNum

Syntax

INTEGER

Access

read-only

Description

Number of messages sent from the destination logical machine to the source logical machine.

 


tuxTBridgeSentNum

Syntax

INTEGER

Access

read-only

Description

Number of messages sent from the source logical machine to the destination logical machine.

 


tuxTBridgeFlowCnt

Syntax

INTEGER

Access

read-only

Description

Number of times flow control has been encountered over this connection.

 


tuxTBridgeCurEncryptBits

Syntax

INTEGER {none(1), 40-bit(2), 128-bit(3), not-available(4)}

Access

read-only

Description

The current level of encryption for this link. The tuxTBridgeCurEncryptBits value is negotiated between the machines when the link is established. The number specifies the encryption key length (in bits).

 


tuxTBridgeNetworkGrpNo

Syntax

INTEGER

Access

read-only

Description

Logical network group number. When both the source and destination tuxTBridgeLmid machine identifiers are in the same network group, tuxTBridgeTbl presents all instances of related fields per network group.

 


tuxTBridgeNetworkGrpName

Syntax

DisplayString

Access

read-only

Description

Logical network group name.

 


tuxTclientTbl

The tuxTclientTbl group contains objects that represent run-time characteristics of active clients within an application. The object values identify and track the activity of clients within a running application. Objects in this table are only accessible through a Tuxedo SNMP agent installed on the local machine.

Object Name
Object ID
tuxTclientState
.1.3.6.1.4.1.140.300.17.1.1.1
tuxTclientBirthTime
.1.3.6.1.4.1.140.300.17.1.1.2
tuxTclientMachineId
.1.3.6.1.4.1.140.300.17.1.1.3
tuxTclientReg
.1.3.6.1.4.1.140.300.17.1.1.4
tuxTclientClntName
.1.3.6.1.4.1.140.300.17.1.1.5
tuxTclientIdleTime
.1.3.6.1.4.1.140.300.17.1.1.6
tuxTclientPid
.1.3.6.1.4.1.140.300.17.1.1.7
tuxTclientSrvGrp
.1.3.6.1.4.1.140.300.17.1.1.8
tuxTclientUsrName
.1.3.6.1.4.1.140.300.17.1.1.9
tuxTclientWsc
.1.3.6.1.4.1.140.300.17.1.1.10
tuxTclientWsh
.1.3.6.1.4.1.140.300.17.1.1.11
tuxTclientWshClientId
.1.3.6.1.4.1.140.300.17.1.1.12
tuxTclientRelease
.1.3.6.1.4.1.140.300.17.1.1.13
tuxTclientWsProto
.1.3.6.1.4.1.140.300.17.1.1.14
tuxTclientNumConv
.1.3.6.1.4.1.140.300.17.1.1.15
tuxTclientNumDeque
.1.3.6.1.4.1.140.300.17.1.1.16
tuxTclientNumEnque
.1.3.6.1.4.1.140.300.17.1.1.17
tuxTclientNumPost
.1.3.6.1.4.1.140.300.17.1.1.18
tuxTclientNumReq
.1.3.6.1.4.1.140.300.17.1.1.19
tuxTclientNumSubscribe
.1.3.6.1.4.1.140.300.17.1.1.20
tuxTclientNumTran
.1.3.6.1.4.1.140.300.17.1.1.21
tuxTclientNumTranAbt
.1.3.6.1.4.1.140.300.17.1.1.22
tuxTclientNumTranCmt
.1.3.6.1.4.1.140.300.17.1.1.23
tuxTclientCmtRet
.1.3.6.1.4.1.140.300.17.1.1.24
tuxTclientCurConv
.1.3.6.1.4.1.140.300.17.1.1.26
tuxTclientCurReq
.1.3.6.1.4.1.140.300.17.1.1.27
tuxTclientCurTime
.1.3.6.1.4.1.140.300.17.1.1.28
tuxTclientLastGrp
.1.3.6.1.4.1.140.300.17.1.1.29
tuxTclientNaddr
.1.3.6.1.4.1.140.300.17.1.1.30
tuxTclientNotify
.1.3.6.1.4.1.140.300.17.1.1.31
tuxTclientNumUnSol
.1.3.6.1.4.1.140.300.17.1.1.32
tuxTclientRpid
.1.3.6.1.4.1.140.300.17.1.1.33
tuxTclientTimeLeft
.1.3.6.1.4.1.140.300.17.1.1.34
tuxTclientTimeStart
.1.3.6.1.4.1.140.300.17.1.1.36
tuxTclientTranLev
.1.3.6.1.4.1.140.300.17.1.1.37
tuxTclientId
.1.3.6.1.4.1.140.300.17.1.1.38
tuxTclientContextID
.1.3.6.1.4.1.140.300.17.1.1.50

 


tuxTclientState

Syntax

INTEGER { active(1), suspended(2), dead(3) }

Access

read-write

Description

The values for GET and SET operations are as follows:

GET: {active(1)|suspended(2)|dead(3)}

A GET operation retrieves run-time information for the selected tuxTclientTbl instance(s). Note that client information is kept in local bulletin board tables only. Therefore, for maximum performance, inquiries on client status should be restricted, using key fields as much as possible. The following states indicate the meaning of a tuxTclientState returned in response to a GET request. States not listed are not returned.

active(1)

tuxTclientTbl instance active. The active(1) state is not an indication of whether the client is idle or busy. A non-0 value retrieved for either the tuxTclientCurConv object or the tuxTclientCurReq object indicates a busy client.

suspended(2)

tuxTclientTbl instance active and suspended from making further service requests (tpcall(3) or tpacall(3)) and from initiating further conversations (tpconnect(3)). See SET suspended(2) below for details.

dead(3)

tuxTclientTbl instance identified as active in the bulletin board but currently not running due to an abnormal death. This state exists only until the BBL local to the client notices the death and takes action to clean up the client’s bulletin board resources.

SET: {active(1)|suspended(2)|dead(3)}

A SET operation updates run-time information for the selected tuxTclientTbl object. The following states indicate the meaning of a tuxTclientState set in a SET request. States not listed cannot be set.

active(1)

Activate a suspended(2) tuxTclientTbl instance. State change allowed only when in the suspended(2) state. Successful return leaves the object in the active(1) state.

suspended(2)

Suspend the tuxTclientTbl instance from making service requests (tpcall(3) or tpacall(3)), initiating conversations (tpconnect(3)), beginning transactions (tpbegin(3)), and enqueuing new requests (tpenqueue(3)). Clients within a transaction are permitted to make these calls until they abort or commit the current transaction, at which time the clients become suspended. Invocations of these routines result in a TPESYSTEM error return and a system log message being generated that indicates the situation. State change is allowed only when the object is in the active(1) state. Successful return leaves the object in the suspended(2) state.

dead(3)

Abortively deactivate the tuxTclientTbl instance. State change is allowed only when the object is in the active(1) or suspended(2) state. The recommended method for deactivating clients is to first suspend them, and then to abortively deactivate them by setting the state to dead(3). Successful return leaves the object in the dead(3) state.
Note: Workstation handlers (tuxTclientWsh == yes(1)) cannot be set to a state of dead(3). The system might not be able to kill the client, due to platform or signaling restrictions. In this case, a native client is abortively terminated at its next access to ATMI, and a workstation client’s connection to a WSH is preemptively torn down.

 


tuxTclientBirthTime

Syntax

INTEGER

Access

read-only

Description

Client identifier. The data in this field should not be interpreted directly by the end user except for equality comparison.

 


tuxTclientMachineId

Syntax

INTEGER

Access

read-only

Description

Client identifier. The data in this field should not be interpreted directly by the end user except for equality comparison.

 


tuxTclientReg

Syntax

INTEGER

Access

read-only

Description

Client identifier. The data in this field should not be interpreted directly by the end user except for equality comparison.

 


tuxTclientClntName

Syntax

DisplayString (SIZE(0..30))

Access

read-only

Description

Client name associated with client at tpinit(3) time through the cltname element of the TPINIT structure.

 


tuxTclientIdleTime

Syntax

INTEGER

Access

read-only

Description

Approximate amount of time, in seconds, since this client last interacted with the system through an ATMI call. This value is accurate to within tuxTdomainScanUnit (see the tuxTdomain group) seconds. When specified as a key field, a positive value indicates that all clients with idle times of at least the indicated value match, a negative value indicates that all clients with no more than the indicated value match, and a 0 value matches all clients.

 


tuxTclientPid

Syntax

INTEGER

Access

read-only

Description

Process identifier of client. Note that for workstation clients, this identifier indicates the workstation handler through which the workstation client is connected. A negative number can be specified on a GET operation for the purpose of retrieving client information for the calling process. If the calling process is not a client, then an error is returned.

 


tuxTclientSrvGrp

Syntax

DisplayString (SIZE(0..30))

Access

read-only

Description

Server group with which the client is associated. This information is set through the grpname element of the TPINIT structure at tpinit(3) time.

 


tuxTclientUsrName

Syntax

DisplayString (SIZE(0..30))

Access

read-only

Description

User name associated with client at tpinit(3) time through the usrname element of the TPINIT structure.

 


tuxTclientWsc

Syntax

INTEGER { yes(1), no(2) }

Access

read-only

Description

If this object is set to yes(1), the indicated client is logged in to the application from a remote workstation.

 


tuxTclientWsh

Syntax

INTEGER { yes(1), no(2) }

Access

read-only

Description

Workstation handler. If this object is set to yes(1), the indicated client is a workstation handler process.

 


tuxTclientWshClientId

Syntax

DisplayString (SIZE(1..78))

Access

read-only

Description

Client identifier for the associated workstation handler (WSH) if this client is a workstation client (tuxTclientWsc == yes(1)); otherwise, the tuxTclientWshClientId value is returned as a 0-length string.

 


tuxTclientRelease

Syntax

INTEGER

Access

read-only

Description

The Tuxedo system major protocol release number for the machine where the client is running. This value can be different from the tuxTmachineSWrelease for the same machine. Note that for /WS clients (tuxTclientWsc == yes(1)), this value can be different from the major release associated with the application administered machine through which the /WS client accesses the application.

 


tuxTclientWsProto

Syntax

INTEGER

Access

read-only

Description

The Tuxedo system /WS protocol version number for a workstation client. This value is changed with each update to the /WS protocol. A value of 0 is returned for this object when it is associated with non-/WS clients (tuxTclientWsc == no(2)).

 


tuxTclientNumConv

Syntax

INTEGER

Access

read-only

Description

Number of conversations initiated by this client through tpconnect(3).

 


tuxTclientNumDeque

Syntax

INTEGER

Access

read-only

Description

Number of dequeue operations initiated by this client through tpdequeue(3).

 


tuxTclientNumEnque

Syntax

INTEGER

Access

read-only

Description

Number of enqueue operations initiated by this client through tpenqueue(3).

 


tuxTclientNumPost

Syntax

INTEGER

Access

read-only

Description

Number of postings initiated by this client through tppost(3).

 


tuxTclientNumReq

Syntax

INTEGER

Access

read-only

Description

Number of requests made by this client through tpcall(3) or tpacall(3).

 


tuxTclientNumSubscribe

Syntax

INTEGER

Access

read-only

Description

Number of subscriptions made by this client through tpsubscribe(3).

 


tuxTclientNumTran

Syntax

INTEGER

Access

read-only

Description

Number of transactions begun by this client.

 


tuxTclientNumTranAbt

Syntax

INTEGER

Access

read-only

Description

Number of transactions aborted by this client.

 


tuxTclientNumTranCmt

Syntax

INTEGER

Access

read-only

Description

Number of transactions committed by this client.

 


tuxTclientCmtRet

Syntax

INTEGER { complete(1) | logged(2) }

Access

read-only

Description

Setting of the TP_COMMIT_CONTROL characteristic for this client. See the description of the Tuxedo system ATMI function tpscmt(3) for details on this characteristic.

 


tuxTclientCurConv

Syntax

INTEGER

Access

read-only

Description

Number of conversations initiated by this client through tpconnect(3) that are still active.

 


tuxTclientCurReq

Syntax

INTEGER

Access

read-only

Description

Number of requests initiated by this client through tpcall(3) or tpacall(3) that are still active.

 


tuxTclientCurTime

Syntax

INTEGER

Access

read-only

Description

Current time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on the local host. This object can be used to compute elapsed time from the tuxTclientTimeStart object value.

 


tuxTclientLastGrp

Syntax

INTEGER

Access

read-only

Description

Server group number of the last service request made or conversation initiated from this client.

 


tuxTclientNaddr

Syntax

DisplayString (SIZE(1..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-only

Description

For workstation clients, this object indicates the network address of the client. Network addresses with unprintable characters are converted to the “0x...” network address format as described in the tuxTmachineNaddr object. Non-workstation clients have a 0-length string associated with them for the tuxTclientNaddr value.

Note: The ability of the system to provide this information is determined by the transport provider in use. In some cases, workstation clients cannot have addresses associated with them if the provider does not make this information available.

 


tuxTclientNotify

Syntax

INTEGER { dipin(1) | signal(2) | ignore(3) }

Access

read-only

Description

Setting of the notification characteristic for this client. See the tuxTdomain group description of this object for more details.

 


tuxTclientNumUnSol

Syntax

INTEGER

Access

read-only

Description

Number of unsolicited messages queued for this client that are awaiting processing.

 


tuxTclientRpid

Syntax

INTEGER

Access

read-only

Description

UNIX system message queue identifier for the client’s reply queue.

Note: This object is a UNIX-system-specific object value that might not be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTclientTimeLeft

Syntax

INTEGER

Access

read-only

Description

Time left, in seconds, for this client to receive the reply for which it is currently waiting before it times out. This timeout can be a transactional timeout or a blocking timeout.

 


tuxTclientTimeStart

Syntax

INTEGER

Access

read-only

Description

Time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on local host, since the client joined the application.

 


tuxTclientTranLev

Syntax

INTEGER

Access

read-only

Description

Current transaction level for this client. 0 indicates that the client is not currently involved in a transaction.

 


tuxTclientId

Syntax

DisplayString (SIZE(1..78))

Access

read-only

Description

Client Identifier.

 


tuxTclientContextID

Syntax

INTEGER (-2..29999)

Access

read-only

Status

mandatory

Description

Identifier for this particular application association.

 


tuxTconnTable

The tuxTconnTable group contains objects that represent run-time characteristics of active conversations within an application. Objects in this table are only accessible through a Tuxedo SNMP agent installed on the local machine. All objects in this MIB group are local objects, that is, values for these objects correspond to the local host only where the Tuxedo agent is running. Thus, the user needs to run an instance of the Tuxedo agent on every node for which these values are of interest. The index into this table is tuxTconnSerNo.

Object Name
Object ID
tuxTconnSerNo
.1.3.6.1.4.1.140.300.18.1.1.1
tuxTconnState
.1.3.6.1.4.1.140.300.18.1.1.2
tuxTconnSvcName
.1.3.6.1.4.1.140.300.18.1.1.3
tuxTconnClientId
.1.3.6.1.4.1.140.300.18.1.1.4
tuxTconnOgrpNo
.1.3.6.1.4.1.140.300.18.1.1.5
tuxTconnOlmid
.1.3.6.1.4.1.140.300.18.1.1.6
tuxTconnOpid
.1.3.6.1.4.1.140.300.18.1.1.7
tuxTconnOsndcnt
.1.3.6.1.4.1.140.300.18.1.1.8
tuxTconnOsrvId
.1.3.6.1.4.1.140.300.18.1.1.9
tuxTconnSgrpNo
.1.3.6.1.4.1.140.300.18.1.1.10
tuxTconnSlmid
.1.3.6.1.4.1.140.300.18.1.1.11
tuxTconnSpid
.1.3.6.1.4.1.140.300.18.1.1.12
tuxTconnSsndcnt
.1.3.6.1.4.1.140.300.18.1.1.13
tuxTconnSsrvId
.1.3.6.1.4.1.140.300.18.1.1.14

 


tuxTconnSerNo

Syntax

INTEGER

Access

read-only

Description

A running number as an index for tuxTconnTable.

 


tuxTconnState

Syntax

INTEGER { active(1) }

Access

read-only

Description

The values for GET and SET operations are as follows:

GET:

A GET operation retrieves run-time information for the selected tuxTconnTable instance(s). The following state indicates the meaning of a tuxTconnState returned in response to a GET request. States not listed are not returned.

active(1)

The active(1) state returned reflects one or both sides of an active conversation within the application.

SET:

SET operations are not permitted for this group.

 


tuxTconnSvcName

Syntax

DisplayString (SIZE(1..127))

Access

read-only

Description

Service name of the conversational service invoked by the originator and processed by the subordinate.

 


tuxTconnClientId

Syntax

DisplayString (SIZE(1..78))

Access

read-only

Description

Client identifier. The data in this field should not be interpreted directly by the end user except for equality comparison.

 


tuxTconnOgrpNo

Syntax

INTEGER (1..30001)

Access

read-only

Description

Server group number for the originator of the conversation. If the originator is a client, then 30,000 is returned as the value for this object.

 


tuxTconnOlmid

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Logical machine identifier that indicates where the originator is running, or (in the case of /WS clients) is accessing the application .

 


tuxTconnOpid

Syntax

INTEGER

Access

read-only

Description

Process identifier for the originator of the conversation.

 


tuxTconnOsndcnt

Syntax

INTEGER

Access

read-only

Description

Number of tpsend(3) calls made by the originator.

 


tuxTconnOsrvId

Syntax

INTEGER (1..30001)

Access

read-only

Description

Server identifier for the originator of the conversation.

 


tuxTconnSgrpNo

Syntax

INTEGER (1..30001)

Access

read-only

Description

Server group number for the subordinate of the conversation. If the originator is a client, then 30,000 is returned as the value for this object.

 


tuxTconnSlmid

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Logical machine identifier that indicates where the subordinate is running or, (in the case of /WS clients) is accessing the application.

 


tuxTconnSpid

Syntax

INTEGER

Access

read-only

Description

Process identifier for the subordinate in the conversation.

 


tuxTconnSsndcnt

Syntax

INTEGER

Access

read-only

Description

Number of tpsend(3) calls made by the subordinate.

 


tuxTconnSsrvId

Syntax

INTEGER (1..30001)

Access

read-only

Description

Server identifier for the subordinate in the conversation.

 


tuxTdevice

The tuxTdevice group contains the following object and group (table).

Object Name
Object ID
tuxTwhichCfgDev
.1.3.6.1.4.1.140.300.19.2
tuxTdeviceTbl
.1.3.6.1.4.1.140.300.19.1

 


tuxTwhichCfgDev

Syntax

DisplayString (SIZE(2..256)) (up to 64 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

The value of this object determines the device for which tuxTdeviceTbl returns configuration and run-time information.

The default value of this object is the TUXCONFIG file for the current domain.

tuxTdeviceTbl

The tuxTdeviceTbl group contains objects that represent configuration and run-time objects of raw disk slices or UNIX system files being used to store Tuxedo system device lists. This group allows for the creation and deletion of device list entries within a raw disk slice or UNIX system file. Objects in this table are only accessible through a Tuxedo SNMP agent installed on the local machine. To create a new row in this table, the user needs to send a SET request, with at least a value for tuxTdevSize. The index into this table is tuxTdevCfgDev and tuxTdevIndex.

Object Name
Object ID
tuxTdevLmid
.1.3.6.1.4.1.140.300.19.1.1.1
tuxTdevCfgDev
.1.3.6.1.4.1.140.300.19.1.1.2
tuxTdeviceName
.1.3.6.1.4.1.140.300.19.1.1.3
tuxTdevOffset
.1.3.6.1.4.1.140.300.19.1.1.4
tuxTdevSize
.1.3.6.1.4.1.140.300.19.1.1.5
tuxTdevIndex
.1.3.6.1.4.1.140.300.19.1.1.6
tuxTdevState
.1.3.6.1.4.1.140.300.19.1.1.7

 


tuxTdevLmid

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Logical machine identifier where the device is located. Note that this object can be used as a key field in both unbooted and booted applications as long as they are already configured (that is, at least one tuxTmachineTable instance exists). It is required as a key field on SET operations when they are accessing a booted application. If specified when accessing the tuxTdeviceTbl table in an unconfigured application, this object is ignored.

Note: This object can be set only during row creation.

 


tuxTdevCfgDev

Syntax

DisplayString (SIZE(2..64))

Access

read-write

Description

Absolute pathname of the file or device where the Tuxedo system filesystem is stored or is to be stored.

Note: This object can be set only during row creation.

 


tuxTdeviceName

Syntax

DisplayString (SIZE(2..64))

Access

read-write

Description

Absolute pathname of the device list entry.

Note: This object can be set only during row creation.

 


tuxTdevOffset

Syntax

INTEGER

Access

read-write

Description

The offset, in blocks, at which space on this tuxTdevice begins for use within the Tuxedo system VTOC specified by tuxTdevCfgDev.

Note: This object can be set only during row creation.

 


tuxTdevSize

Syntax

INTEGER

Access

read-write

Description

The size in pages of the disk area to be used for the device list entry.

Note: This object can be set only in conjunction with row creation.
Note: This object can be set only during row creation.

 


tuxTdevIndex

Syntax

INTEGER

Access

read-only

Description

Device index for tuxTdevice within the device list addressed by tuxTdevCfgDev. The tuxTdevIndex value is used for identification purposes only in getting and setting object values that relate to particular devices within a Tuxedo system filesystem.

 


tuxTdevState

Syntax

INTEGER { valid(1) | invalid(2) | re-init(3) }

Access

read-write

Description

The values for GET and SET operations are as follows:

GET: {valid(1)}

A GET operation retrieves run-time information for the selected tuxTdeviceTbl instance(s). The following state indicates the meaning of a tuxTdevState returned in response to a GET request. States not listed are not returned.

valid(1)

The Tuxedo system filesystem indicated by tuxTdevCfgDev exists and contains a valid device list. tuxTdevice is a valid device within that filesystem with the device index tuxTdevIndex.

SET: {invalid(2)|re-init(3)}

A SET operation updates information for the selected tuxTdeviceTbl instance or adds the indicated object. The following states indicate the meaning of a tuxTdevState set in a SET request. States not listed cannot be set.

invalid(2)

Delete tuxTdeviceTbl instance for application. State change is allowed only when the object is in the valid(1) state. Successful return leaves the object in the invalid(2) state. Note that tuxTdevIndex 0 is special and must be deleted last.

re-init(3)

Re-initializes a valid device.

 


tuxTdomain

The tuxTdomain group contains objects that represent global application characteristics for the domain to which the Tuxedo SNMP Agent is currently connected. The object values serve to identify, customize, size, secure, and tune a Tuxedo application. Many of the object values represented here serve as application defaults for other groups represented in this MIB.

There is exactly one instance of the tuxTdomain group for each application.

Object Name
Object ID
tuxTdomainKey
.1.3.6.1.4.1.140.300.3.1
tuxTdomainMaster
.1.3.6.1.4.1.140.300.3.2
tuxTdomainModel
.1.3.6.1.4.1.140.300.3.3
tuxTdomainState
.1.3.6.1.4.1.140.300.3.4
tuxTdomainID
.1.3.6.1.4.1.140.300.3.5
tuxTdomainUID
.1.3.6.1.4.1.140.300.3.7
tuxTdomainGID
.1.3.6.1.4.1.140.300.3.8
tuxTdomainPerm
.1.3.6.1.4.1.140.300.3.9
tuxTdomainMask
.1.3.6.1.4.1.140.300.3.10
tuxTdomainMaxAccessers
.1.3.6.1.4.1.140.300.3.11
tuxTdomainMaxConv
.1.3.6.1.4.1.140.300.3.12
tuxTdomainMaxGTT
.1.3.6.1.4.1.140.300.3.13
tuxTdomainMaxBufsType
.1.3.6.1.4.1.140.300.3.14
tuxTdomainMaxBufType
.1.3.6.1.4.1.140.300.3.15
tuxTdomainMaxDRT
.1.3.6.1.4.1.140.300.3.16
tuxTdomainMaxGroups
.1.3.6.1.4.1.140.300.3.17
tuxTdomainMaxMachines
.1.3.6.1.4.1.140.300.3.18
tuxTdomainMaxQueues
.1.3.6.1.4.1.140.300.3.19
tuxTdomainMaxRFT
.1.3.6.1.4.1.140.300.3.20
tuxTdomainMaxRTData
.1.3.6.1.4.1.140.300.3.21
tuxTdomainMaxServers
.1.3.6.1.4.1.140.300.3.22
tuxTdomainMaxServices
.1.3.6.1.4.1.140.300.3.23
tuxTdomainMaxACLgroups
.1.3.6.1.4.1.140.300.3.24
tuxTdomainCMTRET
.1.3.6.1.4.1.140.300.3.25
tuxTdomainLoadBalance
.1.3.6.1.4.1.140.300.3.26
tuxTdomainNotify
.1.3.6.1.4.1.140.300.3.27
tuxTdomainSystemAccess
.1.3.6.1.4.1.140.300.3.28
tuxTdomainOptions
.1.3.6.1.4.1.140.300.3.29
tuxTdomainSignal
.1.3.6.1.4.1.140.300.3.30
tuxTdomainSecurity
.1.3.6.1.4.1.140.300.3.31
tuxTdomainAuthsvc
.1.3.6.1.4.1.140.300.3.33
tuxTdomainScanUnit
.1.3.6.1.4.1.140.300.3.34
tuxTdomainBBLQuery
.1.3.6.1.4.1.140.300.3.35
tuxTdomainBlockTime
.1.3.6.1.4.1.140.300.3.36
tuxTdomainDBBLWait
.1.3.6.1.4.1.140.300.3.37
tuxTdomainSanityScan
.1.3.6.1.4.1.140.300.3.38
tuxTdomainCurDRT
.1.3.6.1.4.1.140.300.3.39
tuxTdomainCurGroups
.1.3.6.1.4.1.140.300.3.40
tuxTdomainCurMachines
.1.3.6.1.4.1.140.300.3.41
tuxTdomainCurQueues
.1.3.6.1.4.1.140.300.3.42
tuxTdomainCurRFT
.1.3.6.1.4.1.140.300.3.43
tuxTdomainCurRTdata
.1.3.6.1.4.1.140.300.3.44
tuxTdomainCurServers
.1.3.6.1.4.1.140.300.3.45
tuxTdomainCurServices
.1.3.6.1.4.1.140.300.3.46
tuxTdomainCursType
.1.3.6.1.4.1.140.300.3.47
tuxTdomainCurType
.1.3.6.1.4.1.140.300.3.48
tuxTdomainHwDRT
.1.3.6.1.4.1.140.300.3.49
tuxTdomainHwGroups
.1.3.6.1.4.1.140.300.3.50
tuxTdomainHwMachines
.1.3.6.1.4.1.140.300.3.51
tuxTdomainHwQueues
.1.3.6.1.4.1.140.300.3.52
tuxTdomainHwRFT
.1.3.6.1.4.1.140.300.3.53
tuxTdomainHwRTdata
.1.3.6.1.4.1.140.300.3.54
tuxTdomainHwServers
.1.3.6.1.4.1.140.300.3.55
tuxTdomainHwServices
.1.3.6.1.4.1.140.300.3.56
tuxTdomainMaxNetGroups
.1.3.6.1.4.1.140.300.3.58
tuxMaxObjects (Tuxedo 8.0 or later)
.1.3.6.1.4.1.140.300.3.63
tuxMaxInterfaces (Tuxedo 8.0 or later)
.1.3.6.1.4.1.140.300.3.68
tuxTdomainSignatureAhead
.1.3.6.1.4.1.140.300.3.70
tuxCurInterfaces (Tuxedo 8.0 or later)
.1.3.6.1.4.1.140.300.3.73
tuxHwInterfaces (Tuxedo 8.0 or later)
.1.3.6.1.4.1.140.300.3.78
tuxTdomainSignatureBehind
.1.3.6.1.4.1.140.300.3.80
tuxTdomainEncryptionRequired
.1.3.6.1.4.1.140.300.3.90
tuxTdomainSignatureRequired
.1.3.6.1.4.1.140.300.3.100

 


tuxTdomainKey

Syntax

INTEGER (32769..262143)

Access

read-write

Description

Numeric key for the well-known address in a Tuxedo system bulletin board. In a single processor environment, this key “names” the bulletin board. In a multiple processor or LAN environment, this key names the message queue of the DBBL. In addition, this key is used as a basis for deriving the names of resources other than the well-known address, such as the names for bulletin boards throughout the application.

 


tuxTdomainMaster

Syntax

DisplayString (SIZE (1..30))

Access

read-write

Description

DisplayString is in format: LMID1[,LMID2]

LMID1

Is the master logical machine identifier and is in the range from one to thirty characters.

LMID2

Is the backup logical machine identifier and is in the range from one to thirty characters.

The master identifier (LMID1) must correspond to the local machine for inactive applications. single-machine(1) mode applications (see tuxTdomainModel below) can set only the master logical machine identifier. Modifications to the tuxTdomainMaster value in an active multi-machine(2) application (see tuxTdomainModel below) have the following semantics.

Assuming current active master LMID A, current backup master LMID B, and secondary LMIDs C, D, ...., the following scenarios define the semantics of permitted changes to the tuxTdomainMaster object in a running multi-machine(2) mode application.

A,B -> B,A — Master migration from A to B. A,B -> A,C — Change backup master LMID designation to C.

Note that master migration can be either orderly or partitioned. Orderly migration takes place when the master machine is active and reachable. Otherwise, partitioned migration takes place. All newly established or re-established network connections verify that the two sites connecting share a common view of where the master machine is located. Otherwise, the connection is refused and an appropriate log message is generated.

The master and backup machines in an active application must always have a Tuxedo system release number greater than or equal to all other machines active in the application. The master and backup machines must be of the same release. Modifications to the tuxTdomainMaster object must preserve this relationship.

 


tuxTdomainModel

Syntax

INTEGER { single-machine(1) | multi-machine(2) }

Access

read-write

Description

The configuration type.

single-machine(1)

Specifies a single machine configuration; only one tuxTmachineTable object can be specified.

multi-machine(2)

Specifies a multi-machine or network configuration; multi-machine(2) must be specified if a networked application is being defined.

 


tuxTdomainState

Syntax

INTEGER { active(1) | inactive(2) | forcible-inactive(3) }

Access

read-write

Description

The values for GET and SET operations are as follows:

GET: {active(1)|inactive(2)}

A GET operation retrieves configuration and run-time information for the tuxTdomain group. The following states indicate the meaning of a tuxTdomainState returned in response to a GET request. States not listed are not returned.

active(1)

tuxTdomain group is defined and the master machine is active.

inactive(2)

tuxTdomain group is defined and application is inactive.

SET: active(1)|inactive(2)|forcible-inactive(3)

A SET operation updates configuration and run-time information for the tuxTdomain group. The following states indicate the meaning of a tuxTdomainState set in a SET request. States not listed cannot be set.

active(1)

Activate administrative processes (DBBL, BBL, and so on) on the master machine. A state change is allowed only when the object is in the inactive(2) state. Successful return leaves the object in the active(1) state.

inactive(2)

Deactivate administrative processes (DBBL, BBL, and so on) on the master machine. A state change is allowed only when the object is in the active(1) state. Successful return leaves the object in the inactive(2) state. To do a complete shutdown of the application, you must first make all groups inactive. (See tuxTgroupState.) This state transition fails if any application servers or clients are still attached to the domain. To ignore any running clients or application servers, set to forcible-inactive(3) as explained below.

forcible-inactive(3)

Forcibly deactivate administrative processes (DBBL, BBL, and so on) on the master machine. Attached clients are ignored for the purpose of determining if shutdown should be allowed. State change is allowed only when the object is in the active(1) state. Successful return leaves the object in the inactive(2) state. You need to restart any clients before they can be used to process services after this state transition.

 


tuxTdomainID

Syntax

DisplayString (SIZE (0..30))

Access

read-write

Description

Domain identification string.

 


tuxTdomainUID

Syntax

INTEGER

Access

read-write

Description

Default value for newly configured objects in the tuxTmachineTable group.

Note: Changes to this object do not affect active or already configured tuxTmachineTable instances.

 


tuxTdomainGID

Syntax

INTEGER

Access

read-write

Description

Default value for newly configured objects in the tuxTmachineTable group.

Note: Changes to this object do not affect active or already configured tuxTmachineTable instances.

 


tuxTdomainPerm

Syntax

DisplayString (SIZE(1..9))

Access

read-write

Description

Default value for newly configured objects in the tuxTmachineTable group.

Note: Changes to this object do not affect active or already configured tuxTmachineTable instances.

 


tuxTdomainMask

Syntax

DisplayString (SIZE(1..9))

Access

read-write

Description

Attribute access mask. User type/access mode combinations specified by tuxTdomainMask are no longer allowed for all group/object combinations defined in TM_MIB(5). For example, a setting of 0003 disallows all updates to users other than the administrator or the operator. The value of this object should be provided as an octal number — 0 through 0777.

 


tuxTdomainMaxAccessers

Syntax

INTEGER (1..32767)

Access

read-write

Description

Default value for newly configured objects in the tuxTmachineTable group.

Note: Changes to this object do not affect active or already configured tuxTmachineTable instances.

 


tuxTdomainMaxConv

Syntax

INTEGER (0..32767)

Access

read-write

Description

Default value for newly configured objects in the tuxTmachineTable group.

Note: Changes to this object do not affect active or already configured tuxTmachineTable instances.

 


tuxTdomainMaxGTT

Syntax

INTEGER (0..32767)

Access

read-write

Description

Default value for newly configured objects in the tuxTmachineTable group.

Note: Changes to this object do not affect active or already configured tuxTmachineTable instances.

 


tuxTdomainMaxBufsType

Syntax

INTEGER (1..32767)

Access

read-write

Description

Maximum number of buffer subtypes that can be accommodated in the bulletin board buffer subtype table.

 


tuxTdomainMaxBufType

Syntax

INTEGER (1..32767)

Access

read-write

Description

Maximum number of buffer types that can be accommodated in the bulletin board buffer type table.

 


tuxTdomainMaxDRT

Syntax

INTEGER (0..32767)

Access

read-write

Description

Maximum number of routing table entries that can be accommodated in the bulletin board routing table. One entry per tuxTroutingTable group object is required. Additional entries should be allocated to allow for run-time growth.

 


tuxTdomainMaxGroups

Syntax

INTEGER (100..32767)

Access

read-write

Description

Maximum number of server groups that can be accommodated in the bulletin board server group table.

 


tuxTdomainMaxMachines

Syntax

INTEGER (256..8190)

Access

read-write

Description

Maximum number of machines that can be accommodated in the bulletin board machine table.

 


tuxTdomainMaxQueues

Syntax

INTEGER (1..8191)

Access

read-write

Description

Maximum number of queues to be accommodated in the bulletin board queue table.

 


tuxTdomainMaxRFT

Syntax

INTEGER (0..32767)

Access

read-write

Description

Maximum number of routing criteria range table entries to be accommodated in the bulletin board range criteria table. One entry per individual range within a tuxTroutingRanges specification is required plus one additional entry per tuxTroutingTable group object. Additional entries should be allocated to allow for run-time growth.

 


tuxTdomainMaxRTData

Syntax

INTEGER (0..32760)

Access

read-write

Description

Maximum string pool space to be accommodated in the bulletin board string pool table. Strings and carrays specified within tuxTroutingRanges values are stored in the string pool. Additional space should be allocated to allow for run-time growth.

 


tuxTdomainMaxServers

Syntax

INTEGER (1..8191)

Access

read-write

Description

Maximum number of servers to be accommodated in the bulletin board server table. Allowances should be made in setting this object for system supplied administrative servers. Administration of each Tuxedo system site adds approximately one server. Additionally, if TMSs are specified for any server groups (see tuxTgroupTMSname), they are booted along with their server group and should be accounted for in setting tuxTdomainMaxServers.

 


tuxTdomainMaxServices

Syntax

INTEGER (1..32767)

Access

read-write

Description

Maximum number of services to be accommodated in the bulletin board service table. Allowances should be made in setting this object for system supplied servers that offer services for administrative purposes. Administration of each Tuxedo system site adds approximately five services. Other administrative components such as /WS, /Q, and /DM can also add administrative services that should be accounted for.

 


tuxTdomainMaxACLgroups

Syntax

INTEGER (1..16384)

Access

read-write

Description

Maximum number of group identifiers that can be used for checking ACL permissions. The maximum group identifier that can be defined is tuxTdomainMaxACLgroups - 1.

 


tuxTdomainCMTRET

Syntax

INTEGER { complete(1) | logged(2) }

Access

read-write

Description

Initial setting of the TP_COMMIT_CONTROL characteristic for all client and server processes in a Tuxedo application. logged(2) initializes the TP_COMMIT_CONTROL characteristic to TP_CMT_LOGGED; otherwise, it is initialized to TP_CMT_COMPLETE. See the description of the Tuxedo system ATMI function tpscmt(3) for details on the setting of this characteristic.

Note: Run-time modifications to this object do not affect active clients and servers.

 


tuxTdomainLoadBalance

Syntax

INTEGER { yes(1) | no(2) }

Access

read-write

Description

yes(1)

Load balancing is on.

no(2)

Load balancing is off.
Note: Run-time modifications to this object do not affect active clients and servers.

 


tuxTdomainNotify

Syntax

INTEGER { dipin(1) | signal(2) | ignore(3) }

Access

read-write

Description

Default notification detection method used by the system for unsolicited messages sent to client processes. This default value can be overridden on a per-client basis using the appropriate tpinit(3) flag value. Note that once unsolicited messages are detected, they are made available to the application through the application defined unsolicited message handling routine identified through the tpsetunsol(3) function.

dipin(1)

The value dipin(1) specifies that dip-in-based notification detection should be used, which means that the system only detects notification messages on behalf of a client process while within ATMI calls. The point of detection within any particular ATMI call is not defined by the system, and dip-in detection does not interrupt blocking system calls. dipin(1) is the default notification detection method.

signal(2)

The value signal(2) specifies that signal-based notification detection should be used, which means that the system sends a signal to the target client process after the notification message has been made available. The system installs a signal catching routine on behalf of clients that select this method of notification.

ignore(3)

The value ignore(3) specifies that by default, notification messages are to be ignored by application clients, which would be appropriate in applications where only clients that request notification at tpinit(3) time should receive unsolicited messages.
Note: Run-time modifications to this object do not affect active clients. All signaling of client processes is done by administrative system processes and not by application processes. Therefore, only clients running with the same UNIX system user identifier can be notified by use of the signal(2) method.

 


tuxTdomainSystemAccess

Syntax

INTEGER { fastpath(1) | protected(2) | fastpath-no-override(3) | protected-no-override(4) }

Access

read-write

Description

Default mode used by Tuxedo system libraries within application processes to gain access to Tuxedo system’s internal tables.

fastpath(1)

Specifies that Tuxedo system’s internal tables are accessible by Tuxedo system libraries via unprotected shared memory for fast access.

protected(2)

Specifies that Tuxedo system’s internal tables are accessible by Tuxedo libraries through protected shared memory for safety against corruption by application code.

fastpath-no-override(3) or protected-no-override(4)

These values can be specified to indicate that the mode selected cannot be overridden by an application process that uses flags available for use with tpinit(3).
Note: Updates to the tuxTdomainSystemAccess value in a running application affect only newly started clients and newly configured tuxTsrvrTbl objects.

 


tuxTdomainOptions

Syntax

INTEGER { lan(1) | migrate(2) | accstats(3) | lan-migrate(4) | lan-accstats(5) | migrate-accstats(6) | lan-migrate-accstats(7) | none(8) }

Access

read-write

Description

Comma separated list of application options in effect. Valid options are defined as follows:

lan(1)

Networked application.

migrate(2)

Allow server group migration.

accstats(3)

Exact statistics (single-machine(1) mode only).
Note: Only the accstats(3) can be set or reset in an active application.

 


tuxTdomainSignal

Syntax

INTEGER { sigusr1(1) | sigusr2(2) }

Access

read-write

Description

Signal to be used for signal-based notification (see tuxTdomainNotify above).

 


tuxTdomainSecurity

Syntax

INTEGER DisplayString

Access

read-write

Description

Type of application security. The format is:

security_mode[/app_password]

where security_mode can have the following values:

NONE
APP_PW
USER_AUTH
ACL
MANDATORY_ACL

NONE

A string value of NONE for this object indicates that security is/will be turned off.

APP_PW

The value APP_PW/app_password indicates that application password security is enforced. Clients must provide the application password during initialization.

USER_AUTH

The value USER_AUTH is similar to APP_PW, but indicates also that per-user authentication is done during client initialization.

ACL

The value ACL is similar to USER_AUTH, but also indicates that access control checks are done on service names, queue names, and event names. If an associated ACL is not found for a name, it is assumed that permission is granted

MANDATORY_ACL

The value MANDATORY_ACL is similar to ACL, but permission is denied if an associated ACL is not found for the name.

app_password

This value is needed whenever security_mode is being set to anything but NONE. To change the value of app_password, SET this object to:
current_security_mode/new_password On a GET operation, this object only returns the security mode; the password is not returned.

 


tuxTdomainAuthsvc

Syntax

DisplayString (SIZE (1..127))

Access

read-write

Description

Application authentication service invoked by the system for each client that joins the system. The tuxTdomainAuthsvc value is ignored if the tuxTdomainSecurity object is set to NONE or to APP-PW.

 


tuxTdomainScanUnit

Syntax

INTEGER (0..60)

Access

read-write

Description

Interval of time (in seconds) between periodic scans by the system. Periodic scans are used to detect old transactions and timed-out blocking calls within service requests. The tuxTdomainBBLQuery, tuxTdomainBlockTime, tuxTdomainDBBLWait, and tuxTdomainSanityScan objects are multipliers of this value. Passing a value of 0 for this object on a SET operation causes the object to be reset to its default value.

 


tuxTdomainBBLQuery

Syntax

INTEGER (0..32767)

Access

read-write

Description

Multiplier of the tuxTdomainScanUnit object that indicates time between DBBL status checks on registered BBLs. The DBBL checks to ensure that all BBLs have reported within the tuxTdomainBBLQuery cycle. If a BBL has not been heard from, the DBBL sends a message to that BBL asking for status. If no reply is received, the BBL is partitioned. Passing a value of 0 for this object on a SET operation causes the object to be reset to its default value. The tuxTdomainBBLQuery value should be set to at least twice the value set for tuxTdomainSanityScan.

 


tuxTdomainBlockTime

Syntax

INTEGER (0..32767)

Access

read-write

Description

Multiplier of the tuxTdomainScanUnit object that indicates the minimum amount of time a blocking ATMI call blocks before timing out. Passing a value of 0 for this object on a SET operation causes the object to be reset to its default value.

 


tuxTdomainDBBLWait

Syntax

INTEGER (0..32767)

Access

read-write

Description

Multiplier of the tuxTdomainScanUnit object that indicates the maximum amount of time a DBBL should wait for replies from its BBLs before timing out. Passing a value of 0 for this object on a SET operation causes the object to be reset to its default value.

 


tuxTdomainSanityScan

Syntax

INTEGER (0..32767)

Access

read-write

Description

Multiplier of the tuxTdomainScanUnit object that indicates the time interval between basic sanity checks of the system. Sanity checking includes client/server viability checks done by each BBL for clients/servers running on the local machine as well as BBL status check-ins (multi-machine(2) mode only). Passing a value of 0 for this object on a SET operation causes the object to be reset to its default value.

 


tuxTdomainCurDRT

Syntax

INTEGER (0..32767)

Access

read-only

Description

Current number of bulletin board routing table entries in use.

 


tuxTdomainCurGroups

Syntax

INTEGER (0..32767)

Access

read-only

Description

Current number of bulletin board server group table entries that are in use.

 


tuxTdomainCurMachines

Syntax

INTEGER (0..32767)

Access

read-only

Description

Current number of configured machines.

 


tuxTdomainCurQueues

Syntax

INTEGER (0..32767)

Access

read-only

Description

Current number of bulletin board queue table entries that are in use.

 


tuxTdomainCurRFT

Syntax

INTEGER (0..32767)

Access

read-only

Description

Current number of bulletin board routing criteria range table entries that are in use.

 


tuxTdomainCurRTdata

Syntax

INTEGER (0..32767)

Access

read-only

Description

Current size of routing table string pool.

 


tuxTdomainCurServers

Syntax

INTEGER (0..32767)

Access

read-only

Description

Current number of bulletin board server table entries that are in use.

 


tuxTdomainCurServices

Syntax

INTEGER (0..32767)

Access

read-only

Description

Current number of bulletin board service table entries that are in use.

 


tuxTdomainCursType

Syntax

INTEGER (0..32767)

Access

read-only

Description

Current number of bulletin board subtype table entries that are in use.

 


tuxTdomainCurType

Syntax

INTEGER (0..32767)

Access

read-only

Description

Current number of bulletin board type table entries that are in use.

 


tuxTdomainHwDRT

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of bulletin board routing table entries that are in use.

 


tuxTdomainHwGroups

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of bulletin board server group table entries that are in use.

 


tuxTdomainHwMachines

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of configured machines.

 


tuxTdomainHwQueues

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of bulletin board queue table entries that are in use.

 


tuxTdomainHwRFT

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of bulletin board routing criteria range table entries that are in use.

 


tuxTdomainHwRTdata

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water size of routing table string pool.

 


tuxTdomainHwServers

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of bulletin board server table entries that are in use.

 


tuxTdomainHwServices

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of bulletin board service table entries that are in use.

 


tuxTdomainMaxNetGroups

Syntax

INTEGER (1..8191)

Access

read-write

Description

The maximum number of groups that can be configured.

 


tuxMaxObjects (Tuxedo 8.0 or later)

Syntax

INTEGER

Access

read-write

Description

The default maximum number of active CORBA objects that can be accommodated in the Active Object Map tables in the Tuxedo bulletin board.

 


tuxMaxInterfaces (Tuxedo 8.0 or later)

Syntax

INTEGER (1..32765)

Access

read-write

Description

Specifies the maximum number of interfaces that can be accommodated in the interface table of the bulletin board. If not specified, the default is 100.

All instances of an interface occupy and re-use the same slot in the interface table in the bulletin board. For example, if server SVR1 advertises interfaces IF1 and IF2, SVR2 advertises IF2 and IF3, and SVR3 advertises IF3 and IF4, the interface count is 4, not 6, when calculating tuxMaxInterfaces.

 


tuxTdomainSignatureAhead

Syntax

INTEGER (1..2147483647)

Access

read-write

Description

Number of seconds a valid signature’s timestamp can be ahead of the local machine’s clock.

 


tuxCurInterfaces (Tuxedo 8.0 or later)

Syntax

INTEGER

Access

read-only

Description

The current number of interface entries used in the bulletin board interface tables.

 


tuxHwInterfaces (Tuxedo 8.0 or later)

Syntax

INTEGER

Access

read-only

Description

The high water mark for the number of interface entries used in the bulletin board interface tables.

 


tuxTdomainSignatureBehind

Syntax

INTEGER (1..2147483647)

Access

read-write

Description

Number of seconds a valid signature’s timestamp can be behind the local machine’s clock.

 


tuxTdomainEncryptionRequired

Syntax

INTEGER {yes(1) | no(2)}

Access

read-write

Description

If set to “yes,” every application service in this domain requires an encrypted input message buffer.

 


tuxTdomainSignatureRequired

Syntax

INTEGER {yes(1) | no(2)}

Access

read-write

Description

If set to “yes,” every application service in this domain requires a valid digital signature on its input message buffer.

 


tuxTgroupTable

The tuxTgroupTable group contains objects that represent application characteristics pertaining to a particular server group. The object values represent group identification, location, and DTP information.

The index for this table is tuxTgroupNo. To create a new row, it is necessary to issue a SET request for a non-existing instance that at least specifies values for tuxTgroupName and tuxTgroupLMID.

 


tuxTgroupName

Syntax

DisplayString (SIZE (1..30))

Access

read-write

Description

Logical name of the server group. The group name must be unique within all group names in the tuxTgroupTable group and tuxTgroupLMID values in the tuxTmachineTable group. Server group names cannot contain an asterisk (*), comma, or colon.

Note: This object can be set only during row creation.

 


tuxTgroupNo

Syntax

INTEGER (1..29999)

Access

read-write

Description

Group number associated with this server group.

Note: This object can be set only during row creation.

 


tuxTgroupLMID

Syntax

DisplayString (SIZE (1..61))

Access

read-write

Description

DisplayString is in the format: LMID1[,LMID2]

LMID1

Is the primary machine logical machine identifier for this server group and is in the range from one to sixty-one characters.

LMID2

Is the optional secondary logical machine identifier and is in the range from one to sixty-one characters.

The secondary LMID indicates the machine to which the server group can be migrated (if the MIGRATE option is specified in the tuxTdomainOptions object). A single LMID specified on a GET operation matches either the primary or secondary LMID. Note that the location of an active group is available in the tuxTgroupCurLMID object. Logical machine identifiers specified with the tuxTgroupLMID object must already be configured.

Note: Modifications to this object for an active object can only change the backup LMID designation for the group.

 


tuxTgroupState

Syntax

INTEGER { active(1) | inactive(2) | migrating(3) | invalid(4) | 
re-active(5) | suspend-services(6) | resume-services(7)}

Access

read-write

Description

The values for GET and SET operations are as follows:

GET: {active(1)|inactive(2)|migrating(3)}

A GET operation retrieves configuration and run-time information for the selected tuxTgroupTable object(s). The following states indicate the meaning of a tuxTgroupState returned in response to a GET request. States not listed are not returned.

active(1)

tuxTgroupTable object defined and active (TMS and/or application servers). Server groups with non-0 length values for the tuxTgroupTMSname object are considered active if the TMSs associated with the group are active. Otherwise, a group is considered active if any server in the group is active.

inactive(2)

tuxTgroupTable object defined and inactive.

migrating(3)

tuxTgroupTable object defined and currently in a state of migration to the secondary logical machine. The secondary logical machine is the one listed in tuxTgroupLMID that does not match tuxTgroupCurLMID.

SET: {active(1)|inactive(2)|migrating(3)|invalid(4)|re-active(5) |suspend-services(6)|resume-services(7)}

A SET operation updates configuration and run-time information for the selected tuxTgroupTable object. The following states indicate the meaning of a tuxTgroupState set in a SET request. States not listed cannot be set.

active(1)

Activate the tuxTgroupTable object. State change is allowed only when the group is in the inactive(2) or migrating(3) state. If the group is currently in the inactive(2) state and the primary logical machine is active, then TMS and application servers are started on the primary logical machine; otherwise, if the secondary logical machine is active, the TMS and application servers are started on the secondary logical machine. If neither machine is active, then the request fails. If the group is currently in the migrating(3) state, then the active secondary logical machine (identified as the alternate to tuxTgroupCurLMID in the tuxTgroupLMID list), if it is active, is used to start TMS and application servers. Otherwise, the request fails. Successful return leaves the object in the active(1) state.

inactive(2)

Deactivate the tuxTgroupTable instance. TMS and application servers are deactivated. State change is allowed only when the group is in the active(1) or migrating(3) state. Successful return leaves the object in the inactive(2) state.

migrating(3)

Deactivate the tuxTgroupTable object on its active primary logical machine (tuxTgroupCurLMID) and prepare the group to be migrated to the secondary logical machine. State change is allowed only when the group is in the active(1) state. Successful return leaves the object in the migrating(3) state.

invalid(4)

Delete tuxTgroupTable object for application. State change is allowed only when the group is in the inactive(2) state. Successful return leaves the object in the invalid(4) state.

re-active(5)

Identical to a transition to the active(1) state except that this state change is also allowed in the active(1) state as well as the inactive(2) and migrating(3) states.

suspend-services(6)

Suspend the application services in the group. A SET operation to this state is allowed only when the group is in the active(1) state. The operation leaves the group in active(1) state but with all its application services in a suspended state.

resume-services(7)

Unsuspend and resume all application services that are marked suspended in the group. This operation is allowed only when the group is in the active(1) state. The operation leaves the group in the active(1) state.

 


tuxTgroupCurLMID

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Current logical machine on which the server group is running. The tuxTgroupCurLMID value is not returned for server groups that are not active.

 


tuxTgroupCloseInfo

Syntax

DisplayString (SIZE(0..256))

Access

read-write

Description

If a non-0 length value other than TMS is specified for the tuxTgroupTMSname object, then the tuxTgroupCloseInfo value indicates the resource manager-dependent information needed to terminate access to the resource manager. Otherwise, this object value is ignored.

The format for the tuxTgroupCloseInfo value is dependent on the requirements of the vendor providing the underlying resource manager. The information required by the vendor must be prefixed with rm_name:, which is the published name of the vendor’s transaction (XA) interface followed immediately by a colon (:).

A 0-length string value for this object means that the resource manager for this group (if specified) does not require any application-specific information to close access to the resource.

Note: Run-time modifications to this object do not affect active servers in the group.

 


tuxTgroupOpenInfo

Syntax

DisplayString (SIZE(0..256))

Access

read-write

Description

If a non-0 length value other than TMS is specified for the tuxTgroupTMSname object, the tuxTgroupOpenInfo value indicates the resource manager-dependent information needed to initiate access to the resource manager. Otherwise, this object value is ignored.

The format for the tuxTgroupOpenInfo value is dependent on the requirements of the vendor that provides the underlying resource manager. The information required by the vendor must be prefixed with rm_name:, which is the published name of the vendor’s transaction (XA) interface followed immediately by a colon (:).

A 0-length string value for tuxTgroupOpenInfo means that the resource manager for this group (if specified) does not require any application-specific information to open access to the resource.

Note: Run-time modifications to this object do not affect active servers in the group.

 


tuxTgroupTMScount

Syntax

INTEGER (0..11)

Access

read-write

Description

If a non-0 length value is specified for the tuxTgroupTMSname object, the tuxTgroupTMScount value indicates the number of transaction manager servers to start for the associated group. Otherwise, this object value is ignored.

 


tuxTgroupTMSname

Syntax

DisplayString (SIZE(0..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

Transaction manager server a.out associated with this group. This parameter must be specified for any group entry whose servers participate in distributed transactions (transactions across multiple resource managers and possibly machines that are started with tpbegin(3) and ended with tpcommit(3) or tpabort(3)).

The value TMS is reserved to indicate use of the null XA interface. If a non-empty value other than TMS is specified, a tuxTmachineTlogDevice must be specified for the machine(s) associated with the primary and secondary logical machines for this object

A unique server identifier is selected automatically for each TM server, and the servers are restartable an unlimited number of times.

 


tuxTgroupEncryptionRequired

Syntax

INTEGER { yes(1) | no(2)}

Access

read-write

Description

If set to “yes,” every application service in this group requires an encrypted message buffer.

 


tuxTgroupSignatureRequired

Syntax

INTEGER { yes(1) | no(2)}

Access

read-write

Description

If set to “yes,” every application service in this group requires a valid digital signature on its input message buffer.

 


tuxTmachineTable

The tuxTmachineTable group contains objects that represent application characteristics pertaining to a particular machine. The object values represent machine characteristics, per-machine sizing, statistics, customization options, and UNIX system filenames. This group is available for configured-inactive as well as configured-active machines in the application.

The index into this table is tuxTmachinePmid. To create a new row, issue a SET request for a non-existing row that specifies at least the values for tuxTmachineLmid, tuxTmachineTuxDir, tuxTmachineTuxConfig, and tuxTmachineAppDir. For a multi-machine Tuxedo application, tuxTmachineNaddr, tuxTmachineNlsAddr, and tuxTmachineBridge must also be specified.

Object Name
Object ID
tuxTmachinePmid
.1.3.6.1.4.1.140.300.5.1.1.1
tuxTmachineLmid
.1.3.6.1.4.1.140.300.5.1.1.2
tuxTmachineTuxConfig
.1.3.6.1.4.1.140.300.5.1.1.3
tuxTmachineTuxDir
.1.3.6.1.4.1.140.300.5.1.1.4
tuxTmachineAppDir
.1.3.6.1.4.1.140.300.5.1.1.5
tuxTmachineState
.1.3.6.1.4.1.140.300.5.1.1.6
tuxTmachineUid
.1.3.6.1.4.1.140.300.5.1.1.7
tuxTmachineGid
.1.3.6.1.4.1.140.300.5.1.1.8
tuxTmachineEnvFile
.1.3.6.1.4.1.140.300.5.1.1.9
tuxTmachinePerm
.1.3.6.1.4.1.140.300.5.1.1.10
tuxTmachineUlogPfx
.1.3.6.1.4.1.140.300.5.1.1.11
tuxTmachineType
.1.3.6.1.4.1.140.300.5.1.1.12
tuxTmachineMaxAccessers
.1.3.6.1.4.1.140.300.5.1.1.13
tuxTmachineMaxConv
.1.3.6.1.4.1.140.300.5.1.1.14
tuxTmachineMaxGtt
.1.3.6.1.4.1.140.300.5.1.1.15
tuxTmachineMaxWsClients
.1.3.6.1.4.1.140.300.5.1.1.16
tuxTmachineMaxAclCache
.1.3.6.1.4.1.140.300.5.1.1.17
tuxTmachineTlogDevice
.1.3.6.1.4.1.140.300.5.1.1.18
tuxTmachineTlogName
.1.3.6.1.4.1.140.300.5.1.1.19
tuxTmachineTlogSize
.1.3.6.1.4.1.140.300.5.1.1.20
tuxTmachineBridge
.1.3.6.1.4.1.140.300.5.1.1.21
tuxTmachineNaddr
.1.3.6.1.4.1.140.300.5.1.1.22
tuxTmachineNlsaddr
.1.3.6.1.4.1.140.300.5.1.1.23
tuxTmachineCmpLimit
.1.3.6.1.4.1.140.300.5.1.1.24
tuxTmachineTmNetLoad
.1.3.6.1.4.1.140.300.5.1.1.25
tuxTmachineSpinCount
.1.3.6.1.4.1.140.300.5.1.1.26
tuxTmachineRole
.1.3.6.1.4.1.140.300.5.1.1.27
tuxTmachineMinor
.1.3.6.1.4.1.140.300.5.1.1.28
tuxTmachineRelease
.1.3.6.1.4.1.140.300.5.1.1.29
tuxTmachineMaxPendingBytes
.1.3.6.1.4.1.140.300.5.1.1.30
tuxMaxMachineObjects (Tuxedo 8.0 or later)
.1.3.6.1.4.1.140.300.5.1.1.35
tuxTmachineEncryptionRequired
.1.3.6.1.4.1.140.300.5.1.1.50
tuxTmachineSignatureRequired
.1.3.6.1.4.1.140.300.5.1.1.60

 


tuxTmachinePmid

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Physical machine identifier. This identifier should match the UNIX system nodename returned by the uname -n command when run on the identified system. For a Windows NT system, this identifier should match the computer name and the name configured with the name server.

Note: This object can be set only during row creation.

 


tuxTmachineLmid

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Logical machine identifier.

Note: This object can be set only during row creation.

 


tuxTmachineTuxConfig

Syntax

DisplayString (SIZE (2..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

Absolute pathname of the file or device where the binary Tuxedo system configuration file is found on this machine. The administrator need only maintain one such file, namely the one identified by the tuxTmachineTuxConfig value on the master machine. The information contained in this file is automatically propagated to all other tuxTmachineTable objects as they are activated. See tuxTmachineEnvFile for a discussion of how the tuxTmachineTuxConfig value is used in the environment.

 


tuxTmachineTuxDir

Syntax

DisplayString (SIZE(2..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

Absolute pathname of the directory where the Tuxedo system software is found on this machine. See tuxTmachineEnvFile that follows for a discussion about how the tuxTmachineTuxDir value is used in the environment.

 


tuxTmachineAppDir

Syntax

DisplayString (SIZE (2..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

Colon-separated list of application directory absolute pathnames. The first directory serves as the current directory for all application and administrative servers booted on this machine. All directories in the list are searched when application servers are started. See tuxTmachineEnvFile for a discussion of how the tuxTmachineAppDir value is used in the environment.

 


tuxTmachineState

Syntax

INTEGER { active(1) | inactive(2) | partitioned(3) | invalid(4) | 
re-activate(5) | cleaning(7) }

Access

read-write

Description

The values for GET and SET operations are as follows:

GET: {active(1)|inactive(2)|partitioned(3)}

A GET operation retrieves configuration and run-time information for the selected tuxTmachineTable instance(s). The following states indicate the meaning of a tuxTmachineState returned in response to a GET request. States not listed are not returned

active(1)

tuxTmachineTable instance defined and active (administrative servers, that is, DBBL, BBL, and BRIDGE).

inactive(2)

tuxTmachineTable instance defined and inactive.

partitioned(3)

tuxTmachineTable instance defined, listed in accessible bulletin boards as active, but currently unreachable.

SET: {active(1)|inactive(2)|invalid(4)|re-activate(5)|cleaning(7)}

A SET operation updates configuration and run-time information for the selected tuxTmachineTable instance. The following states indicate the meaning of a tuxTmachineState set in a SET request. States not listed can not be set.

active(1)

Activate the tuxTmachineTable instance. Necessary administrative servers such as the DBBL, BBL, and BRIDGE are started on the indicated site as well as application servers configured to run on that site. State change is allowed only when the machine is in the inactive(2) state. Successful return leaves the object in the active(1) state.

inactive(2)

Deactivate the tuxTmachineTable instance. Necessary administrative servers such as the BBL and BRIDGE are stopped on the indicated site as well as application servers running on that site. State change allowed only when the machine is in the active(1) state and when no other application resources are active on the indicated machine. Successful return leaves the object in the inactive(2) state.

invalid(4)

Delete tuxTmachineTable instance for application. State change is allowed only when the machine is in the inactive(2) state. Successful return leaves the object in the invalid(4) state.

re-activate(5)

Activate the tuxTmachineTable instance. Necessary administrative servers such as the DBBL, BBL, and BRIDGE are started on the indicated site. State change is allowed only when the machine is in either the active(1) or inactive(2) state. Successful return leaves the object in the active(1) state.

cleaning(7)

Initiate cleanup/scanning activities on and relating to the indicated machine. If there are dead clients or servers on the machine, they are detected at this time. If the machine has been partitioned from the application master site, then global bulletin board entries for that machine are removed. This combination is allowed when the application is in the active(1) state and the tuxTmachineTable instance is in either the active(1) or partitioned(3) state. Successful return for a non-partitioned machine leaves the state unchanged. Successful return for a partitioned machine leaves the object in the inactive(2) state.
Note: State change to inactive(2) is allowed only for non-master machines. The master site administrative processes are deactivated through the tuxTdomain group.

 


tuxTmachineUid

Syntax

INTEGER

Access

read-write

Description

UNIX system user-identifier for the Tuxedo application administrator on this machine. Administrative commands such as tmboot(1), tmshutdown(1), and tmadmin(1) must run as the indicated user on this machine. Application and administrative servers on this machine are started as this user.

Note: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTmachineGid

Syntax

INTEGER

Access

read-write

Description

UNIX system group identifier for the Tuxedo application administrator on this machine. Administrative commands such as tmboot(1), tmshutdown(1), and tmadmin(1) must run as part of the indicated group on this machine. Application and administrative servers on this machine are started as part of this group.

Note: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTmachineEnvFile

Syntax

DisplayString (SIZE(2..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

Environment file for clients and servers running on this machine.

 


tuxTmachinePerm

Syntax

DisplayString (SIZE(1..9))

Access

read-write

Description

UNIX system permissions associated with the shared memory bulletin board created on this machine. Default UNIX system permissions for system and application message queues.

Note: Modifications to this object for an active object do not affect running servers or clients.
Note: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTmachineUlogPfx

Syntax

DisplayString (SIZE(0..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

Absolute pathname prefix of the path for the userlog(3) file on this machine. The userlog(3) file name is formed by appending the string .mmddyy to the tuxTmachineUlogPfx object value .mmddyy represents the month, day, and year that the messages were generated. All application and system userlog(3) messages generated by clients and servers running on this machine are directed to this file.

Note: Modifications to this object for an active object do not affect running servers or clients.

 


tuxTmachineType

Syntax

DisplayString (SIZE(1..15))

Access

read-write

Description

Machine type. The tuxTmachineType value is used to group machines into groups of like data representations. Data encoding is not performed when communicating between machines of identical types. This object can be given any string value; values are used only for comparison. Distinct tuxTmachineType objects should be set when the application spans a heterogeneous network of machines or when compilers generate dissimilar structure representations. The default value for tuxTmachineType, a 0-length string, matches any other machine having a 0-length string as its tuxTmachineType object value.

 


tuxTmachineMaxAccessers

Syntax

INTEGER (1..32767)

Access

read-write

Description

Maximum number of clients and servers that can have access to the bulletin board on this machine at one time. System administration processes such as the BBL and tmadmin need not be accounted for in this figure, but all application servers and clients and TMS servers should be counted. If the application is booting workstation listeners on this site, then both the listeners and the potential number of workstation handlers that can be booted should be counted.

 


tuxTmachineMaxConv

Syntax

INTEGER (0..32767)

Access

read-write

Description

Maximum number of simultaneous conversations in which clients and servers on this machine can be involved.

 


tuxTmachineMaxGtt

Syntax

INTEGER (0..32767)

Access

read-write

Description

Maximum number of simultaneous global transactions in which this machine can be involved.

 


tuxTmachineMaxWsClients

Syntax

INTEGER (0..32767)

Access

read-write

Description

Number of entries for accessers on this machine to be reserved for workstation clients. The number specified here takes a portion of the total slots for accessers specified with the tuxTmachineMaxAccessers object. The appropriate setting of this parameter helps to conserve IPC resources because workstation client access to the system is multiplexed through a Tuxedo system supplied surrogate, the workstation handler. It is an error to set this number greater than tuxTmachineMaxAccessers.

 


tuxTmachineMaxAclCache

Syntax

INTEGER (10..32000)

Access

read-write

Description

Number of entries in the cache used for ACL entries when tuxTdomainSecurity is set to acl(4) or mandatory-acl(5). The appropriate setting of this parameter helps to conserve shared memory resources and yet reduce the number of disk access to do ACL checking.

 


tuxTmachineTlogDevice

Syntax

DisplayString (SIZE (0..256)) (up to 64 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

The device (raw slice) or UNIX system file containing the Tuxedo system filesystem that holds the DTP transaction log for this machine. The DTP transaction log is stored as a Tuxedo system VTOC table on the device. This device or file can be the same as that specified for the tuxTmachineTuxConfig object for this machine.

 


tuxTmachineTlogName

Syntax

DisplayString (SIZE (0..30))

Access

read-write

Description

The name of the DTP transaction log for this machine. If more than one DTP transaction log exists on the same tuxTmachineTlogDevice, they must have unique names. tuxTmachineTlogName must be different from the name of any other table on the tuxTmachineTlogDevice where the DTP transaction log table is created.

 


tuxTmachineTlogSize

Syntax

INTEGER (1..2048)

Access

read-write

Description

The numeric size, in pages, of the DTP transaction log for this machine. The tuxTmachineTlogSize object value is subject to limits based on available space in the Tuxedo system filesystem identified by the tuxTmachineTlogDevice object.

 


tuxTmachineBridge

Syntax

DisplayString (SIZE (0..78))

Access

read-write

Description

Device name to be used by the BRIDGE process placed on this logical machine to access the network. The tuxTmachineBridge value is a required value for participation in a networked application through a TLI-based Tuxedo system binary. This object value is not needed for sockets-based Tuxedo system binaries.

 


tuxTmachineNaddr

Syntax

DisplayString (SIZE (0..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

Specifies the complete network address to be used by the BRIDGE process placed on the logical machine as its listening address. The listening address for a BRIDGE is the means by which it is contacted by other BRIDGE processes participating in the application. This object must be set if the logical machine is to participate in a networked application, that is, if the LAN option is set in the tuxTdomainOptions object value.

If DisplayString has the form 0xhex-digits or \\xhex-digits, it must contain an even number of valid hexadecimal digits. These forms are translated internally into a character array that contains the hexadecimal representations of the specified string.

 


tuxTmachineNlsaddr

Syntax

DisplayString (SIZE(0..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

Network address used by the tlisten(1) process servicing the network on the node identified by this logical machine. This network address has the same format as that specified for the tuxTmachineNaddr object.

This object must be set if the logical machine is to participate in a networked application, that is, if the LAN option is set in the tuxTdomainOptions object value.

 


tuxTmachineCmpLimit

Syntax

DisplayString

Access

read-write

Description

Threshold message size at which compression occurs for remote traffic and, optionally, local traffic. Remote and local can be either non-negative numeric values or the string MAXLONG that is dynamically translated to the maximum long setting for the machine. Setting only the remote value defaults local to MAXLONG.

 


tuxTmachineTmNetLoad

Syntax

INTEGER (0..32767)

Access

read-write

Description

Service load added to any remote service evaluated during load balancing on this machine.

 


tuxTmachineSpinCount

Syntax

INTEGER

Access

read-write

Description

Spincount used on this machine for pre-ticket user-level semaphore access. Default values are built into the Tuxedo system binaries on each machine. For tuning purposes, these defaults can be overridden at run-time using tuxTmachineSpinCount. The spincount can be reset to the default built-in value for the site by resetting tuxTmachineSpinCount to 0.

 


tuxTmachineRole

Syntax

INTEGER { master(1)| backup(2)| other(3) }

Access

read-only

Description

The role of this machine in the application.

master(1)

Indicates that this machine is the master machine,

backup(2)

Indicates that it is the backup master machine, and

other(3)

Indicates that the machine is neither the master nor the backup master machine.

 


tuxTmachineMinor

Syntax

INTEGER

Access

read-only

Description

The Tuxedo system minor protocol release number for this machine.

 


tuxTmachineRelease

Syntax

INTEGER

Access

read-only

Description

The Tuxedo system major protocol release number for this machine. This value can be different from the tuxTmachineSWrelease for the same machine.

 


tuxTmachineMaxPendingBytes

Syntax

INTEGER

Access

read-write

Description

Specifies a limit for the amount of space that can be allocated for messages waiting to be transmitted by the BRIDGE process. The minimum value is 100000.

 


tuxMachineMaxObjects (Tuxedo 8.0 or later)

Syntax

INTEGER

Access

read-write

Description

The maximum number of CORBA objects that can be accommodated in the Active Object Map tables in the bulletin board.

 


tuxTmachineEncryptionRequired

Syntax

INTEGER { yes(1) | no(2)}

Access

read-write

Description

If set to “yes,” every application service on this machine requires an encrypted input message buffer.

 


tuxTmachineSignatureRequired

Syntax

INTEGER { yes(1) | no(2)}

Access

read-write

Description

If set to “yes,” every application service on this machine requires a valid digital signature on its input message buffer.

 


tuxTmachineActive

The tuxTmachineActive group contains objects that represent run-time statistics on the local machine if the machine is active (that is, some component of the application is active on the machine). Objects in this group are only accessible through a Tuxedo SNMP agent installed on the local machine.

Object Name
Object ID
tuxTmachineCurAccessers
.1.3.6.1.4.1.140.300.5.2.1
tuxTmachineCurClients
.1.3.6.1.4.1.140.300.5.2.2
tuxTmachineCurConv
.1.3.6.1.4.1.140.300.5.2.3
tuxTmachineCurGTT
.1.3.6.1.4.1.140.300.5.2.4
tuxTmachineCurLoad
.1.3.6.1.4.1.140.300.5.2.5
tuxTmachineCurWsClients
.1.3.6.1.4.1.140.300.5.2.6
tuxTmachineHwAccessers
.1.3.6.1.4.1.140.300.5.2.7
tuxTmachineHwClients
.1.3.6.1.4.1.140.300.5.2.8
tuxTmachineHwConv
.1.3.6.1.4.1.140.300.5.2.9
tuxTmachineHwGTT
.1.3.6.1.4.1.140.300.5.2.10
tuxTmachineHwWsClients
.1.3.6.1.4.1.140.300.5.2.11
tuxTmachineNumConv
.1.3.6.1.4.1.140.300.5.2.12
tuxTmachineNumDequeue
.1.3.6.1.4.1.140.300.5.2.13
tuxTmachineNumEnqueue
.1.3.6.1.4.1.140.300.5.2.14
tuxTmachineNumPost
.1.3.6.1.4.1.140.300.5.2.15
tuxTmachineNumReq
.1.3.6.1.4.1.140.300.5.2.16
tuxTmachineNumSubscribe
.1.3.6.1.4.1.140.300.5.2.17
tuxTmachineNumTran
.1.3.6.1.4.1.140.300.5.2.18
tuxTmachineNumTranAbt
.1.3.6.1.4.1.140.300.5.2.19
tuxTmachineNumTranCmt
.1.3.6.1.4.1.140.300.5.2.20
tuxTmachineLicExpires
.1.3.6.1.4.1.140.300.5.2.21
tuxTmachineLicMaxUsers
.1.3.6.1.4.1.140.300.5.2.22
tuxTmachineLicSerial
.1.3.6.1.4.1.140.300.5.2.23
tuxTmachinePageSize
.1.3.6.1.4.1.140.300.5.2.24
tuxTmachineSWrelease
.1.3.6.1.4.1.140.300.5.2.25
tuxTmachineHwAclCache
.1.3.6.1.4.1.140.300.5.2.26
tuxTmachineAclCacheHits
.1.3.6.1.4.1.140.300.5.2.27
tuxTmachineAclCacheAccess
.1.3.6.1.4.1.140.300.5.2.28
tuxTmachineAclFail
.1.3.6.1.4.1.140.300.5.2.29
tuxTmachineWkCompleted
.1.3.6.1.4.1.140.300.5.2.30
tuxTmachineWkInitiated
.1.3.6.1.4.1.140.300.5.2.31
tuxMachineCurObjects (Tuxedo 8.0 or later)
.1.3.6.1.4.1.140.300.5.2.36
tuxMachineHwObjects (Tuxedo 8.0 or later)
.1.3.6.1.4.1.140.300.5.2.41

 


tuxTmachineCurAccessers

Syntax

INTEGER (0..32767)

Access

read-only

Description

Number of clients and servers that currently access the application either directly on this machine or through a workstation handler on this machine.

 


tuxTmachineCurClients

Syntax

INTEGER (0..32767)

Access

read-only

Description

Number of clients, both native and workstation, currently logged in to this machine.

 


tuxTmachineCurConv

Syntax

INTEGER (0..32767)

Access

read-only

Description

Number of active conversations with participants on this machine.

 


tuxTmachineCurGTT

Syntax

INTEGER (0..32767)

Access

read-only

Description

Number of in use transaction table entries on this machine.

 


tuxTmachineCurLoad

Syntax

INTEGER

Access

read-only

Description

Current service load enqueued on this machine.

Note: If the tuxTdomainLoadBalance object is no(2) or the tuxTdomainModel object is multi-machine(2), then an FML32 NULL value (0) is returned.

 


tuxTmachineCurWsClients

Syntax

INTEGER (0..32767)

Access

read-only

Description

Number of workstation clients currently logged in to this machine.

 


tuxTmachineHwAccessers

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of clients and servers accessing the application either directly on this machine or through a workstation handler on this machine.

 


tuxTmachineHwClients

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of clients, both native and workstation, logged in to this machine.

 


tuxTmachineHwConv

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of active conversations with participants on this machine.

 


tuxTmachineHwGTT

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of in use transaction table entries on this machine.

 


tuxTmachineHwWsClients

Syntax

INTEGER (0..32767)

Access

read-only

Description

High water number of workstation clients currently logged in to this machine.

 


tuxTmachineNumConv

Syntax

INTEGER

Access

read-only

Description

Number of tpconnect(3) operations performed from this machine.

 


tuxTmachineNumDequeue

Syntax

INTEGER

Access

read-only

Description

Number of tpdequeue(3) operations performed from this machine.

 


tuxTmachineNumEnqueue

Syntax

INTEGER

Access

read-only

Description

Number of tpenqueue(3) operations performed from this machine.

 


tuxTmachineNumPost

Syntax

INTEGER

Access

read-only

Description

Number of tppost(3) operations performed from this machine.

 


tuxTmachineNumReq

Syntax

INTEGER

Access

read-only

Description

Number of tpacall(3) or tpcall(3) operations performed from this machine.

 


tuxTmachineNumSubscribe

Syntax

INTEGER

Access

read-only

Description

Number of tpsubscribe(3) operations performed from this machine.

 


tuxTmachineNumTran

Syntax

INTEGER

Access

read-only

Description

Number of transactions initiated (tpbegin(3)) from this machine.

 


tuxTmachineNumTranAbt

Syntax

INTEGER

Access

read-only

Description

Number of transactions aborted (tpabort(3)) from this machine.

 


tuxTmachineNumTranCmt

Syntax

INTEGER

Access

read-only

Description

Number of transactions committed (tpcommit(3)) from this machine.

 


tuxTmachineLicExpires

Syntax

DisplayString (SIZE(0..78))

Access

read-only

Description

Expiration date for the binary on the machine or a 0-length string if binary is not a Tuxedo system master binary.

 


tuxTmachineLicMaxUsers

Syntax

INTEGER (0..32767)

Access

read-only

Description

Maximum number of licensed users on that machine, or -1 if binary is not a Tuxedo system master binary.

 


tuxTmachineLicSerial

Syntax

DisplayString (SIZE(0..78))

Access

read-only

Description

Serial number for binary on the machine or a 0-length string if binary is not a Tuxedo system master binary.

 


tuxTmachinePageSize

Syntax

INTEGER

Access

read-only

Description

Disk pagesize used on this machine.

 


tuxTmachineSWrelease

Syntax

DisplayString (SIZE(0..78))

Access

read-only

Description

Software release for binary on that machine or a 0-length string if binary is not a Tuxedo system master binary.

 


tuxTmachineHwAclCache

Syntax

INTEGER

Access

read-only

Description

High water number of entries used in the ACL cache.

 


tuxTmachineAclCacheHits

Syntax

INTEGER

Access

read-only

Description

Number of accesses to the ACL cache that resulted in a “hit” (that is, the entry was already in the cache).

 


tuxTmachineAclCacheAccess

Syntax

INTEGER

Access

read-only

Description

Number of accesses to the ACL cache.

 


tuxTmachineAclFail

Syntax

INTEGER

Access

read-only

Description

Number of accesses to the ACL cache that resulted in a access control violation.

 


tuxTmachineWkCompleted

Syntax

INTEGER

Access

read-only

Description

Total service load dequeued and processed successfully by servers running on this machine. Note that for long running applications this object can wraparound, that is, exceed the maximum value for a long, and start back at 0 again.

 


tuxTmachineWkInitiated

Syntax

INTEGER

Access

read-only

Description

Total service load enqueued by clients/servers running on this machine. Note that for long running applications this object can wraparound, that is, exceed the maximum value for a long, and start back at 0 again.

 


tuxMachineCurObjects (Tuxedo 8.0 or later)

Syntax

INTEGER

Access

read-only

Description

The number of entries in use in the bulletin board object table for this machine.

 


tuxMachineHwObjects (Tuxedo 8.0 or later)

Syntax

INTEGER

Access

read-only

Description

The high water mark of entries used in the bulletin board object table for this machine.

 


tuxTmsgTable

The tuxTmsgTable group contains objects that represent run-time characteristics of the Tuxedo system managed UNIX system message queues. Objects in this table are only accessible through a Tuxedo SNMP agent installed on the local machine. tuxTmsgId is the index into this table.

Object Name
Object ID
.1.3.6.1.4.1.140.300.6.1.1.1
.1.3.6.1.4.1.140.300.6.1.1.2
.1.3.6.1.4.1.140.300.6.1.1.3
.1.3.6.1.4.1.140.300.6.1.1.4
.1.3.6.1.4.1.140.300.6.1.1.5
.1.3.6.1.4.1.140.300.6.1.1.6
.1.3.6.1.4.1.140.300.6.1.1.7
.1.3.6.1.4.1.140.300.6.1.1.8
.1.3.6.1.4.1.140.300.6.1.1.9
.1.3.6.1.4.1.140.300.6.1.1.10
.1.3.6.1.4.1.140.300.6.1.1.11

 


tuxTmsgId

Syntax

INTEGER

Access

read-only

Description

UNIX system message queue identifier.

Note: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTmsgState

Syntax

INTEGER { active(1) }

Access

read-only

Description

The values for GET and SET operations are as follows:

GET: active(1)

A GET operation retrieves run-time information for the selected tuxTmsgTable object(s). The following state indicates the meaning of a tuxTmsgState returned in response to a GET request. States not listed are not returned.

active(1)

tuxTmsgTable object active. This state corresponds exactly to the related tuxTmachineTable object being active.

SET:

SET operations are not permitted on this group.

 


tuxTmsgCurTime

Syntax

INTEGER

Access

read-only

Description

Current time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on the local host.

 


tuxTmsgCbytes

Syntax

INTEGER

Access

read-only

Description

Current number of bytes on the queue.

 


tuxTmsgCtime

Syntax

INTEGER

Access

read-only

Description

Time of the last msgctl(2) operation that changed a member of the msqid_ds structure associated with the queue.

 


tuxTmsgLrPid

Syntax

INTEGER

Access

read-only

Description

Process identifier of the last process that read from the queue.

 


tuxTmsgLsPid

Syntax

INTEGER

Access

read-only

Description

Process identifier of the last process that wrote to the queue.

 


tuxTmsgQbytes

Syntax

INTEGER

Access

read-only

Description

Maximum number of bytes allowed on the queue.

 


tuxTmsgQnum

Syntax

INTEGER

Access

read-only

Description

Number of messages currently on the queue.

 


tuxTmsgRtime

Syntax

INTEGER

Access

read-only

Description

Time since the last read from the queue.

 


tuxTmsgStime

Syntax

INTEGER

Access

read-only

Description

Time since the last write to the queue.

 


tuxTqueueTable

The tuxTqueueTable group contains objects that represent run-time characteristics of queues in an application. The object values identify and characterize allocated Tuxedo system request queues associated with servers in a running application. They also track statistics related to application workloads associated with each queue object. The index into this table is tuxTqueueRqAddr. Objects in this table are only accessible through a Tuxedo SNMP agent installed on the local machine.

Object Name
Object ID
tuxTqueueRqAddr
.1.3.6.1.4.1.140.300.7.1.1.1
tuxTqueueState
.1.3.6.1.4.1.140.300.7.1.1.2
tuxTqueueRqId
.1.3.6.1.4.1.140.300.7.1.1.3
tuxTqueueSrvrCnt
.1.3.6.1.4.1.140.300.7.1.1.4
tuxTqueueTotNqueued
.1.3.6.1.4.1.140.300.7.1.1.5
tuxTqueueTotWkQueued
.1.3.6.1.4.1.140.300.7.1.1.6
tuxTqueueSource
.1.3.6.1.4.1.140.300.7.1.1.7
tuxTqueueNqueued
.1.3.6.1.4.1.140.300.7.1.1.8
tuxTqueueWkQueued
.1.3.6.1.4.1.140.300.7.1.1.9

 


tuxTqueueRqAddr

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Symbolic address of the request queue. Servers with the same tuxTsrvrRqAddr object value are grouped into a Multiple Server Single Queue (MSSQ) set. object values returned with a tuxTqueueTable object apply to all active servers associated with this symbolic queue address.

 


tuxTqueueState

Syntax

INTEGER { active(1)| migrating(2)| suspended(3)| partitioned(4) }

Access

read-only

Description

The values for GET and SET operations are as follows:

GET: {active(1)|migrating(2)|suspended(3)|partitioned(4)}

A GET operation retrieves run-time information for the selected tuxTqueueTable instance(s). The tuxTqueueTable group does not address configuration information directly. Configuration-related objects discussed here must be set as part of the related tuxTsrvrTbl instances. The following states indicate the meaning of a tuxTqueueState returned in response to a GET request. States not listed are not returned.

active(1)

At least one server associated with this tuxTqueueTable instance is active(1).

migrating(2)

The server(s) associated with this tuxTqueueTable instance is currently in the migrating(2) state. See the tuxTsrvrTbl group for more details on this state.

suspended(3)

The server(s) associated with this tuxTqueueTable instance is currently in the suspended(3) state. See the tuxTsrvrTbl group for more details on this state.

partitioned(4)

The server(s) associated with this tuxTqueueTable instance is currently in the partitioned(4) state. See the tuxTsrvrTbl group for more details on this state.

SET:

A SET operation updates run-time information for the selected tuxTqueueTable object. State changes are not allowed when updating tuxTqueueTable object information. Modification of an existing tuxTqueueTable object is allowed only when the object is in the active(1) state.

 


tuxTqueueRqId

Syntax

INTEGER

Access

read-only

Description

UNIX system message queue identifier.

Note: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTqueueSrvrCnt

Syntax

INTEGER

Access

read-only

Description

Number of active servers associated with this queue.

 


tuxTqueueTotNqueued

Syntax

INTEGER

Access

read-only

Description

The sum of the queue lengths of this queue while it has been active. This sum includes requests enqueued to and processed by servers that are no longer active on the queue. Each time a new request is assigned to the queue, the sum is incremented by the length of the queue immediately before the new request is enqueued.

Note: If the tuxTdomainLoadBalance object is no(2) or the tuxTdomainModel object is multi-machine(2), then tuxTqueueTotNqueued is not returned. In the same configuration, updates to this object are ignored. Consequently, when this object is returned tuxTqueueSource has the same value as the local host.

 


tuxTqueueTotWkQueued

Syntax

INTEGER

Access

read-only

Description

The sum of the workloads enqueued to this queue while it has been active. This sum includes requests enqueued to and processed by servers that are no longer active on the queue. Each time a new request is assigned to the queue, the sum is incremented by the workload on the queue immediately before the new request is enqueued.

Note: If the tuxTdomainLoadBalance object is no(2) or the tuxTdomainModel object is multi-machine(2), then tuxTqueueTotWkQueued is not returned. In the same configuration, updates to this object are ignored. Consequently, when this object is returned tuxTqueueSource has the same value as the local host.

 


tuxTqueueSource

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Logical machine from which local object values are retrieved.

 


tuxTqueueNqueued

Syntax

INTEGER

Access

read-only

Description

Number of requests currently enqueued to this queue from the tuxTqueueSource logical machine. This value is incremented at enqueue time and decremented when the server dequeues the request.

Note: If the tuxTdomainLoadBalance object is no(2) or the tuxTdomainModel object is multi-machine(2), then tuxTqueueNqueued is not returned. Consequently, when this object is returned tuxTqueueSource has the same value as the local host.

 


tuxTqueueWkQueued

Syntax

INTEGER

Access

read-only

Description

Workload currently enqueued to this queue from the tuxTqueueSource logical machine. If the tuxTdomainModel object is set to single-machine(1) and the tuxTdomainLoadBalance object is set to yes(1), then tuxTqueueWkQueued reflects the application-wide workload enqueued to this queue. However, if tuxTdomainModel is set to multi-machine(2) and tuxTdomainLoadBalance is set to yes(1), then tuxTqueueWkQueued reflects the workload enqueued to this queue from the tuxTqueueSource logical machine during a recent timespan. The tuxTqueueWkQueued value is used for load balancing purposes. In order not discriminate against newly started servers, tuxTqueueWkQueued is zeroed out on each machine periodically by the BBL.

 


tuxTroutingTable

The tuxTroutingTable group contains objects that represent configuration characteristics of routing specifications for an application. The object values identify and characterize application data-dependent routing criteria with respect to field names, buffer types, and routing definitions. This table also represents configuration objects for factory-based routing for Tuxedo 8.0 or later applications. Object tuxRoutingFieldType (Tuxedo 8.0 or later) is valid only for factory-based routing. Object tuxTroutingBufType is valid only for service-based routing.

The index into this table consists of the following objects: tuxTroutingName, tuxRoutingType, and tuxInternalIdx.

Object tuxRoutingFieldType is valid only for factory-based routing and is supported only for Tuxedo 8.0 or later applications.

Object tuxTroutingBufType is valid only for service-based routing.

When specifying the index in SET requests, tuxInternalIdx is used as an index.

For factory-based routing, tuxInternalIdx must always have a value of -.

For service-based routing, tuxInternalIdx should equal the first 30 characters in tuxTroutingBufType.

To create a new row in the table, it is necessary to issue a SET request for a non-existing row specifying the values of all objects applicable to the tuxRoutingType.

Object Name
Object ID
tuxTroutingName
.1.3.6.1.4.1.140.300.8.1.1.1
tuxTroutingBufType
.1.3.6.1.4.1.140.300.8.1.1.2
tuxTroutingField
.1.3.6.1.4.1.140.300.8.1.1.3
tuxTroutingRanges
.1.3.6.1.4.1.140.300.8.1.1.4
tuxTroutingState
.1.3.6.1.4.1.140.300.8.1.1.5
tuxRoutingType
.1.3.6.1.4.1.140.300.8.1.1.6
tuxRoutingFieldType (Tuxedo 8.0 or later)
.1.3.6.1.4.1.140.300.8.1.1.7
tuxInternalIdx
.1.3.6.1.4.1.140.300.8.1.1.8

 


tuxTroutingName

Syntax

DisplayString (SIZE(1..15))

Access

read-write

Description

Routing criterion name.

Note: This object can be set only during row creation.

 


tuxTroutingBufType

Syntax

DisplayString (SIZE(1..256))

Access

read-write

Description

List of types and subtypes of data buffers for which this routing entry is valid. A maximum of 32 type/subtype combinations are allowed. The types are restricted to one of FML, VIEW, X_C_TYPE, or X_COMMON. No subtype can be specified for type FML, and subtypes are required for types VIEW, X_C_TYPE, and X_COMMON (* is not allowed). Note that subtype names should not contain semicolon, colon, comma, or asterisk characters. Duplicate type/subtype pairs cannot be specified for the same routing criterion name. More than one routing entry can have the same criterion name as long as the type/subtype pairs are unique. If multiple buffer types are specified for a single routing entry, the data types of the routing field for each buffer type must be the same.

Note: This object is applicable only for service-based routing.
Note: This object can be set only during row creation.

 


tuxTroutingField

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Routing field name.

For Service-based Routing: This field is assumed to be an FML buffer or view field name that is identified in an FML field table (using the FLDTBLDIR and FIELDTBLS environment) or an FML view table (using the VIEWDIR and VIEWFILES environment), respectively. This information is used to get the associated field value for data dependent routing during the sending of a message.

For factory-based routing: This is assumed to be a field that is specified in an NVList parameter to:

PortableServer::POA::create_reference_with_criteria

for an interface that has this factory routing criteria associated with it. See the Tuxedo 8.0 or later documentation for more details.

 


tuxTroutingRanges

Syntax

DisplayString (SIZE(1..2048))

Access

read-write

Description

The ranges and associated server groups for a routing criterion are as follows:

criterion: range: group
range: value | lower - upper | *
lower: value
upper: value
value: MIN | MAX | numeric | string
group
: string | *
numeric: [+ | -]digits[.digits][e | E[ | + | - ] digit
digit: 0-9
digits: digit[digit]

\ can be used to escape the single-quote character in strings.

lower must be less than upper. A group specified as a string must specify a valid tuxTgroupName.

 


tuxTroutingState

Syntax

INTEGER { valid(1) | unknown(2) | invalid(3) }

Access

read-write

Description

The values for GET and SET operations are as follows:

GET: valid(1)

A GET operation retrieves configuration information for the selected tuxTroutingTable instance(s). The following state indicates the meaning of a tuxTroutingState returned in response to a GET request. States not listed are not returned.

valid(1)

tuxTroutingTable instance is defined. Note that valid(1) is the only valid state for this group. Routing criteria are never active; rather, they are associated through the configuration with service names and are acted upon at run-time to provide data dependent routing.

SET: invalid(3)

A SET operation updates configuration information for the selected tuxTroutingTable instance. The following state indicates the meaning of a tuxTroutingState set in a SET request. States not listed cannot be set.

invalid(3)

Delete tuxTroutingTable instance for application. State change allowed only when in the valid(1) state. Successful return leaves the object in the invalid(2) state.

 


tuxRoutingType

Syntax

INTEGER { service(1) |factory(2) }

Access

read-write

Description

service(1)

Specifies that routing criteria apply to data-dependent routing for an Oracle Tuxedo service.

factory(2)

Specifies that the routing criterion applies to factory-based routing for a CORBA interface.
Note: The routing type affects the validity and possible values for other objects defined for this table.
Note: This object can be set during row creation only.

 


tuxRoutingFieldType (Tuxedo 8.0 or later)

Syntax

INTEGER { short(1) |long(2) |float(3) |double(4) |char(5) |string(6) }

Access

read-write

Description

This object specifies the type of tuxTroutingField on which this routing criterion is defined. Its value is valid only for factory-based routing.

Note: This object can be set only during row creation.

 


tuxInternalIdx

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

This object is used as an index of this table instead of tuxTroutingBufType (for service-based routing) or tuxTroutingField (for factory-based routing) to reduce the size of the index. Its value for service-based routing (tuxRoutingType = service(1)) is equal to the first 30 characters in tuxTroutingBufType.

In case of entries for factory-based routing (tuxRoutingType = factory(2)), the value is always tuxTroutingField.

Note: This object can be set only during row creation.

 


tuxTsrvrTbl

The tuxTsrvrTbl group contains objects that represent configuration and run-time characteristics of servers within an application. The object values identify and characterize configured servers as well as provide run-time tracking of statistics and resources associated with each server object.

The index into this table is provided by the objects tuxTsrvrGrpNo and tuxTsrvrId. To create a new row in the table, it is necessary to issue a SET request specifying the values of at least tuxTsrvrGrp and tuxTsrvrName.

Object Name
Object ID
tuxTsrvrGrp
.1.3.6.1.4.1.140.300.20.1.1.1
tuxTsrvrId
.1.3.6.1.4.1.140.300.20.1.1.2
tuxTsrvrName
.1.3.6.1.4.1.140.300.20.1.1.3
tuxTsrvrGrpNo
.1.3.6.1.4.1.140.300.20.1.1.4
tuxTsrvrState
.1.3.6.1.4.1.140.300.20.1.1.5
tuxTsrvrBaseSrvId
.1.3.6.1.4.1.140.300.20.1.1.6
tuxTsrvrClOpt
.1.3.6.1.4.1.140.300.20.1.1.7
tuxTsrvrEnvFile
.1.3.6.1.4.1.140.300.20.1.1.8
tuxTsrvrGrace
.1.3.6.1.4.1.140.300.20.1.1.9
tuxTsrvrMaxgen
.1.3.6.1.4.1.140.300.20.1.1.10
tuxTsrvrMax
.1.3.6.1.4.1.140.300.20.1.1.11
tuxTsrvrMin
.1.3.6.1.4.1.140.300.20.1.1.12
tuxTsrvrRcmd
.1.3.6.1.4.1.140.300.20.1.1.13
tuxTsrvrRestart
.1.3.6.1.4.1.140.300.20.1.1.14
tuxTsrvrSequence
.1.3.6.1.4.1.140.300.20.1.1.15
tuxTsrvrSystemAccess
.1.3.6.1.4.1.140.300.20.1.1.16
tuxTsrvrConv
.1.3.6.1.4.1.140.300.20.1.1.17
tuxTsrvrReplyQ
.1.3.6.1.4.1.140.300.20.1.1.18
tuxTsrvrRpPerm
.1.3.6.1.4.1.140.300.20.1.1.19
tuxTsrvrRqAddr
.1.3.6.1.4.1.140.300.20.1.1.20
tuxTsrvrRqPerm
.1.3.6.1.4.1.140.300.20.1.1.21
tuxTsrvrGeneration
.1.3.6.1.4.1.140.300.20.1.1.22
tuxTsrvrPid
.1.3.6.1.4.1.140.300.20.1.1.23
tuxTsrvrRpid
.1.3.6.1.4.1.140.300.20.1.1.24
tuxTsrvrRqId
.1.3.6.1.4.1.140.300.20.1.1.25
tuxTsrvrTimeRestart
.1.3.6.1.4.1.140.300.20.1.1.26
tuxTsrvrTimeStart
.1.3.6.1.4.1.140.300.20.1.1.27
tuxTsrvrMinDispatchThreads
.1.3.6.1.4.1.140.300.20.1.1.40
tuxTsrvrMaxDispatchThreads
.1.3.6.1.4.1.140.300.20.1.1.50
tuxTsrvrThreadStackSize
.1.3.6.1.4.1.140.300.20.1.1.60

 


tuxTsrvrGrp

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Logical name of the server group. Server group names cannot contain an asterisk (*), comma, or colon.

Note: This object can be set only during row creation.

 


tuxTsrvrId

Syntax

INTEGER (1..30001)

Access

read-write

Description

Unique (within the server group) server identification number.

Note: This object can be set only during row creation.

 


tuxTsrvrName

Syntax

DisplayString (SIZE(1..78))

Access

read-write

Description

Name of the server executable file. The server identified by tuxTsrvrName runs on the machine(s) identified by the tuxTgroupLMID object for this server’s server group. If a relative pathname is given, the search for the executable file is done first in tuxTmachineAppDir, then in tuxTmachineTuxDir/bin, then in /bin and /usr/bin, and then in <path>, where <path> is the value of the first PATH= line that appears in the machine environment file, if one exists. Note that the object value returned for an active server is always a full pathname.

 


tuxTsrvrGrpNo

Syntax

INTEGER (1..30000)

Access

read-only

Description

Group number associated with this server’s group.

 


tuxTsrvrState

Syntax

INTEGER { active(1) |inactive(2) |migrating(3) |cleaning(4) |
restarting(5) |suspended(6) | partitioned(7) |dead(8) | invalid(10) }

Access

read-write

Description

The values for GET and SET operations are as follows:

GET: active(1)|inactive(2)|migrating(3)|cleaning(4)|restarting(5)|
suspended(6)|partitioned(7)|dead(8)

A GET operation retrieves configuration and run-time information for the selected tuxTsrvrTbl instance(s). The following states indicate the meaning of a tuxTsrvrState returned in response to a GET request. States not listed are not returned.

active(1)

tuxTsrvrTbl instance is defined and active. The active(1) state is not an indication of whether the server is idle or busy. An active server with a non-0 length tuxTsrvrCurService object should be interpreted as a busy server, that is, one that is processing a service request.

inactive(2)

tuxTsrvrTbl instance is defined and inactive.

migrating(3)

tuxTsrvrTbl instance is defined and currently in a state of migration to the server group’s secondary logical machine. The secondary logical machine is the one listed in tuxTgroupLMID object that does not match the tuxTgroupCurLMID object.

cleaning(4)

tuxTsrvrTbl instance is defined and currently being cleaned up after by the system due to an abnormal death. Note that restartable servers can enter this state if they exceed tuxTsrvrMaxgen starts/restarts within their tuxTsrvrGrace period.

restarting(5)

tuxTsrvrTbl instance is defined and currently being restarted by the system due to an abnormal death.

suspended(6)

tuxTsrvrTbl instance is defined and currently suspended, pending shutdown.

partitioned(7)

tuxTsrvrTbl instance is defined and active; however, the machine where the server is running is currently partitioned from the tuxTdomainMaster site.

dead(8)

tuxTsrvrTbl instance is defined, identified as active in the bulletin board, but currently not running due to an abnormal death. This state exists only until the BBL local to the server notices the death and takes action (restarting(5)|cleaning(4)).

SET: {active(1)|inactive(2)|dead(8)|invalid(10)}

A SET operation updates configuration and run-time information for the selected tuxTsrvrTbl instance. The following states indicate the meaning of a tuxTsrvrState set in a SET request. States not listed cannot be set.

active(1)

Activate the tuxTsrvrTbl instance. State change is allowed only when the server is in the inactive(2) state. (Servers in the migrating(3) state must be restarted by setting the tuxTgroupState to active(1).) Successful return leaves the object in the active(1) state.

inactive(2)

Deactivate the tuxTsrvrTbl instance. State change is allowed only when the server is in the active(1) state. Successful return leaves the object in the inactive(2) state.

dead(8)

Deactivate the tuxTsrvrTbl instance by sending the server a SIGTERM signal followed by a SIGKILL signal if the server is still running after 20 seconds. Note that by default, a SIGTERM signal causes the server to initiate orderly shutdown and the server becomes inactive even if it is restartable. If a server is processing a long running service or has chosen to disable the SIGTERM signal, then SIGKILL can be used and is treated by the system as an abnormal termination. State change is allowed only when the server is in the active(1) or suspended(6) state. Successful return leaves the object in the inactive(2), cleaning(4), or restarting(5) state.

invalid(10)

Delete tuxTsrvrTbl instance for application. State change is allowed only when the server is in the inactive(2) state. Successful return leaves the object in the invalid(10) state.

 


tuxTsrvrBaseSrvId

Syntax

INTEGER (1..30001)

Access

read-only

Description

Base server identifier. For servers with a tuxTsrvrMax object value of 1, this object is always the same as tuxTsrvrId. However, for servers with a tuxTsrvrMax value of greater than 1, this object indicates the base server identifier for the set of servers configured identically.

 


tuxTsrvrClOpt

Syntax

DisplayString (SIZE(0..256))

Access

read-write

Description

Command line options to be passed to server when it is activated. See the servopts(5) manual page for details.

Note: Run-time modifications to this object do not affect a running server.

 


tuxTsrvrEnvFile

Syntax

DisplayString (SIZE(0..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

Server specific environment file. See tuxTmachineEnvFile for a complete discussion of how this file is used to modify the environment.

Note: Run-time modifications to this object do not affect a running server.

 


tuxTsrvrGrace

Syntax

INTEGER

Access

read-write

Description

The period of time, in seconds, over which the tuxTsrvrMaxgen object limit applies. The tuxTsrvrGrace value is meaningful only for restartable servers, that is, if the tuxTsrvrRestart object is set to yes(1). When a restarting server would exceed the tuxTsrvrMaxgen limit but the tuxTsrvrGrace period has expired, the system resets the current generation (tuxTsrvrGeneration) to 1 and resets the initial boot time (tuxTsrvrTimeStart) to the current time. A value of 0 for this object indicates that a server should always be restarted.

Note that servers sharing a request queue (that is, equal values for tuxTsrvrRqAddr) should have equal values for this object. If they do not, then the first server activated establishes the run-time value associated with all servers on the queue.

Note: Run-time modifications to this object affect a running server and all other active servers with which it is sharing a request queue. However, only the selected server’s configuration parameter is modified. Thus, the behavior of the application depends on the order of boot in subsequent activations unless the administrator ensures that all servers sharing a queue have the same value for this object.

 


tuxTsrvrMaxgen

Syntax

INTEGER (0..256)

Access

read-write

Description

Number of generations allowed for a restartable server (tuxTsrvrRestart == yes(1)) over the specified grace period (tuxTsrvrGrace). The initial activation of the server counts as one generation and each restart also counts as one. Processing after the maximum generations is exceeded is discussed above with respect to tuxTsrvrGrace.

Note that servers sharing a request queue (that is, equal values for tuxTsrvrRqAddr) should have equal values for this object. If they do not, then the first server activated establishes the run-time value associated with all servers on the queue.

Note: Run-time modifications to this object affect a running server and all other active servers with which it is sharing a request queue. However, only the selected server’s configuration parameter is modified. Thus, the behavior of the application depends on the order of boot in subsequent activations unless the administrator ensures that all servers sharing a queue have the same value for this object.

 


tuxTsrvrMax

Syntax

INTEGER (1..1001)

Access

read-write

Description

Maximum number of occurrences of the server to be booted. Initially, tmboot(1) boots tuxTsrvrMin objects of the server, and additional objects can be started individually (by starting a particular server id) or through automatic spawning (conversational servers only). Run-time modifications to this object affect all running servers in the set of identically configured servers (see tuxTsrvrBaseSrvId above) as well as the configuration definition of the server.

 


tuxTsrvrMin

Syntax

INTEGER (1..1001)

Access

read-write

Description

Minimum number of occurrences of the server to be booted by tmboot(1). If a tuxTsrvrRqAddr is specified and tuxTsrvrMin is greater than 1, then the servers form an MSSQ set. The server identifiers for the servers are tuxTsrvrId up to tuxTsrvrId + tuxTsrvrMax - 1. All occurrences of the server have the same sequence number, as well as any other server parameters.

Note: Run-time modifications to this object do not affect a running server.

 


tuxTsrvrRcmd

Syntax

DisplayString (SIZE(0..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

Application-specified command to be executed in parallel with the system restart of an application server. This command must be an executable file.

Note that servers sharing a request queue (that is, equal values for tuxTsrvrRqAddr) should have equal values for this object. If they do not, then the first server activated establishes the run-time value associated with all servers on the queue.

Note: Run-time modifications to this object affect a running server and all other active servers with which it shares a request queue. However, only the selected server’s configuration parameter is modified. Thus, the behavior of the application depends on the order of boot in subsequent activations unless the administrator ensures that all servers sharing a queue have the same value for this object.

 


tuxTsrvrRestart

Syntax

INTEGER { yes(1) | no(2) }

Access

read-write

Description

Restartable yes(1) or non-restartable no(2) server. If server migration is specified for this server group (tuxTdomainOptions = migrate(2) and tuxTgroupLMID with alternate site), this object must be set to yes(1).

Note that servers sharing a request queue (that is, equal values for tuxTsrvrRqAddr) should have equal values for this object. If they do not, the first server activated establishes the run-time value associated with all servers on the queue.

Note: Run-time modifications to this object affect a running server and all other active servers with which it shares a request queue. However, only the selected server’s configuration parameter is modified. Thus, the behavior of the application depends on the order of boot in subsequent activations unless the administrator ensures that all servers sharing a queue have the same value for this object.

 


tuxTsrvrSequence

Syntax

INTEGER (1..10000)

Access

read-write

Description

Specifies when this server should be booted (tmboot(1)) or shutdown (tmshutdown(1)) relative to other servers. If two servers are given the same sequence number, it is possible for tmboot(1) to boot them in parallel and for tmshutdown(1) to shut them down in parallel. tuxTsrvrTbl instances added without a tuxTsrvrSequence object specified or with an invalid value have one generated for them that is 10,000 or more and is higher than any other automatically selected default value. Servers are booted by tmboot(1) in increasing order of sequence number and shutdown by tmshutdown(1) in decreasing order. Run-time modifications to this object affect only tmboot(1) and tmshutdown(1) and affect the order in which running servers can be shutdown by a subsequent invocation of tmshutdown(1).

 


tuxTsrvrSystemAccess

Syntax

INTEGER { fastpath(1) | protected(2) }

Access

read-write

Description

Mode used by Tuxedo system libraries within this server process to gain access to Tuxedo system’s internal tables. See tuxTdomainSystemAccess for a complete discussion of this object.

Note: Run-time modifications to this object do not affect a running server.

 


tuxTsrvrConv

Syntax

INTEGER { yes(1) | no(2) }

Access

read-write

Description

Conversational server yes(1) or request/response server no(2).

 


tuxTsrvrReplyQ

Syntax

INTEGER { yes(1) | no(2) }

Access

read-write

Description

Specifies whether to allocate a separate reply queue for the server
(tuxTsrvrReplyQ == yes(1)). MSSQ servers that expect to receive replies should set this object to yes(1).

 


tuxTsrvrRpPerm

Syntax

DisplayString (SIZE(4))

Access

read-write

Description

UNIX system permissions for the server’s reply queue. If a separate reply queue is not allocated (tuxTsrvrReplyQ == no(2)), this object is ignored. The tuxTsrvrRpPerm value is a string representation of octal numbers starting with a leading 0 0001 through 0777.

Note: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTsrvrRqAddr

Syntax

DisplayString (SIZE(0..30))

Access

read-write

Description

Symbolic address of the request queue for the server. Specifying the same tuxTsrvrRqAddr object value for more than one server is the way multiple server, single queue (MSSQ) sets are defined. Servers with the same tuxTsrvrRqAddr object value must be in the same server group.

 


tuxTsrvrRqPerm

Syntax

DisplayString (SIZE(4))

Access

read-write

Description

UNIX system permissions for the server’s request queue. The tuxTsrvrRqPerm value is a string representation of octal numbers starting with a leading 0 0001 through 0777.

Note: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTsrvrGeneration

Syntax

INTEGER (1..32768)

Access

read-only

Description

Generation of the server. When a server is initially booted via tmboot(1) or activated through the SNMP agent, its generation is set to 1. Each time the server dies abnormally and is restarted, its generation is incremented. Note that when tuxTsrvrMaxgen is exceeded and tuxTsrvrGrace has expired, the server is restarted with the generation reset to 1.

 


tuxTsrvrPid

Syntax

INTEGER

Access

read-only

Description

UNIX system process identifier for the server. Note that this value cannot be a unique value since servers can be located on different machines, allowing for duplication of process identifiers.

Note: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTsrvrRpid

Syntax

INTEGER

Access

read-only

Description

UNIX system message queue identifier for the server’s reply queue. If a separate reply queue is not allocated (tuxTsrvrReplyQ == no(2)), the tuxTsrvrRqid value is the same as the tuxTsrvrRqId value.

Note: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTsrvrRqId

Syntax

INTEGER

Access

read-only

Description

UNIX system message queue identifier for the server’s request queue. If a separate reply queue is not allocated (tuxTsrvrReplyQ == no(2)), the tuxTsrvrRpId value is the same as the tuxTsrvrRpid value.

Note: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTsrvrTimeRestart

Syntax

INTEGER

Access

read-only

Description

Time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on local host, when the server was last started or restarted.

 


tuxTsrvrTimeStart

Syntax

INTEGER

Access

read-only

Description

Time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on local host, when the server was first started. Restarts of the server do not reset this value; however, if tuxTsrvrMaxgen is exceeded and tuxTsrvrGrace is expired, this object is reset to the time of the restart.

 


tuxTsrvrMinDispatchThreads

Syntax

INTEGER (1..999)

Access

read-only

Description

Specifies the number of server dispatch threads started on the initial server boot. This object is effective only if the server has been built with the buildserver -t command.

The separate dispatcher thread that is used when the value of tuxTsrvrMaxDispatchThreads is greater than one is not counted as part of the tuxTsrvrMinDispatchThreads value. The value of tuxTsrvrMinDispatchThreads must be less than the value of tuxTsrvrMaxDispatchThreads. If this object is not specified, the default is 0.

 


tuxTsrvrMaxDispatchThreads

Syntax

INTEGER (0..999)

Access

read-only

Description

Specifies the maximum number of concurrently dispatched threads that each server process can spawn. This object is effective only if the server has been built with the buildserver -t command.

If tuxTsrvrMaxDispatchThreads is greater than one, a separate dispatcher thread is used and does not count against this limit. The value of tuxTsrvrMinDispatchThreads must be less than the value of tuxTsrvrMaxDispatchThreads. If this object is not specified, the default is 1.

 


tuxTsrvrThreadStackSize

Syntax

INTEGER (0..2147483647)

Access

read-write

Description

If this object is not specified or if the value specified is 0, the operating system default is used. This option affects the server only when a value greater than 1 is specified for tuxTsrvrMaxDispatchThreads.

 


tuxTsrvrTblExt

The tuxTsrvrTblExt group is an extension of tuxTsrvrTbl. Objects in this table are only accessible through a Tuxedo SNMP agent installed on the local machine.

Object Name
Object ID
tuxTsrvrIdExt
.1.3.6.1.4.1.140.300.20.2.1.1
tuxTsrvrGrpNoExt
.1.3.6.1.4.1.140.300.20.2.1.2
tuxTsrvrNumConv
.1.3.6.1.4.1.140.300.20.2.1.3
tuxTsrvrNumDeque
.1.3.6.1.4.1.140.300.20.2.1.4
tuxTsrvrNumEnque
.1.3.6.1.4.1.140.300.20.2.1.5
tuxTsrvrNumPost
.1.3.6.1.4.1.140.300.20.2.1.6
tuxTsrvrNumReq
.1.3.6.1.4.1.140.300.20.2.1.7
tuxTsrvrNumSubscribe
.1.3.6.1.4.1.140.300.20.2.1.8
tuxTsrvrNumTran
.1.3.6.1.4.1.140.300.20.2.1.9
tuxTsrvrTranAbt
.1.3.6.1.4.1.140.300.20.2.1.10
tuxTsrvrTranCmt
.1.3.6.1.4.1.140.300.20.2.1.11
tuxTsrvrTotReqC
.1.3.6.1.4.1.140.300.20.2.1.12
tuxTsrvrTotWorkL
.1.3.6.1.4.1.140.300.20.2.1.13
tuxTsrvrCltLmid
.1.3.6.1.4.1.140.300.20.2.1.14
tuxTsrvrCltPid
.1.3.6.1.4.1.140.300.20.2.1.15
tuxTsrvrCltReply
.1.3.6.1.4.1.140.300.20.2.1.16
tuxTsrvrCmtRet
.1.3.6.1.4.1.140.300.20.2.1.17
tuxTsrvrCurConv
.1.3.6.1.4.1.140.300.20.2.1.18
tuxTsrvrCurReq
.1.3.6.1.4.1.140.300.20.2.1.19
tuxTsrvrCurService
.1.3.6.1.4.1.140.300.20.2.1.20
tuxTsrvrCurTime
.1.3.6.1.4.1.140.300.20.2.1.21
tuxTsrvrLastGrp
.1.3.6.1.4.1.140.300.20.2.1.22
tuxTsrvrSvcTimeOut
.1.3.6.1.4.1.140.300.20.2.1.23
tuxTsrvrTimeLeft
.1.3.6.1.4.1.140.300.20.2.1.24
tuxTsrvrTranLev
.1.3.6.1.4.1.140.300.20.2.1.25
tuxTsrvrStateExt
.1.3.6.1.4.1.140.300.20.2.1.26
tuxTsrvrGrpExt
.1.3.6.1.4.1.140.300.20.2.1.27
tuxSrvrCurObjsExt (Tuxedo 8.0 or later)
.1.3.6.1.4.1.140.300.20.2.1.32
tuxSrvrCurInterfaceExt (Tuxedo 8.0 or later)
.1.3.6.1.4.1.140.300.20.2.1.37
tuxTsrvrCurDispatchThreads
.1.3.6.1.4.1.140.300.20.2.1.100
tuxTsrvrHwDispatchThreads
.1.3.6.1.4.1.140.300.20.2.1.110
tuxTsrvrNumDispatchThreads
.1.3.6.1.4.1.140.300.20.2.1.120

 


tuxTsrvrIdExt

Syntax

INTEGER (1..30001)

Access

read-only

Description

Unique (within the server group) server identification number.

 


tuxTsrvrGrpNoExt

Syntax

INTEGER (1..30000)

Access

read-only

Description

Group number associated with this server’s group.

 


tuxTsrvrNumConv

Syntax

INTEGER

Access

read-only

Description

Number of conversations initiated by this server through tpconnect(3).

 


tuxTsrvrNumDeque

Syntax

INTEGER

Access

read-only

Description

Number of dequeue operations initiated by this server through tpdequeue(3).

 


tuxTsrvrNumEnque

Syntax

INTEGER

Access

read-only

Description

Number of enqueue operations initiated by this server through tpenqueue(3).

 


tuxTsrvrNumPost

Syntax

INTEGER

Access

read-only

Description

Number of postings initiated by this server through tppost(3).

 


tuxTsrvrNumReq

Syntax

INTEGER

Access

read-only

Description

Number of requests made by this server through tpcall(3) or tpacall(3).

 


tuxTsrvrNumSubscribe

Syntax

INTEGER

Access

read-only

Description

Number of subscriptions made by this server through tpsubscribe(3).

 


tuxTsrvrNumTran

Syntax

INTEGER

Access

read-only

Description

Number of transactions begun by this server since its last (re)start.

 


tuxTsrvrTranAbt

Syntax

INTEGER

Access

read-only

Description

Number of transactions aborted by this server since its last (re)start.

 


tuxTsrvrTranCmt

Syntax

INTEGER

Access

read-only

Description

Number of transactions committed by this server since its last (re)start.

 


tuxTsrvrTotReqC

Syntax

INTEGER

Access

read-only

Description

Total number of requests completed by this server. For conversational servers (tuxTsrvrConv == yes(1)), the tuxTsrvrTotReqC value indicates the number of completed incoming conversations. The tuxTsrvrTotReqC value is a run-time value that is kept across server restart but is lost at server shutdown.

 


tuxTsrvrTotWorkL

Syntax

INTEGER

Access

read-only

Description

Total workload completed by this server. For conversational servers (tuxTsrvrConv == yes(1)), the tuxTsrvrTotWorkL value indicates the workload of completed incoming conversations. The tuxTsrvrTotWorkL value is a run-time value that is kept across server restart but is lost at server shutdown.

 


tuxTsrvrCltLmid

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Logical machine for the initiating client or server. The initiating client or server is the process that made the service request on which the server is currently working.

 


tuxTsrvrCltPid

Syntax

INTEGER

Access

read-only

Description

UNIX system process identifier for the initiating client or server.

Note: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTsrvrCltReply

Syntax

INTEGER { yes(1) | no(2) | null(3) }

Access

read-only

Description

yes(1)

The initiating client or server expects a reply.

no(2)

The initiating client or server does not expect a reply.

 


tuxTsrvrCmtRet

Syntax

INTEGER { complete(1) | logged(2) }

Access

read-only

Description

The setting of the TP_COMMIT_CONTROL characteristic for this server. For details on this characteristic, see the description of the Tuxedo system ATMI function tpscmt(3).

 


tuxTsrvrCurConv

Syntax

INTEGER

Access

read-only

Description

Number of conversations initiated by this server through tpconnect(3) that are still active.

 


tuxTsrvrCurReq

Syntax

INTEGER

Access

read-only

Description

Number of requests initiated by this server through tpcall(3) or tpacall(3) that are still active.

 


tuxTsrvrCurService

Syntax

DisplayString (SIZE(1..127))

Access

read-only

Description

Service name, if any, on which the server is currently working.

 


tuxTsrvrCurTime

Syntax

INTEGER

Access

read-only

Description

Current time, in seconds, since 00:00:00 UTC, January 1, 1970, as on the local host. This object can be used to compute elapsed time from the tuxTsrvrTimeStart and tuxTsrvrTimeRestart object values.

 


tuxTsrvrLastGrp

Syntax

INTEGER (1..30000)

Access

read-only

Description

Server group number (tuxTgroupNo) of the last service request made or conversation initiated from this server outward.

 


tuxTsrvrSvcTimeOut

Syntax

INTEGER

Access

read-only

Description

Time left in seconds, if any, for this server to process the current service request. A value of 0 for an active service indicates that no timeout processing is being done. See tuxTsvcTimeOut for more information.

 


tuxTsrvrTimeLeft

Syntax

INTEGER

Access

read-only

Description

Time left, in seconds, for this server to receive the reply for which it is currently waiting before it times out. This timeout can be a transactional timeout or a blocking timeout.

 


tuxTsrvrTranLev

Syntax

INTEGER

Access

read-only

Description

Current transaction level for this server. 0 indicates that the server is not currently involved in a transaction.

 


tuxTsrvrStateExt

Syntax

INTEGER { active(1) | inactive(2) | migrating(3) | cleaning(4) | restarting(5) | suspended(6) | partitioned(7) | dead(8) }

Access

read-only

Description

Refer to description of tuxTsrvrState for details.

 


tuxTsrvrGrpExt

Syntax

DisplayString

Access

read-only

Description

Name of group to which this server belongs. This object is included for readability purposes only.

 


tuxSrvrCurObjsExt (Tuxedo 8.0 or later)

Syntax

INTEGER

Access

read-only

Description

The number of entries in use in the bulletin board object table for this server.

 


tuxSrvrCurInterfaceExt (Tuxedo 8.0 or later)

Syntax

DisplayString (SIZE(1..128))

Access

read-only

Description

The interface name of the interface currently active in this server.

 


tuxTsrvrCurDispatchThreads

Syntax

INTEGER

Access

read-only

Description

Current number of active service dispatch threads for this server.

 


tuxTsrvrHwDispatchThreads

Syntax

INTEGER

Access

read-only

Description

Highest number of active service dispatch threads created for this server since its last restart. This number can differ from the number of service calls, because an administrator can specify parameters that control the caching of idle service threads.

 


tuxTsrvrNumDispatchThreads

Syntax

INTEGER

Access

read-only

Description

Total number of active service dispatch threads created for this server since its last restart.

 


tuxTsvcTbl

The tuxTsvcTbl group contains objects that represent configuration characteristics of services within an application. The object values identify and characterize configured services. A tuxTsvcTbl object provides activation time configuration objects for services not specifically configured as part of the tuxTsvcGrp group.

The index into this table is tuxTsvcName. Objects in this group are only accessible through a Tuxedo SNMP agent installed on the local machine. To create a new row in the table, it is necessary to issue a SET request for a non-existing row in the table.

Object Name
Object ID
tuxTsvcName
.1.3.6.1.4.1.140.300.10.1.1.1
tuxTsvcType
.1.3.6.1.4.1.140.300.10.1.1.2
tuxTsvcState
.1.3.6.1.4.1.140.300.10.1.1.3
tuxTsvcAutoTran
.1.3.6.1.4.1.140.300.10.1.1.4
tuxTsvcLoad
.1.3.6.1.4.1.140.300.10.1.1.5
tuxTsvcPrio
.1.3.6.1.4.1.140.300.10.1.1.6
tuxTsvcTimeOut
.1.3.6.1.4.1.140.300.10.1.1.7
tuxTsvcTranTime
.1.3.6.1.4.1.140.300.10.1.1.8
tuxTsvcBufType
.1.3.6.1.4.1.140.300.10.1.1.9
tuxTsvcRoutingName
.1.3.6.1.4.1.140.300.10.1.1.10
tuxTsvcEncryptionRequired
.1.3.6.1.4.1.140.300.10.1.1.20
tuxTsvcSignatureRequired
.1.3.6.1.4.1.140.300.10.1.1.30

 


tuxTsvcName

Syntax

DisplayString (SIZE(1..127))

Access

read-write

Description

Service name.

Note: This object can be set only during row creation.

 


tuxTsvcType

Syntax

INTEGER { app(1) | callable(2) | system(3) | unknown(4) }

Access

read-only

Description

Type of service.

app(1)

Indicates an application-defined service name.

callable(2)

Indicates a system-provided callable service.

system(3)

Indicates a system-provided and system-callable service. system(3) services are not available to application clients and servers for direct access.

 


tuxTsvcState

Syntax

INTEGER { active(1) | inactive(2) | invalid(3) }

Access

read-write

Description

The values for GET and SET operations are as follows:

GET: {active(1)|inactive(2)}

A GET operation retrieves configuration information for the selected tuxTsvcTbl instance(s). The following states indicate the meaning of a tuxTsvcState returned in response to a GET request. States not listed are not returned.

active(1)

tuxTsvcTbl instance is defined and at least one tuxTsvcGrp object with a matching tuxTsvcName value is active.

inactive(2)

tuxTsvcTbl instance is defined and no tuxTsvcGrp object with a matching tuxTsvcName value is active.

SET: invalid(3)

A SET operation updates configuration information for the selected tuxTsvcTbl instance. The following state indicates the meaning of a tuxTsvcState set in a SET request. States not listed cannot be set.

invalid(3)

Delete tuxTsvcTbl instance for application. State change is allowed only when the service is in the inactive(2) state. Successful return leaves the object in the invalid(3) state.

 


tuxTsvcAutoTran

Syntax

INTEGER { yes(1) | no(2) }

Access

read-write

Description

Automatically begin a transaction.

yes(1)

If the request is not already in transaction mode when a service request message is received for this service, automatically begin a transaction.

no(2)

Do not automatically begin a transaction
Note: Run-time updates to this object are not reflected in active tuxTsvcGrp objects.

 


tuxTsvcLoad

Syntax

INTEGER (1..32768)

Access

read-write

Description

This tuxTsvcTbl object imposes the indicated load on the system. Service loads are used for load balancing purposes, that is, queues with higher enqueued workloads are less likely to be chosen for a new request. Service loads have meaning only if the tuxTdomainLoadBalance is set to yes(1).

Note: Run-time updates to this object are not reflected in active tuxTsvcGrp objects.

 


tuxTsvcPrio

Syntax

INTEGER (1..100)

Access

read-write

Description

This tuxTsvcTbl object has the indicated dequeuing priority. If multiple service requests are waiting on a queue for servicing, the higher priority requests are serviced first.

Note: Run-time updates to this object are not reflected in active tuxTsvcGrp objects.

 


tuxTsvcTimeOut

Syntax

INTEGER

Access

read-write

Description

Time limit (in seconds) for processing requests for this service name. Servers processing service requests for this service are abortively terminated (kill -9) if they exceed the specified time limit in processing the request. A value of 0 for this object indicates that the service should not be abortively terminated.

Note: Run-time updates to this object are not reflected in active tuxTsvcGrp objects.

 


tuxTsvcTranTime

Syntax

INTEGER

Access

read-write

Description

Transaction timeout value (in seconds) for transactions automatically started for this tuxTsvcTbl object. Transactions are started automatically when a request not in transaction mode is received and the tuxTsvcAutoTran object value for the service is yes(1).

Note: Run-time updates to this object are not reflected in active tuxTsvcGrp objects.

 


tuxTsvcBufType

Syntax

DisplayString (SIZE(1..256))

Access

read-write

Description

type1[:subtype1[,subtype2 . . . ]][;type2[:subtype3[,. . . ]]] . . .

List of types and subtypes of data buffers accepted by this service. A maximum of 32 type/subtype combinations are allowed. Types of data buffers provided with Tuxedo system are FML (for FML buffers), VIEW, X_C_TYPE, or X_COMMON (for FMLviews), STRING (for NULL terminated character arrays), and CARRAY or X_OCTET (for a character array that is neither encoded nor decoded during transmission). Of these types, only VIEW, X_C_TYPE, and X_COMMON have subtypes. A VIEW subtype gives the name of the particular VIEW expected by the service. Application types and subtypes can also be added (see tuxtypes(5)). For a buffer type that has subtypes, “*” can be specified for the subtype to indicate that the service accepts all subtypes for the associated buffer type.

A single service can only interpret a fixed number of buffer types, namely those found in its buffer type switch (see tuxtypes(5)). If the tuxTsvcBufType value is set to ALL, that service accepts all buffer types found in its buffer type switch.

A type name can be 8 characters or less in length and a subtype name can be 16 characters or less in length. Note that type and subtype names should not contain semicolon, colon, comma, or asterisk characters.

Note: The tuxTsvcBufType value represents the buffer types that must be supported by each and every instance of an application service with this service name. Since this object value is processed at service activation time, updates to this object are allowed only when there are no active tuxTsvcGrp objects with matching service names.

 


tuxTsvcRoutingName

Syntax

DisplayString (SIZE(0..15))

Access

read-write

Description

This tuxTsvcTbl object has the indicated routing criteria name. Active updates to this object are reflected in all associated tuxTsvcGrp objects.

 


tuxTsvcEncryptionRequired

Syntax

INTEGER { yes(1) | no(2) }

Access

read-write

Description

If set to yes, every application service in this group requires an encrypted input message buffer.

 


tuxTsvcSignatureRequired

Syntax

INTEGER { yes(1) | no(2) }

Access

read-write

Description

If set to yes, every application service in this group requires a valid digital signature on its input message buffer.

 


tuxTsvcGrp

The tuxTsvcGrp group contains objects that represent configuration and run-time characteristics of services/groups within an application. The object values identify and characterize configured services/groups as well as provide run-time tracking of statistics and resources associated with each object.

Both tuxTsvcTbl and tuxTsvcGrp define activation time object values for service names within the application. When a new service is activated (advertised), either due to initial activation of a server or due to a call to tpadvertise(3), the following hierarchy exists for determining the object values to be used at service startup time.

  1. If a matching configured tuxTsvcGrp entry exists (matching service name and server group), the objects defined in that object are used to initially configure the advertised service.
  2. Otherwise, if a matching configured tuxTsvcTbl entry exists (matching service name), the objects defined in that object are used to initially configure the advertised service.
  3. Otherwise, if any configured tuxTsvcGrp entries are found with matching service name value, the first one found is used to initially configure the advertised service.
  4. If none of the preceding cases is used, the system defaults for service objects are used to initially configure the advertised service.

Objects in this group are only accessible through a Tuxedo SNMP agent installed on the local machine.

To create a new row in the table, it is necessary to issue a SET request that specifies at least tuxTsvcGrpName. The combination of values specified for tuxTsvcGrpName and tuxTsvcGrpSvcName in the SET request should not correspond to an existing row. If the value of tuxTsvcSrvrId is zero in the SET request, the service entry is configured but not activated (advertised). If tuxTsvcSrvrId is not set to zero, the service is activated using the value of tuxTsvcSrvrId to identify the server instance.

Object Name
Object ID
tuxTsvcGrpSvcName
.1.3.6.1.4.1.140.300.10.2.1.1
tuxTsvcGrpName
.1.3.6.1.4.1.140.300.10.2.1.2
tuxTsvcGrpNo
.1.3.6.1.4.1.140.300.10.2.1.3
tuxTsvcGrpState
.1.3.6.1.4.1.140.300.10.2.1.4
tuxTsvcGrpAutoTran
.1.3.6.1.4.1.140.300.10.2.1.5
tuxTsvcGrpLoad
.1.3.6.1.4.1.140.300.10.2.1.6
tuxTsvcGrpPrio
.1.3.6.1.4.1.140.300.10.2.1.7
tuxTsvcGrpSvcTimeOut
.1.3.6.1.4.1.140.300.10.2.1.8
tuxTsvcGrpTranTime
.1.3.6.1.4.1.140.300.10.2.1.9
tuxTsvcSrvrLmid
.1.3.6.1.4.1.140.300.10.2.1.10
tuxTsvcSrvrRqAddr
.1.3.6.1.4.1.140.300.10.2.1.11
tuxTsvcSrvrId
.1.3.6.1.4.1.140.300.10.2.1.12
tuxTsvcrName
.1.3.6.1.4.1.140.300.10.2.1.13
tuxTsvcSrvrNcompleted
.1.3.6.1.4.1.140.300.10.2.1.14
tuxTsvcSrvrNqueued
.1.3.6.1.4.1.140.300.10.2.1.15

 


tuxTsvcGrpSvcName

Syntax

DisplayString (SIZE(1..15))

Access

read-only

Description

Service name.

 


tuxTsvcGrpName

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Server group name. Server group names cannot contain an asterisk.

 


tuxTsvcGrpNo

Syntax

INTEGER (1..29999)

Access

read-write

Description

Server group number.

 


tuxTsvcGrpState

Syntax

INTEGER { active(1) | inactive(2) | invalid(3) }

Access

read-write

Description

The values for GET and SET operations are as follows:

GET: active(1)|inactive(2)

A GET operation retrieves configuration information for the selected tuxTsvcGrpState instance(s). The following states indicate the meaning of a tuxTsvcGrpState returned in response to a GET request. States not listed are not returned.

active(1)

At least one instance is active, suspended, or partitioned.

inactive(2)

tuxTsvcGrp instance defined and inactive.

SET: invalid(3)

A SET operation removes the corresponding tuxTsvcGrp instance. When a tuxTsvcGrp instance is deleted it also removes the associated tuxTsvcSrvr instances that correspond to server instances that are a part of the group advertising this service. This transition is permissible only in inactive(2) state.

 


tuxTsvcGrpAutoTran

Syntax

INTEGER { yes(1) | no(2) }

Access

read-write

Description

Automatically begin a transaction (yes(1)) when a service request message is received for this service if the request is not already in transaction mode.

 


tuxTsvcGrpLoad

Syntax

INTEGER (1..32767)

Access

read-write

Description

This tuxTsvcGrp instance imposes the indicated load on the system. Service loads are used for load balancing purposes, that is, queues with higher enqueued workloads are less likely to be chosen for a new request.

 


tuxTsvcGrpPrio

Syntax

INTEGER (1..100)

Access

read-write

Description

This tuxTsvcGrp object has the indicated dequeuing priority. If multiple service requests are waiting on a queue for servicing, the higher priority requests are serviced first.

 


tuxTsvcGrpSvcTimeOut

Syntax

INTEGER

Access

read-write

Description

Time limit (in seconds) for processing requests for this service name. Servers processing service requests for this service are abortively terminated (kill -9) if they exceed the specified time limit in processing the request. A value of 0 for this object indicates that the service should not be abortively terminated.

 


tuxTsvcGrpTranTime

Syntax

INTEGER

Access

read-write

Description

Transaction timeout value (in seconds) for transactions automatically started for this tuxTsvcGrp instance. Transactions are started automatically when a request not in transaction mode is received and the tuxTsvcGrpAutoTran object value for the service is yes(1).

 


tuxTsvcSrvrLmid

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Current logical machine on which an active server that offers this service is running.

 


tuxTsvcSrvrRqAddr

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Symbolic address of the request queue for an active server that offers this service. See tuxTsrvrRqAddr for more information on this object.

 


tuxTsvcSrvrId

Syntax

INTEGER (1..30000)

Access

read-write

Description

Server ID of which the service is a part. The user can also set the value of this object to activate (advertise) one or more tuxTsvcGrp instances. The value provided to set this object is used to activate another instance of tuxTsvcGrp.

 


tuxTsvcrName

Syntax

DisplayString (SIZE(1..127))

Access

read-write

Description

Function name within the associated server assigned to process requests for this service. When this object is specified, the tuxTsvcGrp instance is activated (advertised). The user needs to specify the server ID of the corresponding server instance (tuxTsvcSrvrId) in the SNMP index. This object can be updated only during row creation.

 


tuxTsvcSrvrNcompleted

Syntax

INTEGER

Access

read-only

Description

Number of service requests completed with respect to the retrieved active or suspended instance since it was activated (advertised).

Note: The tuxTsvcSrvrNcompleted value is returned only when tuxTdomainLoadBalance is equal to yes(1).

 


tuxTsvcSrvrNqueued

Syntax

INTEGER (0..32767)

Access

read-only

Description

Number of requests currently enqueued to this service. The tuxTsvcSrvrNqueued value is incremented at enqueue time and decremented when the server dequeues the request.

Note: The tuxTsvcSrvrNqueued value is returned only when tuxTdomainModel is set to single-machine(1) and tuxTdomainLoadBalance is set to yes(1).

 


tuxTlistenTbl

The tuxTlistenTbl group contains objects that represent run-time characteristics of Tuxedo listener processes for a distributed application.

Object Name
Object ID
tuxTlistenLmid
.1.3.6.1.4.1.140.300.21.1.1.1
tuxTlistenState
.1.3.6.1.4.1.140.300.21.1.1.2

 


tuxTlistenLmid

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Logical machine identifier.

 


tuxTlistenState

Syntax

INTEGER { inactive(2) | active(1) }

Access

read-only

Description

The values for GET and SET operations are as follows:

GET: {active(1)|inactive(2)}

A GET operation retrieves run-time information for the selected tuxTlistenTbl instance(s). The following states indicate the meaning of a tuxTlistenState returned in response to a GET request. States not listed are not returned.

active(1)

tuxTlistenTbl instance active.

inactive(2)

tuxTlistenTbl instance not active.

 


tuxTranTbl

The tuxTranTbl group contains objects that represent run-time characteristics of active transactions within the application. The following objects comprise the index for rows in this table: tuxTranIndx1, tuxTranIndx2, tuxTranIndx3, tuxTranIndx4, tuxTranIndx5. Objects in this table are accessible only through a Tuxedo SNMP agent running on the local machine.

 


tuxTranCoordLmid

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Logical machine identifier of the server group responsible for coordinating the transaction.

 


tuxTpTranId

Syntax

DisplayString (SIZE(2..78))

Access

read-only

Description

Transaction identifier as returned from tpsuspend(3) mapped to a string representation. The data in this field should not be interpreted directly by the user except for equality comparison.

 


tuxTranXid

Syntax

DisplayString (SIZE(2..78))

Access

read-only

Description

Transaction identifier as returned from tx_info(3) mapped to a string representation. The data in this field should not be interpreted directly by the user except for equality comparison.

 


tuxTranIndx1

Syntax

INTEGER

Access

read-only

Description

This number is purely for unique indexing of this table.

 


tuxTranIndx2

Syntax

INTEGER

Access

read-only

Description

This number is purely for unique indexing of this table.

 


tuxTranIndx3

Syntax

INTEGER

Access

read-only

Description

This number is purely for unique indexing of this table.

 


tuxTranIndx4

Syntax

INTEGER

Access

read-only

Description

This number is purely for unique indexing of this table.

 


tuxTranIndx5

Syntax

INTEGER

Access

read-only

Description

This number is purely for unique indexing of this table.

 


tuxTranState

Syntax

INTEGER { active(1) | abort-only(2) | aborted(3) | com-called(4) |ready(5) | decided(6) | suspended(7) }

Access

read-write

Description

The values for GET and SET operations are as follows:

GET: active(1)|abort-only(2)|aborted(3)|com-called(4)|ready(5)|
decided(6)|suspended(7)

A GET operation retrieves run-time information for the selected tuxTranTbl instance(s). The following states indicate the meaning of a tuxTranState object. States not listed are not returned. Note that distinct objects pertaining to the same global transaction (equivalent transaction identifiers) can indicate differing states. In general, the state indicated on the coordinator’s site (tuxTranCoordLmid) indicates the true state of the transaction. The exception is when a noncoordinator site notices a condition that transitions the transaction state to abort-only(2). This transition is eventually propagated to the coordinator site and results in the rollback of the transaction, but this change cannot be immediately reflected on the coordinator site.

active(1)

The transaction is active.

abort-only(2)

The transaction has been identified for rollback on the retrieval site.

aborted(3)

The transaction has been identified for rollback and rollback has been initiated on the retrieval site.

com-called(4)

The initiator of the transaction has called tpcommit(3) and the first phase of two-phase commit has begun on the retrieval site.

ready(5)

All of the participating groups on the retrieval site have successfully completed the first phase of two-phase commit and are ready to be committed.

decided(6)

The second phase of the two-phase commit has begun on the retrieval site.

suspended(7)

The initiator of the transaction has suspended processing on the transaction. Note that this state is returned from the initiator’s site only.

SET: aborted(3)

A SET operation updates run-time information for the selected tuxTranTbl instance. The following state indicates the meaning of a tuxTranState set in a SET request. States not listed cannot be set.

aborted(3)

Abort the tuxTranTbl instance for the application. State change is allowed only when the transaction is in the active(1), abort-only(2), or com-called(4) state. Cannot be accompanied by a change to tuxTranGstate. Successful return leaves the object in the aborted(3) state.

 


tuxTranTimeOut

Syntax

INTEGER

Access

read-only

Description

Time left (in seconds) before the transaction times out on the retrieval site. Note that the tuxTranTimeOut value is returned only when the transaction state is active(1).

 


tuxTranGrpCnt

Syntax

INTEGER

Access

read-only

Description

Number of groups identified as participants in the transaction by the information returned from the retrieval site.

 


tuxTranGrpIndex

Syntax

INTEGER

Access

read-only

Description

Index of the first group-specific object values (tuxTranGrpNo and tuxTranGstate) corresponding to this object.

 


tuxTranGrpNo

Syntax

INTEGER

Access

read-only

Description

Group number of the participating group.

 


tuxTranGstate

Syntax

INTEGER { active(1) | aborted(2) | rd-only(3) | ready(4) | hcommit(5) | habort(6) | done(7) | pre-prepare(8) | post-abort(9) | post-commit(10) | unknown(11) )

Access

read-write

Description

The values for GET and SET operations are as follows:

GET: active(1)|aborted(2)|rd-only(3)|ready(4)|hcommit(5)|habort(6)
|done(7)

A GET operation retrieves run-time information for the selected tuxTranTbl instance(s) pertaining to the indicated group. The following states indicate the meaning of a tuxTranGstate returned in response to a GET request. States not listed are not returned. Note that distinct objects pertaining to the same global transaction (equivalent transaction identifiers) can indicate differing states for individual groups. In general, the state indicated on the group’s site indicates the true state of the group’s participation in the transaction. The exception is when the coordinator site determines that the transaction should abort and sets each participant group state to aborted(2). This transition is propagated to the group’s site and results in the rollback of the group’s work in the transaction, but cannot be reflected immediately

active(1)

The transaction is active in the indicated group.

aborted(2)

The transaction has been identified for rollback and rollback has been initiated for the indicated group.

rd-only(3)

The group has successfully completed the first phase of two-phase commit and has performed only read operations on the resource manager, thus making it unnecessary to perform the second phase of commit for this group.

ready(4)

The group has successfully completed the first phase of two-phase commit and is ready to be committed.

hcommit(5)

The group has been heuristically committed. This state might or might not agree with the final resolution of the transaction.

habort(6)

The group has been heuristically rolled back. This state might or might not agree with the final resolution of the transaction.

done(7)

This group has completed the second phase of the two-phase commit.

pre-prepare(8)

Indicates that the transaction group contains Tuxedo servers that have called xa_end (TMSUSPEND) during the course of transactional work and that commit processing is beginning. This state exists until either (1) all servers that called xa_end (TMSUSPEND) have caused a call to xa_end (TMSUCCESS), at which point the group state becomes ready, or (2) one of the target servers does a rollback of the transaction, at which point the group state becomes either post-abort(9) or aborted(2).
Note: This state is supported only for Tuxedo 8.0 or later applications.

post-abort(9)

Indicates that a Tuxedo server called xa_end (TPFAIL) and that the TMS has not yet called xa_rollback(). In this case, other Tuxedo servers that called xa_end (TMSUSPEND) are being notified by the TMS in order to clean up their associated CORBA objects.
Note: This state is supported only for Tuxedo 8.0 or later applications.

post-commit(10)

This state is not implemented yet.
Note: This state is supported only for Tuxedo 8.0 or later applications.

SET: hcommit(5)| habort(6)

A SET operation updates run-time information for the first group in the originating request within the selected tuxTranTbl instance. The following states indicate the meaning of a tuxTranGstate set in a SET request. States not listed cannot be set. State transitions are allowed only when performed within the object representing the group’s site.

hcommit(5)

Heuristically commit the group’s work as part of the indicated transaction. State change is allowed only when tuxTranGstate is ready, tuxTranState is ready, and the indicated group is not on the coordinator’s site. Successful return leaves the object in the hcommit(5) state.

habort(6)

Heuristically rollback the group’s work as part of the indicated transaction. State change is allowed only when tuxTranGstate is active(1) or ready(4), tuxTranState is ready(4), and the indicated group is not on the coordinator’s site. Successful return leaves the object in the habort(6) state.

 


tuxTulogTable

The tuxTulogTable group contains objects that represent run-time characteristics of userlog (ULOG) files within an application. The index into this table is tuxTulogSerNo. The values returned for objects in this table are controlled by the MIB control group tuxTulogCtrl.

Object Name
Object ID
tuxTulogSerNo
.1.3.6.1.4.1.140.300.9.1.1.1
tuxTulogLmid
.1.3.6.1.4.1.140.300.9.1.1.2
tuxTulogPmid
.1.3.6.1.4.1.140.300.9.1.1.3
tuxTulogMmDdYy
.1.3.6.1.4.1.140.300.9.1.1.4
tuxTulogTime
.1.3.6.1.4.1.140.300.9.1.1.5
tuxTulogLine
.1.3.6.1.4.1.140.300.9.1.1.6
tuxTulogMsg
.1.3.6.1.4.1.140.300.9.1.1.7
tuxTulogTpTranId
.1.3.6.1.4.1.140.300.9.1.1.8
tuxTulogXid
.1.3.6.1.4.1.140.300.9.1.1.9
tuxTulogPid
.1.3.6.1.4.1.140.300.9.1.1.10
tuxTulogSeverity
.1.3.6.1.4.1.140.300.9.1.1.11
tuxTulogCat
.1.3.6.1.4.1.140.300.9.1.1.12
tuxTulogMsgNum
.1.3.6.1.4.1.140.300.9.1.1.13
tuxTulogProcName
.1.3.6.1.4.1.140.300.9.1.1.14
tuxTulogThreadID
.1.3.6.1.4.1.140.300.9.1.1.20
tuxTulogContextID
.1.3.6.1.4.1.140.300.9.1.1.30

 


tuxTulogSerNo

Syntax

INTEGER

Access

read-only

Description

A running serial number for the rows in tuxTulogTable.

 


tuxTulogLmid

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Retrieval machine logical machine identifier.

 


tuxTulogPmid

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Physical machine identifier.

 


tuxTulogMmDdYy

Syntax

INTEGER

Access

read-only

Description

Month, day, and year of the log file.

 


tuxTulogTime

Syntax

INTEGER

Access

read-only

Description

Time at which the message was generated.

 


tuxTulogLine

Syntax

INTEGER

Access

read-only

Description

Line number of the message in the log file.

 


tuxTulogMsg

Syntax

DisplayString (SIZE(1..256))

Access

read-only

Description

The entire text of the userlog message as it appears in the userlog file.

 


tuxTulogTpTranId

Syntax

DisplayString (SIZE(1..78))

Access

read-only

Description

Transaction identifier as returned from tpsuspend(3). The data in this field should not be interpreted directly by the user except for equality comparison. Messages not associated with transactions retrieve a 0-length string as the value for this object.

 


tuxTulogXid

Syntax

DisplayString (SIZE(1..78))

Access

read-only

Description

Transaction identifier as returned from tx_info(3). The data in this field should not be interpreted directly by the user except for equality comparison. Messages not associated with transactions retrieve a 0-length string as the value for this object.

 


tuxTulogPid

Syntax

INTEGER

Access

read-only

Description

Process identifier of the client or server that generated the userlog message.

 


tuxTulogSeverity

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Severity of message, if any.

 


tuxTulogCat

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Catalog name from which the message was derived, if any.

 


tuxTulogMsgNum

Syntax

INTEGER

Access

read-only

Description

Catalog message number, if the message was derived from a catalog.

 


tuxTulogProcName

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Process name of the client or server that generated the userlog message.

 


tuxTulogThreadID

Syntax

INTEGER

Access

read-only

Description

Identifier for the thread that wrote this userlog message.

 


tuxTulogContextID

Syntax

INTEGER

Access

read-only

Description

Identifier for this particular application association.

 


tuxTulogCtrl

The tuxTulogCtrl group contains objects that control the userlog (ULOG) messages returned by the tuxTulogTable.

Object Name
Object ID
tuxTulogLmidCtrl
.1.3.6.1.4.1.140.300.9.2.1
tuxTulogPmidCtrl
.1.3.6.1.4.1.140.300.9.2.2
tuxTulogMmddyyCtrl
.1.3.6.1.4.1.140.300.9.2.3
tuxTulogTimeCtrl
.1.3.6.1.4.1.140.300.9.2.4
tuxTulogEndTimeCtrl
.1.3.6.1.4.1.140.300.9.2.5
tuxTulogLineCtrl
.1.3.6.1.4.1.140.300.9.2.6
tuxTulogMsgCtrl
.1.3.6.1.4.1.140.300.9.2.7
tuxTulogTptranIdCtrl
.1.3.6.1.4.1.140.300.9.2.8
tuxTulogXidCtrl
.1.3.6.1.4.1.140.300.9.2.9
tuxTulogPidCtrl
.1.3.6.1.4.1.140.300.9.2.10
tuxTulogSeverityCtrl
.1.3.6.1.4.1.140.300.9.2.11
tuxTulogCatCtrl
.1.3.6.1.4.1.140.300.9.2.12
tuxTulogMsgNumCtrl
.1.3.6.1.4.1.140.300.9.2.13
tuxTulogProcNameCtrl
.1.3.6.1.4.1.140.300.9.2.14

 


tuxTulogLmidCtrl

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Logical machine ID to qualify machine from where the userlog file is read for tuxTulogTable. By default, the ULOG files from the local host are returned, in accordance to the ULOGPFX. To revert to the default setting, set this object to null.

 


tuxTulogPmidCtrl

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Physical machine name to qualify the source machine for userlog messages to be listed in tuxTulogTable. By default, messages from all hosts within ULOG files qualified by tuxTulogLmidCtrl are returned. To revert to the default setting, set this object to null.

 


tuxTulogMmddyyCtrl

Syntax

INTEGER

Access

read-write

Description

Date value to qualify userlog messages listed in tuxTulogTable. Default value is current date. To reset the value of the qualifier to its default, set this object to 0.

 


tuxTulogTimeCtrl

Syntax

INTEGER

Access

read-write

Description

Starting time of the time range for which the userlog messages are listed in tuxTulogTable. This number is calculated as under - “hrs*10000 + mins*100 + secs”. The default value is 0.

 


tuxTulogEndTimeCtrl

Syntax

INTEGER

Access

read-write

Description

Ending time of the time range for which the userlog messages are listed in tuxTulogTable. This number is calculated as under - “hrs*10000 + mins*100 + secs”. By default, the maximum value is considered. To revert to the default setting, set this object to 0.

 


tuxTulogLineCtrl

Syntax

INTEGER

Access

read-write

Description

Beginning line number from which the userlog messages are listed in tuxTulogTable. By default, all messages are returned. To revert to the default setting, set this object to 0.

 


tuxTulogMsgCtrl

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Regular expression to qualify userlog messages listed in tuxTulogTable on the basis of the message body. By default, all messages are listed. To revert to the default setting, set this object to null.

 


tuxTulogTptranIdCtrl

Syntax

DisplayString (SIZE(1..78))

Access

read-write

Description

Value of tuxTpTranId to qualify messages to be displayed in the in tuxTulogTable. By default, all messages are returned. To revert to the default setting, set it to null.

 


tuxTulogXidCtrl

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Value of tuxTranXid to qualify messages to be displayed in the in tuxTulogTable. By default, all messages are returned. To revert to the default setting, set it to null.

 


tuxTulogPidCtrl

Syntax

INTEGER

Access

read-write

Description

Value of process Id of the source to qualify messages to be displayed in the tuxTulogTable. By default, messages with any pid are listed. To revert to the default setting, set this object to 0.

 


tuxTulogSeverityCtrl

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Regular expression to qualify userlog messages to be listed in tuxTulogTable on the basis of message severity, if any. By default, messages with any severity are listed. To revert to the default setting, set this object to null.

 


tuxTulogCatCtrl

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Regular expression to qualify userlog messages to be listed in tuxTulogTable on the basis of the catalog name, if any. By default, messages from all catalogs are listed. To revert to the default setting, set this object to null.

 


tuxTulogMsgNumCtrl

Syntax

INTEGER

Access

read-write

Description

Message number in catalog to qualify userlog messages to be listed in tuxTulogTable. By default, all message numbers are returned. To revert to the default setting, set this object to 0.

 


tuxTulogProcNameCtrl

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Regular expression to qualify userlog messages to be listed in tuxTulogTable on the basis of the process name that generated the message, if known. By default, all messages are returned. To revert to the default setting, set this object to null.

 


tuxTnetGrpTbl

The tuxTnetGrpTbl group contains objects that represent application characteristics of network groups. Network groups are groups of logical machine IDs that can communicate over the network address defined in the tuxTnetMapNaddr object in the tuxTnetMapTbl table entry. For row creation, a SET request with tuxTnetGrpName, tuxTnetGrpNo, and tuxTnetGrpPrio is required. tuxTnetGrpNo provides the index into this table.

Object Name
Object ID
tuxTnetGrpName
.1.3.6.1.4.1.140.300.28.1.1
tuxTnetGrpNo
.1.3.6.1.4.1.140.300.28.1.2
tuxTnetGrpState
.1.3.6.1.4.1.140.300.28.1.3
tuxTnetGrpPrio
.1.3.6.1.4.1.140.300.28.1.4

 


tuxTnetGrpName

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Logical name of the network group. A group name is a string of printable characters and cannot contain a pound sign (#), comma (,), colon (:), or newline character. This object can be updated only during row creation.

 


tuxTnetGrpNo

Syntax

INTEGER (1..8191)

Access

read-write

Description

Group identifier of the network group. This object can be updated only during row creation.

 


tuxTnetGrpState

Syntax

INTEGER { valid(1) | invalid(2) }

Access

read-write

Description

A GET request retrieves configuration information for the selected tuxTnetGrpTbl instance (or instances). The following states indicate the meaning of the value that is returned:

GET: valid(1)

The instance is defined. This state is the only valid state for this object.

SET: invalid(2)

Delete the selected tuxTnetGrpTbl instance from the application.

States not listed are not returned.

 


tuxTnetGrpPrio

Syntax

INTEGER (1..8191)

Access

read-write

Description

The priority band for this network group. All network groups that have an equivalent band priority are used in parallel.

 


tuxTnetMapTbl

The instances in the tuxTnetMapTbl associate tuxTmachineLmids to an instance in the tuxTnetGrpTbl. The rows in this table identify which logical machines belong to which network groups. For row creation, a SET request with at least tuxTnetMapNaddr is needed. The index into this table is provided by tuxTnetMapGrpNo and tuxTnetMapLmid.

Object Name
Object ID
tuxTnetMapGrpName
.1.3.6.1.4.1.140.300.33.1.1
tuxTnetMapGrpNo
.1.3.6.1.4.1.140.300.33.1.2
tuxTnetMapLmid
.1.3.6.1.4.1.140.300.33.1.3
tuxTnetMapState
.1.3.6.1.4.1.140.300.33.1.4
tuxTnetMapNaddr
.1.3.6.1.4.1.140.300.33.1.5
tuxTnetMapMinEncryptBit
.1.3.6.1.4.1.140.300.33.1.6
tuxTnetMapMaxEncryptBit
.1.3.6.1.4.1.140.300.33.1.7

 


tuxTnetMapGrpName

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

The logical name of the network group. A group name is a string of printable characters and cannot contain a pound sign (#), comma (,), colon (:), or a newline character.

 


tuxTnetMapGrpNo

Syntax

INTEGER (1..8191)

Access

read-write

Description

Identifier for this logical network group. This object can be updated only during row creation.

 


tuxTnetMapLmid

Syntax

DisplayString (SIZE(1..30))

Access

read-write

Description

Logical machine name for this network mapping. This object can be updated only during row creation.

 


tuxTnetMapState

Syntax

INTEGER { valid(1) | invalid(2) }

Access

read-write

Description

A GET request retrieves configuration information for the selected tuxTnetMapTbl instance (or instances). The following states indicate the meaning of the value of tuxTnetMapState that is returned:

GET: valid(1)

The instance is defined. This state is the only valid state for this object.

SET: invalid(2)

Delete the selected tuxTnetMapTbl instance from the application. If any network links are active as a result of the mapping, they are disconnected. This disconnection can cause a state change in tuxTBridgeTbl instances associated with the network links.

States not listed are not returned.

 


tuxTnetMapNaddr

Syntax

DisplayString (SIZE(1..256)) (up to 78 bytes for Oracle Tuxedo 8.0 or earlier)

Access

read-write

Description

Specifies the complete network address to be used by the BRIDGE process placed on the logical machine as its listening address. The listening address for a BRIDGE is the means by which it is contacted by other BRIDGE processes participating in a networked application, that is, if the value of tuxTdomainOptions is lan(1). If the string is of the form 0xhex-digits or \\xhex-digits, it must contain an even number of valid hexadecimal digits. These forms are translated internally into a character array containing the hexadecimal representation of the string specified. For TCP/IP addresses, either the //hostname:port or #.#.#.#:port format is used.

 


tuxTnetMapMinEncryptBit

Syntax

INTEGER { none(1) | 40-bit(2) | 128-bit(3) | unknown(4) }

Access

read-write

Description

Specifies the required level of encryption when establishing a network link to this machine.

none(1)

No encryption

40-bit(2) and 128-bit(3)

These values specify the encryption key length (in bits). If this minimum level of encryption cannot be met, the attempt to establish the link fails.

The default value is none(1). Modifications to this object do not affect network links that have already been established.

 


tuxTnetMapMaxEncryptBit

Syntax

INTEGER {none(1) | 40-bit(2) | 128-bit(3) | unknown(4) }

Access

read-write

Description

Encryption can be negotiated up to the specified level when establishing a network link.

none(1)

No encryption

40-bit(2) and 128-bit(3)

These values specify the encryption key length (in bits).

The default value is 128-bit(3). Modifications to this object do not affect network links that are already established.

 


tuxTserverCtxtTbl

The tuxTserverCtxtTbl group contains objects that represent configuration and run-time characteristics of individual server dispatch contexts within an application. This group is defined for both single-context and multi-context servers. For single-context servers, the object values in this group are repeated as part of the tuxTsrvrTbl group. The objects in this group are read-only.

These object values provide run-time tracking of statistics and resources associated with each server dispatch context.

Object Name
Object ID
tuxTserverCtxtGrp
.1.3.6.1.4.1.140.300.34.1.1.10
tuxTserverCtxtServerID
.1.3.6.1.4.1.140.300.34.1.1.20
tuxTserverCtxtContextID
.1.3.6.1.4.1.140.300.34.1.1.30
tuxTserverCtxtCltLmId
.1.3.6.1.4.1.140.300.34.1.1.40
tuxTserverCtxtCltPid
.1.3.6.1.4.1.140.300.34.1.1.50
tuxTserverCtxtCltReply
.1.3.6.1.4.1.140.300.34.1.1.60
tuxTserverCtxtCmtRet
.1.3.6.1.4.1.140.300.34.1.1.70
tuxTserverCtxtCurConv
.1.3.6.1.4.1.140.300.34.1.1.80
tuxTserverCtxtCurReq
.1.3.6.1.4.1.140.300.34.1.1.90
tuxTserverCtxtCurService
.1.3.6.1.4.1.140.300.34.1.1.100
tuxTserverCtxtLastGrp
.1.3.6.1.4.1.140.300.34.1.1.110
tuxTserverCtxtSvcTimeOut
.1.3.6.1.4.1.140.300.34.1.1.120
tuxTserverCtxtTimeLeft
.1.3.6.1.4.1.140.300.34.1.1.130
tuxTserverCtxtTranLev
.1.3.6.1.4.1.140.300.34.1.1.140

 


tuxTserverCtxtGrp

Syntax

DisplayString (SIZE(1..30))

Access

read-only

Description

Logical name of the server group. Server group names cannot contain an asterisk (*), comma (,), or colon (:).

 


tuxTserverCtxtServerID

Syntax

INTEGER (SIZE(1..30000))

Access

read-only

Description

Unique (within the server group) server identification number.

 


tuxTserverCtxtContextID

Syntax

INTEGER (SIZE(-2..29999))

Access

read-only

Description

Identifier of this particular server context.

 


tuxTserverCtxtCltLmId

Syntax

INTEGER (SIZE(1..30))

Access

read-only

Description

Logical machine for the initiating client or server. The initiating client or server is the process that made the service request on which the server is currently working.

 


tuxTserverCtxtCltPid

Syntax

INTEGER

Access

read-only

Description

UNIX system process identifier for the initiating client or server.

Limitation: This object is a UNIX-system-specific object that cannot be returned if the platform on which the application is being run is not UNIX-based.

 


tuxTserverCtxtCltReply

Syntax

INTEGER { yes(1) | no(2) }

Access

read-only

Description

The initiating client or server is expecting a reply (yes(1)) or is not expecting a reply (no(2)).

 


tuxTserverCtxtCmtRet

Syntax

INTEGER { complete(1) | logged(2) }

Access

read-only

Description

This object value is the setting of the TP_COMMIT_CONTROL characteristic for this server.

See the description of the Oracle Tuxedo ATMI function tpscmt(3c) for details on this characteristic.

 


tuxTserverCtxtCurConv

Syntax

INTEGER

Access

read-only

Description

Number of conversations initiated by this server through tpconnect() that are still active.

 


tuxTserverCtxtCurReq

Syntax

INTEGER

Access

read-only

Description

Number of requests initiated by this server through tpcall() or tpacall() that are still active.

 


tuxTserverCtxtCurService

Syntax

DisplayString (SIZE (1..127))

Access

read-only

Description

Service name, if any, on which the server is currently working.

 


tuxTserverCtxtLastGrp

Syntax

INTEGER (1..29999)

Access

read-only

Description

Time left (in seconds), if any, for this server to process the current service request. A value of 0 for an active service indicates that no time out processing is being done.

See tuxTsvcTbl: tuxTsvcTimeOut for more information.

 


tuxTserverCtxtSvcTimeOut

Syntax

INTEGER

Access

read-only

Description

Server group number (tuxTgroupTable: tuxTgroupNo) of the last service request made or conversation initiated from this server outward.

 


tuxTserverCtxtTimeLeft

Syntax

INTEGER

Access

read-only

Description

Time left (in seconds) for this server to receive the reply for which it is currently waiting before it will time out. This timeout can be a transactional timeout or a blocking timeout.

 


tuxTserverCtxtTranLev

Syntax

INTEGER

Access

read-only

Description

Current transaction level for this server. 0 indicates that the server is not currently involved in a transaction.

 


beaEventFilters

You can use the Tuxedo event filters to define a subset of Tuxedo event notifications to be generated for each Tuxedo domain being monitored. The beaEventFilters group consists of the following object and group (table).

Object Name
Object ID
beaEvtFilterTblStatus
.1.3.6.1.4.1.140.300.14.1
beaEvtFilterTable
.1.3.6.1.4.1.140.300.14.2

 


beaEvtFilterTblStatus

Syntax

INTEGER { sync(1) | dirty(2) }

Access

read-write

Description

When the agent starts, this object value is always sync(1). If any change is done to beaEvtFilterTable through SET requests, the value of this object becomes dirty(2) and the changes made to beaEvtFilterTable do not take effect. The changes made to the beaEvtFilterTable take effect only when you set the value of this object to sync(1). When you set the value to sync(1), all changes since the last synchronization are applied to the event-processing module.

beaEvtFilterTable

The beaEvtFilterTable group contains objects that represent all the event filters defined for the SNMP Agent. The object values are used to determine the collection of events to be forwarded as SNMP trap notifications.

The columnar objects in the beaEvtFilterTable correspond to fields in the TMEVENT_FILTER entries in the Oracle SNMP Agent configuration file (beamgr.conf). For more detail, see “Configuration Files” in the Oracle SNMP Agent Administration Guide.

Note: Changes to this table are applied only when beaEvtFilterStatus is set to sync(1).

Object Name
Object ID
beaEvtFilterId
.1.3.6.1.4.1.140.300.14.1.1.1
beaEvtAgentName
.1.3.6.1.4.1.140.300.14.1.1.2
beaEvtExpr
.1.3.6.1.4.1.140.300.14.1.1.3
beaEvtFilter
.1.3.6.1.4.1.140.300.14.1.1.4
beaEvtFilterState
.1.3.6.1.4.1.140.300.14.1.1.5

 


beaEvtFilterId

Syntax

DisplayString (SIZE(1..16))

Access

read-write

Description

A unique identifier for the event filter within the filter table.

Note: This object can be SET only during row creation.

 


beaEvtAgentName

Syntax

DisplayString (SIZE (1..32))

Access

read-only

Description

This logical agent name of the agent supporting this filter. This object is provided only for user convenience since the MIB only returns the event filters for the agent that was queried.

 


beaEvtExpr

Syntax

DisplayString (SIZE (1..255))

Access

read-write

Description

An event name expression, which is a regular expression. For the format of regular expressions, see reference page tpsubscribe(3c) in Oracle Tuxedo ATMI C Function Reference. For a Tuxedo system event to be forwarded as an SNMP trap, its name should match this expression. For a list of Tuxedo event names, see reference page EVENTS(5) in Oracle Tuxedo File Formats, Data Descriptions, MIBs, and System Processes Reference. The default for this object is all system events.

Examples

\.Sys.* 

matches all system events. (This event name expression is the default.)

\.SysServer.*

matches all system events related to servers.

A value of NONE blocks all events from being forwarded by the selected agent and overrides any other filter table entries for the same logical agent name.

 


beaEvtFilter

Syntax

DisplayString (SIZE(1..255))

Access

read-write

Description

An event filter expression. Each Tuxedo event is accompanied by an FML buffer that contains pertinent information about the event. The buffer’s contents are evaluated with respect to this filter, if it is present. The filter must evaluate to TRUE or the event is not forwarded.

The SNMP Agent uses this object as an argument to tpsubscribe(). For more information, see reference page tpsubscribe(3c) in Oracle Tuxedo ATMI C Function Reference.

Example

TA_EVENT_SEVERITY==’ERROR’ || TA_EVENT_SEVERITY==’WARN’

TA_EVENT_SEVERITY!==’INFO’

TA_EVENT_LMID==’SITE1’

This filter selects events with a severity of either ERROR or WARNING.

 


beaEvtFilterState

Syntax

INTEGER { active(1) | inactive(2) | invalid(3) }

Access

read-write

Description

This object denotes the current state of the event filter instance.

GET {active(1)|inactive(2)}

A GET operation retrieves configuration and run-time information for the selected beaEvtFilterTbl instance(s). The following states indicate the meaning of a beaEvtFilterState returned in response to a GET request. States not listed are not returned.

active(1)

This filter is being used.

inactive(2)

This filter is not being used.

SET {active(1)|inactive(2)|invalid(3)}

A SET operation updates configuration and run-time information for the selected beaEvtFilterTbl instance. The following states indicate the meaning of a beaEvtFilterState set in a SET request. States not listed cannot be set.

active(1)

Activate the event filter. Activating the event filter can be accomplished only when the filter is in the inactive(2) state.

inactive(2)

Inactivate the event filter. Inactivating the event filter can be accomplished only when the filter is in the active(1) state.

invalid(3)

Inactivate (if active) and remove this event filter.

  Back to Top       Previous  Next