Initial IT configuration
The original version of Company A's application is deployed on a platform and available to users, who access the application through a web browser interface.
Figure 1. Initial IT configuration. Projects in CICS Explorer® are used to define a platform and package version 1.0.0
of the application. The application includes a CICS Bundle project
that packages the web application as an OSGi application project contained
in an enterprise bundle archive (EBA). The URIMAP resource for the
application is created in a CICS bundle and deployed with the application
binding. A Liberty JVM server is also defined using a CICS Bundle
project. The projects are exported to subdirectories in the zFS platform
home directory. A platform definition (PLATDEF) and application definition
(APPLDEF) are created for the platform and application, and stored
in the CICSPlex® SM data
repository. The platform definition is installed in the CICSplex to
create a platform with a region type containing the target CICS® region. The application definition
is installed on the platform to create the CICS bundles for version 1.0.0 of the application
in the CICS region. With the
information from the CICS bundles,
the URIMAP resource for version 1.0.0 of the application, named INDEX,
is dynamically generated in the CICS region, and the resources for the web application are deployed
in the Liberty JVM server.

The initial IT configuration includes several components that an
administrator configures or uses, as shown in Figure 1:
- CICS Explorer
- CICS Explorer is used to set up the platform, using a platform project. CICS Explorer is then used to create, export, and install the CICS bundle projects, application bundle, application binding, and application definition for the original version of the application. It is also used to deploy the resource for the Liberty JVM server to the CICS regions that are part of the platform. It is now used to manage the original version of the application.
- In CICS Explorer are the CICS Bundle projects that package version 1.0.0 of the web application, define the Liberty JVM server, and define the URIMAP resource for version 1.0.0 of the application. The Liberty JVM server is deployed at the level of the platform after the platform is created. The URIMAP resource for version 1.0.0 of the application is deployed with the Application Binding project for version 1.0.0 of the application. The CICS Bundle project containing the web application is deployed with the Application project for version 1.0.0 of the application. Only the CICS Bundle project for the web application is shown in the figure, but other application resources could also be packaged using CICS Explorer and deployed with the Application project. For example, the application used in the demonstration has an additional CICS bundle containing the application logic for the web application.
- CICSPlex SM data repository
- The CICSPlex SM data repository contains the application definition (APPLDEF) for version 1.0.0 of the application, and the platform definition (PLATDEF). It also contains the definitions for the CICS regions and the CICSplex that are used in the platform.
- CICS region
- This CICS region, which is part of the platform, handles the workload for the original version of the application, which is presented as a web application hosted in a Liberty JVM server. The resources for the original version of the application are dynamically created in the CICS regions when the CICS bundles for the application are installed there.
- Liberty JVM server
- A Liberty JVM server runs in the CICS region to host the presentation logic for the application. It is defined as a dependency for the application, so that the application presents a warning at install time if the Liberty JVM server is unavailable in a CICS region where install is being attempted. The JVMSERVER resource for the Liberty JVM server is packaged in a CICS bundle using CICS Explorer. The CICS bundle is added to the platform bundle and deployed in each of the CICS regions where the application is to be installed.
- Platform
- The platform is configured using a platform project in CICS Explorer. The platform includes a region type containing the target CICS region where the application is installed. Only one CICS region is shown, but the application could be deployed to multiple CICS regions, if this is specified in the application binding.
- zFS platform home
- The platform home directory on zFS contains subdirectories with the exported application bundle and application binding for the original version of the application. The subdirectory names include the version number for the application and application binding. The application definition (APPLDEF) in the CICSPlex SM data repository references these items in the platform home directory. The exported CICS bundles, including the CICS bundle for the web application, the CICS bundle with the definition for the Liberty JVM server, and the CICS bundle with the definition for the URIMAP resource for the application, are stored in the bundles subdirectory. Any other CICS bundles for the application, such as the application logic bundle used in the demonstration, would also be exported with the application and stored in the bundles subdirectory.