Renaming a group or a ResGroup (moving resource definitions)

In CICSĀ® Configuration Manager, renaming a group or a ResGroup is equivalent to moving resource definitions from one group or ResGroup to another, within the same CICS configuration. You can choose to move all of the resource definitions in a group or ResGroup, or select resource definitions based on their type and name.

If the destination group or ResGroup already exists, then the resource definitions being moved are added to the resource definitions at that destination. If the destination already contains a resource definition of the same name and type as one being moved, then you can choose whether to overwrite that resource definition or not perform the move.

There is a difference between renaming a group in a CSD-based CICS configuration and renaming a ResGroup in a context-based CICS configuration. If you rename a group, and there are no resource definitions left in the group afterwards, then the original group ceases to exist, because there are no resource definitions that refer to it. However, when you rename a ResGroup in a context-based CICS configuration, the original ResGroup still exists, even if it is empty: CICS Configuration Manager does not delete it.

Renaming a group or a ResGroup does not affect any lists or ResDescs that refer to it. For example, if you rename a group, any lists that refer to the group will still refer to the original group name. If you want to update the list to refer to the new group name, you must edit the list as described in Associating groups with lists.

For CSD-based CICS configurations, this CICS Configuration Manager rename action combines the functionality of the CICS CEDA MOVE and RENAME commands.

To rename a group or a ResGroup:

  1. Expand the CICS configuration to show a list panel of groups or ResGroups that includes the one that you want to rename. For details, see Exploring CICS configurations.
  2. Type REN next to the group or ResGroup that you want to rename.
  3. To move all of the resource definitions (except for any that would overwrite resource definitions at the destination), enter the name of the destination group or ResGroup in the Prompt column, and then press Enter.

    To select which resource definitions are moved, and choose whether or not to overwrite resource definitions at the destination, leave the Prompt column blank, and then press Enter. A pop-up window appears, enabling you to specify these options.