z/OS problem management
Previous topic | Next topic | Contents | Glossary | Contact z/OS | PDF


Steps for obtaining the abend code

z/OS problem management

You need to know how to access the following:
  • SVC dump, SYSMDUMP, and transaction dump
  • Software record in SYS1.LOGREC from the time frame of the error.
If an SVC dump was taken for the error as indicated by IEA794I, IEA611I or IEE911E, use the following IPCS commands to format information and extract the abend and reason code (when available).
  • IPCS STATUS FAILDATA

    For the abend code, look for AB/S0hhh in the symptoms under the heading SEARCH ARGUMENT ABSTRACT, if present. For the reason code, look for PRCS/hhhhhhhh in the symptoms, or look in the register indicated in the abend code explanation.

    Not every dump has error information associated with it. Some dumps, like those requested through the SLIP or DUMP command will not have STATUS FAILDATA output. There are occasions when STATUS FAILDATA will not provide the information you need. Check SYSTRACE and SUMMARY FORMAT (look for RTM2WA SUMMARY) for the abend. If you cannot find it, the dump was probably not requested for an abend. Check the dump title (L Title) and determine why it was not requested. Also, check SYS1.LOGREC, and the SYSLOG and job log for the time frame of the dump.

    In the following example, fields AB/S005C and PRCS/00000214 indicate what to extract for the abend and reason code. The free-format search argument is: ABEND05C and RSN00000214.
    * * * DIAGNOSTIC DATA REPORT * * * 
    
    
    SEARCH ARGUMENT ABSTRACT 
    
    RIDS/IEFW21SD#L RIDS/#UNKNOWN AB/S005C PRCS/00000214 REGS/0E01E REGS/0C6D8
    
    Symptom 							Description 
    ------- 							----------- 
    RIDS/IEFW21SD#L 			Load module name: IEFW21SD 
    RIDS/#UNKNOWN 				Csect name: #UNKNOWN 
    AB/S005C 							System abend code: 005C
    PRCS/00000214 				Abend reason code: 00000214 
    REGS/0E01E 						Register/PSW difference for R0E: 01E 
    REGS/0C6D8 						Register/PSW difference for R0C: 6D8 
    
    SERVICEABILITY INFORMATION NOT PROVIDED BY THE RECOVERY ROUTINE 
    
    Program id 
    Recovery routine csect name 
    Recovery Routine Label 
    Date Assembled 
    Module Level 
    Subfunction 
    
    Time of Error Information 
    
    PSW: 071C2000 83AA2110 Instruction length: 02 Interrupt code: 000D 
    Failing instruction text: BFFFB148 0A0D98EC B08807FE 
    
    Breaking event address: 00000000_00000000 
    AR/GR 0-1 00000000/00000001_00000000 00000000/00000000_0405C000 
    AR/GR 2-3 00000000/00000000_7F10C128 00000000/00000000_00000024 
    AR/GR 4-5 00000000/00000000_006EA338 00000000/00000000_006A3648 
    AR/GR 6-7 00000000/00000000_006A2D64 00000000/00000000_7F363028 
    AR/GR 8-9 00000000/00000000_00000000 00000000/00000000_00000000 
    In the following STATUS FAILDATA output, the symptom string indicates a system abend code of X'0C4' with a reason code of X'00000010'
    SEARCH ARGUMENT ABSTRACT                                                     
                                                                                 
       PIDS/5752SCPX1 RIDS/BPXINPVT#L RIDS/BPXVFPCT AB/S00C4 PRCS/00000010       
       REGS/C4E10 RIDS/BPXMIPCE#R                                                
                                                                                 
       Symptom             Description                                           
       -------             -----------                                           
       PIDS/5752SCPX1      Program id: 5752SCPX1                                 
       RIDS/BPXINPVT#L     Load module name: BPXINPVT                            
       RIDS/BPXVFPCT       Csect name: BPXVFPCT                                  
       AB/S00C4            System abend code: 00C4                               
       PRCS/00000010       Abend reason code: 00000010                           
       REGS/C4E10          Register/PSW difference for R0C:-4E10                 
       RIDS/BPXMIPCE#R     Recovery routine csect name: BPXMIPCE
                                                                                 
     OTHER SERVICEABILITY INFORMATION                                            
                                                                                 
       Recovery Routine Label:  BPXMIPCE                                         
       Date Assembled:          12/19/04                                         
       Module Level:             HBB7720                                         
       Subfunction:             OpenMVS                                          
                                                                                 
     Time of Error Information                                                   
                                                                                 
       PSW: 47043000 80000000 00000000 27EA624C                                  
       Instruction length: 02   Interrupt code: 0010                             
       Failing instruction text: 58E0D56C 18F10E0E B2190200                      
       Translation exception address: 00000000_66831000                          
         
  • EREP or VERBX LOGDATA

    Use EREP to format software records (TYPE=S) recorded to SYS1.LOGREC for the time frame of the failure or error or format SYS1.LOGREC records from the in storage buffer using the VERBX LOGDATA command.

    For information about EREP, see EREP Reference.
    To find software records that might be associated with the failure, follow these suggestions:
    • Look for the general time frame
    • Search on the job name or ASID involved
    • Search for the failing component id.

    For the abend code, look for AB/S0hhh in the symptoms under the heading SEARCH ARGUMENT ABSTRACT, if present.

    For the reason code, look for PRCS/hhhhhhhh in the symptoms, or look in the register indicated in the abend code explanation.

    Here is an example of a software logrec entry formatted by EREP or the IPCS VERBX LOGDATA command against an SVC dump. The free-format search argument generated for this entry is: ABEND05C RSN00000214.
    TYPE: SOFTWARE RECORD REPORT: SOFTWARE EDIT REPORT DAY.YEAR 
    (SVC 13) REPORT DATE: 115.06 
    FORMATTED BY: IEAVTFDE HBB7703 ERROR DATE: 096.06 
    MODEL: 2084 HH:MM:SS.TH 
    SERIAL: 0D8B9F TIME: 12:14:42.66 
    
    JOBNAME: HSMVM0A SYSTEM NAME: VM0A 
    ERRORID: SEQ=03567 CPU=0000 ASID=003C TIME=12:14:42.6 
    
    SEARCH ARGUMENT ABSTRACT 
    
    PIDS/5752SC1B4 RIDS/IEFW21SD#L RIDS/IEFDB400 AB/S005C PRCS/00000214 REGS/0E01E
    REGS/0C6D8 RIDS/IEFDB402#R 
    
    SYMPTOM DESCRIPTION 
    ------- ----------- 
    PIDS/5752SC1B4 PROGRAM ID: 5752SC1B4 
    RIDS/IEFW21SD#L LOAD MODULE NAME: IEFW21SD 
    RIDS/IEFDB400 CSECT NAME: IEFDB400 
    AB/S005C SYSTEM ABEND CODE: 005C 
    PRCS/00000214 ABEND REASON CODE: 00000214 
    REGS/0E01E REGISTER/PSW DIFFERENCE FOR R0E: 01E 
    REGS/0C6D8 REGISTER/PSW DIFFERENCE FOR R0C: 6D8 
    RIDS/IEFDB402#R RECOVERY ROUTINE CSECT NAME: IEFDB402 
    
    OTHER SERVICEABILITY INFORMATION 
    
    RECOVERY ROUTINE LABEL: IEFAB4ED 
    DATE ASSEMBLED: 05223 
    MODULE LEVEL: UA20441 
    SUBFUNCTION: DYNAMIC ALLOCATION 
    
    TIME OF ERROR INFORMATION 
    
    PSW: 071C2000 83AA2110 INSTRUCTION LENGTH: 02 INTERRUPT CODE: 000D 
    FAILING INSTRUCTION TEXT: BFFFB148 0A0D98EC B08807FE 
    
    REGISTERS 0-7 
    GR: 00000000 0405C000 7F10C128 00000024 006EA338 006A3648 006A2D64 7F363028 
  • OPERLOG, SYSLOG, or job log or VERBEXIT MTRACE
    Look for message IEA995I or other messages with an abend code in the message text. The message might also give a reason code. For example:
    IEA995I SYMPTOM DUMP OUTPUT 694 
    USER COMPLETION CODE=4039 REASON CODE=00000000 
    TIME=05.07.41 SEQ=33565 CPU=0000 ASID=0247 
    PSW AT TIME OF ERROR 078D1000 99937C66 ILC 2 INTC 0D 
    ACTIVE LOAD MODULE ADDRESS=1987A4C0 OFFSET=000BD7A6
    NAME=CEEPLPKA 
    DATA AT PSW 19937C60 - 00181610 0A0D58D0 D00498EC 
    AR/GR 0: 80C4BB3E/84000000 1: 00000000/84000FC7 
    2: 00000000/000A1E08 3: 00000000/0002000D 
    4: 00000000/1992CA78 5: 00000000/000A1954 
    6: 00000000/00000000 7: 00000000/198758E0 
    8: 00000000/000A1E08 9: 00000000/000A34C6 
    A: 00000000/000A1954 B: 00000000/19937B90 
    C: 00000000/0009EA58 D: 00000000/000A4608 
    E: 00000000/9992BBAE F: 00000000/00000000 
    END OF SYMPTOM DUMP 

    In message texts, an abend code can be called a system completion code or a SYS CODE. A message can show an abend code in the variable text without identifying it as an abend code; use the message explanation to understand the variable text.

  • VERBEXIT SYMPTOM output from a dump: Format the dump completely, as described in step 1 of Gathering additional problem data for abends. Look for AB/S0hhh and PRCS/hhhhhhhh in the symptoms.
    In the following VERBEXIT SYMPTOM output, the primary symptom string indicates a system abend code of X'03C' and a return code of X'2D000810'.
      Primary Symptom String:
    
        RIDS/NUCLEUS#L RIDS/IARYTASS PIDS/5752SC1CR AB/S003C RIDS/IARRR#R
        VALU/HC0099680 REGS/0E0B4 REGS/088FA PRCS/2D000810 VALU/CNAGEMENT
    
        Symptom            Symptom data       Explanation
        ---------------    -------------      -----------
        RIDS/NUCLEUS#L     NUCLEUS#L          Routine identifier
        RIDS/IARYTASS      IARYTASS           Routine identifier
        PIDS/5752SC1CR     5752SC1CR          Component identifier
        AB/S003C           003C               ABEND code - system
        RIDS/IARRR#R       IARRR#R            Routine identifier
        VALU/HC0099680     C0099680           Error related hexadecimal value
        REGS/0E0B4         0E0B4              Program register
        REGS/088FA         088FA              Program register
        PRCS/2D000810      2D000810           Return code
        VALU/CNAGEMENT     NAGEMENT           Error related character value
    
    The dump does not contain a secondary symptom string.
  • Dump title
    Look at the dump title; some titles contain the abend and reason codes. Use the DISPLAY DUMP,TITLE or DISPLAY DUMP,ERRDATA to display the dump title and any error information associated with captured dumps, or dumps written to pre-allocated or dynamically allocated data sets. In response to the DISPLAY command, message IEE853I or IEE854I are issued containing the requested information. Look in the IEE853I or IEE854I message replies for the abend code, reason codes and the registers. For example:
    IEE853I 12.54.26 SYS1.DUMP TITLES 939 
    SYS1.DUMP DATA SETS AVAILABLE=000 AND FULL=002
    CAPTURED DUMPS=0000, SPACE USED=00000000M, SPACE FREE=00000200M 
    DUMP00 TITLE=ABEND=S0C4,RC=0010,COMPON=SDSF-ESTAE,COMPID=5647-A01
    ,ISSUER=ISFSTAE,SDSF ABEND ROUTINE 
    DUMP TAKEN TIME=17.49.48 DATE=nn/nn/nnnn
    DUMP01 TITLE=ABEND=S0C4,RC=0010,COMPON=SDSF-ESTAE,COMPID=5647-A01
    ,ISSUER=ISFSTAE,SDSF ABEND ROUTINE 
    DUMP TAKEN TIME=nn.nn.nn DATE=nn/nn/nnnn 
    
    

    For a dump that has been copied from the SYS1.DUMPxx data set or for an SVC dump you are viewing in IPCS, use the IPCS LIST TITLE subcommand to obtain the dump title.

You know you are done when you locate the abend and reason codes. Look up a description of the abend code using the product documentation or LookAt and follow the recommendations.




Copyright IBM Corporation 1990, 2010