Activating altered resources when IMS manages ACBs

To introduce altered application programs (PSBs) and databases (DBDs) into online IMS systems when IMS manages ACBs, you submit the updated definitions to IMS, stop the affected resources, and issue the IMPORT DEFN SOURCE(CATALOG) command.

You can use either DDL or IMS generation utility macro instructions to define the altered resources.

The following procedure is for activating modifications that are stored as pending changes in the staging data set. The procedure activates changes in a single online IMS system or, when multiple IMS systems share the resources, in an IMSplex as a whole.

To activate only application program changes in a subset of IMS systems in an IMSplex, see Activating PSBs in subsets of systems in an IMSplex.

To activate only dynamic option (DOPT) PSBs, see Managing DOPT PSBs in IMS-managed ACB environments.

Procedure

To activate altered PSBs, DBDs, or both in online IMS systems when IMS manages ACBs:

Modify the definitions by using either DDL or IMS generation utility macros.
- For more information about modifying definitions with DDL, see Using DDL to define databases and program views.
- For more information about modifying definitions with the IMS generation utilities, see Using the IMS generation utilities to design IMS databases.
Submit the modified definitions to IMS.
- If you use DDL, submit the DDL statements to IMS by using either IMS Enterprise Suite Explorer for Development or the SQL Batch utility.
- If you use generation utility macro statements, after you run the DBD and PSB generation utilities, generate the ACBs and submit the changes to IMS in the same job step by using the ACB Generation and Catalog Populate utility (DFS3UACB) with the MANAGEDACBS=STAGE control statement specified.
If you use DDL, IMS holds the altered DBD and PSB definitions that are not activated automatically as pending changes in the staging data set of the IMS catalog.
If necessary, reorganize the database.
Stop all existing database and program resources that are affected by the changes.
Issue the IMPORT DEFN SOURCE(CATALOG) command.
You can specify OPTION(DELPENDERR) on the IMPORT command to have IMS automatically clean up the staging data set if errors occur during the prepare phase of import processing. Cleaning up the staging data set after errors can help avoid more problems the next time the IMPORT command is issued.
The value of the ACBSHR= parameter that is in effect on the command master IMS system can affect whether the other IMS systems in the IMSplex process an IMPORT DEFN SOURCE(CATALOG) command.
- If ACBSHR=Y is specified in the command master, the IMPORT DEFN SOURCE(CATALOG) command is processed by all IMS systems in the IMSplex that specify ACBSHR=Y and any IMS systems that specify ACBSHR=N, if they are specified on the ROUTE parameter when the command is issued. For IMS systems that specify ACBSHR=N, the IMPORT command succeeds only if the IMS systems have pending ACB changes in the IMS catalog instance that they use.
- If ACBSHR=N is specified on the command master, the command is processed by the command master and by any IMS systems that also specify ACBSHR=N and are specified on the ROUTE parameter. The command is rejected by IMS systems that specify ACBSHR=Y.
The IMS system that serves as the command master is selected by IMS from the IMS systems to which the IMPORT DEFN command was routed.
If you are activating many resources, the IMPORT DEFN SOURCE(CATALOG) command command can take a significant amount of time to complete. To check the status of IMPORT command processing, issue the QUERY MEMBER command.
Restart the affected resources in all IMS systems.