Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Product Name

Related Publications

Conventions

Documentation Accessibility

1 Release Information

Product Set

Changes and Enhancements in Release 9.2.0.1.0

Changes

Oracle Call Interface

APPC Log File

Enhancements

Password Encryption Utility for Gateway Initialization File

Bugs Fixed in Version 9i

Known Restrictions

Multi-byte Character Sets Are Not Supported for Numeric Data and Clauses

CICS Transactions Do Not Allow PF Key Emulation

APPC PIP Data is Not Supported

Floating Point Datatype Conversion is Not Supported

Transaction Programs and Data Compression and Decompression

PGAU USAGE(NULL) on DEFINE/REDEFINE DATA Not Implemented

2 Introduction to Oracle Procedural Gateway for APPC

Overview

Features

Terms

Architecture

Implementation

Starting the Gateway

Communication

Remote Procedure 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

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

Configuring the Oracle Procedural Gateway for APPC

Pre-Configuration Steps

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 Configuration Steps

Optional Configuration Steps to Permit Multiple Users

Windows 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

Deinstalling 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

Passwords in the Gateway Initialization File

Using the pg4pwd Utility

6 Configuring the SNA Communication Package on Windows

Using SNA Security Validation

Specifying SNA Conversation Security

SNA Security Option SECURITY=NONE

SNA Security Option SECURITY=PROGRAM

Processing Inbound Connections

Configuring MS SNA

Independent Versus Dependent LUs

Creating SNA Definitions for the Gateway

Sample SNA Server Definitions

Definition Types

SNA Server Definitions

Server Selection

Link Service Definition

Connection Definition

Local LU Definition

Mode Definition

Remote LU Definition

CPI-C Symbolic Destination Name

Configuring IBM Communication Server

Independent Versus Dependent LUs

Creating SNA Definitions for the Gateway

Definition Types

IBM Communication Server Definitions

Creating the Configuration

Creating the Node

Creating Devices

Choosing the Device Type

Configuring a LAN Device

Creating Peer Connections

Defining the Link Station

Defining the Adjacent Node

Creating Local LUs

Defining Local LUs

Create Partner LUs

Defining Partner LUs

Creating the CPI-C Side Information Profile

Testing 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 init sid.ora Gateway Initialization File Parameters

Backout Considerations When Migrating to New Releases

Parameter Changes for Version 4 to Release 9i Migration of Gateway

New Gateway Initialization Parameters

Renamed Gateway Initialization File Parameters

Obsolete Parameters

New Parameter Added When Migrating from Version 8 or Earlier to Oracle9i Gateway

Migrating from Version 9.0.1.1.1 to 9.2.0.1.0

Oracle Net Considerations

A Gateway Initialization Parameters

Gateway Initialization Parameter File

PGA Parameters

Sample Gateway Initialization File

PGA_CAPABILITY Parameter Considerations

PGA_CONFIRM Parameter Considerations

B Windows-Specific Gateway Messages

Oracle Procedural Gateway for APPC Server Messages

C Summary of Changes in Previous Versions

Changes and Enhancements in Previous Releases

Release 9.0.1.1.0

Oracle Server Dependencies

Oracle Home Directory

PG4APPC and PGAU

PGA_TRACE Parameter No Longer Supported

FDS_CLASS_VERSION Parameter Added

Release 4.0.1.1.0

Release 8.0.6.0.0

Changes

Enhancements

Corrected Problems in Previous Versions

Release 9.0.1.1.0

Release 8.0.6.0.0

Release 4.0.1.1.0

Known Problems in Previous Versions

Release 4.0.1.1.0 and 8.0.6.0.0

Index