Document revision date: 30 March 2001 | |
Previous | Contents | Index |
If ERRFMT$_SEND_MAIL is defined to be TRUE, you receive a mail message with a subject line saying that ERRFMT is about to delete itself. The operator log file and the output displayed at the system console, OPA0:, contain more detailed information about the failure encountered and instructions on how to restart ERRFMT; however, you are often not at the console to see this information.
If you are using ERRFMT in one mode, for example, with sending mail enabled, and you want to disable sending mail, use the system manager's account to edit SYS$STARTUP:SYLOGICAL.COM, adding the following command:
$ DEFINE/SYSTEM ERRFMT$_SEND_MAIL FALSE |
To reenable sending mail, use the system manager's account to edit SYS$STARTUP:SYLOGICAL.COM, adding the following command:
$ DEFINE/SYSTEM ERRFMT$_SEND_MAIL TRUE |
Sending mail to the SYSTEM account is enabled by default. However, you can define ERRFMT$_SEND_TO to send mail to another user if ERRFMT is about to delete itself.
To change the user name to receive mail, use the system manager's account to edit SYS$STARTUP:SYLOGICAL.COM, adding an appropriate logical name DEFINE command. For example:
$ DEFINE/SYSTEM ERRFMT$_SEND_TO R_SMITH |
Compaq recommends that you do not use distribution lists and multiple
user names.
20.4 Using ERROR LOG
Use the Error Log utility (ERROR LOG) to report selectively on the
contents of an error log file. You must have the SYSPRV privilege to
run ERROR LOG.
Starting with OpenVMS Version 7.2, before using the Error Log utility,
you need to translate error log files using the Binary Error Log
Translation utility, which is part of DECevent. For more information,
refer to its documentation, which is included in the DECevent kit.
20.4.1 Understanding ERROR LOG
ERROR LOG supports most OpenVMS supported hardware, such as adapters, disks, tapes, CPUs, and memories, but not all communications devices. Some synchronous communications devices are supported.
The operating system automatically writes messages to the latest version of an error log file, SYS$ERRORLOG:ERRLOG.SYS, as the events shown in Table 20-3 occur.
Event | Description |
---|---|
Errors | Device errors, device timeouts, machine checks, bus errors, memory errors (hard or soft error correcting code [ECC] errors), asynchronous write errors, and undefined interrupts |
Volume changes | Volume mounts and dismounts |
System events | System startups, messages from the Send Message to Error Logger ($SNDERR) system service, and time stamps |
You can use ERROR LOG to process error log entries for the following forms of optional output:
Section 20.4.2 explains how to produce error log reports. Refer to the OpenVMS System Management Utilities Reference Manual for examples of error log reports.
The error reports that ERROR LOG produces are useful in two ways:
The detailed contents of the reports are most meaningful to Compaq support representatives. However, you can use the reports as an important indicator of the system's reliability. For example, using the DCL command SHOW ERROR, you might see that a particular device is producing a relatively high number of errors. You can then use ERROR LOG to obtain a more detailed report and decide whether to consult your support representative.
If a system component fails, a Compaq support representative can study the error reports of the system activity leading up to and including the failure. If a device fails, you can generate error reports immediately after the failure; for example:
Your support representative can then run the appropriate diagnostic program for a thorough analysis of the failed device. Using the combined error logging and diagnostic information, your support representative can proceed to correct the device.
Error reports allow you to anticipate potential failures. Effective use
of the Error Log utility in conjunction with diagnostic programs can
significantly reduce the amount of system downtime.
20.4.2 Producing Error Log Reports
You enter the DCL command in the following format:
ANALYZE/ERROR_LOG [/qualifier(s)][filespec[,...]]
where:
qualifier | Specifies the function the ANALYZE/ERROR_LOG command is to perform. |
filespec | Specifies one or more files that contain information to be interpreted for the error log report. |
Refer to the OpenVMS System Management Utilities Reference Manual for details about the command and its parameters and for examples of error log reports.
ERROR LOG issues error messages for inconsistent error log entries. Use
the Help Message facility to look up explanations and suggested user
actions for these messages.
20.4.3 Producing a Full Error Log Report
The following steps show how to produce an error log report for all entries in the error log file and how to print the report:
$ SET PROCESS/PRIVILEGE=SYSPRV |
$ SET DEFAULT SYS$ERRORLOG |
$ DIRECTORY |
$ ANALYZE/ERROR_LOG/OUTPUT=ERRORS.LIS |
$ PRINT ERRORS.LIS |
$ SET PROCESS/PRIVILEGE=SYSPRV $ SET DEFAULT SYS$ERRORLOG $ DIRECTORY (1) Directory SYS$SYSROOT:[SYSERR] ERRLOG.OLD;2 ERRLOG.OLD;1 ERRLOG.SYS;1 Total of 3 files. $ ANALYZE/ERROR_LOG/OUTPUT=ERRORS.LIS ERRLOG.OLD (2) $ PRINT ERRORS.LIS (3) |
The following list explains the commands in the example.
This section briefly explains how to specify report formats and produce a report of selected entries.
Table 20-4 contains error log report options. For more details about options and examples of error log reports using options, refer to the OpenVMS System Management Utilities Reference Manual.
In Order To... | You Can... |
---|---|
Specify report formats |
Change report formats by using qualifiers, including the following ones:
|
Specify a display device for reports | Use the /OUTPUT qualifier to send reports to a terminal for display or to a disk or magnetic tape file. By default, the system sends the report to the SYS$OUTPUT device. Because error log reports are 72 columns wide, you can display them on the terminal screen. |
Produce a report of selected entries |
Use qualifiers to produce error log reports for specific types of
events and for a specified time interval. For example, you can process
error log entries by selecting a time interval using the /SINCE,
/BEFORE, or /ENTRY qualifiers.
You can specify error log entries for specific events by using the qualifiers /INCLUDE and /EXCLUDE. These qualifiers form a filter to determine which error log entries are selected or rejected. In addition, you can generate error log reports for one or more OpenVMS Cluster members by using the /NODE qualifier. |
Exclude unknown error log entries | By default, when ANALYZE/ERROR_LOG encounters an unknown device, CPU, or error log entry, the utility produces the entry in hexadecimal longword format. Exclude these entries from the report by specifying /EXCLUDE=UNKNOWN_ENTRIES in the command line. |
The DECevent Event Management utility (DECevent) provides an interface between a system user and the operating system's event log files.
On Alpha DS, ES, and GS systems (other than the AlphaServer GS60 and GS140 systems) running OpenVMS, use the Web-Based Enterprise Services (WEBES), which includes the Compaq Analyze, Compaq Crash Analysis Tool (CCAT), and the Revision and Configuration Management (RCM) tools. You can find WEBES and its documentation on the Compaq System Tools CD-ROM, which is included in the OpenVMS Version 7.3 CD-ROM package. You can find the most up-to-date service tool information at the following location:
You cannot use WEBES on the AlphaServer GS60 or the AlphaServer GS140. DECevent and the WEBES tools can be used together in a cluster. |
DECevent allows system users to produce ASCII reports derived from system event entries. The format of the ASCII reports depends on the command entered on the command language interpreter (CLI) with a maximum character limit of 255 characters.
DECevent uses the error log file, SYS$ERRORLOG:ERRLOG.SYS, as the default input file, unless you specify another input file.
Event reports are useful for determining preventive maintenance by helping to identify areas within the system showing potential failure. Event reports also aid in the diagnosis of a failure by documenting events that led to the failure.
The contents of the event reports are most meaningful to your Compaq support representative. However, you can use the event reports as an indicator of system reliability. For example, while using the DCL command SHOW ERROR, you might see that a particular device is producing a higher than normal number of events. You can use DECevent to obtain various detailed reports and determine if you need to contact your Compaq support representative.
If a system component fails, your Compaq support representative can use the event reports to create a history of events leading up to and including the failure.
Used in conjunction with diagnostic programs, event reports significantly reduce the amount of system down time.
DECevent produces five types of reports:
Report Type | Description |
---|---|
Full (default) | Provides a translation of all available information for each entry in the event log. |
Brief | Provides a translation of key information for each entry in the event log. |
Terse | Provides binary event information and displays register values and other ASCII messages in a condensed format. |
Summary | Provides a statistical summary of the event entries in the event log. |
Fast Error (FSTERR) | Provides a quick, one-line per-entry report of your event log for a variety of disk devices. |
These report types are mutually exclusive; in other words, you can select only one report type in a command.
Section 20.5.5 contains examples of types of reports. The OpenVMS System Management Utilities Reference Manual contains additional examples of the types of reports produced by DECevent.
The following sections explain how to use DECevent:
Task | Section |
---|---|
Invoking and exiting DECevent | Section 20.5.2 |
Using DECevent qualifiers | Section 20.5.3 |
Using additional DECevent commands | Section 20.5.4 |
Producing DECevent reports | Section 20.5.5 |
In addition, restrictions are listed in Section 20.5.6.
20.5.2 Invoking and Exiting DECevent
To invoke DECevent, enter the following DCL command:
DIAGNOSE [/primary qualifier][/secondary qualifier[,...][file-spec][,..] |
Note that you do not need to enter the /TRANSLATE qualifier on the command line because it is the default primary qualifier.
A brief discussion of valid qualifiers, their uses, and their order is provided in the following sections. For a more detailed discussion, see the DECevent User's Guide. This guide is available online at the following web site:
http://www.support.compaq.com/svctools |
Select "support tools", next "DECevent", and then "documentation". The DECevent User's Guide is available in several formats.
To exit DECevent, press Ctrl/C and the Return key (to display the system prompt).
You must have SYSPRV privilege to run DECevent; however, only read
access is required to access the ERRLOG.SYS file. You must have the
DIAGNOSE privilege for the /CONTINUOUS primary qualifier to work,
enabling the continuous display of events on a terminal screen.
20.5.3 Using DECevent Qualifiers
The DECevent qualifiers shown and described in Table 20-5 and Table 20-6 allow you to change the format of the reports that DECevent produces.
Qualifier | Description |
---|---|
/ANALYZE | Provides analysis of the event log or real-time analysis of the event logging utilities. |
/BINARY | Controls whether the binary error log records are converted to ASCII text or copied to the specified output file. Do not use this qualifier with any report type qualifier (/FULL, /BRIEF, /TERSE, /SUMMARY, and /FSTERR) or with the /OUTPUT qualifier. |
/CONTINUOUS | Specifies that events are formatted in real time, as they are logged by the operating system event logger. |
/DUMP | Specifies the output to be a brief report followed by a dump of information from the input event log file. |
/INTERACTIVE | Allows users to exit from the command line interface and enter the DECevent interactive command shell. |
/TRANSLATE (default) | Provides translation of event log files into reports. |
Qualifier | Description |
---|---|
/BEFORE | Specifies that only those entries dated earlier than the stated date and time are to be selected for the event report. |
/BRIEF | Generates a brief report |
/ENTRY | Generates a report that includes the specified entry range or starts at the specified entry number. |
/EXCLUDE | Excludes events generated by the specified device class, device name, or error log entry type from the report. |
/FSTERR | Generates a quick, one-line-per-entry report of an event log entry for disks and tapes. |
/FULL (default) | Generates a full report, which provides all available information about an event log entry. |
/INCLUDE | Includes events generated by the specified device class, device name, or error log entry type in the report. |
/LOG | Controls whether informational messages that specify the number of entries selected and rejected for each input file are sent to SYS$OUTPUT. |
/NODE | Generates a report consisting of event entries for specific nodes in an OpenVMS Cluster system. |
/OUTPUT | Specifies the output file for the report. |
/REJECTED | Allows you to specify the name of a file that will contain binary records for rejected entries. |
/SINCE | Specifies that only those entries dated later than the stated date and time are to be selected for the report. |
/SUMMARY | Generates an event report that consists of a statistical summary. |
/TERSE | Generates an event report consisting of binary event information, register values, and ASCII messages in a condensed format. |
Do not use the /BINARY qualifier with any report type qualifier (/FULL, /BRIEF, /TERSE, /SUMMARY, and /FSTERR) or with the /OUTPUT qualifier.
In addition to the qualifiers listed in Table 20-5 and Table 20-6, DECevent contains a set of DIRECTORY commands and a set of SHOW commands:
Previous | Next | Contents | Index |
privacy and legal statement | ||
6017PRO_084.HTML |