Troubleshooting
Problem
You are unable to set or get the contents of the TCTUA because the address of the TCTUA is returned as X'FF000000'. In this case, you are using EXEC CICS ADDRESS TCTUA(W-TCTUA-PTR) to obtain the address of the TCTUA.
Cause
The hexadecimal FF000000 implies that no TCTUA exists. This might be because the USERAREALEN on the TYPETERM is set to 0.
Resolving The Problem
Do the following to update the USERAREALEN to a length in bytes between 1 and 255:
- If you already have your own TYPETERM definition, alter the USERAREALEN to the size of TCTUA that is required. Otherwise, define a new TYPETERM definition with the required USERAREALEN.
- Re-install the updated TYPETERM definition or install the new TYPETERM definition.
- Specify this TYPETERM on the TERMINAL definition to ensure that it is the one picked up when the TERMINAL is installed.
- Re-install the TERMINAL to pick up the new USERAREALEN.
Note: The TYPETERM definition must already be installed when you install tthe TERMINAL definition.
[{"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":"Terminal Control","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"4.1;3.2;3.1","Edition":"","Line of Business":{"code":"LOB70","label":"Z TPS"}}]
Product Synonym
CICS/TS CICS TS CICS Transaction Server
Was this topic helpful?
Document Information
Modified date:
05 January 2026
UID
swg21384107