Specifying symptoms

Table 1 shows the values for the KEY parameter of the VRADATA macro in relation to the MVS™ and RETAIN® keywords. The keys are mapped by VRAMAP (IHAVRA mapping macro).

The table also shows the keywords for the MVS and RETAIN symptoms and explains the meanings of the symptoms. The MVS symptoms are used to describe dumps. The RETAIN symptoms are used to describe problems and to search the RETAIN problem database. Finally, the Fm column identifies the form of the source data:
E
EBCDIC
F
Flag
H
Hexadecimal
Incorrect keys: The following keys are considered incorrect if used as a symptom: 
VRADAE   VRAMINSC   VRAOPT   VRASKP   VRAEND   VRAMINSL   VRAREQ
Table 1. VRADATA macro KEY values related to symptoms
Key Numbers KEY Value Keyword Source Data Explanation
MVS RETAIN Label Fm
DATA FROM FIXED AREAS OF SDWA MAIN STRUCTURE
X'3E9' EFABS AB/S AB/S SDWACMPC H ABEND CODE-SYSTEM. The system obtains this data for all dumps, if the data is available.
X'3EA' EFABU AB/U AB/U SDWACMPC H ABEND CODE-USER
X'3EB' EFLDMD MOD/ RIDS/ name#L SDWAMODN E LOAD MODULE NAME
X'3EC' EFCSCT CSECT/ RIDS/ SDWACSCT E ASSEMBLY MODULE CSECT NAME
X'3ED' EFREX REXN/ RIDS/ name#R SDWAREXN E RECOVERY ROUTINE CSECT NAME
X'3F3' EFPSW REGS/ REGS/ SDWAGRSV H REG/PSW DIFFERENCE. The system obtains this data for all dumps, if the data is available.

The system can generate two or less PSW/REGISTER differences as symptoms, depending on the number of registers found within the range of X'0'-X'FFF'. For a failing PSW address less than 512, the symptom generated is REGS/FE000.
FROM SDWARC1 - DATA FROM EXTENSIONS OF SDWA
X'44D' E1CID1C CID1/ VALU/C SDWACID E COMPONENT IDENTIFIER
X'44E' E1SUB1C SUB1/ VALU/C SDWASC E COMPONENT SUBFUNCTION
X'451' E1AMD1C AMD1/ VALU/C SDWAMDAT E MODULE ASSEMBLY DATE
X'452' E1VRS1C VRS1/ VALU/C SDWAMVRS E VERSION-PTF/PRODUCT IDENTIFIER
X'454' E1HRC1C HRC1/ PRCS/ SDWAHRC H ABEND REASON CODE. The system places the reason code in this field if the REASON keyword is used on the ABEND macro.
X'456' E1RRL1C RRL1/ FLDS/ SDWARRL E RECOVERY ROUTINE LABEL
X'45A' E1CDB1C CDB1/ VALU/C SDWACIDB E BASE COMPONENT ID
X'45C' E1CCR1C CCR1/ VALU/B SDWACCRC F REASON/COMPLETION CODE ALTERED. The system turns on this flag if the REASON keyword is used on the ABEND macro.
X'45E' E1HLH1C HLH1/ VALU/H SDWAHLHI H HIGHEST LOCK HELD INDICATOR. The current lock held.
X'460' E1SUP1C SUP1/ VALU/H SDWASUPR H PSASUPER FLAGS
X'464' E1SPN1C SPN1/ VALU/H SDWASPN H LCCASPIN FLAGS
X'466' E1FI1C FI/ VALU/H SDWAFAIN H FAILING INSTRUCTION AREA
X'468' E1FRR1C FRR1/ VALU/H SDWAFRRE H FRR PARAMETER AREA. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'46A' E1ASID1C ASID1/ VALU/H SDWAASI1 H TASK RELATED ASID
X'46C' E1ORCC1C ORCC1/ PRCS/ SDWAOCMP H ORIGINAL COMPLETION CODE
X'46E' E1ORRC1C ORRC1/ PRCS/ SDWAOCRC H ORIGINAL REASON CODE
X'470' E1PIDSIC PIDS/ PIDS/ SDWACID E PRODUCT/COMPONENT ID
FROM SDWARC2 EXTENSION OF SDWA
X'483' E2MCIC MCI2/ VALU/H SDWAMCIC H MACHINE CHECK INTERRUPT CODE
FROM ABDUMP SYMPTOM AREA PRDHDR (See the AMDDATA macro.)
X'3E9' EFABS AB/S AB/S PRDSMABD H ABEND CODE-SYSTEM. The system obtains this data for all dumps, if the data is available.
X'3EA' EFABU AB/U AB/U PRDSMABD H ABEND CODE-USER
X'3EB' EFLDMD MOD/ RIDS/ name#L PRDSMLMN E LOAD MODULE NAME
X'3EC' E1FI1C FI/ VALU/H PRDSMPDA H FAILING INSTRUCTION AREA. The system obtains this data for all dumps, if the data is available.

