The Oracle Procedural Gateway for APPC provides Oracle applications with seamless access to IBM mainframe data and services through Remote Procedure Call (RPC) processing.
The UNIX platforms supported by this gateway release are:
Linux 32-bit Intel Pentium-based processors
Solaris Operating System (SPARC 64-bit)
AIX pSeries (64-bit), and
HP-UX PA-RISC (64-bit)
Refer to the Oracle Database Installation Guide 10g Release 2 (10.2) for UNIX Systems and to the certification matrix on the OracleMetaLink Web site for the most up-to-date list of certified hardware platforms and operating system versions. The OracleMetaLink Web site is available at
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 gateway using either the SNA communication protocol or the TCP/IP for IMS Connect communication protocol.
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.
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 following typographic conventions are used in this guide:
Convention | Description |
---|---|
monospace |
Monospace type indicates UNIX commands, directory names, user names, path names, and file names. |
italics | Italic type indicates variables, including variable portions of file names. It is also used for emphasis and for book titles. |
UPPERCASE | Uppercase letters indicate Structured Query Language (SQL) reserved words, initialization parameters, and environment variables. |
Bold | Bold type indicates screen names and fields. |
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 command syntax appears in monospace
font. The dollar character ($), number sign (#), or percent character (%) are UNIX command prompts. Do not enter them as part of the command. The following command syntax conventions are used in this guide:
Convention | Description |
---|---|
backslash \ | A backslash is the UNIX command continuation character. It is used in command examples that are too long to fit on a single line. Enter the command as displayed (with a backslash) or enter it on a single line without a backslash:
dd if=/dev/rdsk/c0t1d0s6 of=/dev/rst0 bs=10b \ count=10000 |
braces { } | Braces indicate required items:
.DEFINE {macro1} |
brackets [ ] | Brackets indicate optional items:
cvtcrt termname [outfile] |
ellipses ... | Ellipses indicate an arbitrary number of similar items:
CHKVAL fieldname value1 value2 ... valueN |
italics | Italic type indicates a variable. Substitute a value for the variable:
library_name
|
vertical line | | A vertical line indicates a choice within braces or brackets:
FILE filesize [K|M]
|
The Oracle Procedural Gateway for APPC Installation and Configuration Guide for UNIX is included as part of your product shipment. Also included is:
You might also need Oracle server and Oracle Net documentation. The following is a useful list of the Oracle publications that might be referenced in this guide:
Oracle Database Installation Guide 10g Release 2 (10.2) for UNIX Systems
Oracle Database Administrator's Guide 10g Release 2 (10.2) for UNIX Systems
Other related publications are listed in "Documentation Requirements". Refer to the Oracle Technical Publications Catalog and Price Guide for a complete list of documentation provided for Oracle products.
The following sections provide information about accessing installed documentation.
Documentation for Oracle Procedural Gateway for APPC for UNIX Platforms
Documentation for this product includes this guide and the Oracle Procedural Gateway for APPC User's Guide 10 g Release 2 (10.2) for UNIX and the Oracle Procedural Gateway for APPC Messages Guide 10g Release 2 (10.2).
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 UNIX-specific documentation.
Oracle Database product documentation is on the Oracle Database Generic 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.
The Oracle corporate web page is available at
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
At the Oracle support site, you will find templates to help you prepare information about your problem before you call so that you can be helped more quickly. You also need your CSI number (if applicable) or complete contact details, including any special project information.
Printed documentation is available for sale in the Oracle Store at
http://oraclestore.oracle.com/
To download free release notes, installation documentation, white papers, or other collateral, please visit the Oracle Technology Network (OTN). You must register online before using OTN; registration is free and can be done at
http://www.oracle.com/technology/membership/index.html
If you already have a username and password for OTN, then you can go directly to the documentation section of the OTN Web site at
http://www.oracle.com/technology/documentation/index.html
OracleMetaLink is the Oracle 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.
Log on to OracleMetaLink before installing or administrating your product to search for up-to-date information about Oracle Database for UNIX.
In addition, OracleMetaLink offers forums for information sharing between 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 customers in the US, the Oracle Store is at
Links to Stores in other countries are provided from this Web site.
Oracle Support Services contacts are listed at
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