C H A P T E R  8

System Tab

The System tab displays performance information about the region, as well as configuration information.


procedure icon  To Select the Type of Information to Display

1. Open a region window and select the System tab.

See Displaying a Region's Window.

2. Click the drop-down arrow at the top of the System tab.

3. Select the topic you want to view.

The following topics are available from the System tab:


Performance Overview

The Performance Overview window displays information related to overall system overhead, and on a per transaction class basis.

At the top of the pane, there are two datapoints that apply to the region:

The rest of the pane contains datapoints related to the transaction classes defined for the region. You can view the information for individual transaction classes or for all transaction classes. Use the drop-down list to select a transaction class or all transaction classes.

The following datapoints are also displayed:

TABLE 8-1 Performance Overview Datapoints

Datapoint

Description

CPU (Kernel)

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

CPU (User)

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

Peak Transaction Rate

Peak transaction rate per second. See Peak Transaction Rate.

Peak Transactions Waiting

Maximum number of transactions forced to wait for a transaction processor.

Transaction Processor Restarts

Total number of transaction processor restarts.

Transaction Rate

Current transaction rate per second. See Transaction Rate.

Transactions Aborted

Total number of transactions aborted.

Transactions Deadlocked

Total number of transactions that encountered a deadlock.

Transactions Executed

Total number of transaction executed. See Transactions Executed.

Transactions Waiting

Current number of transactions waiting to be processed.



Performance Details

The Performance Details panel displays details related to active transactions.

Three entries at the top of the pane show:

The following datapoints are displayed on this pane:

TABLE 8-2 Performance Details Datapoints

Datapoint

Description

Task ID

Task identification number.

Before Images

Total number of before images written.

Blocking Buffer

Buffer number the transaction is waiting for.

CICS Command

Last executed CICS command.

CPU (Kernel)

Total system CPU overhead.

CPU (User)

Total user CPU overhead.

Current Locks

Number of locks currently held.

Dataset

Dataset currently being processed.

Elapsed Time

Elapsed time.

Flags

Transaction status flags.

Logical Writes

Total number of logical writes.

Physical Reads

Total number of physical reads.

Physical Writes

Total number of physical writes.

Process ID

Transaction processor process ID.

Program Name

Name of the currently executing program.

Remote System ID

Remote system assigned to this transaction.

Status

Status of this transaction.

Terminal ID

Terminal identifier.

TX Class

Transaction class.

Transaction ID

Transaction name of this task.

User

Current user.

Waiting

True if the task is in the waiting state.

Waits

Total waits.


Transactions Executed

Description

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

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.

Transaction Rate

Description

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

Values

The value of this datapoint is computed as follows:

#Transactions executed (since last update) divided by the Polling 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.

Peak Transaction Rate

Description

Peak Transaction Rate shows the highest number of transactions per second (shown with the Transaction Rate datapoint) calculated for a region since connecting to the region.

Interpretation

The datapoint gives you an idea of what your peak processing performance can be. Your system operates with the most throughput when the Transaction Rate datapoint remains consistently near the Peak Transaction Rate.

However, if the Transaction Rate is consistently close to Peak Transaction Rate, it is possible that the region is running at very close to the maximum throughput of the system and additional resources might be required.

Because this value is only calculated when connected to a region, the value may not represent the actual highest transaction rate achieved by the region. That point might have been reached when the region was not being monitored.


Processes

The Processes pane of the System tab displays information about the processes running in the region. Any of the following processes can be executing:

unikixmain

unikixadmin

unikixstrt

unikixtran0-n

unikixrcv

unikixsched0-n

unikixept

unikixtrin

unikixprt

unikixqm

unikixCommMgr

unikixsock

unikixtcp

 


For each process, the following information is displayed:

TABLE 8-3 Processes Window Datapoints

Datapoint

Description

Name

Process name

CPU (Kernel)

System processor overhead in seconds

Process ID

Process identifier

CPU (User)

User processor overhead in seconds



Logs

The Logs pane enables you to select and view the following system logs:


procedure icon  To Display a Log File

single-step bulletClick the radio button next to the log file you want to view.

The log file contents are displayed in the scrollable window.


Recovery

The Recovery window displays the configuration and status of the recovery file. This window displays the following statistics:

TABLE 8-4 Recovery Window Datapoints

Datapoint

Description

Configured

Indicates if recovery is configured. Values are true or false.

Environment

Environment variable that identifies the file's location. See Environment.

File System

Indicates if the region uses the standard UNIX file recovery method or the Native Recovery File System (NRFS). See File System.

Size

Size of the recovery file in blocks. See Size.

Last Wrap

Last time the (circular) recovery file wrapped. See Last Wrap.

Timeouts

