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:
AN ATTENTION INTERRUPT HAS BEEN REQUESTED DURING DFHCSDUP PROCESSING
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.) - 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).