To deploy the application to the platform, export the application
to the home directory for the platform, define the application in
the data repository, and install the application definition.
Before you begin
You must connect to your CICSplex using the CMCI interface
to create resources through the CICS Explorer®.
About this task
An
application definition is a CICSPlex® SM resource called APPLDEF. The resource identifies the application
bundle and application binding in the home directory for the platform
on zFS. When you install the application definition, CICSPlex SM parses the information in the zFS directory, installs the application
resource (APPLCTN) in the CMAS, and installs the CICS® bundles in the CICS regions in the platform.
Procedure
- Export the CICS Application
project to the home directory for the platform on zFS.
When you export the CICS Application
project, the CICS Explorer also exports the CICS Application
Binding project that you select, and all the CICS bundles associated with the application
bundle and the application binding.
- Open the CICS Cloud perspective.
- In the Project Explorer view, right-click your CICS Application project java.web.example.application and click Export
Application Project to z/OS UNIX File System .
- In the Platform box, select the platform that you set
up in Configuring the platform. Verify that
you have a connection to the target CICSplex, using the dropdown box
to select the correct connection if necessary. Then click Next.
- Select the application binding that you created for
the application, then click Next.
- Use the Connection dropdown box
to select a suitable connection to the z/OS UNIX file system.
- Click Finish to export the CICS Application project, the CICS Application Binding project,
and all the CICS bundles associated
with them, to the home directory for the platform on zFS.
The application bundle and the CICS bundles it references are now available
in the home directory for the platform on zFS, together with the application
binding.
- Create the APPLDEF resource in CICSPlex SM to define the application. You can check the box in the export wizard
to create an application definition after you export the application.
Alternatively, you can create the application definition by following
these steps:
- Open the CICS Cloud perspective.
- In the Cloud Explorer view, right-click and select to open the New Application Definition wizard.
- In the CICSplex field, verify
that the name of your target CICSplex DEMOPLEX appears.
- In the Name field, enter a name
for the APPLDEF resource.
- In the Platform Definition field,
select the name of the PLATDEF resource DEMOPLAT that you created in Configuring the platform.
- Enter a description for the application, and fill in
a version number that matches the version number that you specified
for the CICS Application project,
such as 1.0.0 for the original version.
- In the Application Directory field,
click Browse... and locate the subdirectory
with the name of the application in the home directory for the platform
on zFS, to which you exported the CICS Application project.
- In the Binding Directory field,
click Browse... and locate the subdirectory
with the name of the application binding in the home directory for
the platform on zFS, to which you exported the Application Binding
project.
- Click Finish to create the APPLDEF
resource definition in the CICSPlex SM data repository.
The application definition is
created. Refresh the Cloud Explorer view, and the application definition
name is displayed in the Applications section for the platform.
- Install the application by right-clicking on the application
definition and clicking Install, then OK.
CICSPlex SM installs the CICS bundle
(or bundles) for the application in the CICS regions in the platform. Refresh the Cloud Explorer view,
and the application name appears.
- Enable the application by right-clicking on the application
name and clicking Enable.
If the bundle dependencies are met, that is, the JVMSERVER and TCPIPSERVICE
resources are available in the CICS regions in the platform, the CICS bundle for the application is enabled.
- If you are following the scenario in a CICS region from CICS TS 5.2, you also need to make the installed
application available to users of the platform. In the Cloud Explorer
view, right-click the application name and click Make Available, then OK to make the application available.
Alternatively, open the application in the online application
editor and click the Make Available button
on the Overview tab.
Results
The application is installed in the platform. Refresh
the Cloud Explorer view, and check that the application status displayed
is appropriate. Checking the status of an application explains
what the displayed status of an application means, and what to do
if the application status is not as expected.