MIB Reference

 

The following BEA Tuxedo management information bases (MIBS) have been added or enhanced for the WebLogic Enterprise product:

• T_IFQUEUE Class

• T_INTERFACE Class

• T_JDBCCONNPOOL Class

• T_ROUTING Class

• T_SERVER Class

This topic describes these MIBs.

T_IFQUEUE Class

O verview

The T_IFQUEUE MIB class represents runtime attributes of an interface as it pertains to a particular server queue (T_QUEUE). This is primarily a read-only class providing access to the inherited configuration attributes of an interface as well as statistics relating to the interface on the queue. Additionally, this class gives administrators finer granularity in suspending and activating interfaces. This class provides the link between an interface name and the server processes capable of processing method invocations on the interface, that is, TA_RQADDR can be used as a key search field on the T_SERVER class.

Attribute Table

T_IFQUEUE Class Definition Attribute Table

Attribute	Usage	Type	Permissions	Values	Default
TA_INTERFACENAME	*	string	R--R--R--	string[1..128]	N/A
TA_SRVGRP	*	string	R--R--R--	string[1..30]	N/A
TA_RQADDR	*	string	R--R--R--	string[1..30]	N/A
TA_STATE	k	string	R-XR-XR--	GET: "{ACT|SUS|PAR}" SET: "{ACT|SUS}"	N/A
TA_AUTOTRAN		string	R--R--R--	"{Y|N}"	N/A
TA_LOAD		long	R--R--R--	1 <= num < 32K	N/A
TA_PRIO		long	R--R--R--	1<= num < 101	N/A
TA_TIMEOUT		long	R--R--R--	0 <= num	N/A
TA_TRANTIME		long	R--R--R--	0 <= num	N/A
TA_FBROUTINGNAME		string	R--R--R--	string[1...15]	N/A
TA_LMID	k	string	R--R--R--	LMID	N/A
TA_NUMSERVERS		long	R--R--R--	0 <= num	N/A
TA_TPPOLICY		string	R--R--R--	"{method | transaction | process}"	N/A
TA_TXPOLICY		string	R-R-R--	"{always | never | optional | ignore}"	N/A
TA_NCOMPLETED	l	long	R-XR-XR--	0 <= num	N/A
TA_NQUEUED	l	long	R--R--R--	0 <= num	N/A
TA_CUROBJECTS	l	long	R--R--R--	0 <= num	N/A
TA_CURTRANSACTIONS	l	long	R--R--R--	0 <= num	N/A
( k ) - GET key field ( l ) - Local Field ( * ) - GET/SET key, one or more required for SET operations

Attribute Semantics

TA_INTERFACENAME: string[1..128]

The fully qualified interface name. The interface repository id for the interface. The format of this name is dependent on the options specified in the IDL which generates the interface implementation. See CORBA 2.1 Specification Section 7.6 [CORBA] for details.

TA_SRVGRP: string[0..30]

Server group name. Server group names cannot contain an asterisk, comma or colon.

TA_RQADDR: string[1..30]

Symbolic address of the request queue for an active server offering this interface. See T_SERVER:TA_RQADDR for more information on this attribute.

TA_STATE:

GET: {ACTive | SUSpended | PARtitioned}

A GET operation will retrieve configuration information for the selected T_IFQUEUE objects. The following states indicate the meaning of a TA_STATE returned in response to a GET request. States not listed will not be returned.

ACTive	T_IFQUEUE object represents an available interface in the running system.
SUSpended	T_IFQUEUE object represents a currently suspended interface in the running system.
PARtitioned	T_IFQUEUE object represents a currently partitioned interface in the running system.

SET: { ACTive | SUSpended}

The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

ACTive	Activate the T_IFQUEUE object. State change only allowed when in the SUSpended state. Successful return leaves object in ACTive state.
SUSpended	Suspend the T_IFQUEUE object. State change only allowed when in the ACTive state. Successful return leaves object in SUSpended state.

Limitation: Dynamic advertisement of interfaces (i.e., state change from INActive or INValid to ACTive) is not supported, nor is unadvertisement (i.e., state change from ACTive to INActive).

TA_AUTOTRAN: { Y | N }

Signifies whether a transaction will be automatically started for invocations made outside a transaction context. See T_INTERFACE description of this attribute for discussion of limitations regarding this attribute.

TA_LOAD: 1 <= num <= 32K

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

TA_PRIO: 1 <= num <= 101

This T_INTERFACE object has the indicated dequeuing priority. If multiple interface requests are waiting on a queue for servicing, the higher priority requests will be handled first.

TA_TIMEOUT: 0 <= num

Time limit (in seconds) for processing individual method invocations for this interface. Servers processing method invocations for this interface will be abortively terminated if they exceed the specified time limit in processing the request. A value of 0 for this attribute indicates that the server should not be abortively terminated.

TA_TRANTIME: 0 <= num

Transaction timeout value in seconds for transactions automatically started for this T_INTERFACE object. Transactions are started automatically when a requests not in transaction mode is received and the T_INTERFACE:TA_AUTOTRAN attribute value for the interface is "Y".

TA_FBROUTINGNAME: string[1..15]

The factory-based routing criteria associated with this interface.

TA_LMID: LMID

Current logical machine on which the queue offering this interface is located.

TA_NUMSERVERS: 0 <= num

Number of corresponding servers offering this interface on this queue.

TA_TPPOLICY: { method | transaction | process }

The TP framework deactivation policy. This reflects the policy registered with the framework at server startup. The first server to register the interface sets the value in T_INTERFACE. This value cannot be changed.

TA_TXPOLICY: { optional | always | never | ignore }

The transaction policy for the interface. The setting in this attribute affects the effect of the TA_AUTOTRAN attribute. See TA_AUTOTRAN for further explanation. This attribute is always read-only. It is set by the developer when the server is built and registered at server startup.

TA_NCOMPLETED: 0 <= num

Number of interface method invocations completed since the interface was initially offered.

TA_NQUEUED: 0 <= num

Number of requests currently enqueued for this interface.

TA_CUROBJECTS: 0 <= num

Number of active objects for this interface for associated queue. This number represents the number of entries in the active object table for this queue on the associated machine. This includes objects that are not in memory but that were invoked within an active transaction.

TA_CURTRANSACTIONS: 0 <= num

Number of active global transactions associated with this interface for its associated queue.

T_INTERFACE Class

Overview

The T_INTERFACE MIB class represents configuration and runtime attributes of CORBA interfaces at both the domain and server group levels.

A domain-level T_INTERFACE object is one that is not associated with a Server Group. Its TA_SRVGRP attribute contains a null string (string of length 0, "").

A server group level T_INTERFACE object is one that has an associated server group (i.e., its TA_SRVGRP attribute contains a valid server group name for the domain). This Server Group level representation of an interface also provides a container for managing interface state (TA_STATE) and for collecting accumulated statistics.

