Other resource definition changes

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

Additions to IBM-supplied resource definitions

There are new groups of resource definitions added to your CSD when you run the UPGRADE command:


DFHDP

IBM-supplied group DFHDP contains the resource definitions for the new Application debugging profile manager 3270 interface (the CADP transaction), and for the Inactivate debugging profiles utility. The group contains:

PROGRAM definitions
DFHDPLU, DFHDPIN and DFHDPCP
TRANSACTION definitions
CADP and CIDP
MAPSET definitions
DFHDPMS

DFHDPWB

IBM-supplied group DFHDPWB contians the resource definitions for the new application debugging profile manager web interface. The group contains:

PROGRAM definitions
DFHDPWB, DFHDPWM0, DFHDPWM1, DFHDPWM2, DFHDPWM3, DFHDPWM4, DFHDPWM5, DFHDPWM6, DFHDPWT0, and DFHDPWF0

DFHSO

IBM-supplied group DFHSO contains the resource definitions for External sockets support. The group contains:

PROGRAM definitions
DFHSOCI and DFHSOLI

Changes to IBM-supplied resource definitions

Some IBM-supplied resource definitions are changed or obsolete, and are moved to new compatibility groups.

Following the upgrade of your CSD, the resource definitions listed below no longer exist in their old groups, which are removed from DFHLIST. If you plan to share the upgraded CSD with earlier releases of CICS®, you must remove the obsolete group names from the group lists you use on the earlier releases, and add groups DFHCOMP5, DFHCOMP6, DFHCOMP7, DFHCOMP8, DFHCOMP9, and DFHCOMPA, (or some of these) in their place. See The application programming interface (API).

Moved to group DFHCOMPA

Group DFHJIIRP is obsolete. The definition that was in this group is now in the new compatibility group, DFHCOMPA.

When you upgrade the CSD using DFHCSDUP, DFHCOMPA is locked.

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.

Example

In CICS TS 2.3, JVMPROFILE(DFHJVMCD) was added to the definition of program DFHADJR. Therefore, DFH$CSDU contains the following command:

ALTER PROGRAM(DFHADJR) GROUP(*) JVMPROFILE(DFHJVMCD)

When you you run DFHCSDUP, the attribute is added to the definitions of program DFHADJR in all groups. Other attributes are unchanged.

[[ Contents Previous Page | Next Page Index ]]