IBM Support

SupportPac CA1T: High availability exits for use with CICS TG

Download


Abstract

SupportPac CA1T provides sample CICS request exits to be used with IBM CICS Transaction Gateway (CICS TG), to create high availability and request validation rules

Download Description

SupportPac CA1T provides sample exits to enable a high availability infrastructure to be created quickly, using rules defined in a simple text based configuration file. On z/OS, a highly available Gateway group can be sysplex-wide, presenting a single entry point to external applications, backed by multiple Gateway daemons and CICS regions acting as together. These rules define a set of policies to validate and workload balance External Call Interface (ECI) requests across defined CICS servers, providing increased availability to CICS applications accessed from remote clients using the facilities of the CICS TG.

Version 1 of this SupportPac provides a set of sample CICS request exits to be used with the CICS Transaction Gateway for z/OS V7.2. Three different CICS request exit implementations are provided to perform either round-robin or failover-based workload balancing, or alternatively perform request validation. Only one CICS request exit can be deployed at any one time, and each exit must be configured using an HFS configuration file as described in the supplied documentation.

Version 3 of this SupportPac provides a combined validation and workload balancing infrastructure to be used with:
  • CICS Transaction Gateway for z/OS V8.0, or later
  • CICS Transaction Gateway for Multiplatforms V8.1, or later
  • CICS Transaction Gateway Desktop Edition V8.1, or later

Note: Version 3 of this SupportPac supersedes Version 2, but remains fully compatible. The same configuration file from CA1T V2.x can be used with CA1T V3.x.

Configuration is based on a flexible set of rules defined in a configuration file. On z/OS, the configuration file can reside either on HFS or in an MVS dataset. Rules for workload balancing can be generic per Gateway, based on server aliases, or on the payload type (for example, channel or commarea). Rules for request validation can be specified based on user IDs, transaction IDs, or program names, and operate as either a allowlist (INCLUSIVE) or blocklist (EXCLUSIVE). All rules can be dynamically updated while the Gateway daemon is running. A configurable retry interval is provided to improve the efficiency of request distribution when using workload balancing.

New in release V3.0.0:
  • EXCLUSIVE validation mode that allows ECI requests to be rejected based on user ID, transaction ID, or program name
  • Support for CICS TG for Multiplatforms V8.1, or later
  • Support for CICS TG Desktop Edition V8.1, or later

What's new in this release (V3.0.1)?
  • Added support for CICS TG V9.1

Possible Uses
Creation of CICS Transaction Gateway high availability configurations or request validation policies.

Skill level required
System administrator with understanding of the configuration of the CICS Transaction Gateway.

Details
Authors: Andrew Smithson, Phil Wakelin, and Rob Jones. CICS TG Development, Hursley
Category: 2
Released: 16Jul10
Last updated: 29Sep14
Current Version: V3.0.1

Prerequisites

Installation Instructions

To download the SupportPac, using secure HTTP:
    1. Click on the link below for the relevant version of the SupportPac and save the compressed file to your local machine.
    2. Extract the saved file to a temporary directory on your local machine. This will create the necessary installation, documentation, and license files.
    3. Follow the instructions in the included documentation to complete installation of this SupportPac on your host system.

[{"INLabel":"CA1T V1.1 ReadMe PDF","INLang":"US English","INSize":"30499 B","INURL":"https://public.dhe.ibm.com/software/htp/cics/support/supportpacs/individual/ca1t_v110.pdf"},{"INLabel":"CA1T V3.0.1 ReadMe PDF","INLang":"US English","INSize":"205486 B","INURL":"https://public.dhe.ibm.com/software/htp/cics/support/supportpacs/individual/ca1t_v301.pdf"}]

Download Package

Two versions of this SupportPac are available:

  • CA1T V1.x is compatible only with CICS TG for z/OS V7.2
  • CA1T V3.x is compatible only with CICS TG for z/OS, CICS TG Multiplatforms, and CICS TG Desktop Edition V8.0, or later.

Off
[{"DNLabel":"CA1T V1.1","DNDate":"21 May 2010","DNLang":"US English","DNSize":"129304 B","DNPlat":{"label":"z/OS","code":"PF035"},"DNURL":"https://www14.software.ibm.com/cgi-bin/weblap/lap.pl?popup=Y&li_formnum=L-APIG-7M2GYV&accepted_url=https://public.dhe.ibm.com/software/htp/cics/support/supportpacs/individual/ca1t_v110.zip","DNURL_FTP":"","DDURL":null},{"DNLabel":"CA1T V3.0.1","DNDate":"29 Sep 2014","DNLang":"US English","DNSize":"419112 B","DNPlat":{"label":"z/OS","code":"PF035"},"DNURL":"https://www14.software.ibm.com/cgi-bin/weblap/lap.pl?popup=Y&li_formnum=L-ACRR-94MNLD&accepted_url=https://public.dhe.ibm.com/software/htp/cics/support/supportpacs/individual/ca1t_v301.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":"CTG","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.2;9.1;9.0;8.1;8.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CTG CICS TG CICS Transaction Gateway

Document Information

Modified date:
29 November 2023

UID

swg24021484