Preface

Oracle Procedural Gateway and Tools for WebSphere MQ provides access to WebSphere MQ services.

Audience

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

Documentation Accessibility

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.

Product Name

The complete name for this product is Oracle Procedural Gateway and Tools for WebSphere MQ, also called PG4MQ.

Conventions

The following text conventions are used in this guide:

Convention	Description
`monospace`	Monospace type indicates commands, codes, URL, and text user enters.
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 SQLPlus prompt, SQL>, appears in SQL statement and SQLPlus command examples. Enter your response at the prompt. Do not enter the text of the prompt, "SQL>", in your response.

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, the list of conventions and their meanings are as follows:

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 reserved words, MS-DOS commands, keywords, and environment variables appear in uppercase in examples and text. Reserved words must always be entered as shown; they have reserved meanings within the Oracle system.

Related Publications

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.