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 Java™ plug-in projects 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 or dynamic
web projects to a CICS bundle project. You add details of the
projects using the Include OSGi Project in Bundle or
Include 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.
Procedure
- In the Package Explorer view, right-click the bundle project
that you want to update, and click to open the New wizard.
- Expand the CICS Resources folder and click Include
OSGi Project in Bundle or Include
Web Project in Bundle. Click Next. The wizard opens and displays the projects of that type
in your workspace.
- Click the plug-in project or dynamic
web 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.
- 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.
- 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.