An associated server group level T_INTERFACE object must exist for any CORBA Interfaces that are activated in a server. The activation of interfaces in a server is controlled by the state of a T_IFQUEUE object for the interface. Activation of a T_IFQUEUE object causes its attributes to be initialized with the values specified for the associated server group level T_INTERFACE object. If such an object does not exist, then one will be dynamically created. This dynamically-created server group level T_INTERFACE object will be initialized with the attributes of the domain level T_INTERFACE object for the interface if one exists. If an associated domain level T_INTERFACE object does not exist, system specified default configuration values will be applied. Once activated, interfaces are always associated with a server group level T_INTERFACE object.

The specification of configuration attributes for interfaces at any level is completely optional, system defined defaults will be provided and run-time server group level T_INTERFACE objects will be created. Interfaces to be offered by a server are identified via the ICF file used to generate server skeletons and advertised automatically by the system at server activation time.

Attribute Table

T_INTERFACE Class Definition Attribute Table

Attribute	Usage	Type	Permissions	Values	Default
TA_INTERFACENAME TA_SRVGRP	r* r*	string string	ru-r--r-- ru-r--r--	string[1..128] string[0..30]	N/A N/A
TA_STATE	k	string	rwxr-xr--	GET: "{ACT | INA | SUS | PAR}" SET: "{NEW | INV | ACT | REA | SUS}"	N/A
TA_AUTOTRAN		string	rwxr-xr--	"{Y|N}"	"N"a
TA_LOAD		long	rwxr-xr--	1 <= num < 32K	501
TA_PRIO		long	rwxr-xr--	1<= num < 101	50a
TA_TIMEOUT		long	rwxr-xr--	0 <= num	0a
TA_TRANTIME		long	rwxr-xr--	0 <= num	30a
TA_FBROUTINGNAME		string	rwyr-yr--	string[1...15]	2
TA_LMID	k	string	R--R--R--	LMID	N/A
TA_NUMSERVERS		long	R--R--R--	0 <= num	N/A
TA_TPPOLICY		string	R--R--R--	"{method | transaction | process}"	N/A
TA_TXPOLICY		string	R-R-R--	"{always | never | optional | ignore}"	N/A
TA_NCOMPLETED	l	long	R-XR-XR--	0 <= num	N/A3
TA_NQUEUED	l	long	R--R--R--	0 <= num	N/A
( k ) - GET key field ( l ) - Local Field ( r ) - Required field for object creation (SET TA_STATE NEW) ( * ) - GET/SET key, one or more required for SET operations

1 Group level T_INTERFACE objects (TA_SRVGRP != "") determine their defaults from the domain level T_INTERFACE object with a matching TA_INTERFACENAME setting if one exists. The listed defaults apply if no domain level object exists or if a domain level object is being created. 2 All T_INTERFACE objects with the same TA_INTERFACENAME must have matching TA_FBROUTINGNAME values. Therefore, the default for a newly configured object is the 0 length string ("") if there are currently no matching objects with the same TA_INTERFACENAME. Otherwise, the default (and in fact only legal value) is the currently configured TA_FBROUTINGNAME value for the existing matched objects. 3 TA_NCOMPLETED and TA_IMPLID (locals) require TA_LDBAL="Y" in the T_DOMAIN MIB class.

Attribute Semantics

TA_INTERFACENAME: string[1..128]

The fully qualified interface name. The interface repository id for the interface. The format of this name is dependent on the options specified in the IDL which generates the interface implementation. See CORBA 2.1 Specification Section 7.6 [CORBA] for details.

TA_SRVGRP: string[0..30]

Server group name. Server group names cannot contain an asterisk, comma or colon. An explicitly specified 0 length string for this attribute is used to specify and query domain level configuration and runtime information for an interface. There are certain limitations and semantic differences noted in other attributes with respect to domain and group level objects in this class.

TA_STATE:

Following are the semantics for GET and SET TA_STATE values on the T_INTERFACE class. Where semantics differ between group and domain level objects, those differences are noted.

GET: {ACTive | INActive | SUSpended | PARtitioned}

A GET operation will retrieve configuration information for the selected T_INTERFACE objects. The following states indicate the meaning of a TA_STATE returned in response to a GET request. States not listed will not be returned.

ACTive	T_INTERFACE object is defined and at least one corresponding T_IFQUEUE entry is in the ACTive state. Note: For a group level T_INTERFACE object, corresponding T_IFQUEUE entries are those with matching TA_INTERFACENAME and TA_SRVGRP attributes. For a domain level T_INTERFACE object, corresponding T_IFQUEUE entries are those with matching TA_INTERFACENAME attributes regardless of their TA_SRVGRP value.
INActive	T_INTERFACE object is defined and there are no corresponding T_IFQUEUE entries in any ACTive equivalent state.
SUSpended	T_INTERFACE object is defined and amongst all corresponding T_IFQUEUE entries there are none in the ACTive state and at least one in the SUSpended state. This state is ACTive equivalent for the purpose of determining permissions.
PARtitioned	T_INTERFACE object is defined and amongst all corresponding T_IFQUEUE entries there are none in the ACTive state none in the SUSpended state and at least one in the PARtitioned state. This state is ACTive equivalent for the purpose of determining permissions.

SET: {NEW | INValid | ACTive | REActivate | SUSpended}

A SET operation will update configuration and runtime information for the selected T_INTERFACE object. Note that modifications may affect more than one server group when making domain level changes and runtime modifications may affect more than one server if multiple servers are currently offering an interface. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

NEW	Create T_INTERFACE object for application. State change only allowed when in the INValid state. Successful return leaves object in INActive state. Creation of a domain level T_INTERFACE object will affect existing group level objects with the same TA_INTERFACENAME value by resetting all TA_FBROUTINGNAME values if a new value is explicitly specified. All other configuration attribute settings will not affect existing group level T_INTERFACE objects.
INValid	Delete T_INTERFACE object for application. State change only allowed when in the INActive state. Successful return leaves object in INValid state.
ACTive	Activate the T_INTERFACE object. Setting this state on the domain level object has the effect of activating all corresponding T_IFQUEUE entries that are currently SUSpended throughout the domain. Setting this state on the group level object will affect only servers within the group offering the interface. State change only allowed when in the SUSpended state. Successful return leaves object in ACTive state.
REActivate	Reactivate the T_INTERFACE object. Setting this state on the domain level object has the effect of activating all corresponding T_IFQUEUE entries that are currently SUSpended throughout the domain. Setting this state on the group level object will affect only servers within the group offering the interface. State change only allowed when in the ACTive or SUSpended states. Successful return leaves object in ACTive state. This state permits global activation of T_IFQUEUE entries suspended at the group level without having to individually activate each group level T_INTERFACE object.
SUSpended	Suspend the T_INTERFACE object. Setting this state on the domain level object has the effect of suspending all corresponding T_IFQUEUE entries that are currently ACTive throughout the domain. Setting this state on the group level object will affect only servers within the group offering the interface. State change only allowed when in the ACTive state. Successful return leaves object in SUSpended state.

