CICS Transaction Gateway (CTG) testing and VSE recording
search cancel

CICS Transaction Gateway (CTG) testing and VSE recording


Article ID: 115521


Updated On:


CA Application Test CA Continuous Application Insight (PathFinder) Service Virtualization


The CICS Transaction Gateway (CTG)  is a way to run (LINK) CICS programs from a Java program.

The CTG virtualization is done “on the wire”, so the mainframe is needed for recording only. Playback virtualizes out the mainframe completely.

The virtual service is deployed on the workstation, not to the mainframe. It does not involve the mainframe agents.

The mapping for CTG is different than for CICS virtualization (which uses matchType="metaData" key="Program_name" value="DEMOINQ "). CTG Copybook processing uses matchType="operation" key="DEMOINQ"

We support CTG 7.2, 8.x, and 9.x.



All supported DevTest releases.




CTG recording and playback walkthrough

Connect to ETPGZOS vpn
In Workstation, create project CTG
Copy contents of unzipped ..\ctgclnt\CTG_Clients\Data to project Data folder
In Workstation:
Start the VSE Recorder
Enter info for a CTG recording:

Enter the following. The “Listen/Record on port” is the port number that the DevTest “listener” aka “man in the middle” listens on in your workstation. It can be any port that is not in use on your workstation. I use a port number different than the actual CTG port number on the mainframe to avoid confusion. The remaining info is the IP address and port number of the CTG server on the mainframe that DevTest will forward things to.


Recording begins:


For this example, we will use the IBM sample client. Either would work.

Double click on ..\ctgclnt\CTG_Clients\IBM_Sample\DEMOINQ_Virt.bat​

Recordings appear:



Add copybook data protocols:



Add copybook config:



This panel shows up because we did not check the “Treat all transactions as stateless” box earlier.


We don’t need to do anything here – click Next.

Save the recording config with the little folder in the lower right corner if you want.


Click Next.
Edit the second transaction, first exact response (after the meta response):



Deploy the virtual service

Double click on ..\ctgclnt\CTG_Clients\IBM_Sample\DEMOINQ_Virt.bat

And see the edits in the response (DEMOGETN-MSG).

The virtual service can be stopped in the Portal, or use this shortcut:

Open a command prompt.

Change into your DevTest bin folder.

cd C:\Program Files\CA\DevTestxx.x.x\bin

List virtual services.

VSEManager --vse VSE --username=admin --password=admin --status all

Stop the virtual services.

VSEManager --vse VSE --username=admin --password=admin --stop DEMOINQ

Additional Information

Refer to section "CICS Transaction Gateway (ECI) Transport Protocol" in the documentation of the DevTest release you are running.


1558695311487000115521_sktwi1f5rjvs16i3l.png get_app
1558695309805000115521_sktwi1f5rjvs16i3k.png get_app
1558695308051000115521_sktwi1f5rjvs16i3j.png get_app
1558695306177000115521_sktwi1f5rjvs16i3i.png get_app
1558695304174000115521_sktwi1f5rjvs16i3h.png get_app
1558695302220000115521_sktwi1f5rjvs16i3g.png get_app
1558695300428000115521_sktwi1f5rjvs16i3f.png get_app
1558695298556000115521_sktwi1f5rjvs16i3e.png get_app
1558695296574000115521_sktwi1f5rjvs16i3d.png get_app
1558695294867000115521_sktwi1f5rjvs16i3c.png get_app
1558695292921000115521_sktwi1f5rjvs16i3b.png get_app