bea.com | products | dev2dev | support | askBEA

Download Docs
Search

Installation and Configuration Guide for DCL SNAP-IX

Installing BEA WebLogic Java Adapter for Mainframe for DCL SNAP-IX

After you have reviewed the Preparing to Install WebLogic Java Adapter for Mainframe for DCL SNAP-IX section, you are ready to begin installing WebLogic JAM.

Installing WebLogic JAM includes the following tasks:

- Locating the Installation Files

- Installing WebLogic JAM

Locating the Installation Files

The installation files for installing WebLogic JAM for DCL SNAP-IX are available by download only from the BEA download site. You will need to download wljam51_Sol7DCL7.bin or wljam51_DCL7.bin file.

Installing WebLogic JAM

BEA WebLogic JAM can be installed in the following ways:

- In Graphical Mode

Graphical-mode installation is the graphics-based method of executing the BEA installation program.

- In Console Mode

Console-mode installation is the text-based method of executing the BEA installation program.

Installing WebLogic JAM Using Graphical-mode Installation

Perform the following steps to install the WebLogic JAM in Graphics mode.

1. Log on as root to install the WebLogic JAM software.

   >     $ su -

   >     Password:

2. Set the JAVA_HOME and PATH environment variables. For example, if your BEA Home directory is /usr/bea, then the environment variables should be set in the following way:

   >     export JAVA_HOME=/usr/bea/jdk131_02

   >     export PATH=/usr/bea/jdk131_02/bin:$PATH

3. If you are installing remotely (from a machine other than the one upon which you are installing WebLogic JAM), define the DISPLAY environment variable as follows:

   >     export DISPLAY=xx.xx.xx.xx:0.0

   (xx.xx.xx.xx is the IP address of the machine from which you are installing)

   Note: If you are installing remotely from Microsoft Windows, you must use an X-Window terminal emulator.

4. Execute the installation program. For example, on Solaris 8 enter:

   >     sh wljam51_DCL7.bin

   The BEA WebLogic Java Adapter for Mainframe splash screen displays.

   The splash screen is followed by the Introduction screen.

5. Click Next to continue with the installation. The License Agreement screen displays.

   After reading the license agreement, click Yes to accept the license agreement and click Next to proceed with the installation. The Choose BEA Home Directory screen displays.

   Note: If you click No, you will not be able to continue with the installation. You must either exit the installation or go back to the Introduction screen.

6. Create or select a BEA Home directory (the default is bea). The BEA Home directory is the root directory in which you install all BEA products.

   If you do not already have a BEA Home directory, you can create one by following these steps:

   1. Select the Create a New BEA Home option button.

   2. Accept the default location for your BEA Home directory or click Browse to specify a different location. If you accept the default location, your BEA Home directory will be bea, and your WebLogic JAM software default installation directory is bea/work/userid/bea. If you do not want to install WebLogic JAM in this default location, you will have the opportunity, in Step 11, to choose another directory in which to install the software.

   3. Click Next to proceed with the installation.

   If you already have one or more BEA Home directories on your system, you can use one of those directories as follows:

   1. Select the Use Existing BEA Home option button.

   2. Select a BEA Home directory from the list displayed to the right of the option buttons. All valid BEA Home directories are displayed in this list. Valid BEA Home directories are directories where BEA products have been installed using the standard installation program.

   3. Click Next to proceed with the installation.

7. If the installation program encounters a previous version of WebLogic JAM in the selected BEA Home directory, the Previous Installation Found message box displays. From this message box, do one of the following:

   - Click Continue to install over the previous version.

   - Click Cancel to return to the Choose BEA Home Directory screen and select another directory.

   - Click Exit to exit the installation program.

8. If you do not have a successful installation of WebLogic Server 7.0 in the BEA Home directory, the following warning box displays.

   From this warning box, do one of the following:

   - Click Exit to exit the installation program.

   - Click Previous to return to the Choose BEA Home Directory screen and select another directory.

   - Click Next to proceed with the installation process. However, WebLogic JAM will not be functional until you perform a successful installation of the WebLogic Server Service Pack.

9. If this is your first WebLogic JAM installation, once you have selected a BEA Home Directory in which to install WebLogic JAM, the Choose Product Directory screen displays.

10. Specify an installation directory for WebLogic JAM by performing one of the following actions:

    - Accept the default installation directory.

    - Enter the installation directory directly into the text entry field.

    - Click Browse and navigate to your desired installation root directory, then click OK to make the directory path appear in the Specify Product Installation Directory text entry field.

    Note: Clicking Reset resets the installation directory to the previous value (before you made any changes).

