PH22067: INSUFFICIENT LRECL FOR OUTPUT DATASET IF VARBINARY EXPRESSION - 2 BYTES MISSING PER VARBINARY FIELD

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The LRECL attribute set by Db2 HPU for the output data set
  containing the unloaded data of a logical unload (OUTDDN) is
  insufficient which leads to truncated records in the unloaded
  data.
  
  This occurs if the following conditions are fulfilled:
  - the select-clause of the SELECT statement involves VARBINARY
  expressions.
  - either of the following situation applies:
     - the output data set is allocated outside of Db2
     (HPU typically through a DD statement) that does not specify
     the LRECL parameter and DFSIGDCB=NO applies
     - the output data set is allocated outside of Db2
     (HPU typically through a DD statement) and DFSIGDCB=YES
     applies
     - the output data set is allocated by Db2 HPU through a
     TEMPLATE statement that does not specify the LRECL parameter
  
  When computing the LRECL value suitable for the unloaded data,
  Db2 HPU unduly considers each VARBINARY expression involved in
  the logical unload as a (fixed-length) BINARY expression, thus
  not counting the two bytes necessary for the length part of the
  related variable field.
  
  Therefore, the incorrect LRECL value is equal to the optimal
  value minus two per VARBINARY expression in the select-clause.
  

Local fix

• Specify and explicit LRECL with the correct value and
  DFSIGDCB=NO.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of Db2 High Performance Unload         *
  *                 for z/OS                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: The LRECL attribute set by Db2 HPU for  *
  *                      the output data set containing the      *
  *                      unloaded data of a logical unload       *
  *                      (OUTDDN) is insufficient which leads to *
  *                      truncated records in the unloaded data. *
  *                                                              *
  *                      This occurs if the following conditions *
  *                      are fulfilled:                          *
  *                      - the select-clause of the SELECT       *
  *                      statement involves VARBINARY            *
  *                      expressions.                            *
  *                      - either of the following situation     *
  *                      applies:                                *
  *                         - the output data set is allocated   *
  *                         outside of Db2                       *
  *                         (HPU typically through a DD          *
  *                         statement) that does not specify     *
  *                         the LRECL parameter and DFSIGDCB=NO  *
  *                         applies                              *
  *                         - the output data set is allocated   *
  *                         outside of Db2    (HPU typically     *
  *                         through a DD statement) and          *
  *                         DFSIGDCB=YES    applies              *
  *                         - the output data set is allocated   *
  *                         by Db2 HPU through a TEMPLATE        *
  *                         statement that does not specify the  *
  *                         LRECL parameter                      *
  *                                                              *
  *                      When computing the LRECL value suitable *
  *                      for the unloaded data, Db2 HPU unduly   *
  *                      considers each VARBINARY expression     *
  *                      involved in the logical unload as a     *
  *                      (fixed-length) BINARY expression, thus  *
  *                      not counting the two bytes necessary    *
  *                      for the length part of the related      *
  *                      variable field.                         *
  *                                                              *
  *                      Therefore, the incorrect LRECL value is *
  *                      equal to the optimal value minus two    *
  *                      per VARBINARY expression in the         *
  *                      select-clause.                          *
  ****************************************************************
  * RECOMMENDATION: Apply the PTF                                *
  ****************************************************************
  Insufficient LRECL for output dataset if VARBINARY
  expression - 2 bytes missing per VARBINARY field
  

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:

  UI69013

Modules/Macros

• INZ$$PRM INZTDSC  INZTVAR  INZUTILK
  

Fix information

• Fixed component name

  DB2 HI PERF UNL

• Fixed component ID

  5697F4400

Applicable component levels

• R430 PSY UI69013

     UP20/04/22 P F004

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.