HP OpenVMS Systems Documentation

In this example, all disk devices and all bugcheck entries are excluded from the full (default) report for the file ERRLOG.SYS.

DIAGNOSE/EXCLUDE=TAPES/INCLUDE=MTA0
      

In this example, the device MTA0 is included in the full (default) report for the file ERRLOG.SYS. All other magnetic tape devices are excluded from the report.

DIAGNOSE/EXCLUDE=(DISKS,VOLUME_CHANGES)
      

In this example, entries for disks and entries for all volume information are excluded from the full (default) report for the file ERRLOG.SYS.

DIAGNOSE/EXCLUDE=(DISKS,VOLUME_CHANGES,DEVICE_ERRORS)
      

In this example, entries for all volume changes, for all disks, and for all device error information about disks are excluded from the full (default) report for the file ERRLOG.SYS.

DIAGNOSE/EXCLUDE=(DISKS,VOLUME_CHANGES,DEVICE_ERRORS,BUGCHECKS)
      

In this example, all entries for disks, all entries for volume changes, all entries for device error information about disks, and all entries for bugcheck errors are excluded from the full (default) report for the file ERRLOG.SYS.

Generates a quick, one-line-per-entry report for various disk and tape devices.

Section 9.4 shows the format of a typical FSTERR report.

Format

/FSTERR

Description

The FSTERR report provides the information that Compaq support representatives need when troubleshooting tape or disk device problems.

Do not use /FSTERR with the /BINARY qualifier.

Example

$ DIAGNOSE/FSTERR ERRLOG.OLD;72
      

In this example, the command produces a FSTERR report for tape and disk devices from information contained in the event log ERRLOG.OLD;72.

Generates a full report, which provides all available information for an event entry. This is the default report format.

Section 9.4 contains an example of the format of a typical full report.

Format

/FULL

Description

The full report format provides a translation of all available information for each entry in the event log. The full report is the default report type if a report type is not specified in the command line.

Do not use /FULL with the /BINARY qualifier.

Examples

DIAGNOSE/FULL ERRLOG.OLD;72
      

In this example, the command produces a full (default) report.

DIAGNOSE ERRLOG.OLD;72
      

In this example, the command produces a full (default) report. The default report type is /FULL; it is not necessary to specify it in the command line.

Includes events generated by the specified device class, device name, or event log entry type in the report.

Format

/INCLUDE= [device-class | device-name | entry-type ] [,...]

Parameters

device-class

device-name

entry-type

Specifies one or more keywords denoting the device class, device name, or entry type. If you specify more than one keyword, you must specify a comma-separated list of values that is enclosed in parentheses.

Device Class Keywords

ADAPTER
BUSES
CACHE
DISKS
INFORMATIONAL
LINE_PRINTER
REALTIME
SYNC_COMMUNICATIONS
TAPES
VECTOR
WORKSTATION

Examples of Device Name Constructs

DB	Group of devices
DBA1	Specific device/unit number
(DBA1,HSC1$DUA1,DYA0)	List of devices
(DB,DR,XF)	List of device groups

Entry-Type Keywords

ATTENTIONS	Include device attention entries in the report.
BUGCHECKS	Include all types of bugcheck errors in the report.
CONFIGURATION	Include system configuration entries in the report.
CONTROL_ENTRIES	Include control entries in the report. Control entries include the following entry types: System power failure restarts Time stamps System startups $SNDERR messages (system service to send messages to error log) Operator messages Network messages ERRLOG.SYS created
CPU_ENTRIES	Include CPU-related entries in the report. CPU entries include the following entry types: SBI alerts/faults Undefined interrupts MBA/UBA adapter errors Asynchronous write errors UBA errors
DEVICE_ERRORS	Include device errors in the report.
ENVIRONMENTAL_ENTRIES	Include environmental entries in the report.
MACHINE_CHECKS	Include machine check errors in the report.
MEMORY	Include memory errors in the report.
SNAPSHOT_ENTRIES	Include snapshot entries in the report.
SYNDROME	Include console-generated entries that describe a symptom set used by Compaq support representatives to identify problems.
TIMEOUTS	Include device timeout errors in the report.
UNKNOWN_ENTRIES	Include any entry that had either an unknown entry type or an unknown device type or class.
UNSOLICITED_MSCP	Include unsolicited MSCP entries in the output report.
VOLUME_CHANGES	Include volume mount and dismount entries in the report.

