Valid for Alpha and I64 systems only.
Invokes the Error Log Viewer (ELV) to selectively report the
contents of an error log file.
You can execute ELV commands directly from DCL command level or
from ELV's interactive shell mode.
To invoke ELV, enter the following command:
$ ANALYZE/ERROR_LOG/ELV
The utility enters interactive shell mode and displays the ELV
prompt:
ELV>
You can then enter an ELV command. After ELV executes the
command, it again displays the ELV> prompt. To return directly
to DCL, use the /NOINTERACTIVE qualifier.
You can also enter an ELV command directly from DCL; for example:
$ ANALYZE/ERROR_LOG/ELV TRANSLATE ERRLOG.SYS;42
After ELV executes the command, you are returned to the DCL
prompt by default.
To enter interactive shell mode after executing the command, use
the /INTERACTIVE qualifier.
1 – Categories of Events
ELV recognizes several categories of events for inclusion in (or
exclusion from) various operations. The first major separation
is between valid and invalid events. Then, within the category
of valid events are selected and rejected events. Explanations of
these categories follow.
o Valid
Valid events can be read into an internal buffer; also, bit-
to-text translation data can be produced for the header.
For an event to be valid, the event body does not need
to be translatable; in this case, the event is valid but
untranslatable.
- Selected
A selected event is one that is of particular interest
to you. You select events by using a selection qualifier:
/ENTRY, /INCLUDE, /NODE, /SINCE, and /BEFORE. The events
that are selected according to the selection criteria are
included in or excluded from a report.
- Rejected
A rejected event is one that is not included in a report
because the command line specifies one of the following:
* An interval: /ENTRY, /SINCE, or /BEFORE
* A filter: /INCLUDE, /EXCLUDE, /NODE, or /NONODE
You can use the /REJECTED qualifier to include rejected
events in a report. (By default, only selected events are
included in a report.)
o Invalid
An invalid event is one that cannot be read into an internal
buffer or whose header cannot be translated. You can use the
ELV command DUMP/INVALID to output invalid events to an output
dump file for further examination.
2 – CONVERT
Converts an error log file written in the newer format to an
error log file written in the older format (that is read by
ANALYZE/ERROR_LOG). This command is primarily used to enable
translation of older error log events whose translation is not
supported by ELV.
Format
CONVERT [input-file,...]
2.1 – Parameter
input-file
Supplies one or more names of binary error log files to be
converted to the older format.
If you do not specify an input file name, the default input file
name is SYS$ERRORLOG:ERRLOG.SYS. If you do not specify a device
and directory, the system defaults to your current device and
directory. 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.
2.2 – Qualifiers
2.2.1 /BEFORE
/BEFORE=date-time
Specifies that only those events dated earlier than the stated
date and time are to be selected for the report.
Date-time specifies that only those events dated earlier than
the stated date and time are to be selected for the report. You
can specify an absolute time, a delta time, or a combination of
absolute and delta times. See the OpenVMS System Manager's Manual
for details on specifying times.
If you omit a date and time, TODAY is used.
2.2.2 /ENTRY
/ENTRY=keyword[,...]
Generates a report that includes the specified entry range or
starts at the specified entry number.
You can specify one or both keywords:
Keyword Description
START:decimal-value Indicates the start of a range of entries
in a report.
END:decimal-value Indicates the end of a range of entries
in a report.
Usage Notes:
o You can specify one or both of these parameters. If you
specify both parameters, you must enclose them in parentheses.
o If you specify /ENTRY without the entry range or omit the
qualifier, the entry range defaults to START:1,END:end-of-
file.
2.2.3 /EXCLUDE
/EXCLUDE=event-class[,...]
Excludes the specified event class or classes from the report. Do
not use the /EXCLUDE qualifier with /INCLUDE.
For event-class, specify one or more of the keywords shown in the
following table. If you specify more than one keyword, you must
use a comma-separated list of values enclosed in parentheses.
Keyword Description
ATTENTIONS Exclude device attention entries from the report.
BUGCHECKS Exclude all types of bugcheck entries from the
report.
CONFIGURATION Exclude system configuration entries from the
report.
CONTROL_ Exclude control entries from the report. Control
ENTRIES entries include the following entry types:
o System power failure restarts
o Time stamps
o System startups
o $SNDERR messages (system service to send
messages to error log)
o Operator messages
o Network messages
o ERRLOG.SYS created
CPU_ENTRIES Exclude CPU-related entries from the report. CPU
entries include the following entry types:
o SBI alerts/faults
o Undefined interrupts
o MBA/UBA adapter errors
o Asynchronous write errors
o UBA errors
DEVICE_ Exclude device error entries from the report.
ERRORS
ENVIRONMENTAL_ Exclude environmental entries from the report.
ENTRIES
MACHINE_ Exclude machine check entries from the report.
CHECKS
MEMORY Exclude memory errors from the report.
SNAPSHOT_ Exclude snapshot entries from the report.
ENTRIES
SYNDROME Exclude firmware-generated entries that describe
a symptom set used by VSI support personnel to
identify problems.
TIMEOUTS Exclude device timeout entries from the report.
UNKNOWN_ Exclude any entry that had either an unknown entry
ENTRIES type or an unknown device type or class.
UNSOLICITED_ Exclude unsolicited MSCP entries from the output
MSCP report.
VOLUME_ Exclude volume mount and dismount entries from the
CHANGES report.
2.2.4 /INCLUDE
/INCLUDE=event-class[,...]
Includes the specified event class or classes in the report. Do
not use the /EXCLUDE qualifier with /INCLUDE.
For event-class, specify one or more of the keywords shown in the
following table. If you specify more than one keyword, you must
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_ Select control entries. Control entries include
ENTRIES the following entry types:
o System power failure restarts
o Time stamps
o System startups
o $SNDERR messages (system service to send
messages to error log)
o Operator messages
o Network messages
o ERRLOG.SYS created
CPU_ENTRIES Select CPU-related entries. CPU entries include
the following entry types:
o SBI alerts/faults
o Undefined interrupts
o MBA/UBA adapter errors
o Asynchronous write errors
o UBA errors
DEVICE_ Select device error entries.
ERRORS
ENVIRONMENTAL_ Select environmental entries.
ENTRIES
MACHINE_ Select machine check entries.
CHECKS
MEMORY Select memory errors.
SNAPSHOT_ Select snapshot entries.
ENTRIES
SYNDROME Select firmware-generated entries that describe
a symptom set used by VSI support personnel to
identify problems.
TIMEOUTS Select device timeout entries.
UNKNOWN_ Select any entry that has an unknown entry
ENTRIES class.
UNSOLICITED_ Select unsolicited MSCP entries.
MSCP
VOLUME_ Select volume mount and dismount entries.
CHANGES
2.2.5 /INTERACTIVE
/INTERACTIVE
/[NO]INTERACTIVE
Specifies whether or not ELV is to run in interactive shell mode.
By default, interactive shell mode results from the way ELV is
invoked.
2.2.6 /LOG
/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.
2.2.7 /NODE
/NODE=[node-name,...]
/NONODE=[node-name,...]
Includes or excludes events occurring on a specified node or
nodes from a report.
If you do not enter a node name, only events that occur on
the node on which you are running ELV are selected. (This is
important in a cluster.)
If you enter /NONODE without a value, events occurring on all
nodes that are represented in the error log file are processed.
2.2.8 /OUTPUT
/OUTPUT=[output-file]
Specifies the output file to contain converted copies of events
chosen with interval and filter qualifiers.
If you do not specify an output file name, the input file name
is used. If you do not specify a device and directory, the system
defaults to your current device and directory. If you do not
specify a file type, the default file type is .CVT.
2.2.9 /REJECTED
You can use the /REJECTED qualifier to include rejected events
in a report. (By default, only selected events are included in a
report.)
2.2.10 /SINCE
/SINCE=[date-time]
Specifies that only those events dated later than the stated date
and time are to be selected for the report.
You can use date-time to limit the report to those events dated
later than the specified 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.
2.3 – Examples
1.ELV> CONVERT ERROR_LOG.SYS
The command in this example converts events in ERROR_LOG.SYS to
the older format and writes them to ERROR_LOG.CVT.
2.ELV> CONVERT/OUTPUT
The command in this example converts events in the default file
ERRLOG.SYS to the older format and writes them to ERRLOG.CVT.
3.ELV> CONVERT/OUTPUT=OUTFILE.OUT
The command in this example converts events in the default file
ERRLOG.SYS to the older format and writes them to OUTFILE.OUT.
3 – DUMP
Allows you to specify the name of a file to contain an OpenVMS
dump-style record for each event.
If you do not specify an output file name, the input file name
is used. If you do not specify a device and directory, the system
defaults to your current device and directory. If you do not
specify a file type, the default file type is .DMP.
Format
DUMP [input-file,...]
3.1 – Parameter
input-file
Supplies one or more names of binary error log files to be used
to produce an output dump file.
If you do not specify an input file name, the default input file
name is SYS$ERRORLOG:ERRLOG.SYS. If you do not specify a device
and directory, the system defaults to your current device and
directory. 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.
3.2 – Qualifiers
3.2.1 /BEFORE
/BEFORE=date-time
Specifies that only those events dated earlier than the stated
date and time are to be selected for the report.
Date-time specifies that only those events dated earlier than
the stated date and time are to be selected for the report. You
can specify an absolute time, a delta time, or a combination of
absolute and delta times. See the OpenVMS System Manager's Manual
for details on specifying times.
If you omit a date and time, TODAY is used.
3.2.2 /ENTRY
/ENTRY=keyword[,...]
Generates a report that includes the specified entry range or
starts at the specified entry number.
You can specify one or both keywords:
Keyword Description
START:decimal-value Indicates the start of a range of entries
in a report.
END:decimal-value Indicates the end of a range of entries
in a report.
Usage Notes:
o You can specify one or both of these parameters. If you
specify both parameters, you must enclose them in parentheses.
o If you specify /ENTRY without the entry range or omit the
qualifier, the entry range defaults to START:1,END:end-of-
file.
3.2.3 /EXCLUDE
/EXCLUDE=event-class[,...]
Excludes the specified event class or classes from the report. Do
not use the /EXCLUDE qualifier with /INCLUDE.
For event-class, specify one or more of the keywords shown in the
following table. If you specify more than one keyword, you must
use a comma-separated list of values enclosed in parentheses.
Keyword Description
ATTENTIONS Exclude device attention entries from the report.
BUGCHECKS Exclude all types of bugcheck entries from the
report.
CONFIGURATION Exclude system configuration entries from the
report.
CONTROL_ Exclude control entries from the report. Control
ENTRIES entries include the following event types:
o System power failure restarts
o Time stamps
o System startups
o $SNDERR messages (system service to send
messages to error log)
o Operator messages
o Network messages
o ERRLOG.SYS created
CPU_ENTRIES Exclude CPU-related entries from the report. CPU
entries include the following event types:
o SBI alerts/faults
o Undefined interrupts
o MBA/UBA adapter errors
o Asynchronous write errors
o UBA errors
DEVICE_ Exclude device error entries from the report.
ERRORS
ENVIRONMENTAL_ Exclude environmental entries from the report.
ENTRIES
MACHINE_ Exclude machine check entries from the report.
CHECKS
MEMORY Exclude memory errors from the report.
SNAPSHOT_ Exclude snapshot entries from the report.
ENTRIES
SYNDROME Exclude firmware-generated entries that describe
a symptom set used by VSI support personnel to
identify problems.
TIMEOUTS Exclude device timeout entries from the report.
UNKNOWN_ Exclude any entry that had either an unknown event
ENTRIES type or an unknown device type or class.
UNSOLICITED_ Exclude unsolicited MSCP entries from the output
MSCP report.
VOLUME_ Exclude volume mount and dismount entries from the
CHANGES report.
3.2.4 /INCLUDE
/INCLUDE=event-class[,...]
Includes the specified event class or classes in the report. Do
not use the /EXCLUDE qualifier with /INCLUDE.
For event-class, specify one or more of the keywords shown in the
following table. If you specify more than one keyword, you must
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_ Select control entries. Control entries include
ENTRIES the following entry types:
o System power failure restarts
o Time stamps
o System startups
o $SNDERR messages (system service to send
messages to error log)
o Operator messages
o Network messages
o ERRLOG.SYS created
CPU_ENTRIES Select CPU-related entries. CPU entries include
the following entry types:
o SBI alerts/faults
o Undefined interrupts
o MBA/UBA adapter errors
o Asynchronous write errors
o UBA errors
DEVICE_ Select device error entries.
ERRORS
ENVIRONMENTAL_ Select environmental entries.
ENTRIES
MACHINE_ Select machine check entries.
CHECKS
MEMORY Select memory errors.
SNAPSHOT_ Select snapshot entries.
ENTRIES
SYNDROME Select firmware-generated entries that describe
a symptom set used by VSI support personnel to
identify problems.
TIMEOUTS Select device timeout entries.
UNKNOWN_ Select any entry that has an unknown entry
ENTRIES class.
UNSOLICITED_ Select unsolicited MSCP entries.
MSCP
VOLUME_ Select volume mount and dismount entries.
CHANGES
3.2.5 /INTERACTIVE
/INTERACTIVE
/[NO]INTERACTIVE
Specifies whether or not ELV is to run in interactive shell mode.
By default, interactive shell mode results from the way ELV is
invoked.
3.2.6 /INVALID
Allows you to specify the name of a file to contain invalid
entries.
3.2.7 /LOG
/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.
3.2.8 /NODE
/NODE=[node-name,...]
/NONODE=[node-name,...]
Includes or excludes events occurring on a specified node or
nodes from a report.
If you do not enter a node name, only events that occur on
the node on which you are running ELV are selected. (This is
important in a cluster.)
If you enter /NONODE without a value, events occurring on all
nodes that are represented in the error log file are processed.
3.2.9 /OUTPUT
/OUTPUT=[output-file]
Specifies that the output file is to contain OpenVMS dump-style
records for each event.
If you do not specify an output file name, the input file name
is used. If you do not specify a device and directory, the system
defaults to your current device and directory. If you do not
specify a file type, the default file type is .DMP.
3.2.10 /REJECTED
You can use the /REJECTED qualifier to include rejected events
in a report. (By default, only selected events are included in a
report.)
3.2.11 /SINCE
/SINCE=[date-time]
Specifies that only those events dated later than the stated date
and time are to be selected for the report.
You can use date-time to limit the report to those events dated
later than the specified 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.
3.3 – Examples
1.ELV> DUMP ERROR_LOG.SYS
The command in this example creates a dump file named ERROR_
LOG.DMP that contains OpenVMS dump-style records.
2.ELV> DUMP/OUTPUT=OUTFILE.OUT
The command in this example creates a dump file named
OUTFILE.OUT that contains OpenVMS dump-style records.
3.ELV> DUMP/INVALID
The command in this example creates a dump file with the
default name of ERRLOG.DMP that contains OpenVMS dump-style
records of invalid events.
4.ELV> DUMP/INVALID/OUTPUT=OUTFILE.OUT
The command in this example creates a dump file named
OUTFILE.OUT that contains OpenVMS dump-style records of invalid
events.
4 – 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
4.1 – Example
ELV> EXIT
$
The command in this example terminates the ELV session and
returns control to the DCL command level.
5 – TRANSLATE
Performs a bit-to-text translation of one or more binary error
log files.
Format
TRANSLATE [input-file,...]
5.1 – Parameter
input-file
Supplies one or more names of binary error log files to be
translated.
If you do not specify an input file name, the default input file
name is SYS$ERRORLOG:ERRLOG.SYS. If you do not specify a device
and directory, the system defaults to your current device and
directory. 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.
5.2 – Qualifiers
5.2.1 /BEFORE
/BEFORE=date-time
Specifies that only those events dated earlier than the stated
date and time are to be selected for the report.
Date-time specifies that only those events dated earlier than
the stated date and time are to be selected for the report. You
can specify an absolute time, a delta time, or a combination of
absolute and delta times. See the OpenVMS System Manager's Manual
for details on specifying times.
If you omit a date and time, TODAY is used.
5.2.2 /BRIEF
Specifies that ELV is to generate a brief report. A brief report
is equivalent to using /DETAIL=LOW.
Do not use the /BRIEF qualifier with /DETAIL, /FULL, /ONE_LINE,
or /SUMMARY.
5.2.3 /DETAIL
/DETAIL=[keyword]
Specifies the detail level of the generated report.
Do not use the /DETAIL qualifier with /BRIEF, /FULL, /ONE_LINE,
or /SUMMARY. The keyword denotes the level of detail for the
generated report. Keywords are the following:
Keyword Description
MINIMUM Contains only the minimum amount of information.
LOW Is the equivalent of a /BRIEF report.
MEDIUM Is the default type of report.
HIGH Is the equivalent of a /FULL report.
MAXIMUM Contains the maximum amount of information.
5.2.4 /ENTRY
/ENTRY=keyword[,...]
Generates a report that includes the specified entry range or
starts at the specified entry number. You can specify one or
both keywords:
Keyword Description
START:decimal-value Indicates the start of a range of entries
in a report.
END:decimal-value Indicates the end of a range of entries
in a report.
Usage Notes:
o You can specify one or both of these parameters. If you
specify both parameters, you must enclose them in parentheses.
o If you specify /ENTRY without the entry range or omit the
qualifier, the entry range defaults to START:1,END:end-of-
file.
5.2.5 /EXCLUDE
/EXCLUDE=event-class[,...]
Excludes the specified event class or classes from the report. Do
not use the /EXCLUDE qualifier with /INCLUDE.
For event-class, specify one or more of the keywords shown in the
following table. If you specify more than one keyword, you must
use a comma-separated list of values enclosed in parentheses.
Keyword Description
ATTENTIONS Exclude device attention entries from the report.
BUGCHECKS Exclude all types of bugcheck entries from the
report.
CONFIGURATION Exclude system configuration entries from the
report.
CONTROL_ Exclude control entries from the report. Control
ENTRIES entries include the following entry types:
o System power failure restarts
o Time stamps
o System startups
o $SNDERR messages (system service to send
messages to error log)
o Operator messages
o Network messages
o ERRLOG.SYS created
CPU_ENTRIES Exclude CPU-related entries from the report. CPU
entries include the following entry types:
o SBI alerts/faults
o Undefined interrupts
o MBA/UBA adapter errors
o Asynchronous write errors
o UBA errors
DEVICE_ Exclude device error entries from the report.
ERRORS
ENVIRONMENTAL_ Exclude environmental entries from the report.
ENTRIES
MACHINE_ Exclude machine check entries from the report.
CHECKS
MEMORY Exclude memory errors from the report.
SNAPSHOT_ Exclude snapshot entries from the report.
ENTRIES
SYNDROME Exclude firmware-generated entries that describe
a symptom set used by VSI support personnel to
identify problems.
TIMEOUTS Exclude device timeout entries from the report.
UNKNOWN_ Exclude any entry that had either an unknown entry
ENTRIES type or an unknown device type or class.
UNSOLICITED_ Exclude unsolicited MSCP entries from the output
MSCP report.
VOLUME_ Exclude volume mount and dismount entries from the
CHANGES report.
5.2.6 /FULL
Specifies that ELV is to generate a full report. A full report is
equivalent to using /DETAIL=HIGH.
Do not use the /FULL qualifier with /BRIEF, /DETAIL, ONE_LINE, or
/SUMMARY.
5.2.7 /INCLUDE
/INCLUDE=event-class[,...]
Includes the specified event class or classes in the report. Do
not use the /EXCLUDE qualifier with /INCLUDE.
For event-class, specify one or more of the keywords shown in the
following table. If you specify more than one keyword, you must
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_ Select control entries. Control entries include
ENTRIES the following entry types:
o System power failure restarts
o Time stamps
o System startups
o $SNDERR messages (system service to send
messages to error log)
o Operator messages
o Network messages
o ERRLOG.SYS created
CPU_ENTRIES Select CPU-related entries. CPU entries include
the following entry types:
o SBI alerts/faults
o Undefined interrupts
o MBA/UBA adapter errors
o Asynchronous write errors
o UBA errors
DEVICE_ Select device error entries.
ERRORS
ENVIRONMENTAL_ Select environmental entries.
ENTRIES
MACHINE_ Select machine check entries.
CHECKS
MEMORY Select memory errors.
SNAPSHOT_ Select snapshot entries.
ENTRIES
SYNDROME Select firmware-generated entries that describe
a symptom set used by VSI support personnel to
identify problems.
TIMEOUTS Select device timeout entries.
UNKNOWN_ Select any entry that has an unknown entry
ENTRIES class.
UNSOLICITED_ Select unsolicited MSCP entries.
MSCP
VOLUME_ Select volume mount and dismount entries.
CHANGES
5.2.8 /INTERACTIVE
/INTERACTIVE
/[NO]INTERACTIVE
Specifies whether or not ELV is to run in interactive shell mode.
By default, interactive shell mode results from the way ELV is
invoked.
5.2.9 /LOG
/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.
5.2.10 /NODE
/NODE=[node-name,...]
/NONODE=[node-name,...]
Includes or excludes events occurring on a specified node or
nodes from a report.
If you do not enter a node name, only events that occur on
the node on which you are running ELV are selected. (This is
important in a cluster.)
If you enter /NONODE without a value, events occurring on all
nodes that are represented in the error log file are processed.
5.2.11 /ONE_LINE
Specifies that a one-line-per-event report be generated instead
of a standard report.
Do not use /ONE_LINE with /BRIEF, /DETAIL, /FULL, or /SUMMARY
qualifiers.
5.2.12 /OUTPUT
/OUTPUT=[output-file]
Specifies that the output file is to contain a bit-to-text
translations of events.
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, the system defaults to
your current device and directory. If you do not specify a file
type, the default file type is .LIS.
5.2.13 /PAGE
/PAGE
/NOPAGE
Specifies whether or not to enable paged output of the generated
report.
5.2.14 /REJECTED
You can use the /REJECTED qualifier to include rejected events
in a report. (By default, only selected events are included in a
report.)
5.2.15 /SINCE
/SINCE=[date-time]
Specifies that only those events dated later than the stated date
and time are to be selected for the report.
You can use date-time to limit the report to those events dated
later than the specified 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.
5.2.16 /SUMMARY
Specifies that a summary report is to be generated rather than a
standard report.
Do not use /SUMMARY with /BRIEF, /DETAIL, /FULL, ONE_LINE, or
/TERSE qualifiers.
5.2.17 /TERSE
Specifies that the data is to be displayed in a less interpreted
format, regardless of detail level.
/TERSE has no effect when used with ONE_LINE or /SUMMARY. You can
use /TERSE with /BRIEF, /DETAIL, or /FULL, which use a default
display. (/ONE_LINE and /SUMMARY do not use the same default
display.)
5.3 – Examples
1.ELV> TRANSLATE /BEFORE=24-MAY-2002:04:51:33.87 ERRLOG.SYS;42
For this example, the default report produced for ERRLOG.SYS;42
contains all entries that were logged before 4:51 on May 24,
2002.
2.ELV> TRANSLATE /BRIEF ERRLOG.SYS;42
The command in this example generates a brief report.
3.ELV> TRANSLATE /DETAIL=LOW ERRLOG.SYS;42
The command in this example generates a report with a LOW level
of detail.
4.ELV> TRANSLATE /ENTRY=END:18 ERRLOG.SYS;42
The command in this example shows how to display entries before
a specified entry in a sequence.
5.ELV> TRANSLATE /ENTRY=(START:18,END:37) ERRLOG.SYS;42
The command in this example shows how to display entries within
a specified entry range.
6.ELV> TRANSLATE /EXCLUDE=DEVICE_ERRORS ERRLOG.SYS;42
The command in this example shows how to exclude the DEVICE_
ERRORS entry type from a report.
7.ELV> TRANSLATE /FULL ERRLOG.SYS;42
The command in this example generates a full report.
8.ELV> TRANSLATE /INCLUDE=(VOLUME_CHANGES, CPU_ENTRIES,
BUGCHECKS)
ERRLOG.SYS;42
The command in this example shows how to select VOLUME_
CHANGES, CPU_ENTRIES, and BUGCHECKS entry types.
9.ELV> TRANSLATE /INTERACTIVE ERRLOG.SYS
The command in this example enables interactive shell mode
after translating ERRLOG.SYS. (The default, NOINTERACTIVE,
returns you to the DCL prompt.)
10. ELV> TRANSLATE /LOG ERRLOG.SYS
This example shows how to enable the logging of control and
informational messages.
11. ELV> TRANSLATE /NONODE=(BEAVIS, BUTTHD) ERRLOG.SYS
The command in this example generates a report containing all
events except those occurring on nodes BEAVIS and BUTTHD.
12. ELV> TRANSLATE /ONE_LINE ERRLOG.SYS
The command in this example requests ELV to produce a one-line-
per-event report instead of a standard report.
13. ELV> TRANSLATE /OUTPUT=ERRLOG.DAT;3 ERRLOG.SYS;42
This example creates a binary file named ERRLOG.DAT. If a
version number is specified, as in this example, and a file
with the same name and version number does not exist, then the
binary file will be created with the specified version number.
14. ELV> TRANSLATE /PAGE ERRLOG.SYS
This example shows how to generate a paged report.
15. ELV> TRANSLATE /SINCE="24-MAY-2002 04:51:33.87" ERRLOG.SYS;42
For this example, the default report produced for ERRLOG.SYS;42
contains all entries that were logged after 4:51 on May 24,
2002.
16. ELV> TRANSLATE /SUMMARY ERRLOG.SYS
This example shows how to generate a summary report.
17. ELV> TRANSLATE /TERSE ERRLOG.SYS
This example shows how to generate a terse report.
6 – WRITE
Performs an image copy of events from one or more binary error
log files.
Format
WRITE [input-file,...]
6.1 – Parameter
input-file
Supplies one or more names of binary error log files from which
events are to be copied to a new binary error log file.
If you do not specify an input file name, the default input file
name is SYS$ERRORLOG:ERRLOG.SYS. If you do not specify a device
and directory, the system defaults to your current device and
directory. 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.
6.2 – Qualifiers
6.2.1 /BEFORE
/BEFORE=date-time
Specifies that only those events dated earlier than the stated
date and time are to be selected for the report.
Date-time specifies that only those events dated earlier than
the stated date and time are to be selected for the report. You
can specify an absolute time, a delta time, or a combination of
absolute and delta times. See the OpenVMS System Manager's Manual
for details on specifying times.
If you omit a date and time, TODAY is used.
6.2.2 /ENTRY
/ENTRY=keyword[,...]
Generates a report that includes the specified entry range or
starts at the specified entry number. You can specify one or
both keywords:
Keyword Description
START:decimal-value Indicates the start of a range of entries
in a report.
END:decimal-value Indicates the end of a range of entries
in a report.
Usage Notes:
o You can specify one or both of these parameters. If you
specify both parameters, you must enclose them in parentheses.
o If you specify /ENTRY without the entry range or omit the
qualifier, the entry range defaults to START:1,END:end-of-
file.
6.2.3 /EXCLUDE
/EXCLUDE=event-class[,...]
Excludes the specified event class or classes from the report. Do
not use the /EXCLUDE qualifier with /INCLUDE.
For event-class, specify one or more of the keywords shown in the
following table. If you specify more than one keyword, you must
use a comma-separated list of values enclosed in parentheses.
Keyword Description
ATTENTIONS Exclude device attention entries from the report.
BUGCHECKS Exclude all types of bugcheck entries from the
report.
CONFIGURATION Exclude system configuration entries from the
report.
CONTROL_ Exclude control entries from the report. Control
ENTRIES entries include the following entry types:
o System power failure restarts
o Time stamps
o System startups
o $SNDERR messages (system service to send
messages to error log)
o Operator messages
o Network messages
o ERRLOG.SYS created
CPU_ENTRIES Exclude CPU-related entries from the report. CPU
entries include the following entry types:
o SBI alerts/faults
o Undefined interrupts
o MBA/UBA adapter errors
o Asynchronous write errors
o UBA errors
DEVICE_ Exclude device error entries from the report.
ERRORS
ENVIRONMENTAL_ Exclude environmental entries from the report.
ENTRIES
MACHINE_ Exclude machine check entries from the report.
CHECKS
MEMORY Exclude memory errors from the report.
SNAPSHOT_ Exclude snapshot entries from the report.
ENTRIES
SYNDROME Exclude firmware-generated entries that describe
a symptom set used by VSI support personnel to
identify problems.
TIMEOUTS Exclude device timeout entries from the report.
UNKNOWN_ Exclude any entry that had either an unknown entry
ENTRIES type or an unknown device type or class.
UNSOLICITED_ Exclude unsolicited MSCP entries from the output
MSCP report.
VOLUME_ Exclude volume mount and dismount entries from the
CHANGES report.
6.2.4 /INCLUDE
/INCLUDE=event-class[,...]
Includes the specified event class or classes in the report. Do
not use the /EXCLUDE qualifier with /INCLUDE.
For event-class, specify one or more of the keywords shown in the
following table. If you specify more than one keyword, you must
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_ Select control entries. Control entries include
ENTRIES the following entry types:
o System power failure restarts
o Time stamps
o System startups
o $SNDERR messages (system service to send
messages to error log)
o Operator messages
o Network messages
o ERRLOG.SYS created
CPU_ENTRIES Select CPU-related entries. CPU entries include
the following entry types:
o SBI alerts/faults
o Undefined interrupts
o MBA/UBA adapter errors
o Asynchronous write errors
o UBA errors
DEVICE_ Select device error entries.
ERRORS
ENVIRONMENTAL_ Select environmental entries.
ENTRIES
MACHINE_ Select machine check entries.
CHECKS
MEMORY Select memory errors.
SNAPSHOT_ Select snapshot entries.
ENTRIES
SYNDROME Select firmware-generated entries that describe
a symptom set used by VSI support personnel to
identify problems.
TIMEOUTS Select device timeout entries.
UNKNOWN_ Select any entry that has an unknown entry
ENTRIES class.
UNSOLICITED_ Select unsolicited MSCP entries.
MSCP
VOLUME_ Select volume mount and dismount entries.
CHANGES
6.2.5 /INTERACTIVE
/INTERACTIVE
/[NO]INTERACTIVE
Specifies whether or not ELV is to run in interactive shell mode.
By default, interactive shell mode results from the way ELV is
invoked.
6.2.6 /LOG
/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.
6.2.7 /NODE
/NODE=[node-name,...]
/NONODE=[node-name,...]
Includes or excludes events occurring on a specified node or
nodes from a report.
If you do not enter a node name, only events that occur on
the node on which you are running ELV are selected. (This is
important in a cluster.)
If you enter /NONODE without a value, events occurring on all
nodes that are represented in the error log file are processed.
6.2.8 /OUTPUT
/OUTPUT=[output-file]
Specifies that the output file 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, the system
defaults to your current device and directory. If you do not
specify a file type, the default file type is .DAT.
6.2.9 /REJECTED
You can use the /REJECTED qualifier to include rejected events
in a report. (By default, only selected events are included in a
report.)
6.2.10 /SINCE
/SINCE=[date-time]
Specifies that only those events dated later than the stated date
and time are to be selected for the report.
You can use date-time to limit the report to those events dated
later than the specified 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.
6.3 – Examples
1.ELV> WRITE ERROR_LOG.SYS
The command in this example copies events in ERROR_LOG.SYS to
ERROR_LOG.DAT.
2.ELV> WRITE/OUTPUT
The command in this example copies events in the default file
ERRLOG.SYS to ERRLOG.DAT.
3.ELV> WRITE/OUTPUT=OUTFILE.OUT
The command in this example copies events in the default file
ERRLOG.SYS to OUTFILE.OUT.