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: - To add OSGi applications to a bundle project, by using the Include
OSGi Application Project in Bundle wizard, you must have APAR PM80214
applied.
- 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
- 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, 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.
- 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.
- 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.