Activating new resources when IMS manages ACBs

To introduce new programs views (PSBs) and databases (DBDs) into online IMS systems when IMS manages ACBs, you submit the updated definitions to IMS and, if the resources are not activated automatically, issue the IMPORT DEFN SOURCE(CATALOG) command.

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

If you use DDL, you can configure IMS to activate new DBDs and the associated PSBs automatically by specifying the AUTOIMPORT(CREATE) parameter in the CATALOG section of the DFSDFxxx PROCLIB member. IMS creates and activates the necessary control blocks. If the required data sets do not already exist, you must create them.

If you use DDL to define Fast Path DEDB databases and specify AUTOCREATE=YES in the CATALOG section of the DFSDFxxx PROCLIB member, IMS creates the data sets for the DEDB areas automatically in addition to creating and activating the DBD and PSB control blocks. You can define the attributes of these data sets in the DDL section of the DFSDFxxx PROCLIB member. When AUTOCREATE=YES is specified, you do not need to specify AUTOIMPORT(CREATE).

The following procedure activates the new resources in all IMS systems that share the same IMS catalog.

Procedure

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

Define the resources by using either DDL or IMS generation utility macros.
- For more information about defining databases and program views with DDL, see Using DDL to define databases and program views.
- For more information about defining DBDs and PSBs with the IMS generation utilities, see Using the IMS generation utilities to design IMS databases.
Submit the 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 are creating a new database with DDL, the new DBD can be activated automatically depending on the automatic activation options in effect in the IMS system. Otherwise, IMS holds the ACBs for new DBDs and PSBs as pending changes in the staging data set of the IMS catalog.
If you are creating a new database, make sure that the following steps are complete, planned for, or are handled automatically by IMS:
- The creation of the database data sets.
- The creation of a PSB to access the new database.
- The creation of the runtime attribute control blocks (DDIRs and PDIRs) in the online IMS systems for the database and application programs.
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.