IBM Support

PH61933: PERFORM BASIC COMPLIANCE CHECKING OF DATASET USED AS AN INPUT IMAGE COPY FOR THE UNLOAD

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Db2 HPU assumes that the datasets used as input image copies
    (either provided by the user or automatically determined by
    searching the DB2 catalog) needed for the COPYDDN option are
    valid. If this requirement is not fulfilled, Db2 HPU can unload
    incorrect data without any notification to the user.
    
    For example, the unload produces zero rows and completes with a
    normal completion code if all the following conditions are
    fulfilled:
    - the image copy must be sorted
    - the record size of the image copy is lower than the page size
    of the target tablespace
    
    - the first record of the image copy is not recognized as an
    header page of an image copy : i.e. the value of the character
    at offset 11 is equal neither to X38' nor to  x18'
    
    Db2 HPU should do some basic checking of the content of the
    datasets used as input images copies to detect obviously
    incorrect datasets.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of Db2 High Performance Unload for     *
    *                 z/OS                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: (HPU 5.2 only)                          *
    *                      Db2 HPU assumes that the datasets used  *
    *                      as input image copies (either provided  *
    *                      by the user or automatically            *
    *                      determined by searching the DB2         *
    *                      catalog) needed for the COPYDDN option  *
    *                      are valid. If this requirement is not   *
    *                      fulfilled, Db2 HPU can unload           *
    *                      incorrect data without any              *
    *                      notification to the user.               *
    *                                                              *
    *                      For example, the unload produces zero   *
    *                      rows and completes with a normal        *
    *                      completion code if all the following    *
    *                      conditions are fulfilled:               *
    *                      - the image copy must be sorted         *
    *                      - the record size of the image copy is  *
    *                      lower than the page size of the target  *
    *                      tablespace                              *
    *                      - the first record of the image copy    *
    *                      is not recognized as an header page of  *
    *                      an image copy : i.e. the value of the   *
    *                      character at offset 11 is equal         *
    *                      neither to X'38' nor to  x'18'          *
    *                                                              *
    *                      Db2 HPU should do some basic checking   *
    *                      of the content of the datasets used as  *
    *                      input images copies to detect           *
    *                      obviously incorrect datasets.           *
    ****************************************************************
    * RECOMMENDATION: Apply the PTF                                *
    ****************************************************************
    perform basic compliance checking  of dataset used as an input
    image copy for the unload
    

Problem conclusion

  • Code has been changed to fix this problem
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH61933

  • Reported component name

    DB2 HI PERF UNL

  • Reported component ID

    5697F4400

  • Reported release

    520

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2024-06-18

  • Closed date

    2024-07-01

  • Last modified date

    2024-08-01

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

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

Modules/Macros

  • INZ$$CCQ INZ$$PRM INZMQRY  INZPARM  INZTDSC  INZTOOLS INZTVAR
    INZUTIB1 INZUTIB2 INZUTILC INZUTILD INZUTILK
    

Fix information

  • Fixed component name

    DB2 HI PERF UNL

  • Fixed component ID

    5697F4400

Applicable component levels

  • R520 PSY UI97541

       UP24/07/03 P F407

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSZJXP","label":"DB2 Tools for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"520","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
01 August 2024