Skip Headers

Oracle Procedural Gateway® for APPC Installation and Configuration Guide
10g Release 1 (10.1) for Microsoft Windows
Part No. B13694-01
  Go To Index



List of Figures

Title and Copyright Information

Send Us Your Comments


Intended Audience
Documentation Accessibility
Related Documents
Accessing Installed Documentation
Oracle Services and Support

1 Introduction to Oracle Procedural Gateway for APPC

1.1 Overview of the Gateway
1.2 Features of the Gateway
1.3 Terms
1.4 Architecture of the Gateway
1.5 Implementation of the Gateway
1.6 Communication With the Gateway
1.7 Remote Procedural Call Functions
1.7.1 Description of RPC Functions Remote Transaction Initiation Data Exchange Remote Transaction Termination
1.8 Transaction Types for Gateway Using SNA
1.9 Transaction Types for Gateway Using TCP/IP

2 Release Information

2.1 Product Set
2.2 Changes and Enhancements, Release
2.2.1 Changes Bugs Fixed in Release
2.2.2 Enhancements TCP/IP Support for Connecting the Gateway to IMS Connect Release 1.2 Improved Gateway Log File
2.3 Known Restrictions
2.3.1 Known Restrictions for the Gateway
2.3.2 Known Restrictions for PGAU

3 System Requirements

3.1 Hardware Requirements
3.1.1 Processor Requirements
3.1.2 Memory Requirements
3.1.3 CD-ROM Drive
3.1.4 Disk Space Requirements
3.2 Software Requirements
3.2.1 Operating System Requirements
3.2.2 Communication Protocol Requirements
3.2.3 Oracle Server Requirements
3.2.4 Oracle Networking Product Requirements
3.2.5 IBM Mainframe Requirements
3.3 Documentation Requirements

4 Installing the Gateway

4.1 Before You Begin
4.2 Planning to Upgrade or Migrate the Gateway
4.2.1 Performing Pre-Upgrade Procedures
4.2.2 Upgrade and Migration Considerations
4.2.3 Restoration
4.3 Performing Pre-Installation Procedures
4.3.1 Gateway Installation Methods
4.4 Installing the Gateway Software
4.5 Installation Steps
4.5.1 Step 1: Logon to Windows System
4.5.2 Step 2: Ensure Appropriate Amount of Disk Space
4.5.3 Step 3: Stop All Oracle Services
4.5.4 Step 4: Insert the Gateway Product CD-ROM into Your CD-ROM Drive
4.5.5 Step 5: Start the Oracle Universal Installer
4.5.6 Step 6: Step Through the Oracle Universal Installer Oracle Universal Installer on Windows Platforms
4.6 Deinstalling Your Oracle Procedural Gateway for APPC

5 Configuring Your Oracle Network

5.1 Configuring the Oracle Network for the Gateway

6 Configuring the SNA Communication Package on Windows

6.1 Using SNA Security Validation
6.2 Processing Inbound Connections
6.3 Configuring Your Microsoft Host Integration Server
6.3.1 Independent Versus Dependent LUs
6.3.2 Location of Sample SNA Server Definitions
6.3.3 SNA Server Definition Types
6.3.4 Methods of Creating SNA Server Definitions for the Gateway
6.4 Creating SNA Server Definitions on Microsoft Host Integration Server
6.4.1 Server Selection
6.4.2 Link Service Definition
6.4.3 Connection Definition
6.4.4 Local LU Definition
6.4.5 Mode Definition
6.4.6 Remote LU Definition
6.5 Configuring an IBM Communications Server
6.5.1 Independent Versus Dependent LUs
6.5.2 Definition Types
6.6 Creating IBM Communications Server Definitions for the Gateway
6.6.1 Creating the Configuration
6.6.2 Creating the Node
6.6.3 Creating Devices
6.6.4 Choosing the Device Type
6.6.5 Configuring a LAN Device
6.6.6 Creating Peer Connections
6.6.7 Defining the Link Station
6.6.8 Defining the Adjacent Node
6.6.9 Creating Local LUs
6.6.10 Defining Local LUs
6.6.11 Creating Partner LUs
6.6.12 Defining Partner LUs
6.6.13 Creating the CPI-C Side Information Profile
6.7 Testing the Connection
6.8 Resume Configuration of the Gateway

7 Configuring the TCP/IP Communications Package for IMS Connect

7.1 Configuring TCP/IP for IMS Connect on Windows Platforms

8 Configuring the OLTP

8.1 Configuring the OLTP for Your SNA Environment
8.2 Configuring the OLTP for Your TCP/IP Environment

9 Gateway Configuration Using SNA Communication Protocol

