Creating a platform

Create a CICS® Platform project in the CICS Explorer® to define a platform bundle, which is a type of management bundle that describes a platform. The platform bundle specifies the region types for the platform.

Before you begin

Before you create your CICS Platform project, review your environment and identify how you might map your existing CICS regions to a platform. Alternatively, identify what new CICS regions you might create specifically to use in a platform. For more information, see Platform design.

Set up a platform home directory for the platform in zFS before you create the CICS Platform project. The best practice is to use the default platform home directory, /var/cicsts/CICSplex/platform1, where CICSplex is the name of the CICSplex where the platform will be installed, and platform1 is the name of your platform. If you need to use a different directory as the platform home directory, you can change to the alternative directory name using the platform descriptor editor after you create the CICS Platform project. For instructions to configure the platform home directory, see Creating a platform home directory in zFS.

If you want to deploy CICS bundles at the level of your platform, you can create these ready to add them when you create your CICS Platform project. For example, you can deploy a CICS bundle containing a resource that is required in all the CICS regions in the platform, or a policy that applies to multiple applications deployed on the platform. If you do not yet have any applications, resources, or policies set up for your platform, you can add CICS bundles to the platform after you create it, or at any time after you deploy it. For instructions to create a CICS bundle, see Defining CICS bundles.

About this task

A platform includes one or more region types. Region types are used to classify and contain CICS regions according to their type. For example, all CICS regions that handle connections to DB2® could belong to the same group. You can share CICS regions between region types in the same platform or with region types in other platforms.

You can create new region types to use in the platform. You can also choose to adopt existing CICS system groups (CSYSGRPs) as region types in the platform. A single platform can include both created region types and adopted region types.

Created region types can specify the properties of the CICS regions that they contain. You can clone certain region attribute values for all the CICS regions in a region type by specifying the attributes at a region type level. Only CICS regions whose definitions have the same values specified for those attributes, or have no values specified for those attributes, can be part of that region type. For a list of the attributes that can be specified at a region type level, see Platform design.

If you want to re-implement an existing CICSPlex® SM topology as a platform, you can adopt an existing CICS system group (CSYSGRP) as an adopted region type. Each CSYSGRP that you adopt as part of a platform must meet the requirements listed in Platform design. For example, the group must not contain any subgroups.

For detailed help about the following steps to create a platform, see Working with platforms in the CICS Explorer product documentation.

Procedure

  1. Create a new CICS Platform project in the CICS Explorer. Enter a name for the project, and a name and description for the platform itself. The project location specifies where the CICS Platform project is saved in your local workspace.
  2. Add one or more region types for the platform. Name each region type, then specify whether it is a created region type with a new system group, or an adopted region type using an existing system group. For a created region type, enter a name for the CICS system group (CSYSGRP) that will be created for the region type. To add an existing CICS system group as an adopted region type, you must have a connection to CICSPlex SM.
  3. Optional: Specify any CICS bundles that you want to deploy with the platform, then select the region types where they will be deployed. If you do not have any CICS bundles ready to deploy with the platform, skip this stage.
  4. Click Finish to create the project. When you finish the wizard, the platform project is created in the CICS Explorer workspace.
  5. Use the platform descriptor editor in the CICS Explorer to edit the CICS Platform project to check and complete your specifications for the platform bundle. The platform descriptor editor opens automatically after you create a platform project. To open the platform descriptor editor at a later time, double-click any of the .xml files for the platform bundle, except the manifest.xml file.
    1. If you need to use a different directory instead of the default platform home directory, browse for the home directory that you have set up and specify it as the platform home directory.
    2. Verify your region types, and add or remove created and adopted region types as required. After a platform is installed and active, you can add and remove individual CICS regions in region types. However, you cannot modify the region types in an installed platform, so finalize your region types before installing the platform.
    3. For each of the created region types in your platform, specify any required settings that must apply in all the CICS regions in the region type. Only CICS regions that can accept the required settings can be part of that region type. If your created region type has no special requirements for an attribute, do not specify any value for that attribute, so that any setting is allowed in the CICS regions.
    4. For each of the created region types in your platform, add one or more CICS region definitions for CICS regions that will be part of the region type. A default CICS region definition is provided, which you must replace with a real definition for a CICS region in the created region type. Specify the basic properties for each CICS region, and the created region types where the region will be included.
    5. Verify the CICS bundles that are to be deployed with the platform. Add or remove bundles as required, and verify or change the region types where each CICS bundle is to be deployed. You can deploy further CICS bundles at the level of the platform after you have installed the platform, as you develop your applications and policies.

What to do next

When you have created the CICS Platform project, export it to zFS, set up CICS regions to match each CICS region definition that you created in a region type in your platform, and install the platform in the CICSplex to make it available. For instructions on how to do this, see Deploying a platform.



creating_platform.html | Timestamp icon Last updated: Sunday, 4 June 2017