eLink Adapter for Mainframe User Guide

 

 

About This Document

How this Guide Is Organized

Who Should Read This Information

Administrators

Operators

Product Documentation

Recommended Reading

e-docs Web Site

How to Print the Document

Contact Us

 

Understanding the BEA eLink Adapter for Mainframe Solution

BEA eLink Adapter for Mainframe Overview

The eLink Adapter for Mainframe Architecture

The eLink Adapter for Mainframe Gateway

Communications Resource Manager

 

Configuring and Starting the System

Preparing for Configuration

Determine Your System Architecture

eLink Adapter for Mainframe Components

System Configuration

Local Configuration

Distributed Configuration. CRM on z/OS or OS/390 Host

Distributed Configuration. CRM on Solaris 8 Platform with Gateway on Another UNIX or Windows Platform

Configure the Local Host

Configure the Remote Host

Configuring the eLink Adapter for Mainframe Gateway

Step 1: Edit the DMTYPE File

Step 2: Edit the UBBCONFIG File

Step 3: Edit the DMCONFIG File

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 eLink Adapter for Mainframe Security

Mapping User IDs

ATMI-to-Host User ID Mapping

Direct User ID Mapping

Configuring User ID Mapping

Determining Security Parameters

Determining Security Parameters for Inbound Requests

Determining Security Parameters for Outbound Requests

Setting DMCONFIG File Security Parameters

DM_LOCAL_DOMAINS Section

DM_SNALINKS Section

DM_ACCESS_CONTROL Section

Setting UBBCONFIG File Security Parameters

Bypassing User ID Mapping

Using dmadmin Commands to Administer User ID Mapping

Adding a User ID and Password

Mapping a User ID

Removing User ID Mapping

Deleting a User ID and Password

Modifying a Password

Setting Security Scenario

Configuring Security in the ATMI Domain

Configuring Security in the Local Domain

Configuring Security in the Remote Domain

Setting the Security Level to IDENTIFY

Using Encryption

Illustration of Encryption Process

Configuring the eLink Adapter for Mainframe Gateway and CRM for Encryption

Using TCP/IP Link Authentication

Illustration of Authentication Process

Configuring the eLink Adapter for Mainframe Gateway and CRM for Authentication

Using Third-Party Security Software

 

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

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

Setting the Option to Perform String Transformation

Code Page Translation Tables

Specifying a Translation Table

How the Translation Tables Work

 

APPC/IMS Programming Considerations

APPC/IMS Overview

Implicit API

Explicit API

APPC/IMS Programming

Non-Transactional Application Programming

Transactional Application Programming

Sample Transaction Programs

 

Web-enabling an IBM 3270 Application with eLink Adapter for Mainframe and CrossPlex

Overview of the eLink Adapter for Mainframe and CrossPlex Architecture

Developing an ATMI Client that Invokes a CrossPlex Script on the Mainframe

Task 1: Create a CrossPlex Script

Step 1: Prepare Inbound Record Definition

Step 2: Create a Copybook of the Inbound Record Definition

Step 3: Create an Outbound Record Definition and Copybook

Step 4: Prepare the CrossPlex Script

Step 5: Handling the Mainframe Sign-on

Step 6: Test and Debug the Script

Task 2: Create a View Definition Describing the Application Data

Task 3: Code Your Client Program

Task 4: Configure eLink Adapter for Mainframe to Communicate with CrossPlex

Task 5: Use the Application

Step 1: Set Your Environment Variables

Step 2: Start Your ATMI System

Step 3: Run the Client Program

 

Administrative Command Reference Pages

addumap

addusr

delumap

delusr

DMADM

dmadmin

dmconfig

dmloadcf

dmunloadcf

GWADM

GWSNAX

modusr

 

Error Messages

 

Code Page Translation Tables

Modifying a Code Page Translation Table

Default Tuxedo Code Page Translation Table

United States (00819x00037) Code Page Translation Table

Germany (00819x00273) Code Page Translation Table

Finland/Sweden (00819x00278) Code Page Translation Table

Spain (00819x00284) Code Page Translation Table

Great Britain (00819x00285) Code Page Translation Table

France (00819x00297) Code Page Translation Table

Belgium (00819x00500) Code Page Translation Table

Portugal (00819x00860) Code Page Translation Table

Latin-1 - (00819x01047) Code Page Translation Table

Latin-2 - (00912x00870) Code Page Translation Table