Resource groups

A resource group can be any set of resource definitions that you want to manage as a unit. The resources in a group usually have something in common. They might be logically related by their use in a given application or communications network, or geographically related by their use at a given site.

A resource group can contain resource definitions of all types (such as connections, files, and journals). There is no real limit to the number or combination of resource definitions that can make up a group. However, only one version of a given resource can be included in a resource group at one time. You can maintain multiple versions of a resource definition in different resource groups, but not in the same group.

When you use the GET API command to create a result set of CICS® Definition records, you can limit your request to definitions in a given resource group. The GET command for each CICS Definition object (such as CONNDEF) supports the following parameter:

RESGROUP(resgroup)
(Optional) Specify the name of an existing resource group from which CICS Definition records should be selected.

Start of changeYou create resource groups by using the CREate action command from the RESGROUP view (EUI) or by clicking the Create button in the Resource groups WUI view. This action adds the resource group to the CICSPlex® SM data repository.End of change

You can also create a resource group using the CREATE command in the batched repository-update facility or the API. In that case, you can identify an existing resource group to be used as a model. The CREATE command for the RESGROUP object accepts the following parameters:

MODEL(resgroup)
(Optional) Specify the name of an existing resource group whose resource definitions are to be used by the new group.
MODE(option)
(Required, if you specified a MODEL value) Indicate which definitions are to be copied from the model resource group to the new group:
NO
Do not copy any definitions from the model group.
ASSOCIATIONS
Copy the associations between resource definitions and the model group (RESINGRP definitions) and create a new set of associations from the existing resources to the new group.
MEMBERS
Copy all the resource definitions in the model group and create a new set for use by the new group.
Note:
For a complete description of the RESGROUP view, see Action commands.

You can manage resource groups independently, but the real advantage comes in associating them with one or more resource descriptions or resource assignments.

Start of change

Adding resource definitions to a resource group

Start of changeThere are several ways to create an association between a resource definition and a resource group. Both definitions must exist in the CICSPlex SM data repository before you can create the association:

Adding a definition when it is created
Start of changeYou can automatically associate a resource definition with a resource group when the definition is created by identifying the group in the Resource group name (WUI) or RESGROUP (EUI) field. This is a standard field on the create panel for each resource type.End of change

When you create CICS Definitions using the batched repository-update facility or API you can add them to an existing resource group by using the RESGROUP parameter. The CREATE command for each CICS Definition object (such as CONNDEF) supports the following parameter:

RESGROUP(resgroup)
(Optional) Specify the name of an existing resource group to which the CICS Definition should be added.
Start of changeAdding individual or multiple definitionsEnd of change
Start of change End of change
Using a model resource group
Once a resource group is defined and populated with resource definitions, you can use that group as a model to populate other resource groups. When you create a new resource group, you have the option of specifying:
End of change
Note:
Adding a resource definition to a resource group could result in inconsistent resource set errors. For information about this type of problem and how to resolve it, see Validation of a set of resources.
End of change [[ Contents Previous Page | Next Page Index ]]