Number of times Sun MTP flushes the file due to a timeout. See Timeouts.

File Usage

Amount of the file used to store recovery information. See File Usage.

Reads

Total number of reads from the recovery file.

Writes

Total number of writes to the recovery file.


If recovery is active for a region, the Recovery window displays recovery attributes specified in the VSAM Configuration Table (VCT). If recovery is not turned on in the VCT, the Configured datapoint is false and the rest of the datapoints are blank. The minimum required size for a recovery file is 100 blocks. To activate recovery, you must set the size to at least 100 blocks in the VCT and restart the region.

One of the most important datapoints to monitor is the Last Wrap time. This datapoint displays the last time the recovery file became full, usually causing transactions to abort and the database file to roll back. If this condition persists, you should analyze the transactions that are causing this condition. They may not be properly accessing the database or syncpointing. In many cases, batch programs can cause the recovery file to wrap due to syncpointing the database at inappropriate intervals. Another reason for recovery file wrap may be that the recovery file is too small. Increase the size and determine if the Last Wrap value is similar to when the file was smaller.

Last Wrap

Description

The Last Wrap datapoint indicates the last time the recovery file became totally full.

Values

If a wrap has not occurred, a zero (0) is displayed. When a wrap occurs, this datapoint displays the date and time of the last wrap.

Interpretation

In Sun MTP, the recovery file is implemented as a circular file. When the file is full, it means records can no longer be written to the file because the tail has caught up with the head of the file. In this case, a transaction must be rolled back to free up the recovery file for further processing. When this happens, the Last Wrap datapoint changes to display the exact time when the wrap occurred. After the rollback occurs, records are again written to the recovery file.

The Last Wrap datapoint must be monitored continuously (and compared to the current time) to catch multiple wraps. When such a condition persists, there are two possible causes:

File Usage

Description

The File Usage datapoint displays the current amount of space (% of the total file space) required in the recovery file for processing before images. The value fluctuates to reflect the amount of output activity generated by a region.

Values

The File Usage datapoint is a number between 0 and 100, displayed to two decimal places. This datapoint is blank when recovery is not active.

Interpretation

The value of File Usage indicates how a particular recovery file's size is handling the traffic generated by a region. When the value stays close to 100%, and the Last Wrap datapoint continues to change, the recovery file size should be increased.

Many things can affect recovery file usage: application output to disk, deadlocks, looping transactions, program aborts, and so on. If the value continues to indicate the need to increase the size of the recovery file as you actually increase the file's size, examine the application programs for problems. A well-behaved set of applications should have an optimum recovery file size.

Environment

Description

The Environment datapoint displays the name of the environment variable that points to the directory where the recovery file is located. The administrator specifies this environment variable in the VCT.

Values

The value of the environment variable can be retrieved on the system running the region using the following command:

$ echo $variable-name

where variable-name is the value displayed by the Environment datapoint. Note that this datapoint is blank when recovery is not active.

Interpretation

The value of Environment must be a valid directory path name. The full path name of the recovery file is the value of the Filename datapoint concatenated to the end of the value of the Environment datapoint. The recovery file can be easily moved by changing the value of Environment in the VCT.

The Environment datapoint has no meaning for a native recovery file. For such a file, the Filename datapoint specifies the complete path name of the actual device (the device name is a file in the file system). Refer to the Sun Mainframe Transaction Processing Software Configuration Guide for information about configuring the Native Recovery File System (NRFS).

Size

Description

The Size datapoint indicates the size of the recovery file as configured for the region.

If the size is less than one hundred blocks, Sun MTP does not perform VSAM recovery.

Values

The Size datapoint displays the size of the recovery file in blocks, not bytes. Each block contains the same number of bytes as the VSAM block size for the system. The default VSAM block size is 4 KBytes. However, the block size can be 4, 8, 16, or 32 KBytes. If recovery is not active, the value is zero (0).

Interpretation

The optimum recovery file size depends on the recovery activity generated by applications running within a region. Logically, the recovery file is treated as a circular file. The actual file is a fixed size. In order to safely provide data integrity, Sun MTP must abort a transaction when the logical tail of the file catches up with the head. The value of the Last Wrap datapoint gives an idea of how often this happens. When the Last Wrap datapoint continues to change, recovery file size is a limiting factor in system performance, and the size should be increased.

One way to calculate a working recovery file size is to base the size on the activity of the transaction that performs the most writes. Each write to a database might generate an accompanying before image to the recovery file (if a successive write is to a different record). Multiply the number of these writes by the number of transaction servers. Then multiply that number by the average record size. Use the result as an initial recovery file size (remember to translate the size from bytes to blocks). Adjust the value when the Last Wrap datapoint shows too much activity.



Tip - You must increase the size of the recovery file more if you are using batch jobs that also require recovery file space.



