Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Related Documents

Conventions

Documentation Accessibility

Accessibility of Code Examples in Documentation

1 Release Information

Product Set

Changes and Enhancements, Release 9.0.1.0.1

Enhancements

Changes

BUGS Fixed in Release 9.0.1.0.1:

Known Restrictions

Known Problems

2 Introduction to Oracle Procedural Gateway® for APPC

Overview

Features

Terms

Architecture

Implementation

Starting the Gateway

Communication

Remote Procedural Call Functions

Remote Transaction Initiation

Data Exchange

Remote Transaction Termination

Transaction Types

3 System Requirements

Hardware Requirements

Processor

Memory

Network Attachment

CD-ROM Drive

Disk Space

Software Requirements

Operating System

Communications

Oracle Integrating Server

File Transfer

OLTP

CICS/MVS and CICS/ESA

CICS/VSE

IDMS-DC

IMS/TM

APPC/MVS

Oracle Networking Products

Documentation Requirements

4 Installing and Configuring the Gateway

Before You Begin

Planning to Upgrade the Gateway

Upgrade Considerations

Restoration

Performing Pre-Upgrade Procedures

Performing Pre-Installation Procedures

Installing the Gateway Software

Installation Steps

Step 1: Login as DBA and create login user ID

Login as the Oracle database administrator (DBA) user

Step 2: Create the product installation directory

Step 3: Set the ORACLE_HOME environmental variable

Step 4: Verify the ORACLE_TERM environmental variable

Step 5: Mount the CD-ROM

Step 6: Start the Oracle Universal Installer

Step 7: Step through the Oracle Universal Installer

Configuring the Oracle Procedural Gateway for APPC

Pre-Configuration Steps

Oracle Server Coexistent with Gateway Installation/Upgrade

Stand-alone Gateway Installation/Upgrade

Configuring the Oracle Integrating Server for First-Time Installations

Upgrading the Oracle Integrating Server from Previous Releases

First-Time Installation and Upgrade Configuration Steps

Optional Configuration Steps to Permit Multiple Users

Sun Solaris Configuration

Configuring SNA

Configuring the Gateway

Configuring Your Network

Configuring Commit-Confirm

Configuring the OLTP

Configuring CICS/ESA

Configuring IDMS-DC MVS

Configuring IMS/TM

Configuring APPC/MVS

Verifying the Installation

Verifying the Gateway Installation

Verifying the OLTP Configuration

CICS Verification

IDMS-DC Verification

IMS/TM Verification

APPC/MVS Verification

Performing Post-Installation Procedures

Installing Sample Applications

Accessing the Gateway from Other Oracle Servers

Accessing Other OLTPs from the Oracle Integrating Server

De-installing Your Oracle Procedural Gateway for APPC

5 Security Requirements

Overview of Security Requirements

Authenticating Application Logons

Defining and Controlling Database Links

Link Accessibility

Links and CONNECT Clauses

Using SNA Security Validation

Specifying SNA Conversation Security

SNA Security Option SECURITY=NONE

SNA Security Option SECURITY=PROGRAM

SNA Security Option SECURITY=SAME

Processing Inbound Connections

6 SNA Configuration

Overview of the Configuration Process

Independent Versus Dependent LUs

Configuring SunLink SNA Peer-to-Peer Version 9.0

Setting up a SunLink P2P LU6.2 Server Name

Setting up a Configuration File

CP Directive

TRLINE or SDLCLINE Directives

DLC Directive

LU Directive

PTNR_LU Directive

MODE Directive

Side Information Files

Starting the SunLink SNA PU2.1 Server

Test the Connection

7 Migration and Coexistence with Existing Gateways

Migrating An Existing Gateway Instance to New Release

Step 1: Install the new Release

Step 2: Transferring initsid.ora gateway initialization file parameters

Backout Considerations When Migrating to New Releases

New and Changed Parameters When Migrating from Version 4 to Release 9i of the Gateways

New Parameter Added When Migrating from Version 8 or Earlier to Oracle 9i Gateway

A Gateway Initialization Parameters

Gateway Initialization Parameter File

PGA Parameters

PGA_CAPABILITY Parameter Considerations

PGA_CONFIRM Parameter Considerations

Sample pg4hoa1.sh File

Sample initPGA.ora File

B Sun Solaris - Specific Gateway Messages

Oracle Procedural Gateway for APPC Server Messages

C Summary of Changes in Previous Versions

Changes and Enhancements in Previous Versions

Release 8.0.4.1.0

Release 4.0.1.1.0

Release 4.0.0.1.0

Release 3.4.0.1.0

Release 3.3.1.0.2

Corrected Problems in Previous Versions

Release 8.0.4.1.0

Release 4.0.1.1.0

Release 4.0.0.1.0

Release 3.4.0.1.0

Release 3.3.1.0.2

Known Problems in Previous Versions

Release 8.0.4.1.0

Release 4.0.1.1.0

Index