The platform editor

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 editor to finalize your region types before installing the platform bundle.

The platform 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. As an alternative to double-clicking, you can right-click the file and 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 Edit > Undo, or press Ctrl-Z.

To save your changes, click on the Save icon , or press Ctrl-S. 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 editor has three tabs, Overview, Region Types, and Deployment. The list of actions on the Overview tab explains a process for editing the platform project, and has links to the wizards and tabs to perform each task.

Use the Overview tab of the platform editor for these tasks:

• Changing the ID, description, or platform home directory for the platform.
• Adding and removing 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.
• Adding and removing 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 editor to open the bundle manifest editor.

Use the Region Types tab of the platform editor for these tasks:

• Adding and removing region types for the platform. You can create new region types, or adopt region types from an existing topology.
• Creating new CICS region definitions in created region types.
• Specifying or editing the basic properties for CICS region definitions in created region types.
• Adding and removing 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.

The platform editor does not connect to the target CICSplex, so you cannot use it to add, remove, or share CICS regions in adopted region types. You can only work with CICS region definitions in created region types.

Use the Deployment tab of the platform editor to map the CICS bundles that are deployed with the platform to the region types in the platform. Use the switch button to switch between working with the region types, and working with the CICS bundles.