The failing instruction area is the 12 bytes around the failing instruction, which is pointed to by the failing PSW.
X'3ED' E1HRC1C HRC1/ VALU/H PRDSMGPR H REASON CODE
X'3F3' EFPSW REGS/ REGS/ PRDSMPSW H REG/PSW DIFFERENCE. The system obtains this data for all dumps, if the data is available.

The system can generate two or less PSW/REGISTER differences as symptoms, depending on the number of registers found within the range of X'0'-X'FFF'. For a failing PSW address that is less than 512, the symptom generated is REGS/FE000.
FROM SDWAVRA - CREATED IN VRADATA MACRO FORMAT
X'01' VRACOM VCID/ VALU/C   E COMPONENT IDENTIFIER
X'02' VRASC VSC/ VALU/C   E SUBCOMPONENT IDENTIFIER
X'03' VRALVL VLVL/ VALU/C   E COMPONENT LEVEL
X'04' VRADT VDT/ VALU/C   E MODULE ASSEMBLY DATE
X'05' VRAPTF VPTF/ PTFS/   E MODULE/PRODUCT PTF IDENTIFIER
X'06' VRARC VARC/ PRCS/   E ABEND REASON CODE or REASON CODE
X'07' VRAQVOD VQVOD/ VALU/H   H QUEUE VERIFIER DATA. Defined by the IHAQVOD macro.
X'08' VRAQERR VQERR/ VALU/H   H QUEUE ERROR DATA
X'09' VRALVLS VLVLS/ LVLS/   E RELEASE or LEVEL. The release of the system or level of the program product or component on which the problem occurred.
X'10' VRARRP VRRP/ VALU/H   H RECOVERY ROUTINE PARAMETER
X'11' VRACBM VCBM/ FLDS/   E MAPPING MACRO NAME
X'12' VRACB VCB/ VALU/H   H CONTROL BLOCK DATA. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'13' VRACBF VCBF/ FLDS/   E CONTROL BLOCK FIELD NAME
X'14' VRACBA VCBA/ ADRS/   H CONTROL BLOCK ADDRESS
X'15' VRACBO VCBO/ ADRS/   H CONTROL BLOCK FIELD OFFSET
FROM SDWAVRA - CREATED IN VRADATA MACRO FORMAT
X'16' VRACBL VCBL/ VALU/H   H CONTROL BLOCK LENGTH
X'18' VRACBI VCBI/ VALU/H   H CONTROL BLOCK ID NUMBER
X'19' VRACBIA VCBIA/ VALU/H   H CONTROL BLOCK ID AND ADDRESS
X'1A' VRACBI2 VCBI2/ VALU/H   H CONTROL BLOCK ID AND DATA
X'20' VRAPLI VPLI/ FLDS/   E PARAMETER LIST ID. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'21' VRAPL VPL/ VALU/H   H PARAMETER LIST DATA. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'22' VRAFPI VFPI/ PCSS/   E FOOTPRINT IDENTIFIER. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'23' VRAFP VFP/ VALU/H   H FOOTPRINT DATA. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'24' VRAPA VPA/ VALU/C   E EXECUTION PATH DATA. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'25' VRAP2 VP2/ VALU/C   E EXECUTION PATH DATA. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'26' VRALK VLK/ FLDS/   E NAME OF LOCK HELD. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'27' VRAWAI VWAI/ PCSS/   E WORK AREA ID. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'28' VRAWA VWA/ VALU/H   H WORK AREA DATA. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'29' VRAWAP VWAP/ ADRS/   H WORK AREA ADDRESS
X'30' VRALBL VLBL/ FLDS/   E LABEL RELATED TO FAILURE
X'31' VRARRL VRRL/ FLDS/   E RECOVERY ROUTINE LABEL
X'33' VRAMID VMID/ MSG/   E MESSAGE IDENTIFIER
X'34' VRAMSG VMSG/ MSG/   E MESSAGE TEXT. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'35' VRAERR VERR/ VALU/C   E ERROR INFORMATION. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'36' VRAEHX VEXH/ VALU/H   H ERROR INFORMATION. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'37' VRAHID VHID/ PCSS/   E HEADER FOR DATA. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'38' VRAHEX VHEX/ VALU/H   H HEX ERROR DATA. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'39' VRAEBC VEBC/ VALU/C   E ERROR DATA. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'3A' VRAAID VAID/ VALU/H   H CALLER'S ASID
X'3B' VRATCB VTCB/ ADRS/   H TCB ADDRESS
X'3C' VRACA VCA/ ADRS/   H CALLER'S ADDRESS
X'3D' VRACAN VCAN/ RIDS/   E MODULE NAME OF CALLER
X'40' VRAOA VOA/ PRCS/   H ORIGINAL ABEND CODE
X'41' VRAPSW VPSW/ VALU/H   H RELATED FAILING PSW
X'42' VRAINS VINS/ VALU/H   H FAILING INSTRUCTION AREA. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'43' VRAREGS VREGS/ VALU/H   H REGISTERS ASSOCIATED WITH ABEND. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'44' VRAREGA VREGA/ ADRS/   H REGISTER AREA ADDRESS
X'45' VRAOR15 VOR15/ PRCS/   H ORIGINAL CONTENTS OF REGISTER
X'46' VRADSN VDSN/ PCSS/   E DATA SET NAME. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'47' VRADEV VDEV/ PCSS/   E DEVICE NAME. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'48' VRASN VSN/ VALU/H   H I/O SENSE DATA. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'49' VRAST VST/ VALU/H   H I/O STATUS. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'4A' VRAU VU/ VALU/C   H DEVICE NUMBER OR NAME. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'4B' VRACCW VCCW/ VALU/H   H CCW
X'4C' VRACSW VCSW/ VALU/H   H CSW
X'4D' VRADVT VDVT/ VALU/H   H DEVICE TYPE. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'4E' VRAVOL VVOL/ VALU/C   E VOLUME SERIAL NUMBER. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'60' VRAFREG VFREG/ VALU/H   H FIRST REGISTER IN SAVE AREA. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'63' VRACSCB VSCB/ VALU/H   H CSCB CONTROL BLOCK. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'64' VRACSCBA VSCBA/ ADRS/   H CSCB CONTROL BLOCK ADDRESS
X'65' VRAJOB VJOB/ PCSS/   E FAILING JOB NAME
X'66' VRASTP VSTP/ PCSS/   E FAILING STEP NAME
X'67' VRACMD VCMD/ PCSS/   E FAILING COMMAND. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'68' VRAJCL VJCL/ PCSS/   E JCL STATEMENT. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'73' VRAEPN VEPN/ RIDS/   E ENTRY POINT NAME
X'77' VRAETF VETF/ ADRS/   H ENTRY POINT ADDRESS
X'78' VRACTF VCTF/ ADRS/   H FAILING CSECT ADDRESS
X'79' VRALTF VLTF/ ADRS/   H FAILING LOAD MODULE ADDRESS
X'7A' VRAMO VMO/ ADRS/   H CSECT OFFSET IN LOAD MODULE
X'7B' VRAILO VILO/ ADRS/   H OFFSET IN LOAD MODULE
X'7C' VRAIMO VIMO/ ADRS/   H OFFSET IN ASSEMBLY MODULE
X'7D' VRAFID VFID/ PCSS/   E FEATURE IDENTIFIER. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'7E' VRAPID VPID/ PCSS/   E PRODUCT IDENTIFIER. If the original data in the SDWAVRA is in printable form, the system uses all the characters possible for symptoms. The total size, including the keyword and data, cannot exceed 50 characters for an MVS symptom or 15 characters for a RETAIN symptom.
X'A0' VRAIAP VIAP/ RIDS/   E ANALYTIC PROCEDURE NAME
X'A1' VRAIAL VIAL/ VALU/H   H PARAMETER LIST FOR PROCEDURE. The system converts the first 12 bytes to printable hexadecimal for MVS symptoms. It converts only the last 4 bytes of these 12 bytes to printable hexadecimal for RETAIN symptoms.
X'A2' VRAICL VICL/ VALU/H   H PARAMETER LIST FOR PROGRAM
X'A3' VRAIDP VIDP/ RIDS/   E PROGRAM TO RUN

