The Oracle Procedural Gateway for APPC provides Oracle applications seamless access to virtually any APPC-enabled system, including IBM mainframe data and services through Remote Procedure Call (RPC) processing. This document is intended for Windows users.
Read this guide if you are responsible for tasks such as:
determining hardware and software requirements
installing, configuring, or administering an Oracle Procedural Gateway for APPC
developing applications that access remote host databases through the Oracle Procedural Gateway for APPC using the SNA Communication Protocol or the TCP/IP communication protocol
determining security requirements
determining and resolving problems
Before using this guide to administer the gateway, you should understand the fundamentals of your Microsoft Windows operating system and Procedural Gateways.
Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. 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. Accessibility 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 more information, visit the Oracle Accessibility Program Web site at
http://www.oracle.com/accessibility/
Accessibility of Code Examples in Documentation
Screen readers 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, some screen readers may not always read a line of text that consists solely of a bracket or brace.
Accessibility of Links to External Web Sites in Documentation
This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.
TTY Access to Oracle Support Services
Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.
The Oracle Procedural Gateway for APPC User's Guide for Microsoft Windows is included as part of your product shipment. Also included is:
Oracle Procedural Gateway for APPC Messages Guide for UNIX and Microsoft Windows
Oracle Procedural Gateway for APPC Installation and Configuration Guide
You might also need Oracle Database 10g and Oracle Net documentation. The following is a useful list of the Oracle publications that may be referenced in this book:
Oracle Database Installation Guide 10g Release 2 (10.2) for Microsoft Windows (32-Bit)
Oracle Database Administrator's Guide 10g Release 2 (10.2) for Microsoft Windows (32-Bit)
Oracle Database Application Developer's Guide
Oracle Database Server Concepts
Oracle Database Server Distributed Systems
Oracle Database Error Messages
Oracle Net Services Administrator's Guide
Refer to the Oracle Technical Publications Catalog and Price Guide for a complete list of documentation provided for Oracle products.
Examples of input and output for the gateway and Oracle environment are shown in a special font:
C:\> mkdir \ORACLE\your_name
All output is shown as it appears. For input, refer to the following list of conventions and their meanings:
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 preceding 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 and reserved words, MS-DOS commands, keywords and environment variables appear in uppercase in examples and text. Reserved words and keywords must always be entered as shown; they have reserved meanings within the Oracle system.
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.
The MS-DOS prompt, C:\>
, appears in MS-DOC command examples. Enter your response at the prompt. Do not enter the text of the prompt, C:\>
, in your response.
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.
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 use the following 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 for Oracle Procedural Gateway for APPC for Windows
Documentation for this product includes this guide and the Oracle Procedural Gateway for APPC Installation and Configuration Guide 10g Release 2 (10.2) for Microsoft Windows (32-Bit) and the Oracle Procedural Gateway for APPC Messages Guide 10g Release 2 (10.2) for UNIX and Windows.
To access the documentation in HTML and PDF formats, use a browser to open the top level of the Gateway Documentation CD-ROM. This level contains links to product and Windows-specific documentation.
Oracle Database 10g product documentation is on the Oracle Database 10g Platform-Specific Documentation CD-ROM. Instructions for accessing and installing the documents on the CD-ROM are found in the README file on the top level directory of the CD-ROM.
Oracle's corporate web page is at the following address:
http://www.oracle.com
Oracle offers a wide range of services to help facilitate corporate system solutions, including Oracle Education courses, Oracle Consulting services, and Oracle Support Services from the Web site. In addition, Oracle provides free trial software, updates on Oracle products and service, and technical brochures and data sheets.
Technical Support registration and contact information worldwide is available at the following address:
http://www.oracle.com/support
At Oracle's support site, you will find templates to help you prepare information about your problem before you call so that you may be helped more quickly. You will also need your CSI number (if applicable) or complete contact details, including any special project information.
OTN delivers all product documentation, as well as technical papers, code samples, self-service developer support, and Oracle's key developer products to enable rapid development and deployment of applications built on Oracle technology.
Register with the Oracle Technology Network (OTN) at:
http://otn.oracle.com
All Oracle product documentation can be found at:
http://otn.oracle.com/documentation
OracleMetaLink is Oracle's web service for technical information. Members of OracleMetaLink can search for updates, alerts, patches, and other information about products, releases, and operating systems, or set preferences to be notified automatically of new information. OracleMetaLink offers a variety of services to assist in setting up and administrating Oracle products, including procedures, scripts, commentary, and tuning and configuration best-practices bulletins. Please logon to OracleMetaLink before installing or administrating your product to search for up to date information about Oracle Database 10g Release 2 (10.2) for Microsoft Windows (32-Bit).
In addition, OracleMetaLink offers forums for information sharing among Oracle customers, and direct communication with Oracle Support Services. OracleMetaLink is available to Product Support Customers at no extra cost. Sign up for free membership for this service at the following site:
http://www.oracle.com/support/metalink
Use your Support Access Code (SAC) number to register.
Oracle Products and Other Documentation
For U.S.A. customers, the Oracle Store is at:
http://store.oracle.com
Links to Stores in other countries are provided from this site.
Oracle Support Services contacts are listed at:
http://www.oracle.com/support
Support for Hearing and Speech Impaired Customers
Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week.
For technical questions, call:
1.800.446.2398
For non-technical questions, call:
1.800.464.2330
Training information and worldwide schedules are available from:
http://education.oracle.com