When invoking the DFHCSDUP program, your program passes a list of up to
five parameters, as described below:
- OPTIONS
- A list of character strings, separated by commas. (The information passed
here is that which would otherwise be passed on the PARM keyword of the EXEC
statement of JCL.)
Note: A maximum of three options may be specified:
- UPPERCASE
- specifies that you want all output from DFHCSDUP to be in uppercase. If
you want all output to be in mixed case (the default), do not code this option.
- CSD({READWRITE|READONLY})
- specifies whether you require read/write or read-only access to the CSD.
The default value is READWRITE.
- PAGESIZE(nnnn)
- specifies the number of lines per page on output listings. Valid values
for nnnn are 4 through 9999. The default value is 60.
- NOCOMPAT|COMPAT
- specifies whether the DFHCSDUP utility program is to run in compatibility
mode (that is, whether it can update definitions that are obsolete in CICS® Transaction Server for z/OS®).
The default is NOCOMPAT, which means that you cannot update obsolete attributes.
For further information about this option, see Sharing the CSD between CICS Transaction Server for z/OS, Version 3 Release 1 and earlier releases.
- DDNAMES
- A list of ddnames that, if specified, are substituted for those normally
used by the DFHCSDUP program.
- HDING
- The starting page number of any listing produced by the DFHCSDUP program.
You can use this parameter to ensure that subsequent invocations produce logically
numbered listings. If this parameter is not specified, the starting page number
is set to 1.
The page number, if supplied, must be four numeric EBCDIC
characters.
- DCBs
- The addresses of a set of data control blocks for use internally by the
DFHCSDUP program. Any DCBs (or ACBs) that you specify are used internally,
instead of those normally used by the DFHCSDUP program.
Note that if you
specify both replacement DDNAMES and replacement DCBs, the alternative DCBs
are used, but the alternative DDNAMES are disregarded.
- EXITS
- The addresses of a set of user exit routines to be invoked during processing
of the DFHCSDUP program.