---

T_QUEUE CLASS

Overview

The T_QUEUE class represents run-time attributes of queues in an application. These attribute values identify and characterize allocated BEA TUXEDO system request queues associated with servers in a running application. They also track statistics related to application workloads associated with each queue object.

Note that when a GET operation with the MIB_LOCAL flag is performed in a multi-machine application, multiple objects will be returned for each active queue - one object for each logical machine where local attribute values are collected.

Attribute Table

T_QUEUE Class Definition Attribute Table

Attribute	Type	Permissions	Values	Default
TA_RQADDR( * )	string	R--R--R--	string[1...30]	N/A
TA_SERVERNAME( k )	string	R--R--R--	string[1...78]	N/A
TA_STATE( k )	string	R--R--R--	GET:"{ACT|MIG |SUS|PAR}" SET:N/A	N/A N/A
TA_GRACE	long	R--R--R--	0 <= num	N/A
TA_MAXGEN	long	R--R--R--	1 <= num < 256	N/A
TA_RCMD	string	R--R--R--	string[0...78]	N/A
TA_RESTART	string	R--R--R--	"{Y|N}"	N/A
TA_CONV	string	R--R--R--	"{Y|N}"	N/A
TA_LMID( k )	string	R--R--R--	LMID	N/A
TA_RQID	long	R--R--R--	1 <= num	N/A
TA_SERVERCNT	long	R--R--R--	1 <= num < 8K	N/A
T_QUEUE Class:LOCAL Attributes
TA_TOTNQUEUED	long	R-XR-XR--	0 <= num	N/A
TA_TOTWKQUEUED	long	R-XR-XR--	0 <= num	N/A
TA_SOURCE( k )	string	R--R--R--	LMID	N/A
TA_NQUEUED	long	R--R--R--	0 <= num	N/A
TA_WKQUEUED	long	R--R--R--	0 <= num	N/A
( k ) - GET key field ( * ) - GET/SET key, one or more required for SET operations

Attribute Semantics

TA_RQADDR: string[1...30]

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

TA_SERVERNAME: string[1...78]

Full pathname of the server executable file. The server identified by TA_SERVERNAME is running on the machine identified by the T_QUEUE:TA_LMID attribute. When specified as a key field on a GET operation, this attribute may specify a relative pathname; all appropriate full pathnames will be matched.

TA_STATE:

GET: {ACTive|MIGrating|SUSpended|PARtitioned}

A GET operation will retrieve run-time information for the selected T_QUEUE object(s). The T_QUEUE class does not address configuration information directly. Configuration related attributes discussed here must be set as part of the related T_SERVER 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	At least one server associated with this T_QUEUE object is active.
MIGrating	The server(s) associated with this T_QUEUE object is currently in the MIGrating state. See the T_SERVER class for more details on this state. This state is ACTive equivalent for the purpose of determining permissions.
SUSpended	The server(s) associated with this T_QUEUE object is currently in the SUSpended state. See the T_SERVER class for more details on this state. This state is ACTive equivalent for the purpose of determining permissions.
PARtitioned	The server(s) associated with this T_QUEUE object is currently in the PARtitioned state. See the T_SERVER class for more details on this state. This state is ACTive equivalent for the purpose of determining permissions.

SET:

A SET operation will update run-time information for the selected T_QUEUE object. State changes are not allowed when updating T_QUEUE object information. Modification of an existing T_QUEUE object is allowed only when the object is in the ACTive state.

TA_GRACE: 0 <= num

The period of time, in seconds, over which the T_QUEUE:TA_MAXGEN limit applies. This attribute is meaningful only for restartable servers, that is, if the T_QUEUE:TA_RESTART attribute is set to "Y". A value of 0 for this attribute indicates that a server should always be restarted.

TA_MAXGEN: 1 <= num < 256

Number of generations allowed for restartable servers (T_QUEUE:TA_RESTART == "Y") associated with this queue over the specified grace period (T_QUEUE:TA_GRACE). The initial activation of each server counts as one generation and each restart also counts as one.

TA_RCMD: string[0...78]

Application specified command to be executed in parallel with the system restart of application servers associated with this queue.

TA_RESTART: {Y|N}

Servers associated with this queue are restartable ("Y") or non-restartable ("N").

TA_CONV: {Y|N}

Servers associated with this queue are conversational-based ("Y") or request/response-based ("N").

TA_LMID: LMID

Logical machine on which servers associated with this queue are active.

TA_RQID: 1 <= num

UNIX System message queue identifier.

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_SERVERCNT: 1 <= num < 8K

Number of active servers associated with this queue.

TA_TOTNQUEUED: 0 <= num

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.

Limitation: If the T_DOMAIN:TA_LDBAL attribute is "N" or the T_DOMAIN:TA_MODEL attribute is "MP", then TA_TOTNQUEUED is not returned. In the same configuration, updates to this attribute are ignored. Consequently, when this attribute is returned TA_LMID and TA_SOURCE have the same value.

TA_TOTWKQUEUED: 0 <= num

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.

Limitation: If the T_DOMAIN:TA_LDBAL attribute is "N" or the T_DOMAIN:TA_MODEL attribute is "MP", then TA_TOTWKQUEUED is not returned. In the same configuration, updates to this attribute are ignored. Consequently, when this attribute is returned TA_LMID and TA_SOURCE have the same value.

TA_SOURCE: LMID

Logical machine from which local attribute values are retrieved.

TA_NQUEUED: 0 <= num

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

Limitation: If the T_DOMAIN:TA_LDBAL attribute is "N" or the T_DOMAIN:TA_MODEL attribute is "MP", then TA_NQUEUED is not returned. Consequently, when this attribute is returned TA_LMID and TA_SOURCE have the same value.

TA_WKQUEUED: 0 <= num

Workload currently enqueued to this queue from the TA_SOURCE logical machine. If the T_DOMAIN:TA_MODEL attribute is set to SHM and the T_DOMAIN:TA_LDBAL attribute is set to "Y" then this attribute reflects the application-wide workload enqueued to this queue. However, if TA_MODEL is set to MP and TA_LDBAL is set to "Y", this attribute reflects the workload enqueued to this queue from the TA_SOURCE logical machine during a recent timespan. This attribute is used for load balancing purposes. So as to not discriminate against newly started servers, this attribute value is zeroed out on each machine periodically by the BBL.

Limitations

None.

---

---