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
- Use CICS Explorer to
create a CICS Platform project:
- Open the CICS Cloud
perspective.
- In the Project Explorer view, right-click in the window
and click .
- Expand the CICS Resources folder,
click CICS Platform Project and click Next.
- 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.
- Click Add to create a region
type for the platform.
- 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.
- 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.
- Export the CICS Platform
project to zFS:
- In the Project Explorer view, right-click your new CICS Platform project, and select Export
Platform Project to z/OS UNIX File System.
- 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.
- Click Next and use the z/OS
FTP Connection dropdown box to select a suitable connection
to the z/OS® UNIX file system.
- Click Finish to create the home
directory for your platform and export the CICS Platform project to it.
- 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:
- 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.
- In the Cloud Explorer view, right-click and select to open the New Platform Definition wizard.
- In the CICSplex field, verify
that the name of your target CICSplex DEMOPLEX appears.
- In the Name field, enter the
platform definition name DEMOPLAT, and enter
a suitable description in the Description field.
- 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.
- 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.
- Install the platform by right-clicking the platform
definition and clicking Install, then OK. CICSPlex SM installs
the platform in the CICSplex.
- 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.
- 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.
- 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.