HP OpenVMS System Management Utilities Reference Manual


Previous Contents Index

This example is identical to the previous example except that rejected events are written rather than selected events.

The rejected events are those that fall outside the interval between the two specified dates.
#5

$ ANALYZE/ERROR_LOG/ELV DUMP /INVALID /OUTPUT=OUTFILE.OUT
      

The command in this example writes OpenVMS dump-style records created from invalid events in the default SYS$ERRORLOG:ERRLOG.SYS file to an output dump file named OUTFILE.OUT.

EXIT

Stops the execution of ELV and returns control to the DCL command level. You can also enter Ctrl/Z to perform the same function.

Format

EXIT


Example


ELV> EXIT
$  
      

The command in this example terminates the ELV session and returns control to the DCL command level.

HELP

Provides online help information for using ELV.

Format

HELP [help-topic]


Parameter

help-topic

Specifies the topic for which you want help.

Example


ELV> HELP CONVERT
$ ANALYZE/ERROR_LOG/ELV HELP CONVERT
      

The commands in this example show how to get help information for the ELV CONVERT command from both the interactive shell mode and DCL command level.

TRANSLATE

Performs a bit-to-text translation of events from one or more binary error log files and writes the resulting reports to the terminal or to a single new ASCII output file.

Section 10.5 contains examples of reports.


Format

TRANSLATE [input-file,...]


Parameter

input-file

Supplies one or more names of binary error log files to be translated.

If you do not specify an input file, the default input file is SYS$ERRORLOG:ERRLOG.SYS. If you do not specify a device and directory, your current device and directory are used. If you do not specify a file name, the default file name is ERRLOG. If you do not specify a file type, the default file type is .SYS.


Description

When you use the TRANSLATE command, ELV can generate reports in the formats shown in Table 10-1.

Note

When you use the ELV TRANSLATE command to examine error log files created on systems running OpenVMS Version 7.2 through 7.3-1, you might see the following set of messages displayed after the translation of certain types of events:


   %ELV-E-B2TNOTFND, valid bit-to-text translation data not found 
   -ELV-W-NODNOTFND, bit-to-text node not found 

These messages are the result of a minor change in the error log file format between OpenVMS Versions 7.3-1 and 7.3-2; they can be disregarded. The events affected should be translated correctly.

Table 10-1 Report Formats
Format Description
Standard A report that contains detailed bit-to-text translation information for each event.

To specify the detail level of a standard report, use the /BRIEF, /FULL, or /ONE_LINE qualifier with the TRANSLATE command. In addition to these qualifiers, you can use the /TERSE qualifier to obtain a report that contains less interpretation of the data, regardless of detail level.

At a minimum, the following header information is included for each event in a standard report:

  • Event Number
  • Event Type
  • Timestamp
  • Node
  • Event Class

With the exception of Event Type, the header information is useful when using the following event filtering and interval qualifiers: /BEFORE, /ENTRY, /EXCLUDE, /INCLUDE, /[NO]NODE, /SINCE.

For Event Class, see the keywords listed for the /EXCLUDE or /INCLUDE qualifier.

Standard Report Detail Levels:

  • If you specify /ONE_LINE, the header information is the only event information that is included in a standard report.
  • If you specify /BRIEF, only the most essential event information is included with the header information.
  • If you do not specify a standard report detail level qualifier, only the most commonly useful event information is included with the header information.
  • If you specify /FULL, all event information is included with the header information.
Summary Summary information is broken down by node where applicable, followed by summary information for the entire file. See the example following this table.


Output for SYS$SYSROOT:[SYSERR]ERRLOG.SYS;1 
 
Total number of events:            19 
Number of the first event:         1 
Number of the last event:          19 
Earliest event occurred:           19-JUN-2003 08:52:46.00 
Latest event occurred:             19-JUN-2003 13:08:23.62 
Number of events by event class:       
        BUGCHECKS                  1 
        CONFIGURATION              2 
        CONTROL_ENTRIES            4 
        UNKNOWN_ENTRIES            8 
        VOLUME_CHANGES             4 


Qualifiers

/BEFORE[=date-time]

Specifies that only those events dated earlier than the stated date and time are to be selected.

For date-time, you can specify an absolute time, a delta time, or a combination of absolute and delta times. See the OpenVMS User's Manual for details on specifying times.

If you omit a date and time, TODAY is used.

/BRIEF

