Workflow for application deployment

To set up a platform and create applications, follow this process.

About this task

In CICS®, you can set up a platform to deploy and manage applications over multiple CICS regions. Use the CICS Explorer® or the CICS Explorer SDK to create a platform, applications, and policies to manage the applications. To create a platform, you must be using CICSPlex® SM to manage your CICS regions.

Procedure

  1. Create and install a platform. You can use your platform to deploy multiple applications. If you have already set up a platform, skip to Step 2.
    1. Set up a dedicated file system in z/OS® UNIX for your platform home directory, and set up file system security and FTP security. See Creating a platform home directory in zFS.
    2. Create a CICS Platform project to describe the platform. See Creating a CICS Platform project. CICS regions with similar or identical properties can be grouped together as region types in a platform. You can edit the platform project after you create it.
    3. Export the CICS Platform project to the z/OS UNIX file system. See Deploying a CICS Platform project.
    4. Create a platform definition, which is a PLATDEF resource, to reference the platform bundle and define the platform to CICSPlex SM. See Creating a platform definition.
    5. Install the platform definition, and enable the platform. See Installing a platform definition and enabling the platform.
    You have created and enabled a platform. Verify that your platform is available for use; see Checking the status of a platform.
  2. For each application that you want to deploy on the platform, create CICS bundles that define or import the components of the application. The instructions for these tasks are in the section Working with bundles.
    1. Create one or more CICS Bundle projects to contain the resources for each component of the application. See Creating a CICS Bundle project.
    2. Add resource definitions for the application to the CICS bundles. See Adding resources to a CICS bundle. These resources are dynamically created in the CICS regions when you install the application in the platform, and are managed through the CICS bundles. If you need to edit the resource definitions after you have created them, see Editing resources defined in a CICS bundle.
    3. Declare any dependencies on other resources outside the CICS bundles that must be available in the platform for the application to run. See Defining bundle dependencies.
    4. Define application entry points in the CICS bundles for each of the ways in which your application can be used. See Defining application entry points. Application entry points enable CICS to measure and control resource consumption for the tasks for your applications.
  3. Create policies containing policy rules to manage the applications in your platform. Policy rules describe controls or actions that can be applied to one or more application tasks that run within a platform. You can deploy a policy at the platform level to apply to all applications in the platform, or at the application level.
    1. Create one or more CICS Bundle projects to contain your policies. See Creating a CICS bundle project. A CICS bundle can contain more than one policy.
    2. Create policies and specify appropriate policy rules. See Creating a policy in a CICS Bundle project. To add additional rules, see Adding rules to a policy in a CICS Bundle project. To add custom abend codes, see Customizing the abend code in a policy rule.
  4. For each application that you want to deploy on the platform, create and export an application bundle and an application binding.
    1. Create a CICS Application project to package the CICS bundles that contain the application resources, dependencies, and any policies specific to the application. See Creating a CICS Application project. Include the CICS bundles that you created for the components of the application in Step 2.
    2. Create a CICS Application Binding project to specify how the CICS bundles for the application map to the region types in the platform. See Creating a CICS Application Binding project. Include any CICS bundles containing policies that you created in Step 3 and want to deploy for the application. If you prefer to deploy a policy with the platform, do not include its CICS bundle in the CICS Application Binding project, but instead follow the instructions in Adding a bundle to a CICS Platform project to add it to your platform.
    3. Export the application bundle and the application binding to the z/OS UNIX file system. See Deploying a CICS Application project.
  5. Install and enable each application that you want to deploy on the platform.
    1. Create an application definition, which is an APPLDEF resource, to define the application in a specific platform. See Creating an application definition.
    2. Install the application definition, and enable the application so that the application becomes available for use in the platform. See Installing an application definition and enabling the application.
    You have created and enabled a CICS application. Verify that your application is available for use; see Checking the status of an application. Also verify the policy rules that apply to your application; see Querying policy rules.
  6. Monitor and maintain each application in the platform.
    1. If you experience problems with your platform or applications, use the Cloud Explorer view to check on the status of the CICS regions and CICS bundles for the platform, and the CICS bundles for the application. See Checking the status of a platform and Checking the status of an application.
    2. To scale the capacity of your active platform up or down, or modify the architecture of your platform, to support changes in your workload, use the Cloud Explorer view to add CICS regions to region types in the platform or remove them from region types. See Adding CICS regions to a region type and Removing CICS regions from a region type.
    3. As instructed in your policies, CICS automatically monitors and responds to the behavior of the tasks for your applications. You can add and remove policies for your platform while the platform is available; see Adding a bundle to a CICS platform and Removing a bundle from a CICS platform.
    4. Use the application context data generated for your applications to monitor and measure how much resource an application is using. You can also use the information with the transaction tracking capability in the CICS Explorer to identify and diagnose application-related problems.
    5. To modify your applications, edit and reversion the CICS bundles for the components of the application, then update, reversion, and redeploy the application bundle and application binding. See Updating applications.
  7. If you no longer require an application, or if you no longer require your platform, disable and discard the application or the platform.
    1. If you no longer require an application, disable and discard it. See Disabling and discarding an application. When you disable and discard an application, the CICS bundles that are deployed as part of the application are also disabled and discarded from the CICS region types to which they were bound.
    2. If you no longer require a platform, disable and discard it. See Disabling and discarding a platform. When you disable and discard a platform, the CICS bundles that were installed with the platform bundle, including any policies that you deployed on the platform, are also disabled and discarded.