Adding a plug-in 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 CICS plug-ins that you want to include in the bundle before you deploy everything to zFS. The plug-ins are not included in the bundle project, but a reference is made to them. Consequently when the bundle project is deployed to zFS, the plug-ins are exported at the same time.

About this task

You add details of the plug-in projects using the Include OSGi Project in Bundle wizard. The wizard updates the bundle manifest file to include details of the plug-in that is being added, and creates a resource file with a file extension .osgibundle that points to the plug-in. This task describes how to add details of plug-in projects to a CICS bundle. If you have not created a CICS bundle project, see the topic Creating a CICS bundle project.

Procedure

  1. In the Package Explorer view, locate the bundle project that you want to add the plug-in to, right-click and click New > Other to open the New wizard.
  2. Expand the CICS Resources folder and click Include OSGi Project in Bundle. Click Next. The Include OSGi Project in Bundle wizard opens and displays all the plug-in projects in your workspace.
  3. Click the plug-in project to include in the bundle. When you click the project, the plug-in symbolic name and version are displayed in the OSGi Bundle directive section in the wizard. In the JVM Server field, enter the name of the JVM server that the OSGi bundle will be installed into. If you are not running the application in a JVM server, for example you are running in a JVM POOL environment, enter any 8 characters in the field.
  4. Optional: Optional: The name of the resource file that is created is generated from the plug-in 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 now deploy your bundle to a z/OS® UNIX file system. For more information, see the topic Deploying a CICS Bundle project. When the bundle is exported to zFS, all the files and artifacts needed for the CICS Java application, or applications, that are defined in the bundle are exported.