Front cover IBM z/OS Container Extensions (zCX) Use Cases Lydia Parziale Marco Egli Maike Havemann Subhajit Maitra Eric Marins Edward McCarthy Redbooks IBM Redbooks IBM z/OS Container Extensions (zCX) Use Cases October 2020 SG24-8471-00 Note: Before using this information and the product it supports, read the information in “Notices” on page vii. First Edition (October 2020) This edition applies to Version 2, Release 4, z/OS, Product number 5650-ZOS. © Copyright International Business Machines Corporation 2020. 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 . vii Trademarks . viii Preface . ix Authors. ix Now you can become a published author, too! . .x Comments welcome. xi Stay connected to IBM Redbooks . xi Chapter 1. IBM z/OS Container Extensions overview . 1 1.1 Why use IBM z/OS Container Extensions?. 2 1.2 IBM zCX architecture . 2 1.3 zCX updates . 3 1.3.1 zCX 90-day trial . 4 1.3.2 Docker proxy certificate support . 4 1.3.3 IBM License Manager Tool support . 5 1.3.4 Performance Improvements (zCX and z/OS Communication Server) . 6 1.3.5 Private CA certificate support for Docker proxy . 7 1.3.6 Vector / SIMD Support . 7 Part 1. Integration . 9 Chapter 2. Apache Kafka and ZooKeeper. 11 2.1 ZooKeeper overview . 13 2.2 ZooKeeper configuration. 13 2.2.1 Persistence with Docker volumes . 13 2.2.2 ZooKeeper default service ports . 14 2.2.3 ZooKeeper configuration file . 14 2.3 Kafka overview . 15 2.4 Kafka configuration . 17 2.4.1 Persistence with Docker volumes . 17 2.4.2 Kafka configuration file . 17 2.5 Kafka configuration on one zCX instance . 18 2.5.1 Creating the Kafka cluster. 18 2.6 Kafka configuration on three zCX instances . 39 2.7 Diagnostic commands. 60 2.7.1 ZooKeeper . 60 2.8 Integrating IBM Z applications and Kafka . 61 2.8.1 Event-driven application and Apache Kafka . 61 2.8.2 Key usage patterns of Apache Kafka and IBM Z . 62 2.8.3 Unlocking data from IBM Z to Kafka . 63 2.9 Integration of IBM MQ with Apache Kafka . 64 2.9.1 Setting up IBM MQ connectors to run on IBM z/OS . 64 2.9.2 Starting Kafka Connect on z/OS . 70 2.9.3 Status of plug-ins and connectors. 70 2.9.4 Sending messages from IBM MQ to Kafka. 71 2.10 Sending CICS events to Kafka . 74 2.10.1 Why CICS events? . 74 2.10.2 CICS to Kafka overview . 74 © Copyright IBM Corp. 2020. iii 2.10.3 Example components . 76 2.10.4 ZKAFKA Java program . 77 2.10.5 Testing the example . 78 2.10.6 z/OS Explorer . 80 2.10.7 Developing the ZKAFKA Java program . 84 2.10.8 Creating CICS bundle for Java program. 91 2.10.9 Defining a CICS event . 98 Chapter 3. IBM App Connect Enterprise. 103 3.1 Technical and architectural concepts of ACE . 104 3.1.1 Key concepts of ACE . 106 3.1.2 Runtime components of ACE . 107 3.1.3 ACE run time in zCX . 108 3.1.4 Reasons to run ACE on zCX . 109 3.2 Installing IBM App Connect Enterprise . 109 3.2.1 Obtaining the ACE installation binaries. 109 3.2.2 Obtaining the IBM App Connect Enterprise Docker container build source . 111 3.2.3 Building the Dockerfile for the ACE image . 114 3.2.4 Building the ACE Docker image . 116 3.3 Configuration details . 118 3.4 Deploying an application to ACE to integrate with CICS. 119 3.4.1 Deploying to ACE run time in zCX . 122 3.4.2 Using the Web UI to test deployed REST APIs . 125 Chapter 4. IBM Aspera fasp.io Gateway . 129 4.1 Introduction to Aspera FASP.io Gateway . 130 4.2 Aspera configuration details . 131 4.2.1 Configuration Part 1: fasp.io on the first zCX (sc74cn09) instance. 132 4.2.2 Configuration Part 2: fasp.io on the second zCX (sc74cn04) instance. 137 4.3 Integration with IBM MQ Advanced for z/OS, VUE . 141 4.3.1 Topology . 141 4.3.2 Creating a transmission queue on MQZ1 . 141 4.3.3 Creating sender channel on MQZ1. 142 4.3.4 Creating receiver channel on MQZ2 . ..