ELV$HELP.HLB  —  DUMP
    Writes events from one or more binary error log files to a single
    new ASCII output file in an OpenVMS dump-style format.

    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, 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. Do not use /BEFORE with
    /INVALID.

    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    /ENTRY

       /ENTRY[=keyword,...]

    Specifies the range of entries to be selected. Do not use /ENTRY
    with /INVALID.

    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.3    /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.4    /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.5    /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.6    /INVALID

    Specifies that invalid (rather than valid) events are to be
    written to an output dump file. Do not use /INVALID with /BEFORE,
    /ENTRY, /EXCLUDE, /INCLUDE, /[NO]NODE, /REJECTED, or /SINCE.

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

    Specifies that events occurring on a node or nodes are to be
    selected or rejected. Do not use /NODE or /NONODE with /INVALID.

    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.9    /OUTPUT

       /OUTPUT[=output-file]

    Specifies the output file that is to contain OpenVMS dump-style
    records for 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, your current
    device and directory are used. If you do not specify a file type,
    the default file type is .DMP.

2.10    /REJECTED

    Specifies that rejected (rather than selected) events are to
    be written to an output dump file. Do not use /REJECTED with
    /INVALID.

2.11    /SINCE

       /SINCE[=date-time]

    Specifies that only those events dated later than the stated date
    and time are to be selected. Do not use /SINCE with /INVALID.

    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.

3  –  Examples

    1.ELV> DUMP /NODE=DUMBO /ENTRY=END:10 ERROR_FILE.SYS,ERRLOG.SYS

      The command in this example writes OpenVMS dump-style records
      created from selected events in two input files, ERROR_FILE.SYS
      and ERRLOG.SYS, to an output dump file named ERROR_FILE.DMP.
      The name of the output file comes from the name of the first
      input file in the list.

      The selected events, which end with entry 10, are those that
      occurred on node DUMBO.

    2.$ ANALYZE/ERROR_LOG/ELV DUMP /INCLUDE=(DEVICE_ERRORS,TIMEOUTS) /LOG

      The command in this example writes OpenVMS dump-style
      records created from selected events in the default
      SYS$ERRORLOG:ERRLOG.SYS file to an output dump file named
      ERRLOG.DMP.

      The selected events include only the DEVICE_ERRORS and TIMEOUTS
      event classes. In addition, control and informational messages
      are output to the terminal.

    3.ELV> DUMP /SINCE=22-MAY-2003:01:00:00.00 /BEFORE=24-MAY-2003:04:51:33.87

      The command in this example writes OpenVMS dump-style
      records created from selected events in the default
      SYS$ERRORLOG:ERRLOG.SYS file to an output dump file named
      ERRLOG.DMP.

      The selected events fall in the interval between the two
      specified dates.

    4.ELV> DUMP /SINCE=22-MAY-2003:01:00:00.00 /BEFORE=24-MAY-2003:04:51:33.87
      /REJECTED

      This example is identical to the previous example except that
      rejected events are written rather than selected events.

      The rejected events are those that fall outside the interval
      between the two specified dates.

    5.$ ANALYZE/ERROR_LOG/ELV DUMP /INVALID /OUTPUT=OUTFILE.OUT

      The command in this example writes OpenVMS dump-style
      records created from invalid events in the default
      SYS$ERRORLOG:ERRLOG.SYS file to an output dump file named
      OUTFILE.OUT.
Close Help