The following reporting options display list panels based on relationships between resource definitions in a single CICS® configuration. These help you to "clean up" a CICS configuration: for example, to identify resource definitions that are unused, multiply defined, or redefined with conflicting attributes. Aged or unwanted resource definitions may be candidates for deletion, whereas others may need corrections to avoid attribute conflicts.
You can use these options individually and in any order. However, if you would like a consistent workflow for cleaning up each of your CICS configurations, consider stepping through the options in the order presented here:
For a CICS configuration that refers to a CICSPlex® SM context, this option reports ResGroups that are not related to any ResDesc.
If a group is not related to any list, it means that the group is not included in the group lists, specified by the CICS system initialization parameter GRPLIST, that CICS installs at cold start. Similarly, if a ResGroup is not related to any ResDesc, it means that it cannot be automatically installed. Unless such a group or ResGroup is dynamically installed, it could be old and defunct, and a candidate for deletion.
This report is similar to the list panel displayed by entering the line action UNR (Unrelated) next to a list or ResDesc, which shows the groups or ResGroups that are not related to the selected list or ResDesc. The difference is that this Orphan Groups report displays groups or ResGroups that are unrelated to any list or ResDesc in the selected CICS configuration.
For a CICS configuration that refers to a CSD file, this means that two or more groups contain resource definitions of the same name and resource type.
For a CICS configuration that refers to a CICSPlex SM context, this means that multiple versions of a resource definition exist. However, this report does not include "orphan" versions of resource definitions (that do not belong to any ResGroup). To report orphan resource definitions, use option 4.8 Orphan resources.
This report allows you to focus on resource definitions that are defined more than once, possibly with identical or conflicting attributes. To further aid analysis, use checksums or the compare (CM) line action. Resource definitions with identical attribute values may be considered duplicates and perhaps candidates for deletion. Where attributes differ, analysis may reveal that some resource definitions are aged and in conflict with others.
To avoid cluttering the report with default resource definitions that you cannot change, this report may exclude resource definitions in IBM-protected groups (for example, CICS-supplied groups with prefixes DFH or EYU):
CICS Configuration Manager calculates the checksum value from the attributes of each resource definition, depending on the type of checksum you select from the action bar choice:
For more information on these and other types of checksum, see Comparing a list panel of objects with a checksum column.
You can use this report to identify resource definitions that have different names or belong to different groups but refer to the same resource (for example, the same file). Some of these may be candidates for deletion.
To avoid cluttering the report with default resource definitions that you cannot change, this report may exclude resource definitions in IBM-protected groups:
Matching… reports versus Show DUPLICATE…
Many list panels of resource definitions, such as those under option 2 CICS Resources, offer the action bar choices and . These are similar in purpose to reporting options 4.5 Matching names and 4.6 Matching checksums, respectively: they limit the display to resource definitions that have the same name and resource type, or checksum value, as one or more other resource definitions. However, there are differences:
The following options apply only to resource definitions in CICSPlex SM contexts:
You should review these resource definitions, decide whether they are associated with the correct ResGroups, and perhaps remove them from inappropriate ResGroups.
To remove a resource definition from a ResGroup, enter R (Remove) next to the resource definition in that ResGroup. CICS Configuration Manager protects you from creating orphan resource definitions: if you attempt to remove a version of a resource definition that belongs to only one ResGroup, CICS Configuration Manager displays an error message, and does not remove the resource definition.
The following option applies only to resource definitions in a CSD file: