DFHCNV TYPE=SELECT
This is the format of the DFHCNV TYPE=SELECT macro instruction.
- 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.
