A fix is available
APAR status
Closed as new function.
Error description
ORF supports a new option to initialize (empty out) a database during online reorganization.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IBM IMS Online Reorganization * * Facility V1.1 * **************************************************************** * PROBLEM DESCRIPTION: New keyword to initialize a database * * during online reorganization * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables ORF to initialize (empty out) a database during online reorganization. The following APAR must be applied to the related product: APAR PI88156 for IMS HP Load V2R1 (FMID: H1IM210)
Problem conclusion
======================== = DOCUMENTATION CHANGE = ======================== The IBM IMS Database Solution Pack for z/OS Version 2 Release 2 IMS Online Reorganization Facility User's Guide (SC27-9039-00) ---------------------------------------------------------------- > Using IMS Online Reorganization Facility >> HRFSYSIN DD statement keywords The following new keyword has been added: INITIALIZE keyword Use this keyword to initialize (empty out) the database during the reorganization. In the Reorganization phase, IMS Online Reorganization Facility initializes the shadow database instead of reloading the data. The INITIALIZE keyword is optional for REORG HRFSYSIN DD statements and is not applicable to UNLOAD HRFSYSIN DD statements. INITIALIZE(Y) is applicable only when all of the following conditions are met: - The load library of IMS High Performance Load is included in the STEPLIB. - The primary database to reorganize is not an index. - If the primary database to reorganize is a HALDB with PSINDEXes, PSINDEXBLD(Y) is specified and the load library of IMS Index Builder is included in the STEPLIB. - DFSUINPT DD statement defines a dummy data set. When initialization is requested (INITIALIZE(Y)) and if online updates to any existing database records occur during the job, the job fails in the Apply phase because the shadow database is initialized before the Apply phase and the shadow database contains no database records to apply online updates to. Attention: Use the INITIALIZE(Y) option with caution because this option removes all the database records from the online database. The default value is N. ---------------------------------------------------------------- > Troubleshooting >> Messages and codes >>> Messages The following new messages have been added: HRF01623E INITIALIZE(Y) not available. REASON: reason Explanation: INITIALIZE(Y) cannot be applied because the conditions for applying INITIALIZE(Y) are not met. System action: Processing terminates. User response: Complete one of the following tasks depending on the reason indicated in the message and resubmit the job: HP LOAD NOT FOUND Ensure that the load library of IMS High Performance Load is specified in the STEPLIB concatenations correctly. INDEX NOT SUPPORTED Ensure that the primary database to reorganize is not an index database. PSINDEXBLD(Y) REQUIRED Add the PSINDEXBLD(Y) keyword to the HRFSYSIN DD statement. HRF01624E DFSUINPT DD must define a dummy data set when INITIALIZE(Y) is specified Explanation: Database initialization failed because DFSUINPT DD statement does not define a dummy data set. System action: Processing terminates. User response: To initialize (empty out) the database during reorganization, add the DFSUINPT DD statement that defines a dummy data set and rerun the job. ----------------------------------------------------------------
Temporary fix
Comments
APAR Information
APAR number
PI90523
Reported component name
IMS ONLINE REOR
Reported component ID
5655H9701
Reported release
110
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2017-11-21
Closed date
2017-12-15
Last modified date
2018-06-11
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI52730
Modules/Macros
HRFOAPL1 HRFOHAL0 HRFOLEV0 HRFOREO0 HRFOREO3 HRFOREO4 HRFOREO5 HRFOREOD HRFYCCDF HRFYMSGL HRFYMSGT HRFYPRES
Fix information
Fixed component name
IMS ONLINE REOR
Fixed component ID
5655H9701
Applicable component levels
R110 PSY UI52730
UP17/12/19 P F712
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.
[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89V","label":"IMS Online Reorganization Facility"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.0"}]
Document Information
Modified date:
04 October 2020