BEA Logo BEA WebLogic Java Adapter for Mainframe Release 4.1

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy

 

   WebLogic Java Adapter for Mainframe Doc Home   |   WebLogic Java Adapter for Mainframe Installation Guide   |   Previous Topic   |   Next Topic   |   Contents   |  

Installing the Software

 

This section provides information for installing the BEA Java Adapter for Mainframe (JAM) software. After completing the tasks included in the previous section, "Preparing for Installation," install the JAM and SNA Communications Resource Manager (SNACRM) components according to your configuration requirements:

Note: Refer to the BEA WebLogic Java Adapter for Mainframe Release Notes for information on hardware and software requirements. For additional operational and administrative information on the SNACRM, refer to the SNACRM Administration Guide.

Installation topics are grouped by platform, and by component (JAM or SNACRM) if the component installations differ for particular platforms.

This section includes the following topics:

 


Installing the Software on a Non-Mainframe Unix-based Platform

Both the JAM and the SNACRM components are installed on non-mainframe Unix-based platforms with the install.sh script. You will select which components to install based on your configuration requirements.

To install the software on a Unix-based platform, complete the following steps:

  1. Run the install.sh script supplied on the product CD-ROM.

  2. Enter the needed information as the script progresses through the installation process. This script allows you to select the JAM components you want to install. The script will ask for the following information:

The following listings provide examples of running this script for each of the JAM components. You will supply the values in bold during installation. To accept default values at a prompt, press Enter.

Note: The platforms, stacks, and file names shown in the following listings are examples only. These values are dependent on platform and stack configurations for your system and may vary from the example.

Listing 4-1 Sample Script for JAM Component Installation on a Unix-based Platform


cmadm@dalhpw1:/cmhome/dist/fig-4> sh install.sh

01) hp/hpux11 02) ibm/aix43 03) sun5x/sol26
04) sun5x/sol7 05) sun5x/sol8

Install which platform's files? [01-5, q to quit, l for list]: 1

** You have chosen to install from hp/hpux11 **

BEA WebLogic Java Adapter for Mainframe Release 4.1

This directory contains the BEA WebLogic Java Adapter for Mainframe 4.1
for HP-UX 11.0 on 9000/800 series.


Is this correct? [y,n,q]: y

To terminate the installation at any time
press the interrupt key,
typically <del>, <break>, or <ctrl+c>.

The following packages are available:

1 crm SNA Communications Resource Manager
2 jam BEA WebLogic Java Adapter for Mainframe

Select the package(s) you wish to install (or 'all' to install
all packages) (default: all) [?,??,q]: 2

BEA WebLogic Java Adapter for Mainframe
(9000) Release 4.1
Copyright (c) 2000 BEA Systems, Inc.
All Rights Reserved.
Distributed under license by BEA Systems, Inc.
BEA eLink is a trademark of BEA Systems, Inc.


Directory where BEA WebLogic Java Adapter for Mainframe files are to be installed
(Enter your directory path) [?,q]: /work/cmadm

Using /work/cmadm as the BEA WebLogic Java Adapter for Mainframe base directory

Determining if sufficient space is available ...
7776 blocks are required
2156958 blocks are available to /work/cmadm

Unloading /cmhome/dist/fig-4/hp/hpux11/jam/JAMJA.Z ...
bin/jsnacrm.html
bin/jsnacrm.jar
bin/moncrm.jar
bin/moncrm.x509
classdocs/jamdoc.jar
examples/samples.jar
lib/ebase.jar
lib/jam.jar
7710 blocks
... finished

Changing file permissions...
... finished

Installation of BEA WebLogic Java Adapter for Mainframe was successful

The following packages are available:

1 crm SNA Communications Resource Manager
2 jam BEA WebLogic Java Adapter for Mainframe

Select the package(s) you wish to install (or 'all' to install
all packages) (default: all) [?,??,q]: q

