PH27765: INCORRECT HANDLING OF USER EXIT ERRORS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• (HPU 5.1 only) In the cases described below, Db2 HPU does not
  correctly handle the errors return code returned by the user
  exit.
  - case 1) the user exit return a code greater than 4 when
  invoked at initialization time
  - case 2) the user exit returns a code of 8 when invoked to
  process a row.
  In such cases, Db2 HPU unduly behaves as follows:
  - case 1) the error is ignored and the processing resumes and
  does not report the erroneous situation through an error return
  code. The unload can complete with a code of 0.
  - case 2) the unload stops with completion code of 8 and issues
  the following error message
  INZU447E AN ERROR OCCURRED DURING UNLOAD PROCESSING - REFER TO
  PREVIOUS EXPLANATION
  but does not provide any exploitable explanation concerning the
  root cause of the error.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of Db2 High Performance Unload         *
  *                 for z/OS                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: In the cases described below, Db2 HPU   *
  *                      does not correctly handle the errors    *
  *                      return code returned by the user exit.  *
  *                      - case 1: the user exit return a code   *
  *                      greater than 4 when invoked at          *
  *                      initialization time                     *
  *                      - case 2: the user exit returns a code  *
  *                      of 8 when invoked to process a row.     *
  *                                                              *
  *                      In such cases, Db2 HPU unduly behaves   *
  *                      as follows:                             *
  *                      - case 1: the error is ignored and the  *
  *                      processing resumes and does not report  *
  *                      the erroneous situation through an      *
  *                      error return code. The unload can       *
  *                      complete with a code of 0.              *
  *                      - case 2: the unload stops with         *
  *                      completion code of 8 and issues the     *
  *                      following error message                 *
  *                      INZU447E AN ERROR OCCURRED DURING       *
  *                      UNLOAD PROCESSING - REFER TO PREVIOUS   *
  *                      EXPLANATION                             *
  *                      but does not provide any exploitable    *
  *                      explanation concerning the root cause   *
  *                      of the error.                           *
  ****************************************************************
  * RECOMMENDATION: Apply the PTF                                *
  ****************************************************************
  Incorrect handling of user exit errors
  

Problem conclusion

• Code has been changed to fix this problem
  

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:

  UI71706

Modules/Macros

• INZUTILK INZUTILL
  

Fix information

• Fixed component name

  DB2 HI PERF UNL

• Fixed component ID

  5697F4400

Applicable component levels

• R510 PSY UI71706

     UP20/09/27 P F009

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.