IBM SC34-6814-04 Server User Manual


 
first three subentries of the DDNAMES parameter. The fourth, fifth, and sixth
subentries, if present, replace the ddnames of DFHCSD, SYSIN, and SYSPRINT,
respectively.
v In the DCBS functional data, each subentry consists of two fullwords. The first
word is not used by CICS. The second word contains the address of an open
DCB or ACB. You must ensure that the DCB or ACB has been opened with the
correct attributes, which are:
PRIMARY CSD
AM=VSAM,MACRF=(KEY,DIR,SEQ,IN,OUT)
INPUT FILE
DSORG=PS,MACRF=GL,LRECL=80,RECFM=FB
The address of any end-of-data routine (EODAD) or I/O error routine
(SYNAD) in the DCB is overlaid by DFHCSDUP.
OUTPUT FILE
DSORG=PS,MACRF=PL,LRECL=125,RECFM=VBA
DFHCSDUP does not use the first three subentries of the DCBS parameter. The
fourth, fifth, and sixth subentries, if present, are used instead of the internal
DCBs or ACBs for DFHCSD, SYSIN, and SYSPRINT, respectively.
v In the EXITS parameter, each subentry consists of a single fullword containing
the address of an exit routine. You must specify the exit routines in the order
shown in Figure 131 on page 823. (The user exits are described in “The user exit
points in DFHCSDUP.”)
Responsibilities of the user program
Before invoking DFHCSDUP, your calling program must ensure that:
v RMODE(24) is in force.
v System/370 register conventions are obeyed.
v If the EXITS parameter is passed, any programming environment needed by the
exit routines has been initialized.
v Any ACBs or DCBs passed for use by DFHCSDUP are OPEN.
The user exit points in DFHCSDUP
There are five user exit points in DFHCSDUP. By specifying the appropriate entry
parameters, you can cause DFHCSDUP to pass control to an exit routine at any of
these points.
None of the user exits supports XPI calls.
Parameters passed to the user exit routines
The address of a parameter list is passed to the user exit routine in register 1. The
list contains some standard parameters that are passed to all of the exit routines,
and may also contain some exit-specific parameters that are unique to the exit point
from which the exit routine is being invoked.
The standard parameter list is different from that used by CICS global user exits.
The following DFHUEXIT DSECT maps the standard parameter list used by
DFHCSDUP and the sample program DFH$CUS1. (The UEPCMDA and UEPCMDL
fields are are used only by the get-command exit.)
824 Customization Guide