TuxedoServer Test

This test measures the performance of each server running under each site hosted on a Tuxedo application.

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

Server state

Indicates the state of a server running on a particular site.

Number

It could take any of the following values:

Value

State

Explanation

1

Active

Indicates that the server object is defined and active

2

Migrating

Indicates that the server is defined and currently in a state of migration to the server group’s secondary logical machine

3

Cleaning

Indicates that the server object is defined and is currently being cleaned up by the system after an abnormal death

4

Restarting

Indicates that the server object defined and is currently being restarted by the system after an abnormal death

5

Suspended

Indicates that the server object is defined and is currently suspended pending shutdown

6

Partitioned

Indicates that the server object is defined and active; however, the machine where the server is running is currently partitioned from the master site

7

Dead

Indicates that the server object is defined, identified as active in the bulletin board, but currently not running due to an abnormal death

8

Inactive

Indicates that the server object is defined and inactive

 

Workload completions

Indicates the rate at which workload was completed by the server.

Works/Sec

 

Total conversations

Indicates the total number of conversations initiated by the server

Number

 

Active conversations

Indicates the number of currently active conversations initiated by the server

Number

 

Total requests

Indicates the total number of requests made by the server via tpcall() or tpacall().

Number

 

Active requests

Indicates the number of currently active requests made by the server via tpcall() or tpacall().

Number

 

Transaction initiations

Indicates the rate at which transactions were begun by the server since it was last restarted.

Trans/sec

 

Transaction aborts

Indicates the rate at which transactions were aborted by the server since it was last restarted.

Trans/sec

 

Transaction commits

Indicates the rate at which transactions were committed by the server since it was last restarted.

Trans/Sec