ELV$HELP.HLB  —  TRANSLATE
    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.
Close Help