The system creates records for every hardware or software failure
and system condition that occurs and stores these records in the logrec
data set or the logrec log stream. The records can contain two types
of data that document failures and system conditions:
- Error statistics, which include the number of times that
channels, machine models, and I/O devices have failed
- Environmental data, which include time and circumstances
for each failure or system condition
Note: A programmer can also build symptom records using the SYMRBLD
macro and have those records written into the logrec data set or the
logrec log stream using the SYMREC macro.
See z/OS MVS Programming: Assembler Services Reference IAR-XCT
for information about the macros.
Each record is recorded in hexadecimal format as an undefined length
record. Each record provides:
- Relevant system information at the time of the failure
- Device hardware status at the time of the failure
- Results of any device/control unit recovery attempt
- Results of any software system recovery attempt
- Statistical data
When taken as a whole, these records create a history of the system,
which begins early in system initialization and ends when the system
stops. These records contain:
- Full Abend History: The system writes a logrec record
for every abend, regardless of whether the dump is requested or suppressed.
The logrec data set or the logrec log stream contains a full record
of abnormal ends.
- System Initialization Errors: The system writes errors
during system initialization, before other diagnostic services are
completely functioning.
- Lost Record Counts: The system writes a logrec record
to summarize lost error records. Sometimes hardware-detected or software-detected
errors occur close together. When errors are too close together,
the system cannot write an individual record for each error; instead,
the system counts the errors and writes a summary record.
These sections describe what is in the logrec data set:
This section describes what is in the logrec data set or the logrec
log stream:
See z/OS MVS Diagnosis: Reference for
the format of the header record, time stamp record, and logrec error
records.