IBM Support

PM68882: PROVIDE A NEW FUNCTION TO REASSIGN ILKS FOR THE REPAIR OF DUPLICATED ILK.

A fix is available

Obtain the fix for this APAR.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • Provide a new function to reassign ILKs for the repair of
duplicated ILK.

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: Enable to reassign ILKs for the repair  *
*                      of duplicated ILK.                      *
****************************************************************
* RECOMMENDATION: Apply the maintenance for this APAR.         *
****************************************************************
This APAR enables the specification of REPAIRILK to reassign
ILKs for the repair of duplicated ILK.

    



Problem conclusion


    

  • 



Temporary fix


    

  • 



Comments


    

  • ========================
= Documentation Change =
========================
IMS High Performance Load for z/OS Version 2 Release 1 User's
Guide SC18-9222-04 ( SC18922204 ) should be changed as follows:
================================================================
  2.2      Operating instructions
  2.2.3    Control statements
| 2.2.3.xx REPAIRILK control statement
|
| Specifies whether to reassign ILKs using new RBA, partition
| ID, and reorganization number.
| This control statement is optional. If you do not explicitly
| specify this control statement, REPAIRILK=NO will be used.
|
|    _________________________________________________________
|   |                                                         |
|   |                  _NO___                                 |
|   | >>__REPAIRILK=__|_YES__|_____________________________>< |
|   |                                                         |
|   |_________________________________________________________|
|
| NO
|   ILK in segment prefix is not reassigned.
|
| YES
|   ILK in segment prefix is reassigned using new RBA, partition
|   ID, and reorganization number.
|
| Warning:
|   It is strongly recommended that entire HALDB partitions are
|   reorganized with REPAIRILK=YES when you specify
|   REPAIRILK=YES to prevent future problem caused by ILK
|   duplication.
|   When you specify REPAIRILK=YES, PSINDEX for the HADLB must
|   be rebuilt, because ILKs are changed.
|
| Restriction:
|   Logical relationships are not supported.
|
| Note:
|   The default value of the REPAIRILK control statement can be
|   changed. For details, see "Setting installation default
|   option" in topic 6.1.
|
  6.0 References
  6.1 Setting installation default option
  6.1.4 How to code HPSROPT macro statements
    :
   ____________________________________________________________
  |                                                            |
  | RELOAD:                                                    |
  |          <_,_____________________________________________  |
  | |__RELOAD_______________________________________________ |_|
  |            |_ ________________________________________ _|  |
  |            | |             _(__YES,WARN__)__________  | |  |
  |            | |            |             _WARN__     | | |  |
  |            | |_CHKTRAIL=__|_(__YES__,__|_ERROR_|__)_|_| |  |
  |            |              |_NO______________________|   |  |
                   :
                   :
  |            |_ ________________________________________ _|  |
  |            | |             _NO______________________  | |  |
  |            | |            |          _,PINITON_     | | |  |
  |            | |_PARTINIT=__|_(__YES__|__________|__)_|_| |  |
  |            |                        |_,UNLOAD__|        |  |
  |            |                        |_,LPART___|        |  |
| |            |_ _____________________ ____________________|  |
| |            | |              _NO__  |                    |  |
| |            | |_REPAIRILK=__|_YES_|_|                    |  |
  |            |_ _________________ ________________________|  |
  |            | |         _NO___  |                        |  |
  |            | |_SORT=__|_YES__|_|                        |  |
  |            |          |_COND_|_|                        |  |
  |            |____________________ _______________________|  |
  |              |           _YES_  |                          |
  |              |_WF1REC=__|_NO__|_|                          |
  |                                                            |
  |____________________________________________________________|

    :
  The option keywords supported for the RELOAD parameter are as
  follows:

    - CHKTRAIL, CHKUPDT, HPIO, ILDSBLD, ILEDATAC, ILESTORC,
|     OADSPR, PARTINIT, SORT, REPAIRILK, and WF1REC.

  7.0     Troubleshooting
  7.2     Messages and codes
  7.2.1   Return codes
  7.2.1.1 IMS HP Load return codes
      :
  Table 27. Return codes of IMS HP Load
  +------+-------+---------------------------------------------+
  |Return|Reason |      Meaning                                |
  |code  |code   |                                             |
  +------+-------+---------------------------------------------+
  |   0  |None   |Successful completion.                       |
  +------+-----------------------------------------------------+
  |   4  |The reason code is a logical sum of the following    |
  |      |codes:                                               |
  |      +-------+---------------------------------------------+
      :
  |      +-------+---------------------------------------------+
  |      |X'2000'|Although partition initialization function is|
  |      |       |used, some partitions were not initialized by|
  |      |       |one of the following reasons:                |
  |      |       | :                                           |
