Contents

Title Page

Copyright Page

Preface

Purpose of This Manual

Who Should Read This Manual

: Administrators
: Operators
: Recommended Reading

How This Manual Is Organized

How to Use This Manual

Online Document Considerations

Opening the Manual in a Web Browser

Printing from a Web Browser

Document Conventions

Related Documentation

Connect SNA Documentation

Product Manuals

Other Publications

Contact Information

Documentation Support

Technical Support

1. Introducing BEA Connect SNA

Supported Platforms

2. Understanding How BEA Connect SNA Works

Overview of Domain Gateways

The BEA Connect SNA Domain

The DMINIT and SNACRM Servers

Other Gateway Servers

3. Installing BEA Connect SNA

Pre-Installation Considerations

Local Environment

Local Environment (cont.)

Remote Environment

Installation

Running install.sh

Installation Components

: Executables
: Application Files
: Libraries
: Message Queues

Post Installation Action

4. Configuring BEA Connect SNA

Local Domain Configuration

Editing the UBBCONFIG File

Editing the DMCONFIG File

: Prerequisites
: *DM_LOCAL_DOMAINS Section
: *DM_REMOTE_DOMAINS Section
: *DM_SNADOM Section
: *DM_SNACRM Section
: *DM_SNASTACKS Section
: *DM_SNALINKS Section
: *DM_REMOTE_SERVICES Section

Using the dmadmin Command Interpreter

: Configuring the *DM SNACRM SECTION
: Configuring the *DM_SNASTACKS Section
: Configuring the *DM_SNALINKS Section

Remote Host Domain Configuration

Establishing the VTAM Configuration

Configuring the CICS/ESA LU

: Create Connections at the Remote Host
: Define the Session at the Remote Host
: View Connection and Session Status

Completing Cross-Platform Definitions

Setting Stack Traces

5. Administering the BEA Connect SNA Application Domain

Administration Facilities

The dmadmin Command Interpreter

The SNACRM and PU 2.1 Servers

: Starting the PU2.1 Server
: Starting the SNACRM
: Using DMINIT

Where You Specify Security Parameters

: UBBCONFIG File Security Parameters
: DMCONFIG File Security Parameters
: Security Setting Summary
: Security Setting Summary Tables

How To Administer Security

: Adding a Userid and Password
: Mapping a Userid
: Removing a Userid's Mapping
: Deleting a Userid and Password
: Modifying a Password

Data Translations

Buffers Going To The Remote Host Application

: INBUFTYPE Parameter Definition
: Data Conversion for STRING 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

Buffers Coming From The Remote Host Application

: OUTBUFTYPE Parameter Definition
: Data Conversion for STRING 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 DPL Services

: DPL Requests Originating From A TUXEDO Application
: DPL Requests Originating From a CICS DPL

6. Verifying BEA Connect SNA

Building Your Verification Tests

Building TUXEDO Executables

: Using the buildserver Utility
: Using the buildclient Utility
: Modifying the UBBCONFIG file
: Executing the tmloadcf Command
: Modifying the DMCONFIG File
: Executing the dmloadcf Command
: Modifying the Environment Files

Building CICS/ESA Executables

: Choosing the Source Code Language
: Transferring the Source Code to Host
: Translating CICS/ESA Verbs
: Compiling the Translated Source File
: Link-Editing the Compiled Source File
: Configuring the CICS/ESA Application
: Viewing Connection and Session Status

Running the Sample Application

Running the Application from a TUXEDO Client

Running the Application from a CICS/ESA Client

: CICS/ESA Client with CPI-C
: CICS/ESA Client with DPL

7. Programming Considerations

APPC/IMS Programming

CICS/ISC Programming

Multi-Region versus Multi-Processor Operations

: Asynchronous Processing
: Function Request Shipping
: Transaction Routing
: Distributed Program Link
: Step-by-Step Description: Generic DPL Transaction
: Distributed Transaction Processing
: Step-by-Step Description: Generic DTP Transaction
: CICS/ESA Sync-Levels

Time-out and Error Handling

Application-to-Application Programming

Distributed Program Link (DPL)

