This script opens a new, small, floating window and puts TOC<name>.html and IX<name>.html files in it and sets a generic popup window code to enable the display of some viewlets in the WebLogic Platform Tour.
Skip navigation.

Tuxedo Mainframe Adapter for SNA 8.1 Documentation > Installation Guide > Installing the Tuxedo Mainframe Adapter for SNA Software

Installation Guide

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents Index View as PDF  
Get
Adobe Reader

Installing the Tuxedo Mainframe Adapter for SNA Software

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.

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:

 

Prerequisites for Installation

Before you install BEA Tuxedo Mainframe Adapter for SNA, you should install Tuxedo 8.1.

A JDK is required by the InstallAnywhere installation product to install Tuxedo Mainframe Adapter for SNA. A JDK is installed with Tuxedo 8.1. Verify that the system PATH environment variable is set to the correct version of the JDK. If the JDK version displayed is lower than the required version, you will need to configure your PATH environment variable to use the required JDK that is installed with Tuxedo 8.1.

Warning: If you are installing BEA Tuxedo Mainframe Adapter for SNA on AIX, rename the jre130 directory to jre. The jre130 directory was installed in your BEA Home directory at the same level as Tuxedo 8.1.

 

Installing the CRM on z/OS or OS/390 MVS Platform

This section explains how to install the CRM component on a z/OS or OS/390 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.

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. 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:

Installation Procedure

Perform the following steps to install the CRM component on a z/OS or OS/390 MVS platform:

  1. Load the product CD-ROM on a machine that has File Transfer Protocol (FTP) access to the MVS UNIX directory (/mvs/ftp-unix) or MVS NT directory (/mvs.ftp-nt).
  2. Use FTP to put the following JCL files in the MVS destination PDS dataset:
    3. dsupload.jcl
    install.jcl
    uncmprss.jcl
  3. In your MVS environment, change the DSUPLOAD job to suit your environment. This job allocates the initial datasets needed to receive the product software files from the FTP file transfer.

    4. 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.

  4. Run the DSUPLOAD job.
  5. Put the files listed in Table 2-1 into their corresponding datasets. 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 z/OS or OS/390 platform.


    6.  

    Table 2-1 MVS Installation Product Files and DD Name Datasets

    Product File

    Set Statement

    Your Dataset Name

    TMA81.LOAD

    PRODHLQ

    .LOAD

    TMA81.DATA

    PRODHLQ

    .DATA

    TMA81.SAMPLE

    PRODHLQ

    .SAMPLE


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

    7. Note the following example of a put command:

    put TMA81.LOAD 'BEA.TMA81.LOAD'

    Transfer the datasets using the put command.

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

    8. 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 TMA81.LOAD program objects must be a Partitioned Dataset with Extended attributes (PDSE). The PDSE minimally must have storage class SMS declaration for z/OS or OS/390.

    SET SCLASS=[CLASS NAME]

    In this statement, [CLASS NAME] is the storage class name of the PDSE. This is required for z/OS or OS/390.

    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. 

    CREATE

    Creates the MVS datasets for you.

    This step includes the minimal JCL needed to create the datasets for z/OS or OS/390. You may change the JCL to reflect your own environment.

  8. Run the INSTALL job.

    9. Use Table 2-2 as a worksheet to fill out the names of the datasets created in this step.


     

    Table 2-2 Set Statements and Corresponding Datasets

    Set Statement

    Your Dataset Name

    BEAPDSE

    .LOAD

    BEAPDS

    .DATA

    BEAPDS

    .SAMPLE


     
  9. In your MVS environment, change the UNCMPRSS job to suit your environment.

    10. 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 2-1.

    <BEAPDSE>=[QUALIFIER]

    Use the PDSE qualifier you listed in Table 2-2.

    <BEAPDS>=[QUALIFIER]

    Use the PDS qualifier you listed in Table 2-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')

When prompted, enter:

