Contents Introducing Oracle Tuxedo Mainframe Adapter for TCP (IMS) What You Need to Know 1‑1 Features/Benefits 1‑2 Oracle TMA TCP for IMS Architecture 1‑2 Oracle Tuxedo Mainframe Adapter for TCP Functionality 1‑3 Domains-based Gateway Connectivity 1‑3 Security 1‑3 Domain Name Server Support 1‑3 Dynamic Configuration 1‑4 Required System Components 1‑4 Oracle TMA Gateway Program 1‑4 IBM LE/370 1‑4 IBM TCP/IP for z/OS 1‑4 IMS Server Transactions 1‑4 IMS Client Transactions 1‑5 Understanding How Oracle TMA TCP for IMS Works Inbound Processing 2‑2 Outbound Processing 2‑3 How Oracle TMA TCP for IMS Is Initialized 2‑4 Processing IMS Server Requests 2‑4 Processing IMS Client Requests 2‑5 Two Phases of an IMS Client Request 2‑5 How Oracle TMA TCP for IMS Processes an IMS Client Request 2‑6 How Oracle TMA TCP for IMS Shuts Down 2‑6 Configuring Oracle Tuxedo Mainframe Adapter for TCP Security Security Checking from Tuxedo to Mainframe 3‑1 Security Checking from Mainframe to UNIX 3‑2 Setting Up Security for TMA TCP for IMS 3‑3 Securing Connections from IMS to UNIX 3‑3 Securing Connections from IMS to IMS 3‑4 Securing Connections from IMS to CICS 3‑4 Securing Services 3‑4 Configuring Oracle TMA TCP for IMS System Configuration Parameters 4‑2 Syntax of the SYSTEM Statement 4‑2 Description of SYSTEM Parameters 4‑2 Defining the Local Host 4‑6 Syntax of the HOST Statement 4‑6 Description of HOST Parameters 4‑7 Defining the Local Gateway 4‑8 Syntax of the GATEWAY TYPE=LOCAL Statement 4‑8 Description of GATEWAY TYPE=LOCAL Parameters 4‑9 Defining Remote Gateways 4‑11 Syntax of the GATEWAY TYPE=REMOTE Statement 4‑12 Description of GATEWAY TYPE=REMOTE Parameters 4‑12 Defining Remote Services 4‑15 Syntax of the SERVICE TYPE=REMOTE Statement 4‑15 Description of SERVICE TYPE=REMOTE Parameters 4‑16 Defining Local Services 4‑17 Syntax of the SERVICE TYPE=LOCAL Statement 4‑17 Description of SERVICES Parameters 4‑17 Dynamically Configuring TMA TCP for IMS 4‑18 Modifying SYSTEM Parameters 4‑19 Writing the Configuration to a File 4‑19 Processing a File 4‑20 Changing Gateway Configurations 4‑20 Adding a Gateway 4‑20 Starting a Gateway 4‑21 Stopping a Gateway 4‑21 Modifying an Existing Gateway 4‑22 Changing IMS Host Configurations 4‑22 Adding a Host 4‑22 Starting a Host 4‑23 Modifying an Existing Host 4‑23 Stopping a Host 4‑24 Changing Remote Service Definitions 4‑24 Adding a Remote Service 4‑25 Stopping a Remote Service 4‑25 Modifying an Existing Remote Service 4‑26 Starting a Remote Service 4‑26 Changing Local Service Definitions 4‑27 Adding a Local Service 4‑27 Stopping a Local Service 4‑27 Modifying an Existing Local Service 4‑28 Starting a Local Service 4‑28 Display Status Information 4‑29 Monitoring Oracle TMA TCP for IMS Testing Connectivity with Remote Systems 5‑1 Monitoring and Troubleshooting OTMA 5‑2 Operating Oracle TMA TCP for IMS 5‑3 Initialization 5‑3 Normal Operation 5‑3 Operator Commands 5‑4 Issuing Session-related Messages 5‑4 Termination 5‑5 SHUTDOWN Command 5‑5 A Client-Initiated Shutdown 5‑5 The Oracle TMA TCP for IMS Message Log 5‑6 Message Format 5‑7 z/OS Console Messages 5‑8 The Server Response Log File 5‑8 Programming Oracle TMA TCP for IMS Programming Your Application 6‑1 Programming Interface 6‑2 IMS Server Requests 6‑2 Message Format 6‑2 Field Descriptions 6‑2 Header Files and Copybooks 6‑3 Returning a Response 6‑3 OTMA Client Gateway 6‑3 IMS Client Requests 6‑4 Message Format 6‑4 Field Descriptions 6‑6 Header Files and Copybooks 6‑8 Error Handling 6‑8 Types of Errors 6‑9 Other Errors 6‑9 How Oracle TMA TCP Gateway Translates Data 6‑9 Oracle Tuxedo Buffer Types 6‑10 Data Translation Rules 6‑10 Strings and Numeric Data: A Closer Look 6‑11 Including NULL Characters in String Length Calculations 6‑12 Converting Numeric Data 6‑12 System Services Descriptions TCP/IP for z/OS A‑1 LE/370 A‑2 z/OS A‑3 Error and Informational Messages Logical Machine IDs B‑1 Messages Returned to the Remote Gateway B‑2 Messages Written to the Oracle TMA TCP for IMS Message Log B‑3 Example Configuration Files Sample JCL and User Exits JCL for Executing TMA TCP for IMS D‑1 Executing TMA TCP for IMS D‑2 Sample User Exits Enabling IMS Clients to Communicate to Remote Services D‑2 OTMA Prerouting User Exit (DFSYPRX0) D‑2 Sample DSECT BEAOTM D‑8 OTMA Destination Resolution User Exit (DFSYDRU0) D‑9 Sample IMS Client and Server Transactions IMS Server Transaction E‑1 BEASVR01 - A Sample IMS Server Transaction E‑2 Notes E‑5 IMS Client Transactions E‑5 Request Phase E‑5 Response Phase E‑6 BEACRQ01 - A Sample IMS Client Request Transaction E‑6 Notes E‑9 BEACRP01 - A Sample IMS Client Response Transaction E‑10 Notes E‑13 BEACRR01 - A Sample IMS Client Request/Response Transaction E‑14 Notes E‑18 Error and Reason Codes Glossary
Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.
