Oracle Procedural Gateway and Tools for WebSphere MQ provides access to WebSphere MQ services. This gateway requires a system that is capable of running 64-bit applications.
This guide is intended for anyone responsible for installing, configuring, or administering the Oracle Procedural Gateway for WebSphere MQ. It is also for developers writing applications that access message queuing systems, particularly those developers who need to access queues owned by both WebSphere MQ and other non-Oracle message queuing systems as well as queues owned by Oracle Advanced Queuing (AQ).
Read this guide if you are responsible for tasks such as:
Administering the gateway
Setting up gateway security
Using the gateway
Diagnosing gateway errors
Before using this guide, you must understand the fundamentals of your operating system, the procedural gateways, PL/SQL, the Oracle server, and WebSphere MQ software before using this guide to install, configure, or administer the gateway.
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 complete name for this product is Oracle Procedural Gateway and Tools for WebSphere MQ, also called PG4MQ.
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]
|
See the Oracle Database Heterogeneous Connectivity Administrator’s Guide 10g Release 2 (10.2) for information common to all procedural gateways, including important information about functions, parameters, and error messages.
The guide includes references to the following documents:
Oracle Call Interface Programmer’s Guide 10g Release 2 (10.2)
Oracle Database Administrator's Guide 10g Release 2 (10.2)
Oracle Database Error Messages Release 2 (10.2)
Oracle Database Reference 10g Release 2 (10.2)
Oracle Database Utilities 10g Release 2 (10.2)
Oracle Database Heterogeneous Connectivity Administrator’s Guide 10g Release 2 (10.2)
Oracle Database Net Services Administrator’s Guide 10g Release 2 (10.2)
Oracle Database Net Services Reference Guide 10g Release 2 (10.2)
Oracle Security Overview 10g Release 2 (10.2)
Oracle Database SQL Reference 10g Release 2 (10.2)
PL/SQL Packages and Types Reference 10g Release 2 (10.2)
PL/SQL User’s Guide and Reference 10g Release 2 (10.2)
Oracle Database Administrator's Reference 10g Release 2 (10.2) for UNIX Systems: AIX-Based Systems, Apple Mac OS X, hp HP-UX, hp Tru64 UNIX, Linux, and Solaris Operating System
Oracle Database Installation Guide 10g Release 2 (10.2) for UNIX Systems: AIX-Based Systems, hp HP-UX, hp Tru64 UNIX, Linux, and Solaris Operating System
Oracle Visual Workbench for Oracle Procedural Gateways for IBM MQSeries Installation and User’s Guide