Other resource definition changes

This topic describes some other CSD changes affecting IBM-supplied resource definitions. The topics covered are:

Obsolete IBM-supplied resource definitions

The following groups are obsolete:

DFH$JAVA

IBM-supplied sample application program group DFH$JAVA is removed. This group contained the resource definitions needed for the sample applications for Java™ support using VisualAge® for Java, Enterprise Edition for OS/390®. The same sample applications are defined for use with a JVM by the DFH$JVM group.

DFHAUGRP

IBM-supplied group DFHAUGRP is removed. This group contained the resource definitions for the CICS® transaction affinities utility.

DFH$AFFY

IBM-supplied sample group DFH$AFFY is removed. This group contained sample resource definitions for the CICS transaction affinities utility that you could modify to suit your requirements.

Removing obsolete definition groups from startup group lists.

Obsolete definition groups have been removed from the CICS-supplied default startup group list, DFHLIST.

If you use customized startup group lists, you must remove any obsolete definition groups from them.

Updating user-modified IBM-supplied definitions

When you run the UPGRADE function of the CSD utility program (DFHCSDUP), ensure that you manually upgrade any IBM-supplied definitions that you may have modified on earlier releases. The safest way to do this is to copy the upgraded IBM-supplied definitions and reapply your modifications. This action is required because the UPGRADE command does not operate on your own groups, or on IBM® groups that you have copied.

It is important to upgrade these modified definitions to ensure that they are defined correctly with non-default values for attributes that are new. If you fail to upgrade modified definitions, CICS assigns default values to any new attributes, and these may be inappropriate for IBM-supplied resource definitions.

If you are not sure whether your CSD contains any modified IBM definitions, use the DFHCSDUP SCAN function to compare the IBM-supplied resource definitions with any user-modified versions.

The SCAN function searches for the IBM-supplied version of a specified resource name of a specific resource type and compares it with any other resource definition of the same name and type. DFHCSDUP reports any differences it finds between the IBM-supplied definition and a user-modified version. If you have copied and changed the name of an IBM-supplied definition, the SCAN command enables you to specify the changed name as an alias.

See the the CICS Operations and Utilities Guide for details of the DFHCSDUP SCAN command.

Migrating copies of CICS-supplied resource definitions

If you have made copies of CICS-supplied resource definitions, you may need to change your copies to match the changes which have been made to the supplied definitions for this release.

To help you, member DFH$CSDU in library SDFHSAMP contains ALTER commands that you can apply using the CSD utility program (DFHCSDUP).

  1. Review your resource definitions to determine if you have copied any CICS-supplied definitions.
  2. Review DFH$CSDU to determine if the changes which it contains should apply to your resource definitions.
  3. Make any necessary changes to DFH$CSDU. It is advisable to make a copy of DFH$CSDU, and apply any changes to the copy.
  4. Run DFHCSDUP using your modified version of DFH$CSDU as input.
    Note:
    As supplied, the ALTER commands in DFH$CSDU specify GROUP(*), which means that DFHCSDUP will attempt to change resources in the CICS-supplied groups. This is not permitted, and will result in message DFH5151. You can ignore this message.
[[ Contents Previous Page | Next Page Index ]]