9.1 Before You Begin
9.2 Preparing to Configure a Gateway Installation/Upgrade
9.3 Integrating Server Configuration: First-Time Gateway Installations
9.4 Upgrading or Migrating the Oracle Server from Previous Gateways
9.4.1 If You Must Reinstall Package Specifications
9.4.2 Upgrading PGAU From Previous Gateway Releases
9.5 Configuring the Oracle Integrating Server for Gateways to Coexist
9.6 Optional Configuration Steps to Permit Multiple Users
9.7 Configuring the Gateway
9.8 Configuring Commit-Confirm
9.8.1 Configuring the Oracle Integrating Server for Commit-Confirm
9.8.2 Configuring Gateway Initialization Parameters for Commit-Confirm
9.8.3 Configuring the OLTP for Commit-Confirm
9.9 Verifying the Gateway Installation and OLTP Configuration
9.9.1 Verifying the Gateway Installation
9.9.2 Verifying the OLTP Configuration CICS Verification IDMS-DC Verification IMS/TM Verification APPC/MVS Verification
9.9.3 Verifying OLTP Configuration for Commit-Confirm
9.10 Performing Post-installation Procedures
9.10.1 Installing Sample Applications

10 Gateway Configuration Using TCP/IP Communication Protocol

10.1 Before You Begin
10.2 Preparing to Configure a Gateway Installation
10.3 Configuring the Oracle Integrating Server
10.4 Optional Configuration Steps to Permit Multiple Users
10.5 Configuring TCP/IP for the Gateway
10.6 Configuring the Gateway
10.7 Loading the PGA_TCP_IMSC Table
10.8 Verifying the Gateway Installation and OLTP Configuration
10.8.1 Verifying the Gateway Installation
10.8.2 Verifying the OLTP Configuration IMS/TM Verification
10.9 Performing Post-installation Procedures
10.9.1 Installing Sample Applications

11 Security Requirements

11.1 Overview of Security Requirements
11.2 Authenticating Application Logons
11.3 Defining and Controlling Database Links
11.3.1 Link Accessibility
11.3.2 Links and CONNECT Clauses
11.4 Using SNA Security Validation
11.4.1 Specifying SNA Conversation Security SNA Security Option SECURITY=NONE
11.5 TCP/IP Security
11.5.1 Specifying TCP/IP Conversation Security TCP/IP Security Option SECURITY=NONE TCP/IP Security Option SECURITY=PROGRAM
11.6 Passwords in the Gateway Initialization File
11.6.1 Using the pg4pwd Utility

12 Migration From Existing Gateways

12.1 Migrating An Existing Gateway Instance to New Release Using SNA Protocol
12.1.1 Step 1: Install the New Release
12.1.2 Step 2: Transfer initsid.ora Gateway Initialization File Parameters
12.1.3 Backout Considerations When Migrating to New Releases
12.1.4 Oracle Net Considerations
12.1.5 Parameter Changes: Version 4 to Release of the Gateway
12.1.6 Parameter Changes: Version 8 or Earlier to Gateway Release
12.1.7 Migrating from Gateway Release 9.0.1 or 9.2.0 to Gateway Release
12.2 Migrating from an Existing Gateway Using SNA to TCP/IP
12.2.1 To Use Existing TIPs with Existing SideProfile Definitions
12.2.2 To Use Existing TIPs with LU/TP/LOGMODE Names

A Gateway Initialization Parameters for SNA Protocol

A.1 Gateway Initialization Parameter File Using SNA Protocol
A.1.1 PGA Parameters
A.1.2 PGA_CAPABILITY Parameter Considerations
A.1.3 PGA_CONFIRM Parameter Considerations
A.1.4 Sample listener.ora file for a Gateway using SNA
A.1.5 Sample tnsnames.ora file for a Gateway using SNA

B Gateway Initialization Parameters for TCP/IP Communication Protocol

B.1 Gateway Initialization Parameter File Using TCP/IP
B.1.1 PGA Parameters
B.2 Output for pg4tcpmap Tool
B.2.1 Sample listener.ora file for a Gateway using TCP/IP
B.2.2 Sample tnsnames.ora file for a Gateway using TCP/IP

C Gateway Terminology

C.1 Gateway Term Definitions

D Summary of Changes in Previous Versions

D.1 Changes and Enhancements in Previous Versions
D.1.1 Release
D.1.2 Release
D.1.3 Release
D.1.4 Release
D.1.5 Release
D.2 Corrected Problems in Previous Versions
D.2.1 Release
D.2.2 Release
D.2.3 Release
D.2.4 Release
D.3 Known Restrictions in Previous Releases
D.3.1 Release
D.3.2 Release and

E Configuration Worksheet