HP OpenVMS System Management Utilities Reference Manual

Contents

Index

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

#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:

You can specify one or both of these keywords. If you specify both keywords, you must enclose them in parentheses.
If you specify /ENTRY without an entry range, the entry range defaults to START:1,END:end-of-file.
If you specify the START or END keyword without a value, the keyword is ignored.

/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, refer to 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, refer to 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.

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.

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.

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.

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"

The command in this example copies selected events from the default SYS$ERRORLOG:ERRLOG.SYS file to a new error log file named ERRLOG.DAT.
The selected events are those that occurred since the specified date on all nodes except PANDA.

#3
$ ANALYZE/ERROR_LOG/ELV WRITE /ENTRY=(START:5,END:10)

The command in this example copies selected events from the default SYS$ERRORLOG:ERRLOG.SYS file to a new error log file named ERRLOG.DAT.
The selected events start with entry 5 and end with entry 10.

#4
$ ANALYZE/ERROR_LOG/ELV WRITE /ENTRY=(START:5,END:10) /REJECTED

This example is identical to the previous example except that rejected events are copied rather than selected events.
The rejected events are those that fall outside the specified entry range.

10.5 ELV Sample Reports

You can use the following TRANSLATE qualifiers to produce variations of the standard report:

/ONE_LINE
/BRIEF
/FULL
/TERSE

See Table 10-1 for more information about report formats.

The following sections contain examples of the reports that result from using these qualifiers. In addition, an example is shown of using no qualifiers to produce a standard report of the default detail level.

10.5.1 /ONE_LINE Example

The report produced when you use the /ONE_LINE qualifier includes only the header information for each event.

The example that follows contains multiple summary reports, one for each node represented in this error log file, and a summary report for the entire file.

Output for SYS$COMMON:[SYSEXE.ERRLOGS]EXAMPLE.DAT;2 EVENT EVENT_TYPE_______________________ TIMESTAMP______________ NODE__ EVENT_CLASS___ 1 Volume Mount 14-AUG-2003 13:31:39.12 FRANZ VOLUME_CHANGES 2 Volume Mount 8-FEB-2001 10:15:16.12 WF35P0 VOLUME_CHANGES 3 Volume Dismount 8-FEB-2001 10:15:16.15 WF35P0 VOLUME_CHANGES 4 Volume Mount 8-FEB-2001 10:15:16.28 WF35P0 VOLUME_CHANGES ERROR_LOG_SUMMARY________________________________________________ Summary for node: FRANZ Total number of events: 1 Number of the first event: 1 Number of the last event: 1 Earliest event occurred: 14-AUG-2003 13:31:39.12 Latest event occurred: 14-AUG-2003 13:31:39.12 Number of events by event class: VOLUME_CHANGES 1 Summary for node: WF35P0 Total number of events: 3 Number of the first event: 2 Number of the last event: 4 Earliest event occurred: 8-FEB-2001 10:15:16.12 Latest event occurred: 8-FEB-2001 10:15:16.28 Number of events by event class: VOLUME_CHANGES 3 Summary for node: <ALL NODES> Total number of events: 4 Number of the first event: 1 Number of the last event: 4 Earliest event occurred: 8-FEB-2001 10:15:16.12 Latest event occurred: 14-AUG-2003 13:31:39.12 Number of events by event class: VOLUME_CHANGES 4

10.5.2 /BRIEF Example

The report produced when you use the /BRIEF qualifier includes only the most essential event information along with the header information for each event.

