Deploying a CICS Application project

Export the CICS® Application project, the Application Binding project, and the associated CICS bundles to z/OS® UNIX, and create an application definition in the CICSPlex® SM data repository.

About this task

When you export the CICS Application project, the CICS Explorer® also exports the Application Binding project and the CICS bundles associated with the application bundle and application binding. The files for the application are exported to the home directory for the platform on zFS. Any CICS bundles that are already deployed to the platform home directory and installed in the CICSplex at the correct version are not included in the export.

The home directory defaults to /var/cicsts/cicsplex_name/platform_name, or is the alternative home directory name that you specified when you set up the platform. In the home directory, the following directories hold the different project resources:
  • applications holds the application bundles exported from CICS Explorer.
  • bindings holds the application bindings exported from CICS Explorer.
  • bundles holds the CICS bundles exported from CICS Explorer. These might be used in applications, or as part of the platform.

The application definition, which is an APPLDEF resource definition, identifies the location of the application bundle in the platform home directory on zFS, and identifies the target platform for the application.

Procedure

  1. In the CICS Cloud perspective, in the Project Explorer view, right-click your Application project or Application Binding project, and click Export Application Project to z/OS UNIX File System or Export Application Binding Project to z/OS UNIX File System. Alternatively, click the link in the Actions list in the application editor or the application binding editor to export the application.
  2. If you started the export process from the application binding project, select the name of the application that you are exporting, and click Next.
  3. Select the CICS SM connection to the target CICSplex using the dropdown box.
  4. Select the application binding for the application that you are exporting. The box is prefilled with the current selection.
  5. To create an application definition following the export, check the box. If you are already connected to z/OS with the appropriate z/OS connection for the export, and none of the CICS bundles in the application project or application binding project are already installed in the CICSplex, you can now click Finish to carry out the export. Otherwise, click Next.
  6. If you clicked Next, select or verify the z/OS connection that you want to use for the export. When you make a selection the connection is established. If none of the CICS bundles in the platform project are already installed in the CICSplex, you can now click Finish to carry out the export. Otherwise, click Next.
  7. If any of the CICS bundles that you specified in the application project or application binding project are already deployed to the platform home directory and installed in the CICSplex at the correct version, the wizard displays an additional page. The page shows the CICS bundles that are already installed, and the platform or application that installed them. These CICS bundles will not be included in the export, but your application can use the CICS bundles that are already installed. If you want to check on any of these CICS bundles or make any changes to the environment before carrying out the export, click Cancel. If the arrangement is correct, click Finish to carry out the export.
  8. The application bundle, application binding, and associated CICS bundles are exported to the home directory of the installed target platform. If you checked the box in the application export wizard, the New Application Definition wizard now opens automatically. To create your application definition at another time, open the CICS Cloud perspective. In the Cloud Explorer view, right-click and select New > Application Definition to open the New Application Definition wizard.
    Tip: You can also access this wizard from the CICS SM perspective. Right-click the CICSplex you want to work with and click New > Other. Expand the CICS Definitions folder and click Application Definition.
  9. In the New Application Definition wizard, enter a name for the application definition in the Name field, which is the name of the APPLDEF resource definition in the data repository. The CICSplex field is automatically populated with the name of the CICSplex you are working with.
  10. In the Platform Definition field, select the name of the platform where you want to install the application.
  11. Enter a description for the application, and supply a version number that matches the version number that you specified for the application project, such as 1.0.0 for the original version.
  12. Verify that the Application Directory and Binding Directory fields contain the names of the subdirectories of the platform home directory where the application project and application binding project were exported. Enter or browse for an alternative directory if necessary. To browse for an alternative directory, choose an active connection to zFS in the z/OS connection field.
  13. Click Finish to create the application definition in the data repository of the CMAS. You can edit the application definition before it is installed, but you cannot edit it after it is installed. Double-click the application definition in the Cloud Explorer view to edit it.

What to do next

Install the application definition to dynamically create the resources from the bundles across the region types in the platform.