User-only conversion

The resource contains no fields that can be converted by standard means; all require nonstandard conversion. There are two methods of enabling user-only conversion.

Procedure

  1. Create a conversion template.
  2. Specify the USREXIT keyword on the DFHCNV TYPE=ENTRY macro that defines the resource.
    • If you specify USREXIT=YES, CICS calls DFHUCNV to convert the data.
    • If you specify USREXIT=program, CICS calls the named program to convert the data.
  3. Specify DATATYP=USERDATA on the DFHCNV TYPE=FIELD macros that define the nonstandard data fields.
    1. Optional: Define nonstandard fields with a USRTYPE value in the range X'50' through X'80'
      These values are passed to your user program, and can be used to distinguish between different types of nonstandard field.
  4. Supply a user-written version of DFHUCNV or a differently-named conversion program to handle all fields.
    The user-replaceable conversion program gives a description and listing of DFHUCNV, with guidance on how to use it as a basis for your own conversion program.