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,...]
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.
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 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.
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 /INVALID
Allows you to specify the name of a file to contain invalid entries.
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.
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.
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.
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.)
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 – 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.