PK59570: HP LOAD SUPPORTS VALIDATION OF COMPRESSION ROUTINE CHANGE DURINGTHE REORGANIZATION.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• HP Load supports validation of compression routine change during
  the reorganization.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS High Performance Load   *
  *                 for z/OS Version 2 Release 1 (FMID=H1IM210)  *
  ****************************************************************
  * PROBLEM DESCRIPTION: HP Load supports validation of          *
  *                      compression routine change during the   *
  *                      reorganization.                         *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  HP Load supports validation of compression routine change during
  the reorganization.
  When segment edit/compression routine is changed during the
  reorganization, decompressed unload data set should be used and
  the use of compressed unload data set has the risk of corrupting
  database. This APAR provides the function to prevent the use of
  compressed unload data set during the load processing of the
  reorganization. If compression routine is changed during the
  reorganization and the input unloaded data set is in a
  compressed form, the reload job will end abnormally and the
  registered DMB entry (RDE) will not be updated.
  To use this function, the following maintenance is required:
  APAR PK59352 for IMS Library Integrity Utilities (FMID=H27P110)
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  IMS High Performance Load for z/OS Version 2 Release 1 User's
  Guide SC18-9222-02 ( SC18922202 ) should be changed as follows:
  ================================================================
  2.1 Introduction
   2.1.1 Program functions
    2.1.1.1 Reloading IMS databases by using high performance
            methods
  :
    Optionally, High Performance Load reloads an HD unloaded
    database data set with compressed segments, created by the IMS
    High Performance Unload for OS/390 unload utilities or other
    compatible utilities, in a compressed form without calling the
  | segment compression routine. In this case, the segment
  | compression routine must not be changed during the
  | reorganization. IMS Library Integrity Utilities for z/OS with
  | APAR PK59352 can be used to detect such a change.
  | If it detects the change and the input unloaded data set is in
  | a compressed form, the reload job will end abnormally.
  | For information about IMS Library Integrity Utilities,
  | see 'IMS Library Integrity Utilities for z/OS, V1R1,
  | User's Guide'.
  :
  High Performance Load supports logical relationships and
  secondary indexes. This is also true for a HALDB.
   :
  
  APPENDIX1.3   Appendix C.  Messages and codes
   APPENDIX1.3.1 Return codes
    APPENDIX1.3.1.1 High Performance Load return codes
    Table 27. Return codes of High Performance Load
    +------+--------+--------------------------------------------+
    |Return| Reason | Meaning                                    |
    |code  | code   |                                            |
    +------+--------+--------------------------------------------+
    |  0   | None   | Successful completion.                     |
    +---------------+--------------------------------------------+
    |  4   | The reason code is a logical sum of the following   |
    |      | codes:                                              |
    |      +--------+--------------------------------------------+
    |      |            :                                        |
  | |      +--------+--------------------------------------------+
  | |      | X'1000'| API function error in the LIU Integrity    |
  | |      |        | Checker                                    |
  | |      +--------+--------------------------------------------+
    |      |            :                                        |
  | +------+--------+--------------------------------------------+
  
  APPENDIX1.3   Appendix C.  Messages and codes
   APPENDIX1.3.3 Messages
    APPENDIX1.3.3.1 High Performance Load messages
  
  | HPSR3870E NAME/TOKEN SERVICE xxxxxxx FAILED. NAME: nametoken
  | RC=nn
  | Explanation: The process failed in the z/OS MVS Name/Token
  | Service. xxxxxxx shows the service name. nn is the return code
  | of the Name/Token service.
  | System Action: High Performance Load issues a user 3870 abend.
  | Programmer response: If necessary, correct the warning
  | condition and rerun the job.
  | Problem determination: Find the cause of the error. For the
  | return code, see the z/OS MVS Programming Assembler Services
  | Reference, Volume 2 (IARR2V-XCTLX).
  
  | HPSR3871I   RDE CREATED FOR DBD/PART: dbdname/partname.
  | Explanation: The registered DMB entry (RDE) has been
  | successfully created for database dbdname/partname.
  | System action: Processing continues.
  | Programmer Response: None.
  | Problem Determination: None.
  
  | HPSR3872W  LIU API FUNCTION ERROR. DBD/PART=dbdname/partname
  | FUNC=xxxxxx RC=rr  RSN=yyyy
  | Explanation: The API function in the LIU Integrity Checker
  | ended with an error. The registered DMB entry (RDE) was not
  | created  or updated.
  | System action: Processing continues.
  | Programmer response: Create the RDE after the reload process,
  | or correct the warning condition and rerun the job.
  | Problem Determination: None.
  
  | HPSR3873E THE INPUT DATA IS COMPRESSED BY THE OLD COMP
  | ROUTINE.
  | Explanation: The input data has been compressed by a
  | compression routine other than that is defined in the DBD.
  | The data cannot be decompressed.
  | System Action: High Performance Load issues a user 3873 abend.
  | Programmer response: If you change the compression routine,
  | use a decompressed unload data set for input.
  | Problem determination: None.
  
  | HPSR3874E THE INFORMATION ABOUT RDE CREATION WAS NOT FOUND.
  | DBD/PART= dbdname/partname
  | Explanation: HP Load needs to get the information about the
  | creation of the registered DMB entry (RDE) from LIU.
  | However, HP Load could not find the information for database
  | dbdname/partname.
  | System Action: High Performance Load issues a user 3874 abend.
  | Programmer response: Contact IBM Software Support.
  | Problem determination: None.
  

APAR Information

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

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

  UK33378

Modules/Macros

• HPSRDSCT HPSRFCA0 HPSRGVT0 HPSRHDLA HPSRHDLD
  HPSRHDL7 HPSRHDL8 HPSRHDL9 HPSRHSLA HPSRHSLD HPSRHSL7 HPSRHSL8
  HPSRHSL9 HPSRMSGT HPSRPC00 HPSRRLDA HPSRRLDM HPSRRLD7 HPSRRLD8
  HPSRRLD9
  

Fix information

• Fixed component name

  IMS HIGH PERF L

• Fixed component ID

  5655E0700

Applicable component levels

• R210 PSY UK33378

     UP08/02/01 P F801

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.