Adding a project to a CICS bundle project

When you create a CICS® bundle project, the project contains only a manifest file and a properties file. You must add details of any projects that you want to include in the CICS bundle before you deploy everything to zFS. You can add OSGi projects, OSGi applications, or dynamic web projects to a CICS bundle project.

The projects are not included in the bundle project, but a reference is made to them. When the bundle project is deployed to zFS, the Java™ plug-ins are compiled, and all the projects are exported at the same time.

Before you begin

This task describes how to add details of a project to a CICS bundle. If you have not created a CICS bundle project, see Creating a CICS bundle project.

About this task

You can add OSGi projects (either Eclipse plug-in projects or OSGi bundle projects created with WebSphere® Application Server Developer Tools for Eclipse (WDT)), OSGi application projects, or dynamic web projects to a CICS bundle project. You add details of the projects using the Include OSGi Project in Bundle, Include OSGi Application Project in Bundle, or Include Dynamic Web Project in Bundle wizard. The wizard updates the bundle manifest file to include details of the project that is being added, and creates a resource file with a file extension .osgibundle or .warbundle that points to the project.
Notes:
  1. To add OSGi applications to a bundle project, by using the Include OSGi Application Project in Bundle wizard, you must have APAR PM80214 applied.
  2. To add OSGi bundles that are not included in an OSGi application project to a CICS bundle project. you must have a build.properties file that includes the location of the output folder. For example, the build.properties file might have the following content:
    source.. = src/
    output.. = bin/
    bin.includes = META-INF/,\

Procedure

  1. In the Package Explorer view, right-click the bundle project that you want to update, and click New > Other to open the New wizard.
  2. Expand the CICS Resources folder and click Include OSGi Project in Bundle, Include Dynamic Web Project in Bundle, or Include OSGi Application Project in Bundle. Click Next. The wizard opens and displays the projects of that type in your workspace.
  3. Click the project to include in the bundle. When you click the project, the wizard displays the symbolic name, and the version when applicable. In the JVM Server field, enter the name of the JVM server where the application component is going to run. If you are not running the application in a JVM server, enter any 8 characters in the field.
  4. Optional: The name of the resource file that is created is generated from the project name and is displayed in the wizard. You can use the Back button to change the file name.
  5. Click Finish.

Results

A project resource file is added to the bundle project and the manifest file is updated. You can repeat these steps to add more projects to the CICS bundle project.

What to do next

You can add resources to the CICS bundle project for your application. For example, you can create a program to make your Java application available to other applications in CICS.

You can deploy your CICS bundle to a z/OS® UNIX file system, as described in Deploying a CICS bundle. When the CICS bundle project is exported to zFS, all the files and artifacts needed for the application are compiled and exported.

Alternatively, you can package your CICS bundle project in a cloud-style application project for deployment into a CICS platform. By using an application project, you can group together all the CICS bundle projects that comprise your application and deploy and install them in a single step. For more information, see Creating a CICS Application project.