Deploying the application

To deploy the application to the platform, export the application to the home directory for the platform, define the application in the data repository, and install the application definition.

Before you begin

You must connect to your CICSplex using the CMCI interface to create resources through the CICS Explorer®.

About this task

An application definition is a CICSPlex® SM resource called APPLDEF. The resource identifies the application bundle and application binding in the home directory for the platform on zFS. When you install the application definition, CICSPlex SM parses the information in the zFS directory, installs the application resource (APPLCTN) in the CMAS, and installs the CICS® bundles in the CICS regions in the platform.

Procedure

  1. Export the CICS Application project to the home directory for the platform on zFS.
    When you export the CICS Application project, the CICS Explorer also exports the CICS Application Binding project that you select, and all the CICS bundles associated with the application bundle and the application binding.
    1. Open the CICS Cloud perspective.
    2. In the Project Explorer view, right-click your CICS Application project java.web.example.application and click Export Application Project to z/OS UNIX File System .
    3. In the Platform box, select the platform that you set up in Configuring the platform. Verify that you have a connection to the target CICSplex, using the dropdown box to select the correct connection if necessary. Then click Next.
    4. Select the application binding that you created for the application, then click Next.
    5. Use the Connection dropdown box to select a suitable connection to the z/OS UNIX file system.
    6. Click Finish to export the CICS Application project, the CICS Application Binding project, and all the CICS bundles associated with them, to the home directory for the platform on zFS.
    The application bundle and the CICS bundles it references are now available in the home directory for the platform on zFS, together with the application binding.
  2. Create the APPLDEF resource in CICSPlex SM to define the application. You can check the box in the export wizard to create an application definition after you export the application. Alternatively, you can create the application definition by following these steps:
    1. Open the CICS Cloud perspective.
    2. In the Cloud Explorer view, right-click and select New > Application Definition to open the New Application Definition wizard.
    3. In the CICSplex field, verify that the name of your target CICSplex DEMOPLEX appears.
    4. In the Name field, enter a name for the APPLDEF resource.
    5. In the Platform Definition field, select the name of the PLATDEF resource DEMOPLAT that you created in Configuring the platform.
    6. Enter a description for the application, and fill in a version number that matches the version number that you specified for the CICS Application project, such as 1.0.0 for the original version.
    7. In the Application Directory field, click Browse... and locate the subdirectory with the name of the application in the home directory for the platform on zFS, to which you exported the CICS Application project.
    8. In the Binding Directory field, click Browse... and locate the subdirectory with the name of the application binding in the home directory for the platform on zFS, to which you exported the Application Binding project.
    9. Click Finish to create the APPLDEF resource definition in the CICSPlex SM data repository.
      The application definition is created. Refresh the Cloud Explorer view, and the application definition name is displayed in the Applications section for the platform.
  3. Install the application by right-clicking on the application definition and clicking Install, then OK.
    CICSPlex SM installs the CICS bundle (or bundles) for the application in the CICS regions in the platform. Refresh the Cloud Explorer view, and the application name appears.
  4. Enable the application by right-clicking on the application name and clicking Enable.
    If the bundle dependencies are met, that is, the JVMSERVER and TCPIPSERVICE resources are available in the CICS regions in the platform, the CICS bundle for the application is enabled.
  5. Start of changeIf you are following the scenario in a CICS region from CICS TS 5.2, you also need to make the installed application available to users of the platform. In the Cloud Explorer view, right-click the application name and click Make Available, then OK to make the application available.
    Alternatively, open the application in the online application editor and click the Make Available button on the Overview tab.
    End of change
Start of change

Results

The application is installed in the platform. Refresh the Cloud Explorer view, and check that the application status displayed is appropriate. Checking the status of an application explains what the displayed status of an application means, and what to do if the application status is not as expected. End of change