Configuring the platform

Configure a platform to make services available to CICS® applications.

Before you begin

You must be using CICSPlex® SM to manage your CICS regions. You must have connected to your target CICSplex using the CMCI interface through CICS Explorer®.

In your target CICSplex, you must have a CICS system group (CSYSGRP) that meets the following requirements:
  • The group has not already been adopted by a platform.
  • The group does not contain any subgroups.
  • The group will not require modification (for example, a group that is involved in WLM or RTA). Platforms require a lock on the groups that are used as region types.
  • The CICS regions in the group have the CICSPlex SM system parameter MASPLTWAIT(YES) specified. This parameter is also required for Business Application Services.
If you do not have a CSYSGRP that meets these requirements, create a new one to use with this scenario.

CICS Explorer can generate the zFS directory structures that you require for your platform home directory. To create a suitable data set, and set up file system security and FTP security, see Preparing zFS for platforms.

About this task

To set up a platform, you create a CICS Platform project and export it to zFS, then you create a platform definition to define the platform to CICSPlex SM. A platform definition is a CICSPlex SM PLATDEF resource definition, which identifies the platform bundle that you defined using the CICS Platform project. When you install the platform definition, CICSPlex SM creates the platform within the CICSplex.

The platform provides services to CICS applications. In this scenario, the CICS regions in the platform must provide a JVM server and TCP/IP service to run a Java™ application and access it from the web.

You can use CICS Explorer or the CICS Explorer SDK for the steps in the following procedure.

Procedure

  1. Use CICS Explorer to create a CICS Platform project:
    1. Open the CICS Cloud perspective.
    2. In the Project Explorer view, right-click in the window and click New > Project.
    3. Expand the CICS Resources folder, click CICS Platform Project and click Next.
    4. Enter the project name my.demo.platform, and change the description if you want. The default location is generated for the home directory for your platform on zFS. Click Next.
    5. Click Add to create a region type for the platform.
    6. In the Add a Region Type panel, specify the region type name demo.platform.AOR.regiontype. Use the CICS SM connection dropdown box to select the connection to your target CICSplex, such as DEMOPLEX, and select the name of this CICSplex in the CICSplex field. Then select the name of your existing CICS system group in the CICSplex that contains the target CICS regions, such as CSYSGRP1. Click OK.
    7. Click Next. You do not need to deploy any CICS bundles with the platform bundle, so click Finish. The CICS Platform project is created as a new project in the Project Explorer view. When you install the platform, it will adopt the existing CICS system group that you specified as a region type for the platform, so all the CICS regions in the system group will be part of the platform.
  2. Export the CICS Platform project to zFS:
    1. In the Project Explorer view, right-click your new CICS Platform project, and select Export Platform Project to z/OS UNIX File System.
    2. Select the name of your target CICSplex. If the name of your target CICSplex is not shown, use the CICS SM Connection dropdown box to select your connection to the target CICSplex. Verify the location for the platform home directory, /var/cicsts/DEMOPLEX/my.demo.platform, where DEMOPLEX is the name of your target CICSplex and my.demo.platform is the name of your CICS Platform project. Also verify the location for the platform directory, where the CICS Explorer will export the CICS Platform project. The platform directory will be a subdirectory in the home directory displayed here. The default location for the platform directory is /var/cicsts/DEMOPLEX/my.demo.platform/platform/my.demo.platform, where DEMOPLEX is the name of your target CICSplex and my.demo.platform is the name of your CICS Platform project. The CICS Explorer will create other subdirectories to contain the applications, bindings, and bundles that will be deployed into the platform.
    3. Click Next and use the z/OS FTP Connection dropdown box to select a suitable connection to the z/OS® UNIX file system.
    4. Click Finish to create the home directory for your platform and export the CICS Platform project to it.
  3. Create a platform definition in the CICSplex. You can check the box in the export wizard to create a platform definition after you export the platform. Alternatively, you can create the platform definition by following these steps:
    1. In the Cloud Explorer view in the CICS Cloud perspective, verify that the name of your target CICSplex, DEMOPLEX, where you want to set up your platform, appears in the CICSplex field. Otherwise, use the drop-down box to select the correct CICSplex.
    2. In the Cloud Explorer view, right-click and select New > Platform Definition to open the New Platform Definition wizard.
    3. In the CICSplex field, verify that the name of your target CICSplex DEMOPLEX appears.
    4. In the Name field, enter the platform definition name DEMOPLAT, and enter a suitable description in the Description field.
    5. Click Browse... and locate the CICS Platform project in the platform subdirectory of the home directory for the platform. The location for the CICS Platform project is /var/cicsts/DEMOPLEX/my.demo.platform/platform/my.demo.platform, where DEMOPLEX is the name of your target CICSplex and my.demo.platform is the name of your CICS Platform project.
    6. Click Finish to create the PLATDEF resource definition in the CICSPlex SM data repository. The platform definition is created. Refresh the Cloud Explorer view, and the platform definition name is displayed.
    7. Install the platform by right-clicking the platform definition and clicking Install, then OK. CICSPlex SM installs the platform in the CICSplex.
    8. Refresh the Cloud Explorer view, and the platform name appears. Because you did not install any additional CICS bundles with the platform, the platform is now active.
    If you are using these instructions to set up a platform to use with the scenario Updating an application on a platform or the scenario Hosting two versions of a CICS application concurrently on the same platform, do not create JVMSERVER and TCPIPSERVICE resources as described in the following steps. Instead, return now to the instructions for the scenario that you are following.
  4. As a service for the application that you will deploy later in this scenario, create and install a JVMSERVER resource in all the CICS regions that are part of your platform. You can install the DFHJVMS resource, which is in the sample CSD group DFH$OSGI, or create your own resource in the data repository for the CICSplex. For details of how to set up a JVM server, see Setting up a JVM server.
  5. As a service for the application that you will deploy later in this scenario, create and install a TCPIPSERVICE resource in all the CICS regions that are part of your platform. Set the PROTOCOL attribute to HTTP and the PORT attribute to a port number that is free. If you are including more than one region in your platform, you must use a different TCPIPSERVICE in each region to open all ports at the same time.

Results

You created the platform and provided the services that are required by the Java web example.

What to do next

Package the Java web example as a CICS application.


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