The CICS® system
definition utility program, DFHCSDUP, is a component of resource definition
online (RDO). DFHCSDUP is an offline utility program that allows you
to read from and write to a CICS system definition (CSD) file, either
while CICS is running or while it is inactive.
You can use the DFHCSDUP program to:
- ADD a group to the end of a named list in a CSD file
- ALTER attributes of an existing resource definition
- APPEND a group list from one CSD file to a group list in another,
or in the same, CSD file
- COPY all of the resource definitions in one group or several generically
named groups to another group or several other generically named groups
in the same, or in a different, CSD file
- DEFINE a single resource, or a group of resources, on the CSD
- 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
- EXTRACT data from the CSD and pass it to a user program for processing
- INITIALIZE a new CSD file, and add to it CICS-supplied resource
definitions
- LIST selected resource definitions, groups, and lists
- MIGRATE the contents of a table from a CICS load library to a
CSD file
- LIST a specific APAR
- REMOVE a single group from a list on the CSD file
- SCAN all IBM®-supplied groups and user defined groups for
a resource. The definition of the matched resource in an IBM supplied
group is compared to the definition(s) of the corresponding matched
resource in the user groups.
- SERVICE a CSD file when necessary
- UPGRADE the CICS-supplied resource definitions in a primary CSD
file for a new release of CICS
- Define resources using a set of user-defined default values (USERDEFINE
command)
- VERIFY a CSD file by removing internal locks on groups and lists.
See
Resource management utility DFHCSDUP commands for
information on each of these commands.
Note that the DFHCSDUP utility opens the CSD in non-RLS
mode (even if 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.