Upgrading entries in the code page conversion table (DFHCNV)

A code page conversion table is not now required for CICS® web support. However, you might have existing request processing structures that include an analyzer program that references entries in the conversion table. If you do not want to change the analyzer program, you can continue to provide DFHCNV entries.

About this task

In releases of CICS before CICS Transaction Server for z/OS®, Version 3 Release 1, the code page conversion table (DFHCNV) was used to define code page conversions between the code pages used in CICS and the ASCII code pages used by web clients. For CICS web support in CICS Transaction Server for z/OS, Version 5 Release 4, you do not have to create any new entries in the code page conversion table. CICS web support handles code page conversion using z/OS conversion services.

However, if you want to continue to use an analyzer program that you coded in an earlier CICS release to reference DFHCNV, you must either continue to supply the entries in the code page conversion table, or change the analyzer program. To change the analyzer program, you code two new output parameters to specify the client and server code pages, in place of the output parameter that specified the name of a DFHCNV entry. If you make this change, you do not have to upgrade your DFHCNV entries. Writing an analyzer program tells you how to code your output parameters in this way.
Note: As supplied, the CICS-supplied sample analyzer DFHWBADX specifies an entry defined in the sample code page conversion table DFHCNVW$. The sample conversion table can be used without any configuration, but you might prefer to modify DFHWBADX to use the new output parameters, to provide greater control and avoid the use of the sample conversion table.

If you prefer, to continue using DFHCNV:

Procedure

  1. Locate your source for the DFHCNV resource definition macros that you used to define the conversion table in an earlier CICS release.
    The sequence of macros includes a DFHCNV TYPE=ENTRY macro for each pair of code pages.
  2. Use the macros to set up a DFHCNV conversion table, following the process described in Defining the conversion table.
    You define, assemble, and link-edit the table.