BEA WebLogic Java Adapter for Mainframe User Guide


	Corporate Info \| News \| Solutions \| Products \| Partners \| Services \| Events \| Download \| How To Buy
	http://www.oracle.com/technology/documentation/index.html \| Search \| PDF Files \| Contact \|

WebLogic Java Adapter for Mainframe User Guide Doc Home \| BEA WebLogic Java Adapter for Mainframe User Guide \| Previous Topic \| Next Topic \| Contents \| Index

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

Understanding the BEA WebLogic Java Adapter for Mainframe Solution

The BEA WebLogic Enterprise Application Integration Solution

Enterprise Application Integration: 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

Document Type Definition

JAM XML Capabilities

Configuring and Administering the BEA WebLogic Java Adapter for Mainframe Gateway

General Steps for Defining the Gateway Configuration

About the JCRMGW Configuration File

JCRMGW Configuration File Sections

JC_REMOTE_DOMAINS Section

Keyword Definitions

JC_SNACRM Section

Keyword Definitions

JC_SNASTACKS Section

Keyword Definitions

JC_SNALINKS Section

Keyword Definitions

JC_LOCAL_SERVICES Section

Keyword Definitions

JC_REMOTE_SERVICES Section

Keyword Definitions

Sample Configuration File

Special Configuration Considerations for WebLogic Server 6.0

Locating the Gateway Configuration File

Adding the JAM Startup Class to the WebLogic Server Configuration File

Post Configuration Requirements

JAM Administration Servlet

Configuring the Servlet for WebLogic Server 5.1

Configuring the Servlet for WebLogic Server 6.0

Starting the Servlet

Setting Servlet Options

Using Servlet Commands

Developing Java Applications

Building the Base Java Application

Dataview 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

Providing OS/390 Mainframe Access with No Data Translation

Using Client Diagnostic Features with WebLogic Server 5.1

Client Traffic Tracing

Client Loopback

Client Stub Operation

Deploying Applications

Deploying Servlets in WebLogic Server 5.1

Deploying Enterprise Java Beans in WebLogic Server 5.1

Deploying Applications in WebLogic Server 6.0

Supported Security Options

Controlling User IDs and Passwords through Business Logic or Client Classes

Controlling Security Credentials from Client EJB Code

Controlling Security Credentials from Client Class Code

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: Define Business Operations for the Create Employee Record Example

Step 1: Set Up Create New Employee Record Object

Step 2: Set Up Data Accessor Business Operations

Step 3: Set Up ApplicationView Business Operations

Task 2: Set Up a Workflow Template

Task 3: Define Variables

Task 4: Define the Start Node

Task 5: Create a Task to Set Up an Employee Name

Task 6: Create a Task to Set Up the Employee Address

Task 7: Create Additional Tasks to Complete the Employee Record

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

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

Script Syntax Reserved Words

Results of Running the Code Generator

Configuration Checker Utility

com.bea.sna.jcrmgw.jcrmConfigurator

Error and Informational Messages

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