Installation terminated
cmadm@dalhpw1:/cmhome/dist/fig-4>


Listing 4-2 Sample Script for SNACRM Component Installation on a Unix-Based Platform


cmadm@dalhpw1:/cmhome/dist/fig-4> sh install.sh

01) hp/hpux11 02) ibm/aix43 03) sun5x/sol26
04) sun5x/sol7 05) sun5x/sol8

Install which platform's files? [01-5, q to quit, l for list]: 1

** You have chosen to install from hp/hpux11 **

BEA WebLogic Java Adapter for Mainframe Release 4.1

This directory contains the BEA WebLogic Java Adapter for Mainframe 4.1
for HP-UX 11.0 on 9000/800 series.

Is this correct? [y,n,q]: y

To terminate the installation at any time
press the interrupt key,
typically <del>, <break>, or <ctrl+c>.

The following packages are available:

1 crm SNA Communications Resource Manager
2 jam BEA WebLogic Java Adapter for Mainframe

Select the package(s) you wish to install (or 'all' to install
all packages) (default: all) [?,??,q]: 1

SNA Communications Resource Manager
(9000) Release 1.2
Copyright (c) 2000 BEA Systems, Inc.
All Rights Reserved.
Distributed under license by BEA Systems, Inc.
BEA eLink is a trademark of BEA Systems, Inc.

Directory where SNA Communications Resource Manager files are to be installed
(Enter your directory path) [?,q]: /work/cmadm

Using /work/cmadm as the SNA Communications Resource Manager base directory

The following CRM stack support options are available:

1 hp60 SNA plus2 v6.0

Select an option [?,??,q]: 1

Determining if sufficient space is available ...
21828 blocks are required
2156958 blocks are available to /work/cmadm

Unloading /cmhome/dist/fig-4/hp/hpux11/crm/CRMSA.Z ...
bin/CRMLOGS
bin/SNACRM
bin/bealogo.gif
bin/crmdown
bin/crmlkoff
bin/crmlkon
bin/hpux.env
lib/fmb.def
lib/libbuft.sl
lib/libcsxappc.sl
lib/libcsxcrm.sl
lib/libcsxgpw.sl
lib/libcsxscrm.sl
lib/libcsxxcrm.sl
lib/libcsxxfm.sl
lib/libcsxxmw.sl
lib/libctxdebugs_12.sl
lib/libctxmess_12.sl
lib/libctxos_12.sl
lib/libctxplat_12.sl
lib/libctxprim_12.sl
lib/libfml.sl
lib/libfml32.sl
lib/libgp.sl
lib/libgpnet.sl
lib/libtux.sl
lib/libtux2.sl
21370 blocks
... finished

Unloading /cmhome/dist/fig-4/hp/hpux11/crm/STKSA.Z ...
lib/libcsxhp60.sl
1610 blocks
... finished

Changing file permissions...
... finished

Installation of SNA Communications Resource Manager was successful

The following packages are available:

1 crm SNA Communications Resource Manager
2 jam BEA WebLogic Java Adapter for Mainframe

Select the package(s) you wish to install (or 'all' to install
all packages) (default: all) [?,??,q]: q

Installation terminated
cmadm@dalhpw1:/cmhome/dist/fig-4>


 


Installing the SNACRM Component on an OS/390 Unix Platform

The following steps install the SNACRM on an OS/390 Unix platform. This installation is for a distributed configuration where the SNACRM resides on the mainframe in an OS/390 environment.

Note: This procedure assumes the installer is familiar with File Transfer Protocol (FTP) functions.

  1. Load the product CD-ROM on a machine that has File Transfer Protocol (FTP) access to the OS/390 host.

  2. Copy the file os390.tar (in binary mode) from the root directory on the CD-ROM to the working directory on the OS/390 host.

  3. To extract the installation script from the tar file on the mainframe, use the following command:

    tar xvfo os390.tar

    Executing the tar command extracts the install.sh script and subdirectories containing the software to be installed from the tar file.

  4. Execute the install.sh script using the following command:

    sh install.sh