Description

You can specify one or more devices by device class, device name, or one or more keywords that identify entry types.

Use the UNKNOWN_ENTRIES keyword to obtain a report that contains the contents of the device registers logged by unsupported devices.

Any known information for the entry is translated; the remaining information is output in hexadecimal longwords.

If you specify a device class keyword or a device name construct with both the /INCLUDE and /EXCLUDE qualifiers, the /INCLUDE qualifier takes precedence.

The BUSES keyword also includes error log entries for the BI bus. The DEVICE_ERRORS keyword also includes entries for the BI adapter.

Examples

DIAGNOSE/INCLUDE=MTA0
      

In this example, the full (default) report consists of entries for the device MTA0, which are in the default error log file ERRLOG.SYS.

DIAGNOSE/INCLUDE=MTA0/EXCLUDE=TAPES
      

In this example, the device MTA0 is included in the full (default) report for the file ERRLOG.SYS. All other magnetic tape devices are excluded from the report.

DIAGNOSE/INCLUDE=(MTA0,VOL)
      

In this example, the full (default) report consists of all entries and volume mounts and dismounts for the device MTA0, which are in the default error log file ERRLOG.SYS.

DIAGNOSE/INCLUDE=(DISKS,VOLUME_CHANGES)
      

In this example, the full (default) report consists of all entries for all disks and all entries for volume information, which are in the default error log file ERRLOG.SYS.

DIAGNOSE/INCLUDE=(DISKS,VOLUME_CHANGES,DEVICE_ERROR)
      

In this example, the report consists of all entries for disks, all volume entries and all device error information on disks, which are in the default error log file ERRLOG.SYS.

DIAGNOSE/INCLUDE=(DISKS,VOLUME_CHANGES,DEVICE_ERROR,BUGCHECK)
      

In this example, the full (default) report consists of all entries for disks, all entries for volume changes, all entries for device error information on disks, and all entries for bugcheck events. These entries are in the default error log file ERRLOG.SYS.

Controls whether informational messages that specify the number of entries selected and rejected for each input file are sent to SYS$OUTPUT. By default, these messages are not displayed.

Format

/[NO]LOG

Example

$ DIAGNOSE/LOG ERRLOG.OLD;5
      

In this example, informational messages generated about ERRLOG.OLD;5 are sent to SYS$OUTPUT.

Generates a report consisting of error log entries for specific nodes in an OpenVMS Cluster system.

Format

/NODE= (node-name[,...])

Parameter

node-name

Specifies the names of one or more OpenVMS Cluster members. Names cannot exceed six characters. If more than one node name is entered, you must specify a comma-separated list of node names that is enclosed in parentheses.

Example

$ DIAGNOSE/NODE=(GARCIA,LESH) SYS$SYSROOT:[SYS*.SYSERR]ERRLOG.SYS
      

In this example, the cluster system consists of members BROOME, GARCIA, LESH, and PUTNAM. The output full (default) report contains only those entries that were logged for nodes GARCIA and LESH.

Specifies the output file for a report.

Format

/OUTPUT [=file-spec]

Parameter

file-spec

The output file selected for the report. Refer to the OpenVMS User's Manual for details on specifying files.

Description

If you omit the /OUTPUT qualifier, output is directed to SYS$OUTPUT. If you specify /OUTPUT=file-spec, the selected output file contains the report. If you omit the device or directory specification, the current device and default directory are used. If you omit the file name, the file name of the input file is used. If you omit the file type, the default file type is .LIS.

Do not use /OUTPUT with the /BINARY qualifier.

Example

$ DIAGNOSE/OUTPUT=ERROR_LOG.LIS ERRLOG.OLD;72
      

In this example, the default full report ERROR_LOG.LIS contains entries generated from ERRLOG.OLD;72.

Allows you to specify the name of a file that will contain binary records for rejected entries.

Format

/REJECTED [=file-spec]

Parameter

file-spec

Specifies the name of the file that is to contain the rejected entries.

Description

