The DFHCSDUP UPGRADE command

Change the CICS®-supplied resource definitions in a primary CSD file.

Read syntax diagramSkip visual syntax diagram
UPGRADE syntax

>>-UPgrade--+-----------------------+--+---------+-------------><
            '-USing--(--filename--)-'  '-Replace-'   

Description

Upgrades the IBM®-supplied definitions in the CSD. Definitions are added to, modified in, or deleted from DFH-groups. Note that deleted definitions are added to compatibility groups with names of the form DFHCOMPn. This enables you to share the CSD with earlier releases of CICS after you have run the upgrade command.

Use the DFHCSDUP LIST command to check the status of the CSD file before or after the upgrade. The command reports the release in which a CSD was created, and the release to which it has been upgraded.

The upgrade command can also be used to apply any package of IBM-supplied resource definitions to the CSD file. For example, the definitions for the CICS sample programs and transactions can be transferred to the CSD file with the UPGRADE statement.

Options

Replace
Specify the REPLACE option when you need to rerun the UPGRADE command (for example, because of a previous issue).
USing(filename)

To install IBM features onto CICS, specify UPGRADE USING(filename). For example, UPGRADE USING(DFHRDJPN) is used to place the double-byte character set feature definitions onto the CSD file.

To upgrade a CSD, do not specify the USING operand. All IBM-supplied definitions from any release are deleted and then the CSD file is initialized, so you do not need to say which release you came from.



upgrade.html | Timestamp icon Last updated: Monday, 5 June 2017