Invoking DFHCSDUP from a user program
You can invoke the CSD update batch utility program DFHCSDUP from a user program, enabling you to create a flexible interface to the utility.
By specifying the appropriate entry parameters, your program can cause DFHCSDUP to pass control to an exit routine at any of five exit points. The exits can be used, for example, to pass commands to DFHCSDUP, or to respond to messages produced by DFHCSDUP processing.
You can run your user program:
- In batch mode
- Under TSO. Note:
- In a TSO environment, it is normally possible for the terminal
operator to interrupt processing at any time by means of an ATTENTION
interrupt. In order to protect the integrity of the CICS system definition file (CSD), DFHCSDUP
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 (see The put-message exit), where this is available, and
also to the default output file: Your put-message exit routine can terminate DFHCSDUP. (Note that you must supply a put-message routine if you want your operators to regain control after an ATTENTION interrupt.)
AN ATTENTION INTERRUPT WAS
REQUESTED DURING DFHCSDUP PROCESSING - Suitably authorized TSO operators can use the CEDA INSTALL transaction to install resources that have previously been defined with DFHCSDUP.
- In a TSO environment, it is normally possible for the terminal
operator to interrupt processing at any time by means of an ATTENTION
interrupt. In order to protect the integrity of the CICS system definition file (CSD), DFHCSDUP
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 (see 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. For more information, see The sample program, DFH$CUS1.