Data conversion using a CICS-supplied interface
If you are using a CICS-supplied interface to invoke a service flow, you might have to perform data conversion in the CICS Service Flow Runtime region using a customized version of the standard CICS® conversion table, DFHCNV.
You might need a data conversion table if the CICS system is using ISC to communicate with a member of the CICS family that runs on a hardware platform that does not use EBCDIC. The conversion table defines how data is changed from ASCII format at the workstation to EBCDIC format in CICS.
ECI applications use the CICS mirror program to call the CICS data conversion program, DFHCCNV, passing the request and reply messages found in the COMMAREA. DFHCCNV performs the necessary conversion of the COMMAREA as defined in the customized conversion table, DFHCNV. It applies standard conversion to those fields in the conversion templates for which you have not specified nonstandard, user-handled conversion.
If DFHCCNV finds a conversion template in the DFHCNV table that matches the CICS SFR interface program name DFHMADPL, it performs code page translation and data conversion for the COMMAREA associated with the ECI request. A conversion template is a table entry defining fields in a data area to be converted and the conversion method to be applied to each field.
The conversion template must specify the following:
- A table entry for the interface DFHMADPL.
- Entries for each field offset, type of conversion, and field length found in the message header structures DFHMAH.
- All binary fields must specify DATATYP=NUMERIC, if you require ASCII to EBCDIC conversion. You must supply similar conversion entries (DATATYP=NUMERIC) with correct field offsets if the client application data portion of the request and reply messages uses binary data.
See Conversion template for DFHMADPL for a sample conversion template of DFHMADPL.
- CICS Family: Communicating from CICS on System/390
- IBM® Redbooks publication: CICS Transaction Gateway V5: The WebSphere Connector for CICS
- Java applications in CICS
- IBM Redbooks publication: Java Connectors for CICS
For information on how to install and configure DFHCNV, see Setting up data conversion.