Contents

About This Developer Center

Who Should Read This Information

: Administrators
: Operators
: Recommended Reading

How the Information Is Organized

How to Use the Documentation

Online Document Considerations

Opening the Developer 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

Supported Platforms

2. Understanding How the Software Works

Overview of Domain Gateways

The BEA eLink SNA Domain

The DMINIT and SNACRM Servers

Other Gateway Servers

3. Configuring the System

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

4. Verifying the Software

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

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

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

General Usage Notes

6. 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)

: Special Treatment of TRANSID for DPL
: 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

A. Reference Pages

: Synopsis
: Description
: Portability
: Diagnostics
: Example
: See Also

: Synopsis
: Description
: Portability
: Diagnostics
: Examples
: See Also

: Synopsis
: Description
: Diagnostics
: Examples
: See Also

: Synopsis
: Description
: Portability
: Diagnostics
: Example
: See Also

: Synopsis
: Description
: Portability
: Diagnostics
: Examples
: See Also

: Synopsis
: Description
: Portability
: Examples
: See Also

: Synopsis
: Description
: Administration Mode Commands
: Configuration Mode Commands
: Configuration Input Format
: Configuration Limitations
: Restrictions for Configuration Field Identifiers/Updates
: Configuring the DM_LOCAL_DOMAINS Section
: Configuring the DM_REMOTE_DOMAINS Section
: Configuring the DM_TDOMAIN Section
: Configuring the DM_OSITP Section
: Configuring the DM_LOCAL_SERVICES Section
: Configuring the DM_REMOTE_SERVICES Section
: Configuring the DM_ROUTING Section
: Configuring the DM_ACCESS_CONTROL Section
: Configuring the DM_PASSWORDS Section
: Diagnostics in Configuration Mode
: Configuration Example
: Security
: Environment Variables
: General Diagnostics
: Interoperability
: Portability
: See Also

: Description
: Definitions
: Configuration File Format
: The DM_LOCAL_DOMAINS Section
: The DM_REMOTE_DOMAINS Section
: The DM_TDOMAIN Section
: The DM_OSITP Section
: The DM_SNACRM Section
: The DM_SNASTACKS Section
: The DM_SNALINKS Section
: The DM_ACCESS_CONTROL Section
: The DM_LOCAL_SERVICES Section
: The DM_REMOTE_SERVICES Section
: The DM_ROUTING Section
: Files
: Example 1
: Example 2
: Example 3
: See Also

: Synopsis
: Description
: Portability
: Environment Variables
: Examples
: Diagnostics
: See Also

: Synopsis
: Description
: Portability
: Examples
: Diagnostics
: See Also

: Synopsis
: Description
: Portability
: Interoperability
: Examples
: See Also

: Synopsis
: Description
: Portability
: Diagnostics
: Examples
: See Also

: Synopsis
: Description
: Trace Options
: General Options
: Environment Variables
: Configuring DM_SNACRM
: Portability
: Interoperability
: Diagnostics
: Examples
: See Also

: Synopsis
: Description
: Command Line Options
: Trace Options
: General Options
: xsnacrm Window
: Examples
: Customizing X Resources
: Widgets
: See Also

B. ATMI to CPI-C Function Mapping

C. CPI-C Parameters and Values

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

[Top] [Prev] [Next] [Bottom]