Performs a bit-to-text translation of one or more binary error
log files.
Format
TRANSLATE [input-file,...]
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.
2 – Qualifiers
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 /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.
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.
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.
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.
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.
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
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.
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.
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.
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.
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.
2.13 /PAGE
/PAGE
/NOPAGE
Specifies whether or not to enable paged output of the generated
report.
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.)
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.
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.
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.)
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.