| |      +-------+---------------------------------------------+
| |      |X'4000'|Error code returned from the DB Sensor.      |
| |      +-------+---------------------------------------------+
| |      |X'8000'|Although REPAIRILK=YES is specified, some    |
| |      |       |partitions are not reloaded. It is strongly  |
| |      |       |recommended that entire HALDB partitions are |
| |      |       |reloaded with REPAIRILK=YES to prevent a     |
| |      |       |future problem caused by duplication of ILK. |
| +------+-------+---------------------------------------------+

  7.2.3.1 IMS HP Load messages
    :
| HPSR0134I LOGICAL RELATIONSHIP IS FOUND IN THE DBD DEFINITION
|
| Explanation: Logical relationship is found in the DBD
| definition. If the database is a HALDB, you need to rebuild
| ILDS.
| System Action: IMS HP Load continues processing.
| User Response: None.
| Problem Determination: None.
|
| HPSR0135I SECONDARY INDEX IS DEFINED FOR THE DB
|
| Explanation: At least one secondary index is defined for the
| database. If the database is a HALDB, you need to rebuild ILDS
| or secondary index databases.
| System Action: IMS HP Load continues processing.
| User Response: None.
| Problem Determination: None.
|
| HPSR0136E REPAIRILK=YES CANNOT BE SPECIFIED FOR DB WITH
| LOGICAL RELATIONSHIP
|
| Explanation: The specification of REPAIRILK=YES is not
| supported for database with logical relationship.
| System Action: Processing stops with return code 8.
| User Response: Specify another option for the REPAIRILK
| statement and rerun the job.
| Problem Determination: None.
|
| HPSR0137W ALTHOUGH REPAIRILK=YES IS SPECIFIED, SOME PARTITIONS
| ARE NOT RELOADED
|
| Explanation: Although REPAIRILK=YES is specified, some
| partitions are not reloaded. ILKs for the segments of the
| reloaded partitions are reassigned by specifying
| REPAIRILK=YES. These ILKs may duplicate with the ILK for the
| segment in the partitions that is not reorganized. So it is
| strongly recommended that entire HALDB partitions are reloaded
| with REPAIRILK=YES to prevent a future problem caused by
| duplication of ILK.
| System Action: IMS HP Load sets a return code of 4 and
| completes the reloading of the database.
| User Response: It is strongly recommended that entire HALDB
| partitions are reloaded with REPAIRILK=YES to prevent a future
| problem caused by duplication of ILK.
| Problem Determination: None.
|
| HPSR0138W PSINDEX: ddname   MUST BE REBUILT
|
| Explanation: The PSINEX database ddname must be rebuilt
| because ILKs are reassigned by REPAIRILK=YES.
| System Action: IMS HP Load continues processing.
| User Response: The PSINDEX must be rebuilt after the
| reorganization of database.
| Problem Determination: None.

    



APAR Information




    

  • APAR number
    PM68882
    • 

  • Reported component name
    IMS HIGH PERF L
    • 

  • Reported component ID
    5655E0700
    • 

  • Reported release
    210
    • 

  • Status
    CLOSED  UR1
    • 

  • PE
    NoPE
    • 

  • HIPER
    NoHIPER
    • 

  • Special Attention
    YesSpecatt / New Function
    • 

  • Submitted date
    2012-07-13
    • 

  • Closed date
    2012-09-06
    • 

  • Last modified date
    2012-10-01
    • 





    

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

    • 

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

    
UK81582
    

    • 



Modules/Macros


    

  • HPSRCILA HPSRCILB HPSRCIL2 HPSRCIL7 HPSRCIL8
HPSRCIL9 HPSRFCA0 HPSRHTBL HPSRMSGT HPSROPT  HPSROPTA HPSROPTS
HPSRRLDA HPSRRLDB HPSRRLD2 HPSRRLD7 HPSRRLD8 HPSRRLD9 HPSRRRI0
HPSRRRI9 HPSRSTMT

    




Publications Referenced


SC18922204    





Fix information


    

  • Fixed component name
    IMS HIGH PERF L
    • 

  • Fixed component ID
    5655E0700
    • 



Applicable component levels


    

  • R210  PSY  UK81582
       UP12/09/08  P  F209
    • 



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":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89F","label":"IMS HP Load"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1.0","Edition":"","Line of Business":{"code":"","label":""}}]
              

                                                                    

          
 
        

      

    

      

        

          

            
Document Information


            

            


                        

            Modified date:
            

            01 October 2012
            

            
                      

        


        

        


      

    

  



    

  

  
    
            

          
Page Feedback