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 envirnment | IMS-managed ACB environment | |||
Utility | Default | DBD Changes | Default | DBD Changes |
Unload | IMS DD | NEWDBD(ddn) | Active Directory | NEWDBD(STAGE) |
Load | IMS DD | new DBDLIB in IMS DD | Active Directory | NEWDBD(STAGE) |
Reorg | IMS DD | OLDDBD(ddn) | Active Directory | NEWDBD(STAGE) |
Index Build | IMS DD | new DBDLIB in IMS DD | Active Directory | NEWDBD(STAGE) |
Prefix Resolution | IMS DD | new DBDLIB in IMS DD | Active Directory | NEWDBD(STAGE) |
DB Copy | IMS DD | new DBDLIB in IMS DD | Active Directory | N/A |
DB Clone | IMS DD | new DBDLIB in IMS DD | Active Directory | NEWDBD(STAGE) |
Pointer Checker | IMS DD | new DBDLIB in IMS DD | Active Directory | NEWDBD(STAGE) |
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.
Related topic