bea.com | products | dev2dev | support | askBEA

Download Docs
Search

Installation and Configuration Guide for DCL SNAP-IX

Introduction to Installing BEA WebLogic JAM

Proper installation is essential to successfully operating BEA WebLogic Java Adapter for Mainframe (hereafter referred to as WebLogic JAM). The following sections provide an overview of the installation process for WebLogic JAM for use with the DCL SNAP-IX stack.

About BEA WebLogic Product Distribution

The BEA WebLogic JAM for DCL SNAP-IX is distributed only on the Web. Service Packs for WebLogic JAM are distributed only on the Web.

Web Distribution of WebLogic JAM

An evaluation copy of WebLogic JAM 5.1 is available for download from the BEA corporate Web site at http://commerce.bea.com/downloads/weblogic_server.jsp#jam. When you download WebLogic JAM, you get a built-in 30-day evaluation license. BEA provides an additional 60-day evaluation license that can be downloaded from the same location. At the end of the evaluation period, you can purchase a non-expiring license for your WebLogic JAM product.

WebLogic JAM is distributed as an installer file that contains a copy of the BEA installation program, InstallAnywhere.

CD-ROM Distribution of WebLogic JAM

If you purchased WebLogic JAM from your local sales representative, you will find the following items in the product box:

- Two CD-ROMs:

- BEA WebLogic Java Adapter for Mainframe product software CD

- BEA WebLogic Java Adapter for Mainframe Online Documentation CD

- The following printed documents:

- BEA WebLogic Java Adapter for Mainframe Installation Guide

- BEA WebLogic Java Adapter for Mainframe Release Notes

- BEA Software License and Limited Warranty pamphlet

- Customer Support Quick Reference and Other Important Information card

You can also access the WebLogic JAM Online Documentation at:

http://www.oracle.com/technology/documentation/index.html

Note: The WebLogic JAM for DCL SNAP-IX is not included on the CD-ROM.

About the WebLogic JAM Components

WebLogic JAM enables applications running on WebLogic Server and mainframe systems to interact using two main components:

- The Gateway

The WebLogic JAM Gateway component is a server that runs within WebLogic Server and communicates with the CRM using the TCP/IP protocol. The WebLogic JAM Gateway acts as a gateway to route requests and responses between WebLogic Server and mainframe systems, such as CICS and IMS. The Gateway component also forwards configuration information to the CRM at start-up.

- The Communications Resource Manager (CRM)

The CRM is the WebLogic JAM component that manages communications resources. The CRM coordinates the flow of data between Java applications running on a WebLogic Server platform and applications running on a mainframe. The mainframe applications may use CICS/ESA with Distributed Program Link (DPL) or Advanced Program-to-Program Communications (APPC), or IMS with implicit or explicit APPC.

About the BEA WebLogic JAM Installation Program

The InstallAnywhere installation program is the BEA standard tool for WebLogic product installation. InstallAnywhere installs the WebLogic JAM Gateway and CRM on the target UNIX system.

Installation Methods

InstallAnywhere supports the following installation methods:

- Graphical user interface (GUI) mode installation

- Console-mode installation (UNIX systems only)

About the BEA Home Directory

When installing WebLogic JAM, the installer program prompts you to specify a BEA Home directory. The BEA Home directory is a repository for common files that are used by multiple BEA products installed on the same machine. For this reason, the BEA Home directory can be considered a central support directory for the BEA products installed on your system.

The files in the BEA Home directory are essential to ensuring that the BEA software operates correctly on your system. They perform the following types of functions:

- Ensure that licensing works correctly for the installed BEA products

- Facilitate checking of cross-product dependencies during installation

- Facilitate Service Pack installation

About the BEA WebLogic JAM License

WebLogic JAM uses an XML-format license called license.bea. This license file, stored in the BEA Home directory, is used for the BEA WebLogic products installed on the target system.

The first time you download and install a BEA WebLogic product that uses the BEA Home directory convention, the installer program installs a license.bea file in the BEA Home directory that you created during installation and populates the file with an evaluation product license. Subsequently, when you download and install additional BEA products that contain a license.bea file as part of the distribution, the installer program automatically adds the new evaluation product licenses to the license.bea file.

Evaluation Licenses

An evaluation copy of WebLogic JAM comes with a 30-day evaluation license so that you can start using WebLogic JAM immediately. BEA also offers an extended 60-day evaluation license that can be downloaded from the BEA Web site. To use WebLogic JAM beyond the evaluation period, contact your salesperson about purchasing a non-expiring license.

Non-Expiring Licenses

If you purchase WebLogic JAM, you will receive a development or production product license through email. After installing the WebLogic JAM software and receiving the product license, you must update the existing license.bea file with the license file you received.

Acquiring a WebLogic JAM License

You acquire a WebLogic JAM license from BEA in one of two ways: from the BEA Web site when you download an evaluation copy of the WebLogic JAM product, or through email when you purchase WebLogic JAM. When you download WebLogic JAM from the BEA Web site, an evaluation license is included with the distribution.

Miscellaneous Notes

The following items are specific to running WebLogic JAM with DCL SNAP-IX.

- The Solaris 7 and 8 CRM is not persistent. When it loses its Gateway, it goes down and needs to be restored.

- The multiple Gateway to a single CRM feature is not supported with the Solaris 7 or 8 CRM.