Configuring RepConnector for IBM WebSphere MQ

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 it is correctly configured.

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. However, you must go back to verify this connection once you have created the RepConnector environment.

StepsConfiguring IBM WebSphere MQ

  1. Verify that the lines in the repra_env.bat file on Windows or the repra_env.sh file on UNIX that define the IBMMQ_HOME environment variable are not commented out and point to the installation location for the IBM WebSphere MQ environment. For example:

    On Windows:

    IBMMQ_HOME=c:\Program Files\IBM\WebSphere MQ
    

    On UNIX:

    IBMMQ_HOME=/opt/mqm
    
  2. 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
    
  3. If you are connecting to the remote MQ daemon, verify that the MQ Server environment variable is defined correctly in the repra_env.bat file on Windows, or the repra_env.sh file on 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
    
  4. Restart your application server.

StepsConfiguring MQ JMS

  1. Verify that the lines in the repra_env.bat file on Windows or the repra_env.sh file on UNIX that define the IBMMQ_HOME environment variable are not commented out and point to the installation location for the IBM MQ JMS. For example:

    On Windows:

    IBMMQ_HOME=c:\Program Files\IBM\WebSphere MQ
    

    On UNIX:

    IBMMQ_HOME=/opt/mqm
    
  2. 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=%IBMMQ_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
    
  3. If you are connecting to the remote MQ daemon, verify that the MQ Server environment variable is defined correctly in the repra_env.bat file on Windows, or the repra_env.sh file on 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
    
  4. Restart your application server.