OpenVMS System Management Utilities Reference Manual

/EXCLUDE

Excludes errors generated by the specified device class, device name, or event entry type from the report.

Format

/EXCLUDE= [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 event log 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 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_ENTRIES Exclude control entries from 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 Exclude CPU-related entries from 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 Exclude device error entries from the report.

ENVIRONMENTAL_ENTRIES Exclude environmental entries from the report.

MACHINE_CHECKS Exclude machine check entries from the report.

MEMORY Exclude memory errors from the report.

SNAPSHOT_ENTRIES Exclude snapshot entries from the report.

SYNDROME Exclude console-generated entries that describe a symptom set used by Digital support personnel to identify problems.

TIMEOUTS Exclude device timeout entries from the report.

UNKNOWN_ENTRIES Exclude any entry that had either an unknown entry type or an unknown device type or class.

UNSOLICITED_MSCP Exclude unsolicited MSCP entries from the output report.

VOLUME_CHANGES Exclude volume mount and dismount entries from the report.

DESCRIPTION

You can specify one or more devices by device class, device name, or one or more keywords that identify entry types.
Unless you specify the UNKNOWN_ENTRIES keyword to explicitly exclude from a report any entries from unsupported (unknown) devices, any unknown device is reported.
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 excludes event log entries for the BI bus. The DEVICE_ERRORS keyword also excludes entries for the BI adapter.

Examples

```
$ DIAGNOSE/TRANSLATE/EXCLUDE=MTA0 
```
In this example, entries for the device MTA0 are excluded from the full (default) report for the file ERRLOG.SYS.
```
$ DIAGNOSE/TRANSLATE/EXCLUDE=(MTA0,DRA5) ERRLOG.OLD 
```
In this example, the devices MTA0 and DRA5 are excluded from the full (default) report for the file ERRLOG.OLD.
```
$ DIAGNOSE/TRANSLATE/EXCLUDE=(DISKS,BUGCHECKS) 
```
In this example, all disk devices and all bugcheck entries are excluded from the full (default) report for the file ERRLOG.SYS.
```
$ DIAGNOSE/TRANSLATE/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/TRANSLATE/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/TRANSLATE/EXCLUDE=(DISKS,VOLUME_CHANGES,DEVICE_ERRORS) 
```
In this example, entries for all volume changes, for all disks, and for all device error information on disks are excluded from the full (default) report for the file ERRLOG.SYS.
```
$ DIAGNOSE/TRANSLATE/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 on disks, and all entries for bugcheck errors are excluded from the full (default) report for the file ERRLOG.SYS.

/FSTERR

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

Format

/FSTERR

DESCRIPTION

The FSTERR report provides the information that Digital support personnel need when troubleshooting tape or disk device problems.
Do not use /FSTERR with the /BINARY qualifier.
The Example section shows the format of a typical FSTERR report.

Example

$ DIAGNOSE/TRANSLATE/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.

/FULL

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

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/TRANSLATE/FULL ERRLOG.OLD;72 
```
In this example, the command produces a full (default) report.
```
$ DIAGNOSE/TRANSLATE 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.

/INCLUDE

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 Digital support personnel 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/TRANSLATE/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/TRANSLATE/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/TRANSLATE/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/TRANSLATE/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/TRANSLATE/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/TRANSLATE/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.

/INTERACTIVE

Allows users to exit the command line interface (CLI) and enter the DECevent interactive command shell.

Format

/INTERACTIVE

DESCRIPTION

All commands valid from the CLI are valid from within the interactive command shell. You do not need to precede qualifiers with DIAGNOSE/TRANSLATE when in the interactive command shell. In addition to CLI commands, the interactive command shell accepts SET, SAVE, and RESTORE commands.

Example

$ DIAGNOSE/TRANSLATE/INTERACTIVE

In this example, a user has requested to exit the command line interface and enter the DECevent interactive command shell.
The DIAG> prompt is displayed when in the interactive command shell.

/LOG

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/TRANSLATE/LOG ERRLOG.OLD;5

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

/NODE

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/TRANSLATE/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.

/OUTPUT

Specifies the output file for the report.

Format

/OUTPUT [=file-spec]

PARAMETER

file-spec
The output file selected for the report. See 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/TRANSLATE/OUTPUT=ERROR_LOG.LIS ERRLOG.OLD;72

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

/REJECTED

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/TRANSLATE/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.

/SINCE

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. See 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/TRANSLATE/SINCE=19-APR-1996: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, 1996.

/SUMMARY

Generates summary information of all events in the event log.

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/TRANSLATE/SUMMARY ERRLOG.OLD;5

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

/TERSE

Generates a 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.
Section 9.4 shows the format of a typical terse report.

Example

$ DIAGNOSE/TRANSLATE/TERSE ERRLOG.OLD;97

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

/TRANSLATE

Translates the contents of an event log file. This qualifier is the default qualifier to the DIAGNOSE verb.

Format

/TRANSLATE [qualifier(s)][infile][,...]

DESCRIPTION

The /TRANSLATE qualifier translates the contents of the default event log file, SYS$ERRORLOG:ERRLOG.SYS, or a selected input event log file.

Example

$ DIAGNOSE/TRANSLATE/BRIEF ERRLOG.OLD;97

In this example, the brief report generated from ERRLOG.OLD;97 contains minimal information.

9.4 DECevent Examples

Sample Event Log Reports

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; /TRANSLATE is the default qualifier.

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

$ DIAGNOSE/TRANSLATE/FULL 
 
$ DIAGNOSE

Example 9-1 shows the format of a full report.

Example 9-1 Full Report Format

******************************** ENTRY    1 ******************************** 
Logging OS                        1. OpenVMS 
System Architecture               2. Alpha 
OS version                           V7.1 
Event sequence number          1583. 
Timestamp of occurrence              18-APR-1996 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/TRANSLATE/BRIEF

Example 9-2 shows the format for a brief report.

Example 9-2 Brief Report Format

******************************** ENTRY    1 ******************************** 
 
Logging OS                        1. OpenVMS 
System Architecture               2. Alpha 
OS version                           V7.1 
Event sequence number          1583. 
Timestamp of occurrence              18-APR-1996 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/TRANSLATE/TERSE

Example 9-3 shows the format for a terse report.

Example 9-3 Terse Report Format

******************************** ENTRY    1 ******************************** 
 
Logging OS                           1. 
System Architecture                  2. 
OS version                  V7.1 
Event sequence number             1583. 
Timestamp of occurrence     1996041809211800 
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.

  6048P019.HTM
  OSSG Documentation
  26-NOV-1996 12:42:45.72

Legal

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

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_ENTRIES	Exclude control entries from 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	Exclude CPU-related entries from 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	Exclude device error entries from the report.
ENVIRONMENTAL_ENTRIES	Exclude environmental entries from the report.
MACHINE_CHECKS	Exclude machine check entries from the report.
MEMORY	Exclude memory errors from the report.
SNAPSHOT_ENTRIES	Exclude snapshot entries from the report.
SYNDROME	Exclude console-generated entries that describe a symptom set used by Digital support personnel to identify problems.
TIMEOUTS	Exclude device timeout entries from the report.
UNKNOWN_ENTRIES	Exclude any entry that had either an unknown entry type or an unknown device type or class.
UNSOLICITED_MSCP	Exclude unsolicited MSCP entries from the output report.
VOLUME_CHANGES	Exclude volume mount and dismount entries from the report.

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 Digital support personnel 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.