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.
You 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.
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.
There 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
You 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.
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.
Adding individual or multiple definitions
- In the WUI you can add one or more existing resource definitions of a given type to a group by selecting the definition or definitions
on a resource definition tabular view and clicking the Add to resource
group button.
- In the EUI you can add existing resource definition to a group one at a time by using
the ADD action command from a resource definition view.
- Also in the EUI you can add multiple resource definitions of a given
type to a group by using the RES action command from the RESGROUP view:
- Display the RESGROUP view.
- Issue the RES action command with a resource type in the Restype field.
- Select resource definitions from the Add Resource to RESGROUP list.
When you issue the RES action command, you can limit the list of resource definitions
that are displayed by specifying:
- A version number in the ResVer field
- A generic resource name in the Pattern field
- 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:
- A resource group whose resource definitions are to be used as a model by the newly
created group.
- Which definitions are to be copied from the model group:
- The actual resource definitions (to create an additional set of resources)
- The associations between the model group and existing resources
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.
[[ Contents Previous Page | Next Page Index ]]