External Interfaces Guide
Total Page:16
File Type:pdf, Size:1020Kb
CICS Transaction Server for z/OS 5.4 External Interfaces Guide IBM Note Before using this information and the product it supports, read the information in “Notices” on page 161. This edition applies to the IBM CICS® Transaction Server for z/OS® Version 5 Release 4 (product number 5655-Y04) and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright International Business Machines Corporation 1974, 2020. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About this PDF.......................................................................................................v Chapter 1. CICS external interfaces....................................................................... 1 Interfaces to CICS transactions and programs...........................................................................................1 The client/server model......................................................................................................................... 2 Distributed computing............................................................................................................................2 TCP/IP protocols.....................................................................................................................................3 ONC and DCE concepts.......................................................................................................................... 6 EXCI concepts.........................................................................................................................................6 3270 bridge concepts............................................................................................................................ 7 Chapter 2. Bridging to 3270 transactions................................................................9 Introduction to the 3270 bridge..................................................................................................................9 The Link3270 bridge mechanism.......................................................................................................... 9 The bridge facility.................................................................................................................................10 The application data structure (ADS).................................................................................................. 11 Link3270 programming considerations...............................................................................................11 Transaction Routing considerations.................................................................................................... 15 Using the Link3270 bridge.........................................................................................................................17 Establish Link3270 suitability..............................................................................................................18 Writing the Link3270 client..................................................................................................................18 Using Link3270 messages................................................................................................................... 22 Using Link3270 single transaction mode............................................................................................ 25 Using Link3270 session mode............................................................................................................. 26 Calling the Link3270 bridge................................................................................................................. 31 Using data conversion with Link3270..................................................................................................32 Managing the Link3270 bridge environment............................................................................................ 33 Defining Link3270 system initialization parameters...........................................................................34 Defining the bridge facility .................................................................................................................. 34 Administering the Link3270 bridge...........................................................................................................40 INQUIRE/SET AUTOINSTALL with the Link3270 bridge..................................................................... 40 INQUIRE/SET BRFACILITY with the Link3270 bridge........................................................................ 40 INQUIRE TASK with the Link3270 bridge............................................................................................41 INQUIRE/SET TRACETYPE with the Link3270 bridge.........................................................................41 INQUIRE TRANSACTION with the Link3270 bridge........................................................................... 41 XPI commands for the Link3270 bridge..............................................................................................41 Using Link3270 bridge load routing.....................................................................................................42 Link3270 message formats.......................................................................................................................43 Link3270 message header (BRIH).......................................................................................................44 Inbound Link3270 vectors...................................................................................................................51 Outbound Link3270 vectors................................................................................................................ 57 Link3270 ADS descriptor..................................................................................................................... 73 Link3270 diagnostics.................................................................................................................................76 BRIH-RETURNCODE values................................................................................................................. 77 Link3270 sample programs.......................................................................................................................82 About the NACT transaction................................................................................................................ 82 Running the sample client programs...................................................................................................83 Setting up the NACT transaction .........................................................................................................86 Chapter 3. CICS ONC RPC support........................................................................89 iii Introduction to ONC RPC...........................................................................................................................89 ONC RPC concepts............................................................................................................................... 90 ONC RPC facilities................................................................................................................................ 91 ONC RPC naming and routing.............................................................................................................. 93 CICS ONC RPC concepts ..................................................................................................................... 94 Setting up CICS ONC RPC .......................................................................................................................102 CICS ONC RPC setup tasks................................................................................................................ 103 Defining CICS ONC RPC resources to CICS....................................................................................... 104 Configuring CICS ONC RPC using the connection manager................................................................... 106 Starting the connection manager...................................................................................................... 106 Updating CICS ONC RPC status......................................................................................................... 109 Enabling CICS ONC RPC.....................................................................................................................111 Defining, saving, modifying, and deleting 4-tuples...........................................................................113 Registering the 4-tuples.................................................................................................................... 118 Unregistering 4-tuples....................................................................................................................... 118 Disabling CICS ONC RPC....................................................................................................................121 Updating the CICS ONC RPC data set................................................................................................122 Processing the alias list......................................................................................................................126 Developing CICS ONC RPC