Data conversions within CICS® using z/OS® Unicode conversion services adds to the data conversion support that is provided for any of the range of EBCDIC and ASCII codepage combinations listed in the "CICS-supported conversions" topic in the CICS Family: Communicating from CICS on System/390® manual.
Conversions involving Unicode typically take place as part of the processing of HTTP requests or the use of the CONTAINER API commands introduced in CICS TS 3.1. The conversion of data to or from either UTF-8 or UTF-16 and EBCDIC and ASCII codepages, depends on the selection of suitable conversion images. Conversion between the UTF-8 and UTF-16 forms of Unicode is also supported.
To use the data conversion methods described here, as opposed to those offered by earlier releases of CICS, you must be communicating your data using channels or containers, as described in the CICS Application Programming Guide.
CICS documents and document templates cannot be converted to or from the UTF-8 and UTF-16 character encodings. This restriction applies whether they are used as a static response in CICS Web support, retrieved by CICS in response to EXEC CICS WEB API commands, or retrieved by an application program using an EXEC CICS DOCUMENT RETRIEVE command.
Appendix F of the z/OS Support for Unicode: Using Conversion Services manual -SA22 -7649 records those conversions which are supported though these services. CICS now supports any of these character conversions by making use of the z/OS conversion services.
CICS supports conversions involving UTF-16 data using any of the following CCSID's: 1200, 1201, and 1202. The z/OS conversion services permit CCSID 1200, in its big-endian form, to be used, but does not contain support for the little-endian form or for CCSIDs 1201 or 1202. CICS transforms any source data that is identified in any of these unsupported forms to the big-endian form of 1200 before passing the data to z/OS for conversion. If the target data is one of the unsupported forms then CICS receives the data as the big-endian form of 1200 and transforms it to the required CCSID. If the target CCSID is 1200 then CICS assumes the encoding to be in big-endian form. If the conversion is between any of these CCSIDs then CICS will carry out the transformation without calling the z/OS conversion services.
When setting up the z/OS conversion image for conversions involving any of these forms of UTF-16 then CCSID 1200 must be specified. CCSIDs 1201 and 1202 will not be recognised by z/OS when attempting to create a conversion image.
CONVERSION 850,037;
CONVERSION 850,037,RECLM;