DFHCNV TYPE=FIELD

This is the format of the DFHCNV TYPE=FIELD macro instruction, which occurs as many times as needed.

Read syntax diagramSkip visual syntax diagram
>>-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.


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