BEA WebLogic Java Adapter for Mainframe Version 4.1 User 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

 

Understanding the BEA WebLogic Java Adapter for Mainframe Solution

The BEA WebLogic^TM Enterprise Application Integration Solution

Enterprise Application Integration (EAI): A Step Beyond the Middleware Solution

The BEA EAI Solution on WebLogic Server

Understanding the WebLogic Sever Integration Environment

Accelerate Your Development Time

Build For the Enterprise

Scale and Manage as Your Needs Grow

WebLogic Application Servers

WebLogic Server

WebLogic Enterprise

WebLogic Express

BEA WebLogic Java Adapter for Mainframe Overview

JAM Architecture

eGen COBOL Code Generator

Java Communications Resource Manager Gateway

System Network Architecture Communications Resource Manager

 

Understanding How JAM Uses XML

What is XML?

Document Type Definition

XML Schema

JAM XML Capabilities

 

Configuring the BEA WebLogic Java Adapter for Mainframe

General Steps for Defining the Gateway Configuration

About the JCRMGW Configuration File

JCRMGW Configuration File Sections

JC_REMOTE_DOMAINS Section

Valid Keywords

Keyword Definitions

JC_SNACRM Section

Valid Keywords

Keyword Definitions

JC_SNASTACKS Section

Valid Keywords

Keyword Definitions

JC_SNALINKS Section

Valid Keywords

Keyword Definitions

JC_LOCAL_SERVICES Section

Valid Keywords

Keyword Definitions

JC_REMOTE_SERVICES Section

Valid Keywords

Keyword Definitions

Sample Configuration File

Post Configuration Requirements

 

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

Working with Generated Files

Customizing an Enterprise Java Bean-Based Application

Compiling and Deploying

Generating a Server Enterprise Java Bean-Based Application

Creating a Script

Processing the Script

Generated Files

Customizing a Server Enterprise Java Bean-Based Application

Compiling and Deploying

Generating a Stand-Alone Client Application

Processing a Script

Generated Files

Customizing a Stand-Alone Java Application

Using Client Diagnostic Features

Client Traffic Tracing

Client Loopback

Client Stub Operation

 

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

Other Access Methods for Generated DataView Classes

Mainframe Access to DataView Classes

XML Access to DataView Classes

Hashtable Access to DataView Classes

Code for Unloading and Loading Hashtables

Rules for Unloading and Loading Hashtables

Name Translator Interface Facility

 

Using BEA WebLogic Process Integrator with JAM

WebLogic Process Integrator Overview

WebLogic Process Integrator Architecture

Integration with JAM

WebLogic Process Integrator to Mainframe  Requests

Using the eGen COBOL Utility for WebLogic Process Integrator to Mainframe Requests

Workflow Development for WebLogic Process Integrator to Mainframe Requests

Mainframe to WebLogic Process Integrator Requests

Example of JAM Application Integrated with WebLogic Process Integrator

Task 1: Set Up JAM Components as Business Operations

Task 2: Set Up a Workflow

Task 3: Define the Start Node

Task 4: Set Up the Start Node Properties

Task 5: Create a Setup Name Task

Task 6: Create Additional Tasks

 

Developing a Multi-Service Data Entry Servlet

Task 1: Use eGen COBOL to Create a Base Application

Step 1: Prepare eGen COBOL Script

Step 2: Add Service Entries

Step 3: Add Page Declaration in eGen COBOL 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 BEA WebLogic Server Properties

Task 4: Deploy Your Application

Task 5: Use the Application

Sample COBOL Programs for the Form Buttons

Create

Read

Update

Delete

 

Enhancing an Existing Servlet to Originate a Mainframe Request

Task 1: Use eGen COBOL to Create a Base Class

Step 1: Prepare eGen COBOL 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 WebLogic Server Properties

Task 4: Deploy Your Application

Task 5: Use the Application

Sample COBOL Program to Write to Temporary Storage Queue

 

Updating an Existing EJB to Service a Mainframe Request

Task 1: Use eGen COBOL to Create a Base Class

Step 1: Prepare eGen COBOL 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

Sample COBOL Program to Write to Temporary Storage Queue

 

Integrating JAM with Crossplex

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: Use eGen COBOL to Create a Base Application

Step 1: Prepare eGen COBOL Script

Step 2: Add Service Entry

Step 3: Add Page Declarations in eGen COBOL Script

Step 4: Add Servlet Name

Step 5: Generate the Java Source Code

Task 3: 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: Create Implementation for doPostSetup

Step 5: Create Implementation for doPostFinal

Task 4: Update the JAM Configurations and Update WebLogic Server Properties

Task 5: Deploy Your Application

Task 6: Use the Application

 

Code Generator Reference Pages

eGen COBOL

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