BEA Logo BEA eLink Adapter for Mainframe 4.0

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy

   http://www.oracle.com/technology/documentation/index.html   |   Search   |   PDF Files   |   Contact   |  

 

   eLink Adapter for Mainframe Doc Home   |   eLink Adapter for Mainframe User Guide   |   Previous Topic   |   Next Topic   |   Contents   |   Index

BEA eLink Adapter for Mainframe User Guide

 

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

Documentation Conventions

Contact Us

 

1. Understanding the BEA eLink Adapter for Mainframe

Enterprise Application Integration

BEA eLink Adapter for Mainframe Overview

The eAM Architecture

The eAM Gateway

Communications Resource Manager

 

2. Configuring the System

Preparing for Configuration

Determine Your System Architecture

eAM Components

System Architecture

Configure the Local Host

Configure the Remote Host

Configuring the eAM Gateway with the CRM

Step 1: Edit the DMTYPE File

Step 2: Edit the UBBCONFIG File

Step 3: Edit the DMCONFIG File

Step 4: Start the CRM

Step 5: Start the ATMI Servers

 

3. Verifying the Software

Building Verification Tests

Building ATMI Platform Executables

Modify the UBBCONFIG File

Execute the tmloadcf Command

Modify the DMCONFIG File

Execute the dmloadcf Command

Modify the Environment 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

Compile the Translated Source File

Create the Executable Object

Configure the CICS/ESA Application

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

 

4. Security

Understanding eAM Security

Mapping User IDs

ATMI-to-Host User ID Mapping

Direct User ID Mapping

Configuring User ID Mapping

Determining Security Parameters

Setting DMCONFIG File Security Parameters

Setting UBBCONFIG File Security Parameters

Bypassing User ID Mapping

Using dmadmin Commands to Administer User ID Mapping

Setting Security Scenario

Using Encryption

Configuring the eAM Gateway and CRM for Encryption

Using TCP/IP Link Authentication

Configuring the eAM Gateway and CRM for Authentication

 

5. Data Translations

Data Conversion

Conversion of ATMI Typed Buffers to Records

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

Conversion of Records to ATMI Typed Buffers

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

Using Information Integrator

About Data Mapping

Setting Up the eLink Information Integrator in the UBBCONFIG File

Defining the IIServer

Advertising the Services for Data Mapping

Sample UBBCONFIG File for Data Mapping

Setting Up eLink Information Integrator in the DMCONFIG File

Specifying Inbound Encoding and Decoding Services

Specifying Outbound Encoding and Decoding Buffers

 

6. APPC/IMS Programming Considerations

APPC/IMS Overview

Implicit API

Explicit API

APPC/IMS Programming

Non-Transactional Application Programming

Transactional Application Programming

Sample Transaction Programs

 

7. Integrating eAM with Crossplex

CrossPlex Architecture

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: Test and Debug the Script

Handling the Mainframe Sign-on

Task 2: Create a view definition that describes the application data.

Task 3: Code your client program.

Task 4: Configure eAM to talk to the CrossPlex installation on your
mainframe.

Task 5: Use the Application

Step 1: Start Your ATMI System.

Step 2: Run the Client Program.

 

A. Reference Pages

addumap

Synopsis

Description

Portability

Diagnostics

Example

See Also

addusr

Synopsis

Description

Portability

Diagnostics

Examples

See Also

CRMLOGS

Synopsis

Description

Diagnostics

Examples

See Also

crmlkoff

Synopsis

Description

Portability

Example

Diagnostics

See Also

crmlkon

Synopsis

Description

Portability

Example

Diagnostics

See Also

delumap

Synopsis

Description

Portability

Diagnostics

Example

See Also

delusr

Synopsis

Description

Portability

Diagnostics

Examples

See Also

DMADM

Synopsis

Description

Portability

Examples

See Also

dmadmin

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

dmconfig

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

dmloadcf

Synopsis

Description

Portability

Environment Variables

Examples

Diagnostics

See Also

dmunloadcf

Synopsis

Description

Portability

Examples

Diagnostics

See Also

GWADM

Synopsis

Description

Portability

Interoperability

Examples

See Also

GWSNAX

Synopsis

Description

Portability

Interoperability

Examples

See Also

modusr

Synopsis

Description

Portability

Diagnostics

Examples

See Also

SNACRM

Synopsis

Description

Trace Options

General Options

Environment Variables

Portability

Interoperability

Diagnostics

Examples

See Also

xsnacrm

Synopsis

Description

Command Line Options

General Options

xsnacrm Window

Examples

Customizing X Resources

Widgets

See Also

 

B. Error Messages

 

C. 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

 

 

 

Copyright © 2001 BEA Systems, Inc. All rights reserved.
Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.