Updating an application project

Update the CICS® bundles for the components of the application and include the new versions in the application bundle.

Procedure

  1. Click Window > Show view > Project Explorer to open the Project Explorer view.
  2. Locate the application project, expand the META-INF folder for the application project, and double-click on the application.xml file or the bundles.xml file. The application editor opens. For a guide to using the application editor, see The application editor.
    Tip: If CICS Explorer® finds an error in the XML files for the application bundle, or another important problem, information about the error or problem is displayed in the Problems view.
  3. To include further CICS bundles in the application bundle, click Add. Select the appropriate CICS bundles from the list of CICS bundles that are available in your workspace.
  4. To remove CICS bundles that are currently included in the application bundle, select the CICS bundles and click Remove.
  5. To edit any of the CICS bundles that are included in the application bundle, double-click on the name of the CICS bundle in the list in the application editor to open the bundle manifest editor.
    1. Use the bundle manifest editor to add and remove dependencies from the CICS bundle, create new application entry points, and define policy scopes.
    2. To edit resources that are defined in the CICS bundle, use the resource editors, as described in Editing resources defined in a CICS bundle project. If you want to rename any resources that are not supported for multi-versioning, so that you can install the new version of the application without disabling and discarding the previous version, rename them at this stage.
    3. When you have updated a CICS bundle, use the bundle manifest editor to increment the major, minor, or micro version numbers for the CICS bundle according to your versioning policy, and save your changes. CICS Explorer only recognizes and exports changed CICS bundles when you increment the version number.
    4. Remove the old version of the CICS bundle from the application bundle by selecting it and clicking Remove in the application editor. When you update the version number for the CICS bundle, CICS Explorer marks the old version with an error in the application editor.
    5. Include the updated CICS bundle in the application bundle by clicking Add in the application editor, and selecting the new version of the CICS bundle from the list of CICS bundles that are available in your workspace.
  6. To edit any of the entry points for the application, double-click on the name of the application entry point in the list in the application editor to open the bundle manifest editor. When you have updated the application entry point, use the bundle manifest editor to increment the major, minor, or micro version numbers for the CICS bundle according to your versioning policy, and save your changes. Include the updated CICS bundle containing the application entry point in the application bundle, and remove the old version.
  7. When you have completed your updates to the application, use the Version field in the application editor to increment the major, minor, or micro version numbers for the application according to your versioning policy, then save your changes.

What to do next

Next, you can either update the existing application binding to specify the new version of the application, or create a new application binding for the new version of the application.