Table of Contents Understanding the Oracle Tuxedo Mainframe Adapter for SNA Solution Oracle Tuxedo Mainframe Adapter for SNA Overview The Oracle Tuxedo Mainframe Adapter for SNA Architecture The Oracle Tuxedo Mainframe Adapter for SNA Gateway Communications Resource Manager Configuring and Starting the System Preparing for Configuration Determine Your System Architecture Oracle Tuxedo Mainframe Adapter for SNA Components System Configuration Configure the Local Host Configure the Remote Host Configuring the Oracle Tuxedo Mainframe Adapter for SNA Gateway Overview Step 1: Edit the DMTYPE File Step 2: Edit the UBBCONFIG File Step 3: Edit the DMCONFIG File (and Edit CRM Configuration File to Have Separate CRM Configurations on Mainframe) Configurations for Customized Call ID Support Set Environment Variable CALLID_FIELDS_CFG Set Configuration File CALLFLDS Sample Using the Oracle Tuxedo Metadata Repository Tuxedo Metadata Respository Service-Level Keywords Mapping Between DMCONFIG Elements and Tuxedo Metadata Repository Keywords GWSNAX Server Configuration Starting the System Step 1: Start the CRM Step 2: Start the ATMI Servers See Also Verifying the Software Building Verification Tests Building ATMI Platform Executables Modify the UBBCONFIG File Execute the tmloadcf Command Modify the DMCONFIG File Execute the dmloadcf Command Modify the Environment Files Build the Server Build the Client Building CICS/ESA Executables Choose the Source Code Language Transfer the Source Code to the Host Translate CICS/ESA Verbs Compile the Translated Source File Create the Executable Object Configure the CICS/ESA Application View Connection and Session Status Running the Sample Application Running the Application from an ATMI Client Running the Application from a CICS/ESA Client CICS/ESA Client with CPI-C CICS/ESA Client with DPL Running the Application from a CICS/VSE Client CICS/VSE Sample Applications Other Considerations Providing Security Understanding Oracle Tuxedo Mainframe Adapter for SNA Security Mapping User IDs ATMI-to-Host User ID Mapping Direct User ID Mapping Configuring User ID Mapping Determining Security Parameters Setting DMCONFIG File Security Parameters Setting UBBCONFIG File Security Parameters Bypassing User ID Mapping Using dmadmin Commands to Administer User ID Mapping Setting Security Scenario Using Link-Level Encryption Illustration of Encryption Process Configuring the Oracle Tuxedo Mainframe Adapter for SNA Gateway and CRM Using SSL Encryption Configuring the Oracle Tuxedo Mainframe Adapter for SNA Gateway and CRM Samples of SSL Encryption Configuration File for CRM Using TCP/IP Link Authentication Illustration of Authentication Process Configuring the Oracle Tuxedo Mainframe Adapter for SNA Gateway and CRM for Authentication Setting Up Data Translations Data Conversion Conversion of ATMI Typed Buffers to Records Data Conversion for STRING Typed Buffer Data Conversion for XML Typed Buffer Data Conversion for X_OCTET/CARRAY Typed Buffers Data Conversion for VIEW/VIEW32/X_C_TYPE/X_COMMON Typed Buffers Data Conversion for FML/FML32 Typed Buffers Data Conversion for RECORD Typed Buffers Conversion of Records to ATMI Typed Buffers Data Conversion for STRING Typed Buffer Data Conversion for XML Typed Buffer Data Conversion for X_OCTET/CARRAY Typed Buffers Data Conversion for VIEW/VIEW32/X_C_TYPE/X_COMMON Typed Buffers Data Conversion for FML/FML32 Typed Buffers Data Conversion for RECORD Typed Buffers Data Conversion For DPL Services DPL Requests Originating From an ATMI Application DPL Requests Originating From a CICS DPL Translation Rules for VIEW Data Types String Considerations Converting Numeric Data Translation Rules for RECORD Data Types Translation Rules for Strings Setting the Option to Perform String Transformation Code Page Translation Tables Specifying a Translation Table How the Translation Tables Work Multi-byte Character Set (MBCS) Support ART for CICS Integration Consideration APPC/IMS Programming Considerations APPC/IMS Overview Implicit API Explicit API APPC/IMS Programming Non-Transactional Application Programming Transactional Application Programming Sample Transaction Programs Channel/Container Support in DPL Channel / Container Overview ATMI Server Programming Configurations VIEW32 Definitions DMCONFIG Environment Variable See Also Inbound Transaction Routing Overview Configuration MF CICS Configuration ARTCICS and TMA SNA Configuration Example(s) Configuration TMA/SNA High Availability Outbound Call (from Oracle Tuxedo to CICS) Single Connection and Multiple Links Configuring UBBCONFIG Configuring DMCONFIG Configuring VTAM List Configuring Connections Programming for DPLS Multiple Connections and Multiple Links Inbound Call (from CICS to Oracle Tuxedo) Single Connection and Multiple Links Configuring UBBCONFIG Configuring DMCONFIG Configuring VTAM List Configuring Connections Programming for DPLC Configuring CICS System Initialization Table Multiple Connections and Multiple Links ART CICS Calls Transaction in Z/CICS Step 1: Configuring ART CICS on Open System Step 2: Defining VTAM Resources Step 3: Configuring and Deploying TMA SNA Step 4: Start CRM on Mainframe ART IMS Calls Transaction in Z/IMS Step 1: Configuring Sub-transactions on Z/OS Step 2: Configuring and Deploying TMA SNA for IMS Step 3: Generating Buffer Converter Program for Sub-transactions Administrative Command Reference Pages addumap addusr delumap delusr DMADM dmadmin dmconfig dmloadcf dmunloadcf GWADM GWSNAX modusr tmadmin tmadmin(1) Error Messages Code Page Translation Tables Modifying a Code Page Translation Table Default Tuxedo Code Page Translation Table United States (00819x00037) Code Page Translation Table Germany (00819x00273) Code Page Translation Table Finland/Sweden (00819x00278) Code Page Translation Table Spain (00819x00284) Code Page Translation Table Great Britain (00819x00285) Code Page Translation Table France (00819x00297) Code Page Translation Table Belgium (00819x00500) Code Page Translation Table Portugal (00819x00860) Code Page Translation Table Italy (00819x00280) Code Page Translation Table Latin-1 – (00819x01047) Code Page Translation Table Latin-2 – (00912x00870) Code Page Translation Table Glossary
Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.
