Installing the Tuxedo Mainframe Adapter for SNA Software

This section provides information and step-by-step instructions for installing Oracle 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 Oracle 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 Oracle 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”

•	“Installing the CRM on z/OS MVS Platform”

•	“Installing the Gateway”

Prerequisites for Installation

Before you install Oracle Tuxedo Mainframe Adapter for SNA, you should install Tuxedo.

A JDK is required by the InstallAnywhere installation product to install Tuxedo Mainframe Adapter for SNA. A JDK is installed with Tuxedo. Verify that the system PATH environment variable is set to the correct version of the JDK installed by Tuxedo.

Installing the CRM on z/OS MVS Platform

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.

Summary of Installation Tasks

The following list is a summary of the tasks detailed in Installation Procedure:

•	Put the JCL files in the MVS environment prior to installation using the FTP program.

•	Allocate the initial datasets using one of the JCL jobs.

•	FTP the product software files (TMACRM.*) to the allocated datasets.

•	Run the second JCL job to allocate the final datasets.

•	Run the 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 installer contains the following files relating to this installation procedure:

•	README file contains notes on how to install the product in this environment. This is a summary of the procedure in this section.

•	createds.jcl file is a JCL example for creating MVS datasets to receive the Tuxedo Mainframe Adapter for SNA software.

•	uncmprss.jcl file is a JCL example to uncompress and unload into the product datasets.

•	TMACRM.LOAD file contains the Tuxedo Mainframe Adapter for SNA program objects. (Required)

•	TMACRM.DATA file contains Tuxedo Mainframe Adapter for SNA data files. (Required)

•	TMACRM.SAMPLE file contains sample JCL files.

Installation Procedure

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

1.	Load the product 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:

createds.jcl

uncmprss.jcl

In your MVS environment, change the CREATEDS job to suit your environment. This job allocates the initial datasets needed to receive the product software files from the FTP file transfer and the SNACRM Load Library, sample and data datasets.

Use the SET statements in the CREATEDS job to set the high-level qualifiers of the receiving datasets according to the following syntax:

SET TMPPDS=[QUALIFIER]

In this statement, [QUALIFIER] is the high-level qualifier for initial datasets need to receive the product software files.

SET HLQPDSE=[QUALIFIER]

In this statement, [QUALIFIER] is the high-level qualifier for the SNACRM Load Library. The load library containing the TMACRM.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 HLQPDS=[QUALIFIER]

In this statement, [QUALIFIER] is the high-level qualifier for the sample and data datasets. These are standard PDS.

The CREATEDS job has the following steps:

DELETE

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 and the SNACRM Load Library, sample and data datasets.

3.	Run the CREATEDS job.

4.	Put the files listed in Table 4‑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 platform.

 

Table 4‑1 MVS Installation Product Files and DD Name Datasets

Product File	Set Statement	Your Dataset Name
TMACRM.LOAD	TMPHLQ	.LOAD
TMACRM.DATA	TMPHLQ	.DATA
TMACRM.SAMPLE	TMPHLQ	.SAMPLE

Use Table 4‑2 as a worksheet to fill out the names of the datasets created for SNACRM Load Library, sample and data.

 

Table 4‑2 Set Statements and Corresponding Datasets

Set Statement	Your Dataset Name
HLQPDSE	.LOAD
HLQPDS	.DATA
HLQPDS	.SAMPLE

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

Note the following example of a put command:

put TMACRM.LOAD ’TMPHLQ.LOAD’

Transfer the datasets using the put command.

6.	In your MVS environment, change the 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 4‑1.

<BEAPDSE>=[QUALIFIER]

Use the PDSE qualifier you listed in Table 4‑2.

<BEAPDS>=[QUALIFIER]

Use the PDS qualifier you listed in Table 4‑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 4‑1.

yyy

Is the corresponding dataset name you listed in Table 4‑2.

Installing the Gateway

Unix installations may be performed in Console Mode, Silent Mode, or Graphics Mode, while Windows installations must be performed in Graphics Mode.

Installing the Gateway in Console Mode

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

1.	Log on as root.

$ su -
Password:

2.	Execute the appropriate installation program for your operating system in character-based mode. For example, execute the AIX program to install only the Tuxedo Mainframe Adapter for SNA Gateway:

# sh <installer>.bin -i console

3.	The installation program runs and prompts you for responses (see Listing 4‑1 for an example).

Listing 4‑1 UNIX Console Mode Installation Example, Gateway on AIX 53

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

==============================================================================
Oracle Tuxedo Mainframe Adapter SNA
------------------------------------------------------------------------------
==============================================================================
Introduction
------------

InstallAnywhere will guide you through the installation of Tuxedo Mainframe
Adapter for SNA.

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

==============================================================================
Choose BEA Home Directory
-------------------------

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

Enter a number: 2
1- /bea/
2- /bea/tuxedo

Existing BEA Home: 2

==============================================================================
Pre-Installation Summary
------------------------

Please Review the Following Before Continuing:

Product Name:
    Tuxedo Mainframe Adapter for SNA

Install Folder:
    /bea/tuxedo

Java VM to be Used by Installed Product:

    /bea/tuxedo/jre

Product Version
    xxx

Disk Space Information (for Installation Target):
    Required: 4,095,715 bytes
    Available: 531,012,902,912 bytes

PRESS <ENTER> TO CONTINUE: ENTER

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

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

Press <ENTER> to continue.:
==============================================================================
Install Complete
----------------

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

/bea/tux100
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.	Do one of the following, depending on your platform:

On Windows:

a.	Double click the installer program in File Explorer.

On UNIX:

a.	Log on as root to install the Tuxedo Mainframe Adapter for SNA software.

$ su -
Password:

b.	Execute the appropriate installation program for your operating system. For example, execute the AIX program:

/mnt/> sh <installer>.bin

The Introduction screen displays.

 

 

2.	Click Next to proceed with the installation. The Choose BEA Home Directory screen displays .

 

3.	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 Oracle products. This directory was set up when you installed Tuxedo.

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

a.	Select the Create a New BEA Home option.

b.	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 Home directory.

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

a.	Select the Use Existing BEA Home option.

b.	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 Oracle products have been installed using the standard installation program.

c.	Click Next to proceed with the installation.

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

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.

5.	If you do not have a successful installation of Tuxedo in the BEA Home directory, the Tuxedo Not Found! message box displays

From this message box, do one of the following:

•	Click Exit to exit the installation program so you can install Tuxedo.

•	Click Previous to return to the Choose BEA Home Directory Screen and select another directory.

6.	If you have a successful installation of Tuxedo, the pre-installaton Summary screen displays,

From this message box, do one of the following:

•	Click Next to begin installing

•	Click Previous to return to the Choose BEA Home Directory Screen and select another directory.

7.	Then Installing Tuxedo Mainframe Adapter message srceen displays

8.	After the product is installed, the Install Complete screen displays

9.	Click Done to exit the installation program.