11. Click Install to accept the product directory you have chosen and proceed with the installation. WebLogic JAM will create a wljam5.1 folder in the BEA Home directory. The Install Complete screen displays once you click Install.

12. Click Done to exit the installation program.

Installing WebLogic JAM in Console Mode

To install WebLogic JAM in console-mode, run the wljam51_Sol7DCL7.bin or wljam51_DCL7.bin program.

Perform the following steps to install WebLogic JAM in console mode:

1. Log on as root.

   >     $ su -

   >     Password:

2. Set the JAVA_HOME and PATH environment variables as follows:

   >     export JAVA_HOME=<BEA_HOME>/jdk131_02

   >     export PATH=<BEA_HOME>/jdk131_02/bin:$PATH

   Example: If your BEA Home directory is /usr/bea, then these environment variables should be set as follows:

   >     export JAVA_HOME=/usr/bea/jdk131_02

   >     export PATH=/usr/bea/jdk131_02/bin:$PATH

3. Execute the appropriate installation program for your non-mainframe Unix system in character-based mode. For example, to execute the WebLogic JAM for DCL SNAP-IX installation program for Solaris 8, enter the following:

   >     sh wljam51_DCL7.bin -i console

4. The installation program runs and prompts you for responses.

Listing 3-1 Console Mode Installation Example

>     Preparing to install...

>     Preparing CONSOLE Mode Installation...

>     ======================================================================

>     BEA WebLogic Java Adapter for Mainframe(created with InstallAnywhere by Zero G)

>     -----------------------------------------------------------------

>     ======================================================================

>     Introduction

>     ------------

>     This installer will guide you through the installation of 'WebLogic Java

>     Adapter for Mainframe'. On each step, answer the questions provided.  Type

>     "quit" at any time to exit the installer.

>     PRESS <ENTER> TO CONTINUE:

>     ======================================================================

>     License Agreement

>     -----------------

>     Please read before installing:

>     BEA WebLogic Java Adapter for Mainframe(r) 5.1 Software License

>     The Software and accompanying documentation (respectively "Software"and "Documentation") you have acquired are protected by the copyright laws of the United States and international copyright treaties. In addition, the possession and use of the Software and Documentation is subject to the restrictions contained in this License.

>     For purposes of this agreement:

>     Client Software means the Software programs provided as part of the Software that operate on an intelligent, single user device, permitting that device access to the shared resources provided by Server Software.

>     Server Software means the Software programs provided as part of the Software that are designed to operate on a single computing device, providing access to the shared resources attached to that computer.  Server Software may contain technical limitations that limit use of Server Software to a specified number of Users.

>     User Count means the number of users specified on the uniform product code label provided on the outside packaging of the Product.

>     PRESS <ENTER> TO CONTINUE:

>     Connection Management Software means the computer programs provided as part of the Software which monitor the number of connections permitted under this License and which are designed to prevent more connections than the number of licensed connections specified by the User Count.

>     User means a connection to the Server Software permitting a user or a process access to the shared resources provided by Server Software.

>     Domain means a single unit Server Software (network server) or a collection of Server Software defined as an administratively autonomous System application(s).

>     The Software contains various Software programs with different license rights. Some of the programs are licensed for use on a single Domain, whereas some are licensed for use on several machines (workstations). The type of license that applies depends on the following definitions and the permitted uses specified in the documentation.

>     License.  Subject to the terms and conditions of this License,  BEA grants to you a non-exclusive, non-transferable right to (a) use the Server Software on a single Domain and (b) provided you do not receive any direct payment, to make, distribute and simultaneously use internally within your organization, PRESS <ENTER> TO CONTINUE:

>     up to the User Count number of copies of the Client Software.  The Client Software may not be used to support other than the Server Software. You may not modify the Connection Management Software or otherwise multiplex workstations to increase the number of connections supported by the Server Software. Further, you may not use any device, process or computer program in conjunction with the Server Software which increases, either directly or indirectly, the number of connections to the Server Software.

>     Except as permitted by law despite this restriction, you agree, not to reverse compile, disassemble, or otherwise reverse engineer the Software. You also agree not to lease, rent, sublicense or otherwise transfer the Software to any third party, nor to modify or create a derivative work of the Software or otherwise use them except as provided for in this license.

>     BEA reserves all rights not expressly granted to you.

>     General Terms

>     Term. This License will become effective on the date you acquire the Software and will remain in force until terminated.  You may terminate this License at any time by destroying the Documentation and Software together with all copies and adaptations. This License shall also automatically terminate if you PRESS <ENTER> TO CONTINUE:

>     breach any of the terms or conditions. You agree to destroy the original and all copies of the Software and Documentation, or to return them to BEA upon termination of this License.

>     Governing Law. Except as otherwise restricted by law, this License shall be governed by, and interpreted in accordance with, the laws of the State of California of the United States of America, without regard to laws of California governing conflicts of law.  Furthermore, it is understood that this License shall be treated as though it were executed in the State of California. The parties agree that any action relating to this License shall be instituted and prosecuted in the courts of competent jurisdiction of the State of California.

>     Entire License. This License sets forth the entire understanding and License between you and BEA and may be amended only in writing signed by both parties. NO VENDOR, DISTRIBUTOR, DEALER, RETAILER, SALES PERSON OR OTHER PERSON IS AUTHORIZED TO MODIFY THIS LICENSE OR TO MAKE ANY WARRANTY, REPRESENTATION OR PROMISE WHICH IS DIFFERENT THAN, OR IN ADDITION TO, THE REPRESENTATIONS OR PROMISES OF THIS LICENSE.

>     Waiver. No waiver of any right under this License shall be effective unless in writing and signed by a duly authorized representative off the party to be PRESS <ENTER> TO CONTINUE:

>     bound.  No waiver of any past or present right arising from any breach or failure to perform shall be deemed to be a waiver of any future right arising under this License.

>     Severability. If any provision in this License is invalid or unenforceable, that provision shall be construed, limited, modified or, if necessary, severed, to the extent necessary, to eliminate its invalidity or unenforceability, and the other provisions of this License shall remain unaffected.

>     Export. BEA can only make the Software available pursuant to a valid export license. Consequently, BEA will refund any fees paid by you if it is unable to obtain an export license to ship the Software to you. Your sole remedy to BEA for BEA's failure to obtain an export license is a refund. You hereby agree that you will not knowingly, directly or indirectly, without prior written consent, if required, of the Office of Export Licensing of the U.S. Department of Commerce, Washington D.C. 20230, download, export, transmit or transfer the Software to any group Q, S, W, Y, or Z country specified in the Export Administration Regulations issued by the U.S. Department of Commerce or to any country to which such transmission is restricted by applicable regulations or statutes.

>     PRESS <ENTER> TO CONTINUE:

>     U.S. Government Restricted Rights. Use, duplication, or disclosure by the United States Government is subject to restrictions as set forth in FAR 52.227-14 (June 1987) Alternate III(g)(3) (June 1987), FAR 52.227-19 (June 1987), or DFARS 52.227-7013 (c)(1)(ii) (June 1988), as applicable. Contractor/Manufacturer is BEA Systems, Inc. 2315 North First Street, San Jose, CA 95131

>     BEA is a registered trademark of BEA Systems, Inc.

>     BEA Tuxedo is a registered trademark of BEA Systems, Inc. in the US and other countries

>     Copyright 2002, BEA Systems, Inc.  All Rights Reserved.

>     DO YOU AGREE WITH THE TERMS OF THE LICENSE? (Y/N): y

>     =======================================================================

>     Choose BEA Home Directory

>     -------------------------

>         1- Create a New BEA Home
>         2- Use Existing BEA Home

>     Enter a number: 2

>         1- /bea/loads
>         2- /cmhome/wls70

>     Existing BEA Home: 2

>     ===============================================================================

>     Choose Product Directory

>     ------------------------

>         1- Modify Current Selection (/cmhome/wls70/wljam5.1)
>         2- Use Current Selection (/cmhome/wls70/wljam5.1)
>     Enter a number: 2

>     ======================================================================

>     Installing...

>     -------------

>      [==================|==================|==================|======]

>      [------------------|------------------|------------------|------]

>     ======================================================================

>     Install Complete

>     ----------------

>     Congratulations!

>     You have successfully installed BEA WebLogic Java Adapter for Mainframe. To verify the success of your installation, refer to the WebLogic JAM Installation Guide at the BEA corporate Web site for instructions on running installation verification samples for IMS and CICS regions.

>     PRESS <ENTER> TO EXIT THE INSTALLER: