Deploying a CICS non-OSGi Java application

The Java™ applications are included in a CICS® bundle and can be deployed to a z/OS® UNIX System Services (z/OS UNIX) file system using CICS Explorer®, or using the CICS provided Gradle or Maven plug-in.

About this task

This task outlines the steps to deploy a non-OSGi Java application. The process is the same as for an OSGi application; the only difference is that CICS uses the application JAR file instead of the bundle.

If you're using CICS Explorer: You can use the IBM® CICS SDK for Java and the IBM CICS SDK for Enterprise Java (Liberty) in CICS Explorer to deploy bundles by following instructions in this topic. When you are not authorized to deploy the bundle directly to a z/OS file system, you can export the bundle as a compressed file. For more information, see Exporting a CICS bundle project to your local file system in the CICS Explorer product documentation
If you're using Gradle or Maven: You can package and deploy applications in CICS bundles by using the CICS-provided Gradle or Maven plug-in, provided the CMCI JVM server is configured to use the CICS bundle deployment API.

This tutorial provides step-by-step instructions on how to build a CICS bundle from an existing Java application that is already built by Gradle or Maven.

Procedure

  1. Convert the Java application to a plug-in project.
  2. Add the plug-in project to a CICS bundle.
    Follow the instructions in Adding a project to a CICS bundle project.
  3. Deploy the bundle project to a z/OS Unix file system.

Results

The Java application is exported to z/OS UNIX. The exported bundle includes the application JAR files.