Updated: 11 December 1998

DECamds User's Guide

To display more information about an event, click MB3 on the event in the Event Log window, and then choose Display. Depending on the event, you have one or more event display choices that give you more information about the event. Figure 2-5 shows a sample event display choice dialog box.

Figure 2-5 Event Display Choice Dialog Box

To take corrective action on an event, click MB3 on the event in the Event Log window, and then choose Fix. Depending on the type of event, one or more of the following event fix choices are displayed (not all events have all fix options):

• Adjust process working set
• Crash node
• Delete a process
• Exit an image
• Lower process priority
• Purge process working set
• Raise process priority
• Resume a process
• Suspend a process

See Chapter 4 for detailed information about performing fixes.

2.3.3 Sending Event Information to OPCOM

By default, events that meet both of the following criteria are sent to OPCOM:

• Have a severity level of 90 or above
• Occur continuously for 600 seconds (10 minutes)

You can change either criterion by choosing Filter Data... from the Customize menu of the Event Log window. For more information on changing Event Log filters, see Chapter 5.

2.3.4 Removing an Event from the Event Log Window

To remove an event from the Event Log window, click MB3 on an event, and choose Remove from the menu. An event reappears if DECamds routine sampling detects the same situation that caused the original log entry.

2.3.5 Retaining and Releasing an Event in the Event Log Window

Event Log entries are removed when the underlying cause is removed, so an event might disappear from the Event Log window. To retain the selected event in the Event Log window, click MB3 on an event and choose Freeze. When an event is frozen, the Time field is highlighted.

To release the selected event, click MB3 on the event and choose Unfreeze.

This chapter describes the DECamds data windows that you can display from the System Overview and Event Log windows.

Figure 3-1 shows the hierarchy of the DECamds data windows.

Figure 3-1 DECamds Data Window Hierarchy

Table 3-1 describes the data windows and their functions.

Table 3-1 DECamds Data Windows

Window	Reference	Opened from Window	Displays
Disk Status Summary	Section 3.1	Event Log System Overview	Disk device data including path, volume name, status, and mount, transaction, error, and resource wait counts.
Volume Summary	Section 3.2	Event Log System Overview	Disk volume data, including path, volume name, disk block utilization, queue length, and operation count rate.
Single Disk Summary	Section 3.3	Disk Status Summary Volume Summary	Summary data about each node in the group in which a disk is available.
Page/Swap File Summary	Section 3.4	Event Log System Overview	Data about page and swap names and utilization, including free, used, and reserved pages.
Node Summary	Section 3.5	Event Log System Overview	Overview of a specific node's resource demand on the CPU state queues and processor modes, memory utilization, page faults, and I/O.
Process I/O Summary	Section 3.6	Event Log Node Summary System Overview Single Disk Summary	Statistics about I/O utilization by process, including buffered I/O, direct I/O, and page write I/O; also lists various I/O quotas.
CPU Modes Summary	Section 3.7	Node Summary	A graphic representation of each CPU's processor modes, listing the process currently executing in the CPU.
CPU Summary	Section 3.8	Event Log Node Summary System Overview	Statistics about CPU utilization by process, including process state, priority, execution rate, CPU time, and wait time.
Memory Summary	Section 3.9	Event Log Node Summary System Overview	Statistics about memory usage by process, including process working set count, quota and extent, and paging rates.
Single Process Summary	Section 3.10	Event Log Any data window	Specific data about a process, basically a combination of data elements from the CPU, Memory, and Process I/O displays, as well as data for specific quota utilization, current image, specific process information, and wait queue time.
Lock Contention Summary	Section 3.11	Event Log System Overview	Data about each resource for which a potential lock contention situation exists.
Single Lock Summary	Section 3.12	Event Log Lock Contention Summary	Specific data about the blocking lock and any other locks in the granted, conversion, or waiting queues.
Cluster Transition/Overview Summary	Section 3.13	Event Log System Overview	Summary information about each node's membership in an OpenVMS Cluster.
System Communication Architecture Summary	Section 3.14	Cluster Transition/Overview Summary	System Communication Architecture (SCA) information about a selected node's connection or connections to other nodes in a cluster.
NISCA Summary	Section 3.15	System Communication Architecture Summary	Summary information about the Network Interconnect System Communication Architecture (NISCA) protocol, which is responsible for carrying messages to other nodes in the cluster.