The installation script prompts you for responses. Listing 4-3 is a sample installation. It shows the installation of the SNACRM only in a distributed configuration on an OS/390 mainframe platform. User responses are in bold.

Listing 4-3 Sample Script for SNACRM Component Installation on an OS/390 Unix Platform


igor:/bea/loads/dist/fig-4: >sh install.sh

01) os390/os390r8

Install which platform's files? [01- 1 , q to quit, l for list]: 1

** You have chosen to install from os390/os390r8 **

BEA eLink SNA Communications Resource Manager Release 1.2

This directory contains the BEA eLink SNA Communications Resource Manager 1.2
for IBM OS/390 Unix R8 on IBM OS/390.

Is this correct? [y,n,q]: y

To terminate the installation at any time
press the interrupt key,
typically <del>, <break>, or <ctrl+c>.

The following packages are available:

1 crm SNA Communications Resource Manager

Select the package(s) you wish to install (or 'all' to install
all packages) (default: all) [?,??,q]:

SNA Communications Resource Manager
(OS390) Release 1.2
Copyright (c) 2000 BEA Systems, Inc.
All Rights Reserved.
Distributed under license by BEA Systems, Inc.
BEA eLink is a trademark of BEA Systems, Inc.

Directory where SNA Communications Resource Manager files are to be installed
(Enter your directory path) [?,q]: /u/igor

Using /u/igor as the SNA Communications Resource Manager base directory
Usage: expr expression

The following CRM stack support options are available:

1 vtm28 OpenEdition MVS 390 vtm28 OpenEdition MVS 390

Select an option [?,??,q]: 1

Determining if sufficient space is available ...
68000 blocks are required
270552 blocks are available to /u/igor

Unloading /bea/loads/dist/fig-4/os390/os390r8/crm/CRMSA.Z ...
6800 blocks
x bin/CRMLOGS
x bin/SNACRM
x bin/crmdown
x bin/crmlkoff
x bin/crmlkon
x bin/uss.env
x lib/csxappc.dll
x lib/csxcrm.dll
x lib/csxgpw.dll
x lib/csxscrm.dll
x lib/csxxcrm.dll
x lib/csxxfm.dll
x lib/csxxmw.dll
x lib/ctxdebugs_12.dll
x lib/ctxmess_12.dll
x lib/ctxos_12.dll
x lib/ctxplat_12.dll
x lib/ctxprim_12.dll
x lib/fmb.def
x lib/libbuft.dll
x lib/libfml.dll
x lib/libfml32.dll
x lib/libgp40.dll
x lib/libgpnet.dll
x lib/libtux.dll
x lib/libtux2.dll
... finished

Unloading /bea/loads/dist/fig-4/os390/os390r8/crm/STKSA.Z ...
241 blocks
x lib/csxvtm28.dll
... finished

Changing file permissions...
... finished

Installation of SNA Communications Resource Manager was successful

Please don't forget to fill out and send in your registration card
igor:/bea/loads/dist/fig-4: >


 


Installing the SNACRM Component on an OS/390 MVS Platform

This section explains how to install the SNACRM component on an OS/390 Multiple Virtual Storage (MVS) platform. This installation is for a distributed configuration where the SNACRM resides on the mainframe in an OS/390 MVS environment.

Summary of Installation Tasks

The following list is a summary of the tasks detailed in "Installation Procedure":

The installation for this environment is semi-automated. Two JCL files are provided to facilitate prerequisites for allocating data sets in the MVS environment and to unload JAM product software into the allocated data sets.

The product CD-ROM contains the following files relating to this installation procedure:

Installation Procedure

