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,...]
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 – 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 /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.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.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.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.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.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.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.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.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.
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.