Contents

Introducing the BEA eLink SNA System
  Features
  Functions
  Supported TUXEDO Platforms
  Supported Host Platforms

Understanding How the Software Works
  Overview of Domain Gateways
  The BEA eLink SNA Domain
  The DMINIT and SNACRM Servers
  Other Gateway Servers

Configuring the System
  Local Domain Configuration
  Edit the UBBCONFIG File
  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

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

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
  Security
  Security Overview
  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
  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
  General Usage Notes

Programming Considerations
  Overview
  APPC/IMS Programming
  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
  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

Reference Pages
  addumap
  addusr
  CRMLOGS
  crmlkoff
  crmlkon
  delumap
  delusr
  DMADM
  dmadmin
  dmconfig
  dmloadcf
  dmunloadcf
  GWADM
  GWSNAX
  modusr
  SNACRM
  xsnacrm

ATMI to CPI-C Function Mapping

CPI-C Parameters and Values

Error Messages

Sample VTAM Configurations

Code Page Translation Tables

Glossary