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 DFHCSDUP commands to do 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)
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 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: