The csd cross-referencing program – IBM SC33-1683-02 User Manual

Page 777

Advertising
background image

Table 39. Sample EXTRACT user programs for the DFHCSDUP utility program

Program
names

Languages

Description

DFH$CRFA
DFH0CRFC
DFH$CRFP

Assembler
VS COBOL II
PL/I

Produces a cross-reference listing of the resource
definitions defined in the group or list you specify on the
EXTRACT command.

DFH$FORA
DFH0FORC
DFH$FORP

Assembler
VS COBOL II
PL/I

Formats the group or list of resource definitions you specify
on the EXTRACT command into a form suitable for the
DB2 table load utility.

DFH0CBDC

VS COBOL II

Writes the list or group of resource definitions you specify
on the EXTRACT command in the form of DEFINE
commands, suitable for use as a backup copy of the
resources extracted.

You can use the sample programs as supplied, or as models on which to base your
own programs.

Only the assembler-language versions of DFH$CRFx and DFH$FORx are supplied
in executable form in CICSTS13.CICS.SDFHLOAD, but for each of these programs
the source statements are supplied in CICSTS13.CICS.SDFHSAMP.

The CICS-supplied sample DB2 formatting programs (DFH$FORx) cannot be used
when the CSD compatibility option (COMPAT) is specified on the DFHCSDUP utility
program. The output from the CSD cross-reference listing and CSD backup utility
programs depends on whether the compatibility option is specified. If the
compatibility option is specified, the output includes obsolete keywords from
releases before CICS Transaction Server for OS/390 Release 3; if the option is not
specified, only keywords from CICS Transaction Server for OS/390 Release 3 are
output. For further information about running the DFHCSDUP utility program with
the compatibility option, see the

CICS Resource Definition Guide.

Note that the sample programs require you to specify the OBJECTS keyword on
the DFHCSDUP EXTRACT command.

The output data definition names (ddnames) for the sample programs are as
follows:

CRFOUT

CSD cross-referencing program

FOROUT

DB2 formatting program

CBDOUT

CSD backup utility program.

The sample programs are discussed in the next three sections.

The CSD cross-referencing program

The CICS-supplied sample CSD cross-referencing program produces a
cross-reference listing of objects and keywords on the CSD. The data gathered by
the EXTRACT command is passed to the sample program, where it is saved in a
cross-reference table. On the final call to this sample program, the contents of the
table are printed in collating sequence.

DFHCSDUP as a batch program

Chapter 30. User programs for the system definition utility program (DFHCSDUP)

745

Advertising