Limitation: Dynamic advertisement of interfaces (i.e., state change from INActive or INValid to ACTive) is not supported, nor is unadvertisement (i.e., state change from ACTive to INActive).

TA_AUTOTRAN: { Y | N }

Signifies whether a transaction will be automatically started for invocations made outside a transaction context.

Limitations: Run-time updates to this attribute are not reflected in active equivalent T_INTERFACE objects and TA_TXPOLICY may override the value specified for this attribute in the ubbconfig file. If TA_TXPOLICY is:

always	A value of N will have no effect at run time. Behavior will be as though the setting was Y.
never	A value of Y will have no effect. The interface will never be involved in a transaction.
ignore	A value of Y will have no effect. The interface will never be involved in a transaction.

TA_LOAD: 1 <= num <= 32K

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

Limitation: Run-time updates to this attribute for domain level objects will not affect corresponding group level objects for the same interface.

TA_PRIO: 1 <= num <= 101

This T_INTERFACE object has the indicated dequeuing priority. If multiple interface requests are waiting on a queue for servicing, the higher priority requests will be handled first.

Limitation: Run-time updates to this attribute for domain level objects will not affect corresponding group level objects for the same interface.

TA_TIMEOUT: 0 <= num

Time limit (in seconds) for processing individual method invocations for this interface. Servers processing method invocations for this interface will be abortively terminated if they exceed the specified time limit in processing the request. A value of 0 for this attribute indicates that the server should not be abortively terminated.

Limitation: Run-time updates to this attribute for domain level objects will not affect corresponding group level objects for the same interface.

TA_TRANTIME: 0 <= num

Transaction timeout value in seconds for transactions automatically started for this T_INTERFACE object. Transactions are started automatically when a requests not in transaction mode is received and the T_INTERFACE: TA_AUTOTRAN attribute value for the interface is "Y".

Limitation: Run-time updates to this attribute for domain level objects will not affect corresponding group level objects for the same interface.

Note: Updating this value at runtime for domain level objects should cause a warning, since the only use would be to set the default for a subsequent boot of the application.

TA_FBROUTINGNAME: string[1..15]

The factory-based routing criteria associated with this interface. The name FBROUTINGNAME is used to allow for the future possibility of other routing criteria for message-based routing. This will be less confusing than trying to overload ROUTINGNAME

Limitation: This attribute may be set only for a domain level T_INTERFACE object, i.e., TA_SRVGRP is "".

TA_LMID: LMID

Current logical machine with which the active equivalent group level T_INTERFACE object is associated. This attribute is blank, i.e., "" for domain level objects unless a local query is performed, i.e., TA_FLAGS has the MIB_LOCAL bit set. In the local case, multiple domain level objects will be returned for the same interface, one per machine, with the local values retrieved from each machine represented in the separate objects.

TA_NUMSERVERS: 0 <= num

Number of corresponding servers offering this interface.

TA_TPPOLICY: { method | transaction | process }

The TP framework deactivation policy. This reflects the policy registered with the framework at server startup. The first server to register the interface sets the value in T_INTERFACE. This value cannot be changed.

TA_TXPOLICY: { optional | always | never | ignore }

The transaction policy for the interface. The setting in this attribute affects the effect of the TA_AUTOTRAN attribute. See TA_AUTOTRAN for further explanation. This attribute is always read-only. It is set by the developer when the server is built and registered at server startup.

TA_NCOMPLETED: 0 <= num

Number of interface method invocations completed with respect to the corresponding T_IFQUEUE objects since they were initially offered. Local queries (TA_FLAGS MIB_LOCAL bit set) on domain level objects will return one object per machine with the statistics for the indicated interface on that machine.

TA_NQUEUED: 0 <= num

Number of requests currently enqueued for this interface. Local queries (TA_FLAGS MIB_LOCAL bit set) on domain level objects will return one object per machine with the statistics for the indicated interface on that machine.

Implementation Hint

The T_INTERFACE MIB is a mapping from an interface to a BEA Tuxedo service. The MIB server can implement some of the get/set operations for an interface by calling the existing logic for the associated T_SERVICE object.

T_JDBCCONNPOOL Class

Overview

This class represents the configuration and runtime attributes of JDBC connection pools on a Java server. The attributes consist of statistics or values associated with each connection pool. Except for TA_STATE, attribute values are persistent in TUXCONFIG. Local attributes are local to the memory allocated to a Java server.

Attribute Table

T_JDBCCONNPOOL Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_SRVID( r )( * )	string	ru-r--r--	1<=num<30,001	N/A
TA_SRVGRP( r )( * )	string	ru-r--r--	string[1...30]	N/A
TA_DSNAME( r )( * )	string	ru-r--r--	string[0...30]	N/A
TA_DRIVER	string	rw-r--r--	string[0...256]	N/A
TA_URL	string	rw-r--r--	string[2...256]	N/A
TA_STATE	string	rw-r--r--	GET:VALID SET:"{NEW|INVALID}"	N/A N/A
TA_DBNAME	string	rw-r--r--	string[0...30]	N/A
TA_DBUSER	string	rw-r--r--	string[0...30]	N/A
TA_DBPASSWORD	string	rw------	string[0...64]	N/A
TA_USERROLE	string	rw-r--r--	string[0...30]	N/A
TA_DBHOST	string	rw-r--r--	string[0...30]	N/A
TA_DBNETPROTOCOL	string	rw-r--r--	string[0...30]	N/A
TA_DBPORT	long	rw-r--r--	0<num<64K	N/A
TA_PROPS	string	rw-r--r--	string[0...256]	N/A
TA_ENABLEXA	string	rw-r--r--	{Y | N}	N
TA_CREATEONSTARTUP	string	rw-r--r--	{Y | N}	Y
TA_LOGINDELAY	long	rw-r--r--	0<=num	0
TA_INITCAPACITY	long	rw-r--r--	0<num	N/A
TA_MAXCAPACITY	long	rw-r--r--	0<num	N/A
TA_CAPACITYINCR	long	rw-r--r--	0<num	N/A
TA_ALLOWSHRINKING	string	rw-r--r--	{Y | N}	N
TA_SHRINKPERIOD	long	rw-r--r--	1<=num	15
TA_TESTTABLE	string	rw-r--r--	string[0...256]	N/A
TA_REFRESH	long	rw-r--r--	0<=num	5
TA_TESTONRESERVE	string	rw-r--r--	{Y | N}	N
TA_TESTONRELEASE	string	rw-r--r--	{Y | N}	N
TA_WAITFORCONN	string	rw-r--r--	{Y | N}	Y
TA_WAITTIMEOUT	long	rw-r--r--	0<=num	N/A
T_JDBCCONNPOOL Class:LOCAL Attributes
TA_CONNUSED	long	R--R--R--	0<=num	N/A
TA_CONNAVAILABLE	long	R--R--R--	0<=num	N/A
TA_HWMCONNUSE	long	R--R--R--	0<=num	N/A
TA_HWMCONNCREATED	long	R--R--R--	0<=num	N/A
TA_AWAITINGCONN	long	R--R--R--	0<=num	N/A
TA_HWMFORWAIT	long	R--R--R--	0<=num	N/A
( r ) - Required field for object creation (SET TA_STATE NEW) ( * ) - GET/SET key, one or more required for SET operations

Attribute Semantics

TA_SRVID 1<=num<30,001

Together with the server group name, this value is used to identify a Java server, specified in the SERVERS section of the UBBCONFIG, for which the connection pool is being described.

TA_SRVGRP string[1...30]

Name of a server group. This is used to identify a Java server, specified in the SERVERS section of the UBBCONFIG, for which the connection pool is being described.

TA_DSNAME string[0...30]

The data source name for the connection pool.

TA_DRIVER string[0...256]

The class name for the Java driver.

TA_URL string[0...256]

URL for a JDBC driver that is not JDBC 2.0-compliant.

TA_STATE

The INVALID state is used to delete entries from the configuration file on a SET request. VALID is always returned by a GET request.

TA_DBNAME string[0...30]

The database name.

TA_DBUSER string[0...30]

User's account name.

TA_DBPASSWORD string[0...64]

The user's password. The password entered by the user should not exceed 24 bytes.

TA_DBUSERROLE string[0...30]

The user's SQL role.

TA_DBHOST string[0...30]

Database server name.

TA_DBNETPROTOCOL string[0...30]

The protocol used to communicate with the database.

TA_DBPORT 0<num<64K

The port used for database connections.

TA_PROPS string[0...256]

Vendor-specific information for the JDBC driver.

TA_ENABLEXA Y or N

If set to Y, indicates that the pool supports XA mode.

TA_CREATEONSTARTUP Y or N

If set to Y, indicates that the connection pool is created when the server is started. If set to N, the pool is created when the first request arrives.

TA_LOGINDELAY

The login delay in seconds.

TA_INITCAPACITY 0<num

The number of connections initially supported in the connection pool. num should not exceed the value of TA_MAXCAPACITY.

TA_MAXCAPACITY 0<num

The maximum number of connections supported in the connection pool.

TA_CAPACITYINCR 0<num

The number of connections added to the pool when the current limit is exceeded but the maximum capacity has not yet been reached.

TA_ALLOWSHRINKING Y or N

If set to Y, allows connection pool shrinking.

TA_SHRINKPERIOD 1=<num

The interval after which shrinking occurs, in minutes.

TA_TESTTABLE string[0...256]

The name of a table in the database that is used to test the viability of connections in the connection pool. The query select count(*) from TESTTABLE is used to test a connection. The table must exist and be accessible to the database user for the connection.

TA_REFRESH 0<=num

The refresh interval, in minutes.

TA_TESTONRESERVE Y or N

If set to Y, the Java server tests a connection after removing it from the pool and before giving it to the client. The test adds a small delay in serving the client's request for a connection from the pool but ensures that the client receives a working connection. A value for TA_TESTTABLE must be set for this feature to work.

TA_TESTONRELEASE Y or N

If set to Y, the Java server tests a connection before returning it to the connection pool. If all the connections in the pool are already in use and a client is waiting for a connection, the client's wait will be slightly longer due to the test of the connection. A value for TA_TESTTABLE must be set for this feature to work.

TA_WAITFORCONN Y or N

If set to Y, enables an application to wait for a connection indefinitely if none is currently available. If set to N, a request for a connection returns to the caller immediately if there is no connection available. Y is assumed unless TA_WAITTIMEOUT is specified, in which case it becomes N.

TA_WAITTIMEOUT 0<num

Time in seconds that an application will wait for a connection to become available.

T_ROUTING Class

Overview

The T_ROUTING class represents configuration attributes of routing specifications for an application. These attribute values identify and characterize application data dependent routing criteria with respect to field names, buffer types, and routing definitions.

Attribute Table

T_ROUTING Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_ROUTINGNAME( r )( * )	string	ru-r--r--	string[1...15]	N/A
TA_ROUTINGTYPE ( r)	string	ru-r--r--	SERVICE or FACTORY	SERVICE
TA_BUFTYPE( r )( * )	string	ru-r--r--	string[1...256]	N/A1
TA_FIELD( r )( k ) ( * )	string	ru-r--r--	string[1...30]	N/A1
TA_RANGES( r )	carray	rw-r--r--	carray[1...2048]	N/A
TA_TYPE	string	ru-r--r--	string[1..15]	"SERVICE2
TA_FIELDTYPE ( r )	string	rw-r--r--	string[1..30]	N/A
TA_STATE( k )	string	rw-r--r--	GET:"{VAL}" SET:"{NEW|INV}"	N/A N/A
( k ) - GET key field ( r ) - Required field for object creation (SET TA_STATE NEW) ( * ) - GET/SET key, one or more required for SET operations

¹TA_BUFTYPE only applies to BEA Tuxedo data-dependent routing criteria. TA_FIELDTYPE only applies to WebLogic Enterprise Factory-Based routing criteria. The specified u (uniqueness) permission applies only in the relevant case. That is: the combination of TA_ROUTINGNAME, TA_TYPE and TA_BUFTYPE must be unique for TA_TYPE=SERVICE, and TA_ROUTINGNAME, TA_TYPE and TA_FIELD must be unique for TA_TYPE=FACTORY.

The TA_TYPE attribute determines the permissible attributes for the TA_ROUTING object. TYPE=SERVICE corresponds to BEA Tuxedo data-dependent routing criteria. TYPE=FACTORY corresponds to WebLogic Enterprise factory-based routing. The default is SERVICE. SET operations are assumed to be for data-dependent routing if no TA_TYPE is specified. Specification of TA_FIELDTYPE is invalid for data-dependent routing. Specification of TA_BUFTYPE is invalid for factory-based routing.

Attribute Semantics

TA_ROUTINGNAME: string[1...15]

Routing criteria name.

TA_ROUTINGTYPE:type

Specifies the routing type. The default is TYPE=SERVICE to ensure that existing UBBCONFIG files used in BEA Tuxedo environments continue to work properly. Use TYPE=FACTORY if you are implementing factory-based routing for a WebLogic Enterprise interface.

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

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 be 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 (\Q\Q*'' is not allowed). Note that subtype names should not contain semicolon, colon, comma, or asterisk characters. Duplicate type/subtype pairs can not be specified for the same routing criteria name; more than one routing entry can have the same criteria 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.

