Contents

List of Figures

Title and Copyright Information

Send Us Your Comments

Preface

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.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

1.7.1.1 Remote Transaction Initiation

1.7.1.2 Data Exchange

1.7.1.3 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 10.1.0.2.0

2.2.1.1 pg4hoa1.sh Bootstrap Shell Script No Longer Used When Migrating

2.2.1.2 SunLink Peer-to-Peer No Longer Supported on Solaris

2.2.1.3 AIX: IBM Comm. Server on AIX 5L Does Not Support SNA 32-bit Libraries

2.2.1.4 Bugs Fixed in Release 10.1.0.2.0

2.2.2 Enhancements

2.2.2.1 TCP/IP Support for Connecting PG4APPC to IMS Connect Release 1.2

2.2.2.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 Network Attachment Requirements

3.1.4 CD-ROM Drive

3.1.4.1 HP-UX Only

3.1.5 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: Login as DBA and Create Login User ID

4.5.2 Step 2: Create the Product Installation Directory

4.5.3 Step 3: Setting the Environment Variables

4.5.4 Step 5: Mount the CD-ROM

4.5.4.1 Mounting the CD-ROM for AIX-Based Systems

4.5.4.2 Mounting the CD-ROM for HP-UX

4.5.4.3 Mounting the CD-ROM for Solaris Operating System (SPARC 64-bit)

4.5.5 Step 6: Start the Oracle Universal Installer

4.5.5.1 For AIX Systems

4.5.5.2 For HP-UX

4.5.5.3 For Solaris

4.5.6 Step 7: Step through the Oracle Universal Installer

4.5.6.1 Oracle Universal Installer on UNIX 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 AIX-Based Systems

6.1 Processing Inbound Connections

6.2 Independent Versus Dependent LUs

6.3 Creating SNA Profiles for the Gateway

6.4 Profile Types

6.5 SNA Server Profiles

6.5.1 SNA Node Profile

6.5.2 Link Station Profile

6.5.3 Mode Profile

6.5.4 Local LU Profile

6.5.5 Partner LU Profile

6.5.6 Partner LU Location Profile

6.5.7 Side Information Profile

6.6 Activating Profiles

6.7 Resume Configuration of the Gateway

7 Configuring the SNA Communication Package on HP-UX

7.1 Processing Inbound Connections

7.1.1 Steps for Configuring the Communications Interfaces

7.2 The SNAPlus2 Configuration Tool

7.3 Creating SNAPlus2 Profiles for the Gateway

7.4 Independent Versus Dependent LUs

7.4.1 Sym Dest Name

7.5 Creating SNA Definitions for the Gateway

7.6 Sample SNAPlus2 Definitions

7.7 Configuring SNAPlus2

7.8 Testing the Connection

7.9 Resume Configuration of the Gateway

8 Configuring the SNA Communication Package on Solaris

8.1 Processing Inbound Connections

8.2 Configuring SNAP-IX Version 6

8.2.1 Before You Begin

8.2.2 SNAP-IX Configuration Tool

8.2.3 Creating SNAP-IX Profiles for the Gateway

8.2.4 Independent Versus Dependent LUs

8.2.5 Creating SNA Definitions for the Gateway

8.2.6 Sample SNAP-IX Definitions

8.2.7 Configuring SNAP-IX

8.2.8 Invoking xsnaadmin

8.2.8.1 Configuring the SNA node

8.2.8.2 Adding a Port

8.2.8.3 Create a Link Station

8.2.8.4 Create Local LUs

8.2.8.5 Create Partner LUs

8.2.8.6 Create Mode and CPI-C Profiles

8.2.9 Testing the Connection

8.3 Resume Configuration of the Gateway

9 Configuring the TCP/IP Communications Package for IMS Connect

9.1 Configuring TCP/IP for IMS Connect on UNIX Platforms

10 Configuring the OLTP

10.1 Configuring the OLTP for Your SNA Environment

10.2 Configuring the OLTP for Your TCP/IP Environment

11 Gateway Configuration Using SNA Communication Protocol

11.1 Before You Begin

11.2 Preparing to Configure a Gateway Installation/Upgrade

11.3 Integrating Server Configuration: First-Time Gateway Installations

