Front cover CICS Transaction Gateway V5 The WebSphere Connector for CICS Install and configure the CICS TG on z/OS, Linux, and Windows Configure TCP/IP, TCP62, APPC or EXCI connections to CICS TS V2.2 Deploy J2EE applications to WebSphere Application Server V4 on z/OS or Windows Phil Wakelin John Joro Kevin Kinney David Seager ibm.com/redbooks International Technical Support Organization CICS Transaction Gateway V5 The WebSphere Connector for CICS August 2002 SG24-6133-01 Note: Before using this information and the product it supports, read the information in “Notices” on page ix. Second Edition (August 2002) This document updated on June 26, 2009. This edition applies to CICS Transaction Gateway V5.0 and CICS Transaction Server for z/OS V2.2 for use on the z/OS and Windows operating systems. © Copyright International Business Machines Corporation 2001 2002. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Notices . ix Trademarks . x Preface . xi The team that wrote this redbook. xii Become a published author . xiii Comments welcome. xiii Summary of changes . xv August 2002, Second Edition . xv Part 1. Introduction . 1 Chapter 1. CICS Transaction Gateway . 3 1.1 CICS TG: Infrastructure. 4 1.1.1 Client daemon . 5 1.1.2 Gateway daemon . 7 1.1.3 Configuration Tool. 9 1.1.4 Terminal Servlet . 10 1.2 CICS TG: Interfaces . 11 1.2.1 External Call Interface. 11 1.2.2 External Presentation Interface. 12 1.2.3 External Security Interface . 13 Part 2. Configuring CICS connections . 15 Chapter 2. APPC connections to CICS . 17 2.1 Introduction to APPC. 18 2.1.1 Software checklist . 19 2.1.2 Definitions checklist. 19 2.2 APPC connections in CICS . 21 2.2.1 CICS CONNECTION definitions . 21 2.2.2 CICS SESSIONS definitions . 22 2.2.3 CICS connection autoinstall . 23 2.3 APPC connections and VTAM . 25 2.3.1 VTAM application major node . 26 2.3.2 VTAM logon mode table . 27 2.3.3 VTAM switched major node . 27 2.4 Configuring IBM Personal Communications . 28 © Copyright IBM Corp. 2001 2002. All rights reserved. iii 2.5 APPC definitions for the CICS TG. 29 2.6 Problem determination . 35 2.6.1 Tips and utilities . 35 2.6.2 Tracing . 36 Chapter 3. TCP62 connections to CICS . 39 3.1 Introduction to TCP62 . 40 3.1.1 Software checklist . 42 3.1.2 Definitions checklist. 42 3.2 APPC connections in CICS . 43 3.3 VTAM definitions . 44 3.4 TCP62 definitions for the CICS TG . 46 3.5 Problem determination . 55 3.5.1 Tips and utilities . 55 3.5.2 Tracing . 61 Chapter 4. EXCI connections to CICS . 65 4.1 Introduction to EXCI . 66 4.1.1 Software checklist . 67 4.1.2 Definitions checklist . 67 4.2 EXCI connections . 67 4.2.1 EXCI CONNECTION definitions . 68 4.2.2 EXCI SESSIONS definitions . 70 4.2.3 EXCI options table: DFHXCOPT. 72 4.2.4 EXCI user-replaceable module: DFHXCURM. 73 4.2.5 Transactional EXCI . 73 4.3 EXCI definitions for the CICS TG . 74 4.4 Problem determination . 75 4.4.1 Tips and utilities . 75 4.4.2 Tracing . 80 Chapter 5. TCP/IP connections to CICS . 81 5.1 Introduction to ECI over TCP/IP . 82 5.1.1 Software checklist . 83 5.1.2 Definitions checklist. 84 5.2 TCP/IP definitions for CICS. 84 5.3 TCP/IP definitions for the CICS TG. 87 5.4 Problem determination . 90 5.4.1 Tips and utilities . 90 5.4.2 Tracing . 97 Chapter 6. CICS TG security scenarios. 99 6.1 Introduction to CICS security. 100 6.2 CICS TG security scenarios . 101 iv CICS Transaction Gateway V5 6.2.1 ECI to CICS TG for z/OS (EXCI). 102 6.2.2 ECI to CICS TG for Windows (TCP/IP). 112 6.2.3 EPI to CICS TG for Windows (TCP62) . 115 6.3 Problem determination . 126 6.3.1 Tips and utilities . 126 Part 3. Gateway daemon scenarios. 131 Chapter 7. TCP connections to the Gateway daemon on z/OS. 133 7.1 Preparation . 134 7.1.1 Software checklist . 135 7.1.2 Definitions checklist. ..