X'C8'
X'C9'
X'CA'
X'CB'
X'CC'
X'CD'
X'CE'
X'CF'
X'D0'
X'D1'
X'D2'
X'D3'
X'D4'
X'D5'
X'D6'
X'D7'
X'D8'
X'D9'
X'DA'
X'DB'
X'DC'
X'DD'
X'DE'
X'DF'
X'E0'
X'E1'
X'E2'
X'E3'
X'E4'
X'E5'
X'E6'
X'E7'
X'E8'
X'E9'
X'EA'
X'EB'
X'EC'
X'ED'
X'EE'
X'EF'

VRARRK
VRARRK1
VRARRK2
VRARRK3
VRARRK4
VRARRK5
VRARRK6
VRARRK7
VRARRK8
VRARRK9
VRARRK10
VRARRK11
VRARRK12
VRARRK13
VRARRK14
VRARRK15
VRARRK16
VRARRK17
VRARRK18
VRARRK19
VRARRK20
VRARRK21
VRARRK22
VRARRK23
VRARRK24
VRARRK25
VRARRK26
VRARRK27
VRARRK28
VRARRK29
VRARRK30
VRARRK31
VRARRK32
VRARRK33
VRARRK34
VRARRK35
VRARRK36
VRARRK37
VRARRK38
VRARRK39

@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/
@nnn/

VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/C
VALU/H
VALU/H
VALU/H
VALU/H
VALU/H
VALU/H
VALU/H
VALU/H
VALU/H
VALU/H
VALU/B
VALU/B
VALU/B
VALU/B
VALU/B

  

E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
E
H
H
H
H
H
H
H
H
H
H
F
F
F
F
F

 DEVELOPER ASSIGNED SYMPTOM KEYS. A program assigns one of these symptom keys. The IHAVRA macro defines decimal keys 200 to 239 as assignable to any symptom desired by the programmer. The IHAVRA macro assigns all other keys. If programmer-assigned keys are used, a visible key, such as @204 for decimal key 204, is created by the system. The decimal keys are appropriate for the following forms of data:
Keys 200-224
EBCDIC data
Keys 225-234
Hexadecimal data
Keys 235-239
Flag data
Parent topic: System Reference