The /REJECTED qualifier creates a binary file that contains copies of the original binary event log entry. If the event log entry is rejected because the command line also specifies an interval (/SINCE, /BEFORE, or /ENTRY qualifier) or a filter (/INCLUDE or /EXCLUDE qualifier), the entry is written to the specified file.

Rejected entries are not translated because they fall into one of the following categories:

• All entries specified with the /EXCLUDE qualifier
• All entries not specified with the /INCLUDE qualifier
• Any entry that does not occur within the period specified by the /SINCE and /BEFORE qualifiers
• Any entry that is not in the range of entries specified by the /ENTRY qualifier

If you specify /REJECTED=file-spec, the output file contains image copies of the rejected records. If you omit the device or directory specification, the current device and default directory are used. If you omit the file name, the file name of the input file is used. If you omit the file type, the default file type is .REJ.

Example

$ DIAGNOSE/INCLUDE/BINARY=MTA0/REJECTED=REAL_ERRS.DAT ERRLOG.OLD;5
      

In this example, the output file REAL_ERRS.DAT contains image copies of all entries from ERRLOG.OLD;5, with the exception of those entries that apply to the MTA0 device. Note the use of the /BINARY qualifier.

Specifies that only those entries dated later than the stated date and time are to be selected for the report.

Format

/SINCE [=date-time]

Parameter

date-time

Limits the error report to those entries dated later than the specified time.

Description

Only absolute date and time specifications are valid. Refer to the OpenVMS User's Manual for details on specifying times.

If you omit the /SINCE qualifier, all entries are processed. If you specify /SINCE without a date and time, the default is TODAY.

Example

$ DIAGNOSE/SINCE=19-APR-2000:15:00 ERRLOG.OLD;56
      

In this example, the full (default) report generated from ERRLOG.OLD;56 contains entries that have been logged since 15:00 on April 19, 2000.

Generates summary information of all events in the event log.

Section 9.4 contains an example of summary information.

Format

/SUMMARY

Description

The /SUMMARY qualifier generates a summary report from the specified input event log file.

Do not use the /BINARY qualifier with /SUMMARY.

Example

$ DIAGNOSE/SUMMARY ERRLOG.OLD;5
      

The output generated by the command in this example is a summary report of all entries in ERRLOG.OLD;5.

Generates a terse report.

Section 9.4 shows the format of a typical terse report.

Format

/TERSE

Description

The /TERSE qualifier specifies that the registers and header of each event entry be formatted in the standard report type format, but the contents of each register are not translated into readable messages.

Do not use the /TERSE report qualifier with the /BINARY qualifier.

Example

$ DIAGNOSE/TERSE ERRLOG.OLD;97
      

In this example, the terse report generated from ERRLOG.OLD;97 contains register and header information.

9.4 DECevent Examples

The DECevent event management utility provides the following five report types:

• Full
• Brief
• Terse
• Summary
• FSTERR

The following sections show examples of each report type with a brief explanation of each.

Full Report Example

To produce a full report, use the /FULL qualifier. The full report format provides a translation of all available information for each entry in the event log. The full report is the default report type if a report type is not specified in the command line.

Either of the following commands will produce a full report format:

$ DIAGNOSE/FULL

$ DIAGNOSE

The following example shows the format of a full report.

******************************** ENTRY    1 ********************************
Logging OS                        1. OpenVMS
System Architecture               2. Alpha
OS version                           V7.3
Event sequence number          1583.
Timestamp of occurrence              18-APR-2000 09:21:18
System uptime in seconds      58004.
Error mask                x00000000
Flags                         x0001  Dynamic Device Recognition present
Host name                            COGENT

Alpha HW model                       DEC 3000 Model 400
System type register      x00000004  DEC 3000
Unique CPU ID             x00000002
mpnum                     x000000FF
mperr                     x000000FF

Event validity                   -1. Unknown validity code
Event severity                   -1. Unknown severity code
Entry type                      100.
Major Event class                 3. IO Subsystem

IO Minor Class                    1. MSCP
IO Minor Sub Class                5. Logged Message

---- Device Profile ----
Vendor
Product Name                         RAID 0 - Host Based
Unit Name                            COGENT$DPA
Unit Number                      10.
Device Class                  x0001  Disk

