User/CICS conversion

Use user/CICS conversion when the resource contains some fields that can be converted by standard means, and some that require nonstandard 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. Define standard fields as DATATYP=CHARACTER, PD, BINARY, GRAPHIC, or NUMERIC, as appropriate.
  5. Supply a user-written version of DFHUCNV or a differently-named conversion program to handle the nonstandard 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.