Chapter 34. User programs for the system definition utilityprogram (DFHCSDUP)
This chapter tells you how to write programs for use with the CICS system definition
utility program (DFHCSDUP). It is divided into the following sections:
1. “An overview of DFHCSDUP” contains background information.
2. “Invoking a user program from DFHCSDUP” on page 814 describes the
DFHCSDUP EXTRACT command, and tells you how to write a user program to
be invoked from DFHCSDUP.
3. “Invoking DFHCSDUP from a user program” on page 821 tells you how to write
a program from which DFHCSDUP itself can be invoked.
4. “The user exit points in DFHCSDUP” on page 824 describes the user exit points
in DFHCSDUP.
5. “The sample program, DFH$CUS1” on page 829 describes a sample program
that shows you how to invoke DFHCSDUP from a user program.

An overview of DFHCSDUP

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.
Using DFHCSDUP,you can do the following:
vAdd a group to the end of a named list in a CSD file
vAlter the definition of a single resource, on the CSD
vAppend a group list from one CSD file to a group list in another, or in the same,
CSD file
vCopy all of the resource definitions in one group to another group in the same, or
in a different, CSD file
vDefine a single resource, or a group of resources, on the CSD
vDelete from the CSD a single resource definition, all of the resource definitions in
a group, or all of the group names in a list
vExtract requested data from the CSD and pass it to a named user program for
processing
vInitialize a new CSD file, and add to it the CICS-supplied resource definitions
vList selected resource definitions, groups, and lists
vMigrate the contents of a table from a CICS load library to a CSD file
vProcess an APAR—thatis, apply maintenance for a specific APAR to the CSD
vRemove a single group from a list on the CSD file
vScan all IBM-supplied and user-defined groups for a resource
vService a CSD file when necessary
vUpgrade the CICS-supplied resource definitions in a primary CSD file for a new
release of CICS
vDefine resources using a set of user-defined default values (USERDEFINE
command)
vVerify a CSD file by removing internal locks on groups and lists.
Youcan invoke DFHCSDUP in two ways:
© Copyright IBM Corp. 1977, 2011 813