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.
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, 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.
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 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.
2.2 /BRIEF
Specifies that ELV is to generate a brief standard report. Do not
use /BRIEF with /FULL or /ONE_LINE.
2.3 /ENTRY
/ENTRY[=keyword,...]
Specifies the range of entries to be selected.
You can specify one or both of the following keywords:
Keyword Description
START[:decimal- Indicates the start of a range of entries to
value] be selected.
END[:decimal- Indicates the end of a range of entries to be
value] selected.
Usage Notes:
o You can specify one or both of these keywords. If you specify
both keywords, you must enclose them in parentheses.
o If you specify /ENTRY without an entry range, the entry range
defaults to START:1,END:end-of-file.
o If you specify the START or END keyword without a value, the
keyword is ignored.
2.4 /EXCLUDE
/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:
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 Reject 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_ERRORS Reject device error entries.
ENVIRONMENTAL_ Reject environmental entries.
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 VSI 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.
2.5 /FULL
Specifies that ELV is to generate a full standard report. Do not
use /FULL with /BRIEF or /ONE_LINE.
2.6 /INCLUDE
/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:
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_ERRORS Select device error entries.
ENVIRONMENTAL_ Select environmental entries,
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 VSI 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.
2.7 /INTERACTIVE
/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.
2.8 /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.9 /NODE
/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.
2.10 /ONE_LINE
Specifies that ELV is to generate a one-line-per-event standard
report. Do not use /ONE_LINE with /BRIEF or /FULL.
2.11 /OUTPUT
/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.
2.12 /PAGE
/PAGE
/NOPAGE
Specifies whether or not to enable paged output of a report. The
default /NOPAGE disables paged output of reports.
2.13 /REJECTED
Specifies that rejected (rather than selected) events are to be
translated.
2.14 /SINCE
/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.
2.15 /SUMMARY
/SUMMARY
/NOSUMMARY
Specifies that a summary report or a standard report is to be
generated:
o If you enter /SUMMARY, only a summary report is generated.
o If you enter /NOSUMMARY, only a standard report is generated.
o If you omit the qualifier altogether, the default is to
display both a standard and a summary report.
2.16 /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 <REFERENCE>(terse).
3 – 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.