Preface

Read this guide if you are responsible for tasks such as:

• determining hardware and software requirements

• installing, configuring or administering the Oracle Procedural Gateway for APPC

• developing applications

• determining security requirements

• determining and resolving problems

Before using this guide to administer the gateway, you should understand the fundamentals of the operating system for your platform and procedural gateways.

Intended Audience

This guide is intended for anyone responsible for administering the gateway, and also for developers writing applications that access remote host databases through the gateway.

Related Publications

The Oracle Procedural Gateway for APPC User's Guide is included as part of your product shipment. Also included is:

• Oracle Procedural Gateway for APPC Messages Guide

and, depending upon your platform:

• Oracle Procedural Gateway for APPC for HP9000 Series 700/800 Installation and Configuration Guide

• Oracle Procedural Gateway for APPC for Sun Solaris Installation and Configuration Guide

• Oracle Procedural Gateway for APPC for RS/6000 Installation and Configuration Guide

You might also need Oracle server and Oracle Net documentation. Below is a list of the Oracle9i publications that you will find referenced in this book:

• Oracle 9i Server Installation Guide

• Oracle 9i Server Administrator's Guide

• Oracle9i Server Application Developer's Guide

• Oracle9i Server Concepts

• Oracle9i Distributed Systems

• Oracle 9i Administrator's Guide

Refer to the Oracle Technical Publications Catalog and Price Guide for a complete list of documentation provided for Oracle products.

Conventions

Examples of input and output for the gateway and Oracle environment are shown in a special font:

$ mkdir /ORACLE/your_name 

All output is shown as it actually appears. For input, refer to the list of conventions and their meanings in the following table:

Convention	Meaning
example text	Words or phrases, such as mkdir and ORACLE, must be entered exactly as spelled and in the letter case shown. In this example, mkdir must be entered in lowercase letters and ORACLE in uppercase letters.
italic text	Italicized uppercase or lowercase, such as your_name, indicates that you must substitute a word or phrase, such as the actual directory name.
BOLD text or bold italic TEXT	Bold words or phrases refer to a file or directory structure, such as a directory, path, or file ID.
...	Ellipses indicate that the preceeding item can be repeated. You can enter an arbitrary number of similar items.
{ }	Curly braces indicate that one of the enclosed arguments is required. Do not enter the braces themselves.
|	Vertical lines separate choices.
[ ]	Square brackets enclose optional clauses from which you can choose one or none. Do not enter the brackets themselves.

Other punctuation, such as commas, quotation marks or the pipe symbol (|) must be entered as shown unless otherwise specified. Directory names, file IDs and so on appear in the required letter case in examples. The same convention is used when these names appear in text, and the names are highlighted in bold. The use of italics indicates that those portions of a file ID that appear in italics can vary.

Gateway commands, file IDs, reserved words and keywords appear in uppercase in examples and text. UNIX commands, environment variables, and keywords appear in the required letter case in examples and text. Reserved words and keywords must always be entered as shown; they have reserved meanings within the Oracle system.

SQL*Plus Prompts

The SQL*Plus prompt, SQL>, appears in SQL statement and SQL*Plus command examples. Enter your response at the prompt. Do not enter the text of the prompt, SQL>, in your response.

UNIX Prompts

The UNIX prompt, $, appears in UNIX command examples. Enter your response at the prompt. Do not enter the text of the prompt, $, in your response. A dollar sign, $, is also part of some UNIX directory names and should not be mistaken for a prompt character.

PGAU prompts

The PGAU prompt, PGAU>, appears in PGAU command examples. Enter your response at the prompt. Do not enter the text of the prompt, PGAU>, in your response.

Directory Names

Throughout this document, there are references to the directories in which product-related files reside. $ORACLE_HOME is used to represent the Oracle home directory. This is the default location for Oracle products. If you have installed into a location other than $ORACLE_HOME, replace all references to $ORACLE_HOME with the drive and path specification you have used.

Storage Measurements

Storage measurements use these abbreviations:

• K, for kilobyte which equals 1024 bytes

• M, for megabyte which equals 1 048 576 bytes

• G, for gigabyte which equals 1 073 741 824 bytes

Documentation Accessibility

Oracle's goal is to make our products, services, and supporting documentation accessible to the disabled community with good usability. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program web site at:
http://www.oracle.com/accessibility/.

Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document.

The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.