DA(`yyy')

In these statements, the following definitions apply:

xxx

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

yyy

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

 

Installing the Gateway on AIX, HP-UX, Solaris 8, or Windows

In addition to Solaris 8 installation as described in Installing Tuxedo Mainframe Adapter for SNA Components on Solaris 8, the Tuxedo Mainframe Adapter for SNA Gateway may also be installed on AIX, HP-UX, Solaris 8, or Windows platforms.

Note: The CRM is not available on any of these platforms and can only be installed on Solaris 8 non-mainframe UNIX. Refer to the BEA Tuxedo Mainframe Adapter for SNA Release Notes for more detailed information about platform support.

AIX, HP-UX, and Solaris 8 installations may be performed in Console Mode or Graphics Mode, while Windows installations must be performed in Graphics Mode.

Installing the Gateway in Console 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:

UNIX Platform

.bin File

AIX 5.2

tmasna81_Aix.bin

HP-UX 11

tmasna81_Hp.bin

Solaris 8

tmasna81_Sol8.bin


 

Perform the following steps to install the Tuxedo Mainframe Adapter for SNA software in console mode:

  1. Insert the Tuxedo Mainframe Adapter for SNA CD-ROM in your CD device.
  2. Log on as root.
    3. $ su -
    Password:
  3. Mount the CD-ROM. Mount commands vary depending on your system configuration. Refer to your System Administrator for the specific command for your system. Use a command similar to the following example to mount the CD-ROM.
    4. # mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt
  4. Change the directory to the unix directory on your CD-ROM device. For example,
    5. # cd /mnt/tmasna81
  5. List the CD-ROM contents.
    6. # ls
    tmasna81_Aix.bin
    tmasna81_Hp.bin
    tmasna81_Sol8.bin
    tmasna81_Win.exe
    mvs
  6. Execute the appropriate installation program for your operating system in character-based mode. For example, execute the HP-UX 11 program to install only the Tuxedo Mainframe Adapter for SNA Gateway:
    7. # sh tmasna81_Hp.bin -i console
  7. The installation program runs and prompts you for responses (see Listing 2-1 for an example).

Listing 2-1 UNIX Console Mode Installation Example, Gateway on HP-UX 11

Preparing to install...
Preparing CONSOLE Mode Installation...

===============================================================================
BEA Tuxedo Mainframe Adapter SNA 8.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:

BEA Tuxedo Mainframe Adapter for SNA(r) 8.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...
              .
              .
              .
User Count means the number of users specified on the uniform product code
label provided on the outside packaging of the Product.

Connection Management Software means...
              .
              .
              .
Copyright 2003, 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/
    2- /bea/Tuxedo 8.1
    
Existing BEA Home: 1

===============================================================================
Installing...
-------------

 [==================|==================|==================|==================]
 [------------------|------------------|------------------|------------------]

===============================================================================
License Selection Option
------------------------

    1- Copy License File Now
    2- Copy License File Later

Enter a number:  2

===============================================================================
Install License Later.
----------------------

You will need to manually append lic.txt (on license diskette) 
to your base product license file (in udataobj directory). 
Refer to your BEA Tuxedo Mainframe Adapter for SNA Installation 
Guide for details on how to do this. 

===============================================================================
Install Complete
----------------

Congratulations. 'Tuxedo Mainframe Adapter for SNA' has been successfully installed 
to:

   /bea/loads/tux81
PRESS <ENTER> TO EXIT THE INSTALLER: ENTER

Installing the Gateway in Graphics Mode

Perform the following steps to install the Tuxedo Mainframe Adapter for SNA Gateway on a Windows or UNIX platform in Graphics Mode:

  1. Insert the Tuxedo Mainframe Adapter for SNA CD-ROM in your CD device.
  2. Do one of the following, depending on your platform:

    3. On Windows:

    1. Choose Start—>Run. The Run dialog displays.
    2. Click Browse to navigate to the CD-ROM drive.
    3. Select the tmasna81 directory; then, select the tmasna81_Win.exe program.
    4. Click Open. The selected path and executable appear in the Run dialog.
    5. Click OK to begin the installation. The Introduction screen (Figure 2-1) displays.

      6. Note: All screen illustrations in this section are for Windows NT.

    On UNIX:

    1. Log on as root to install the Tuxedo Mainframe Adapter for SNA software.
      2. $ su -
      Password:
    2. Mount the CD-ROM. Mount commands vary depending on your system configuration. Refer to your System Administrator for the specific command for your system. Use a command similar to the following command to mount the CD-ROM on any UNIX system.
      3. > mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt
    3. Change the directory to the tmasna81 directory on your CD-ROM device. For example,
      4. > cd /mnt/tmasna81
    4. List the CD-ROM contents.
      5. # ls
      tmasna81_Aix.bin
      tmasna81_Hp.bin
      tmasna81_Sol8.bin
      mvs
    5. Execute the appropriate installation program for your operating system. For example, execute the AIX program:
      6. /mnt/tmasna81> sh tmasna81_Aix.bin

      The Introduction screen (similar to Figure 2-1) displays.

      Figure 2-1 Introduction Screen

      Introduction Screen


       
  3. Click Next to continue with the installation. The License Agreement screen displays (Figure 2-2).

    4. Figure 2-2 License Agreement Screen

    License Agreement Screen


     
  4. Select Yes to accept the license agreement; then click Next to proceed with the installation. The Choose BEA Home Directory screen displays (Figure 2-3).

    5. Figure 2-3 Choose BEA Home Directory Screen

    Choose BEA Home Directory Screen


     
  5. Select a New or Existing BEA Home option to specify the BEA Home directory (the default is 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.

    6. If you want to create a new BEA Home directory, follow these steps:

    1. Select the Create a New BEA Home option.
    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 c:\bea, and your Tuxedo Mainframe Adapter for SNA software default installation directory will be the Tuxedo 8.1 Home directory .
    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.
    2. Select a BEA Home directory from the list displayed to the right of the options. 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.
  6. If the installation program encounters a previous version of Tuxedo Mainframe Adapter for SNA in the selected BEA Home directory, the Previous Installation Found message box displays (Figure 2-4).

    7. Figure 2-4 Previous Installation Found Message Box

    Previous Installation Found Message Box


     

    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.
  7. If you do not have a successful installation of Tuxedo 8.1 in the BEA Home directory, the Tuxedo 8.1 Not Found! message box displays (Figure 2-5).

    8. Figure 2-5 Tuxedo 8 Not Found Message Box

    Tuxedo 8 Not Found Message Box


     

    From this message box, do one of the following:

    • Click Exit to exit the installation program so you can install Tuxedo 8.1.
    • Click Previous to return to the Choose BEA Home Directory Screen and select another directory.
  8. After the product is installed, the License Installation Choice screen displays (Figure 2-6).

    9. Figure 2-6 License Installation Choice Screen

    License Installation Choice Screen


     
  9. Select one of the following license installation options:
  1. Upon installation completion, the Install Complete screen displays (Figure 2-9).

    2. Figure 2-9 Install Complete Screen

    Install Complete Screen


     
  2. Click Done to exit the installation program.

 

Installing Tuxedo Mainframe Adapter for SNA Components on Solaris 8

The TMA SNA Gateway, the CRM, or both the Gateway and CRM may be installed on Solaris 8.

Installing the Software in Console Mode

To install the TMA SNA software on Solaris 8 in console mode, you will run the tmasna81_Sol8.bin program. If you choose the Full Installation set, this program installs both the Gateway and the CRM on Solaris 8. You may also choose to install only the Gateway or only the CRM on Solaris 8.


 

Perform the following steps to install the TMA SNA software in console mode on Solaris 8:

  1. Insert the TMA SNA CD-ROM in your CD device.
  2. Log on as root.
    3. $ su -
    Password:
  3. Mount the CD-ROM. Mount commands vary depending on your system configuration. Refer to your System Administrator for the specific command for your system. Use a command similar to the following command to mount the CD-ROM.
    4. # mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt
  4. Change the directory to the unix directory on your CD-ROM device. For example,
    5. # cd /mnt/tmasna81
  5. List the CD-ROM contents.
    6. # ls
    tmasna81_Aix.bin
    tmasna81_Hp.bin
    tmasna81_Sol8.bin
    tmasna81_Win.exe
    mvs
  6. Execute the Solaris 8 program to install both the TMA SNA Gateway and CRM on Solaris 8:
    7. # sh tmasna81_Sol8.bin -i console
  7. The installation program runs and prompts you for responses (see Listing 2-2 for an example). When you are asked to choose the Install Set, enter the number for the type of installation you want to perform:

    8. 1

    Gateway Only

    2

    Distributed CRM

    3

    Full Install


     

    If you choose the Gateway Only or Full Install, the software will be installed in your tuxedo8.1 directory. If you choose to install the Distributed CRM, the software will be installed in the tmasna81 directory.

    Note: If you select the Distributed CRM, you will not be prompted for the license location.

Listing 2-2 UNIX Console Mode Installation Example, Full Installation on Solaris 8

Preparing to install...
Preparing CONSOLE Mode Installation...

===============================================================================
BEA Tuxedo Mainframe Adapter SNA (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:

BEA Tuxedo Mainframe Adapter for SNA(r) 8.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...
              .
              .
              .
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: y

Connection Management Software means...
              .
              .
              .
Copyright 2003, BEA Systems, Inc.  All Rights Reserved.

DO YOU AGREE WITH THE TERMS OF THE LICENSE? (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/tuxedo8.1
    
Existing BEA Home: 1

-----------------------------------------------
A previous installation of Tuxedo Mainframe Adapter for SNA 8.1 
has been detected at /bea/loads/tux81.
 The following options are available:

    1- Continue to install over /bea/loads/tux81
    2- Cancel to select another BEA Home Directory
    3- Exit the installation

Choose a number: 1

===============================================================================
Installing...
-------------

 [==================|==================|==================|==================]
 [------------------|------------------|------------------|------------------]

===============================================================================
License Selection Option
-----------------------

    1- Copy License File Now
    2- Copy License File Later

Enter a number:2

===============================================================================
Install License Later.
----------------------

You will need to manually append lic.txt (on license diskette) 
to your base product license file (in udataobj directory). 
Refer to your BEA Tuxedo Mainframe Adapter for SNA Installation 
Guide for details on how to do this. 

===============================================================================
Install Complete
----------------

Congratulations. 'Tuxedo Mainframe Adapter for SNA' has been successfully installed 
to:

   /bea/tux81

PRESS <ENTER> TO EXIT THE INSTALLER: <ENTER>

Installing the Software in Graphics Mode

Perform the following steps to install the TMA SNA software in graphics mode on Solaris 8:

  1. Insert the TMA SNA CD-ROM in your CD device.
  2. Log on as root to install the TMA SNA software.
    3. $ su -
    Password:
  3. Mount the CD-ROM. Mount commands vary depending on your system configuration. Refer to your System Administrator for the specific command for your system. Use a command similar to the following command to mount the CD-ROM on any UNIX system.
    4. > mount -r -F cdfs /dev/cdrom/c1b0t0l0 /mnt
  4. Change the directory to the tmasna81 directory on your CD-ROM device. For example,
    5. > cd /mnt/tmasna81
  5. List the CD-ROM contents.
    6. # ls
    tmasna81_Aix.bin
    tmasna81_Hp.bin
    tmasna81_Sol8.bin
    mvs
  6. Execute the Solaris 8 program:
    7. /mnt/tmasna81> sh tmasna81_Sol8.bin

    The Introduction screen (see Figure 2-10) displays.

    Figure 2-10 Introduction Screen

    Introduction Screen


     
  7. Click Next to continue with the installation. The License Agreement screen displays (Figure 2-11).

    8. Figure 2-11 License Agreement Screen

    License Agreement Screen


     
  8. Select Yes to accept the license agreement; then click Next to proceed with the installation. The Choose Install Set screen displays (Figure 2-12).

    9. Figure 2-12 Choose Install Set Screen

    Choose Install Set Screen


     
  9. Select one of the Install Set options depending on whether you want to install the Gateway only, the CRM, or both on Solaris 8.

    10. Note: If you choose the Gateway Only or Full Install, the software will be installed in your tuxedo8.1 directory. If you choose to install the Distributed CRM, the software will be installed in the tmasna81 directory.

  10. Click Next to proceed with the installation. The Choose BEA Home Directory screen displays (Figure 2-13).

    11. Figure 2-13 Choose BEA Home Directory Screen

    Choose BEA Home Directory Screen


     
  11. Select a New or Existing BEA Home option to specify the BEA Home directory (the default is 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.

    12. If you want to create a new BEA Home directory, follow these steps:

    1. Select the Create a New BEA Home option.
    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 c:\bea, and your Tuxedo Mainframe Adapter for SNA software default installation directory will be the Tuxedo 8.1 Home directory.
    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.
    2. Select a BEA Home directory from the list displayed to the right of the options. 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.
  12. If the installation program encounters a previous version of Tuxedo Mainframe Adapter for SNA in the selected BEA Home directory, the Previous Installation Found message box displays (Figure 2-14).

    13. Figure 2-14 Previous Installation Found Message Box

    Previous Installation Found Message Box


     

    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.
  13. If you do not have a successful installation of Tuxedo 8.1 in the BEA Home directory, the Tuxedo 8.1 Not Found! message box displays (Figure 2-15).

    14. Figure 2-15 Tuxedo 8.1 Not Found Message Box

    Tuxedo 8.1 Not Found Message Box


     

    From this message box, do one of the following:

    • Click Exit to exit the installation program so you can install Tuxedo 8.
    • Click Previous to return to the Choose BEA Home Directory Screen and select another directory.
  14. After the product is installed, the License Installation Choice screen displays (Figure 2-16).

    15. Note: If you are installing the Distributed CRM, you will not be prompted for the License Installation Choice. Proceed to step 16.

    Figure 2-16 License Installation Choice Screen

    License Installation Choice Screen


     
  15. Select one of the following license installation options:
  1. Upon installation completion, the Install Complete screen displays (Figure 2-19).

    2. Figure 2-19 Install Complete Screen

    Install Complete Screen


     
  2. Click Done to exit the installation program.

 

Validating the Tuxedo Mainframe Adapter for SNA Software Installation

You can validate the Tuxedo Mainframe Adapter for SNA software installation in the following ways:

Verifying Installation Files and Directories

The Tuxedo Mainframe Adapter for SNA CD-ROM contains libraries and executable programs for each of the supported platforms as described in the tables in the following sections. After installing the Tuxedo Mainframe Adapter for SNA software, verify that these libraries and programs are installed on your system.

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

Tuxedo Mainframe Adapter for SNA Gateway Installation Files and Directories

The Tuxedo Mainframe Adapter for SNA Gateway includes the files listed in the following tables.

AIX 5.2

Verify that the following files are installed for the Tuxedo Mainframe Adapter for SNA Gateway Installation:

Table 2-3 AIX Installation Files and Directories for Tuxedo Mainframe Adapter for SNA Gateway Installation

Directory

Files

 
bin
 
GWSNAX
 
lib
 
libcsxcrm.so
libctxcp_12.so
libctxdebugs_12.so
libctxos_12.so
libctxplat_12.so
libctxprim_12.so
libgws.so
crmmon.jar
 
local/C
 
LIBGWS.text
LIBGWS_CAT
 
TMA/sna/simpapp
 
aix.env
app.env
BEACONN.RDO
BEASNA.RDO
BEASNA.RDO.VSE
DMCONFIG
dminit.scr
Makefile
MIRRDPLC.c
MIRRDPLC.c.VSE
MIRRDPLC.cbl
MIRRDTPC.c
MIRRDTPC.cbl
mirrorsrv.c
README
toupclt.c
TOUPDPLS.c
TOUPDPLS.c.VSE
TOUPDPLS.cbl
TOUPDTPS.c
TOUPDTPS.c.VSE
TOUPDTPS.cbl
TOUPDTPS.cbl.VSE
UBBCONFIG 
EXPIMSSV.c 
IMPIMSSV.cbl
simpims.c
BEAWTOR.asm
 
udataobj/codepage
 
00819x00037
00819x00273
00819x00278
00819x00284
00819x00285
00819x00297
00819x00500
00819x00860
00819x01047
00912x00870
none
tuxedo


 

HP-UX 11

Verify that the following files are installed for the Tuxedo Mainframe Adapter for SNA Gateway Installation:

Table 2-4 HP-UX Installation Files and Directories for Tuxedo Mainframe Adapter for SNA Gateway Installation

Directory

Files

 
bin
 
GWSNAX
 
lib
 
libcsxscrm.sl
libctxcp_12.sl
libctxdebugs_12.sl
libctxos_12.sl
libctxplat_12.sl
libctxprim_12.sl
libgws.sl
crmmon.jar
 
local/C
 
LIBGWS.text
LIBGWS_CAT
 
TMA/sna/simpapp
 
app.env
BEACONN.RDO
BEASNA.RDO
BEASNA.RDO.VSE
DMCONFIG
dminit.scr
hpux.env
Makefile
MIRRDPLC.c
MIRRDPLC.cbl
MIRRDPLC.c.VSE
MIRRDTPC.c
MIRRDTPC.cbl
mirrorsrv.c
README
toupclt.c
TOUPDPLS.c
TOUPDPLS.c.VSE
TOUPDPLS.cbl
TOUPDTPS.c
TOUPDTPS.c.VSE
TOUPDTPS.cbl
TOUPDTPS.cbl.VSE
UBBCONFIG 
EXPIMSSV.c 
IMPIMSSV.cbl
simpims.c
BEAWTOR.asm
 
udataobj/codepage
 
00819x00037
00819x00273
00819x00278
00819x00284
00819x00285
00819x00297
00819x00500
00819x00860
00819x01047
00912x00870
none
tuxedo


 

Solaris 8

Verify that the following files are installed for the Tuxedo Mainframe Adapter for SNA Gateway Installation:

Table 2-5 Solaris 8 Installation Files and Directories for Tuxedo Mainframe Adapter for SNA Gateway Installation

Directory

Files

 
bin
 
GWSNAX
 
lib
 
libcsxcrm.so
libctxcp_12.so
libctxdebugs_12.so
libctxos_12.so
libctxplat_12.so
libctxprim_12.so
libgws.so
crmmon.jar
 
local/C
 
LIBGWS.text
LIBGWS_CAT
 
TMA/sna/simpapp
 
app.env
BEACONN.RDO
BEASNA.RDO
BEASNA.RDO.VSE
DMCONFIG
dminit.scr
Makefile
MIRRDPLC.c
MIRRDPLC.c.VSE
MIRRDPLC.cbl
MIRRDTPC.c
MIRRDTPC.cbl
mirrorsrv.c
README
solaris.env
toupclt.c
TOUPDPLS.c
TOUPDPLS.c.VSE
TOUPDPLS.cbl
TOUPDTPS.c
TOUPDTPS.c.VSE
TOUPDTPS.cbl
TOUPDTPS.cbl.VSE
UBBCONFIG
EXPIMSSV.c 
IMPIMSSV.cbl
simpims.c
BEAWTOR.asm
 
udataobj/codepage
 
00819x00037
00819x00273
00819x00278
00819x00284
00819x00285
00819x00297
00819x00500
00819x00860
00819x01047
00912x00870
none
tuxedo


 

Windows 2000 Advanced Server

Verify that the following files are installed for the Tuxedo Mainframe Adapter for SNA Gateway Installation:

Table 2-6 Windows Installation Files and Directories for Tuxedo Mainframe Adapter for SNA Gateway Installation

Directory

Files

 
bin
 
csxcrm.dll
ctxcp_12.dll
ctxdebugs_12.dll
ctxos_12.dll
ctxplat_12.dll
ctxprim_12.dll
gws.dll
gwsnax.exe
 
lib

crmmon.jar

 
local/C
 
LIBGWS.text
LIBGWS_CAT
 
TMA/sna/simpapp
 
app.env
BEACONN.RDO
BEASNA.RDO
BEASNA.RDO.VSE
BEAWTOR.asm
DMCONFIG
dminit.scr
Makefile
MIRRDPLC.c
MIRRDPLC.c.VSE
MIRRDPLC.cbl
MIRRDTPC.c
MIRRDTPC.cbl
mirrorsrv.c
winenv.bat
README
simpims.c
toupclt.c
TOUPDPLS.c
TOUPDPLS.c.VSE
TOUPDPLS.cbl
TOUPDTPS.c
TOUPDTPS.c.VSE
TOUPDTPS.cbl
TOUPDTPS.cbl.VSE
UBBCONFIG 
EXPIMSSV.c 
IMPIMSSV.cbl
 
udataobj/codepage
 
00819x00037
00819x00273
00819x00278
00819x00284
00819x00285
00819x00297
00819x00500
00819x00860
00819x01047
00912x00870
none
tuxedo


 

CRM Installation Files and Directories

The CRM includes the files listed in the following tables.

Solaris 8

Verify that the following files are installed for the Tuxedo Mainframe Adapter for SNA CRM Installation:

Table 2-7 Solaris 8 Installation Files and Directories for CRM Installation

Directory

Files

 
bin
 
CRM
CRMLOGS
crmlkon
crmlkoff
crmdown
solaris.env
 
lib
 
libctxdebugs_12.so
libctxos_12.so
libctxprim_12.so
libctxplat_12.so
libcsxappc.so
libcsxxfm.so
libcsxgpw.so
libcsxcrm.so
libcsxscrm.so
libcsxspx70.so
libgpnet.so.71
libengine.so.71


 

z/OS V1R4 or OS/390 MVS V2R10

Verify that the following files are installed for the CRM Installation:

.

Table 2-8 z/OS or OS/390 MVS Installation Files and Directories for CRM Installation

Directory

Files

misc

README
dsupload.jcl
install.jcl
uncmprss.jcl

load library

 
CRM 
CRMLOGS
CRMLKON
CRMLKOFF
CRMDOWN
CSXAPPC
CSXXFM
CSXXMW
CSXGPW
CSXCRM
CSXXCRM
CSXSCRM
CSXVTM28
DEBUGS
LIBGP
LIBGPNBT
LIBGP40
OS
PRIM
PLAT

data library

ENV

sample library

 
CRMLOGS
CRMLKON
CRMLKOFF
CRMSTART
CRMDOWN


 


 

Solaris 8 Full Installation Files and Directories

Verify that the following files are installed for the Full Installation of the Tuxedo Mainframe Adapter for SNA Gateway and CRM on Solaris 8:

Table 2-9 Solaris 8 Full Installation Files and Directories

Directory

Files

 
bin
 
CRM
CRMLOGS
crmlkon
crmlkoff
crmdown
GWSNAX
solaris.env
 
lib
 
crmmon.jar
libcsxappc.so
libcsxcrm.so
libcsxgpw.so
libcsxscrm.so
libcsxspx70.so
libcsxxfm.so
libctxcp_12.so
libctxdebugs_12.so
libctxos_12.so
libctxplat_12.so
libctxprim_12.so
libgws.so
 
local/C
 
LIBGWS.text
LIBGWS_CAT
 
TMA/sna/simpapp
 
app.env
BEACONN.RDO
BEASNA.RDO
BEASNA.RDO.VSE
DMCONFIG
dminit.scr
Makefile
MIRRDPLC.c
MIRRDPLC.c.VSE
MIRRDPLC.cbl
MIRRDTPC.c
MIRRDTPC.cbl
mirrorsrv.c
README
solaris.env
toupclt.c
TOUPDPLS.c
TOUPDPLS.c.VSE
TOUPDPLS.cbl
TOUPDPS.c
TOUPDPS.c.VSE
TOUPDPS.cbl
TOUPDPS.cbl.VSE
UBBCONFIG
EXPIMSSV.c
IMPIMSSV.c
simpims.c
BEAWTOR.asm
 
udataobj/codepage
 
00819x00037
00819x00273
00819x00278
00819x00284
00819x00285
00819x00297
00819x00500
00819x00860
00819x01047
00912x00870
none
tuxedo


 

Running the Sample Applications

After you install Tuxedo Mainframe Adapter for SNA, you can verify your Tuxedo Mainframe Adapter for SNA installation by running the following sample applications:

Refer to the "Verifying the Software" section of the BEA Tuxedo Mainframe Adapter for SNA User Guide for more detailed information about verifying your software.

 

Uninstalling Tuxedo Mainframe Adapter for SNA

This section provides instructions for uninstalling Tuxedo Mainframe Adapter for SNA. The following topics are discussed:

Uninstalling on Non-mainframe UNIX Platforms in Console Mode

To remove Tuxedo Mainframe Adapter for SNA from a UNIX platform:

  1. Change directories to your uninstaller_TMASNA directory with a command similar to the following example:
    2. > cd /bea/tuxedo8.1/uninstaller_TMASNA
  2. Start the uninstallation program with the following command:
    3. /bea/tuxedo8.1/uninstaller_TMASNA> sh Uninstall -i console

    Listing 2-3 displays an Tuxedo Mainframe Adapter for SNA uninstallation.

    Note: The single-dash bar just beneath the double-dash bar in Listing 2-3 is a progress indicator. When the single-dash bar becomes the same length as the double-dash bar, uninstallation is complete.

Listing 2-3 UNIX Console Mode Uninstall Example

Preparing CONSOLE Uninstall...
===============================================================================
BEA Tuxedo Mainframe Adapter for SNA (InstallAnywhere Uninstaller by Zero G)
-------------------------------------------------------------------------------

About to uninstall...

   BEA Tuxedo Mainframe Adapter for SNA

This will completely remove all components installed by InstallAnywhere.  It 
will not remove files and folders created after the installation.

PRESS <ENTER> TO BEGIN THE UNINSTALL, OR 'QUIT' TO EXIT THE UNINSTALLER: <ENTER>

===============================================================================
Uninstall...
------------

 [==================|==================|==================|==================]
 [------------------|------------------|------------------|------------------]

===============================================================================
Uninstall Complete
------------------

All items were successfully uninstalled.

PRESS <ENTER> TO EXIT THE UNINSTALLER: <ENTER>

Uninstalling on Windows Platform

Perform the following steps to remove the Tuxedo Mainframe Adapter for SNA software from a Windows platform:

  1. Choose Start—>Programs—>BEA WebLogic E-Business Platform—>Tuxedo Mainframe Adapter for SNA 8.1—>Uninstall BEA Tuxedo Mainframe Adapter for SNA from the Start menu. The Tuxedo Mainframe Adapter for SNA Uninstaller screen displays (Figure 2-20).

    2. Figure 2-20 Tuxedo Mainframe Adapter for SNA Uninstaller Screen

    Tuxedo Mainframe Adapter for SNA Uninstaller Screen


     
  2. Click Uninstall to start removing Tuxedo Mainframe Adapter for SNA. When the process is complete, the screen shown in Figure 2-21 is displayed.

    3. Figure 2-21 Tuxedo Mainframe Adapter for SNA Uninstall Complete Screen

    Tuxedo Mainframe Adapter for SNA Uninstall Complete Screen


     
  3. Click Exit to complete the uninstallation.

Note: Some files may not be removed because they are required for another BEA product.

Uninstalling on z/OS or OS/390 Platforms

To remove the Tuxedo Mainframe Adapter for SNA product from your z/OS or OS/390 platform, consult with your system administrator. The process for removing applications from these platforms varies, depending on your particular system setup.

 

Manually Setting Up the License Key

You must enter the license key for Tuxedo Mainframe Adapter for SNA software to enable the connection capabilities for your system. As a prerequisite, Tuxedo 8.1 must be installed and operational with its license key file available. To enable the Tuxedo Mainframe Adapter for SNA license key, you must append the license key file provided with the product software to the Tuxedo license key file.

Warning: Do not alter any parameters within sections of the license key files. Doing so will invalidate the license and may disable your product software.

Perform the following steps to use the license key.

  1. With the text editor of your choice, open the BEA license key file in the udataobj/lic.txt sub-directory located in the Tuxedo platform directory. An example of this file follows:

Listing 2-4 Example of BEA License Key File

[TUXEDO 8.1]
LICENSEE=BEA Professional Services
SERIAL=1000000104
ORDERID=0
USERS=20
TYPE=SDK
WEBGUI=separate
WSCOMPRESSION=separate
EXPRIATION=2003-12-31
SIGNATURE=Xo201490OtaTEUb5L45UtAhUA12imvbiz92HladkaphonjQA/zeXXY=
  1. Append the Tuxedo Mainframe Adapter for SNA license key file, lic.txt to the Tuxedo license file.

Listing 2-5 Example of Tuxedo Mainframe Adapter for SNA License Key File Appended to BEA License Key File

# BEA License File
#
# This file contains license tokens to enable BEA Tuxedo and
# optional components.
# Each License begins with a "[section name]" and ends with
# a "SIGNATURE=" line.
#
# New license sections should be appended to this file, and the
# old section, if present, should be deleted.
#
# WARNING: Altering parameters withing a section will invalidate
# the license. This is a violation of BEA Systems licensing
# agreement, and may also disable Tuxedo or optional components.
# For Technical Support and to obtain a license, call 888-BEA-SUPT
# (888-232-7878) or 408-570-8070

[BEA TUXEDO]
VERSION=8.1
LICENSEE=BEA Internal Development User
SERIAL=177
ORDERID=Internal
USERS=400000
TYPE=SDK
DEVELOPERS=200000
EXPIRATION=2003-12-31
SIGNATURE=MC0CFA6ehW+FOQnKL45UtAhUAUAohqPyD/IB/mgPOe6AVr7YIvW8a0=
             .
             .
             .
# BEA Tuxedo Mainframe Adapter License File
#
# This file contains license tokens to enable a BEA Tuxedo Mainframe Adapter. 
# Each License begins with a "[section name]" and ends with
# a "SIGNATURE=" line.
#
# WARNING: Altering parameters withing a section will invalidate
# the license. This is a violation of BEA Systems licensing
# agreement, and may also disable TMA components.
#
# For Technical Support and to obtain a license, call 888-BEA-SUPT
# (888-232-7878) or 408-570-8070

[Tuxedo Mainframe Adapter]
LICENSEE=BEA SYSTEMS
VERSION=8.1
SERIAL=A101999739
ORDERID=Internal
EXPIRATION=2003-12-29
SIGNATURE=Xo201490OtaTEUb5L45UtAhUA12imvbiz92HladkaphonjQA/zeXXY=
  1. Save the file and exit the text editor. Your license key is now in effect.

 

Back to Top Previous Next