Chapter 30. 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. “DFHCSDUP as a batch program” on page 742 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 751 tells you how to
write a program from which DFHCSDUP itself can be invoked.

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
vVerify a CSD file by removing internal locks on groups and lists.
Youcan invoke DFHCSDUP in two ways:
vAs a batch program. The next section refers to this method.
vFrom a user program running either in batch mode or in a TSO environment.
“Invoking DFHCSDUP from a user program” on page751 describes this method.
© Copyright IBM Corp. 1977, 1999 741
|