Configure RepConnector for IBM WebSphere MQ

This section describes how to set up the RepConnector environment so that RepConnector can communicate with the IBM WebSphere MQ or MQ JMS Messaging System.

Sybase recommends that you configure your environment before you configure the RepConnector connection. This enables you to ping the IBM Websphere MQ Messaging System during configuration to verify that you have configured it properly. If you do not configure your RepConnector environment before configuring the RepConnector connection, RepConnector Manager allows you to create the connection even if the ping has failed. You must go back to verify this once you have set up the RepConnector environment.

Configuring IBM WebSphere MQ

To configure your environment for IBM WebSphere MQ:

Verify that the lines in repra_env.bat (Windows) or repra_env.sh (UNIX) that define the IBMMQ_HOME environment variable are not commented out and point to the installation location for the IBM Websphere MQ environment.
- On Windows:
```
IBMMQ_HOME=c:\Program Files\IBM\WebSphere MQ
```
- On UNIX:
```
IBMMQ_HOME=/opt/mqm
```

Verify that the lines that define the directory structure for the IBM WebSphere MQ library files, mq.jar and mqbind.jar, are not commented out and are defined correctly for your environment.

On Windows:

REPRA_CLASSPATH=%IBMMQ_HOME%\Java\lib\com.ibm.mq.jar;
REPRA_CLASSPATH=%IBMMQ_HOME%\Java\lib\com.ibm.mqbind.jar;%REPRA_CLASSPATH%
CLASSPATH=%CLASSPATH%;%REPRA_CLASSPATH%
BOOTCLASSPATH=%BOOTCLASSPATH%;%REPRA_CLASSPATH%

On UNIX:

REPRA_CLASSPATH=$IBMMQ_HOME/java/lib/com.ibm.mq.jar
REPRA_CLASSPATH=$IBMMQ_HOME/java/lib/com.ibm.mqbind.jar:$REPRA_CLASSPATH
CLASSPATH=$CLASSPATH:$REPRA_CLASSPATH
BOOTCLASSPATH=$BOOTCLASSPATH:$REPRA_CLASSPATH

If you are connecting to the remote MQ daemon, verify that the MQ Server environment variable is defined correctly in repra_env.bat (Windows) or repra_env.sh (UNIX). If the environment variable is not defined correctly, modify it as follows:
- On Windows, at the command line, where CHANNEL1 is the name you have defined for the channel for the server connection, enter:
```
set MQSERVER=CHANNEL1/TCP/'mymachine(1414)'
```
- On UNIX, at the command line, where CHANNEL1 is the name you have defined for the channel for the server connection, enter:
```
MQSERVER=CHANNEL1/TCP/'mymachine1(1414)'
export MQSERVER
```
See Chapter 4, “Configuring the Messaging System,” for more information.
To effect the changes, restart your application server.

To configure EAServer, see the EAServer documentation.

Configuring MQ JMS

To configure your environment for MQ JMS:

Verify that the lines in repra_env.bat (Windows) or repra_env.sh (UNIX) that define the IBMMQ_HOME environment variable are not commented out and point to the installation location for the IBM WebSphere MQ JMS.
- On Windows:
```
IBMMQ_HOME=c:\Program Files\IBM\WebSphere MQ
```
- On UNIX:
```
IBMMQ_HOME=/opt/mqm
```

Verify that the lines that define the directory structure for the IBM WebSphere MQ JMS library files, mq.jar and mqbind.jar, are not commented out and are defined correctly for your environment.

On Windows:

REPRA_CLASSPATH=%IBMMQ_HOME%\Java\lib\com.ibm.mq.jar;
REPRA_CLASSPATH=%IBMMQ_HOME%\Java\lib\com.ibm.mqbind.jar;%REPRA_CLASSPATH%
REPRA_CLASSPATH=%IBMMQ_HOME%\Java\lib\com.ibm.mqjms.jar;%REPRA_CLASSPATH%
REPRA_CLASSPATH=%IBMMA_HOME%\Java\lib;%REPRA_CLASSPATH%
CLASSPATH=%CLASSPATH%;%REPRA_CLASSPATH%
BOOTCLASSPATH=%BOOTCLASSPATH%;%REPRA_CLASSPATH%

On UNIX:

REPRA_CLASSPATH=$IBMMQ_HOME/java/lib/com.ibm.mq.jar
REPRA_CLASSPATH=$IBMMQ_HOME/java/lib/com.ibm.mqbind.jar:$REPRA_CLASSPATH
REPRA_CLASSPATH=$IBMMQ_HOME/java/lib/com.ibm.mqjms.jar:$REPRA_CLASSPATH
REPRA_CLASSPATH=$IBMMQ_HOME/java/lib:$REPRA_CLASSPATH
CLASSPATH=$CLASSPATH:$REPRA_CLASSPATH
BOOTCLASSPATH=$BOOTCLASSPATH:$REPRA_CLASSPATH

If you are connecting to the remote MQ daemon, verify that the MQ Server environment variable is defined correctly in repra_env.bat (Windows) or repra_env.sh (UNIX). If the environment variable is not defined correctly, modify it as follows:
- On Windows, at the command line, where CHANNEL1 is the name you have defined for the channel for the server connection, enter:
```
set MQSERVER=CHANNEL1/TCP/'remotemachine1(1414)'
```
- On UNIX, at the command line, where CHANNEL1 is the name you have defined for the channel for the server connection, enter:
```
MQSERVER=CHANNEL1/TCP/'remotemachine1(1414)'
export MQSERVER
```
See Chapter 4, “Configuring the Messaging System,” for more information.
To effect the changes, restart your application server.