---- IO SW Profile ----
VMS DC$_CLASS                     1.
VMS DT$_TYPE                    175.

---- MSCP Logged Msg ----

Logged Message Type Code         22. RAID Message
RAID Event Type                   8. Remove Member
Distinguished Member              0.
Member Index                      1.
RAID Urgency                      4. Global Disk Error
RAID Status               x00180009  Bit 00 - Reduced
                                     Bit 03 - Striped
                                     Bit 19 - FE Dis FE
                                     Bit 20 - BC Buff Copy Off
RAIDset Name                         KGB

****************************************************************************

Brief Report Example

To produce a brief report, use the /BRIEF qualifier. The brief report format provides translation of key information for each entry in the event log.

For a brief report format, enter the following command:

$ DIAGNOSE/BRIEF

The following example shows the format for a brief report.

******************************** ENTRY    1 ********************************

Logging OS                        1. OpenVMS
System Architecture               2. Alpha
OS version                           V7.3
Event sequence number          1583.
Timestamp of occurrence              18-APR-2000 09:21:18
System uptime in seconds      58004.
Error mask                x00000000
Host name                            COGENT

Alpha HW model                       DEC 3000 Model 400
System type register      x00000004  DEC 3000
Unique CPU ID             x00000002
mpnum                     x000000FF
mperr                     x000000FF

Event validity                   -1. Unknown validity code
Event severity                   -1. Unknown severity code
Major Event class                 3. IO Subsystem

IO Minor Class                    1. MSCP
IO Minor Sub Class                5. Logged Message

---- Device Profile ----
Vendor
Product Name                         RAID 0 - Host Based
Unit Name                            COGENT$DPA
Unit Number                      10.
Device Class                  x0001  Disk



Logged Message Type Code         22. RAID Message
RAID Event Type                   8. Remove Member
Distinguished Member              0.
Member Index                      1.
RAID Urgency                      4. Global Disk Error
RAID Status               x00180009  Bit 00 - Reduced
                                     Bit 03 - Striped
                                     Bit 19 - FE Dis FE
                                     Bit 20 - BC Buff Copy Off
RAIDset Name                         KGB

*****************************************************************************

Terse Report Example

To produce a terse report, use the /TERSE qualifier. The terse report format provides binary event information and displays register values and other ASCII messages in a condensed format.

For a terse report format, enter the following command:

$ DIAGNOSE/TERSE

The following example shows the format for a terse report.

******************************** ENTRY    1 ********************************

Logging OS                           1.
System Architecture                  2.
OS version                  V7.3
Event sequence number             1583.
Timestamp of occurrence     2000041809211800
System uptime in seconds         58004.
Error mask                   x00000000
Flags                            x0001
Host name                   COGENT
Alpha HW model               DEC 3000 Model 400
System type register         x00000004
Unique CPU ID                x00000002
mpnum                        x000000FF
mperr                        x000000FF
Event validity                      -1.
Event severity                      -1.
Entry type                         100.
Major Event class                    3.
IO Minor Class                       1.
IO Minor Sub Class                   5.
---- Device Profile ----
Vendor
Product Name                RAID 0 - Host Based
Unit Name                   COGENT$DPA
Unit Number                         10.
Device Class                     x0001

---- IO SW Profile ----
VMS DC$_CLASS                        1.
VMS DT$_TYPE                       175.
---- MSCP Logged Msg ----

Logged Message Type Code            22.
RAID Event Type                      8.
Distinguished Member                 0.
Member Index                         1.
RAID Urgency                         4.
RAID Status                  x00180009
RAIDset Name                KGB

**********************************************************************

Summary Report Example

To produce a summary report, use the /SUMMARY qualifier. The summary report format provides a statistical summary of the event entries in the event log.

For a summary report format, enter the following command:

$ DIAGNOSE/SUMMARY

The following example shows the format for a summary report.

***************************************************************************

 SUMMARY OF ALL ENTRIES LOGGED ON NODE COGENT

     IO Subsystem
       MSCP                                  9.
       Host Based RAID                       3.

 DATE OF EARLIEST ENTRY                18-APR-2000 09:21:18
 DATE OF LATEST ENTRY                  12-MAY-2000 10:44:54

***************************************************************************