ELV$HELP.HLB  —  CONVERT
    Converts and writes events from one or more binary error log
    files written in the newer format to a single new error log file
    written in the older format. The new file can then be 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, 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    /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.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 is entered.

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

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

       /OUTPUT[=output-file]

    Specifies the output file that is to contain converted copies of
    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 .CVT.

2.9    /REJECTED

    Specifies that rejected (rather than selected) events are to be
    converted.

2.10    /SINCE

       /SINCE[=date-time]

    Specifies that only those events dated later 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.

3  –  Examples

    1.$ ANALYZE/ERROR_LOG/ELV CONVERT /INTERACTIVE /NONODE=(BEAVIS,BUTTHD)

      The command in this example, executed from DCL command level,
      converts selected events in the default SYS$ERRORLOG:ERRLOG.SYS
      file to the older format and writes these events to the
      ERRLOG.CVT file. After the command executes, the system
      displays the ELV> prompt.

      The selected events are from all nodes except BEAVIS and
      BUTTHD.

    2.ELV> CONVERT /LOG /OUTPUT=OUTFILE

      The command in this example converts events in the default
      SYS$ERRORLOG:ERRLOG.SYS file to the older format and writes the
      converted events to OUTFILE.CVT.

      In addition, control and informational messages are output to
      the terminal.

    3.$ ANALYZE/ERROR_LOG/ELV CONVERT /NODE /BEFORE=YESTERDAY ERROR_LOG.SYS

      The command in this example converts selected events from
      ERROR_LOG.SYS to the older format and writes the converted
      events to ERROR_LOG.CVT.

      The selected events are those that occurred before YESTERDAY on
      the current node.

    4.ELV> CONVERT /ENTRY=START:5 /EXCLUDE=BUGCHECKS

      The command in this example converts events in the default
      SYS$ERRORLOG:ERRLOG.SYS file to the older format and writes the
      converted events to ERRLOG.CVT.

      The selected events, which start with entry 5, do not include
      the BUGCHECKS event class.
Close Help