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
- 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.
- 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.
- 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.
- 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.
- 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.