Using DFHTCTxx

To translate national characters which are not handled by UCTRAN, you can modify the translation table in the terminal control table.

About this task

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:

Note: If you are already using a customized TCT rather than DFHTCTDY (that is, something other than 'NO' or 'DY' is specified on the SIT TCT parameter), you must add your translation code to the TCT you are using.

Procedure

  1. Take a copy of the DFHTCTDY assembler source file. CICS provides this in the CICSTS54.CICS .SDFHSAMP library.
  2. Modify the translation table in the source file, as shown in Figure 1.
  3. Save the source file as DFHTCTxx, where 'xx' is any 2–character suffix other than 'DY'.
  4. Use the CICS-supplied DFHAUPLE job to assemble, define to SMP/E, and linkedit the new table.
  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.

Example

Figure 1 shows a suggested way to code the assembler source statements to translate your national characters.
Figure 1. Suggested coding for national language character translation
 MACRO
NATLANG
DFHUCTRT CSECT Resume UCTRAN table CSECT
.*
.* This example translates lowercase 'a' ( EBCDIC X'81') to
.* uppercase 'A' (EBCDIC X'C1') for a US code page.
.*
ORG TCZUCTAB+X'81' Reset the counter to the
character to be translated.
DC X'C1' Declare the replacement
character as a constant.
.*
.* Repeat the above two statements for each extra character you want
.* to be translated.
.*
ORG , Reset the location counter
&SYSLOC LOCTR Resume previous location counter
MEND End of macro definition
DFHTCT TYPE=INITIAL,SUFFIX=xx, *
MIGRATE=COMPLETE, *
ACCMETH=(VTAM), *
DUMMY=DUMMY
NATLANG Execute NATLANG
DFHTCT TYPE=FINAL
END DFHTCTBA


dfha3c1.html | Timestamp icon Last updated: Monday, 5 June 2017