PK15166: THIS CUSTOMER IS COMPLAINING THAT DFHDU640 FAILS TO PRINT THE REGISTERS AT THE LAST EXEC COMMAND. EIUS +X'50' IS ZEROS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This customer is complaining that DFHDU640 fails to print
  the registers at the last EXEC command.
  The Transactiondump (ID=1/0005) shows for task 00042
     REGISTERS AT LAST EXEC COMMAND
     - NO EXEC COMMAND REGISTERS CAN BE FOUND
     We also see the following message:
  DFHSR0001 IV3A64A1 An abend (code 0C1/AKEA) has occurred at
  offset X'00000096' in program PGMASRA.
     Trace shows:
  AP 00E1 EIP EXIT ASKTIME OK  RET-80083868.
  AP 1942 APLI *EXC*-Program-Check FUNCTION(START_PROGRAM)
     PROGRAM(PGMASRA
  .
      We have two issues here....
  1. RET addr wrong on EIP EXIT trace entry - DFHEIP is missing
  code to address EIUS_RSA_ADDR so that Reg14 can be set from the
  applications save area before issuing the exit trace entry.
  .
  2. EIUS_RSA_ADDR being cleared before control passed back to the
  application - DFHEIP is zeroing EIUS_RSA_ADDR in all cases. I
  believe it should work as at R620 where only if this was a JVM
  program was EIUS_RSA_ADDR cleared.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: After post processing transaction dump  *
  *                      REGISTERS AT LAST EXEC COMMAND are not  *
  *                      printed.                                *
  *                      In addition the return address for      *
  *                      trace entry AP 00E1 EIP EXIT is         *
  *                      incorrect.                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  If DFHDU640 is used to process a transaction dump registers
  after the last exec cics command should be displayed. Instead
  the following is displayed in the formatted output REGISTERS AT
  LAST EXEC COMMAND - NO EXEC COMMAND REGISTERS CAN BE FOUND.
  In addition the AP 00E1 EIP EXIT trace entry RET address
  contains the return address for DFHEIP and not the return
  address of the program.
  For the first problem the application register save area
  address is being incorrectly cleared and for the second problem
  R14 is not being loaded before the AP 00E1 EIP EXIT trace point
  is written.
  
  Additional Keywords : EIUS_RSA_ADDR ASRA 0C1 S0C1 ABENDS0C1
                        ABEND0C1 RET
  

Problem conclusion

• DFHEIP has been changed to only clear EIUS_RSA_ADRR if the
  program is a JVM program and to get the return address from
  EIUS_RSA_ADRR before the EIP EXIT trace entry is written.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  PK15218 UK10439

Modules/Macros

•    DFHEIP
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK10439

     UP05/12/30 P F512

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.