Table of Contents

• Title and Copyright Information
• 1 Introducing Oracle Tuxedo Mainframe Adapter for TCP Gateway
  • 1.1 What You Need to Know
  • 1.2 Oracle TMA TCP Gateway and the Oracle Tuxedo Architecture
  • 1.3 Operational Considerations
  • 1.4 Oracle TMA TCP Functionality
    • 1.4.1 Domains-based Gateway Connectivity
    • 1.4.2 Security
    • 1.4.3 Connection Multiplexing
    • 1.4.4 Domain Name Server Support
  • 1.5 GWIDOMAIN Gateway Component
  • 1.6 How TMA TCP Gateway Affects Oracle Tuxedo Application Programs
    • 1.6.1 VIEW Definitions
    • 1.6.2 FML Buffer Support
  • 1.7 How TMA TCP Gateway Affects Oracle Tuxedo Administration
• 2 Understanding How Oracle TMA TCP Gateway Works
  • 2.1 Planning Your Configuration
  • 2.2 Initializing TMA TCP Gateway
  • 2.3 Processing Local Service Requests
    • 2.3.1 Step 1: Receiving a Service Request from Oracle Tuxedo Software
    • 2.3.2 Step 2: Connecting to a Remote System
    • 2.3.3 Step 3: Converting Input Buffer Types
    • 2.3.4 Step 4: Translating Input Data
    • 2.3.5 Step 5: Transmitting the Service Request
    • 2.3.6 Step 6: Receiving a Reply
    • 2.3.7 Step 7: Translating the Reply
    • 2.3.8 Step 8: Converting Output Data
    • 2.3.9 Step 9: Sending the Reply to the Caller
  • 2.4 Processing Remote Service Requests
  • 2.5 Processing Shut Down Requests
  • 2.6 Programming Considerations
    • 2.6.1 Input and Output Issues
      • 2.6.1.1 Preparing Input and Output Data with TMA TCP Gateway
      • 2.6.1.2 Service Request Parameters
      • 2.6.1.3 Output Data Considerations
    • 2.6.2 Limitations on the Use of Certain ATMI Functions
      • 2.6.2.1 Conversational Communication Functions
      • 2.6.2.2 Non-Transactional Communications
      • 2.6.2.3 The tpsprio( ) and tpgprio( ) Functions
      • 2.6.2.4 The tpbroadcast() and tpnotify() Functions
    • 2.6.3 Error Handling
      • 2.6.3.1 Gateway Errors
      • 2.6.3.2 Remote System Failures
      • 2.6.3.3 Application Errors
• 3 Configuring Oracle TMA TCP Gateway for Data Mapping
  • 3.1 Converting Input and Output Data
    • 3.1.1 Buffers and Records
    • 3.1.2 Buffers Received from Local Programs
    • 3.1.3 Records Received from Remote Programs
  • 3.2 Managing Parameters for Buffer and Record Conversion
    • 3.2.1 Parameters for Locally Originated Calls
      • 3.2.1.1 Guidelines for Mapping Input Buffers to Input Records
      • 3.2.1.2 Guidelines for Mapping Output Records to Output Buffers
    • 3.2.2 Parameters for Remotely Originated Calls
      • 3.2.2.1 Guidelines for Mapping Input Records to Input Buffers
      • 3.2.2.2 Guidelines for Mapping Output Buffers to Output Records
  • 3.3 Mapping Buffers to Records
    • 3.3.1 Setting the INBUFTYPE and INRECTYPE Parameters
  • 3.4 Mapping Records to Buffers
    • 3.4.1 Setting the OUTRECTYPE and OUTBUFTYPE Parameters
    • 3.4.2 Creating VIEW Definitions to Facilitate Buffer Conversion
      • 3.4.2.1 Preparing VIEW Definitions
    • 3.4.3 Translating Data
      • 3.4.3.1 Data Translation Rules
      • 3.4.3.2 NULL Characters in String Length Calculations (C Programs)
      • 3.4.3.3 NULL Characters in String Length Calculations (COBOL Programs)
      • 3.4.3.4 Converting Numeric Data
  • 3.5 Encoding COBOL Data Types
    • 3.5.1 Using the COBOL Data Encoding Library
      • 3.5.1.1 Encoding for All Services
      • 3.5.1.2 Encoding Messages To and From a Specific Host
  • 3.6 Using Code Page Translation Tables
    • 3.6.1 Specifying a Translation Table
    • 3.6.2 How the Translation Tables Work
    • 3.6.3 Troubleshooting Translation Table Errors
    • 3.6.4 Sample DMCONFIG Definition for ASCII to EBCDIC Translations
  • 3.7 Using Multibyte Character Set (MBCS) Translations
    • 3.7.1 Sample DMCONFIG Definition for MBCS Translations
