Oracle Procedural Gateway for WebSphere MQInstallation and User’s Guide,10g Release 2 (10.2) for WindowsB16216-02August 2006
Oracle Procedural Gateway for WebSphere MQ Installation and User’s Guide, 10g Release 2 (10.2) forWindowsB16216-02Copyright 2006, Oracle. All rights reserved.Primary Author:Maitreyee ChalihaContributing Author:Li-Te ChenThe Programs (which include both the software and documentation) contain proprietary information; theyare provided under a license agreement containing restrictions on use and disclosure and are also protectedby copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly,or decompilation of the Programs, except to the extent required to obtain interoperability with otherindependently created software or as specified by law, is prohibited.The information contained in this document is subject to change without notice. If you find any problems inthe documentation, please report them to us in writing. This document is not warranted to be error-free.Except as may be expressly permitted in your license agreement for these Programs, no part of thesePrograms may be reproduced or transmitted in any form or by any means, electronic or mechanical, for anypurpose.If the Programs are delivered to the United States Government or anyone licensing or using the Programs onbehalf of the United States Government, the following notice is applicable:U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical datadelivered to U.S. Government customers are "commercial computer software" or "commercial technical data"pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. Assuch, use, duplication, disclosure, modification, and adaptation of the Programs, including documentationand technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle licenseagreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, CommercialComputer Software—Restricted Rights (June 1987). Oracle USA, Inc., 500 Oracle Parkway, Redwood City,CA 94065.The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherentlydangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup,redundancy and other measures to ensure the safe use of such applications if the Programs are used for suchpurposes, and we disclaim liability for any damages caused by such use of the Programs.Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or itsaffiliates. Other names may be trademarks of their respective owners.The Programs may provide links to Web sites and access to content, products, and services from thirdparties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites.You bear all risks associated with the use of such content. If you choose to purchase any products or servicesfrom a third party, the relationship is directly between you and the third party. Oracle is not responsible for:(a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with thethird party, including delivery of products or services and warranty obligations related to purchasedproducts or services. Oracle is not responsible for any loss or damage of any sort that you may incur fromdealing with any third party.
ContentsPreface . ixAudience.Documentation Accessibility .Product Name .Conventions .Related Publications.Related Documents .1IntroductionIntroduction to Message Queuing .Introduction to WebSphere MQ.WebSphere MQ Terms .Introduction to the Gateway .Developing Gateway Applications .Gateway Terms.Advantages of Using the Gateway .Gateway Architecture.Component Descriptions .Oracle Applications .Oracle Integrating Server.Oracle Net .Gateway.WebSphere MQ Queue Manager.WebSphere MQ Application .Gateway Structure .Gateway Operation.Communication 61-61-61-61-61-6Release InformationChanges and Enhancements.Changes and Enhancements for 10g Release 2 (10.2).Oracle Server Dependencies.Changes and Enhancements for 10g Release 2 (10.2).Support for Large Data Buffers.PG4MQ Data Types .2-12-12-12-12-12-1iii
PGM UTL Procedures .PG4MQ API Prototype Changes .Heterogeneous Services Architecture .Performance Enhancements .New PG4MQ Packages .New PG4MQ Deployment Scripts .Large Payload Support .Database Link and Alias Library .Known Restrictions for 10g Release 2 .Known Problems for 10g Release are Requirements. 3-1Software Requirements. 3-1Recommended Documentation . 3-24PreinstallationPreinstallation Tasks.WebSphere MQ Software.ORACLE HOME .About Oracle Universal Installer .oraInventory Directory.Starting Oracle Universal Installer .54-14-14-14-24-24-2InstallationInstallation. 5-1Stepping Through the Oracle Universal Installer . 5-16Uninstallation and ReinstallationUninstallation .Uninstalling Using Oracle Universal Installer.Uninstalling Oracle Procedural Gateway for WebSphere MQ .Reinstallation .7ConfigurationConfiguration Overview .Configuring the Gateway .Using the Gateway with the Default Values.Using the Gateway Without the Default Values .Changing Default Values .Step 1: Choose a System ID for the Gateway .Step 2: Customize the gateway initialization file .Configuring Oracle Net for the Gateway .Using Oracle Net with Default Gateway Values.Using Oracle Net When Changing the Default Gateway Values .iv6-16-16-16-37-17-17-27-27-27-27-27-37-47-4
Step 1: Configure the Oracle Net TNS Listener for the Gateway . 7-4Step 2: Stop and start the TNS listener for the Gateway . 7-6Configuring Oracle Net for Oracle Integrating Server . 7-7Using Gateway Default Values . 7-7Changing Gateway Default Values . 7-7TCP/IP Example . 7-7IPC Example . 7-8Creating a Transaction Log Queue . 7-9Administering the Database Links Alias Library. 7-9Using Database Links . 7-9Creating Database Links . 7-10Dropping Database Links . 7-10Examining Available Database Links . 7-11Limiting the Number of Active Database Links. 7-11Creating Alias Library . 7-11Dropping Alias Library . 7-11Installing the Oracle Visual Workbench Repository. 7-11Preinstallation Tasks . 7-11Step 1: Choose a Repository Server . 7-11Step 2: Locate the Installation Scripts. 7-12Step 3: Upgrade the Visual Workbench Repository . 7-12Step 4: Ensure that the UTL RAW Package Is Installed . 7-12Step 5: Ensure that the DBMS OUTPUT Package Is Enabled. 7-12Step 6: Create a Database Link. 7-13Visual Workbench Repository Installation Tasks . 7-13Step 1: Enter the Database Connection Information. 7-13Step 2: Check for Existing Workbench Repository . 7-13Step 3: Check for Required PL/SQL Packages . 7-13Step 4: Install the UTL PG Package . 7-14Step 5: Create the Administrative User and All Repository Tables . 7-14Step 6: Create Public Synonyms and Development Roles . 7-14After the Repository is Created. 7-14Uninstall the Visual Workbench Repository. 7-14Step 1: Enter the Database Connection Information. 7-15Step 2: Check for Existing Workbench Repository . 7-15Preparing the Production Oracle Server . 7-15Introduction . 7-15Verifying and Installing PL/SQL Packages . 7-16Removing the PL/SQL Packages. 7-168Gateway Running EnvironmentSecurity Models .Relaxed Model .Strict Model .Authorization Process for a WebSphere MQ Server Application .Authorization Process for a WebSphere MQ Client Application .Authorization for WebSphere MQ Objects .8-18-18-28-28-28-2v
Transaction Support.Non-Oracle Data Sources and Distributed Transactions .Transaction Capability Types.Transaction Capability Types of Procedural Gateway for WebSphere MQ .Single-Site Transactions .Commit-Confirm Transactions .Troubleshooting.Message and Error Code Processing .Interpreting Gateway Messages .Common Error Codes.Gateway Tracing .LOG DESTINATION PARAMETER.Verifying Gateway Operation .AThe PGM, PGM UTL8, and PGM SUP PackagesPGM Package, PG4MQ Gateway Procedures, and Data Type Defintions .Summary of Procedures and Type Definitions .Procedure Conventions .MQI Calls Performed by the Gateway.Unsupported MQI Calls.Migration Tips .MQCLOSE Procedure.MQGET Procedure.PGM.MQMD Type Definition.PGM.MQGMO Type Definition.MQOPEN Procedure.PGM.MQOD Type Definition .MQPUT Procedure.PGM.MQPMO Type Definition .PGM SUP Package .PGM.MQGMO Values .OPTIONS Field.VERSION Field.MATCHOPTIONS Field .WAITINTERVAL.PGM.MQMD Values.CODEDCHARSETID Field.ENCODING Field .ENCODING Field, Values for Binary Integers.ENCODING Field, Values for Floating Point Numbers .ENCODING Field, Mask Values .ENCODING Field, Values for Packed Decimal Integers .EXPIRY Field .FEEDBACK Field .FORMAT Field .MSGTYPE Field.PERSISTENCE Field A-21A-21A-22
PRIORITY Field.PUTAPPLTYPE Field .REPORT Field.VERSION Field.Report Field, Mask Values.PGM.MQOD Values .OBJECTTYPE Field .OBJECTTYPE Field, Extended Values .VERSION Field.PGM.MQPMO Values .OPTIONS Field.VERSION Field.MQCLOSE Values.hobj Argument .options Argument .MQOPEN Values .options Argument .Maximum Lengths for Fields of PGM Type Definitions.Error Code Definitions .BUTL RAW PackageMessage Data Types.UTL RAW Functions .UTL RAW.TO RAW .UTL RAW.BIT AND .UTL RAW.BIT COMPLEMENT.UTL RAW.BIT OR.UTL RAW.BIT XOR .UTL RAW.CAST TO RAW .UTL RAW.CAST TO VARCHAR2 .UTL RAW.COMPARE .UTL RAW.CONCAT .UTL RAW.CONVERT .UTL RAW.COPIES.UTL RAW.LENGTH.UTL RAW.OVERLAY.UTL RAW.REVERSE .UTL RAW.SUBSTR .UTL RAW.TRANSLATE.UTL RAW.TRANSLITERATE.UTL teway Initialization ParametersGateway initialization file.
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 appli