Using Performance Cubes

The Performance Agent component of CA Performance Management for OpenVMS can create a performance data file, called a cube, which is readable by CA NSM Performance Manager on the CA NSM Management station. When you install the Performance Agent on OpenVMS, you are asked questions related to the creation of this cube, including if you want to activate the Performance Cube functionality.

Note: You do not have to activate this functionality for CA Performance Agent for OpenVMS to function properly on an OpenVMS system.

When activated, Performance Agent creates a cube file and periodically transfers that cube file to the CA NSM Management station. When you install CA Performance Agent on an OpenVMS system, the following text file is created:

CAPOLY$DATA:CAPOLY$CUBE_OPTIONS.DAT

This file is created whether or not a CA NSM Management Station exists and whether or not you activate the functionality. Creating this file ensures that you do not have to completely reinstall CA NSM Performance Agent for OpenVMS to activate the functionality. This file contains the following information:

CA NSM Management Station Name - Identifies the name of the CA NSM Management Station Name. If you do not have a CA NSM Management station, you should enter a fictitious nodename when prompted. The fictitious nodename is stored in the CAPOLY$DATA:CAPOLY$CUBE_OPTIONS.DAT text file. You can change this name using any text editor. Look for the keyword DATABASE and change the node name accordingly. For example, if the node name entered during installation was NSMMGT1, the text file contains the following line:
```
DATABASE "NSMMGT1"
```
To change the node name, replace NSMMGT1 with the correct node name.
Timeband - Identifies the length of the interval that the data represents. When you are prompted for timeband during installation, enter a number in minutes. The default is 60. In the CAPOLY$DATA:CAPOLY$CUBE_OPTIONS.DAT text file, this information is stored in seconds. Look for the keyword TIMEBAND in the data file. For example, the default of 60 minutes is represented as the following code:
```
TIMEBAND "3600"
```
To change the interval, replace 3600 seconds with the desired interval expressed in units of seconds.
Data Items - Identifies the data items to be included in the cube file. The following code represent default entries:
```
PROCESS  "Process process page count"   Y
PROCESS  "Process WorkSet size limit"   N
```
Where Y indicates that the "Process process page count" data is to be included and the N indicates that the "Process WorkSet size limit" data is not to be included in the cube file. You can edit the file by changing the Y and N to get the desired data.

The following lists include the default data items and their default setting (Y or N) in the cube options supplied during the installation. Data items are organized into groups of related items.

For a brief description and interpretation of these data items, see chapter 5 of the CA Performance Management for OpenVMS Performance Agent Administrator guide.

This section contains the following topics:

Tell Technical Publications how we can improve this information