The following procedure describes the general tasks you must perform for record format conversions:
-
Modify the database description.
Insert the UPDATE statement in front of the database description. This statement instructs the DASDL compiler to update the existing database description, creating a new description file.
The tables in Update, Reorganization, and Modeling Capabilities and Limitations indicate the database changes allowed during a record format conversion.
-
Compile the database description.
-
Run the BUILDREORG program using the database description file produced in step 2. This action creates a reorganization description file.
-
Generate the Reorganization program using the reorganization description file produced in step 3.
-
Compile the DMSUPPORT library using the new database description file produced in step 2. The title of the new DMSUPPORT library must include the new update level of the database. For example, if the new database update level is 2, and the database is not a permanent directory database, the title is DMSUPPORT/<database name>/2. If it is a permanent directory database, the default title is <path name>/DMSUPPORT/<database name>/2. If you set the compiler control option to ZIP, this step occurs automatically.
The new database description file contains information about both the new and the old record formats.
-
If any user programs invoke the reorganized structures directly, the programs must be recompiled. If a user program does not invoke any reorganized structures, the user program can still access the database during the reorganization run.
When items are deleted, all references to these items must be removed from user programs.
Programs that invoke remaps of any reorganized structures need not be recompiled as long as the remap record format remains the same.
-
Run the Reorganization program. Make sure that both the new and the old DMSUPPORT library, as well as the new database description file produced in step 2, are present.
The Reorganization program reads the old data set, set, or subset and generates a new one in the new format. When the Reorganization program run is complete, the new structure replaces the old structure, and the old structure is removed.