• 4 Setting Up Security for Oracle TMA TCP Gateway
  • 4.1 Security Checking from Tuxedo to Mainframe
  • 4.2 Security Checking from Mainframe to Tuxedo
  • 4.3 Setting Up Security
    • 4.3.1 Tuxedo Security Plug-in
    • 4.3.2 Built-in Tuxedo Security
  • 4.4 Sample Security Files
    • 4.4.1 User Files
    • 4.4.2 Group File
    • 4.4.3 ACL File
  • 4.5 Data Area Security
    • 4.5.1 Enabling Data Area Security
    • 4.5.2 Format
  • 4.6 Using TLS Encryption
• 5 Configuring Oracle TMA TCP Gateway
  • 5.1 Updating the Oracle Tuxedo UBBCONFIG File
    • 5.1.1 Updating the GROUPS Section to Establish a Server Group
      • 5.1.1.1 Syntax
      • 5.1.1.2 Example
    • 5.1.2 Updating the SERVERS Section
      • 5.1.2.1 Syntax
      • 5.1.2.2 Using the Request Logging Option
      • 5.1.2.3 Other Options for Configuring Servers
  • 5.2 Specifying Parameters in the GWICONFIG File
    • 5.2.1 Defining the GLOBAL Section of the GWICONFIG File
    • 5.2.2 Defining the NATIVE Section of the GWICONFIG File
    • 5.2.3 Defining the FOREIGN Section of the GWICONFIG File
    • 5.2.4 Defining the LOCAL_SERVICES Section of the GWICONFIG File
    • 5.2.5 Defining the REMOTE_SERVICES Section of the GWICONFIG File
  • 5.3 Defining Domain Configurations in the DMCONFIG File
    • 5.3.1 DM_LOCAL_DOMAINS Section
    • 5.3.2 DM_REMOTE_DOMAINS Section
    • 5.3.3 DM_ACCESS_CONTROL Section
    • 5.3.4 DM_LOCAL_SERVICES Section
    • 5.3.5 DM_REMOTE_SERVICES Section
    • 5.3.6 DM_ROUTING Section
    • 5.3.7 Sample DMCONFIG File
• 6 Starting Oracle TMA TCP Gateway
  • 6.1 Setting Environment Variables
  • 6.2 Invoking TMA TCP Gateway
  • 6.3 Administering the Gateways
• 7 Error and Information Messages
• 8 Code Page Translation Tables
  • 8.1 Modifying a Code Page Translation Table
  • 8.2 Default Tuxedo
  • 8.3 United States (00819x00037)
  • 8.4 Germany (00819x00273)
  • 8.5 Finland/Sweden (00819x00278)
  • 8.6 Spain (00819x00284)
  • 8.7 Great Britain (00819x00285)
  • 8.8 France (00819x00297)
  • 8.9 Belgium (00819x00500)
  • 8.10 Portugal (00819x00860)
  • 8.11 Latin-1 (00819x01047)
  • 8.12 Latin-2 (00912x00870)