Output for SYS$COMMON:[SYSEXE.ERRLOGS]EXAMPLE.DAT;1 EVENT EVENT_TYPE_______________________ TIMESTAMP______________ NODE__ EVENT_CLASS__________ 1 Volume Mount 14-AUG-2003 13:31:39.12 FRANZ VOLUME_CHANGES DESCRIPTION____________________________ RANGE___ VALUE_____________ TRANSLATED_VALUE______ Logging CPU 3 Number of CPU's in Active Set 4 System Marketing Model 1968 COMPAQ AlphaServer GS160 Error Mask <31:00>: 0x00000003 Operating System Version X9WY-SSB Device Unit Number 200 Device Generic Name FRANZ$DKB Volume Label OPAL_X9WY ERROR_LOG_SUMMARY________________________________________________ Total number of events: 1 Number of the first event: 1 Number of the last event: 1 Earliest event occurred: 14-AUG-2003 13:31:39.12 Latest event occurred: 14-AUG-2003 13:31:39.12 Number of events by event class: VOLUME_CHANGES 1

10.5.3 No Qualifiers Example

The report produced when you do not use any qualifiers includes only the most commonly useful event information along with the header information for each event.

Output for SYS$COMMON:[SYSEXE.ERRLOGS]EXAMPLE.DAT;1 EVENT EVENT_TYPE_______________________ TIMESTAMP______________ NODE__ EVENT_CLASS____________ 1 Volume Mount 14-AUG-2003 13:31:39.12 FRANZ VOLUME_CHANGES DESCRIPTION____________________________ RANGE___ VALUE_____________ TRANSLATED_VALUE________ Hardware Architecture 4 Alpha Hardware System Type 35 Wildfire Logging CPU 3 Number of CPU's in Active Set 4 System Marketing Model 1968 COMPAQ AlphaServer GS160 Error Mask <31:00>: 0x00000003 Seconds Since Boot 17 Error Sequence Number 46 DSR String AlphaServer GS160 6/731 Operating System Version X9WY-SSB Owner UIC of the Volume 65537 Unit Operation Count 378 Device Unit Number 200 Device Generic Name FRANZ$DKB Volume Number within Set 0 Number of Volumes within Set 0 Volume Label OPAL_X9WY ERROR_LOG_SUMMARY________________________________________________ Total number of events: 1 Number of the first event: 1 Number of the last event: 1 Earliest event occurred: 14-AUG-2003 13:31:39.12 Latest event occurred: 14-AUG-2003 13:31:39.12 Number of events by event class: VOLUME_CHANGES 1

10.5.4 /FULL Example

The report produced when you use the /FULL qualifier includes all event information along with the header information for each event.

Output for SYS$COMMON:[SYSEXE.ERRLOGS]EXAMPLE.DAT;1 EVENT EVENT_TYPE_______________________ TIMESTAMP______________ NODE__ EVENT_CLASS____________ 1 Volume Mount 14-AUG-2003 13:31:39.12 FRANZ VOLUME_CHANGES DESCRIPTION____________________________ RANGE___ VALUE_____________ TRANSLATED_VALUE________ Operating System Type 2 OpenVMS Hardware Architecture 4 Alpha Vendor ID 0x00000DEC hp Hardware System Type 35 Wildfire Logging CPU 3 Number of CPU's in Active Set 4 System Marketing Model 1968 COMPAQ AlphaServer GS160 Error Mask <31:00>: 0x00000003 Seconds Since Boot 17 Chip Type 11 EV67 (21264A) Error Sequence Number 46 DSR String AlphaServer GS160 6/731 DDR String 000000000000000000000000000000000000000000000000000000000000 0x0000 System Serial Number 0x0000000000000000000000000000000000000000 Time - ISO 8601 Format 20030814133139,12-0400 Operating System Version X9WY-SSB Computer Name FRANZ Owner UIC of the Volume 65537 Unit Operation Count 378 Device Unit Number 200 Device Generic Name FRANZ$DKB Volume Number within Set 0 Number of Volumes within Set 0 Volume Label OPAL_X9WY ERROR_LOG_SUMMARY________________________________________________ Total number of events: 1 Number of the first event: 1 Number of the last event: 1 Earliest event occurred: 14-AUG-2003 13:31:39.12 Latest event occurred: 14-AUG-2003 13:31:39.12 Number of events by event class: VOLUME_CHANGES 1

Contents

Index