Activating PSBs in subsets of systems in an IMSplex
If you are changing only PSBs in an IMSplex environment, you can activate the PSBs on a subset of the IMS systems by using the UPDATEPSB option of the IMPORT DEFN SOURCE(CATALOG) command. Later, you activate the PSBs on the other IMS systems in the IMSplex by using the REFRESHPSB option of the command.
Activating the PSBs on only a subset of systems enables programs to continue running with the original PSB on the other systems in the IMSplex while you test the PSB changes on the subset of IMS systems.
You can use the UPDATEPSB option for GSAM DBDs, so that when the IMPORT command is issued with the FOR(IMSID()) keyword, any GSAM DBDs in the staging data set are activated in the IMS directory.
- Updating staged PSBs and GSAM DBDs
- Refreshing pending PSBs
You specify the subset of IMS systems that process the UPDATEPSB or REFRESHPSB option on the FOR(IMSID()) keyword when you issue the IMPORT command. However, for initial routing of the command to specific IMS systems in the IMSplex, you must specify the routing requirements in TSO SPOC or other command interface when you first submit the command.
When the FOR(IMSID()) option is specified, you must route the command to one of the IMS systems that are specified on the FOR(IMSID()) keyword.
Use the UPDATEPSB option when 64-bit storage pools are enabled, IMS loads the old version of the non-resident PSBs into 64-bit storage and mark them as refresh pending on IMS systems that share the directory data sets but are not included on the FOR(IMSID()) keyword. For dynamic option (DOPT) PSBs and for IMS systems without 64-bit storage pools enabled, the effect of the UPDATEPSB option is no different than issuing the IMPORT DEFN SOURCE(CATALOG) command without OPTION(UPDATEPSB) specified.
The previous effects of the UPDATEPSB option also apply to the FOR(IMSID()) keyword without OPTION() keyword specified.
The IMS systems that are not specified in the FOR(IMSID()) keyword when the UPDATEPSB option is specified do not process the IMPORT command so do not reload their in-memory PSB definitions after the modified PSB definitions are imported into the IMS directory. However, after command processing completes, if an IMS system that was not specified on the command is required to reload its in-memory PSB definition from the IMS directory for any other reason, the modified PSB definition will become the active PSB definition in that IMS system.
Usually, the IMS systems that are excluded from the UPDATEPSB option continue to use the original, in-memory PSB definitions until either the IMPORT DEFN SOURCE(CATALOG) OPTION(REFRESHPSB) command is issued for the IMS system or the IMS system is restarted. In-memory PSB definitions that are prevented from reloading when the UPDATEPSB option is specified have a refresh-pending (REFP) status in the IMPORT command response.
To activate the PSB modifications in an IMS system and remove the PSBs refresh-pending status, issue the IMPORT DEFN SOURCE(CATALOG) OPTION(REFRESHPSB) command with the ID of the IMS system specified on the FOR(IMSID()) keyword. The REFRESHPSB option reloads all PSB definitions that have a refresh-pending status in the IMS system.