Skip Headers

Table of Contents Image Oracle® Procedural Gateway for APPC Installation and Configuration Guide
Release 9.2.0.1.0 for UNIX

Part Number A96648-01
Go To Index
Index

Go to next page

Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience
Related Documents
Conventions
Documentation Accessibility

1 Release Information

Product Set
Changes and Enhancements Release 9.2.0.1.0
Changes
Oracle Call Interface
APPC Log File
Enhancements
Password Encryption Utility for Gateway Initialization File
AIX-Only: Password Encryption Utility for Resource Recovery Manager
Bugs Fixed in Version 9i
Known Restrictions

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
HP-UX Only
Disk Space
Software Requirements
Software Requirements for AIX-Based Systems
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
Step 2: Create the Product Installation Directory
Step 3: Set the ORACLE_HOME Environment Variable
Step 4: Set the DISPLAY Environment Variable
Step 5: Mount the CD-ROM
Mounting the CD-ROM for AIX-Based Systems
Mounting the CD-ROM for HP-UX
Mounting the CD-ROM for Solaris
Step 6: Start the Oracle Universal Installer
For AIX-Based Systems
For HP-UX
For Solaris
Step 7: Step through the Oracle Universal Installer
Oracle Universal Installer on AIX-Based Systems and HP-UX
Oracle Universal Installer on Solaris
Configuring Oracle Procedural Gateway for APPC
Preconfiguration 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 Configuration Steps
Optional Configuration Steps to Permit Multiple Users
Configuration
Configuring the SNA Communication Packages
Configuring the Gateway
Configuring Your Network
Configuring Commit-Confirm
AIX-Based Systems Only: Two-Phase Commit
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 Postinstallation 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
AIX-Based Systems Only: Using the pg4rrmpwd Utility

6 Configuring the SNA Communication Package on AIX-Based Systems

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
Independent Versus Dependent LUs
Creating SNA Profiles for the Gateway
Profile Types
SNA Server Profiles
SNA Node Profile
Link Station Profile
Mode Profile
Local LU Profile
Partner LU Profile
Partner LU Location Profile
Side Information Profile
Transaction Program Name Profile
Activating Profiles

7 Configuring the SNA Communication Package on HP-UX

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
Steps for Configuring the Communications Interfaces
The SNAplus2 Configuration Tool
Creating SNAplus2 Profiles for the Gateway
Independent Versus Dependent LUs
Sym Dest Name
Creating SNA definitions for the Gateway
Sample SNAplus2 Definitions
Configuring SNAplus2
Testing the Connection

8 Configuring the SNA Communication Package on Solaris

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
Configuring SunLink SNA Peer-to-Peer Version 9.0
Overview of the Configuration Process
Independent Versus Dependent LUs
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
Configuring SNAP-IX Version 6
Before You Begin
SNAP-IX Configuration Tool
Creating SNAP-IX Profiles for the Gateway
Independent Versus Dependent LUs
Creating SNA Definitions for the Gateway
Sample SNAP-IX Definitions
Configuring SNAP-IX
Invoking xsnaadmin
Configuring the SNA node
Adding a Port
Create a Link Station
Create Local LUs
Create Partner LUs
Create Mode and CPI-C Profiles
Testing the Connection

9 AIX-Based Systems Only: Implementing Two-Phase Commit

Introduction
Supported OLTPs (Online Transaction Processors)
Two-Phase Commit Architecture
Required Components
Roles of the Components of Two-Phase Commit
Interactions
Two-Phase Commit Flow
Gateway Server and RRM LU6.2 Log Tables
PreConfiguration Tasks
Choose a Dedicated Local LU
Set Up RRM Execution Group
Configuring Two-Phase Commit
Configuring the Oracle Logging Server
Configuring the Gateway Initialization Parameters
Configuring the RRM Initialization Parameters
Configuring the SNA Server
Configuring CICS/ESA
Post-Configuration Tasks
Set Up RRM Startup and Shutdown Procedures
Customizing the rrmstart script
RRM Recovery
RRM issued message PGA-21215
RRM issued message PGA-21218
Two-Phase Commit With CICS/ESA
Application Design Requirements
Manual Recovery of In-Doubt Transactions
Logging Two-Phase Commit Activity from CICS
PGALUWID Subroutine
Periodic Log Cleanup

10 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
Parameter Changes for Version 4 to Release 9i of the Gateways
Parameter Changes for Version 8 or Earlier to Oracle9.2.0 Gateway
Migrating from Oracle9.0.1 to Oracle9.2.0
Oracle Net Considerations

A Gateway Initialization Parameters

Gateway Initialization Parameter File
PGA Parameters
PGA Parameters on AIX
PGA Parameters on HP-UX and Solaris
PGA_CAPABILITY Parameter Considerations: AIX-Based Systems
PGA_CAPABILITY Parameter Considerations: HP-UX and Solaris
PGA_CONFIRM Parameter Considerations
Sample pg4hoa1.sh (Boot Parameter) File
AIX-Based Systems
HP-UX
Solaris
Sample initPGA.ora File
AIX-Based Systems Only: Sample rrmstart Script
AIX-Based Systems Only: Sample HQWM920.ini File

B Platform-Specific Gateway Messages

AIX-Based Systems Specific Messages
Oracle Procedural Gateway for APPC Server Messages
Oracle Procedural Gateway for APPC Resource Recovery Manager Messages
HP-UX Specific Messages
Oracle Procedural Gateway for APPC Server Messages
Solaris Specific Messages
Oracle Procedural Gateway for APPC Server Messages

C Summary of Changes in Previous Versions

Changes and Enhancements in Previous Versions
Release 9.0.1.0.1
Release 8.0.4.1.0/ 8.0.6.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.1
Corrected Problems in Previous Versions
Release 9.0.1.0.1
Release 8.0.6.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.1
Known Problems in Previous Releases
Release 8.0.6.1.0
Release 4.0.1.1.0

Index


Go to next page
Oracle
Copyright © 1996, 2002 Oracle Corporation.

All Rights Reserved.
Go To Index
Index