System definition file utility program (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.
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
- 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 or definitions 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.
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.
You can invoke the DFHCSDUP program in two ways:
- As a batch program, for details see Invoking DFHCSDUP as a batch program.
- From a user program running either in batch mode or in a TSO environment, for details see Invoking the DFHCSDUP program from a user program.