Invoking the DFHCSDUP program from a user program
Invoking the DFHCSDUP program from a user program enables you to create a flexible interface to the utility.
About this task
By specifying the appropriate entry parameters, your program can cause the DFHCSDUP program to pass control to an exit routine at any of five exit points. The exits can be used, for example, to pass commands to the DFHCSDUP program, or to respond to messages produced by its processing.
- In batch mode
- Under TSO. Note:
- In a TSO environment, it is normally possible for the terminal user to
interrupt processing at any time by means of an ATTENTION interrupt. In order
to protect the integrity of the CSD file, the DFHCSDUP program does not respond
to such an interrupt until after it has completed the processing associated
with the current command. It then writes message number DFH5618 to the put-message
exit, where this is available, and also to the default output file: . Your put-message exit routine can terminate the DFHCSDUP program, (You must supply a put-message routine if you want your operators to regain control after an ATTENTION interrupt.)
AN ATTENTION INTERRUPT HAS BEEN REQUESTED DURING DFHCSDUP PROCESSING
- Suitably authorized TSO users can use the CEDA INSTALL transaction to install resources that have previously been defined with the DFHCSDUP program.
- In a TSO environment, it is normally possible for the terminal user to
interrupt processing at any time by means of an ATTENTION interrupt. In order
to protect the integrity of the CSD file, the DFHCSDUP program does not respond
to such an interrupt until after it has completed the processing associated
with the current command. It then writes message number DFH5618 to the put-message
exit, where this is available, and also to the default output file:
The CICS®-supplied sample program, DFH$CUS1, illustrates how the DFHCSDUP program can be invoked from a user program. It is written as a command processor (CP) for execution under the TSO/E operating system.
The following sections outline the entry parameters of the DFHCSDUP program and the responsibilities of the user program. For programming information about invoking the DFHCSDUP program from a user program, see User programs for the system definition utility program (DFHCSDUP).