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
- 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.
- 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.
- 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.
- 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.
- 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.