Timeouts

Description

The Timeouts datapoint displays the number of times Sun MTP flushes before images when an internal (and currently non-configurable) timeout period expires and one of many trigger conditions have not already caused a flush. Sun MTP optimizes recovery file writing by grouping before images together and flushing them all at once. There are a few trigger conditions that cause a flush: reaching a maximum combined size (32 KBytes), reaching a command-line specified number of entries to flush, or experiencing transaction conditions like a syncpoint or end of transaction.

Values

The timeouts datapoint is an integer value initialized to zero at region startup.

Interpretation

The algorithm for writing out before images favors very active systems. You can expect the Timeouts value to be quite low for systems that perform a lot of disk activity. The number of timeouts should increase when a system does not perform very many transactions.

If the Timeouts count increases while the system is quite active, inform your authorized Sun service provider.

File System

Description

This datapoint identifies how I/O to a recovery file is managed. The type of management is determined when the recovery file is configured.

Values

Value

Description

UNIX

When the recovery file is a UNIX file, it is managed by the host file system just like any other file. The file is identified by concatenating the Filename value to the value of the Environment variable.

Native

Native recovery is an alternative method of recovery for a region. A native recovery file resides somewhere on a raw disk partition managed exclusively by Sun MTP. I/O efficiency might be improved with a native recovery file because Sun MTP bypasses overhead inherent in file system management.


Interpretation

On UNIX systems, a native recovery file might offer superior performance over a normal UNIX file. However, the initial setup is more involved for a native file. First, you must choose a free disk area. This could be a completely free raw partition (one not used by a file system), or an unused portion of a raw partition. The space for a native recovery file must be formatted with the Sun MTP kixnrfs utility. Refer to the Sun Mainframe Transaction Processing Software Configuration Guide for more details. Because it is so easy to set up and resize a UNIX recovery file, you can establish an optimum recovery file size with a UNIX file first, then transfer the file to a native organization.


Batch

The Batch panel displays the following information:

TABLE 8-5 Batch Window Datapoints

Datapoint

Description

Batch System

Node name of the configured batch system. See Batch System.

Batch Search Interval

Frequency with which the region checks to determine if a batch job is waiting to run


Batch System

Description

A region can be configured to connect to a Sun MBM node. This connection allows Sun MBM batch jobs to access the region's VSAM datasets. The Batch System datapoint identifies the node directory, which is configured in the region's VCT.

Values

If a node directory is defined, that value is displayed in this datapoint. Otherwise, the value is N/A.

Interpretation

If the region is not configured, Sun MBM batch jobs cannot access VSAM datasets maintained in that region. A region configured for connection to a Sun MBM node does not guarantee a connection. The connection can be verified by examining system messages written to the region's log file, $KIXSYS/unikixmain.log.


Languages

The Languages pane displays the languages used in the programs running in the region.

A box with the language name is displayed in the pane as well as the following datapoints:

TABLE 8-6 Languages Window Datapoints

Datapoint

Description

Configured

Indicates if a language is configured for the region. Values are true and false.

Location

Identifies the directory path where the language is installed.

Version

Indicates the version of the language.



Limits

The Limits panel displays a set of configuration restrictions:

TABLE 8-7 Limits Window Datapoints

Datapoint

Description

Maximum Background Tasks

Indicates the maximum number of background tasks configured.

Maximum Batch Jobs

Indicates the number of batch jobs that can run concurrently in the region.

Maximum Debug Terminals

Indicates the number of debug terminals configured. See Maximum Debug Terminals.

Transaction Processors

Indicates the number of transaction servers configured. See Transaction Processors.

Maximum Users

Indicates the number of concurrent users configured.

Maximum Query Jobs

Indicates the number of query jobs that can run concurrently in the region.

Terminal Timeout

Indicates the terminal timeout in seconds.


Transaction Processors

Description

The Transaction Processors datapoint displays the number of transaction servers available for executing transactions. Each transaction server is a system process.

Values

The number of Transaction Processors is the number of transaction servers configured for the region.

Maximum Debug Terminals

Description

The Maximum Debug Terminals datapoint indicates how many debug terminals are available for debugging a region.

Values

The value of Maximum Debug Terminals is the number configured for the region.

Interpretation

This datapoint represents the number of transaction servers to be used for executing transactions in debug mode.

If this value is zero, no debugging can be performed.


Accounting

The Accounting panel displays a set of configuration options.

TABLE 8-8 Accounting Window Datapoints

Datapoint

Description

System Accounting

Indicates whether system-level accounting is enabled. Values are true or false.

Transaction Accounting

Indicates whether default transaction accounting is enabled. Values are true or false.

User Accounting

Indicates whether default user accounting is enabled. Values are true or false.