DFHCNV TYPE=FIELD
This is the format of the DFHCNV TYPE=FIELD macro instruction, which occurs as many times as needed.
>>-DFHCNV -TYPE=FIELD--,OFFSET=nnnn--,DATATYP= -+-BINARY----+---> +-CHARACTER-+ +-GRAPHIC---+ +-NUMERIC---+ +-PD--------+ '-USERDATA--' >--,USRTYPE=nnn--,DATALEN=nnnn--+-----------+-------------------> '-,LAST=YES-' >--+-----------------+----------------------------------------->< | .-NO--. | '-,SOSI= -+-----+-' '-YES-'
- TYPE=FIELD
- Specifies conversion specifications for a data field. There must be one such statement for each field in a record. You cannot code a TYPE=FIELD macro until you have coded a TYPE=SELECT macro.
- OFFSET=nnnn
- Specifies the byte offset in the record or key at which the conversion should start, up to a maximum of 65535. (For TYPE=KEY conversions, this is the byte offset from the start of the key not from the start of the record.)
- DATATYP={CHARACTER|PD|BINARY|USERDATA|GRAPHIC|NUMERIC}
- Specifies the type of conversion required:
- CHARACTER
- Specifies character fields.
- PD
- Specifies packed decimal data in z/Architecture® format.
Any packed decimal data in other formats should be defined for USERDATA conversion, and the user-replaceable program DFHUCNV must contain the necessary conversion code.
- BINARY
- Specifies binary data in big-endian format.
By default, BINARY data is not converted. This default action can be overridden to allow requests from platforms that support different binary architectures to access the same CICS resource using the same conversion table.
- USERDATA
- Specifies data to be converted by the user-replaceable program DFHUCNV. The DFHCCNV conversion code bypasses these fields. See the USRTYPE operand.
- GRAPHIC
- Specifies fields that contain DBCS characters only.
- NUMERIC
- Specifies that binary fields held on the workstation in INTEL format (for example, C Language integer datatype) need to be converted to z/Architecture format. Integers (four bytes) or short integers (two bytes) can be converted.
- USRTYPE=nnn
- Specifies a value that is made available to the user-replaceable
conversion program DFHUCNV. The values you provide can be in the range
80 to 128 (X'50' to X'80'). The default value is
80 (X'50'). If more than one type of user-defined conversion
is possible, you can use this value to specify to DFHUCNV what conversion
is needed for each field.
This option is ignored if DATATYP=USERDATA is not specified.
- DATALEN=n
- Specifies the length of the data field to be converted, in bytes,
up to a maximum of 65535. For variable length fields, specify the
maximum possible length.
If DATATYP=NUMERIC, DATALEN must be 2 or 4.
- LAST=YES
- Specifies that this is the last field definition for this TYPE=SELECT statement.
- SOSI=YES|NO
- Enter YES for a mixed string containing SBCS and DBCS characters; enter NO for an SBCS string. This field is valid only if DATATYPE=CHARACTER has been entered in this macro. The default is NO.
