The DFHCSDUP EXTRACT command

Extract a resource definition, group, or list from the CICS system definition file (CSD).

EXTRACT syntax

Read syntax diagramSkip visual syntax diagramEXtractGroup(groupname)LIst(listname)USerprogram(DFHxCRFy)USerprogram(DFHxFORy)USerprogram(DFH0CBDC)USerprogram(user-written program)Objects

Description

You can use the EXTRACT command to extract resource definition data from the CSD file, either from a list or from a group, and invoke a user program to process the extracted data. You specify the user program on the USERPROGRAM parameter.
Note: For programming information about coding user programs for the EXTRACT command, see Invoking a user program from DFHCSDUP.
Options
Group(groupname)
Specifies only those resource definitions within the named group. You can specify a generic group name.
LIst(listname)
Specifies only those resource definitions within the groups contained in the named list. You can use a generic list name only if you are not using the OBJECTS option.
Objects
Returns the detail of each resource definition. You can extract resource definition data at two levels of detail:
  • Without the OBJECTS option, the command extracts either the names of all the groups within a specified list, or the names of all the resource definitions within a specified group.
  • With the OBJECTS option, all the resource definition attributes are also extracted.

You must specify OBJECTS for the supplied sample user programs DFHxCRFy and DFHxFORy. It is optional for DFH0CBDC and user-written user programs.

USerprogram(user-written program)
Specifies the name of the user-written program that is to process the data retrieved by the EXTRACT command. You must supply a USERPROGRAM value.

CICS® supplies three types of sample user program: DFHxCRFy, DFHxFORy, and DFH0CBDC. The letter x in the program name is $ for assembler or PL/I and 0 for COBOL. The letter y in the program name denotes the programming language, where y=A is the assembler version, y=C is the COBOL version, and y=P is the PL/I version.

Each user-written program must use a specific DD card:
  • DFHxCRFy needs DD card CRFOUT
  • DFHxFORy needs DD card FOROUT
  • DFH0CBDC needs DD card CBDOUT

All other user programs are available in source form, in CICSTS56.CICS.SDFHSAMP, and the assembler versions are also available in pregenerated form in CICSTS56.CICS.SDFHLOAD.

Examples

The following command uses the supplied user program, DFH0CBDC, to extract the resource definitions in group DFHTYPE and create the DEFINE commands needed to create them. It stores these commands in the file specified by the CBDOUT DD statement. 
EXTRACT GROUP(DFHTYPE) USERPROGRAM(DFH0CBDC) OBJECTS