How to setup virtual terminal selection for a CICSTOR / CICSAOR environment?

Document ID : KB000052513
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

When I logon to a CICSTOR region and the transaction is executed in a CICSAOR region I end up with a sensecode 0824 and the transaction abends.

The virtual terminal I use for the CICSTOR has already a session to the CICSAOR region.

Solution:

This problem is caused by using the same GROUP virtual terminal for both applications, CICSTOR and CICSAOR regions.

You must setup TPX in a way that TPX does not select the same virtual terminal for CICSTOR and CICSAOR regions.

If you define one of them with TYPE=UNQ and the other with TYPE=GRP in ACT you are fine because a unique and a group terminal can not be the same.

If you decide to use TYPE=GRP virtual terminals for both CICSTOR and CICSAOR region you must setup some masking rules.


Assume you have 300 group VTs defined TPXGR000 - TPXGR299. You want to use TPXGR000 - TPXGR199 for logons to the CICSTOR and TPXGR200 - TPXGR299 for logons to theCICSAOR region.

Here the steps to do:

  1. Create a virtual terminal masking table - we call it CICS here

  2. Create 2 entries - lets say CICSTOR and CICSAOR

    Masking Rules Table: CICS
    Masking Rules Table Entry CICSAORCICSTOR
  3. In the entry for CICSTOR define

    Masking Rules Table: CICS
    Masking Rules Table Entry: CICSTOR
    Physical Terminal     Virtual TerminalMasking Rule          Masking Rule--------                TPXGR0----------                TPXGR1--
  4. In the entry for CICSAOR define

    Masking Rules Table: CICS
    Masking Rules Table Entry: CICSAOR
    Physical Terminal       Virtual TerminalMasking Rule            Masking Rule--------                TPXGR2--
  5. In the ACT for CICSTOR application define CICSTOR as masking rule.

  6. In the ACT for CICSAOR application define CICSAOR as masking rule.

  7. Define VMSK=CICS in the TPX procedure or use
    SMRT - 10 Startup Parameters to define CICS as masking table.

  8. Recycle TPX

    TPX will now use TPXGR000 - TPXGR199 for CICSTOR and TPXGR200 - TPXGR299 for CICSAOR. TPX will select the first available VT within these ranges.

For the decision which way to go keep in mind that a TYPE=UNQ VT can only have one session whereas a TYPE=GRP VT can share sessions to different applications.