Link maintenance information (LMI) record

The LMI record provides detailed device/CPC node information that is gathered for a particular link incident. An LMI record describes link-degraded and link-failure incidents.

Table 1. Format of the LMI record
Offset		Size (bytes) Alignment (bits)	Field Name	Description
Dec	Hex	Size (bytes) Alignment (bits)	Field Name	Description
0	(0)	1	A2KEY1	Class/Source:
		1010 0010		Link maintenance information (LMI) record; type = X'A2'.
1	(1)	1	A2KEY2	System/release level:
		100. ....		OS/VS2 and later MVS™ systems.
		.... xxxx		Release level (0-1F).
2	(2)	1	A2SMS	Record-independent switches:
		1... ....		More records follow.
		0... ....		Last record.
		.x.. ....		Time-of-Day (TOD) clock instruction issued.
		.0.. ....		IBM® System/360
		.1.. ....		IBM System/370
		..1. ....		Record truncated.
		...1 ....		370 XA mode record.
		.... 1...		TIME macro used.
		.... .xxx		Reserved.
3	(3)	3		Record-dependent switches:
			A2SW1	Reserved.
			A2SW2	Reserved.
			A2SW3	Reserved.
6	(6)	1	A2RCDCT	Record count:
		xxxx ....		Sequence number of this physical record.
		.... xxxx		Total number of physical records in this logical record.
7	(7)	1		Reserved.
8	(8)	8	A2DT	System date and time of incident:
8	(8)	4	A2DATE	System date of failure.
12	(C)	4	A2TIME	System time of failure.
16	(10)	8	A2CPUID	CPU identification.
16	(10)	1	A2VER	Machine version code:
		xxxx xxx.		Reserved.
		.... ...0		Version I CPUs.
		.... ...1		Version II CPUs.
17	(11)	3	A2SER	CPU serial number.
20	(14)	2	A2MOD	CPU machine model number
22	(16)	2	A2CEL	Reserved.
				END OF STANDARD HEADER
24	(18)	1	A2INQUAL	Incident qualifiers.
		1... ....		Null.
		.1.. ....		Resend. Report or record has already been sent to a channel.
		..1. ....		Dynamic connectivity control element. Incident node is a dynamic switch port.
		...1 ....		Dedicated connection; static connection state.
		.... xx..		Reporting class.
		.... 00..		Information report.
		.... 01..		Link degraded but operational.
		.... 10..		Link not operational.
		.... 11..		Reserved.
		.... ..xx		Reserved.
25	(19)	1	A2INCODE	Incident code.
		x... ....		Primary/Secondary report.
		0... ....		Primary report.
		1... ....		Secondary report.
		.xxx xxxx		Incident code type (IC). X'07'- X'7F' reserved.
		x000 0001		Implicit incident.
		x000 0010		Bit error rate threshold exceeded.
		x000 0011		Link failure, loss of signal or synchronization.
		x000 0100		Link failure, nonoperational sequence recognized.
		x000 0101		Link failure, sequence timeout.
		x000 0110		Link failure, illegal sequence for link-level facility state.
26	(1A)	2	A2DEDCIF	Statically Connected Switch Interface (SCSI).
28	(1C)	32	A2INODES	INCIDENT Node Descriptor.
		Byte 0		Incident flags.
		xxx. ....		Incident node-ID validity. X'3' - X'7' reserved.
		000. ....		Valid node ID.
		001. ....		Valid node ID which may not be current.
		010. ....		Invalid node ID; bytes 1-31 are not valid.
		...x ....		Incident Node Type:
		...0 ....		Device node
		...1 ....		CPC node
		.... xxxx		Reserved.
		Bytes 1-3	A2NODPAR	DEVICE Node Parameters if byte 0 bit 3 = 0.
		Byte 1		Reserved, X'00'.
		Byte 2		Class:
		0000 0000		Unspecified Class
		0000 0001		Direct Access Storage (DASD)
		0000 0010		Magnetic Tape
		0000 0011		Unit Record (input)
		0000 0100		Unit Record (output)
		0000 0101		Printer
		0000 0110		Communications Controller
		0000 0111		Terminal (full screen)
		0000 1000		Terminal (line mode)
		0000 1001		Stand-alone Channel-to-Channel (CTC)
		0000 1010		Switch
		xxxx xxxx		Reserved (11 - 255)
		Byte 3		Reserved, X'00'.
		Bytes 1-3	A2NODPAR	CPCNode Parameters if byte 0 bit 3 = 1.
		Byte 1		Reserved, X'00'.
		Byte 2		Interface Class:
		0000 0000		Unspecified Class
		0000 0001		ESA/370 channel
		0000 0010		Integrated channel-to-channel adapter (CTCA)
		xxxx xxxx		Reserved (3 - 255)
		Byte 3		Identification:
		xxxx xxxx		CHPID.
		Bytes 4-9	A2ITYPE	Incident type number EBCDIC decimal value right justified.
		Bytes 10-12	A2IMOD	Incident model number EBCDIC alphameric right justified.
		Bytes 13-15	A2IMEG	Incident manufacturer EBCDIC alphameric right justified.
		Bytes 16-17	A2IPMFG	Incident plant of manufacture EBCDIC alphameric right. justified.
		Bytes 18-29	A2ISEQ	Incident sequence number EBCDIC alphameric right. justified.
		Bytes 30-31	A2IID	Incident hexadecimal interface ID.
60	(3C)	32	A2ANODES	ATTACHED Node Descriptor.
		Byte 0		Incident flags.
		xxx. ....		Attached node-ID validity. X'3' - X'7' reserved.
		000. ....		Valid node ID.
		001. ....		Valid node ID which may not be current.
		010. ....		Invalid node ID; bytes 1-31 are not valid.
		...x ....		Attached Node Type:
		...0 ....		Device node
		...1 ....		CPCnode
		.... xxxx		Reserved.
		Bytes 1-3	A2NOPARM	DEVICE Node Parameters if byte 0 bit 3 = 0.
		Byte 1		Reserved, X'00'.
		Byte 2		Class:
		0000 0000		Unspecified Class
		0000 0001		Direct Access Storage (DASD)
		0000 0010		Magnetic Tape
		0000 0011		Unit Record (input)
		0000 0100		Unit Record (output)
		0000 0101		Printer
		0000 0110		Communications Controller
		0000 0111		Terminal (full screen)
		0000 1000		Terminal (line mode)
		0000 1001		Stand-alone Channel-to-Channel (CTC)
		0000 1010		Switch
		xxxx xxxx		Reserved (11 - 255)
		Byte 3		Reserved, X'00'.
		Bytes 1-3	A2NOPARM	CPCNode Parameters if byte 0 bit 3 = 1.
		Byte 1		Reserved, X'00'.
		Byte 2		Interface Class:
		0000 0000		Unspecified Class
		0000 0001		ESA/370 channel
		0000 0010		Integrated channel-to-channel adapter (CTCA)
		xxxx xxxx		Reserved (3 - 255)
		Byte 3		Identification:
		xxxx xxxx		CHPID.
		Bytes 4-9	A2ATYPE	Attached type number EBCDIC decimal value right justified.
		Bytes 10-12	A2AMOD	Attached model number EBCDIC alphameric right justified.
		Bytes 13-15	A2AMFG	Attached manufacturer EBCDIC alphameric right justified.
		Bytes 16-17	A2APMFG	Attached plant of manufacture EBCDIC alphameric right justified.
		Bytes 18-29	A2ASEQ	Attached sequence number EBCDIC alphameric right justified.
		Bytes 30-31	A2AIID	Attached hexadecimal interface ID.
92	(5C)	36	A2INDEP	Incident node-dependent information.