This article makes it easier for you to try out the examples in the new IBM Redbooks publication Cloud Enabling CICS (SG24-8114-00).
By following the steps you can:
- Manage a CICS application as a single entity
- Provide automated controls via CICS policies
- Deploy and back-out application versions with no service downtime
- And even deploy multiple versions of the application concurrently
Below are snapshots of the CICS Explorer projects at various stages of the example, along with instructions on how to import them into CICS Explorer.
You can use these projects to quickly jump to the section of the publication you wish to investigate, without needing to start from the beginning.
All you need is the latest version of CICS Explorer.
Download the CICS Explorer project archive files
CloudEnablingCICS_Chapter3_Platform.zip contains the Explorer projects to define the development CICS platform as created by the end of chapter 3.
CloudEnablingCICS_Chapter4_Platform_ApplicationV1.0.0.zip contains the development CICS platform as well as the first version of the CICS application, as created by the end of chapter 4.
CloudEnablingCICS_Chapter5_Platform_Policy_ApplicationV1.0.1.zip contains the development CICS platform and the platform scoped CICS policy. It also contains version 1.0.1 of the CICS application which has been updated to include a CICS policy scoped to the application. These projects are a snapshot by the end of chapter 5.
Preparing for application multi-version support, CloudEnablingCICS_Chapter6_Platform_Policy_ApplicationV1.0.2.zip contains the CICS platform and platform policy along with the next version of the CICS application. Midway through chapter 6 you will create version 1.0.2 of the application which will package the definitions for the application entry points into the application.
CloudEnablingCICS_Chapter6_Platform_Policy_ApplicationV1.100.0.zip contains the CICS platform and policy along with version 1.100.0 of the CICS application. By the end of chapter 6 you have an updated version of the application that can be simultaneously deployed, as version 1.0.2.
Instructions for importing the projects into CICS Explorer
The individual zip files contain a snapshot of all of the Explorer projects, up until that stage of the book. Therefore it is not required to import any preceding chapters, just the point at which you plan to begin from.
Perform the following steps to import the projects contained in the zip file into CICS Explorer:
Download the required zip file to a temporary location on your workstation.
For example C:\temp\CloudEnablingCICS_Chapter4_Platform_ApplicationV1.0.0.zip
Choose Select archive file: and click on the Browse... button next to it.
Locate the zip file in the temporary location that you downloaded in step 1. The project contents of the zip file will display in the Import wizard. Ensure they are all selected (see later instructions in this blog if clashes are found).
Your workspace will contain the projects as created in the relevant chapter of the IBM Redbooks publication "Cloud Enabling CICS".
Customizing the imported projects
The CICS Explorer projects from CICS application version 1.0.2 and upwards (after chapter 5) require customization due to the LIBRARY resource datasets.
Perform the following steps to customise the dataset locations:
Import the required projects into CICS Explorer.
Expand the project general.insurance.customer.applicationservices.to.dev.bundle and double-click on the file GENAAPSV.library to edit the LIBRARY definition resource.
What to do if you get clashes during the import of projects
Importing the projects assumes that they do not already exist in the CICS Explorer workspace. If you do have existing projects then you may get clashes during the import , such as shown below:
You can prevent import clashes by either creating a new workspace before importing the projects, or deleting the existing projects. If you opt to delete the existing projects, then ensure you also delete them from disk in the Delete Resources dialog as shown below:
So does this mean that when I use CICS Cloud resources within my organisation, I need to share and import ZIP files with my colleagues?
No. This articles is using archive files as a simplification for sharing projects with others. For an explanation of how to share CICS Explorer projects within your organisation and incorporating your Source Code Management (SCM), refer to the CICSdev blog CICS Explorer and Source Control.
Download the IBM Redbooks publication Cloud Enabling CICS