|
|
|
|
|
|
About This Guide
This guide provides information about the BEA eLink Java Adapter for Mainframe (JAM) WLS Edition, a product that enables client/server transactions between Java applications and OS/390 CICS or IMS programs.
This section covers the following topics:
Who Should Read This Guide
The audience is primarily Java application developers, Customer Information Control System (CICS) application developers, Information Management System (IMS) application developers, and system administrators who configure gateway software on BEA Web Logic Server (WLS) platforms.
System Administrators
As the application administrator, you install the WLS platform software and configure the JAM gateway. You must have sufficient System Network Architecture (SNA) knowledge to configure the underlying SNA stack (PU2.1 server) so it conforms with definitions created in Virtual Telecommunications Access Method (VTAM) and CICS for each remote domain. Refer to stack vendor documentation for details.
Successfully linking and establishing conversations between Java applications and mainframe-based programs requires special coordination. The names and characteristics of mainframe resources, configured in the SNA stack, must agree with resources and characteristics defined in VTAM and CICS.
Typically, remote VTAM and CICS resources are defined by system personnel in a data center where IBM mainframes are located. Therefore, you need to request the remote names of IMS and CICS resources from data center systems personnel and use those names to configure the SNA stack and the JAM gateway.
Java Application Developers
The JAM facility provides application developers bidirectional, transparent processing using platform native Application Programming Interfaces (API). Java application programmers can develop clients or servers using standard object-oriented programming techniques without regard for mainframe protocols.
CICS Application Developers
CICS programmers can develop servers or clients using the CICS Link command and the Distributed Program Link (DPL) subset API as a standard distributed CICS application. In addition, any existing CICS application designed to be invoked from a DPL can be used without modification.
IMS Application Developers
IMS programmers can use any IMS program (without modification) that sends and receives messages to and from the IMS message queue as either a client or a server.
How this Guide Is Organized
The BEA eLink Java Adapter for Mainframe WLS Edition User Guide is organized as follows:
This section gives an overview of the JAM environment and describes two configurations for the product.
This section provides information and procedures for configuring the JAM development environment to create a basic servlet that can execute a CICS DPL.
This section explains how to build a base Java application from a COBOL copybook and generate Java application source code.
This section gives procedures for installing developed servlets and/or EJB into an operational environment.
This section describes the basic level of security supported by the JAM product software.
This section provides data mapping rules for the EgenCobol tool used to generate Java code from COBOL copybooks.
This section provides three programming scenarios for developing and deploying JAM applications. You can follow the steps to learn practical uses for the tools included with the JAM product.
This appendix contains reference pages for the EgenCobol tool.
This appendix describes the configuration checker utility that can be used to verify the contents of the jcrmgw.cfg file before starting the Java Communications Resource Manager Gateway (JCRMGW).
This appendix gives descriptions of messages that may be encountered while using JAM software.
This appendix tells how to use the HTML pages describing JAM Java classes.
Product Documentation
The JAM documentation consists of the following:
The Documentation CDROM included in the package with your product software CDROM contains an HTML Web User Interface (WUI). The WUI links to HTML versions and PDF versions of JAM documentation. The WUI should be viewed on an online browser. The PDF versions should be used for printing. (Information on how to view the online documentation is available in the BEA eLink Java Adapter for Mainframe WLS Edition Release Notes.)
Note: The WUI requires a Web browser that supports HTML 3.0. Netscape Navigator 2.02 or Microsoft Internet Explorer 3.0 or later.
You must have the Adobe Acrobat Reader to print the PDF file. If you do not have this reader, you can obtain it free of charge from the Adobe Systems Incorporated home site at www.adobe.com. (The BEA eLink Java Adapter for Mainframe WLS Edition WUI contains a hot link to this site.)
Document Conventions
The following documentation conventions are used throughout this manual:
|
Convention |
Item |
|---|---|
|
boldface text |
Indicates terms defined in the glossary. |
|
Ctrl+Tab |
Indicates that you must press two or more keys simultaneously. |
|
italics |
Indicates emphasis or book titles. |
|
monospace text |
Indicates code samples, commands and their options, data structures and their members, data types, directories, and file names and their extensions. Monospace text also indicates text that you must enter from the keyboard. Examples: #include <iostream.h> void main ( ) the pointer psz chmod u+w * \tux\data\ap .doc tux.doc BITMAP float |
|
monospace boldface text |
Identifies significant words in code. Example: void commit ( ) |
|
monospace italic text |
Identifies variables in code. Example: String expr |
|
UPPERCASE TEXT |
Indicates device names, environment variables, and logical operators. Examples: LPT1 SIGNON OR |
|
{ } |
Indicates a set of choices in a syntax line. The braces themselves should never be typed. |
|
[ ] |
Indicates optional items in a syntax line. The brackets themselves should never be typed. Example: buildobjclient [-v] [-o name ] [-f file-list]... [-l file-list]... |
|
| |
Separates mutually exclusive choices in a syntax line. The symbol itself should never be typed. |
|
... |
Indicates one of the following in a command line:
The ellipsis itself should never be typed. Example: buildobjclient [-v] [-o name ] [-f file-list]... [-l file-list]...
|
|
. |
Indicates the omission of items from a code example or from a syntax line. The vertical ellipsis itself should never be typed. |
Contact Us
If you have any questions about this version of BEA eLink Java Adapter for Mainframe WLS Edition, or if you have problems installing and running the software, contact BEA Customer Support through BEA WebSupport at www.beasys.com. You can also contact Customer Support by using the contact information provided on the Customer Support Card, which is included in the product package.
When contacting Customer Support, be prepared to provide the following information:
|
|
|
|
|
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|