A fix is available
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 IMS Database Reorganization * * Expert for z/OS Version 4 Release 1 * * (FMID=H25N410). * **************************************************************** * 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 by IPR Reload utility or the reload task of Smart Reorg Driver. To use the new function, the following maintenance is required: - APAR PM68882 for IMS High Performance Load (FMID=H1IM210)
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== IMS Database Reorganization Expert for z/OS Version 4 Release 1 User's Guide SC19-1137-02 ( SC19113702 ) should be changed as follows: ================================================================ 3.5.2 Control statements for Smart Reorg 3.5.2.2 Control statements for Smart Reorg Driver 3.5.2.5 Control statements for Reload task : Table 17. Control statements for Reload task +----------+-------------------+---------+--- | Keyword | Acceptable values | Default | +----------+-------------------+---------+--- | : | : | : | +----------+-------------------+---------+--- | | REPAIRILK| NO or YES | NO | +----------+-------------------+---------+--- | : | : | : | 5.3 IPR Reload JCL statements 5.3.2 Control statements | 5.3.2.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 7.1. | 7.0 Reference 7.1 Setting installation default options 7.1.4 How to code HPSCOPT macro statements : ____________________________________________________________ | | | DRIVRL: | | <_,_____________________________________________ | | |__DRIVRL_______________________________________________ |_| | |_ ____________ __________________ __________| | | | |_ILEDATAC=__|_data_class_name__| | | : : | |_ ________________________________________ _| | | | | _NO______________________ | | | | | | | _,PINITON_ | | | | | | |_PARTINIT=__|_(__YES__|__________|__)_|_| | | | | |_,UNLOAD__| | | | | |_ _____________________ ____________________| | | | | | _NO__ | | | | | | |_REPAIRILK=__|_YES_|_| | | | |_ _________________ ________________________| | | | | _NO___ | | | | | |_SORT=__|_YES__|_| | | | | |_COND_|_| | | | |_ __________________ _______________________| | | | _YES_ | | | |_WF1REC=__|_NO__|_| | | | |____________________________________________________________| : ____________________________________________________________ | | | 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__|_| | | | |____________________________________________________________| : DRIVRL This parameter identifies the Reload task under the Smart Reorg Driver. This parameter supports the following values: - ILEDATAC - ILESTORC - OADSPR - PARTINIT | - REPAIRILK - SORT - WF1REC The specification of PARTINIT is valid only when REORGINPT=ULDS is used. : : RELOAD This parameter identifies the IPR Reload utility. This parameter supports the following values: - DECODEDBD - PARTINFO - CHKUPDT - HPIO - OADSPR - PARTINIT | - REPAIRILK - SORT - ITKBLOAD - ITKBSRVR - ILDSBLD - ILEDATAC - ILESTORC - GDGBASE - GDGLIMIT - WF1REC Note: The Reload task under Smart Reorg uses the option table for DRIVRL, not the one for RELOAD. 8.0 Troubleshooting 8.2 Messages and codes 8.2.1 Return codes 8.2.1.3 The IPR Reload utility return codes : Table 69. Return codes of the IPR Reload utility +------+-------+---------------------------------------------+ |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. | | +------+-------+---------------------------------------------+
APAR Information
APAR number
PM68883
Reported component name
IMS DB REORG EX
Reported component ID
5655F7400
Reported release
410
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
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:
UK81583
Modules/Macros
HPSCOPT HPSCOPTS HPSGOPTR
| SC19113702 |
Fix information
Fixed component name
IMS DB REORG EX
Fixed component ID
5655F7400
Applicable component levels
R410 PSY UK81583
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSVL5Q","label":"IMS Database Reorganization Expert for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023