1 Introduction to Legacy Adapter Installation

This book describes how to install Oracle Connect, Oracle Application Server Legacy Adapters, and Oracle Studio.

This section includes the following topics:

Overview

Legacy adapters integrate Oracle Application Server with legacy and mainframe applications. These adapters include OracleAS Adapter for Tuxedo, OracleAS Adapter for CICS, OracleAS Adapter for VSAM, OracleAS Adapter for IMS/TM, and OracleAS Adapter for IMS/DB.

Table 1-1 describes the legacy adapters. These adapters are deployed as J2CA resource adapters within an Oracle WebLogic container during installation.

Table 1-1 Oracle Application Server Legacy Adapters

Adapter Description

OracleAS Adapter for Tuxedo

Models services running on the BEA Tuxedo application server. Captures and maintains a metadata schema for the Tuxedo system by importing Tuxedo metadata and transforming this metadata into mapping definitions for Oracle Connect.

OracleAS Adapter for CICS

Connects Oracle Application Server with CICS. This adapter supports two-phase commit and can fully participate in a distributed transaction.

OracleAS Adapter for VSAM

Enables access to VSAM data managed by CICS or directly. This adapter implements interactions as parameterized SQL with the parameters forming the input record, and with the output (in cases where there is an output) aggregated into an XML document forming the output record.

OracleAS Adapter for IMS/TM

Provides access to MPP based IMS/TM transactions. Each OracleAS Adapter for IMS/TM outbound interaction is mapped to a specific IMS/TM transaction.

OracleAS Adapter for IMS/DB

Captures and maintains a metadata schema for IMS/DB by importing various IMS definition files such as a PSB file, DBD files, and COBOL copybooks.


System Requirements

Before installing OracleAS Adapters for CICS, ensure that your computer meets the following requirements:

IBM z/OS Hardware and Software Requirements

This section describes the following requirements for installing Oracle Connect on an IBM z/OS platform:

Hardware Requirements

The following table summarizes the hardware requirements for Oracle Connect.

Table 1-2 Oracle Connect Hardware Requirements

Hardware Component Requirements

Processor

An IBM zSeries computer

Memory

The minimum requirement is 4 MB for each connection. A connection is defined as a connection to a server process or daemon. The actual memory requirement depends on such things as the size of the database and the number of databases accessed.

Disk Space (3380 and 3390 disks)

150 cylinders


Software Requirements

The following table summarizes the software requirements for Oracle Connect.

Table 1-3 Oracle Connect Software Requirements

Software Component Requirements

Operating System

IBM z/OS Version 1.8-1.10

CICS TP Monitor

V4R1 or higher (recommended to use CICS V6R1 or higher)

CICS EXCI support must be installed and IRCSTRT=YES must be specified in the CICS initialization parameters, so that the IRC (Inter Region Communication) starts.

You can also set the IRC to open by issuing the following command: CEMT SET IRC OPEN. In addition, the IBM group DFH$EXCI (or an equivalent user-defined group) must be installed in the CICS region using the CEDA RDO facility.

TCP/IP

The operating system must be able to use the TCP/IP protocol for using the Internet.

C Runtime Library

The C runtime library has all the standard C runtime programs.

Oracle Application Server

Oracle Application Server 11g (11.1.1.2).


UNIX Hardware and Software Requirements

This section describes the following requirements for installing Oracle Connect on a UNIX platform:

Hardware Requirements

The following table summarizes the hardware requirements for Oracle Connect on a UNIX platform.

Table 1-4 UNIX Hardware Requirements

Hardware Component Requirements

Processor

RedHat Linux

Linux Suse

HP-UX

IBM AIX

Solaris Operating System (SPARC)

Disk Space

70 MB free disk space


Software Requirements

The following table summarizes the software requirements for Oracle Connect.

Table 1-5 UNIX Software Requirements

Software Component Requirements

Operating System

RedHat Linux EL3.0 and 4.0 (32 and 64-bit)

Linux SUSE SLES 9 and 10 (32 and 64-bit)

HP-UX PA-RISC 64-bit (11.11, 11.23)

IBM AIX 5L (64-bit)

Sun Solaris SPARC 2.8 and 2.9 (32 and 64-bit)

Sun Solaris SPARC 2.10 (64-bit).

Oracle Application Server

Oracle Application Server 11g (11.1.1.2)


Windows Hardware and Software Requirements

This section describes the following requirements for installing Oracle Connect on Windows:

Hardware Requirements

The following table summarizes the hardware requirements for installing Oracle Connect on Windows.

Table 1-6 Oracle Connect Hardware Requirements for Windows

Hardware Component Requirements

Processor

An Intel or 100% compatible computer based on a Pentium processor.

Memory

256 MB RAM.

Disk Space

40 MB free disk space.


Software Requirements

The following table summarizes the software requirements when installaing Oracle Connect on Windows.

Table 1-7 Oracle Connect Software Requirements for Windows

Software Component Requirements

Operating System

Microsoft Windows 2000 with service pack 3 or higher (32-bit)

Microsoft Windows XP Professional service pack 2 (32-bit)

Microsoft Windows Server 2003 service pack 2 (32 and 64-bit).

Microsoft Windows Server 2008 (32 and 64-bit)

Microsoft

Network transport protocol software, TCP/IP, included with Microsoft Windows.


Oracle Studio Requirements

The following are the hardware requirements for Oracle Studio:

  • Processor: Intel or 100% compatible computer , based on a Pentium processor

  • Memory: 256 MB

  • Disk space: 120 MB of free disk space

You can install Oracle Studio on the following operating systems:

  • Windows 2000 with Service Pack 4 or higher

    Windows XP Professional with Service Pack 2 or higher

    Windows Server 2003 with Service Pack 2 or higher

    Windows Server 2008

    Windows Vista

  • The following Linux operating systems with GTK:

    • Red Hat Linux EL 4

    • Red Hat Linux 5.x

    • Oracle Enterprise Linux 4

    • Oracle Enterprise Linux 5.x

    • Linux SUSE 10

PS2 Patch Requirement

PS2 adapter users must install one or more patches from Oracle before working with Oracle Connect. You can download the patches from:

http://support.oracle.com.

For further assistance, contact Oracle support at:

http://www.oracle.com/support/contact.html.

SOA users download and install patch number 9654566.

OSB users download and install patch numbers 9654566 and 10065292.