Appendix E. Uppercase Translation; Translating National Characters To Uppercase; Using The Xzcin Exit; Using Dfhtctxx - IBM SC34-6814-04 Customization Manual

Appendix E. Uppercase translation

This appendix describes how to translate lower- and mixed-case characters to
uppercase. "Translating national characters to uppercase" describes how to
translate national characters that CICS cannot handle by standard means.
"Translating TS data sharing messages to uppercase" on page 876 describes how
to translate operator messages produced by CICS temporary storage data sharing.

Translating national characters to uppercase

In CICS, translation of terminal user-input to uppercase characters can be done
either by using the UCTRAN option on the PROFILE and TYPETERM definitions, or
by using the EXEC CICS SET TERMINAL(termid) UCTRANST command.
However, some languages have characters which are not part of the set of EBCDIC
characters translated by UCTRAN, and so are never translated to uppercase,
regardless of what you have specified on your resource definitions. To translate
these national characters, you have two options:
v Use the XZCIN exit
v Create a new terminal control table (TCT), based on your current TCT (or on the
Whichever method you use, the Character Data Representation Architecture Level 1
- Registry manual, SC09-1391-00, is a useful reference for information on code
pages.

Using the XZCIN exit

XZCIN is described on page 121. To use it for uppercase translation, you must
supply your own translation routine, which is then invoked when terminal input
occurs.

Using DFHTCTxx

To translate national characters which are not handled by UCTRAN, you can modify
the translation table in the terminal control table.
If you use RDO for all your terminals and have TCT=NO specified in your SIT or its
overrides, CICS uses the dummy TCT, DFHTCTDY, to create control blocks for
RDO-defined and autoinstalled terminals. It is not recommended that you modify
DFHTCTDY directly. Instead, take a copy of the DFHTCTDY source file, save it
under a new name, and modify the copy. The steps you need to follow are:
1. Take a copy of the DFHTCTDY assembler source file. CICS provides this in the
2. Modify the translation table in the source file, as shown in Figure 133 on page
3. Save the source file as DFHTCTxx, where 'xx' is any 2–character suffix other
4. Use the CICS-supplied DFHAUPLE job to assemble, define to SMP/E, and
5. Specify the 2–character suffix of your new TCT on the SIT TCT parameter.
6. Restart CICS, so that the new TCT takes effect.
© Copyright IBM Corp. 1977, 2011
dummy TCT, DFHTCTDY, if you have TCT=NO specified in the SIT), and modify
the translation table in it.
CICSTS32.CICS.SDFHSAMP library.
876.
than 'DY'.
linkedit the new table.
875