What's new in IMS Online Reorganization Facility

This topic summarizes the technical changes for this edition.

New and changed information is denoted by carets (Symbol that indicates the start of new or changed content and Symbol that indicates the end of new or changed content) at the beginning and end of the new or changed information. Editorial changes that have no technical significance are not noted.

Revision markers follow these general conventions:

  • Only technical changes are marked; style and grammatical changes are not marked.
  • If part of an element, such as a paragraph, syntax diagram, list item, task step, or figure is changed, the entire element is marked with revision markers, even though only part of the element might have changed.
  • If a topic is changed by more than 50%, the entire topic is marked with revision markers (so it might seem to be a new topic, even though it is not).

Revision markers do not necessarily indicate all the changes made to the information because deleted text and graphics cannot be marked with revision markers.

Start of change

SC27-9039-11 (April 2024)

Description Related APARs
Support adding secondary indexes when IMS manages ACBs
For more information, see DBD change feature in an IMS-managed ACBs environment.
 PH59732
End of change

SC27-9039-10 (February 2024)

Description Related APARs
Allow negative value in the RELOAD.SEARCH keyword
See the updated syntax diagram of the RELOAD.SEARCH keyword.
 PH59278

SC27-9039-09 (December 2023)

Description Related APARs
Discard changes made during database initialization
IMS Online Reorganization Facility has been enhanced to support an option to discard changes made during database initialization.
For more information, see INITIALIZE keyword.
 PH57885

SC27-9039-08 (September 2023)

Description Related APARs
Database data sets (DBDS) organization conversion support
IMS Online Reorganization Facility has been enhanced to support DBDS organization conversion.
IMS Online Reorganization Facility supports the following conversions:
  • OSAM to OSAM LDS
  • VSAM to OSAM
  • VSAM to OSAM LDS
IMS Online Reorganization Facility provides the following new functions to support the conversion:
  • DDEFPDS2 DD support
  • NEWDBD and DDEFPDS2 DD combination support
For more information, see the following topics:
PH54781

SC27-9039-07 (April 2023)

Description Related APARs
Allow specifying allocation value for temporary unload data set per job
New keywords, UNLSPAC and UNLUNIT, have been added to allow specifying allocation value for temporary unload data set per job. For more information, see the following topics:
PH49853

SC27-9039-06 (July 2022)

Description Related APARs
Reorganize the IMS catalog
IMS Online Reorganization Facility has been enhanced to support reorganization of the IMS catalog.
IMS catalog databases are deleted from a list of databases that are not supported.
 PH46904

SC27-9039-05 (April 2022)

Description Related APARs
Run a read-only reorganization job for an index
A new option to run a read-only reorganization job for an index has been added. The new keyword, READONLY(Y), is effective only for index reorganization. For more information, see READONLY keyword.
Reorganize a single or selected partitions of a non-recoverable PSINDEX database
The new TEMPRECOV(Y) keyword reorganizes a single or selected partitions of a non-recoverable PSINDEX database. For more information, see TEMPRECOV keyword.
PH43854

SC27-9039-04 (December 2021)

Description Related APARs
Create a batch image copy of a database using a new IMAGECOPY command
This APAR enables IMS Online Reorganization Facility to create a batch image copy of a database using a new IMAGECOPY command with minimal impact to database availability.
For more information, see the following topics:
PH41091

SC27-9039-03 (September 2021)

Description Related APARs
Reorganize databases with external logical relationships
Support online reorganization of databases that have external logical relationships.
In order to reorganize multiple databases in parallel, IMS Online Reorganization Facility initiates multiple subordinate address spaces. Each subordinate address space is a started task that executes the subordinate address space procedure named HRFSUB, so this procedure must be placed in your PROCLIB data set before running the reorganization job. For more information, see the following topics:
PH33045
Message HRF01617W has been modified. PH35989
Message HRF01163E has been modified. PH38867

SC27-9039-02 (April 2020)

Description Related APARs
Specify whether to allow read-only DL/I batch jobs to access the database
A new keyword, READON, has been added. You can use this keyword to specify whether to allow read-only DL/I batch jobs to access the database which the IMS Online Reorganization Facility job is processing. This enhancement enables IMS Online Reorganization Facility to minimize impacts to DL/I batch jobs during reorganization. For more information, see READON keyword.
 PH04466
Unload a database that has external logical relationships
IMS Online Reorganization Facility has been enhanced to support unloading HISAM, HIDAM, HDAM, SHISAM, PHDAM, and PHIDAM databases while the database remains online. It can unload a database that has logical relationships (including external logical relationships), but when it unloads logical child segments whose logical parent's concatenated keys (LPCKs) are virtual, it does not retrieve the LPCKs.
 PH10454
Reorganize encrypted VSAM databases
A new keyword, KEYLABEL, and a new base configuration parameter, LOGKYLBL, have been added. This enhancement enables IMS Online Reorganization Facility to reorganize encrypted VSAM databases and to dynamically allocate encrypted data sets for image copy and apply log. For more information, see the following topics:
PH11473
Support IMS management of ACBs
IMS Online Reorganization Facility has been enhanced to support the IMS management of ACBs.
When the IMS management of ACBs is enabled, IMS Online Reorganization Facility can refer to database definitions in the IMS catalog directory instead of the DBD library. If you want to change the database definition in a reorganization job, you can specify the NEWDBD(*STAGING) keyword to have IMS Online Reorganization Facility reload the database using pending database definitions in the IMS catalog staging data sets. For more information, see the following topics:
PH11847

SC27-9039-01 (September 2018)

Description Related APARs
Allocate GDG data sets as log data sets
IMS Online Reorganization Facility can allocate GDG data sets as log data sets. For more information, see the following topics:
PH00388
Rebuild PSINDEXes during HALDB reorganization
If you specify the PSINDEXBLD keyword, IMS Online Reorganization Facility rebuilds PSINDEXes during HALDB reorganization. For more information, see the following topics:
PI89625
Initialize the database during reorganization
A new keyword, INITIALIZE, has been added. You can use this keyword to initialize (empty out) the database during reorganization. For more information, see INITIALIZE keyword.
 PI90523
Enhancement to the conditional reorganization capability
Three new keywords, CR.EVALINDEX, CR.IC, and CR.UNLOAD, have been added. These keywords enhance the conditional reorganization capability. For more information, see the following topics:
PI91880
Other documentation changes
New topic Applying maintenance has been added. Follow the instructions in this topic to apply maintenance to IMS Online Reorganization Facility when the maintenance requires refreshing the IMS Online Reorganization Facility load modules in online systems.
 N/A