The delivered logical topology
The new version of the application, including the bug fix, is available on the platform and is provided to users automatically in place of the original version.
Figure 1. Delivered logical topology. Projects in CICS Explorer® are used to package version 1.0.1 of the application.
The new application version includes version 1.0.1 of the CICS Bundle
project that defines the resources for the application, and the LIBRARY
resource definition in the CICS® bundle is updated. New subdirectories are created for the new versions
of the application and application binding, but the CICS bundle is stored in the same bundles subdirectory. An application definition (APPLDEF)
is created for version 1.0.1 of the application, and stored in the CICSPlex® SM data repository.
The new application definition is installed on the platform to create
the CICS bundle and resources
for version 1.0.1 of the application in the CICS region. The LIBRARY resource for version
1.0.1 of the application points to a new data set on z/OS® with the programs for version 1.0.1 of
the application. The CICS bundles
and resources for version 1.0.0 of the application are still installed
in the CICS region, but the
TRANSACTION resource, which has not been updated, now points automatically
to version 1.0.1 of the application.

The delivered IT configuration includes several components that
an administrator configures or uses, as shown in Figure 1:
- CICS Explorer
- CICS Explorer is used to package, export, and install the new versions of the CICS bundle project, application bundle, application binding, and application definition. The new version 1.0.1 of the CICS bundle project includes an update to the LIBRARY resource, to point to the data set with the new versions of the programs for the application. The other resource definitions for the application are not changed. The CICS bundle project containing the resource for the CICS transaction also does not need to be updated, because it is deployed separately. CICS Explorer is then used to make the new version of the application available to users. It can also be used to reinstate the older version of the application if required, and to disable or discard it if it is no longer required.
- CICSPlex SM data repository
- The CICSPlex SM data repository contains the application definition for the new version of the application. The name of the APPLDEF resource is the same that was used for the older version's APPLDEF resource, but the version number is changed to match the new version of the application.
- CICS region
- The CICS region now hosts the new version of the application. Private LIBRARY and PROGRAM resources for the new version of the application are dynamically created in the CICS regions when the CICS bundle containing the resources for the new version of the application is installed. The TRANSACTION resource is unchanged.
- Data sets on z/OS
- The new versions of the programs for the application are stored in a different Partitioned Data Set (PDS) or Partitioned Data Set Extended (PDSE) on z/OS. The updated LIBRARY resource for the new version of the application references the new data set.
- Platform
- The platform includes a region type containing the target CICS region where both versions of the application are now installed. Only the newer version of the application is accessible to users through the CICS transaction.
- Transaction
- The CICS transaction that runs the application is not involved with the update process, and it is unchanged. When users run the transaction, CICS automatically provides users with the highest available version of the application, so the program for version 1.0.1 of the application now runs.
- zFS platform home
- The platform home directory on zFS contains the exported CICS bundle, application bundle, and application binding for both versions of the application. New dedicated subdirectories are created for the new versions of the application bundle and the application binding. The new application definition (APPLDEF) in the CICSPlex SM data repository references the directories where the new versions of the application and application binding are exported. The new version of the CICS bundle with the application resources is stored in the bundles subdirectory.