This topic describes some other CSD changes affecting IBM-supplied resource definitions. The topics covered are:
There are new groups of resource definitions added to your CSD when you run the UPGRADE command:
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.
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.
These IBM-supplied groups contain sets of resource definitions for the link 3270 bridge,as follows:
DFHBR is locked and included in DFHLIST when you upgrade the CSD.
DFHBRCF is locked and included in DFHLIST when you upgrade the CSD.
DFHBRUT is locked and included in DFHLIST when you upgrade the CSD.
DFHBRVR is locked and included in DFHLIST when you upgrade the CSD.
DFHBRVSL is locked and included in DFHLIST when you upgrade the CSD.
DFHBRVSR is locked and included in DFHLIST when you upgrade the CSD.
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:
IBM-supplied group DFHDPWB contians the resource definitions for the new application debugging profile manager web interface. The group contains:
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.
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:
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.
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.
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.
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.
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.
IBM-supplied group DFHSO contains the resource definitions for External sockets support. The group contains:
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).
The resource definitions removed and now defined in DFHCOMP8 are from:
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.
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.
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:
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.
The following groups are obsolete:
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.
IBM-supplied group DFHAUGRP is removed. This group contained the resource definitions for the CICS transaction affinities utility.
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.
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.
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.
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).
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 ]]