Deploying a CICS bundle

You can deploy a CICS® bundle by exporting it directly to a z/OS® UNIX System Services (z/OS UNIX) file system from CICS Explorer®. Use a BUNDLE resource to locate the bundle in zFS and dynamically create the resources from the bundle in the CICS region.

About this task

When you have created a CICS bundle in CICS Explorer, you must export it to a z/OS UNIX file system to make it available in CICS.

Note: If you are not authorized to deploy the bundle directly to a z/OS file system, you can export the CICS bundle project as a compressed file to your local file system. For more information, see Exporting a CICS bundle project to your local file system.

Procedure

  1. Navigate to the CICS Project Explorer.
  2. Right-click your CICS bundle project and click Export to z/OS UNIX File System. The Export to z/OS UNIX File System dialog opens.
    A screen capture of the Export to Unix File System dialog. The screen capture shows a parent directory of /u/nbishop/ and a bundle directory of /u/nbishop/Bundle. The name of the Bundle Directory is the parent directory with the bundle name appended.
    The Bundle project field contains the name of your currently selected bundle project. Alternatively, you can type the name of a bundle project in the field or click Browse to select a project.

  3. In the Connection field, select either an existing connection to an FTP port by clicking the twistie, or click the connection text hyperlink to define a new connection of type System z - FTP.
  4. In the Parent Directory field, specify the name of a z/OS UNIX file system directory as a target for the transfer. This can be a new or an existing directory.
  5. Optional: Select the Clear existing contents of Bundle directory check box to remove any folders and files in the target directory before performing the file transfer. If you do not select the check box and a folder by that name exists, the export does not take place.
  6. Click Finish.

Results

The bundle project is exported to the target directory z/OS UNIX.

What to do next

Define and enable a BUNDLE resource for the CICS bundle. See BUNDLE resource definitions in the CICS TS Information Center for more information. When the BUNDLE resource is enabled, CICS reads the manifest in the bundle directory and dynamically creates the CICS resources. It also checks that any dependencies are present in the CICS region.

Note: When you have created and deployed your bundle using the CICS Explorer, you must ensure proper management of the bundle source. The bundle cannot be reconstructed from the exported data in zFS, and a failure of your workstation might cause the data to be lost. You can use the Export function of CICS Explorer to export the bundle and check it in to a source code management system.