Deploying a CICS Platform project

You can deploy a platform bundle by exporting the CICS® Platform project to z/OS® UNIX. Define and install the platform to dynamically create the resources from the bundles across the regions in the platform.

About this task

After you have created a CICS Platform project, you export the Platform project to z/OS UNIX to install the platform in CICSPlex® SM. The export process packages the CICS bundles that are referenced in the Platform project and deploys all the files to the target directory in z/OS UNIX. During the export, the wizard checks that the directories of the platform exist. For example, the wizard checks for the /applications, /bundles, and /bindings directories, if they are defined in the platform.xml file, and creates them if they do not exist.

Procedure

  1. In the CICS Project Explorer Right-click your Platform project and click Export Platform Project to z/OS UNIX File System. The "Export platform" window opens.
  2. Click a radio button to specify how you want to export the platform. You can select from the following export choices:
    • Export this platform and its CICS bundles to the home directory of a platform. If you select this choice, complete steps a through e.
    • Export to a specific location. If you select this choice go to step 3 and complete steps 4 through 9.
    1. Select the platform that you want to export. This field is prefilled with the current selection, if applicable.
    2. Select the destination CICSplex for the export. The platform home directory location is displayed.

      The wizard validates whether a platform with the same platform home directory is installed or not. If the platform exists the export fails.

    3. Click Next.
    4. Select the FTP connection that you want to use for the export. When you make a selection the connection is established, and the wizard checks for the bundles, applications, and bindings subdirectories of the platform home directory by using the FTP connection. If they do not exist, the wizard creates the folders and exports the platform bundle and associated CICS bundles to the right place.
    5. Click Finish.
  3. In the Platform Project field, specify your project. You can use the currently selected Platform Bundle project, you can type the name of another project, or you can click Browse to select a different project.
  4. In the z/OS FTP connection field, either expand the twistie to select an existing connection to an FTP port, or click System z - FTP to set up a System z FTP connection.
  5. In the Parent Directory field, specify the name of a z/OS UNIX file system directory as a target for the transfer. This directory name can be a new or an existing directory.
  6. Optional: Type over the directory name to change it. The Platform Directory field shows the target directory for the exported platform bundle. By default, the directory name uses the platform ID.
  7. Optional: Select the Clear existing contents of Platform directory check box to remove any folders and files in the target directory before transferring the file. If you do not select the check box and a folder or file with the same name exists, the export fails.
  8. Click Finish.

Results

The platform bundle and associated CICS bundles are exported to the target directory in z/OS UNIX.

What to do next

Create a platform definition to deploy the platform into the CICSplex.