| Oracle Procedural Gateway® for WebSphere MQ Installation and User's Guide, 10g Release 2 (10.2) for Windows Part Number B16216-02 |
|
|
View PDF |
| Oracle Procedural Gateway® for WebSphere MQ Installation and User's Guide, 10g Release 2 (10.2) for Windows Part Number B16216-02 |
|
|
View PDF |
This chapter contains information that is specific to this release of the gateway. It contains the following sections:
The following changes and enhancements apply to all releases of the 10g Release 2 (10.2) gateway products.
The following sections describe the changes and enhancements included in this release.
The following changes and enhancements are for the previous release of the Oracle10g gateway products.
The PL/SQL RAW data type limitation is 32 KB (32767 bytes). For large loads, you must use the TABLE OF RAWS data type. For more information about support for large data buffers, refer to Appendix A.
The following table provides information about PGM_UTL procedures.
| Procedure | V401 | V804 | V817 and V901 | Oracle10g Release 2 |
|---|---|---|---|---|
TO_RAW |
NA | PGM_UTL.TO_RAW |
PGM_UTL8.TO_RAW |
PGM.TO_RAW |
RAW_TO_MQMD |
NA | PGM_UTL.RAW_TO_MQMD |
PGM_UTL8.RAW_TO_MQMD |
PGM.RAW_TO_MQMD |
RAW_TO_MQPMO |
NA | PGM_UTL.RAW_TO_MQPMO |
PGM_UTL8.RAW_TO_MQPMO |
PGM.RAW_TO_MQPMO |
RAW_TO_MQGMO |
NA | PGM_UTL.RAW_TO_MQGMO |
PGM_UTL8.RAW_TO_MQGMO |
PGM.RAW_TO_MQGMO |
Note:
For Oracle10g Release (10.2), the PGM.TO_RAW, PGM.RAW_TO_MQMD, PGM.RAW_TO_MQPMO, and PGM.RAW_TO_MQGMO procedures are added for backward compatibility.The following table provides information about PG4MQ application programming interface changes.
| API | V401 Arguments | V804 Arguments | V817 & V901 Arguments | 10g Release 2 Arguments |
|---|---|---|---|---|
MQOPEN |
(MQOD,INT,INT) |
(RAW,INT,INT) |
(RAW,INT,INT) |
(PGM.MQOD,INT,INT) |
MQPUT |
(INT,MQMD,MQPMO,RAW) |
(INT,RAW,RAW,RAW) |
(INT,RAW,RAW,RAW) |
(INT,PGM.MQMD,PGM_MQPMO,RAW) or (INT, PGM.MQMD, PGM_MQPMO, PGM.MQPUT_BUFFER) |
MQGET |
(INT,MQMD,MQGMO,RAW) |
(INT,RAW,RAW,RAW) |
(INT,RAW,RAW,RAW) |
(INT,PGM.MQMD,PGM_MQGMO,RAW) or (INT, PGM.MQMD, PGM.MQGMO, PGM_MQGET_BUFFER) |
MQCLOSE |
(INT,INT) |
(INT,INT) |
(INT,INT) |
(INT,INT) |
Refer to Appendix A for the details of APIs.
This release of Oracle Procedural Gateway for WebSphere MQ uses the Oracle Heterogeneous Services external procedure component within the Oracle10g server.
See Also:
Refer to Oracle Database Application Developer's Guide - Fundamentals for more information.Oracle Procedural Gateway for WebSphere MQ contains several internal performance enhancements. This product has shown major improvements in response time and CPU utilization for all relevant address spaces for a variety of workloads compared to version 4 gateways. The actual performance improvement at your site might vary, depending on your installation type and workload.
PGM and PGM_UTL8 packages are new in this release. These packages provide new features as well as ensure backward compatibility. Refer toMigration Tips for details of upgrading your existing PL/SQL application programs to use Oracle10g PG4MQ features.
The following scripts are new in this release:
pgm.sql
pgmobj.sql
pgmdeploy.sql
pgmundeploy.sql
The gateway procedures in the PGM package are defined in pgm.sql and PGM_MQ* data type definitions used by the procedures are defined in pgmobj.sql. For complete information about PGM package, PG4MQ gateway procedures, and data type definitions, refer to Appendix A.
PG4MQ 10g Release 2 (10.2) supports large payloads or messages longer than 32767 bytes. For more information, refer to the putlongsample.sql and getlongsample.sql sample programs installed with the PG4MQ.
A connection to the gateway is established through a database link. From PG4MQ 10g release 2 and later, this database link is no longer associated with each PG4MQ gateway procedural call (for example, PGM.MQPUT@dblink). From 10g release 2 and later, it needs to be defined only once in the MQOD data type used by MQOPEN, and this database link is registered in the object handle returned by the MQOPEN call. Refer to the sample programs installed with the gateway for details. By default, a public database link, pg4mqdepdblink, is created with your default SID when PG4MQ deployment scripts are executed.
The following restriction is known to exist for this release.
Customizing LOG_DESTINATION
There is a known issue when customizing the gateway initialization file for gateway tracing for MS windows platform. When customizing the path name of LOG_DESTINATION, the delimiter must be double backslashes. For example:
LOG_DESTINATION=C:\\oracle\\product\\10.2.0\\pg4mqs\\pg4mq\\log\\pg4mqs.log
Note:
IfLOG_DESTINATION is not defined for MS windows platform, a default name is used and the log is created in ORACLE_HOME\pg4mq\trace directoryCustomizing deployment script pgmobj.sql
There is a known issue when customizing the gateway deployment script pgmobj.sql for MS windows platform. When defining the path name of libpg4mq, the delimiter must be backslashes. For example create or replace library libpg4mq as:
CREATE OR REPLACE LIBRARY libpg4mq as 'C:\oracle\product\10.2.0\pg4mqs\bin\orapg4mqs.dll' transactional
or
CREATE OR REPLACE LIBRARY libpg4mq as '$ORACLE_HOME\bin\orapg4mqs.dll' transactional
The problems documented in this section are specific to the Oracle Procedural Gateway for WebSphere MQ and are known to exist in this release of the product. These problems will be fixed in a future release. If you have any questions or concerns about these problems, contact Oracle Support Services.
A current list of problems is available online. Contact your local Oracle office for information about accessing this online information.
