[Top] [Prev] [Next] [Bottom]

# Chapter 3. Installing BEA Connect SNA

## Pre-Installation Considerations

The normal Connect SNA environment generally consists of two properly configured components, a local environment and a remote environment.

### Local Environment

A local environment is a UNIX-based machine running Connect SNA 2.0. Connect SNA 2.0 is a fully bidirectional program, supporting the local system as either a client or server. This environment consists of the following components:

- Hardware, which is any workstation and network interface supported by the required software.

- Operating system software and SNA protocol stacks (PU servers). Refer to Table 1-1, "Supported Platforms," on page 1-3 for a complete listing.

- TUXEDO 6.4 software

### Local Environment (cont.)

The platform on which Connect SNA is installed must have BEA TUXEDO 6.4 already installed. Stack installation should also be completed and verified before installing Connect SNA.

You should shut down all Domain administrative and gateway servers within an application domain prior to installing this product, particularly the following:

- GWTDOMAIN

- GWADM

- DMADM

Do not run the following commands until the installation is complete:

- dmadmin

- dmloadcf

- dmunloadcf

### Remote Environment

A remote environment is an IBM mainframe that may or may not be on the same local network. As in the local environment, Connect SNA 2.0 is a fully bidirectional program, supporting the remote system as either a client or server. This environment consists of the following components:

- Hardware is any workstation and network interface supported by the required software.

- Software:

  MVS 5.22 9510 or higher, including OS/390 through 1.3
  VTAM 4.3 or higher
  CICS 3.3 or higher
  IMS/ESA DC 5.01 (optional)

- Support software for a mainframe (optional)

## Planning

Prior to installing BEA Connect SNA software, you must ensure the CICS/ESA remote domain is prepared to conduct operations with the TUXEDO local domain. This includes:

- Establishing the VTAM configuration

- Configuring the CICS/ESA Logical Unit (LU)

  - Creating connections

  - Defining sessions

- Completing cross-platform definitions

- Setting stack traces

Chapter 4, "Configuring BEA Connect SNA," gives more detailed information about these tasks.

Note: It is important to involve your mainframe system support personnel early in the process. In a large shop, separate individuals are likely to be responsible for MVS, VTAM, and CICS/ESA. Make sure everyone is involved.

## Installation

When installing or upgrading BEA Connect SNA, you must run the `install.sh` script and enter the needed information as it progresses through the install process. This script installs all of the necessary components required to run the software.

### Running install.sh

As you run the script, you will be asked for the following information:

- System on which to install BEA Connect SNA 2.0 (refer to Table 1-1, "Supported Platforms," on page 1-3):

- Version of BEA Connect SNA to install

- Directory where BEA TUXEDO is installed (Defaults to the current directory if it is not specified)

Listing 3-1 gives an example of running this script. The values in bold are supplied by the user during installation. To accept default values at a prompt, press Enter.

> Listing 3-1 `install.sh` Example

>     user@dalhpw1:/bea/loads/tmp/cmadm.dist4/sna20> sh ./install.sh

>     01) hp/hpux1020      02) ibm/aix421       03) sun5x/sol251
>     04) hp/hpux11        05) sun5x/sol26

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

>     ** You have chosen to install from hp/hpux1020 **

>     BEA Connect SNA Release 2.0  for
>      BEA TUXEDO System Release 6.4.

>     This directory contains BEA Connect SNA for
>     HPUX 10.20 on HP PA-RISC.
>     Please refer to the product documentation for release notes and
>     further information.

>     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     sna20           BEA Connect SNA Release 2.0

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

>     BEA Connect SNA
>     (9000) Release 2.0
>     Copyright (c) 1998 BEA Systems, Inc.
>     Portions * Copyright 1986-1998 RSA Data Security, Inc.
>     All Rights Reserved.
>     Distributed under license by BEA Systems, Inc.
>     TUXEDO is a registered trademark.

>     TUXEDO directory (TUXDIR) where files are to be installed [?,q]:
>     /bea/work/jdahl/tuxedo

>     Determining if sufficient space is available ...
>     48212 blocks are required
>     1592650 blocks are available to /bea/work/jdahl/tuxedo

>     Using /bea/work/jdahl/tuxedo as the SNA base directory

