Migrating from an earlier IMS 15 release

Because all releases of IMS within the version IMS 15 use a single set of SMP/E function modification identifiers (FMIDs), you do not need to perform a full installation of IMS to migrate from an earlier release of IMS 15 to IMS 15.2. Instead, you apply APAR/PTFs to migrate to IMS 15.2 if you are already using IMS 15.

IMS 15.6 requires that IMS Managed ACB is enabled to start IMS for TM/DB and DBCTL users. The IMS catalog must be set up for Managed ACBs and the DFSDFxxx PROCLIB member used by the online IMS must include a catalog section that has CATALOG=Y and ACBMGMT=CATALOG specified.

Users of DCCTL are not required to implement IMS Managed ACBs and can continue to use ACBLIBs for their DCCTL regions. DCCTL users that share ACBLIBs with DB/TM systems can continue to use the ACBLIBs or they can share the IMS catalog directory created by the DB/TM systems. This is described here: DCCTL enhancement to support IMS management of ACBs.

You can migrate to IMS 15.2 from an earlier release of IMS 15 by applying the PTFs for APAR PH16682 and APAR PH23298 to update the IMS installed level that is displayed in select output. After you apply the PTFs for APAR PH16682 and APAR PH23298, the installed level (that is, the version, release, modification level of the IMS system) is updated from the earlier release of IMS 15 to IMS 15.2.

Procedure

The general steps for migrating to IMS 15.2 from an earlier release of IMS 15 are as follows:

  1. Shut down the IMS system.
  2. Apply the PTFs for APAR PH16682 and APAR PH23298 for the FMIDs in your IMS installation.
  3. Restart the IMS system.

    If you are migrating from an earlier system that was the active system in an XRF complex, you must cold start the system after migration.

    If you are migrating from an earlier system that was not the active IMS system in an XRF complex, you do not need cold start the system after migration. You can warm start the system instead.

  4. Perform PTF-level testing.
  5. Check the output of the following messages, commands, and log records to confirm that the IMS version number is updated to IMS 15.2:
    • Messages DFS1929I and DFS4878I.
    • The QUERY IMSFUNC and QUERY IMSPLEX commands.
    • The output page header for DBRC commands.
    • The X'42' and X'4500' log records.

    The IMS installed level is updated to 15.2 in the SCDINLVL control block field and in the &DFSLEVIN macro variable set by IMS macro DFSLEVIN. Output locations, including those in the preceding list, that reference the SCDINLVL control block field are updated to 15.2. However, because the IMS installed level that is specified in the SSCDIMSR control block field and the DFSLEV constant is not changed, the output locations that reference SSCDIMSR or DFSLEV will continue to display 15.1 (the IMS base level) even after you apply APAR PH16682.