Tuxedo PIA Server Details Test

Using this test, administrators can figure out how many server processes in the domain are currently servicing requests, how many are active and ready for requests but have not been assigned requests yet, and the number of server processes that are not even ready for requests. With the help of the detailed diagnosis of this test, administrators can swiftly identify which server process is in which state presently, the number of requests being handled by each server process currently, and the total number of requests per server process for which processing is complete. Using this information, administrators can determine the following:

  • Which server processes are idle?
  • Which server processes are active, but are not processing any request?
  • Which server process is handling too many requests currently?

Target of the test : A Tuxedo Application Server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for the application server domain 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 number at which the specified Host listens to. By default, this will be 12345.

PSAdmin Home

To collect metrics from a Tuxedo application server, this test runs PeopleSoft Server Administration (PSADMIN) commands on the target server. The first step towards this is to launch the psadmin.exe. To enable the test to run the psadmin.exe, you need to configure the test with the full path to the directory in which the psadmin.exe resides. Therefore, in the PSAdmin Home text box, specify the location of the psadmin.exe. Typically, this will be the install directory of the Tuxedo application server. For instance, on Windows, your specification can be C:\ps\appsrv and on Unix, your specification can be: opt/ps/appsrv

Domain

An application server Domain is the collection of server processes, supporting processes, and resource managers that enable connections to the database. A single application server machine can support multiple application server domains running on it. A server process is executable code that receives incoming transaction requests. The server process carries out a request by making calls to a service. Using a managed Tuxedo application server, you can monitor only those server processes and transactions that pertain to a single domain. This is why, the eG agent needs to be explicitly configured with the application server Domain it needs to monitor. 

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise suite embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability
  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Active servers

Indicates the number of server processes that are active, but are not processing any request currently.

Number

Use the detailed diagnosis of this measure to know which are the active server processes.

Running servers

Indicates the number of server processes that are actively servicing requests presently.

Number

Use the detailed diagnosis of this measure to know which server processes are running currently.

Idle servers

Indicates the number of server processes that are not even ready for servicing any requests currently.

Number

Use the detailed diagnosis of this measure to know which are the idle server processes.

Other servers

Indicates the number of server processes that are in any other state.

Number

Use the detailed diagnosis of this measure to know which server processes are in a state other than Active, Running, or Idle.

To identify the idle server processes, use the detailed diagnosis of the Idle servers measure.

DDidleservers

Figure 1 : The detailed diagnosis of the Idle servers measure of the Tuxedo PIA Server Details test