PK30536: ADDITIONAL USER ERROR HANDLING FOR CMPSC MICROCODE

APAR status

• Closed as program error.

Error description

• Add code to HCOZLDX0 and HCOZLDXV to include additional user
  error handling for CMPSC microcode failures.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM IMS Hardware Data       *
  *                 Compression Extended (HSDCE) product         *
  *                 5655-E02.                                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: The CMPSC hardware instruction invoked  *
  *                      by the compression exit gets an         *
  *                      ABENDS0C7 as a result of various user   *
  *                      errors, e.g. wrong dictionary used to   *
  *                      decompress than used to compress. An    *
  *                      IMS online application that detected    *
  *                      an ABENDS0C7 would cause IMS to issue   *
  *                      an ABENDU113 and then bring down the    *
  *                      IMS control region.                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  There was no internal error processing in the exit drivers
  HCOZLDX0 and HCOZLDXV to handle microcode abends due to user
  errors.
  

Problem conclusion

• Special processing was added to exit drivers HCOZLDX0 and
  HCOZLDXV to handle CMPSC microcode ABENDS0C7s.
  A new reasoncodeD3C4E711 was added to the ABENDU3325 process
  so that IMS will recognize the error and only issue an
  ABENDU840, or similar, to terminate the failing online
  application. This avoids IMS terminating the entire control
  region.
  
  Page 85 in Appendix A of the Users Guide SC27-1005-03 needs
  the following reason code description added.
  
  Reason Code 11
  Explanation: The CMPSC instruction issued by the exit
  detected an ABENDS0C7.
  Syatem action: The exit ends immediately and the IMS
  application terminates with an IMS user ABENDU840 or
  similar.
  Operator response: Notify the DBA owner of the failing
  transaction.
  System programmer response: Notify the DBA owner of the
  failing transaction.
  Problem determination: An incorrect dictionary was used
  to retrieve data in an HDC compresssed segment. Correct
  the failing DBD's COMPRTN exit name and try again. If the
  failure persists, contact IBM support.
  
  Follow the instructions on page 54 of the Users Guide
  (Relinking a compression Exit Routine) to implement this
  new special processing enhancement.
  

Temporary fix

Comments

APAR Information

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

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

  UK20479

Modules/Macros

•    HCOZLDXV HCOZLDX0
  

Fix information

• Fixed component name

  IMS HDCE

• Fixed component ID

  5655E0200

Applicable component levels

• R220 PSY UK20479

     UP06/12/13 P F612