IBM Support

SupportPac CA5F: IBM CICS TG 'gateway' intercept plug-in support

Download


Abstract

SupportPac CA5F allows integration test tools to intercept ECI calls to CICS Transaction Gateway (CICS TG) from Java applications before they are processed by CICS TG.

Download Description

This SupportPac, CA5F, allows integration test tools to intercept External Call Interface (ECI) calls to IBM CICS Transaction Gateway (CICS TG), originating from Java Standard Edition (Java SE) and Java Enterprise Edition (JEE) applications. This, therefore, allows such applications to be tested without requiring a running CICS TG or CICS Transaction Server.

This SupportPac provides updated versions of the CICS TG V8.0 Java base classes and non-extended architecture (non-XA) ECI resource adapter. These updated files support the use of a Gateway intercept plug-in that can intercept application calls made through the Java Application Programming Interfaces (APIs). Documentation for the APIs is also provided by this SupportPac.

When enabled, a Gateway intercept plug-in is notified before a connection to a Gateway daemon is opened or closed, and before a request is sent to the Gateway daemon. Before a connection is opened, the plug-in can change properties of the connection object, and can prevent the connection from opening. Before a request is sent over a connection, the plug-in can change properties of the request object, and can cause the request to be returned to the application without being sent. Before a connection is closed, the plug-in can prevent the connection from closing. This allows a variety of scenarios to be simulated for application testing.

Possible uses:
Allows CICS interactions to be simulated for the purposes of application testing, without requiring a running CICS server or CICS Transaction Gateway.

Skill level required:
Plug-in developers must be familiar with developing applications in Java.

What's new in this release (V1.2)?
  • Updated details in the supporting documentation, under heading "Enabling a Gateway Intercept Plug-in in a JEE environment", relating to the isolation of the installed resource adapters from each other, when installing both cicseci.rar and cicsepi.rar into the same WebSphere Application Server.
  • No changes are required to the SupportPac execution code.

Details:
Author: Andrew Smithson, CICS TG Development, IBM Hursley, UK.
Released: 10Dec12
Last updated: 24Oct14
Current Version: 1.2

Prerequisites

This SupportPac requires IBM CICS Transaction Gateway for z/OS V8.0 or later, or IBM CICS Transaction Gateway for Multiplatforms V8.0 or later.

For Java SE applications, Java 1.5 or later is required.


For JEE applications, a J2EE 1.4 certified application server or a JEE 5 certified application server that successfully runs the JCA resource adapter Install Verification Test (IVT), provided with CICS TG, is required.

Usage is restricted to remote mode topologies for JEE or Java applications. Java applications using the Java base classes must ensure that the only CICS TG jar file on their classpath is the version of ctgclient.jar provided by this SupportPac.

[{"INLabel":"ca5f.pdf (ReadMe)","INLang":"US English","INSize":"137705 B","INURL":"https://public.dhe.ibm.com/software/htp/cics/support/supportpacs/individual/ca5f.pdf"}]

Download Package

To download the SupportPac:
  1. Click on the download link below and save the file to your local machine.
  2. Extract the saved file to a temporary directory on your target machine. This will create the necessary installation files.
  3. Follow the instructions in the included documentation to complete installation of this SupportPac.

Off
[{"DNLabel":"ca5f.zip","DNDate":"24 Oct 2014","DNLang":"US English","DNSize":"14794112 B","DNPlat":{"label":"z/OS","code":"PF035"},"DNURL":"https://www14.software.ibm.com/cgi-bin/weblap/lap.pl?popup=Y&li_formnum=L-GKSE-N4XCZN&accepted_url=https://public.dhe.ibm.com/software/htp/cics/support/supportpacs/individual/ca5f.zip","DNURL_FTP":"","DDURL":null}]

Technical Support

BY DOWNLOADING, INSTALLING, COPYING, ACCESSING, OR OTHERWISE USING THE FREE-OF-CHARGE SUPPORTPAC, YOU AGREE THAT THE SUPPORTPAC IS COPYRIGHTED AND LICENSED BY INTERNATIONAL BUSINESS MACHINES CORPORATION, OR ITS AFFILIATE, SOLELY FOR YOUR INTERNAL USE, AND IS NOT SOLD. THE SUPPORTPAC IS PROVIDED ‘AS IS’ WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IBM PRODUCT SUPPORT IS NOT OFFERED FOR THE SUPPORTPAC. OTHER IBM LICENSE TERMS MAY ALSO APPLY TO THE SUPPORTPAC AND IN THE EVENT (AND TO THE EXTENT ONLY) OF ANY CONFLICT, THOSE LICENSE TERMS WILL APPLY. IF YOU ARE ACCEPTING THESE TERMS ON BEHALF OF ANOTHER PERSON OR A COMPANY OR OTHER LEGAL ENTITY, YOU REPRESENT AND WARRANT THAT YOU HAVE FULL AUTHORITY TO BIND THAT PERSON, COMPANY, OR LEGAL ENTITY TO THESE TERMS. IF YOU DO NOT AGREE TO THESE TERMS:

  • DO NOT DOWNLOAD, INSTALL, COPY, ACCESS, CLICK ON AN "ACCEPT" BUTTON, OR USE THE SUPPORTPAC; AND
  • PROMPTLY DESTROY ALL COPIES OF THE SUPPORTPAC AND RELATED DOCUMENTATION.
To view the available collection of CICS SupportPacs, visit the CICS SupportPacs Home Page

[{"Product":{"code":"SSGMJ2","label":"CICS Transaction Gateway"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"SupportPac","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"9.0;8.1;8.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICS TG CICSTG CTG

Document Information

Modified date:
29 November 2023

UID

swg24033968

Page Feedback