The CSD backup utility program
Use the CICS-supplied sample CSD backup utility program, DFH0CBDC, to write the list or group of resource definitions specified on the EXTRACT command in the form of DEFINE commands that are suitable for use as a backup copy.
The CICS-supplied sample CSD backup utility program produces a file of DFHCSDUP
DEFINE control statements. The file can be used:
- For later editing and commenting to document CSD resources
- For distribution, in part or as a whole, to other CICS® installations
- To re-create or add resource definitions to any CSD using DFHCSDUP.
The program must be run against an EXTRACT command of the form:
EXTRACT GROUP(group name) OBJECTS USERPROGRAM(program-name) or:
EXTRACT LIST(list name) OBJECTS USERPROGRAM(program-name) Note
that the sample program requires you to specify the OBJECTS keyword. Note the following points when using DFH0CBDC:
- It can deal with only one set of data during each invocation of DFHCSDUP; if two EXTRACT commands are issued, the second set of data overwrites the first.
- In the file produced by DFH0CBDC, any DEFINE statements that relate to CICS-supplied resources are preceded by an asterisk (*) in column 1; in other words, they are commented out. This is important if you use the file as input to define resources to a CSD. (The CICS-supplied definitions are already present in the CSD, having been produced automatically when it was initialized.)
- If you remove an asterisk from column 1 (to reinstate the DEFINE statement), do so by deleting it, not by overtyping it with a blank. This ensures that the resulting command is no more than 72 characters long; if it is longer than this, errors occur when the output is passed back through DFHCSDUP.