|
|
This section provides information and step-by-step instructions for installing BEA Tuxedo Mainframe Adapter for SNA software (hereafter referenced as TMA SNA.) After completing the tasks included in Preparing to Install Tuxedo Mainframe Adapter for SNA, install the TMA SNA components according to your configuration requirements as described in the following section.
| Notes: | Refer to the BEA Tuxedo Mainframe Adapter for SNA Release Notes if you are upgrading from a previous version of eLink Adapter for Mainframe, and for information about hardware and software requirements. For additional operational and administrative information on the CRM, refer to the BEA Tuxedo Mainframe Adapter for SNA CRM Administration Guide. |
| Note: | All references to ATMI files, functions, and documentation apply to Tuxedo files, functions, and documentation. |
Information topics are grouped by platform and by component (Gateway or CRM) if the component installations differ for particular platforms.
This section includes the following topics:
Before you install BEA Tuxedo Mainframe Adapter for SNA, you should install Tuxedo 9.0.or 9.1
A JDK is required by the InstallAnywhere installation product to install Tuxedo Mainframe Adapter for SNA. A JDK is installed with Tuxedo 9.0 and 9.1. Verify that the system PATH environment variable is set to the correct version of the JDK installed by Tuxedo 9.0 or 9.1.
This section explains how to install the CRM component on a z/OS Multiple Virtual Storage (MVS) platform.
| Note: | The installation process assumes the installer is familiar with Job Control Language (JCL) job operations and File Transfer Protocol (FTP) functions. |
The following list is a summary of the tasks detailed in Installation Procedure:
TMA91.xxx) to the allocated datasets.TSO RECEIVE command to unload the data in your product datasets. A third JCL file has been provided to run this procedure in batch.The installation for this environment is semi-automated. Three JCL files are provided to facilitate prerequisites for allocating datasets in the MVS environment and to unload Tuxedo Mainframe Adapter for SNA product software into the allocated datasets.
The product CD-ROM contains the following files relating to this installation procedure:
dsupload.jcl file is a JCL example for creating MVS datasets to receive the Tuxedo Mainframe Adapter for SNA software.install.jcl file is a JCL example creating the unloaded product datasets.uncmprss.jcl file is a JCL example to uncompress and unload into the product datasets.TMA91.LOAD file contains the Tuxedo Mainframe Adapter for SNA program objects. (Required)TMA91.DATA file contains Tuxedo Mainframe Adapter for SNA data files. (Required)TMA91.SAMPLE file contains sample JCL files.Perform the following steps to install the CRM component on a z/OS MVS platform:
/mvs/ftp-unix) or MVS NT directory (/mvs.ftp-nt).dsupload.jcl
install.jcl
uncmprss.jcl
DSUPLOAD job to suit your environment. This job allocates the initial datasets 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 according to the following syntax:
SET PRODHLQ=[QUALIFIER]
The DSUPLOAD job has the following steps:
DELOLD
Deletes any existing datasets previously created so you can run this JCL multiple times, if necessary.
CREATE
Allocates the initial datasets needed to receive the product software files.
DSUPLOAD job.
Note the following example of a put command:
put TMA91.LOAD ’BEA.TMA91.LOAD’
Transfer the datasets using the put command.
INSTALL job to suit your environment.
Use the SET statements to alter the job for your environment according to the following syntax:
SET BEAPDSE=[QUALIFIER]
In this statement, [QUALIFIER] is the high-level qualifier for the SNACRM Load Library. The load library containing the TMA91.LOAD program objects must be a Partitioned Dataset with Extended attributes (PDSE). The PDSE minimally must have storage class SMS declaration for z/OS.
SET SCLASS=[CLASS NAME]
In this statement, [CLASS NAME] is the storage class name of the PDSE. This is required for z/OS.
SET BEAPDS=[QUALIFIER]
In this statement, [QUALIFIER] is the high-level qualifier for the sample and data datasets. These are standard PDS.
The INSTALL job has the following steps:
DELOLD
Deletes any existing datasets created by the INSTALL job so you can run this JCL multiple times, if necessary.
CREATECreates the MVS datasets for you.
This step includes the minimal JCL needed to create the datasets for z/OS. You may change the JCL to reflect your own environment.
Use Table 3-2 as a worksheet to fill out the names of the datasets created in this step.
UNCMPRSS job to suit your environment.Modify the following variables in the JCL to the high-level qualifier you listed in the tables according to the following syntax:
<PRODHLQ>=[QUALIFIER]Use the qualifier you listed in Table 3-1.
<BEAPDSE>=[QUALIFIER]Use the PDSE qualifier you listed in Table 3-2.
<BEAPDS>=[QUALIFIER]Use the PDS qualifier you listed in Table 3-2.
The UNCMPRSS job has the following step:
UNLOLD
Performs a TSORECEIVE to uncompress and unload the data in your installation datasets created in step 8.
To manually perform the TSO RECEIVE command to unload the data in your installation datasets created in Step 8, enter a command similar to the following command:
TSO RECEIVE INDS(‘xxx’)
DA(‘yyy’)
In these statements, the following definitions apply:
In addition to HP-UX 11.23 installation as described in Installing Tuxedo Mainframe Adapter for SNA Components on HP-UX 11.23, the Tuxedo Mainframe Adapter for SNA Gateway may also be installed on AIX, HP-UX, Solaris 10, Linux, or Windows platforms.
| Note: | The CRM is not available on any of these platforms and can only be installed on HP-UX 11.23 non-mainframe UNIX. Refer to the BEA Tuxedo Mainframe Adapter for SNA Release Notes for more detailed information about platform support. |
AIX, HP-UX, Linux, and Solaris 10 installations may be performed in Console Mode, Silent Mode, or Graphics Mode, while Windows installations must be performed in Graphics Mode.
To install the Tuxedo Mainframe Adapter for SNA Gateway on non-mainframe UNIX in console mode, you run one of the following .bin programs as appropriate for your operating system:
Perform the following steps to install the Tuxedo Mainframe Adapter for SNA software in console mode:
$ su -
Password:
# mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt
unix directory on your CD-ROM device. For example,# cd /mnt/
# ls
tmasna91_32_aix_53_ppc.bin
tmasna91_32_hpux_1123_pa.bin
tmasna91_32_sol_9_sp.bin
tmasna91_32_SLES_9_x86.bin
tmasna91_32_win_2k3_x86.exe
mvs
# sh tmasna91_32_hpux_1123_pa.bin -i consolePreparing to install...
Preparing CONSOLE Mode Installation...
==============================================================================
BEA Tuxedo Mainframe Adapter SNA 9.1 (created with InstallAnywhere by Zero G)
------------------------------------------------------------------------------
==============================================================================
Introduction
------------
This installer will guide you through the installation of 'Tuxedo Mainframe
Adapter for SNA'. On each step, answer the questions provided. Type "quit" at
any time to exit the installer.
==============================================================================
License Agreement
-----------------
Please read before installing:
You acknowledge that your use of this software is subject to (i) the license
terms that you signed when you placed your most recent order with us; or,
if you haven't signed a license agreement with us, (ii) the shrinkwrap
license terms included in your most recent order with us for which we shipped
software media to you; or, if neither (i) or (ii) are applicable, then, (iii)
if you are downloading this software from edelivery.oracle.com, then the
Oracle Electronic Delivery Trial License Agreement (which you acknowledge
that you have read and understand) governs your use of the software. Note:
Programs downloaded for trial use or downloaded as replacement media may not
be used to update any unsupported programs.
DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N) (Y/N): y
==============================================================================
Choose BEA Home Directory
-------------------------
1- Create a New BEA Home
2- Use Existing BEA Home
Enter a number: 2
1- /bea/
2- /bea/Tuxedo 9.0
Existing BEA Home: 1
==============================================================================
Pre-Installation Summary
------------------------
Please Review the Following Before Continuing:
Product Name:
Tuxedo Mainframe Adapter for SNA
Install Folder:
/bea/tux91/tuxedo9.1
Java VM to be Used by Installed Product:
/bea/tux91/jre
Product Version
9.1
Disk Space Information (for Installation Target):
Required: 4,556,286 bytes
Available: 531,012,902,912 bytes
PRESS <ENTER> TO CONTINUE:
==============================================================================
Installing...
-------------
[==================|==================|==================|==================]
[------------------|------------------|------------------|------------------]
==============================================================================
Install Complete
----------------
Congratulations. 'Tuxedo Mainframe Adapter for SNA 9.1' has been successfully installed to:
/bea/tux91/tuxedo9.1
PRESS <ENTER> TO EXIT THE INSTALLER: ENTER
Perform the following steps to install the Tuxedo Mainframe Adapter for SNA Gateway on a Windows or UNIX platform in Graphics Mode:
Run. The Run dialog displays.tmasna91_32_win_2k3_x86.exe program.| Note: | All screen illustrations in this section are for Windows 2003. |
$ su -
Password:
> mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt
> cd /mnt/
# ls
tmasna91_32_aix_53_ppc.bin
tmasna91_32_hpux_1123_pa.bin
tmasna91_32_sol_9_sp.bin
tmasna91_32_SLES_9_x86.bin
tmasna91_32_win_2k3_x86.exe
mvs
/mnt/> sh tmasna91_32_aix_53_ppc.bin
The Introduction screen (similar to Figure 3-1) displays.
If you click the Do Not Accept option button, you will not be able to continue with the installation. You must either exit the installation or go back to the Introduction screen.
c:\bea). The BEA Home directory is the root directory in which you install all BEA products. This directory was set up when you installed Tuxedo.If you want to create a new BEA Home directory, follow these steps:
c:\bea, and your Tuxedo Mainframe Adapter for SNA software default installation directory will be the Tuxedo 9.1 Home directory.If you already have one or more BEA Home directories on your system, you can use one of those directories as follows:
From this message box, do one of the following:
From this message box, do one of the following:
The TMA SNA Gateway, the CRM, or both the Gateway and CRM may be installed on HP-UX 11.23.
To install the TMA SNA software on HP-UX 11.23 in console mode, you will run the tmasna91_32_hpux_1123_pa.bin program. If you choose the Full Installation set, this program installs both the Gateway and the CRM on HP-UX 11.23. You may also choose to install only the Gateway or only the CRM on HP-UX 11.23.
Perform the following steps to install the TMA SNA software in console mode on HP-UX 11.23:
$ su -
Password:
# mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt
unix directory on your CD-ROM device. For example,# cd /mnt/
# ls
tmasna91_32_aix_53_ppc.bin
tmasna91_32_hpux_1123_pa.bin
tmasna91_32_sol_9_sp.bin
tmasna91_32_SLES_9_x86.bin
tmasna91_32_win_2k3_x86.exe
mvs
# sh tmasna91_32_hpux_1123_pa.bin -i console
If you choose the Gateway Only or Full Install, the software will be installed in your tuxedo9.1 or tuxedo9.0 directory. If you choose to install the Distributed CRM, the software will be installed in the tmasna91 directory.
Preparing to install...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...
Launching installer...
Preparing CONSOLE Mode Installation...
===============================================================================
BEA Tuxedo Mainframe Adapter SNA (created with InstallAnywhere by Zero G)
-------------------------------------------------------------------------------
===============================================================================
Introduction
------------
InstallAnywhere will guide you through the installation of Tuxedo Mainframe Adapter for SNA 9.1.
It is strongly recommended that you quit all programs before continuing with this installation.
Respond to each prompt to proceed to the next step in the installation. If you want to change something on a previous step, type 'back'.
You may cancel this installation at any time by typing 'quit'.
PRESS <ENTER> TO CONTINUE:
==============================================================================
License Agreement
-----------------
Please read before installing:
You acknowledge that your use of this software is subject to (i) the license
terms that you signed when you placed your most recent order with us; or,
if you haven't signed a license agreement with us, (ii) the shrinkwrap
license terms included in your most recent order with us for which we shipped
software media to you; or, if neither (i) or (ii) are applicable, then, (iii)
if you are downloading this software from edelivery.oracle.com, then the
Oracle Electronic Delivery Trial License Agreement (which you acknowledge
that you have read and understand) governs your use of the software. Note:
Programs downloaded for trial use or downloaded as replacement media may not
be used to update any unsupported programs.
DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): y
==============================================================================
Choose Install Set
------------------
Please Choose the Install Set to be installed by this installer.
->1- Gateway Only
2- Distributed CRM
3- Full Install
ENTER THE NUMBER FOR THE INSTALL SET, OR <ENTER> TO ACCEPT THE DEFAULT: 3
==============================================================================
Choose BEA Home Directory
-------------------------
1- Create a New BEA Home
2- Use Existing BEA Home
Enter a number: 2
1- /bea
2- /bea/tuxedo9.1
Existing BEA Home: 1
-----------------------------------------------
A previous installation of Tuxedo Mainframe Adapter for SNA 9.1
has been detected at /bea/loads/tux91.
The following options are available:
1- Continue to install over /bea/loads/tux91
2- Cancel to select another BEA Home Directory
3- Exit the installation
Choose a number: 1
==============================================================================
Installing...
-------------
[==================|==================|==================|==================]
[------------------|------------------|------------------|------------------]
==============================================================================
Install Complete
----------------
Congratulations. 'Tuxedo Mainframe Adapter for SNA 9.1' has been successfully installed to:
/bea/tux91
PRESS <ENTER> TO EXIT THE INSTALLER: <ENTER>
Perform the following steps to install the TMA SNA software in graphics mode on HP-UX 11.23:
$ su -
Password:
> mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt
> cd /mnt/
# ls
tmasna91_32_aix_53_ppc.bin
tmasna91_32_hpux_1123_pa.bin
tmasna91_32_sol_9_sp.bin
tmasna91_32_SLES_9_x86.bin
mvs
/mnt/> sh tmasna91_32_hpux_1123_pa.bin
The Introduction screen (see Figure 3-7) displays.
If you click the Do Not Accept option button, you will not be able to continue with the installation. You must either exit the installation or go back to the Introduction screen.
| Note: | If you choose the Gateway Only or Full Install, the software will be installed in your tuxedo9.1 or tuxedo9.0 directory. If you choose to install the Distributed CRM, the software will be installed in the tmasna91 directory. |
If you want to create a new BEA Home directory, follow these steps:
If you already have one or more BEA Home directories on your system, you can use one of those directories as follows:
From this message box, do one of the following:
From this message box, do one of the following:
|
