Tuxedo Queues Test

The BEA Tuxedo message queuing servers provide for time-independent communication among clients and servers in a BEA Tuxedo application. They make it possible for an application, within a global transaction, to store client and server generated messages to stable storage for processing later. A client or server process involved in message queuing communications decides when it wants to retrieve a message off its queue.

Since too many enqueued messages can cause performance slowdowns, it is good practice to monitor the length of each message queue, identify overloaded queues, and initiate measures to reduce the load on the queue. The Tuxedo Queues test provides these queue-level insights.

Target of the test : A Tuxedo Domain Server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for every Machine_name:Queue_name associated with the Tuxedo Domain server being monitored.

Configurable parameters for the test
Parameter Description

Test period

How often should the test be executed.

Host

The host for which the test is to be configured.

Port

The port at which the specified host listens. The default port is 12345.

TuxDir

Specify the full path to the installation directory of the Tuxedo Domain server. For example, while monitoring a Tuxedo server on Windows, your TuxDir can be: E:\oraclehome\tuxedo11gR1

AppDir

Specify the full path to the application directory of the Tuxedo Domain server. For example, while monitoring a Tuxedo server on Windows, your appdir can be: E:\oraclehome\tuxedo11gR1\samples\atmi\simpapp

TuxConfig

Each BEA Tuxedo domain is controlled by a configuration file in which installation-dependent parameters are defined. The binary version of this configuration file is called TuxConfig. The TUXCONFIG file may be given any name; the actual name is the device or system filename specified in the TUXCONFIG environment variable. Specify the name of the TuxConfig file here. For example, while monitoring a Tuxedo server on Windows, your TuxConfig can be:E:\oraclehome\tuxedo11gR1\samples\atmi\simpapp\tuxconfig

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Servers connected

Indicates the number of servers currently connected to this queue.

Number

 

Average queue length

Indicates the average number of requests in this queue.

Number

A high value or a consistent increase in this value could indicate a potential overload condition.

Service requests queued

Indicates the number of service requests in this queue.

Number

 

All requests in queue

Indicates the actual number of requests in this queue.

Number