Hardware error records

When an error occurs during an attempt to access either a library or drive, data is gathered to determine recovery from the error. When the error recovery procedures are invoked, an outboard recording record (OBR) is built and written to SYS1.LOGREC. To print these records, use the EREP service aid.

Tables Table 1, Table 2, and Table 3 provide mapping of the OBR.

The mapping of the 3995 library long OBR follows.

Table 1. 3995 Library Long OBR Format
Offset Dec(Hex)	Name	Length	Description
0(X'0')	OBRKEY	1	OBR record type, set to X'30'.
1(X'1')	OBRKEY2	1	System release level, set to X'83'.
2(X'2')	OBRSMS	1	Record independent switches.
3(X'3')	OBRSW2	1	Record dependent switches.
4(X'4')	OBRXASW	1	370/XA mode record switch.
4(X'4')		1... ....	CHPID is valid.
5(X'5')	OBRSCID	1	Channel set ID, set to zeros.
6(X'6')	OBRRCDCT	1	Record count.
7(X'7')		1	Reserved.
8(X'8')	OBRDT	8	System date and time.
8(X'8')	OBRDATE	4	System date of failure.
12(X'C')	OBRTIME	4	System time of failure.
16(X'10')	OBRCPUID	8	CPU identification.
24(X'18')	OBRJOBID	8	Job name or user ID.
32(X'20')	OBRFCCW	8	Failing CCW, set to zeros.
40(X'28')	OBRCSW	8	Channel status word, set to zeros.
48(X'30')	OBRDEVDC	1	Number of doublewords of device-dependent data, set to X'23'.
49(X'31')	OBRSECUA	3	Secondary control unit address, set to zeros.
52(X'34')	OBRCODE	4	Set device type X'08002182'.
56(X'38')	OBRLSDRC	1	Statistical data amount set to 0.
57(X'39')	OBRPCUA	3	Device number of CTC adapter.
60(X'3C')	OBRRETRY	2	Number of retries attempted, set to 0.
62(X'3E')	OBRSBCNT	2	Number of sense bytes, set to X'0020'.
64(X'40')	OBRDEVDP	280	Device-dependent data.
64(X'40')	OBRNAME	8	Library name.
72(X'48')	OBRSER	8	Library serial number.
80(X'50')	OBRFORDR	260	Failing command.
340(X'154')		4	Reserved.
344(X'158')	OBRDSN	32	Device-dependent sense data.
344(X'158')	OBRTRBRC	2	Task request block return code.
346(X'15A')	OBRFSC	2	Fault symptom code.
348(X'15C')	OBRDEVSN	28	Device sense.

The mapping of the 3995 drive long OBR follows.

Table 2. 3995 Optical Disk Drive Long OBR
Offset Dec(Hex)	Name	Length	Description
0(X'0')	OBRKEY	1	OBR record type, set to X'30'.
1(X'1')	OBRKEY2	1	System release level, set to X'83'.
2(X'2')	OBRSMS	1	Record independent switches.
3(X'3')	OBRSW2	1	Record dependent switches.
4(X'4')	OBRXASW	1	370/XA mode record switch.
4(X'4')		1... ....	CHPID is valid.
5(X'5')	OBRSCID	1	Channel set ID, set to zeros.
6(X'6')	OBRRCDCT	1	Record count.
7(X'7')		1	Reserved.
8(X'8')	OBRDT	8	System date and time.
8(X'8')	OBRDATE	4	System date of failure.
12(X'C')	OBRTIME	4	System time of failure.
16(X'10')	OBRCPUID	8	CPU identification.
24(X'18')	OBRJOBID	8	Job name or user ID.
32(X'20')	OBRFCCW	8	Failing CCW, set to zeros.
40(X'28')	OBRCSW	8	Channel status word, set to zeros.
48(X'30')	OBRDEVDC	1	Number of doublewords of device-dependent data, set to X'23'.
49(X'31')	OBRSECUA	3	Secondary control unit address, set to zeros.
52(X'34')	OBRCODE	4	Set device type X'08002183'.
56(X'38')	OBRLSDRC	1	Statistical data amount set to 0.
57(X'39')	OBRPCUA	3	Device number of CTC adapter.
60(X'3C')	OBRRETRY	2	Number of retries attempted, set to 0.
62(X'3E')	OBRSBCNT	2	Number of sense bytes, set to X'0020'.
64(X'40')	OBRDEVDP	280	Device-dependent data.
64(X'40')	OBRNAME	8	Drive name.
72(X'48')	OBRSER	6	Volume serial number of mounted volume.
78(X'4E')		2	Reserved.
80(X'50')	OBRFORDR	260	Failing command.
340(X'154')		4	Reserved.
344(X'158')	OBRDSN	32	Device-dependent sense data.
344(X'158')	OBRTRBRC	2	Task request block return code.
346(X'15A')	OBRFSC	2	Fault symptom code.
348(X'15C')	OBRDEVSN	28	Device sense.

Refer to the IBM® 3995 Optical Library: Maintenance Information Manual for an example of a formatted 3995 OBR record.

The mapping for the 3995 library miscellaneous data record (MDR) follows.

Table 3. 3995 Library MDR
Offset Dec(Hex)	Name	Length	Description
0(X'0')	MDRCLSRC	1	MDR type, set to X'91'.
1(X'1')	MDRSYREL	1	System release level, set to X'83'.
2(X'2')	MDRSWTCH	1	Record switches.
3(X'3')		1	Reserved.
4(X'4')	MDRDEVTP	1	Device type, set to X'50'.
5(X'5')		1	Reserved.
6(X'6')	MDRRCDCT	1	Record count.
7(X'7')	MDRCHPID	1	Channel path identifier.
8(X'8')	MDRDT	8	System date and time.
8(X'8')	MDRDATE	4	System date of receipt.
12(X'C')	MDRTIME	4	System time of receipt.
16(X'10')	MDRMVERN	1	Machine version number.
17(X'11')	MDRCPUSR	3	CPU serial number.
20(X'14')	MDRCPMOD	2	CPU machine model number.
22(X'16')		2	Reserved.
24(X'18')	MDRDEVAD	2	Device address of data identified in record.
26(X'1A')	MDRDEVDP	282	Device-dependent information.
26(X'1A')	MDRVOL	6	Volume serial number. The volume serial number that is demounted from an optical drive.
32(X'20')	MDRDRVNM	8	Drive name.
40(X'28')	MDRLIBNM	8	Library name.
48(X'30')	MDRLIBSN	8	Library serial number.
56(X'38')	MDRBOXID	2	The box in the configuration that the buffer log data belongs to.
58(X'3A')	MDROWNER	64	Owner information. A 64-byte data area for owner information or comments.
122(X'7A')	MDRSTAMP	4	Time stamp at demount. The time when the cartridge is demounted from the drive. The time stamp is a 4-byte sequential number of the seconds since January 1, 1980.
126(X'7E')	MDRTWRT	4	Number of temporary write errors. The number is increased by 1 whenever the SCSI sense key reports a recovered error and the additional sense code is write error.
130(X'82')	MDRPWRT	4	Number of permanent write errors. The number is increased by 1 whenever the SCSI sense key reports a medium error and the additional sense code is write error.
134(X'86')	MDRKBWRT	4	Estimated number of kilobytes written. This is an estimated number of data written on the cartridge. The unit is kilobytes, which is equal to 1024 bytes.
138(X'8A')	MDRTRD	4	Number of temporary read errors. The number is increased by 1 whenever the SCSI sense key reports a recovered error and the additional sense code is read error.
142(X'8E')	MDRPRD	4	Number of permanent read errors. The number is increased by 1 whenever the SCSI sense key reports a medium error and the additional sense code is read error.
146(X'92')	MDRKBRD	4	Estimated number of kilobytes read. This is an estimated number of data read from the cartridge. The unit is kilobytes, which is equal to 1024 bytes.
150(X'96')	MDRTSK	4	Number of temporary seek errors. The number is increased by 1 whenever the SCSI sense key reports a recovered error and the additional sense code is seek positioning error.
154(X'9A')	MDRPSK	4	Number of permanent seek errors. The number is increased by 1 whenever the SCSI sense key reports a medium error and the additional sense code is no-seek-complete.
158(X'9E')	MDRTLD	4	Number of temporary load errors. The number is increased by 1 whenever the autochanger reports a recovered error and the hardware error code is drive access error.
162(X'A2')	MDRPLD	4	Number of permanent load errors. The number is increased by 1 whenever the autochanger reports a hardware error and the hardware error code is drive access error.
166(X'A6')	MDRDRVNO	1	Drive number. This is the number of the drive on which the volume is mounted.
167(X'A7')	MDRKBERS	4	Estimated number of kilobytes erased. This is an estimated number of data erased from the cartridge. The unit is kilobytes, which is equal to 1024 bytes.
171(X'AB')	MDRUSED	4	Percent used of spare sectors. This is the percentage of spare sectors that have been used.
175(X'AF')	MDRFREE	4	Total number of spare sectors. This is the total number of spare sectors initially available when the cartridge was first formatted.
179(X'B3')	MDRMFLGS	4	Media type flags.
183(X'B7')	MDRMFLGS	125	Reserved for future use.

See EREP User's Guide and EREP Reference for an example of a formatted 3995 MDR.