File Formats, Data Descriptions, MIBs, and System Processes Reference
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.
(k)— |
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.
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.
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.
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.
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..256] (up to 78 bytes for BEA Tuxedo 8.0 or earlier)
Application specified command to be executed in parallel with the system restart of application servers associated with this 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.
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
", 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.
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
", 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.
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"
, TA_NQUEUED
is not returned. Consequently, when this attribute is returned TA_LMID
and TA_SOURCE
have the same value.
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
", the TA_WKQUEUED
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
.