Updating the application binding

Use the CICS Explorer® to update the resources in the CICS bundles that are deployed with the application binding, specify deployment regions for the new versions of the CICS bundles for the application, and re-version the application binding.

Procedure

  1. In the Project Explorer view, update the CICS® bundle where the URIMAP resource for the application is defined.
    1. Rename the URIMAP resource that is defined in the CICS bundle, using a name that indicates the new version of the application. In the application used in the demonstration, the URIMAP resource is renamed to INDEX11.
    2. Edit the URIMAP resource that is defined in the CICS bundle to specify the path for the web page presented by the new version of the application. In the application used in the demonstration, the path is changed to /demo.liberty.appV1.1/.
    3. Expand the META-INF folder for the CICS bundle and double-click the cics.xml file to open it in the bundle manifest editor.
    4. On the Entry Points tab, double-click the application entry point that is declared for the URIMAP resource. In the Modify Application Entry Point dialog, change the resource name to match your new name for the URIMAP resource. In the application used in the demonstration, the resource name is updated to INDEX11.
    5. Increment the minor version number for the CICS bundle, and save your changes. In the application used in the demonstration, the version number of the CICS bundle where the URIMAP resource is defined is changed to 1.1.0.
  2. In the Project Explorer view, locate the application binding for the application, expand the META-INF folder for the application binding project, and double-click the appbinding.xml, bundles.xml, or deployment.xml file to open the application binding descriptor editor.
    1. On the Overview tab of the application binding descriptor editor, click Browse by the application name, and select the new version of the application. In the application used in the demonstration, version 1.1.0 of the application is selected.
    2. In the CICS Bundles section of the Overview tab, remove the old version of the CICS bundle where the URIMAP resource for the application is defined, and add the new version of that CICS bundle. In the application used in the demonstration, the new version 1.1.0 of the CICS bundle is added.
    3. On the Deployment tab, use the switch button to switch to working with the CICS bundles. Select the new versions of the CICS bundles that are deployed with the application bundle and the application binding, and select the appropriate region type where they are to be deployed. Cancel the selection of region type for the old versions of the CICS bundles. In the application used in the demonstration, new versions are deployed of the CICS bundle where the URIMAP resource for the application is defined, and of the CICS application bundle that packages the application.
    4. When you have completed your updates to the application binding, use the Version field in the application binding editor to increment the minor version number for the application binding, then save your changes.

What to do next

Next, export the new versions of the application, application binding, and CICS bundles to the platform home directory, and install them on the platform. Deploying the new version of the application explains how to do this.


update_appbinding.html | Timestamp icon Last updated: Sunday, 4 June 2017