Tuxedo Sites Test

This test reports statistics pertaining to each site configured under a Tuxedo domain.

Target of the test : A Tuxedo Domain Server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for the 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.

WSNAddr

The network address of the workstation listener that is to be contacted for access to the Tuxedo application. This variable is required for Workstation clients and is ignored for native clients. When invoked by a workstation client, this variable is used within tpinit().

Example:

TCP/IP addresses may be specified in the following forms: 

//host.name:port_number

OR 

//#.#.#.#:port_number, where port_number is the port at which the WSL (Workstation listener) is started for a Tuxedo application or domain.

WSDevice

Specify the name of the device to be used to access the network. This variable is required for Workstation clients and is ignored for native clients. When invoked by a workstation client, this variable is used within tpinit().

Example:

On Unix machines, the value of this parameter can be /dev/tcp.

TuxLibPath

Specify the path to the Tuxedo library.

Example:

On Unix machines, the value of this parameter can be in the form: <TUXEDO_INSTALL_DIR>/lib. On Windows, it can be in the form: <TUXEDO_INSTALL_DIR>\lib.

TuxDir

Specify the installation directory of the Tuxedo domain server.

UserName

If security is enabled for an application, then provide the user name that can be used to connect to the application. Otherwise, enter None.

Password

If security is enabled for an application, then provide the password for the above-mentioned UserName. Otherwise, enter None.

Confirm Password

Confirm the password (if specified) by retyping it here.

TuxConfig

Provide the full path to the tuxconfig file used to run the Tuxedo application.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Site state

Indicates the state of a site configured under a Tuxedo domain.

 

It could take any of the following values:

Value

State

Explanation

1

Active

Indicates that the site is defined and active

2

Partitioned

Indicates that the site defined and active, but is currently unreachable. This state is equivalent to Active for the purpose of determining permissions.

3

Inactive

Indicates that the site is defined and inactive

 

Transaction aborts

Indicates the number of clients, both native and Workstation, who are currently logged in to the site

Number

 

Transaction commits

Indicates the number of Workstation clients, currently logged in to the site

Number

 

TListen state

Indicates the state of the Tlisten process running on this site

Number

This measure takes the value 1 or 2. 1 implies that the process is active and 2 implies that the process is not running or inactive.

Total clients

Indicates the number of clients, both native and Workstation, who are currently logged in to the site

Number

 

Workstation clients

Indicates the number of Workstation clients, currently logged in to the site

Number

 

Conversations

Indicates the number of active conversations with participants on the site

Number

 

Global transactions

Indicates the number of global transactions the site is currently involved in

Number

 

Current load

Indicates the rate at which load is queued on this site

Loads/sec

 

Work completions

Indicates the rate at which work is completed by this site

Works/sec

 

Work initiations

Indicates the rate at which work is initiated on this site by clients/servers

Works/sec

 

Transaction initiations

Indicates the rate at which transaction is initiated from this site

Trans/sec