Information

This site will undergo maintenance on Friday, 26 September at 2:00 AM CDT / 12:30 PM IST and may experience a short period of instability during that time.

NEWDBD


BMC AMI Online Reorg for IMS interprets the NEWDBD keyword differently depending on the utility and whether IMS-managed ACBs are in use. 

This keyword is available in PLUSIN; it is not available as a global option. 

In an IMS-managed ACB environment

You can specify the NEWDBD(STAGE) keyword on several utilities (see the table below). It enables you to change a DBD during a reorganization. For the REORG and UNLOAD utilities, this means performing the changes and producing the resulting data set (unload file or database) in the new format. For the remaining utilities such as RELOAD and Pointer Checker, it simply means to honor the changes present in the staging directory so that these tools can all be run against a changed DBD without having to promote it to the active directory until the end of the reorganization. 

When you are using BMC AMI Online Reorg for IMS  in an IMS-managed ACB environment, the value 'STAGE' of the NEWDBD keyword indicates that the result DBD will be created using the DBD description from the staging directory.   

When using the UNLOAD command, NEWDBD(STAGE) will produce an unload file that honors the DBD definition in the staging directory. 

For all tools that use NEWDBD(STAGE), the active directory will be searched for any required DBDs such as indexes and logical relations that are not present in the staging directory. This is so that any unchanged DBDs do not also have to be regenerated to staging. 

The following table describes how the NEWDBD keyword applies to the various DB utilities: 

 non-IMS managed ACB envirnmentIMS-managed ACB environment
UtilityDefaultDBD ChangesDefaultDBD Changes
UnloadIMS DDNEWDBD(ddn)Active DirectoryNEWDBD(STAGE)
LoadIMS DDnew DBDLIB in IMS DDActive DirectoryNEWDBD(STAGE)
ReorgIMS DDOLDDBD(ddn)Active DirectoryNEWDBD(STAGE)
Index BuildIMS DDnew DBDLIB in IMS DDActive DirectoryNEWDBD(STAGE)
Prefix ResolutionIMS DDnew DBDLIB in IMS DDActive DirectoryNEWDBD(STAGE)
DB CopyIMS DDnew DBDLIB in IMS DDActive DirectoryN/A
DB CloneIMS DDnew DBDLIB in IMS DDActive DirectoryNEWDBD(STAGE)
Pointer CheckerIMS DDnew DBDLIB in IMS DDActive DirectoryNEWDBD(STAGE)
Information
Note

UNLOAD and REORG are the utilities that take the old copy of the DBD and carry out the actual change process. 
Other utilities only indicate that the change has happened, but the changed DBD has not yet been promoted to the active directory. 

In a non-IMS managed ACB environment

The NEWDBD keyword is optional, and only applies to the UNLOAD command. For the REORG command, see the OLDDBD keyword for DBD changes in a non-IMS managed ACB environment. 

For UNLOAD, specify the NEWDBD(ddname) for the ddname where the changed DBDs reside. The resulting output file will honor these changes. 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Online Reorg for IMS 5.1