C H A P T E R  5

Machine and Region Windows

This chapter describes the machine and region windows.


Displaying the Machine Window

After you add a machine, you can display a window that contains summary information about the system and the regions running on it.

The machine window has two tabs:


procedure icon  To Display the Machine Window

single-step bulletUse either method:

The machine window opens and displays the General tab by default. The title bar contains the machine name and port number.

The datapoints on the General tab are:

TABLE 5-1 General Tab Datapoints

Datapoint

Description

Name

Name of the machine.

Port

Port number.

State

State of the machine. See Machine States.


Machine States

The icon and the color of the machine name indicate the state of the system:

Region States

A region can have one of the following states, which is denoted by an icon:

TABLE 5-2 Region States

Icon

State

 Region running icon

 

Can be contacted and running

 Region not running icon

 

Can be contacted and not running

 Region can't be contacted icon

 

Cannot be contacted

When a region cannot be contacted, its name is red.



MTP Regions Tab

The machine window's MTP Regions tab lists each region on a host and a set of datapoints about that region.


procedure icon  To Display the Regions Running on a Host

1. Double-click the machine name in the list panel.

2. In the machine window, click the MTP Regions tab.

The table of regions is displayed.

3. Select the region whose details you want to view.

4. Click the Show Details box in the lower left corner of the window.

A panel listing the table details in a more readable format is displayed. You can resize this panel by dragging its top slider.

The datapoints on the region window are as follows:

TABLE 5-3 MTP Regions Tab Datapoints

Datapoint

Description

Name

Name of region, as defined when the region was registered.

Region Home

The path name of the region's $KIXSYS directory.

Running

Indicates if the region is running. Values are true and false.

System CPU

Total system processor time (CPU) for all transaction processors (in seconds). See System CPU.

Transaction Rate

Current transaction rate per second. See Transaction Rate.

Transactions Executed

Total number of transactions executed. See Transactions Executed.

Tx Classes

The total number of transaction classes configured for this region. The value includes the two reserved transaction classes KIXADMIN and KIXDFLT.

Tx Servers Configured

Number of transaction servers configured for this region

User CPU

Total user processor time (CPU) for all transaction processors (in seconds). See User CPU.

Users

Number of users connected to the region. See Users.


System CPU

Description

The System CPU utilization represents the amount of time spent executing system calls on behalf of a given region.

Values

The value is in the format: hh:mm:ss.

The time displayed is not very precise, because it is measured in units of seconds.

Interpretation

This value tells the administrator how much System CPU a region requires to process transactions. If this datapoint and the User CPU datapoint add up to actual wall clock time, the machine's hardware configuration may be saturated. In this case, either application optimization or additional hardware might be required.

Transaction Rate

Description

The Transaction Rate value shows the average number of transactions executed in a second by a region.

Values

The value is computed as follows:

#Transactions executed (since last update) divided by the Update Interval

Interpretation

This value gives you an idea of a particular region's throughput. This value can be more accurately computed by using a shorter polling interval. However, a shorter polling interval requires substantially more processing overhead.

The value of this datapoint can be influenced by many factors external to the region. For example, a development server's activities will cause a region to run slower than if the region has a dedicated machine.

Transactions Executed

Description

The Transactions Executed datapoint represents the cumulative total of transactions executed since the region was started.

Values

This value is retrieved directly from Sun MTP.

Interpretation

This value is used to compute the transaction rate for a particular region.

As long as your system is operating properly, and users are performing transactions, this datapoint should continue to increase. When this datapoint stops growing, check to make sure that all the transaction servers are idle and that no one is logged on to the system. If that is not the case, search for hang conditions.

User CPU

Description

The User CPU datapoint represents the amount of CPU time spent executing application code (not operating system calls) on behalf of a region.

Values

The value is in the format: hh:mm:ss.

The time displayed is not very precise, because it is measured in units of seconds.

Interpretation

This value tells the administrator how much User CPU a region requires to process transactions. If this datapoint and the System CPU datapoint add up to actual wall clock time, a machine's hardware configuration may be saturated. If this is the case, you must either optimize your application or consider adding additional hardware.

Users

Description

The Users datapoint shows the total number of users that are currently logged in to a region.

Values

This number ranges from 0 to the maximum number of users licensed for this region. It goes up and down depending on users logging in and out.

Interpretation

If this number is consistently close to the licensed maximum number of users, you should consider increasing your license since the region will disallow logins once the maximum licensed number is reached.