11.4 Upgrading or Migrating the Oracle Server from Previous Gateways

11.4.1 If You Must Reinstall Package Specifications

11.4.2 Upgrading PGAU From Previous Gateway Releases

11.5 Configuring the Oracle Integrating Server for Gateways to Coexist

11.6 Optional Configuration Steps to Permit Multiple Users

11.7 Configuring the Gateway

11.8 Configuring Commit-Confirm

11.8.1 Configuring the Oracle Integrating Server for Commit-Confirm

11.8.2 Configuring Gateway Initialization Parameters for Commit-Confirm

11.8.3 Configuring the OLTP for Commit-Confirm

11.9 Verifying the Gateway Installation and OLTP Configuration

11.9.1 Verifying the Gateway Installation

11.9.2 Verifying the OLTP Configuration

11.9.2.1 CICS Verification

11.9.2.2 IDMS-DC Verification

11.9.2.3 IMS/TM Verification

11.9.2.4 APPC/MVS Verification

11.9.3 Verifying OLTP Configuration for Commit-Confirm

11.10 Performing Postinstallation Procedures

11.10.1 Installing Sample Applications

12 Gateway Configuration Using TCP/IP Communication Protocol

12.1 Before You Begin

12.2 Preparing to Configure a Gateway Installation

12.3 Configuring the Oracle Integrating Server

12.4 Optional Configuration Steps to Permit Multiple Users

12.5 Configuring TCP/IP for the Gateway

12.6 Configuring the Gateway

12.7 Loading the PGA_TCP_IMSC Table

12.8 Verifying the Gateway Installation and OLTP Configuration

12.8.1 Verifying the Gateway Installation

12.8.2 Verifying the OLTP Configuration

12.8.2.1 IMS/TM Verification

12.9 Performing Post-installation Procedures

12.9.1 Installing Sample Applications

13 Security Requirements

13.1 Overview of Security Requirements

13.2 Authenticating Application Logons

13.3 Defining and Controlling Database Links

13.3.1 Link Accessibility

13.3.2 Links and CONNECT Clauses

13.4 Using SNA Security Validation

13.4.1 Specifying SNA Conversation Security

13.4.1.1 SNA Security Option SECURITY=NONE

13.4.1.2 SNA Security Option SECURITY=PROGRAM

13.4.1.3 SNA Security Option SECURITY=SAME

13.5 TCP/IP Security

13.5.1 Specifying TCP/IP Conversation Security

13.5.1.1 TCP/IP Security Option SECURITY=NONE

13.5.1.2 TPC/IP Security Option SECURITY=PROGRAM

13.6 Passwords in the Gateway Initialization File

13.6.1 Using the pg4pwd Utility

14 Migration From Existing Gateways

14.1 Migrating An Existing Gateway Instance to New Release Using SNA Protocol

14.1.1 Step 1: Install the New Release

14.1.2 Step 2: Transfer initsid.ora Gateway Initialization File Parameters

14.1.3 Backout Considerations When Migrating to New Releases

14.1.4 Oracle Net Considerations

14.1.5 Parameter Changes: Version 4 to Release 10.1.0.2.0 of the Gateway

14.1.6 Parameter Changes: Version 8 or Earlier to Gateway Release 10.1.0.2.0

14.1.7 Migrating from Gateway Release 9.0.1 or 9.2.0 to Gateway Release 10.1.0.2.0

14.2 Migrating from an Existing Gateway Using SNA to TCP/IP

14.2.1 To Use Existing TIPs with Existing SideProfile Definitions

14.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 9.2.0.1.0

D.1.2 Release 9.0.1.0.1

D.1.3 Release 8.0.6.1.0 and 8.0.4.1.0

D.1.4 Release 4.0.1.1.0

D.2 Corrected Problems in Previous Versions

D.2.1 Release 9.2.0.1.0

D.2.2 Release 9.0.1.0.1

D.2.3 Release 8.0.6.1.0 and 8.0.4.1.0

D.2.4 Release 4.0.1.1.0

D.3 Known Restrictions in Previous Releases

D.3.1 Release 9.2.0.1.0

D.3.2 Release 8.0.6.1.0 and 4.0.1.1.0

E Configuration Worksheet

Index