PK52055: ENHANCEMENT OF THE PARTITION INITIALIZATION FUNCTION.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• When HP Load reloads a HALDB partition with PARTINIT=YES and the
  partition does not contain any segment, it does not initialize
  the partition when the PINIT flag in RECON is off.
  HP Load is changed to issue a warning message in such cases.
  

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: This APAR provides a new function to    *
  *                      issue a warning message when a HALDB    *
  *                      partition is empty after HP Load with   *
  *                      PARTINIT=YES and the partition is not   *
  *                      initialized.                            *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides a new function to issue a warning message
  when a HALDB partition is empty after HP Load with PARTINIT=YES
  and the partition is not initialized. The warning Message is
  issued when the partition was not initialized by the following
  reasons.
  - PARTINIT=YES,PINITON is specified. But the flag in the RECON
    shows that the partition does not need to be initialized
    (NOPINIT).
  - PARTINIT=YES,UNLOAD is specified. But the partition
    information is not found in the unloaded data set.
  
  To use this new function, the following conditions must be
  satisfied:
  - The input unloaded data set has been created by HP Unload with
    APAR PK48499 and with the CHECKREC=YES option.
  - The input unloaded data sets are not concatenated.
  

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.0      High Performance Load
  2.2      Operating instructions
  2.2.3    Control statements
  2.2.3.16 PARTINIT control statement
  
       :
  If you want to use High Performance Load as a replacement for
  the HALDB partition data set initialization utility, specify the
  PARTINIT=YES control statement and DFSUINPT DD DUMMY for the
  High Performance Load JCL, and run it.
  
  | If you want HP Load to issue a warning message when a HALDB
  | partition is empty after HP Load with PARTINIT=YES and the
  | partition is not initialized, the following conditions must be
  | satisfied:
  | - The input unloaded data set has been created by HP Unload
  |   with APAR PK48499 and with the CHECKREC=YES option.
  | - The input unloaded data sets are not concatenated.
  
  APPENDIX1       Appendixes
  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'0020'| An inconsistent return code is received    |
  | |      |        | from the exit routine that is specified on |
  | |      |        | the USERHDRX control statement.            |
  | |      +--------+--------------------------------------------+
    |      |            :                                        |
  | |      +--------+--------------------------------------------+
  | |      | X'2000'| Although partition initialization function |
  | |      |        | is used, some partitions were not          |
  | |      |        | initialized by one of the following        |
  | |      |        | reasons.                                   |
  | |      |        | - The flag in the RECON shows that the     |
  | |      |        |   partition does not need to be initialized|
  | |      |        |   (NOPINIT).                               |
  | |      |        | - The partition information is not found in|
  | |      |        |   the unloaded data set.                   |
  | +------+--------+--------------------------------------------+
  
  APPENDIX1.3.3   Messages
  APPENDIX1.3.3.1 High Performance Load messages
  
    HPSR0121W PARTINIT=YES,UNLOAD IS IGNORED (reason)
  
    Explanation: PARTINIT=YES,UNLOAD was ignored because HP Load
    could not determine which partition should be initialized.
    reason gives description why the process was ignored. The
    reason is one of the following:
  
      CONCATENATED UNLOAD D/S
       - The input unloaded data sets are concatenated.
  
  |   LOAD API
  |    - Load API function is used
  |
      LOW LEVEL UNLOAD D/S
      - The input unloaded data set was not created by HP Unload
        with the CHECKREC=YES
         :
  
  | HPSR0122W PART: xxxxxxxx IS NOT INITIALIZED BECAUSE
  | INFORMATION IS NOT FOUND IN UNLOAD D/S
  |
  | Explanation: The flag in the DBRC RECON record for the
  | partition shows that the partition needs to be initialized
  | (PINIT=ON). However, the partition whose information is not
  | found in the unloaded data set is not initialized due to the
  | specification of PARTINIT=YES,UNLOAD.
  |
  | System Action: High Performance Load continues processing and
  | sets a return code of 4.
  |
  | Programmer Response: If the partition database data set is
  | deleted/defined before the reload, you must initialize it by
  | DFSUPNT0 before using it.
  |
  | Problem Determination: None
  
  | HPSR0123W EMPTY PARTITION xxxxxxxx IS NOT INITIALIZED BECAUSE
  | THE DBRC FLAG SHOWS NOPINIT.
  |
  | Explanation: The unloaded partition does not contain any
  | segment during reload. However, the partition is not
  | initialized because the flag in the RECON shows that the
  | partition does not need to be initialized (NOPINIT).
  |
  | System Action: High Performance Load continues processing and
  | sets a return code of 4.
  |
  | Programmer Response: If the partition database data set is
  | deleted/defined before the reload, you must initialize it by
  | DFSUPNT0 before using it.
  |
  | Problem Determination: None
  
  ======================= End of Doc-Change ======================
  

APAR Information

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

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

  UK29545

Modules/Macros

•    HPSRDSCT HPSRFCA0 HPSRHDLA HPSRHDLD HPSRHDL7
  HPSRHDL8 HPSRHDL9 HPSRMSGT HPSRRLDA HPSRRLDM HPSRRLD7 HPSRRLD8
  HPSRRLD9 HPSRRRIN HPSRRRI0 HPSRRRI9
  

Fix information

• Fixed component name

  IMS HIGH PERF L

• Fixed component ID

  5655E0700

Applicable component levels

• R210 PSY UK29545

     UP07/09/26 P F709

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.