User’s Guide

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

Local Configuration

Distributed Configuration—CRM on z/OS Host

Distributed Configuration—CRM on Unix/Linux

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)

Option A: Edit the DMCONFIG File

Option B: Edit the DMCONFIG File and CRM Configuration File

Configurations for Customized Call ID Support

Set Environment Variable CALLID_FIELDS_CFG

Set Configuration File CALLFLDS

Syntax

Descriptions

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

Verifying the Software

Building Verification Tests

Building ATMI Platform Executables

Modify the UBBCONFIG File

Add the ATMI Simple Server to the UBBCONFIG File

Enable Transactional Services

Execute the tmloadcf Command

Modify the DMCONFIG File

Execute the dmloadcf Command

Modify the Environment Files

The app.env File

The <Machine>.env 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

COBOL Language Translator Example

C Language Translator example

Compile the Translated Source File

COBOL Compiler Example

C Compiler Example

Create the Executable Object

Configure the CICS/ESA Application

BEACONN File: Connection definition

BEACONN File: Session Definition

BEASNA File: Program Definition

BEASNA File: Remote Program Definition

BEASNA File: Transaction Definition

BEASNA File: Partner Definition

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

Using Encryption

Illustration of Encryption Process

Configuring the Oracle Tuxedo Mainframe Adapter for SNA Gateway and CRM for Encryption

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

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)

Overview

Outbound Configuration

Inbound Call (from CICS to Oracle Tuxedo)

Overview

Inbound Configuration

Multiple Connections and Multiple Links

Overview

Multiple Configuration

Administrative Command Reference Pages

addumap

addusr

delumap

delusr

DMADM

dmadmin

dmconfig

dmloadcf

dmunloadcf

GWADM

GWSNAX

modusr

Error Messages

Code Page Translation Tables