TA_FIELD: string[1...30]

The routing field name. When TA_TYPE=FACTORY, 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 section on factory-based routing for more details.

When TA_TYPE=SERVICE 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 variables) or an FML view table (using the VIEWDIR and VIEWFILES environment variables), respectively. This information is used to get the associated field value for data dependent routing during the sending of a message.

TA_FIELDTYPE (Factory-based Routing Only)

Routing field type. This field is only valid if TA_TYPE=FACTORY. Valid types are: SHORT, LONG, FLOAT, DOUBLE, CHAR, STRING. Specification of this attribute is only valid for factory-based routing criteria.

TA_RANGES: carray[1...2048]

The ranges and associated server groups for the routing field. The format of string is a comma-separated, ordered list of range/group name pairs. A range/group name pair has the following format:

lower[-upper]:group

lower and upper are signed numeric values or character strings in single quotes. lower must be less than or equal to upper. To embed a single quote in a character string value, it must be preceded by two backslashes (for example, 'O\\'Brien'). The value MIN can be used to indicate the minimum value for the data type of the associated field on the machine. The value MAX can be used to indicate the maximum value for the data type of the associated field on the machine. Thus, "MIN--5" is all numbers less than or equal to -5, and "6-MAX" is all numbers greater than or equal to 6.

The meta-character \Q\Q*'' (wildcard) in the position of a range indicates any values not covered by the other ranges previously seen in the entry; only one wild-card range is allowed per entry and it should be last (ranges following it will be ignored).

The routing field can be of any data type supported in FML. A numeric routing field must have numeric range values, and a string routing field must have string range values.

String range values for string, carray, and character field types must be placed inside a pair of single quotes and can not be preceded by a sign. Short and long integer values are a string of digits, optionally preceded by a plus or minus sign. Floating point numbers are of the form accepted by the C compiler or atof(3): an optional sign, then a string of digits optionally containing a decimal point, then an optional e or E followed by an optional sign or space, followed by an integer.

The group name indicates the associated group to which the request is routed if the field matches the range. A group name of \Q\Q*'' indicates that the request can go to any group where a server offers the desired service.

Limitation: Attribute values greater than 256 bytes in length will disable interoperability with BEA Tuxedo Release 4.2.2 and earlier.

TA_STATE:

GET: {VALid}

A GET operation will retrieve configuration information for the selected T_ROUTING object(s). The following states indicate the meaning of a TA_STATE returned in response to a GET request. States not listed will not be returned.

VALid

T_ROUTING object is defined. Note that this is the only valid state for this class. Routing criteria are never ACTive; rather, they are associated through the configuration with service names and are acted upon at runtime to provide data dependent routing. This state is INActive equivalent for the purpose of permissions checking.

SET: {NEW|INValid}

A SET operation will update configuration information for the selected T_ROUTING object. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

NEW	Create T_ROUTING object for application. State change allowed only when in the INValid state. Successful return leaves the object in the VALid state.
unset	Modify an existing T_ROUTING object. This combination is not allowed in the INValid state. Successful return leaves the object state unchanged.
INValid	Delete T_ROUTING object for application. State change allowed only when in the VALid state. Successful return leaves the object in the INValid state.

TA_TYPE

Routing criteria type. Valid values are "FACTORY" or "SERVICE". "FACTORY" specifies that the routing criteria applies to factory-based routing for a CORBA interface. The specification of TYPE=FACTORY is mandatory for a factory-based routing criteria. "SERVICE" specifies that the routing criteria applies to data-dependent routing for a BEA Tuxedo service. Default is "SERVICE". Specification of this attribute is optional for data-dependent routing criteria. Note that the type specified affects the validity and possible values for other fields defined for this MIB class. These are noted for each field. TA_TYPE is required for SET operations for factory-based routing criteria.

Limitations

None.

T_SERVER Class

Overview

The T_SERVER class represents configuration and run-time attributes of servers within an application. These attribute values identify and characterize configured servers as well as provide run-time tracking of statistics and resources associated with each server object. Information returned will always include fields that are common among all contexts of a server. In addition, for those servers that are not defined to the system as multicontexted (that is, those for which the value of TA_MAXDISPATCHTHREADS is 1), this class includes information about the server's context. For those servers that are defined to the system as multicontexted, placeholder values are reported for per-context attributes. Per-context attributes can always be found as part of the T_SERVERCTXT class. The T_SERVERCTXT class is defined even for single-contexted servers.

The TA_CLTLMID, TA_CLTPID, TA_CLTREPLY, TA_CMTRET, TA_CURCONV, TA_CURREQ, TA_CURRSERVICE, TA_LASTGRP, TA_SVCTIMEOUT, TA_TIMELEFT, and TA_TRANLEV attributes are specific to each server dispatch context. All other attributes are common to all server dispatch contexts.

TA_CLASSPATH, TA_JAVAHEAP, TA_JAVAHEAPUSE, TA_JAVAVERSION, and TA_JAVAVENDOR apply to Java servers only.

Attribute Table

T_SERVER Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_SRVGRP( r )( * )	string	ru-r--r--	string[1...30]	N/A
TA_SRVID( r )( * )	long	ru-r--r--	1 <= num < 30,001	N/A
TA_SERVERNAME( k )( r )	string	rw-r--r--	string[1...78]	N/A
TA_SRVTYPE	string	r--r--r--	JAVA	N/A
TA_GRPNO( k )	long	r--r--r--	1 <= num < 30,000	N/A
TA_STATE( k )	string	rwxr-xr--	GET:"{ACT|INA|MIG|CLE| RES|SUS|PAR|DEA}" SET:"{NEW|INV|ACT|INA |DEA}"	N/A N/A
TA_BASESRVID	long	r--r--r--	1 <= num < 30,001	N/A
TA_CLOPT	string	rwyr--r--	string[0...256]	"-A"
TA_ENVFILE	string	rwyr--r--	string[0...78]	""
TA_GRACE	long	rwyr--r--	0 <= num	86,400
TA_MAXGEN	long	rwyr--r--	1 <= num < 256	1
TA_MAX	long	rwxr--r--	1 <= num < 1,001	1
TA_MIN	long	rwyr--r--	1 <= num < 1,001	1
TA_RCMD	string	rwyr--r--	string[0...78]	""
TA_RESTART	string	rwyr--r--	"{Y|N}"	N
TA_SEQUENCE( k )	long	rwxr--r--	1 <= num < 10,000	>= 10,000
TA_SYSTEM_ACCESS	string	rwyr--r--	"{FASTPATH|PROTECTED}"	(1)
TA_CONV( k )	string	rw-r--r--	"{Y|N}"	N
TA_REPLYQ	string	rw-r--r--	"{Y|N}"	N
TA_RPPERM	long	rw-r--r--	0001 <= num <= 0777	(1)
TA_RQADDR( k )	string	rw-r--r--	string[0...30]	"GRPNO.SRVID"
TA_RQPERM	long	rw-r--r--	0001 <= num <= 0777	(1)
TA_LMID( k )	string	R--R--R--	LMID	N/A
TA_GENERATION	long	R--R--R--	1 <= num < 32K	N/A
TA_PID( k )	long	R--R--R--	1 <= num	N/A
TA_RPID	long	R--R--R--	1 <= num	N/A
TA_RQID	long	R--R--R--	1 <= num	N/A
TA_TIMERESTART	long	R--R--R--	1 <= num	N/A
TA_TIMESTART	long	R--R--R--	1 <= num	N/A
T_SERVER Class: LOCAL Attributes
TA_CLASSPATH	string	R--R--R--	string[0...2,047]	N/A
TA_JAVAHEAP	long	R--R--R--	0<num
TA_JAVAHEAPUSE	long	R--R--R--	1<=num<=100	N/A
TA_JAVAVENDOR	string	R--R--R--	string[0...30]	N/A
TA_JAVAVERSION	string	R--R--R--	string[0...30]	N/A
TA_MAXDISPATCHTHREADS	long	R--R--R--	0<num	N/A
TA_NUMCONV	long	R-XR-XR--	0 <= num	N/A
TA_NUMDEQUEUE	long	R-XR-XR--	0 <= num	N/A
TA_NUMENQUEUE	long	R-XR-XR--	0 <= num	N/A
TA_NUMPOST	long	R-XR-XR--	0 <= num	N/A
TA_NUMREQ	long	R-XR-XR--	0 <= num	N/A
TA_NUMSUBSCRIBE	long	R-XR-XR--	0 <= num	N/A
TA_NUMTRAN	long	R-XR-XR--	0 <= num	N/A
TA_NUMTRANABT	long	R-XR-XR--	0 <= num	N/A
TA_NUMTRANCMT	long	R-XR-XR--	0 <= num	N/A
TA_THREADSTACKSIZE	long	R--R--R--	0<num	N/A
TA_TOTREQC	long	R-XR-XR--	0 <= num	N/A
TA_TOTWORKL	long	R-XR-XR--	0 <= num	N/A
TA_CLTLMID	string	R--R--R--	LMID	N/A
TA_CLTPID	long	R--R--R--	1 <= num	N/A
TA_CLTREPLY	string	R--R--R--	"{Y|N}"	N/A
TA_CMTRET	string	R--R--R--	"{COMPLETE|LOGGED}"	N/A
TA_CURCONV	long	R--R--R--	0 <= num	N/A
TA_CURDISPATCHTHREADS	long	R--R--R--	0<num	N/A
TA_CUROBJECTS	long	R--R--R--	0 <= num	N/A
TA_CURINTERFACE	string	R--R--R--	string[0..128]	N/A
TA_CURREQ	long	R--R--R--	0 <= num	N/A
TA_CURRSERVICE	string	R--R--R--	string[0...15]	N/A
TA_CURTIME	long	R--R--R--	1 <= num	N/A
TA_HWDISPATCHTHREADS	long	R--R--R--	0<num	N/A
TA_LASTGRP	long	R--R--R--	1 <= num < 30,000	N/A
TA_SVCTIMEOUT	long	R--R--R--	0 <= num	N/A
TA_TIMELEFT	long	R--R--R--	0 <= num	N/A
TA_TRANLEV	long	R--R--R--	0 <= num	N/A
( k ) - GET key field ( r ) - Required field for object creation (SET TA_STATE NEW) ( * ) - GET/SET key, one or more required for SET operations

¹Defaults to value set for this attribute in Class T_DOMAIN

Attribute Semantics

TA_SRVGRP: string[1...30]

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

TA_SRVID: 1 <= num < 30,001

Unique (within the server group) server identification number.

TA_SERVERNAME: string[1...78]

Name of the server executable file. The server identified by TA_SERVERNAME will run on the machine(s) identified by the T_GROUP:TA_LMID attribute for this server's server group. If a relative pathname is given, then the search for the executable file is done first in TA_APPDIR, then in TA_TUXDIR/bin, then in /bin and /usr/bin, and then in <path>, where <path> is the value of the first PATH= line appearing in the machine environment file, if one exists. Note that the attribute value returned for an active server will always be a full pathname. The values for TA_APPDIR and TA_TUXDIR are taken from the appropriate T_MACHINE object. See discussion of the T_MACHINE:TA_ENVFILE attribute for a more detailed discussion of how environment variables are handled.

TA_GRPNO: 1 <= num < 30,000

Group number associated with this server's group.

TA_STATE:

GET:{ACTive|INActive|MIGrating|CLEaning|REStarting|SUSpended|PARtitioned|DEAd}

A GET operation will retrieve configuration and run-time information for the selected T_SERVER object(s). The following states indicate the meaning of a TA_STATE returned in response to a GET request. States not listed will not be returned.

ACTive	T_SERVER object defined and active. This is not an indication of whether the server is idle or busy. An active server with a non 0-length TA_CURRSERVICE attribute should be interpreted as a busy server, that is, one that is processing a service request.
INActive	T_SERVER object defined and inactive.
MIGrating	T_SERVER object 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 T_GROUP:TA_LMID attribute that does not match the T_GROUP:TA_CURLMID attribute. This state is ACTive equivalent for the purpose of determining permissions.
CLEaning	T_SERVER object defined and currently being cleaned up by the system after an abnormal death. Note that restartable servers may enter this state if they exceed TA_MAXGEN starts/restarts within their TA_GRACE period. This state is ACTive equivalent for the purpose of determining permissions.
REStarting	T_SERVER object defined and currently being restarted by the system after an abnormal death. This state is ACTive equivalent for the purpose of determining permissions.
SUSpended	T_SERVER object defined and currently suspended pending shutdown. This state is ACTive equivalent for the purpose of determining permissions.
PARtitioned	T_SERVER object defined and active; however, the machine where the server is running is currently partitioned from the T_DOMAIN:TA_MASTER site. This state is ACTive equivalent for the purpose of determining permissions.
DEAd	T_SERVER object defined, identified as active in the bulletin board, but currently not running due to an abnormal death. This state will exist only until the BBL local to the server notices the death and takes action (REStarting|CLEaning). Note that this state will only be returned if the MIB_LOCAL TA_FLAGS value is specified and the machine where the server was running is reachable. This state is ACTive equivalent for the purpose of determining permissions.

SET: {NEW|INValid|ACTive|INActive|DEAd}

A SET operation will update configuration and run-time information for the selected T_SERVER object. The following states indicate the meaning of a TA_STATE set in a SET request. States not listed may not be set.

NEW	Create T_SERVER object for application. State change allowed only when in the INValid state. Successful return leaves the object in the INActive state.
unset	Modify an existing T_SERVER object. This combination is allowed only when in the ACTive or INActive state. Successful return leaves the object state unchanged.
INValid	Delete T_SERVER object for application. State change allowed only when in the INActive state. Successful return leaves the object in the INValid state.
ACTive	Activate the T_SERVER object. State change allowed only when in the INActive state. (Servers in the MIGrating state must be restarted by setting the T_GROUP:TA_STATE to ACTive.) For the purpose of determining permissions for this state transition, the active object permissions are considered (that is, --x--x--x). Successful return leaves the object in the ACTive state. The TMIB_NOTIFY TA_FLAG value should be used when activating a server if status on the individual server is required.
INActive	Deactivate the T_SERVER object. State change allowed only when in the ACTive state. Successful return leaves the object in the INActive state. The TMIB_NOTIFY TA_FLAG value should be used when deactivating a server if status on the individual server is required.
DEAd	Deactivate the T_SERVER object by sending the server a SIGTERM signal followed by a SIGKILL signal if the server is still running after the appropriate timeout interval (see TA_MIBTIMEOUT in MIB(5)). Note that by default, a SIGTERM signal will cause the server to initiate orderly shutdown and the server will become 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 may be used and will be treated by the system as an abnormal termination. State change allowed only when in the ACTive or SUSpended state. Successful return leaves the object in the INActive, CLEaning or REStarting state.

TA_BASESRVID: 1 <= num < 30,001

Base server identifier. For servers with a TA_MAX attribute value of 1, this attribute will always be the same as TA_SRVID. However, for servers with a TA_MAX value greater than 1, this attribute indicates the base server identifier for the set of servers configured identically.

TA_CLASSPATH string[0...2,047]

The current CLASSPATH for the run time.

TA_CLOPT: string[0...256]

Command-line options to be passed to server when it is activated. See the servopts(5) reference page for details. Limitation: Run-time modifications to this attribute will not affect a running server.

TA_ENVFILE: string[0...78]

Server specific environment file. See T_MACHINE:TA_ENVFILE for a complete discussion of how this file is used to modify the environment. Limitation: Run-time modifications to this attribute will not affect a running server.

TA_GRACE: 0 <= num

The period of time, in seconds, over which the T_SERVER:TA_MAXGEN limit applies. This attribute is meaningful only for restartable servers, that is, if the T_SERVER:TA_RESTART attribute is set to "Y". When a restarting server would exceed the TA_MAXGEN limit but the TA_GRACE period has expired, the system resets the current generation (T_SERVER:TA_GENERATION) to 1 and resets the initial boot time (T_SERVER:TA_TIMESTART) to the current time. A value of 0 for this attribute indicates that a server should always be restarted.

Note that servers sharing a request queue (that is, equal values for T_SERVER:TA_RQADDR) should have equal values for this attribute. If they do not, then the first server activated will establish the run-time value associated with all servers on the queue.

Limitation: Run-time modifications to this attribute will 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 attribute.

TA_JAVAHEAP 0<num

The heap size as specified in the run-time options.

TA_JAVAHEAPUSE 1<=num<=100

The percentage of heap space used.

TA_MAXGEN: 1 <= num < 256

Number of generations allowed for a restartable server (T_SERVER:TA_RESTART == "Y") over the specified grace period (T_SERVER:TA_GRACE). 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 TA_GRACE.

Note that servers sharing a request queue (that is, equal values for T_SERVER:TA_RQADDR) should have equal values for this attribute. If they do not, then the first server activated will establish the run-time value associated with all servers on the queue.

Limitation: Run-time modifications to this attribute will 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 attribute.

TA_MAXDISPATCHTHREADS 0<num

The maximum number of threads, as specified with -M in the CLOPT.

TA_MAX: 1 <= num < 1,001

Maximum number of occurrences of the server to be booted. Initially, tmboot(3c) boots T_SERVER:TA_MIN objects of the server, and additional objects may be started individually (by starting a particular server ID) or through automatic spawning (conversational servers only). Run-time modifications to this attribute will affect all running servers in the set of identically configured servers (see TA_BASESRVID above) as well as the configuration definition of the server.

TA_MIN: 1 <= num < 1,001

Minimum number of occurrences of the server to be booted by. If a T_SERVER:TA_RQADDR is specified and TA_MIN is greater than 1, then the servers will form an MSSQ set. The server identifiers for the servers will be T_SERVER:TA_SRVID up to TA_SRVID + T_SERVER:TA_MAX - 1. All occurrences of the server will have the same sequence number, as well as any other server parameters.

Limitation: Run-time modifications to this attribute will not affect a running server.

TA_RCMD: string[0...78]

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

Note that servers sharing a request queue (that is, equal values for T_SERVER:TA_RQADDR) should have equal values for this attribute. If they do not, then the first server activated will establish the run-time value associated with all servers on the queue.

Limitation: Run-time modifications to this attribute will 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 attribute.

TA_RESTART: {Y|N}

Restartable ("Y") or non-restartable ("N") server. If server migration is specified for this server group (T_DOMAIN:TA_OPTIONS/MIGRATE and T_GROUP:TA_LMID with alternate site), then this attribute must be set to "Y".

Note that servers sharing a request queue (that is, equal values for T_SERVER:TA_RQADDR) should have equal values for this attribute. If they do not, then the first server activated will establish the run-time value associated with all servers on the queue.

Limitation: Run-time modifications to this attribute will 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 attribute.

TA_SEQUENCE: 1 <= num < 10,000

Specifies when this server should be booted ( tmboot(1) ) or shutdown ( tmshutdown(1) ) relative to other servers. T_SERVER objects added without a TA_SEQUENCE attribute specified or with an invalid value will have one generated for them that is 10,000 or more and is higher than any other automatically selected default. 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 attribute affect onlytmboot(1) and tmshutdown(1) and will affect the order in which running servers may be shutdown by a subsequent invocation of tmshutdown(1).

TA_SYSTEM_ACCESS: {FASTPATH|PROTECTED}

Mode used by BEA Tuxedo system libraries within this server process to gain access to BEA Tuxedo system's internal tables. See T_DOMAIN:TA_SYSTEM_ACCESS for a complete discussion of this attribute.

Limitation: Run-time modifications to this attribute will not affect a running server.

TA_CONV: {Y|N}

Conversational server ("Y") or request/response server ("N").

TA_HWDISPATCHTHREADS

The high water mark for the number of threads in the server.

TA_REPLYQ: {Y|N}

Allocate a separate reply queue for the server (TA_REPLYQ == "Y"). MSSQ servers that expect to receive replies should set this attribute to "Y".

TA_RPPERM: 0001 <= num <= 0777

UNIX system permissions for the server's reply queue. If a separate reply queue is not allocated (T_SERVER:TA_REPLYQ == "N"), then this attribute is ignored. Limitation: This is a UNIX system specific attribute that may not be returned if the platform on which the application is being run is not UNIX-based.

TA_RQADDR: string[0...30]

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

TA_RQPERM: 0001 <= num <= 0777

UNIX system permissions for the server's request queue.

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

TA_LMID: LMID

Current logical machine on which the server is running.

TA_GENERATION: 1 <= num < 32K

Generation of the server. When a server is initially booted via tmboot(1) or activated through the TM_MIB(5), its generation is set to 1. Each time the server dies abnormally and is restarted, its generation is incremented. Note that when T_SERVER:TA_MAXGEN is exceeded and T_SERVER:TA_GRACE has expired, the server will be restarted with the generation reset to 1.

TA_PID: 1 <= num

UNIX system process identifier for the server. Note that this may not be a unique attribute since servers may be located on different machines allowing for duplication of process identifiers.

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

TA_RPID: 1 <= num

UNIX system message queue identifier for the server's reply queue. If a separate reply queue is not allocated (T_SERVER:TA_REPLYQ == "N"), then this attribute value will be the same as T_SERVER:TA_RQID.

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

TA_RQID: 1 <= num

UNIX system message queue identifier for the server's request queue. If a separate reply queue is not allocated (T_SERVER:TA_REPLYQ == "N"), then this attribute value will be the same as T_SERVER:TA_RPID.

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

TA_THREADSTACKSIZE 0<num

The stack size per thread as specified in the runtime options.

TA_TIMERESTART: 1 <= num

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

TA_TIMESTART: 1 <= num

Time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on T_SERVER:TA_LMID, when the server was first started. Restarts of the server do not reset this value; however, if T_SERVER:TA_MAXGEN is exceeded and T_SERVER:TA_GRACE is expired, this attribute will be reset to the time of the restart.

TA_NUMCONV: 0 <= num

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

TA_NUMDEQUEUE: 0 <= num

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

TA_NUMENQUEUE: 0 <= num

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

TA_NUMPOST: 0 <= num

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

TA_NUMREQ: 0 <= num

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

TA_NUMSUBSCRIBE: 0 <= num

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

TA_NUMTRAN: 0 <= num

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

TA_NUMTRANABT: 0 <= num

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

TA_NUMTRANCMT: 0 <= num

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

TA_TOTREQC: 0 <= num

Total number of requests completed by this server. For conversational servers (T_SERVER:TA_CONV == "Y"), this attribute value indicates the number of completed incoming conversations. This is a run-time attribute that is kept across server restart but is lost at server shutdown.

TA_TOTWORKL: 0 <= num

Total workload completed by this server. For conversational servers (T_SERVER:TA_CONV == "Y"), this attribute value indicates the workload of completed incoming conversations. This is a run-time attribute that is kept across server restart but is lost at server shutdown.

TA_CLTLMID: LMID

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. The value in this field has meaning only for single-context servers. In multi-context servers, the null string is returned as a placeholder. This field element is also contained in the T_SERVERCTXT class, both for single-context servers and for multicontext servers.

TA_CLTPID: 1 <= num

UNIX system process identifier for the initiating client or server. The value in this field has meaning only for single-context servers. In multi-context servers, -1 is returned as a placeholder. This field element is also contained in the T_SERVERCTXT class, both for single-context servers and for multicontext servers.

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

TA_CLTREPLY: {Y|N}

The initiating client or server is expecting a reply ("Y") or is not expecting a reply ("N"). The value in this field has meaning only for single-context servers. In multi-context servers, the null string is returned as a placeholder. This field element is also contained in the T_SERVERCTXT class, both for single-context servers and for multicontext servers.

TA_CMTRET: {COMPLETE|LOGGED}

Setting of the TP_COMMIT_CONTROL characteristic for this server. See the description of the ATMI function call tpscmt(3c) for details on this characteristic. The value in this field has meaning only for single-context servers. In multi-context servers, the null string is returned as a placeholder. This field element is also contained in the T_SERVERCTXT class, both for single-context servers and for multicontext servers.

TA_CURCONV: 0 <= num

Number of conversations initiated by this server via tpconnect(3c) that are still active. For multicontext servers, this field represents the total for all server contexts. Values for individual server contexts can be found in the T_SERVERCTXT class.

TA_CURDISPATCHTHREADS

The current number of threads in the server

TA_CUROBJECTS

The number of entries in use in the Bulletin Board object table for this server. Scope is local.

TA_CURINTERFACE

The interface name of the interface currently active in this server. Scope is local.

TA_CURREQ: 0 <= num

Number of requests initiated by this server via tpcall(3c) or tpacall(3c) that are still active. For multicontext servers, this field represents the total for all server contexts. Values for individual server contexts can be found in the T_SERVERCTXT class.

TA_CURRSERVICE: string[0 . . . 15]

Service name that the server is currently working on, if any. The value in this field has meaning only for single-context servers. In multicontext servers, the null string is returned as a placeholder. This field element is also contained in the T_SERVERCTXT class, both for single-context servers and for multicontext servers.

TA_CURTIME: 1 <= num

Current time, in seconds, since 00:00:00 UTC, January 1, 1970, as returned by the time(2) system call on T_SERVER:TA_LMID. This attribute can be used to compute elapsed time from the T_SERVER:TA_TIMESTART and T_SERVER:TA_TIMERESTART attribute values.

TA_LASTGRP: 1 <= num < 30,000

Server group number (T_GROUP:TA_GRPNO) of the last service request made or conversation initiated from this server outward. The value in this field has meaning only for single-context servers. In multicontext servers, -1 is returned as a placeholder. This field element is also contained in the T_SERVERCTXT class, both for single-context servers and for multicontext servers.

TA_SVCTIMEOUT: 0 <= num

Time left, in seconds, for this server to process the current service request, if any. A value of 0 for an active service indicates that no timeout processing is being done. See T_SERVICE:TA_SVCTIMEOUT for more information. The value in this field has meaning only for single-context servers. In multicontext servers, -1 is returned as a placeholder. This field element is also contained in the T_SERVERCTXT class, both for single-context servers and for multicontext servers.

TA_TIMELEFT: 0 <= num

Time left, in seconds, for this server to receive the reply for which it is currently waiting before it will timeout. This timeout may be a transactional timeout or a blocking timeout. The value in this field has meaning only for single-context servers. In multicontext servers, -1 is returned as a placeholder. This field element is also contained in the T_SERVERCTXT class, both for single-context servers and for multicontext servers.

TA_TRANLEV: 0 <= num

Current transaction level for this server. 0 indicates that the server is not currently involved in a transaction. The value in this field has meaning only for single-context servers. In multicontext servers, -1 is returned as a placeholder. This field element is also contained in the T_SERVERCTXT class, both for single-context servers and for multicontext servers.

Limitations

None.

 

Copyright © 2000 BEA Systems, Inc. All rights reserved. Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.