The DFHCSDUP EXTRACT command

Extract a resource definition, group, or list from the CSD file.

Read syntax diagramSkip visual syntax diagram
EXTRACT syntax

>>-EXtract--+-Group--(--groupname--)-+-------------------------->
            '-LIst--(--listname--)---'   

>--+-USerprogram--(--DFHxCRFy--)-------------+--+---------+----><
   +-USerprogram--(--DFHxFORy--)-------------+  '-Objects-'   
   +-USerprogram--(--DFH0CBDC--)-------------+                
   '-USerprogram--(--user-written program--)-'                

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 the CICS® Customization Guide.

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 CICS-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. .

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

Examples

The following command uses the CICS-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