Altering the definition of a DMB verification-enabled online DEDB by using the DEDB Alter utility (DBFUDA00)

When you alter the definition of an online DEDB database that has DMB verification turned on by using the DEDB Alter utility (DBFUDA00) of IMS™, you must stop the DMB verification process and then restart the DMB verification process after the DEDB is altered.

About this task

When you use the DEDB Alter utility (DBFUDA00) to alter the definition of an online DEDB, you must temporarily stop the DMB verification process. After the new definition is applied to the online database, restart the DMB verification process with the new RDEs that contain the new definition. Without these steps, the DMB verification process uses the old definitions to verify the DMBs. Therefore, the DMB verification process might deny database authorization requests that use correct IMS control blocks.

Note: The DEDB Alter utility is supported in IMS Version 13 and later.

The following figure shows the steps to alter the definition of an online DEDB that has DMB verification turned on.

Figure 1. Steps to alter an online DEDB that has DMB verification turned on

1. Run the DBDGEN procedure with the new definition to update the DBD member in the DBD library with the new database structure.
2. Run the ACBGEN utility to update the ACB member that is in the staging ACBLIB.
3. Use the LICON utility of the Integrity Checker utility to stop the DMB verification process. To do so, issue one of the following LICON utility commands:

   Changed definition	LICON utility command
   Altering a DEDB area	CHANGE.DB DBD(dbname) AREA(areaname) CHECKON(N)
   Replacing the randomizer	CHANGE.DB DBD(dbname) CHECKON(N)

4. Run the DEDB Alter utility to apply the changes to the online DEDB.

   The new DBD definition is applied to the ACBLIB and is used to access the altered database.

   For more information about the DEDB Alter utility, see the topic "DEDB Alter utility (DBFUDA00)" in IMS Database Utilities.

5. Use the LICON utility of the Integrity Checker utility to re-create the RDEs to reflect the new definition and start the DMB verification process. To do so, issue one of the following LICON utility commands:

   Changed definition	LICON utility command
   Altering a DEDB area	INIT.DB DBD(dbname) AREA(areaname) CHECKON(Y,D) REPLACE
   Replacing the randomizer	INIT.DB DBD(dbname) CHECKON(Y,D) REPLACE

   The DMB verification process starts and uses the new DBD definition.