Specifies that ELV is to generate a brief standard report. Do not use /BRIEF with /FULL or /ONE_LINE.

/ENTRY[=keyword,...]

Specifies the range of entries to be selected.

You can specify one or both of the following keywords:
Keyword Description
START[:decimal-value] Indicates the start of a range of entries to be selected.
END[:decimal-value] Indicates the end of a range of entries to be selected.

Usage Notes:

/EXCLUDE=event-class[,...]

Specifies an event class or classes to be rejected. Do not use /EXCLUDE with /INCLUDE.

For event-class, specify one or more of the keywords shown in the following table. If you specify more than one keyword, use a comma-separated list of values enclosed in parentheses.
Keyword Description
ATTENTIONS Reject device attention entries.
BUGCHECKS Reject all types of bugcheck entries.
CONFIGURATION Reject system configuration entries.
CONTROL_ENTRIES Reject control entries. Control entries include the following entry types:
  • System power failure restarts
  • Time stamps
  • System startups
  • $SNDERR messages (system service to send messages to error log)
  • Operator messages
  • Network messages
  • ERRLOG.SYS created
CPU_ENTRIES Reject CPU-related entries. CPU entries include the following entry types:
  • SBI alerts/faults
  • Undefined interrupts
  • MBA/UBA adapter errors
  • Asynchronous write errors
  • UBA errors
DEVICE_ERRORS Reject device error entries.
ENVIRONMENTAL_ENTRIES Reject environmental entries.
MACHINE_CHECKS Reject machine check entries.
MEMORY Reject memory errors.
SNAPSHOT_ENTRIES Reject snapshot entries.
SYNDROME Reject firmware-generated entries that describe a symptom set used by HP support personnel to identify problems.
TIMEOUTS Reject device timeout entries.
UNKNOWN_ENTRIES Reject any entry that has an unknown entry class.
UNSOLICITED_MSCP Reject unsolicited MSCP entries.
VOLUME_CHANGES Reject volume mount and dismount entries.

/FULL

Specifies that ELV is to generate a full standard report. Do not use /FULL with /BRIEF or /ONE_LINE.

/INCLUDE=event-class[,...]

Specifies an event class or classes to be selected. All other event classes are implicitly rejected. Do not use /INCLUDE with /EXCLUDE.

For event-class, specify one or more of the keywords shown in the following table. If you specify more than one keyword, use a comma-separated list of values enclosed in parentheses.
Keyword Description
ATTENTIONS Select device attention entries.
BUGCHECKS Select all types of bugcheck entries.
CONFIGURATION Select system configuration entries.
CONTROL_ENTRIES Select control entries. Control entries include the following entry types:
  • System power failure restarts
  • Time stamps
  • System startups
  • $SNDERR messages (system service to send messages to error log)
  • Operator messages
  • Network messages
  • ERRLOG.SYS created
CPU_ENTRIES Select CPU-related entries. CPU entries include the following entry types:
  • SBI alerts/faults
  • Undefined interrupts
  • MBA/UBA adapter errors
  • Asynchronous write errors
  • UBA errors
DEVICE_ERRORS Select device error entries.
ENVIRONMENTAL_ENTRIES Select environmental entries,
MACHINE_CHECKS Select machine check entries.
MEMORY Select memory errors.
SNAPSHOT_ENTRIES Select snapshot entries.
SYNDROME Select firmware-generated entries that describe a symptom set used by HP support personnel to identify problems.
TIMEOUTS Select device timeout entries.
UNKNOWN_ENTRIES Select any entry that has an unknown entry class.
UNSOLICITED_MSCP Select unsolicited MSCP entries.
VOLUME_CHANGES Select volume mount and dismount entries.

/INTERACTIVE

/NOINTERACTIVE

Specifies whether or not ELV is to run in interactive shell mode after you execute the ELV command. By default, interactive shell mode results from the way the current ELV command was entered.

For more information, see Section 10.2.

/LOG

/NOLOG

Specifies whether or not ELV is to output control and informational messages to the terminal. The default /NOLOG does not output these messages to the terminal.

/NODE[=node-name,...]

/NONODE[=node-name,...]

Specifies that events occurring on a node or nodes are to be selected or rejected.

If you enter /NODE without a value, only events that occur on the node on which you are running ELV are selected.

If you enter /NONODE without a value, events occurring on all nodes that are represented in the error log file are selected.

