HP OpenVMS System Management Utilities Reference
Manual
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:
- 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.
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
|
|
