Parameters for managing CICS Definitions

You can use CICSPlex® SM to manage your CICS® resource definitions as CICS Definition objects.

Start of change

Creating resource descriptions

A resource description represents the largest set of resources that can be managed as a unit by CICSPlex SM. It might consist of all the resources in several resource groups or resource assignments (much like a CSD group list) or the set of resources that make up a given application on various CICS systems. When you create a resource description using the batched repository-update facility or API, you can identify an existing resource description to be used as a model. The CREATE command for the RESDESC object accepts the following parameter:

MODEL(resdesc)
(Optional) Specify the name of an existing resource description whose resource assignments are to be used by the new resource description.
End of change

Creating resource groups

One aspect of managing CICS Definitions is combining them into logical sets of resources in a resource group (RESGROUP). When you create a resource group using the batched repository-update facility or API 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.

Adding CICS Definitions to a resource group

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.

Selecting CICS Definitions

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, or CICS system. The GET command for each CICS Definition object (such as CONNDEF) supports the following parameters:

RESGROUP(resgroup)
(Optional) Specify the name of an existing resource group from which CICS Definition records should be selected.
CICSSYS(value)
(Required for SYSRES definition, optional for all others) Specify the name of an existing CICS system whose system links definitions are to be used as a model.

Start of changeWhen the CICSSYS parameter is used, the result set will contain records that have been modified to show what the record would look like when installed in the system specified by CICSSYS(value).End of change

[[ Contents Previous Page | Next Page Index ]]