ANALYZE, /ERROR_LOG
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help ANALYZE, /ERROR_LOG *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
The Error Log utility (ERROR LOG) selectively reports the
contents of an error log file.
Starting with OpenVMS Version 7.2, before using the Error
Log utility, you need to translate error log files using the
Binary Error Log Translation utility, which is part of
DECevent. For more information, refer to DECevent
documentation, which is included in the DECevent kit.
Format
ANALYZE/ERROR_LOG [/qualifier(s)] [file-spec[,...]]
| 1 - Qualifiers |
1.1 - /BEFORE
/BEFORE[=date-time]
Specifies that only those entries dated earlier than the stated
date and time are to be selected for the error report. If you do
not specify a date or time, all entries are processed.
1.2 - /BINARY
/BINARY[=file-spec]
/NOBINARY
Controls whether the binary error log records are converted to
ASCII text or copied to the specified output file.
Do not use /BINARY with the /FULL, /BRIEF, /OUTPUT, or /REGISTER_
DUMP qualifiers. These qualifiers generate an ASCII report;
/BINARY generates a binary file.
1.3 - /BRIEF
Generates a brief report. Do not use /BRIEF with the /BINARY
qualifier.
1.4 - /ENTRY
/ENTRY[=(START:decimal-value[,END:decimal-value])]
Generates an error log report that includes the specified entry
range or starts at the specified entry number. If you specify
/ENTRY without the entry range or omit the qualifier, the entry
range defaults to START:1,END:end-of-file.
1.5 - /EXCLUDE
/EXCLUDE=
{ device-class }
( { device-name } [,...])
{ entry-type }
{ }
Excludes errors generated by the specified device class, device
name, or error log entry type from the error log report. If you
specify more than one keyword, you must specify a comma-separated
list of values that is enclosed in parentheses.
You can specify one or more devices by device class or name. The
following keywords and name constructs are valid for specifying
devices:
Device Class Keywords:
ADAPTER
BUSES
CACHE
DISKS
INFORMATIONAL
LINE_PRINTER
REALTIME
SYNC_COMMUNICATIONS
TAPES
VECTOR
WORKSTATION
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
You can specify one or more of the following keywords that
identify entry types:
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:
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 Exclude CPU-related entries from the
report. 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 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.
SYNDROME Exclude console-generated entries that
describe a symptom set used by Compaq
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.
1.6 - /FULL
/FULL (D)
/NOFULL
Generates a full report that provides all available information
for an error log entry. Do not use /FULL with the /BINARY
qualifier.
1.7 - /INCLUDE
/INCLUDE=
{ device-class }
( { device-name } [,...])
{ entry-type }
{ }
Includes errors generated by the specified device class, device
name, or error log entry type in the error log report. If you
specify more than one keyword, you must specify a comma-separated
list of values that is enclosed in parentheses.
You can specify one or more devices by device class or name. The
following keywords and name constructs are valid for specifying
devices:
Device Class Keywords:
ADAPTER
BUSES
CACHE
DISKS
INFORMATIONAL
LINE_PRINTER
REALTIME
SYNC_COMMUNICATIONS
TAPES
VECTOR
WORKSTATION
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
You can specify one or more of the following keywords that
identify entry types:
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:
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 Include CPU-related entries in the report.
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 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.
SYNDROME Include console-generated entries that
describe a symptom set used by Compaq
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.
1.8 - /LOG
/LOG
/NOLOG (D)
Controls whether informational messages that specify the number
of entries selected and rejected for each input file are sent to
SYS$OUTPUT.
1.9 - /MODEL
/MODEL=(hexadecimal-value[,...])
Generates a report consisting of event log entries that occurred
on the specified CPU. If you specify more than one hexadecimal
value, you must specify a comma-separated list of values that is
enclosed in parentheses. (Alpha only)
1.10 - /NODE
/NODE=(node-name[,...])
Generates a report consisting of error log entries for specific
nodes in an OpenVMS Cluster system. If you specify more than one
node name, you must specify a comma-separated list of values that
is enclosed in parentheses.
1.11 - /OUTPUT
/OUTPUT[=file-spec]
Specifies the output file for the error log report. If you omit
the output file specification, output is directed to SYS$OUTPUT.
Do not use /OUTPUT with the /BINARY qualifier.
1.12 - /REGISTER_DUMP
Used in conjunction with the /INCLUDE qualifier to generate, in
a hexadecimal longword format, a report that consists of device
register information. Do not use /REGISTER_DUMP with the /BINARY
qualifier.
1.13 - /REJECTED
/REJECTED[=file-spec]
Allows you to specify the name of a file that will contain binary
records for rejected entries. If you do not specify an output
file, the data are written to the file ERRLOG.REJ in your current
directory.
1.14 - /SID_REGISTER
/SID_REGISTER=(hexadecimal-value[,...])
Generates a report consisting of error log entries that occurred
on the specified CPU. If you specify more than one hexadecimal
value, you must specify a comma-separated list of values that is
enclosed in parentheses. (VAX only)
1.15 - /SINCE
/SINCE[=date-time]
Specifies that only those entries dated later than the stated
date and time are to be selected for the report. If you specify
/SINCE without a date and time, the default is TODAY. If you omit
the /SINCE qualifier, all entries are processed.
1.16 - /STATISTICS
Generates run-time statistical information.
| 2 - Examples |
1. $ ANALYZE/ERROR_LOG/BEFORE=19-APR-2000:10:00 ERRLOG.OLD;5
In this example, the error log report generated for ERRLOG.OLD;5
contains entries that were logged before 10:00 a.m on April 19, 2000.
2. $ ANALYZE/ERROR_LOG/INCLUDE=DBA1/BINARY=DBA1_ERR.DAT ERRLOG.OLD;5
In this example, the output file DBA1_ERR.DAT contains image
copies of the entries that apply to DBA1.
3. $ ANALYZE/ERROR_LOG/BRIEF ERRLOG.OLD;97
In this example, the error log report generated from
ERRLOG.OLD;97 contains minimal information.
4. $ ANALYZE/ERROR_LOG/ENTRY=(START:1,END:18) ERRLOG.SYS
In this example, the entry range for the error log report
generated from file ERRLOG.SYS is limited to entry numbers 1
through 18.
5. $ ANALYZE/ERROR_LOG/EXCLUDE=MTA0
In this example, the error log entries for the device MTA0 are
excluded from the error log report for the file ERRLOG.SYS.
6. $ ANALYZE/ERROR_LOG/EXCLUDE=(MTA0,DRA5) ERRLOG.OLD
In this example, the devices MTA0 and DRA5 are excluded from the
error log report for the file ERRLOG.OLD.
7. $ ANALYZE/ERROR_LOG/EXCLUDE=TAPES/INCLUDE=MTA0
In this example, the device MTA0 is included in the error log
report for the file ERRLOG.SYS. All other magnetic tape devices
are excluded from the report.
8. $ ANALYZE/ERROR_LOG/INCLUDE=(DISK,VOLUME_CHANGES, -)
_$ DEVICE_ERROR,BUGCHECK
In this example, the report consists of error log entries for
volume and device error information on disks, and bugcheck
errors. These entries are in the default error log file
ERRLOG.SYS.
9. $ ANALYZE/ERROR_LOG/MODEL=415 ERRLOG.SYS
In this example, the output consists of only those entries
that were logged for the system with a model type of 00000415
(hexadecimal).
10. $ ANALYZE/ERROR_LOG/NODE=(ORANGE,NASSAU) -
_$ SYS$SYSROOT:[SYS*.SYSERR]ERRLOG.SYS
In this example, the OpenVMS Cluster system consists of members
BROOME, NASSAU, ORANGE, and PUTNAM. The output contains only
those entries that were logged for nodes NASSAU and ORANGE.
11. $ ANALYZE/ERROR_LOG/INCLUDE=DB/REGISTER_DUMP ERRLOG.OLD;72
In this example, the output is in the format of a REGISTER_DUMP
report containing entries that apply only to the DB device.
12. $ ANALYZE/ERROR_LOG/INCLUDE=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.
13. $ ANALYZE/ERROR_LOG/SID_REGISTER=02006148 ERRLOG.OLD;72
The /SID_REGISTER qualifier is for VAX only. In this example,
the output consists of only those entries that were logged for
the system with an ID of 02006148 (hexadecimal).
14. $ ANALYZE/ERROR_LOG/STATISTICS ERRLOG.OLD;4
In this example, the output generated by this command consists
of a full report of all entries in ERRLOG.OLD;4 and the run-time
statistics for the execution of the command.
15. $ ANALYZE/ERROR_LOG/INCLUDE=DBA4/NOFULL/SUMMARY ERRLOG.OLD;5
The /SUMMARY qualifier is for VAX only. The output generated
by the command in this example includes the summary report. The
report contains the entries that apply to the DBA4 device: device
error, device timeout, and device attention.
3 - /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]
date-time
Limits the error report to those entries dated later than the
specified time. If you specify /SINCE without a date and time,
the default is TODAY. If you omit the /SINCE qualifier, all
entries are processed.
3.1 - Description
Only absolute date and time specifications are valid. See the
OpenVMS User's Manual for details on specifying times.
3.2 - Example
$ ANALYZE/ERROR_LOG/SINCE=19-APR-2000:15:00 ERRLOG.OLD;56
In this example, the error log report generated from
ERRLOG.OLD;56 contains entries that have been logged since
15:00 on April 19, 2000.
4 - /STATISTICS
Generates run-time statistical information.
Format
/STATISTICS
4.1 - Description
Use the /STATISTICS qualifier to generate a report that consists
of the page faults, buffered I/O, direct I/O, and CPU time used
in the execution of the ANALYZE/ERROR_LOG command.
4.2 - Example
$ ANALYZE/ERROR_LOG/STATISTICS ERRLOG.OLD;4
In this example, the output generated by this command consists
of a full report of all entries in ERRLOG.OLD;4 and the run-time
statistics for the execution of the command.
|
|
