Contents

About This Information Center

Purpose

Scope

Who Should Read This Information

Administrators

Operators

Recommended Reading

How the Information Is Organized

How to Use The Documentation

Online Document Considerations

Opening the information Center in a Web Browser

Printing the PDF File

Printing from a Web Browser

Document Conventions

Related Documentation

BEA eLink SNA Documentation

Product Manuals

Other Publications

Contact Information

Documentation Support

Customer Support

North American Support Center

European Support Center

1. Introducing the BEA eLink SNA System

Features

Functions

Supported TUXEDO/WLE Platforms

Supported Host Platforms

2. Understanding How the Software Works

Overview of Domain Gateways

The eLink SNA Domain

The eLink SNA Domain Components

The DMINIT and SNACRM Servers

Other Gateway Servers

3. Configuring the System

Local Domain Configuration

Edit the UBBCONFIG File

General Information

Defining a Data Mapping Tool (Optional)

Edit 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_LOCAL_SERVICES Section

DM_REMOTE_SERVICES Section

Use 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

Creating Connections at the Remote Host

Defining the Session at the Remote Host

View Connection and Session Status

Completing Cross-Platform Definitions

Setting Stack Traces

4. Verifying the Software

Overview

Building Your Verification Tests

Building TUXEDO Executables

Using the buildserver Utility

Using the buildclient Utility

Modifying the UBBCONFIG file

Enabling Transactional Services

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

Running the Application from a CICS/VSE Client

CICS/VSE Sample Applications

Other Considerations

5. Administering the 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

Specifying the SNACRM as a BEA TUXEDO Server

Enter the UBBCONFIG Parameters

Write the Script

The SNACRM Monitor

Prerequisite for Running the JSNACRM Utility on an NT Platform

Running the Java Applet Version

Running the Java Application Version

Activating and De-Activating Links

Using the crmlkon Command

Using the crmlkoff Command

6. Security

Security Overview

Where You Specify Security Parameters

UBBCONFIG File Security Parameters

DMCONFIG File Security Parameters

DM_LOCAL_DOMAINS section

DM_SNALINKS section

DM_ACCESS_CONTROL section

Security Setting Summary

Security Setting Summary Tables

Setting Up Security in a Configured Application

Configuring Security in the TUXEDO Domain

Setting the Security Level to IDENTIFY

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

7. Data Translations

Overview

Default Data Translation Rules

Strings and Numeric Data

Converting Numeric Data

Application-to-Host Communications

Buffers Going To The Remote Host Application

Buffers Coming From The Remote Host Application

Data Conversion For DPL Services

Programming Language String Transformation

Setting the Switch to Perform String Transformation

How the Switch Works

Example

Code Page Translation Tables

Specifying a Translation Table

How the Translation Tables Work

Example

Data Mapping Tool

Data Mapping Overview

Setting Up the eLink Integrator in the UBBCONFIG File

Defining the elinkmerc Server

Advertising the Services for Data Mapping

Sample UBBCONFIG File for Data Mapping

Setting Up the eLink Integrator in the DMCONFIG File

Specifying Inbound Encoding/Decoding Buffers

Specifying Outbound Encoding/Decoding Buffers

General Usage Note

8. Application to Application Programming Considerations

Overview

Application-to-Application Programming

Distributed Program Link (DPL)

Special Treatment of TRANSID for DPL

Specifying the Size of a DPL Commarea

DPL Examples

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 Sends/Receives Data

Step-by-Step Description: TUXEDO Conversational Client to CICS/ESA DTP, Client Grants 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: 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 Host CPI-C to TUXEDO Conversational Server, Client Grants Control

Where to Find Additional Information

9. APPC/IMS Programming Considerations

APPC/IMS Overview

Implicit API

Explicit API

APPC/IMS Programming

Non-Transactional Application Programming

Transactional Application Programming

Sample Transaction Programs

10. CICS/ISC Programming Considerations

CICS/ISC Programming

About CICS/ISC

Multi-Region versus Multi-Processor Operations

ISC 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

A. Reference Pages

addumap

addusr

CRMLOGS

crmlkoff

crmlkon

delumap

delusr

DMADM

dmadmin

dmconfig

dmloadcf

dmunloadcf

GWADM

GWSNAX

modusr

SNACRM

xsnacrm

B. ATMI to CPI-C Function Mapping

C. CPI-C Parameters and Values

D. Error 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)

Microsoft SNA Cross-Platform Definitions

F. Code Page Translation Tables

Glossary

Index