Configuring Oracle
Oracle support and configuration information.
Change versionlist box. To go to the topic in a later version, edit the version number in the URL box in your browser.
- Check environment variable settings.
- Create the Oracle switch load file.
- Add resource manager configuration information.
- Change the Oracle configuration parameters, if necessary.
Checking the Oracle environment variable settings
- ORACLE_HOME
- The Oracle home directory. For example, on UNIX and Linux® systems, use:
On Windows systems, use:export ORACLE_HOME=/opt/oracle/product/8.1.6
set ORACLE_HOME=c:\oracle\ora81
- ORACLE_SID
- The Oracle SID being used. If you are using Net8 for client/server connectivity, you might not
have to set this environment variable. Consult your Oracle documentation. The subsequent example is an example of setting this environment variable, on UNIX and Linux systems:
The equivalent on Windows systems is:export ORACLE_SID=sid1
set ORACLE_SID=sid1
If you run queue managers on Windows 64 bit systems, then both 64 bit and 32 bit Oracle clients must be installed. You must install both clients because the queue manager runs as 32 bit processes that use a 32 bit switch load file, which must in turn start a 32 bit Oracle client dll.
The switch load file, loaded by 64 bit queue managers, must access the Oracle 64 bit client libraries. 32 bit queue managers must access the 32 bit Oracle client when IBM WebSphere MQ is running on a Windows 64 bit system.
Creating the Oracle switch load file
To
create the Oracle switch load file, use the sample file xaswit.mak,
which IBM WebSphere MQ provides to build the
switch load files for various database products. On Windows systems, you can find xaswit.mak in
the directory C:\Program Files\IBM\WebSphere MQ\tools\c\samples\xatm
.
To create the Oracle switch load file with Microsoft Visual C++, use: nmake
/f xaswit.mak oraswit.dll
The generated switch
file is placed in
.MQ_INSTALLATION_PATH
\exitsMQ_INSTALLATION_PATH
represents the high-level
directory in which IBM WebSphere MQ is installed.
You
can find xaswit.mak in the directory
. MQ_INSTALLATION_PATH
/samp/xatmMQ_INSTALLATION_PATH
represents the high-level
directory in which IBM WebSphere MQ is installed.
make -f xaswit.mak oraswit
The generated 32 bit switch load file is placed
in /var/mqm/exits
.
The generated 64 bit switch
load file is placed in /var/mqm/exits64
.
Adding resource manager configuration information for Oracle
- On Windows and Linux (x86 and x86-64 platforms) systems, use the IBM WebSphere MQ Explorer. Specify the details of the switch load file in the queue manager properties panel, under XA resource manager.
- On all other systems specify the details of the switch load file in the XAResourceManager stanza in the qm.ini file of the queue manager.
LogDir
to the XA open string
so that all error and tracing information is logged to the same place.
- In Figure 1, the xa_open string has been used with four parameters. Additional parameters can be included as described in Oracle's documentation.
- When using the IBM WebSphere MQ parameter
ThreadOfControl=THREAD
you must use the Oracle parameter+threads=true
in the XAResourceManager stanza.
See the Oracle8 Server Application Developer's Guide for more information about the xa_open string.
Changing Oracle configuration parameters
- Review your maximum sessions
- You might have to review your LICENSE_MAX_SESSIONS and PROCESSES settings to take into account the additional connections required by processes belonging to the queue manager. See Installing and configuring the database product for more details.
- Set database privileges
- The Oracle user name specified in the xa_open string must have
privileges to access the DBA_PENDING_TRANSACTIONS view, as described
in the Oracle documentation. The necessary privilege can be given using the following example command:
grant select on DBA_PENDING_TRANSACTIONS to myuser;