---

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

---

---