The platform descriptor editor
Use the platform descriptor editor to work with platform bundles that are not yet installed in a CICSplex. If you do edit a platform bundle for a platform that is already installed, you must stop, discard, reinstall, and restart the platform to implement the changes.
After a platform is installed and active, you can use menus in the CICS Cloud perspective to add and remove individual CICS® regions in region types, and you can add and remove CICS bundles that are deployed with the platform. However, you cannot modify the region types in an installed platform, so use the platform descriptor editor to finalize your region types before installing the platform bundle.
The platform descriptor editor opens automatically after you create a project of that type. To open the editor at a later time, go to the Project Explorer view in the CICS Cloud perspective. Expand the META-INF folder for the project and double-click on any of the .xml files for the platform bundle, except the manifest.xml file. Alternatively, right-click the file, click Open With, then select the name of the editor. When the editor opens, the editor name tab displays the name of the platform.
If you do not have a versioned backup system that enables you to revert to a previous version of the project, instead of editing the existing project directly, you might prefer to copy it to another project and then edit the new copy.
Errors and warnings during the editing process are displayed in the main editor window, the Problems tab in the perspective, or the status field in the workbench.
To reverse one or more of your changes before you save them, use the Undo function. On the workbench menu, click
, or press Ctrl+Z (cmd+Z for macOS).To save your changes, click the Save icon , or press Ctrl+S (cmd+S for macOS). If you attempt to close the editor without saving the
changes, a dialog is displayed asking if you want to save your changes or close without saving.
The platform descriptor editor has three tabs: Overview, Region Types, and Deployment. The Actions section on the Overview tab explains a process to edit the platform project, and has links to the wizards and tabs to perform each task.

- Change the ID, description, or platform home directory for the platform.
- Add and remove region types for the platform. The Overview tab has basic functions to create new region types, or adopt region types from an existing topology. To modify the region types and work with the CICS regions in them, use the Region Types tab. Double-clicking on the name of a region type takes you to that region type in the Region Types tab.
- Add and remove CICS bundles that are deployed with the platform. To edit any of these CICS bundles, double-click on the name of the bundle in the list in the platform descriptor editor to open the bundle manifest editor.

- Add and remove region types for the platform. You can create new region types, or adopt region types from an existing topology.
- Create new CICS region definitions in created region types.
- Specify or edit the basic properties for CICS region definitions in created region types.
- Add and remove CICS region definitions in created region types, and sharing them between created region types. Any orphaned CICS region definition that is not currently in a region type is displayed at the top of the list. Select the region to add it to a region type.

