Chapter 1

The DECevent Event Management Utility Overview

This chapter discusses the DECevent event management utility, the translation of events, analysis and notification, and the DECevent graphical user interface.

1.1 Introduction

The DECevent event management utility provides the interface between a system user and the operating system's event logger. DECevent provides the following two main functions:

1.2 DECevent and the Translation of Events

Users can request the translation of events from specific event logs into a variety of ASCII reports. The format and contents of the ASCII reports is determined by flags and parameters entered on the command line interface (CLI). The maximum length of the command line is limited to 255 characters.

DECevent translation has the following features:

You also can maintain and customize the user environment with the interactive shell commands.

Necessary Privileges

Tru64 UNIX users need superuser privileges to use the translation and reporting features of DECevent, unless the event log file protection has been changed to allow all users to access the event log files.

1.3 DECevent Analysis and Notification

The added value function of DECevent provides constant monitoring of a system's event logger. When a significant number of events have occurred so that a DECevent threshold has been crossed, automatic analysis of the event is performed. Automatic analysis can result in the generation of Compaq-specific theory codes that enable Multivendor Customer Services to identify one or more failing field replaceable units (FRU).

Depending upon the theory codes generated from analysis, repair actions may be initiated. Also, depending upon the results of analysis, the proper individuals are notified of the event.

The analysis and notification flags allow the following features:

In addition to automatic analysis and notification, DECevent allows you to perform manual analysis on a user supplied event log. Manual analysis can also result in the generation of Compaq-specific theory codes that enable Multivendor Customer Services to determine a failing FRU.

Necessary Privileges

Tru64 UNIX users need superuser privileges to use the analysis and notification features of DECevent.

Note

A product authorization key (PAK) license is required to utilize the DECevent analysis and notification added-value options. The license is obtained by a Compaq Customer Services engineer through the technical information management architecture (TIMA) and must be installed on your system prior to kit installation. To find the DECevent service PAK in TIMA, select the TIMA tools database and search for "Service PAKS." The title of the tool you need is "Service Tools Product Authorization Key (PAK) Distribution Tool." Refer to TIMA documentation for specifics.

In addition, customers may acquire the PAK information by requesting it from DSNlink hardware support. If DSNlink is installed on your system, type DSNLINK ITS at the system prompt and open the database articles for your operating system. Search for DECEVENT and select the article with the PAK information. You also can refer to the DSNlink for OpenVMS Users's Guide (AA-PBL4D-TE) for further information about DSNlink.

Licenses are verified at run time by the License Management Facility (LMF). For more information on LMF concepts and operation, enter the HELP LICENSE command at the DCL ($) prompt.

1.4 The DECevent Graphical User Interface

In addition to entering commands on the CLI, you have the option of using the DECevent graphical user interface (GUI) to perform translation and analysis. The DECevent Graphical User Interface User's Guide (AA-QE26A-TE) contains all the information necessary for you to use the GUI.