Editing resources defined in a CICS bundle project

To edit the definitions for resources that are defined in CICS® bundle projects, you use the CICS Explorer® resource editors. You can edit a resource definition in a CICS bundle project immediately after you create it. You can also edit a resource that you defined in a CICS bundle project at an earlier time.

About this task

Resource editors are available for the following types of resource definitions that you create in CICS bundle projects:
  • FILE resource definitions
  • JVMSERVER resource definitions
  • LIBRARY resource definitions
  • PIPELINE resource definitions
  • PROGRAM resource definitions
  • TCPIPSERVICE resource definitions
  • TRANSACTION resource definitions
  • URIMAP resource definitions
  • WEBSERVICE resource definitions

To edit a JVM profile that is packaged in a CICS bundle project with a JVMSERVER resource definition, you use the JVM Profile editor.

To edit a pipeline configuration file that is packaged in a CICS bundle project with a PIPELINE resource, you use the Text editor.

Web service binding files and WSDL documents that are packaged in a CICS bundle project with a WEBSERVICE resource cannot be edited in the CICS Explorer, only imported.

For an overview of the CICS Explorer resource editors and tips on using them, see Working with editors.

For instructions to browse and edit resources that are defined in a CICSplex or CICS system, rather than in a CICS bundle, see Browsing and editing resources.

Procedure

  1. Open the resource definition for editing.
    • To edit a new resource definition that you are just creating in a CICS bundle project, in the wizard select the Open editor check box before you click Finish. The resource editor opens when you have finished the wizard.
    • To edit a resource that you already defined in a CICS bundle project at an earlier time, you can open an editor from the Project Explorer view. Expand the CICS bundle in the Project Explorer view and locate the name of the resource. Right-click the resource name and select Open with, then select the name of the appropriate resource editor, such as Program Definition Resource. The resource editor opens and displays the resource attributes.
  2. Update the values for the attributes. Only the attributes that you can edit are displayed. In resource editors for resources defined in bundles, you cannot view attributes that you cannot edit.
    • If the attribute value must be one from a predetermined list, a button is displayed next to the Value field. Clicking the button displays a list of all the possible values. When you click a value, it is entered in the Value field.
    • If the attribute value is free-form text, you can type the new value in the field.
    • You can select or specify an empty string for the value of an attribute. If you choose an empty string, the attribute is removed from the resource definition in the bundle project when you save your changes.
  3. To edit a JVM profile that is packaged in a CICS bundle project, expand the CICS bundle in the Project Explorer view. Right-click the name of the JVM profile and select Open with, then select the JVM Profile editor. Edit the options in the JVM profile as appropriate for your environment. The JVM profile (.jvmprofile file) must be located in the same directory as the resource definition for the JVM server (.jvmserver file). For information on the options and settings available in JVM profiles, and specific suggestions for JVM servers that are configured to run functions such as OSGi applications, Axis2, or Liberty, see Setting up a JVM server in the CICS TS V5.2 product information.
  4. To edit a pipeline configuration file that is packaged in a CICS bundle project, expand the CICS bundle in the Project Explorer view. Right-click the name of the pipeline configuration file and select Open with, then select the Text editor. Add appropriate message handlers, header processing programs, and application handlers for your pipeline. For descriptions of the CICS-supplied sample pipeline configuration files, information on the XML elements that are used in a pipeline configuration file, and examples, see Pipeline configuration files in the CICS TS V5.2 product information.
  5. When your updates are complete, click Save, or press Ctrl-S, to apply the changes to the definition. Your changes are saved in the bundle project. You can then close the editor.

What to do next

If you have not yet deployed the CICS bundle project, when you have edited the resources deploy the CICS bundle or the application bundle that references it. For instructions to deploy an application bundle, see Deploying a CICS Application project. When you deploy the CICS bundle or the application bundle and install it, the dynamically generated resources are created in the CICS regions with the modifications that you made.

If you already deployed the CICS bundle project that contains the resource definition, or the application bundle that references it, you need to export the new version of the CICS bundle or application bundle to z/OS UNIX, disable and discard the resource that represents the previous version of the bundle, and install a resource that represents the new version of the bundle. Follow the instructions in Updating CICS bundles to do this. When you reinstall the CICS bundle or the application bundle, new resources are dynamically generated in the CICS regions with your modifications.