BEA eLink Java Adapter for Mainframe WLS Edition User Guide

 

This guide provides information about BEA eLink Java Adapter for Mainframe WLS Edition (JAM), a product that enables client/server transactions between Java applications and OS/390 CICS or IMS programs. Also refer to the BEA eLink Adapter for Mainframe, SNACRM Administration Guide for information about how the System Network Architecture Communications Resource Manager (SNACRM) provides the emulation that enables CICS DPL protocols to flow into and out of the JAM environment.

 

About This Guide

Who Should Read This Guide

System Administrators

Java Application Developers

CICS Application Developers

IMS Application Developers

How this Guide Is Organized

Product Documentation

How to Use The Documentation

Document Conventions

Contact Us

 

Introducing eLink Java Adapter for Mainframe WLS Edition

JAM Environment

WebLogic Server

System Network Architecture Communications Resource Manager

Java Communications Resource Manager Gateway

EgenCobol Code Generator

Supported Third-Party SNA Stack

Configuration Options

Combined Configuration

Distributed Configuration

Installation Considerations

 

Configuring the Java Adapter for Mainframe Environment

Configuring the JAM Environment

Step 1 - Install a Supported SNA Stack

Step 2 - Install the Java JDK

Step 3 - Install WebLogic Server

Step 4 - Install the Java Access for Mainframe

Step 5 - Install the SNA Communications Resource Manager

Step 6 - Establish Your Mainframe Environment

Step 7 - Start WebLogic Server

Step 8 - Configure the Java Communication Resource Manager Gateway (JCRMGW)

JC_REMOTE_DOMAINS Section

JC_SNACRM Section

JC_SNASTACKS Section

JC_SNALINKS Section

JC_LOCAL_SERVICES Section

JC_REMOTE_SERVICES Section

Sample Configuration File

 

Developing Java Applications

Building the Base Java Application

Data View Concepts

Obtaining the COBOL Copybook

Creating a New Copybook

Using an Existing Copybook

Script Comments

Script Comments

Generating the Java Application Source

Generating a Servlet-Only JAM Application

Creating a Script

Processing a Script

Generated Files

Customizing a Servlet-Only JAM Application

Generating a Client Enterprise Java Bean-Based Application

Creating a Script

Processing the Script

Generated Files

Customizing an Enterprise Java Bean-Based Application

Generating a Server Enterprise Java Bean-Based Application

Creating a Script

Processing the Script

Generated Files

Customizing a Server Enterprise Java Bean-Based Application

Generating a Stand-Alone Client Application

Processing a Script

Generated Files

Customizing a Stand-Alone Java Application

 

Deploying Applications

Deploying Servlets

Deploying Enterprise Java Beans

 

Security

 

Programming Reference

Field Name Mapping Rules

Field Type Mappings

Group Field Accessors

Elementary Field Accessors

Array Field Accessors

Fields with REDEFINES Clauses

COBOL Data Types

 

Programming Scenarios

Scenario A: Developing a Multi-Service Data Entry Servlet

Task 1: Use EgenCobol to Create a Base Application

Prerequisite

Step 1: Prepare EgenCobol Script

Step 2: Add Service Entries

Step 3: Add Page Declaration in EgenCobol Script

Step 4: Add Servlet Name

Step 5: Generate the Java Source Code

Step 6: Review the Java Source Code

Task 2: Create Your Custom Application from the Base Application

Step 1: Start with Imports

Step 2: Declare the New Custom Class

Step 3: Add Implementation for doGetSetup

Step 4: Continue Implementation for doGetSetup

Step 5: Finish Implementation for doGetSetup

Step 6: Create Implementation for doPostSetup

Step 7: Continue Implementation for doPostSetup

Step 8: Continue Implementation of doPostSetup

Step 9: Continue Implementation for doPostSetup

Step 10: Finish Implementation of doPostSetup

Step 11: Create Implementation for doPostFinal

Step 12: Update the jcrmgw.cfg File with Service Entries

Step 13: Create Basic Three-Part HTML Frame

Step 14: Create a Series of Links to HELP Pages

Task 3: Update the JAM Configurations and Update WLS Properties

Task 4: Deploy Your Application

Task 5: Use the Application

Scenario A Summary

Create

Read

Update

Delete

Scenario B: Enhancing an Existing Servlet to Originate a Mainframe Request

Task 1: Use EgenCobol to Create a Base Class

Prerequisite

Step 1: Prepare EgenCobol Script

Step 2: Generate the Java Source Code

Step 3: Review the Java Source Code

Task 2: Update the Survey Servlet Using the Generated Class

Step 1: Start with Imports

Step 2: Add New Data Members

Step 3: Update doPost with Mainframe Request

Step 4: Continue Updating doPost by Extracting Form Data

Step 5: Continue Updating doPost by Calling Mainframe Service

Task 3: Update the JAM Configurations and Update WLS Properties

Task 4: Deploy Your Application

Task 5: Use the Application

Scenario B Summary

Scenario C: Updating an Existing EJB to Service a Mainframe Request

Task 1: Use EgenCobol to Create a Base Class

Prerequisite

Step 1: Prepare EgenCobol Script

Step 2: Generate the Java Source Code

Step 3: Review the Java Source Code

Task 2: Update the Trader Interface Using the Generated Class

Step 1: Start with Import

Step 2: Continue with Imports

Step 3: Update EJB with dispatch

Step 4: Continue Updating EJB with dispatch

Step 5: Finish Updating EJB with dispatch

Task 3: Update the JAM Configurations

Task 4: Deploy Your Application

Task 5: Use the Application

Scenario C Summary

 

Code Generator Reference Pages

EgenCobol

Synopsis

Script Syntax Reserved Words

General rules

Grammar

Results of Running the Code Generator

 

Configuration Checker Utility

bea.sna.jcrmgw.jcrmConfigurator

Synopsis

Description

GWBOOT

Synopsis

Description

 

Error and Informational Messages

 

Java Docs