3.1 Disk Status Summary Window

The Disk Status Summary window shown in Figure 3-2 displays data about availability, count, and errors of disk devices on the system.

Figure 3-2 Disk Status Summary Window

To open a Disk Status Summary window, do one of the following:

• In the System Overview window, click MB3 on a node or group line, choose Display from the menu, and choose Disk Status Summary from the submenu.
• In the Event Log window, click MB3 on any disk status-related event, and choose Display from the menu.

Table 3-2 describes the Disk Status Summary window data fields.

Table 3-2 Disk Status Summary Window Data Fields

Field	Displays
Device Name	The standard OpenVMS device name that indicates where the device is located, as well as a controller or unit designation.
Path	The primary path (node) from which the device receives commands.
Volume Name	The name of the media that is currently mounted.
Status	One or more of the following disk status values: Alloc Disk is allocated to a specific user CluTran Disk status is uncertain due to a cluster state transition in progress Dismount Disk in process of dismounting; may be waiting for a file to close Foreign Disk is mounted with the /FOREIGN qualifier Invalid Disk is in an invalid state (likely Mount Verify Timeout) MntVerify Disk is waiting for a mount verification Mounted Disk is logically mounted by a MOUNT command or service call Offline Disk is no longer physically mounted in device drive Online Disk is physically mounted in device drive Shadow Set Member Disk is a member of a shadow set Unavailable Disk is set /UNAVAILABLE Wrong Volume Disk has been mounted with the wrong volume name Wrtlck Disk is mounted and write locked
Errors 1	The number of errors generated by the disk (a quick indicator of device problems).
Trans 1	The number of currently-in-progress file system operations for the disk.
Mount 1	The number of nodes that have the specified disk mounted.
Rwait 1	An indicator that a system I/O operation is stalled, usually during normal connection failure recovery or volume processing of host-based shadowing.

DECamds detects the following disk status-related events and displays them in the Event Log window. Node refers to the name of the node that is signaling the event. Disk refers to the name of the disk to which the event is related.

• DSKERR, node disk disk error count is high
• DSKINV, node disk disk is in an invalid state
• DSKMNV, node disk disk mount verify in progress
• DSKOFF, node disk disk is off line
• DSKRWT, node disk disk Rwait count is high
• DSKUNA, node disk disk is unavailable
• DSKWRV, node disk wrong volume mounted

The Volume Summary window shown in Figure 3-3 displays summary data about disk volumes mounted in the system. Volume summary data is accurate when every node in an OpenVMS Cluster environment is in the same group. Multiple clusters can share a group, but clusters cannot be divided into different groups without losing accuracy.

Figure 3-3 Volume Summary Window

To open a Volume Summary window, do one of the following:

• In the System Overview window, click MB3 on a node or group line, choose Display from the menu, and choose Volume Summary from the submenu.
• In the Event Log window, click MB3 on any volume-related event, and choose Display from the menu.

Table 3-3 describes the Volume Summary window data fields.

Table 3-3 Volume Summary Window Data Fields

Field	Displays
Device Name	The standard OpenVMS device name that indicates where the device is located, as well as a controller or unit designation.
Path	The primary path (node) from which the device receives commands.
Volume Name	The name of the mounted media.
Used	The number of volume blocks in use.
% Used	The percentage of the number of volume blocks in use in relation to the total volume blocks available.
Free	The number of blocks of volume space available for new data.
Queue	The average number of I/O operations pending for the volume (an indicator of performance; less than 1.00 is optimal).
OpRate	The rate at which the operations count to the volume has changed since the last sampling. The rate measures the amount of activity on a volume. The optimal load is device-specific.

DECamds detects the following volume-related events and displays them in the Event Log window. Node refers to the name of the node that is signaling the event. Disk refers to the name of the disk to which the event is related. Group refers to the name of the group to which the event is related.

• DSKQLN, node disk disk volume queue length is high
• LOVLSP, group disk disk volume free space is low