/ONE_LINE

Specifies that ELV is to generate a one-line-per-event standard report. Do not use /ONE_LINE with /BRIEF or /FULL.

/OUTPUT[=output-file]

Specifies the output file that is to contain bit-to-text translation reports.

By default, output is written to SYS$OUTPUT. If you do not specify an output file name, the input file name is used. If you do not specify a device and directory, your current device and directory are used. If you do not specify a file type, the default file type is .LIS.

/PAGE

/NOPAGE

Specifies whether or not to enable paged output of a report. The default /NOPAGE disables paged output of reports.

/REJECTED

Specifies that rejected (rather than selected) events are to be translated.

For more information, see Section 10.3.

/SINCE[=date-time]

Specifies that only those events dated later than the stated date and time are to be selected. If you omit a date and time, TODAY is used.

For date-time, you can specify an absolute time, a delta time, or a combination of absolute and delta times. See the OpenVMS User's Manual for details on specifying times.

/SUMMARY

/NOSUMMARY

Specifies that a summary report or a standard report is to be generated:

/TERSE

Specifies that the data in a standard report is to be displayed in a less interpreted format, regardless of detail level. /TERSE has no effect on a summary report.

See the /TERSE example in Section 10.5.5.


Examples

#1

$ ANALYZE/ERROR_LOG/ELV TRANSLATE /ONE_LINE /PAGE
      

The command in this example translates selected events from the default SYS$ERRORLOG:ERRLOG.SYS file and writes the resulting standard and summary reports to the terminal in paged output. The standard report is a one-line-per-event report.

#2

ELV> TRANSLATE /BRIEF /NOSUMMARY
      

The command in this example translates selected events from the default SYS$ERRORLOG:ERRLOG.SYS file and writes the resulting standard report to the terminal. The standard report is a brief report.

#3

ELV> TRANSLATE /SINCE=TODAY /OUTPUT=REPORT.TXT
      

The command in this example translates selected events from the default SYS$ERRORLOG:ERRLOG.SYS file and writes the resulting standard report to an ASCII output file named REPORT.TXT.

The selected events are those that occurred since TODAY.

#4

$ ANALYZE/ERROR_LOG/ELV TRANSLATE /FULL /TERSE
      

The command in this example translates selected events from the default SYS$ERRORLOG:ERRLOG.SYS file and writes the resulting standard and summary reports to the terminal. The standard report is a full report in terse format.

#5

ELV> TRANSLATE /INCLUDE=VOLUME_CHANGES /SUMMARY
      

The command in this example translates selected events from the default SYS$ERRORLOG:ERRLOG.SYS file and writes the resulting summary report to the terminal.

The selected events include only the VOLUME_CHANGES event class.

WRITE

Performs an image copy of events from one or more binary error log files to a single new binary error log file.

Format

WRITE [input-file,...]


Parameter

input-file

Supplies one or more names of binary error log files to be used to produce a new binary error log file.

If you do not specify an input file, the default input file is SYS$ERRORLOG:ERRLOG.SYS. If you do not specify a device and directory, your current device and directory are used. If you do not specify a file name, the default file name is ERRLOG. If you do not specify a file type, the default file type is .SYS.


Qualifiers

/BEFORE[=date-time]

Specifies that only those events dated earlier than the stated date and time are to be selected.

For date-time, you can specify an absolute time, a delta time, or a combination of absolute and delta times. See the OpenVMS User's Manual for details on specifying times.

If you omit a date and time, TODAY is used.

/ENTRY[=keyword,...]

Specifies the range of entries to be selected.

You can specify one or both of the following keywords:
Keyword Description
START[:decimal-value] Indicates the start of a range of entries to be selected.
END[:decimal-value] Indicates the end of a range of entries to be selected.

Usage Notes:

/EXCLUDE=event-class[,...]

Specifies an event class or classes to be rejected. Do not use /EXCLUDE with /INCLUDE.

For event-class, specify one or more of the keywords shown in the following table. If you specify more than one keyword, use a comma-separated list of values enclosed in parentheses.
Keyword Description
ATTENTIONS Reject device attention entries.
BUGCHECKS Reject all types of bugcheck entries.
CONFIGURATION Reject system configuration entries.
CONTROL_ENTRIES Reject control entries. Control entries include the following entry types:
  • System power failure restarts
  • Time stamps
  • System startups
  • $SNDERR messages (system service to send messages to error log)
  • Operator messages
  • Network messages
  • ERRLOG.SYS created
