The resource definition batch utility DFHCSDUP

The CICS® system definition utility program, DFHCSDUP, is a component of resource definition online (RDO). You can use the DFHCSDUP offline utility program to read from and write to a CICS system definition (CSD) file, either while CICS is running or while it is inactive.

Note that the DFHCSDUP utility opens the CSD in non-RLS mode, even when you request RLS access on your JCL. This means that, if you access the CSD from CICS in RLS mode, it cannot be open when you run DFHCSDUP. The reason for the restriction is that the DFHCSDUP utility does not have the capabilities that are needed in order to open a recoverable file in RLS mode. The restriction also applies, however, if your CSD is nonrecoverable.

What you can do by using DFHCSDUP commands

You can use DFHCSDUP to perform the following tasks:

Add a group to the end of a named list in a CSD file (ADD command)
Alter attributes of an existing resource definition. on the CSD (ALTER command)
Append a group list from one CSD file to a group list in another, or in the same, CSD file (APPEND command)
Copy all of the resource definitions in one group to another group in the same, or in a different, CSD file (COPY command)
Copy a single resource definition from one group to another group (COPY command)
Define a single resource, or a group of resources, on the CSD (DEFINE command)
Delete from the CSD a single resource definition, all of the resource definitions in a group, or all of the group names in a list (DELETE command)
Extract data from the CSD and pass it to a user program for processing (EXTRACT command)
Initialize a new CSD file, and add to it the CICS-supplied resource definitions (INITIALIZE command)
List selected resource definitions, groups, and lists (LIST command)
Process an APAR—that is, apply maintenance for a specific APAR to the CSD (PROCESS command)
Remove a single group from a list on the CSD file (REMOVE command)
Scan all IBM-supplied and user-defined groups for a resource (SCAN command)
Service a CSD file when necessary (SERVICE command)
Upgrade the CICS-supplied resource definitions in a primary CSD file for a new release of CICS (UPGRADE command)
Define resources using a set of user-defined default values (USERDEFINE command)
Verify a CSD file by removing internal locks on groups and lists (VERIFY command)

For information about each of these commands, see Resource management utility DFHCSDUP commands.

How to invoke DFHCSDUP

You can invoke the DFHCSDUP program in two ways:

As a batch program
You can edit and use this sample job to invoke DFHCSDUP as a batch program.
From a user program running either in batch mode or in a TSO environment
For details, see Invoking DFHCSDUP from a user program.

Security for DFHCSDUP

The DFHCSDUP utility requires batch access to the CSD. Ensure that only authorized users are allowed to update the CSDs. Restrict the access list on the CSD data set profile to the CICS region user IDs and other authorized users only. For more information, see Protecting data sets in z/OS Security Server RACF Security Administrator's Guide.