IBM Support

CICS input map with mixed case is translated to upper case even after SET TERMINAL NOUCTRAN

Troubleshooting


Problem

You have a CICS application that uses an input map that contains several input fields that have mixed case values. For this input map, you do an EXEC CICS SET TERM(EIBTRIMD) NOUCTRAN followed by a EXEC CICS SEND MAP and then a RETURN(tranid). The next task does a RECEIVE MAP with ASIS. However, the input fields are all getting translated to upper case.

Cause

Transaction PROFILE UCTRAN specification was incorrect. Since UCTRAN(YES) was specified on the PROFILE definition for the transaction, this was overriding the EXEC CICS TERMINAL NOUCTRAN command.

Resolving The Problem

There are two places where you can define upper case translation. In the TYPETERM definition and in the PROFILE associated with the transaction definition.  The documentation for both of these definitions include the following table entitled The effect of UCTRAN attributes on tranid and data translation, that shows the possible combinations and their effect on translation.
The effect of UCTRAN attributes on tranid and data translation
To have one transaction run in lower case and the rest in upper case:
  1. Define the TYPETERM with UCTRAN set to NO or TRANID.
  2. Specify a PROFILE with UCTRAN(NO) in the TRANSACTION definition for the lower case transaction.
  3. Specify a PROFILE with UCTRAN(YES) in the TRANSACTION definitions for the upper case transactions.

Alternatively, you can control uppercase translation from within an application program, by using the EXEC CICS SET TERMINAL UCTRAN or NOUCTRAN command to change the setting from the TYPETERM. But if you specify NOUCTRAN, you would also have to specify UCTRAN(NO) on the PROFILE definition to stop upper case translation from occurring. Of course, this only takes effect for transactions after the one in which the command is issued.  For further information on this command see EXEC CICS SET TERMINAL and uppercase translation.

It is also possible to change the UCTRAN definition for the terminal that came from the TYPETERM using the CEOT transaction on your own terminal. You can use CEOT to turn off upper case translation, run the lower case transaction, and then use CEOT to turn upper case translation back on. Topic CEOT - Terminal Status in the CICS TS documentation discusses how you can use the CEOT transaction. To turn upper case translation on for your terminal, you can enter:
CEOT UCTRAN

and to turn upper case translation off you can enter:
CEOT NOUCTRAN

Note: With UCTRAN(tranid) specified on the TYPETERM and UCTRAN(NO) on the transaction PROFILE the transaction id will always be translated to uppercase but the data will not be translated.

[{"Type":"MASTER","Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"ARM Category":[{"code":"a8m0z00000007d1AAA","label":"Developing applications"},{"code":"a8m0z00000007TbAAI","label":"Terminals"}],"ARM Case Number":"","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"All Versions"}]

Product Synonym

CICS/TS CICS TS CICS Transaction Server

Document Information

Modified date:
04 March 2024

UID

swg21389964