CPU_ENTRIES Reject CPU-related entries. CPU entries include the following entry types:
  • SBI alerts/faults
  • Undefined interrupts
  • MBA/UBA adapter errors
  • Asynchronous write errors
  • UBA errors
DEVICE_ERRORS Reject device error entries.
ENVIRONMENTAL_ENTRIES Reject environmental entries.
MACHINE_CHECKS Reject machine check entries.
MEMORY Reject memory errors.
SNAPSHOT_ENTRIES Reject snapshot entries.
SYNDROME Reject firmware-generated entries that describe a symptom set used by HP support personnel to identify problems.
TIMEOUTS Reject device timeout entries.
UNKNOWN_ENTRIES Reject any entry that has an unknown entry class.
UNSOLICITED_MSCP Reject unsolicited MSCP entries.
VOLUME_CHANGES Reject volume mount and dismount entries.

/INCLUDE=event-class[,...]

Specifies an event class or classes to be selected. All other event classes are implicitly rejected. Do not use /INCLUDE with /EXCLUDE.

For event-class, specify one or more of the keywords shown in the following table. If you specify more than one keyword, use a comma-separated list of values enclosed in parentheses.
Keyword Description
ATTENTIONS Select device attention entries.
BUGCHECKS Select all types of bugcheck entries.
CONFIGURATION Select system configuration entries.
CONTROL_ENTRIES Select control entries. Control entries include the following entry types:
  • System power failure restarts
  • Time stamps
  • System startups
  • $SNDERR messages (system service to send messages to error log)
  • Operator messages
  • Network messages
  • ERRLOG.SYS created
CPU_ENTRIES Select CPU-related entries. CPU entries include the following entry types:
  • SBI alerts/faults
  • Undefined interrupts
  • MBA/UBA adapter errors
  • Asynchronous write errors
  • UBA errors
DEVICE_ERRORS Select device error entries.
ENVIRONMENTAL_ENTRIES Select environmental entries.
MACHINE_CHECKS Select machine check entries.
MEMORY Select memory errors.
SNAPSHOT_ENTRIES Select snapshot entries.
SYNDROME Select firmware-generated entries that describe a symptom set used by HP support personnel to identify problems.
TIMEOUTS Select device timeout entries.
UNKNOWN_ENTRIES Select any entry that has an unknown entry class.
UNSOLICITED_MSCP Select unsolicited MSCP entries.
VOLUME_CHANGES Select volume mount and dismount entries.

/INTERACTIVE

/NOINTERACTIVE

Specifies whether or not ELV is to run in interactive shell mode after you execute the ELV command. By default, interactive shell mode results from the way the current ELV command was entered.

For more information, see Section 10.2.

/LOG

/NOLOG

Specifies whether or not ELV is to output control and informational messages to the terminal. The default /NOLOG does not output these messages to the terminal.

/NODE[=node-name,...]

/NONODE[=node-name,...]

Specifies that events occurring on a node or nodes are to be selected or rejected.

If you /NODE without a value, only events that occur on the node on which you are running ELV are selected.

If you enter /NONODE without a value, events occurring on all nodes that are represented in the error log file are selected.

/OUTPUT[=output-file]

Specifies the output file that is to contain image copies of events.

If you do not specify an output file name, the input file name is used. If you do not specify a device and directory, your current device and directory are used. If you do not specify a file type, the default file type is .DAT.

/REJECTED

Specifies that rejected (rather than selected) events are to be copied to a new binary error log file.

For more information, see Section 10.3.

/SINCE[=date-time]

Specifies that only those events dated later than the stated date and time are to be selected.

For date-time, you can specify an absolute time, a delta time, or a combination of absolute and delta times. See the OpenVMS User's Manual for details on specifying times.

If you omit a date and time, TODAY is used.


Examples

#1

ELV> WRITE /EXCLUDE=CONTROL_ENTRIES /OUTPUT=NEW_ERROR_LOG.SYS
      

The command in this example copies selected events from the default SYS$ERRORLOG:ERRLOG.SYS file to a new error log file named NEW_ERROR_LOG.SYS.

The selected events do not include the CONTROL_ENTRIES event class.

#2

ELV> WRITE /NONODE=PANDA /SINCE="20-AUG-2003 04:51:33.87"
      


Previous Next Contents Index