DFHCNV TYPE=SELECT

This is the format of the DFHCNV TYPE=SELECT macro instruction.

Read syntax diagramSkip visual syntax diagram
>>-DFHCNV -TYPE=SELECT--,OPTION= -+-COMPARE-+--,OFFSET=nnnn----->
                                  '-DEFAULT-'                 

>--+-,DATA='dd...dd'--+----------------------------------------><
   '-,XDATA='xx...xx'-'   

TYPE=SELECT
Indicates the start of conversion definitions (DFHCNV TYPE=FIELD macros) to be applied to a record that satisfies the comparison defined in this macro. If the defined comparison is not satisfied by the data in the record, the conversion program (DFHCCNV) skips to the next TYPE=SELECT macro, until it finds a match or reaches the OPTION=DEFAULT macro. Every TYPE=SELECT macro must be followed by at least one TYPE=FIELD macro.
OPTION={COMPARE|DEFAULT}
States the basic selection options:
COMPARE
Indicates that the data should be converted according to the specifications in the following DFHCNV TYPE=FIELD macros, if the record satisfies the comparison defined in this macro (OFFSET and DATA or XDATA options).
DEFAULT
Indicates that the data should be converted according to the specifications in the following DFHCNV TYPE=FIELD macros, if the record has not satisfied the comparison defined in any previous DFHCNV TYPE=SELECT COMPARE macro.

For each resource entry (started by a TYPE=ENTRY macro) the last TYPE=SELECT macro must specify OPTION=DEFAULT. No other TYPE=SELECT macro in the entry should specify OPTION=DEFAULT.

The following options are ignored if OPTION=DEFAULT is coded.
OFFSET=nnnn
Specifies the byte offset in the record at which the comparison should be made, up to a maximum of 65535.
DATA='dd...dd'
Restriction: Use only if the data to be tested is defined as DATATYP=CHARACTER, SOSI=NO

Specifies the comparison data as an EBCDIC character string, with a maximum length of 255 characters. CICS converts the incoming data from ASCII to EBCDIC before checking it against the comparison data, so that EBCDIC is compared with EBCDIC. Outgoing data is in EBCDIC, so the comparison is made in EBCDIC without conversion.

XDATA='xx...xx'
Restriction: Use if DATA option is not used

Specifies the comparison data as a hexadecimal string, with an even number of digits, maximum length 254 digits. Data is compared against this field, without conversion.



dfht8c0088.html | Timestamp icon Last updated: Sunday, 4 June 2017