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:


DFHADET

The IBM-supplied group DFHADET contains the definitions you need to run the EJB application development tool. The group contains a file definition (for the DFHADEM file) and 15 program definitions.

DFHADET is not included in list DFHLIST when you initialize or upgrade the CSD.

DFHADST

The IBM-supplied group DFHADST contains the resource definitions needed for the new CREA and CREC transactions.

DFHADST contains the CREA and CREC mapset, two program and two transaction resource definitions, and the group is included in list DFHLIST when you initialize or upgrade the CSD.

DFHBR, DFHBRCF, DFHBRUT, DFHBRVR, DFHBRVSL DFHBRVSR, and DFH$BRLK

These IBM-supplied groups contain sets of resource definitions for the link 3270 bridge,as follows:

DFHBR
This contains the basic program resource definitions for the link 3270 bridge mechanism.

DFHBR is locked and included in DFHLIST when you upgrade the CSD.

DFHBRCF
This group defines the file resource definition required for the bridge number space defined as a coupling facility data table.

DFHBRCF is locked and included in DFHLIST when you upgrade the CSD.

DFHBRUT
This group defines the file resource definition required for the bridge number space defined as a user-mantained data table.

DFHBRUT is locked and included in DFHLIST when you upgrade the CSD.

DFHBRVR
This group defines the file resource definition required for the bridge number space defined as a VSAM RLS file.

DFHBRVR is locked and included in DFHLIST when you upgrade the CSD.

DFHBRVSL
This group defines the file resource definition required for the bridge number space defined as a VSAM local KSDS file.

DFHBRVSL is locked and included in DFHLIST when you upgrade the CSD.

DFHBRVSR
This group defines the file resource definition required for the bridge number space defined as a VSAM remote KSDS file.

DFHBRVSR is locked and included in DFHLIST when you upgrade the CSD.

DFH$BRLK
This group defines the resource definitions needed for the link 3270 bridge sample application.

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

DFHEJBU

The IBM-supplied group DFHEJBU contains the program resource definition needed for the CICS® EJB user-replaceable program, DFHEJEP. This program intercepts EJB events for the EJB application development tool.

DFHEJBU is included in list DFHLIST when you initialize or upgrade the CSD.

DFHEJCF, DFHEJVR, and DFHEJVS

These IBM-supplied groups contain three versions of the file resource definitions for the EJB request streams directory and the EJB object store for session beans. The three versions are:

DFHEJCF
File definitions for coupling facility data tables (CFDTs), with TABLE(CF).
DFHEJVR
File definitions for LSR mode VSAM files, with LSRPOOLID(1).
DFHEJVS
File definitions for RLS mode VSAM files, with RLS(YES).

These groups of sample definitions are added to the CSD by the DFHCSDUP UPGRADE command, but are not included in DFHLIST. The groups are not locked, so that when you have decided which version you want to use, you can modify the data set name and any other attributes you want to change. Add the name of the modified group to your start-up group list if you are using CICS EJB support.

DFHIPECI

The IBM-supplied group DFHIPECI contains the definitions for the CICS ECI over TCP/IP interface.

This group is locked and included in DFHLIST when you upgrade the CSD.

DFHOTS

The IBM-supplied group DFHOTS contains the program (DFHOTR) and resynchronization transaction (CJTR) resource definitions for CICS Object Transaction Services (OTS) support.

This group is locked and included in DFHLIST when you upgrade the CSD.

DFHPSSGN

The IBM-supplied group DFHPSSGN contains the program and transaction resource definitions for CICS VSAM persistent sessions signon retention support.

This group is locked and included in DFHLIST when you upgrade the CSD.

DFHRQS

The IBM-supplied group DFHRQS contains the CICS request stream resource definitions.

This group is locked and included in DFHLIST when you upgrade the CSD.

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 DFHCOMP8

The resource definitions removed and now defined in DFHCOMP8 are from:

Moved to group DFHCOMP9

The following groups, which were introduced in CICS TS 2.1, are obsolete:

The definitions that were in these three groups are all now in the new compatibility group, DFHCOMP9.

Note that, whereas the groups DFHADBD and DFHADFD are unlocked in a CICS TS 2.1 CSD, when you upgrade the CSD using DFHCSDUP, DFHCOMP9 is locked.

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.

Changes to the DFH$IIOP samples group

There are changes to resource definitions defined in the DFH$IIOP samples group, but the definitions that have been removed are not defined in DFHCOMP8. The definitions that have been removed are:

The definitions that are still defined in DFH$IIOP, but have changed in some significant way, are:

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.

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 ]]