Activating modified PSBs in an initial subset of systems with UPDATEPSB

Use the OPTION(UPDATEPSB) keyword to introduce and activate modified PSBs for the first time in an IMSplex in only a subset of the online IMS systems.

Ensure that the staging data set of the IMS catalog does not contain any database definitions (DBDs) that are waiting to be activated in the IMSplex. If the staging data set contains pending DBD changes, the IMPORT DEFN command fails when the UPDATEPSB or REFRESHPSB option is specified.

Procedure

To activate PSBs in a subset of IMS systems in an IMSplex:

  1. Load modified PSB definitions into the staging data set of IMS catalog
  2. Route workload away from the target IMS systems in which you are activating the PSBs.
  3. Stop affected program resources in the target IMS systems.
  4. In TSO SPOC or the OM API, explicitly route the following command to one or more of the IMS systems that are specified in the FOR(IMSID()) keyword: IMPORT DEFN SOURCE(CATALOG) OPTION(UPDATEPSB) FOR(IMSID()).

    The IMS system that serves as the command master for the UPDATEPSB option must be one of the IMS systems that are specified in the FOR(IMSID()) keyword. Routing the command to one of the specified systems ensures one of them acts as the command master.

    Upon processing the command, the modified PSBs are activated in the IMS systems that are specified on the FOR(IMSID()) keyword. In the IMS systems that are not specified on the FOR(IMSID()) keyword, the original definitions of the PSBs are still used, but the PSBs show a status of refresh-pending (REFP).

  5. Restart the affected resources in the target IMS systems.
  6. Test the new program definitions in the target IMS systems.
  7. When testing is complete, resume workload on the target IMS systems with the new PSBs.
When you are ready to activate the modified PSBs in the other systems in the IMSplex, follow the procedure in Activating modified PSBs in subsequent subsets of systems with REFRESHPSB.