: Step-by-Step Description: TUXEDO Client Request/Response to CICS/ESA DPL
: Step-by-Step Description: TUXEDO Client Asynchronous Request/Response to CICS/ESA DPL
: Step-by-Step Description: TUXEDO Client Asynchronous Request/Response with No Reply to CICS/ESA DPL
: Step-by-Step Description: CICS/ESA DPL to TUXEDO Request/Response Server
: Step-by-Step Description: CICS/ESA DPL to TUXEDO Request/Response Server, Service in Autonomous Transaction
: Step-by-Step Description: TUXEDO Client Request/Response to CICS/ESA DPL, in Autonomous Transaction
: Step-by-Step Description: Transactional TUXEDO Client Multiple Requests/Responses to CICS/ESA DPL
: Step-by-Step Description: Transactional CICS/ESA DPL to TUXEDO Request/Response Server

Distributed Transaction Processing (DTP)

: Step-by-Step Description: TUXEDO Client Request/Response to CICS/ESA DTP
: Step-by-Step Description: TUXEDO Client Asynchronous Request/Response to CICS/ESA DTP
: Step-by-Step Description: TUXEDO Client Asynchronous Request/Response with No Reply to CICS/ESA DTP
: Step-by-Step Description: TUXEDO Conversational Client to CICS/ESA DTP, Server Gets Control
: Step-by-Step Description: TUXEDO Conversational Client to CICS/ESA DTP, Client Retains Control
: Step-by-Step Description: TUXEDO Conversational Client to CICS/ESA DTP, Client Grants/Gets Control
: Step-by-Step Description: CICS/ESA DTP to TUXEDO Conversational Server, Client Retains Control
: Step-by-Step Description: CICS/ESA DTP to TUXEDO Conversational Server, Client Relinquishes Control
: Step-by-Step Description: Transactional TUXEDO Client Request/Response to CICS/ESA DTP
: Step-by-Step Description: Transactional TUXEDO Conversational Client to CICS/ESA DTP, Server Gets Control
: Step-by-Step Description: Transactional TUXEDO Conversational Client to CICS/ESA DTP, Client Grants/Gets Control
: Step-by-Step Description: CICS/ESA DTP to Transactional TUXEDO Conversational Server, Host Client Relinquishes Control

CPI-C Programming

: Step-by-Step Description: TUXEDO Client Request/Response to Host CPI-C
: Step-by-Step Description: TUXEDO Client Asynchronous Request/Response to Host CPI-C
: Step-by-Step Description: TUXEDO Client Asynchronous Request/Response to Host with No Reply
: Step-by-Step Description: TUXEDO Conversational Client to Host CPI-C, Server Gets Control
: Step-by-Step Description: TUXEDO Conversational Client to Host CPI-C, Client Retains Control
: Step-by-Step Description: TUXEDO Conversational Client to Host CPI-C, Client Grants/Gets Control
: Step-by-Step Description: Host CPI-C to TUXEDO Asynchronous Request/Response Server with No Reply
: Step-by-Step Description: HOST CPI-C to TUXEDO Server Request/Response
: Step-by-Step Description: Host CPI-C to TUXEDO Conversational Service, Client Retains Control
: Step-by-Step Description: TUXEDO Conversational Service, Client Grants Control
: Step-by-Step Description: Transactional TUXEDO Client Request/Response to Host CPI-C
: Step-by-Step Description: Transactional TUXEDO Conversational Client to Host CPI-C, Server Gets Control
: Step-by-Step Description: Transactional TUXEDO Conversational Client to Host CPI-C, Client Grants/Gets Control
: Step-by-Step Description: Transactional Host CPI-C to TUXEDO Conversational Server, Client Grants Control

Where to Find Additional Information

A. Reference Pages

: addumap
: addusr
: delumap
: delusr
: DMADM
: dmadmin
: dmconfig
: dmloadcf
: dmunloadcf
: dmusradd
: dmusrmod
: GWADM
: modusr
: xsnacrm
: SNACRM
: CRMLOGS

B. ATMI to CPI-C Function Mapping

ATMI Calls Mapped to CPI-C Verbs

C. CPI-C Parameters and Values

CPI-C Verbs

D. Error Messages

SNACRM Messages

GWSNAX Messages

E. Sample VTAM Configurations

Introduction

Local Environment

Remote Environment

Sample Environments

Machine Attributes (LAN Descriptions)

Local Environment Configuration

: HPSNAPlus2 Configuration

Remote Environment Configurations

: ATCSTRxx VTAM Start List
: XCA Major Node Defines the LAN Adapter for SYS1
: Switched Network (SWNET) Definitions
: VTAM Application Major Nodes for CICS Regions
: CICS Resource Definition Entries (RDO)

Glossary