>     Unloading /bea/loads/tmp/cmadm.dist4/sna20/hp/hpux1020/sna/sna.Z ...
>     bin/DMINIT
>     bin/GWSNAX
>     bin/Xsnacrm
>     bin/CRMLOGS
>     bin/xsnacrm
>     bin/SNACRM
>     connect/sna/simpapp/BEACONN.RDO
>     connect/sna/simpapp/BEASNA.RDO
>     connect/sna/simpapp/DMCONFIG
>     connect/sna/simpapp/MIRRDTPC.c
>     connect/sna/simpapp/MIRRDTPC.cbl
>     connect/sna/simpapp/Makefile
>     connect/sna/simpapp/README
>     connect/sna/simpapp/TOUPDPLS.c
>     connect/sna/simpapp/TOUPDPLS.cbl
>     connect/sna/simpapp/TOUPDTPS.c
>     connect/sna/simpapp/TOUPDTPS.cbl
>     connect/sna/simpapp/UBBCONFIG
>     connect/sna/simpapp/aix.env
>     connect/sna/simpapp/app.env
>     connect/sna/simpapp/dminit.scr
>     connect/sna/simpapp/hpux.env
>     connect/sna/simpapp/mirrorsrv.c
>     connect/sna/simpapp/solaris.env
>     connect/sna/simpapp/toupclt.c
>     lib/libctxmess.a
>     lib/libctxdebugs.a
>     lib/libctxos.a
>     lib/libctxprim.a
>     lib/fmb.def
>     lib/libgws.a
>     lib/libcsxappc.a
>     lib/libcsxxfm.a
>     lib/libcsxxmw.a
>     lib/libcsxgpw.a
>     lib/libcsxcrm.a
>     lib/libcsxxcrm.a
>     lib/libcsxscrm.a
>     lib/libcsxhp51.a
>     lib/libctxmess.sl
>     lib/libctxdebugs.sl
>     lib/libctxos.sl
>     lib/libctxprim.sl
>     lib/libgws.sl
>     lib/libcsxappc.sl
>     lib/libcsxxfm.sl
>     lib/libcsxxmw.sl
>     lib/libcsxgpw.sl
>     lib/libcsxcrm.sl
>     lib/libcsxxcrm.sl
>     lib/libcsxscrm.sl
>     lib/libcsxhp51.sl
>     locale/C/LIBGWS_CAT
>     locale/C/LIBGWS.text
>     47580 blocks
>     ... finished

>     Changing file permissions...
>     ... finished

>     Installation of BEA Connect SNA was successful

>     The following packages are available:

>       1     sna20           BEA Connect SNA Release 2.0
>       2     snaDOC          BEA Connect SNA Documentation

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

>     Please don't forget to fill out and send in your registration card

### Installation Components

When you run the `install.sh` script, it installs all of the following BEA Connect SNA components.

#### Executables

This script installs the following BEA Connect SNA executables the`./bin` directory:

>     DMINIT
>     GWSNAX
>     Xsnacrm
>     CRMLOGS
>     xsnacrm
>     SNACRM

#### Application Files

This script installs the following BEA Connect SNA application files into the `./connect/sna/simpapp` directory:

>     BEACONN.RDO
>     BEASNA.RDO
>     DMCONFIG
>     MIRRDTPC.c
>     MIRRDTPC.cbl
>     Makefile
>     README
>     TOUPDPLS.c
>     TOUPDPLS.cbl
>     TOUPDTPS.c
>     TOUPDTPS.cbl
>     UBBCONFIG
>     aix.env
>     app.env
>     dminit.scr
>     hpux.env
>     mirrorsrv.c
>     solaris.env
>     toupclt.c

#### Libraries

This script installs the following BEA Connect SNA libraries into the `./lib` directory:

>     libctxmess.a
>     libctxdebugs.a
>     libctxos.a
>     libctxprim.a
>     fmb.def
>     libgws.a
>     libcsxappc.a
>     libcsxxfm.a
>     libcsxxmw.a
>     libcsxgpw.a
>     libcsxcrm.a
>     libcsxxcrm.a
>     libcsxscrm.a
>     libcsxhp51.a
>     libctxmess.sl
>     libctxdebugs.sl
>     libctxos.sl
>     libctxprim.sl
>     libgws.sl
>     libcsxappc.sl
>     libcsxxfm.sl
>     libcsxxmw.sl
>     libcsxgpw.sl
>     libcsxcrm.sl
>     libcsxxcrm.sl
>     libcsxscrm.sl
>     libcsxhp60.sl*

*Platform O/S and Stack version dependent. Other possible entries are: `libcsxbrx40.sl`, `libcsxsun91.sl`, `libcsxibm50.sl`, and `libcsxspx60.sl`.

#### Message Queues

This script installs the following BEA Connect SNA message queue files into the `./locale/C` directory:

>     LIBGWS_CAT
>     LIBGWS.text

### Post Installation Action

After installing Connect SNA 2.0, modify your existing DMTYPE file, located in the `$TUXDIR/udataobj` directory, to contain the following line:

>     SNAX:-lgw -lgws:-lgp -lgpnet -lcsxcrm::

[Top] [Prev] [Next] [Bottom]