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:

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:

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:

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:

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.