Perform the following steps to install the SNACRM component on an OS/390 MVS platform:

  1. Load the product CD-ROM on a machine that has File Transfer Protocol (FTP) access to the OS/390 host.

  2. Use FTP to put the following JCL files in the MVS destination PDS dataset:

    README
    dsupload.jcl
    install.jcl

  3. In your MVS environment, change the DSUPLOAD job to suit your environment. This job allocates the initial data sets needed to receive the product software files from the FTP file transfer.

    Use the SET statements in the DSUPLOAD job to set the high-level qualifiers of the receiving datasets.

    SET BEAHLQ=[QUALIFIER]

    Where [DATASET] is a high-level qualifier used to create the data sets.

    The DSUPLOAD job has the following steps:

    DELOLD

    Deletes any existing data sets previously created so you can run this JCL multiple times, if necessary. To run this step, remove the RESTART parameter in the job information.

    CREATE

    Allocates the initial data sets needed to receive the product software files.

  4. Run the DSUPLOAD job.

  5. Put the files listed in Table 4-1 into their corresponding data sets. Use the table as a worksheet and fill in the names you created in step 3. Use the worksheet as a guide for transferring the product data to the OS/390 platform.

    Table 4-1 MVS Installation Product Files and DD Name Data Sets

    Product File

    Set Statement

    Your Dataset Name

    JAM41.LOAD

    BEAHLQ

    .LOAD

    JAM41.DATA

    BEAHLQ

    .DATA

    JAM41.SAMPLE

    BEAHLQ

    .SAMPLE

  6. From the Unix/NT command prompt, set binary data transfer mode using the FTP program.

    Example of a PUT command:

    PUT JAM41.LOAD 'BEA.JAM41.LOAD'

    Transfer the data sets using the put command.

  7. In your MVS environment, change the INSTALL job to suit your environment.

    Use the SET statements to alter the job for your environment.

    SET SMSHLQ=[QUALIFIER]

    Where [QUALIFIER] is the high-level qualifier for the SNACRM Load Library. The load library containing the JAM41.LOAD program objects must be a Partitioned Data Set with Extended attributes (PDSE). The PDSE minimally must have storage class SMS declaration for OS/390 v2.8.

    SET HLQ=[QUALIFIER]

    Where [QUALIFIER] is the high-level qualifier for the sample and data datasets. These are standard PDS.

    SET SCLASS=[CLASS NAME]

    Where [CLASS NAME] is the storage class name of the PDSE. This is required for OS/390 v2.8.

    The INSTALL job has the following steps:

    DELOLD 

    Deletes any existing data sets created by the INSTALL job so you can run this JCL multiple times, if necessary. To run this step, remove the RESTART parameter in the job information.

    CREATE

    Creates the MVS data sets for you.

    This step includes the minimal JCL needed to create the data sets for OS/390 v2.8. You may change the JCL to reflect your own environment.

  8. Run the INSTALL job.

    Use the following table as a worksheet to fill out the names of the datasets created in this step.

    Table 4-2 Set Statements and Corresponding Datasets

    Set Statement

    Your Dataset Name

    SMSHLQ

    .LOAD

    BEAHLQ

    .DATA

    BEAHLQ

    .SAMPLE

  9. Enter the TSO RECEIVE command to unload the data in your installation data sets created in Step 8. For example, enter the following command:

    TSO RECEIVE INDS(`xxx')

    When prompted, enter:

    DA("yyy")

    where:

    xxx

    Is the dataset name you listed in Table 4-1.

    yyy

    Is the corresponding dataset name you listed in Table 4-2.

 


Installing the Software on a Windows NT Platform

Complete the following steps to install the JAM software on a Windows NT system.

  1. Insert the product CD-ROM into your drive and click on the Run option from the Start menu. The Run window displays. Click the Browse button to select the CD-ROM drive. Select the Winnt folder, then select the Setup.exe file. Click OK to run the executable and begin the installation. The Welcome screen displays as shown in Figure 2-1. Click Next to continue.

    Figure 4-1 Welcome Screen

  2. When the BEA Software License Agreement displays as shown in Figure 2-2, click Yes to accept the terms of the agreement and continue with the product installation. Click No to exit the installation process.

    Figure 4-2 BEA Software License Agreement

  3. When the User Information screen, shown in Figure 2-3, displays after the License Agreement, enter the name of the eLink Platform System Administrator in the Name field. Enter the name of your company in the Company field. Click Next to continue with the installation.

    Figure 4-3 User Information Screen

  4. When the Select Components screen (shown in Figure 2-4) displays after the User Information screen, select the components you want to install; clear the components you do not want to install.

    Figure 4-4 Select Components Screen

  5. When the Choose Destination Location screen displays as shown in Figure 2-5, enter the directory where you want the software installed and click Next.

    Note: The Choose Destination Location screen will display for each component you select to install.

    Figure 4-5 Choose Destination Location Screen

  6. When the Installation Progress screen displays, indicating the progress of the installation of files, the quantity of read operations from the CD-ROM, the available disk space being used, and the completion percentage of the installation process. When the bar displays 100%, the installation has completed. You may abort the installation process anytime prior to completion by clicking the Cancel button.

  7. The Setup Complete Screen will display, indicating the eLink software has been successfully installed on your platform. Click Finish to exit the installation process. See Figure 2-6.

    Figure 4-6 Setup Complete Screen

Uninstalling Java Adapter for Mainframe on Windows NT

Complete the following steps to uninstall JAM on a Windows NT system.

  1. Click the Start button, and then point to Settings. Point to the folder that contains Control Panel, and then click Control Panel.

  2. Double-click on the Add/Remove Programs option from the Control Panel listings to access the Add/Remove Programs Properties window.

  3. In the Add/Remove Program Properties window, select eLink Java Adapter for Mainframe 4.1, JAM Edition from the program list and click the Add/Remove button.

  4. When the message box asks if you are sure you want to completely remove the software and its components, click Yes to continue with uninstalling. Click No to cancel uninstalling.

  5. The uninstall process for JAM begins. As shown in Figure 2-7, the Remove Programs From Your Computer screen displays. Click OK to complete the uninstall process.

    Figure 4-7 Remove Programs From Your Computer Screen

 


Verifying Installation Files and Directories

The JAM CD-ROM contains the following libraries and executable programs for each of the following installation scenarios and their supported platforms. After installing the JAM software, verify that these libraries and programs are installed on your system.

JAM Installation

All directories are relative to the installation directory. Platform specific stack abstraction libraries are included in these tables as well.

Solaris

Verify that the following JAM files are installed by the JAM software:

Table 4-3 Solaris Installation Files and Directories

Directory

Files

bin

jsnacrm.html
jsnacrm.jar
moncrm.jar
moncrm.x509
egencobol

lib

jam.jar
ebase.jar

classdocs

jamdocs.jar

examples

samples.jar

AIX

Verify that the following JAM files are installed by the JAM software:

Table 4-4 HP-UX Installation Files and Directories

Directory

Files

bin

jsnacrm.html
jsnacrm.jar
moncrm.jar
moncrm.x509
egencobol

lib

jam.jar
ebase.jar

classdocs

jamdocs.jar

HP-UX

Verify that the following JAM files are installed by the JAM software:

Table 4-5 HP-UX Installation Files and Directories

Directory

Files

bin

jsnacrm.html
jsnacrm.jar
moncrm.jar
moncrm.x509
egencobol

lib

jam.jar
ebase.jar

classdocs

jamdocs.jar

Windows NT

Verify that the following JAM files are installed by the JAM software:

Table 4-6 Windows NT Installation Files and Directories

Directory

Files

bin

jsnacrm.html
jsnacrm.jar
moncrm.jar
moncrm.x509
egencobol.cmd

lib

jam.jar
ebase.jar

classdocs

jamdocs.jar

Examples Directories and Files

The following directories and files are included in the examples installation directory. These files are used in examples described in the BEA WebLogic Java Adapter for Mainframe User Guide.

Table 4-7 Examples Directories and Files

Directory

Files

examples/common

CICS.RDO
DPLDEMOC
DPLDEMOR
DPLDEMOU
DPLDEMOD
EMPREC

examples/servlet

README
servlet.script

examples/ejb

README
ejb.script

examples/standalone

README
standalone.script

examples/inbound/loopback

README
CICS.RDO
LBDPLOUT
LBDPLIN
inbound.script

examples/inbound/TDQueue

README
CICS.RDO
DPLINIT
DPLSERVER
inbound.script

Distributed SNACRM Installation

Verify that the following SNACRM platform files are installed on your system.

All directories are relative to the specified installation directory. Also included are the eLink Platform libraries that will ship with the standalone SNACRM. For encryption purposes, the libgp that is shipped will be the one enabled for 40-bit encryption.

Solaris

Verify that the following SNACRM platform files are installed by the JAM software:.

Table 4-8 Solaris Installation Files and Directories

Directory

Files

bin

CRMLOGS
SNACRM
crmlkon
crmlkoff
crmdown
bealogo.gif
solaris.env

lib

fmb.def
libbuft.so
libcsxappc.so
libcsxcrm.so
libcsxgpw.so
libcsxscrm.so
libcsxxcrm.so
libcsxxfm.so
libcsxxmw.so
libctxdebugs_12.so
libctxmess_12.so
libctxos_12.so
libctxplat_12.so
libctxprim_12.so
libfml.so
libfml32.so
libgp.so
libgpnet.so
libtux.so
libtux2.so

HP-UX

Verify that the following SNACRM platform files are installed by the JAM software.

Table 4-9 HP-UX Installation Files and Directories

Directory

Files

bin

CRMLOGS
SNACRM
crmlkon
crmlkoff
crmdown
bealogo.gif
hpux.env

lib

fmb.def
libbuft.sl
libcsxappc.sl
libcsxcrm.sl
libcsxgpw.sl
libcsxscrm.sl
libcsxxcrm.sl
libcsxxfm.sl
libcsxxmw.sl
libctxdebugs_12.sl
libctxmess_12.sl
libctxos_12.sl
libctxplat_12.sl
libctxprim_12.sl
libfml.sl
libfml32.sl
libgp.sl
libgpnet.sl
libtux.sl
libtux2.sl

OS/390 Unix

Verify that the following SNACRM platform files are installed by the JAM software.

Table 4-10 OS/390 Installation Files and Directories

Directory

Files

bin

crmlkoff
crmlkon
CRMLOGS
SNACRM
crmdown
uss.390

lib

fmb.def
ctxmess_12.dll
ctxdebugs_12.dll
ctxos_12.dll
ctxprim_12.dll
ctxplat_12.dll
csxappc.dll
csxxfm.dll
csxxmw.dll
csxgpw.dll
csxcrm.dll
csxxcrm.dll
csxscrm.dll
csxvtm28.dll
libbuft.dll
libgp40.dll
libgpnet.dll
libfml.dll
libfm132.dll
libtux.dll
libtux2.dll

OS/390 MVS

Verify that the following SNACRM platform files are installed by the JAM software.

Table 4-11 HP-UX Installation Files and Directories

Directory

Files

misc

README
DSUPLOAD
INSTALL

load library

CRMLOGS
SNACRM
CRMLKON
CRMLKOFF
CSXAPPC
CSXFR
CSXXMW
CSXGPW
CSXCRM
CSXXCRM
CSXSCRM
CSXVTM28
CRMDOWN
MESS
DEBUGS
OS
PRIM
PLAT

data library

FMB
ENV

sample library

SNACRM
CRMLOGS
CRMLKON
CRMLKOFF
CRMDOWN

Windows NT

Verify that the following SNACRM platform files are installed by the JAM software

.

Table 4-12 Windows NT Installation Files and Directories

Directory

Files

bin

bealogo.gif
crmlkoff.exe
crmlkon.exe
crmlogs.exe
crmdown.exe
csxappc.dll
csxcrm.dll
csxgpw.dll
csxibm60.dll
csxms40.dll
csxscrm.dll
csxxfm.dll
ctxdebugs_12.dll
ctxmess_12.dll
ctxos_12.dll
ctxprim_12.dll
ctxplat_12.dl
ntenv.bat
libgp.dll
libgpnet.dll
libfml.dll
libfml32.dll
libtux.dll
libtux2.dll
libbuft.dll

lib

fmb.def

 


Setting Up the License Key

After you install the JAM software, you need to set up your license key. As a prerequisite for using the JAM license key, WebLogic Server and the WebLogic Process Integrator must be installed and operational. The license files for WebLogic Server and WebLogic Process Integrator are XML-based and reside in the server/license directory in your WebLogic Process Integrator installation. The WebLogic Server license file is WebLogicLicense.xml. You must append the license key for the JAM software to the BEA license file, license.bea, to enable the connection capabilities for your system. Refer to your BEA WebLogic Server and BEA WebLogic Process Integrator documentation for more information about their respective license files.

Note: If you are not integrating with WebLogic Process Integrator, disregard instructions and examples pertaining to WebLogic Process Integrator.

The directory where the BEA license file resides is specified by one of the following:

In addition to appending the JAM license key, you must place a set of JAM jar files in your CLASSPATH so that the JAM software can be used.

Appending the License Key to the BEA License File

To enable the JAM license key, you must append the license key file provided with the JAM product software to the BEA license file (license.bea). This can be done automatically by answering a query at JAM installation time, or it can be done manually as shown in the steps below.

Caution: Do not alter any information within sections of the license key files. This is a violation of the BEA Systems licensing agreement. Doing so may disable JAM and/or additional components.

Perform the following steps to use the license key.

  1. With the text editor of your choice, open the BEA license file in server/license/license.bea. An example of this file follows.

    Listing 13 Sample BEA License File

    <!--
    ! license.bea
    !BEA product software license file.
    !-->

    <bea-licenses>

    <license-group
    format="1.0"
    product="wlpi"
    release="1.0">

    <license
    component="WebLogic Process Integrator"
    expiraton="2001-12-31"
    id="001-0001-02A
    licensee="Sally GoodUser"
    type="normal"
    users="200"
    cpus="10"
    ip="*"
    signature="MCwC88hbwQK9aANkMvdkworeigNr"
    />

    </license-group>
    </bea-licenses>


  2. Append the JAM group portion of the JAM license key file to the BEA license file. Following is an example of the JAM license key appended to the BEA license file with the JAM license key portion highlighted in bold.

    Listing 14 Sample BEA License File with JAM License Key Appended

    <!--
    ! license.bea
    !BEA product software license file.
    !-->

    <bea-licenses>

    <license-group
    format="1.0"
    product="wlpi"
    release="1.0">

    <license
    component="WebLogic Process Integrator"
    expiraton="2001-12-31"
    id="001-0001-02A
    licensee="Sally GoodUer"
    type="normal"
    users="200"
    cpus="10"
    ip="*"
    signature="MCwC88hbwQK9aANkMvdkworeigNr"
    />

    </license-group>

       <license-group
    format="1.0"
    product="jam"
    release="4.1">

    <license
    component="JAM CRM Gateway"
    expiraton="2001-12-31"
    id="001-0001-01A
    licensee="Sally GoodUer"
    type="normal"
    users="200"
    cpus="10"
    ip="*"
    signature="ABCQ6d9AhRd4dTUYHuLM72"
    />

    </license-group>
    </bea-licenses>


  3. Save the file and exit the text editor. Your license key is now in effect.

Setting the CLASSPATH

The following JAM jar files should be placed on the CLASSPATH in order for the JAM license key and JAM to work: