Symptom record

When a module detects a programming failure, it constructs a symptom record containing a description of the failure.

A symptom record contains structured data base (SDB) symptom strings. Symptom strings are valuable problem determination aids. Symptom strings can be used by installations and the IBM® Support Center to search for matching problems in a problem reporting data base.

The record is processed by two macros:

The ADSR macro, which maps the record.
SYMREC allows authorized programs to write records to the logrec data set. Unauthorized programs are allowed to write to the logrec data set only if an installation provided user exit has been installed.
For more information on how to write an exit routine, see z/OS MVS Installation Exits.

Table 1. Format of the symptom record (section 1)
Offset		Size (bytes) alignment (bits)	Field name	Description
Dec	Hex	Size (bytes) alignment (bits)	Field name	Description
0	(0)	1	HDRTYP	Class/Source:
		.1.. 11..		Symptom record; type=X'4C'.
1	(1)	1	HDROPRN	System/Release level:
		100. ....		OS/VS2.
		bits 3-7
		0-1F		Release level 0-31.
2	(2)	1	HDRIS	Record-independent switches:
		x... ....		Reserved.
		.1.. ....		Time-of-day (TOD) clock instruction issued. Used in conjunction with date and time values at displacement 8.
		..1. ....		Record truncated. (When EREP detects this bit being on, it does not
				edit record but prints it out in hexadecimal.)
		...1 ....		Record created by MVS/SP Version 2 or 3.
		.... 1...		TIME macro used.
		.... .xxx		Reserved.
3	(3)	3	HDRDS	Record-dependent switches:
		Byte 0
		x... ....		Reserved.
		.1.. ....		Record incomplete. (Record truncated because of lack of buffer
				space.)
		...x xxxx		Reserved.
		Byte 1		Reserved.
		Byte 2		Reserved.
6	(6)	1	HDRCNT	Not used for symptom record.
7	(7)	1		Reserved.
8	(8)	8	HDRTM	Time-of-day clock.
16	(10)	1	HDRCPID	Machine version code.
17	(11)	3		Central processor serial number.
20	(14)	2		Central processor machine model number.
22	(16)	2		Reserved.

				END OF STANDARD HEADER

24	(18)	2	ADSRID	‘SR’ symptom record id.
26	(1A)	4	ADSRCPM	Central processor model number.
30	(1E)	6	ADSRCPS	Central processor serial number.
36	(24)	4	ADSRGMT	Local time zone conversion factor.
40	(28)	4	ADSRTIME	Time stamp.
44	(2C)	8	ADSRTOD	Time stamp (HHMMSSTH).
52	(34)	6	ADSRDATE	Date (YYMMDD).
58	(3A)	8	ADSRSID	Customer assigned system/node name.
66	(42)	4	ADSRSYS	Product ID of BCP
70	(46)	8	ADSRCML	Feature and level of SYMREC macro.
78	(4E)	1	ADSRFL1	Record status flags.
		1... ....		Reserved.
		.1.. ....	ADSRTRNC	Symptom record was truncated.
		..1. ....	ADSRPMOD	The section 3 symptom string has been modified.
		...1 ....	ADSRSGEN	No record from component.
		.... 1...	ADSRSMOD	The section 4 symptom string has been modified.
		.... .111		Reserved.
79	(4F)	1	ADSRFL2	Record status flags.
		1... ....	ADSRNOTD	ADSRTOD and ADSRDATE have not been computed.
		.1.. ....	ADSRASYN	Record was created asynchronously from the error.
		..11 1111		Reserved.
80	(50)	8	ADSRDTP	Type of dump taken for this event.

Table 2. Format of the symptom record (section 2)
Offset		Size (bytes) alignment (bits)	field Name	Description
Dec	Hex	Size (bytes) alignment (bits)	field Name	Description
88	(58)	2	ADSRARID	Architectural level of the symptom record.
90	(5A)	2	ADSRL	Length of section 2.
92	(5C)	2	ADSRCSL	Length of section 2.1 (ADSRCMPS).
94	(5E)	2	ADSRCSO	Offset of section 2.1 (ADSRCMPS).
96	(60)	2	ADSRDBL	Length of section 3 (ADSRDBST).
98	(62)	2	ADSRDBO	Offset of section 3 (ADSRDBST).
100	(64)	2	ADSRROSL	Length of section 4 (ADSRROSD).
102	(66)	2	ADSRROSA	Offset of section 4 (ADSRROSD).
104	(68)	2	ADSRRONL	Length of section 5 (ADSR5ST).
106	(6A)	2	ADSRRONA	Offset of section 5 (ADSR5ST).
108	(6C)	2	ADSRRISL	Reserved.
110	(6E)	2	ADSRRISA	Reserved.
112	(70)	8	ADSRSRES	System data.
120	(78)	16		Reserved.

Table 3. Format of the symptom record (at offset ADSRCSO in ADSR) (section 2.1)
Offset		Size (bytes) alignment (bits)	Field name	Description
Dec	Hex	Size (bytes) alignment (bits)	Field name	Description
0	(0)	100	ADSRCMPS
0	(0)	4	ADSRC	Identifier for section 2.1.
4	(4)	2	ADSRCRL	Architectural level of the symptom record.
6	(6)	9	ADSRCID	Component identifier.
15	(F)	1	ADSRFLC	Component status flags.
		1... ....	ADSRNIBM	Non-IBM program.
		.111 1111		Reserved.
16	(10)	4	ADSRLVL	Component level.
20	(14)	8	ADSRPTF	PTF level.
28	(1C)	8	ADSRPID	PID level.
36	(24)	8	ADSRPIDL	PID release level.
44	(2C)	32	ADSRCDSC	Text description.
76	(4C)	4	ADSRRET	Return code.
80	(50)	4	ADSRREA	Reason code.
84	(54)	8	ADSRPRID	Problem identifier.
92	(5C)	8	ADSRSSID	Subsystem identifier.

Table 4. Format of the Symptom Record (at offset ADSRDBO in ADSR) (section 3)
Offset	Size (bytes) alignment (bits)	Field name	Description
Dec Hex	Size (bytes) alignment (bits)	Field name	Description
ADSRDBO	variable	ADSRDBST	Primary symptom string.

Table 5. Format of the symptom record (at offset ADSRROSA in ADSR) (section 4)
Offset	Size (bytes) alignment (bits)	Field name	Description
Dec Hex	Size (bytes) alignment (bits)	Field name	Description
ADSRROSA	variable	ADSRROSD	Secondary symptom string.

Table 6. Format of the symptom Record (at offset ADSRRONA in ADSR) (section 5)
Offset	Size (bytes) alignment (bits)	Field name	Description
Dec Hex	Size (bytes) alignment (bits)	Field name	Description
ADSRRONA	variable	ADSR5ST	Free format data.