The Single Disk Summary window shown in Figure 3-4 displays summary data about each node in the group in which a disk is available. This window is a node-by-node display of the data that is summarized in the Disk Status Summary and Volume Summary windows. The values displayed are those you would see if you displayed Disk Status Summary or Volume Summary for each node within the group.

You can use this display to determine both of the following:

• Which node in the group has a disk with high I/O rates
  Determining which node has a high I/O rate to the disk is useful because you can sort by direct I/O rate and learn which process or processes are causing the high I/O rates to the disk.
• If a disk is in a state that is inconsistent with other nodes
  Determining which node or nodes might be in an abnormal state is useful because you can then discover if, for some reason, one node believes that the disk is in the MntVerify or CluTran state, thus holding up processing in the cluster in which the node resides.

Figure 3-4 Single Disk Summary Window

To open a Single Disk Summary window, follow these steps:

1. In the System Overview window, click MB3 on a group or node name.
   The system displays a pop-up menu.
2. Choose Display from the menu and Disk Status Summary (or Volume Summary) from the submenu.
   The system displays the Disk Status Summary window (or Volume Summary window).
3. In the Disk Status Summary window (or Volume Summary window), click MB3 on a device name.
   The system displays a pop-up menu.
4. Choose Display Disk.
   The system displays the Single Disk Summary window.

As an alternative to steps 3 and 4, you can can double-click MB1 on a line in the Disk Status Summary or Volume Summary window to display the Single Disk Summary window.

Note that when you click on an item, DECamds temporarily stops updating the window for 15 seconds or until you choose an item from a menu.

Table 3-4 lists the Single Disk Summary window data fields.

Table 3-4 Single Disk Summary Window Data Fields

Field	Displays
Node	Name of the node
Status	Status of the disk: mounted, online, offline, and so on
Errors	Number of errors on the disk
Trans	Number of currently-in-progress file system operations on the disk (number of open files on the volume)
Rwait	Indication of an I/O stalled on the disk
Free	Count of free disk blocks on the volume An (M) after the free block count indicates this node holds the lock on the volume that DECamds uses to obtain the true free block count on the volume. Other nodes might not have accessed the disk, so their free block count might not be up to date.
QLen	Average number of operations in the I/O queue for the volume
OpRate	Count of rate of change to operations on the volume

From the Single Disk Summary window, you can display the Process I/O Summary window. See Section 3.6 for more information.

3.4 Page/Swap File Summary Window

The Page/Swap File Summary window shown in Figure 3-5 displays data about a node's page/swap file usage and identifies page or swap files that are overused or underconfigured. It also displays nodes that lack a page or swap file.

Figure 3-5 Page/Swap File Summary Window

To open a Page/Swap File Summary window, do one of the following:

• In the Event Log window, click MB3 on any event, and choose Display from the menu displayed. Then choose Page/Swap File Summary from the submenu displayed.
• In the System Overview window, click MB3 on any node or group line, and choose Display from the menu displayed. Then choose Page/Swap File Summary from the submenu displayed.

Table 3-5 describes the Page/Swap File Summary window data fields.

Table 3-5 Page/Swap File Summary Window Data Fields

Field	Displays
Node Name	The name of the node on which the page/swap file resides.
File Name	The name of the page/swap file. For secondary page/swap files, the file name is obtained by a special AST to the job controller on the remote node. DECamds makes one attempt to retrieve the file name.
Used	The number of used pages or pagelet blocks within the file.
% Used	A graph representing the percentage of the blocks from the available page or pagelet blocks in each file.
Total	The total number of pages or pagelet blocks within the file.
Reservable	The number of pages or pagelet blocks that can be logically claimed by a process for future physical allocation. This value can be listed as a negative value, because it is merely a value of a process's interest in getting pages from the file. If every process currently executing needed to use the file, then this value is the debt that is owed.

DECamds detects the following page and swap file-related events and displays them in the Event Log window. Node is replaced by the name of the node to which the event is related.

• LOPGSP, node file page file space is low
• LOSWSP, node file swap file space is low
• NOPGFL, node has no page file
• NOSWFL, node has no swap file

Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal

5929PRO_002.HTML