Legacy platform

Setting up the MQ client

You can install and configure the MQ client to test the integration between Sterling™ Order Management System and your external system.

Procedure

  1. Download and install the MQ client on an external system.
    1. Go to https://www-945.ibm.com/support/fixcentral/ and enter or select the product name as IBM MQ.
    2. Select the latest version of the MQ client.
    3. Select the platform based on where you want to install the client.
    4. Click Continue to proceed. Once you reach the search results page, download the appropriate file for your platform. For example, 8.0.0.7-WS-MQC-Win64 is for a Windows 64-bit machine.
  2. Obtain the MQ self signed SSL certificate from IBM Cloud Dropbox or SI DEV Team BOX area.
  3. Install the certificate into trusted keystore for MQ client.
    Using the iKeyman utility that is installed as part of MQ Client, create key.db and install the certificate.
  4. Configure the MQ client in the following manner:
    1. Create a channel definition. (generates the AMQCLCHL.TAB file)
      1. On Linux or Unix:
        Run cd <MQ_Client_Installation_Path>/bin

        On Windows:
        Run cd <MQ_Client_Installation_Path>\bin

      2. On Linux or Unix:
        Run ./runmqsc -n

        On Windows:
        Run runmqsc -n

      3. Run the following command to create the channel definition.

        DEFINE CHANNEL(SYSTEM.SSL.SVRCONN) CHLTYPE(CLNTCONN) TRPTYPE(TCP) CONNAME(‘<cust>-oms.<env>.coc.ibmcloud.com(1415)’) QMNAME(OM_QMGR) SSLCIPH(TLS_RSA_WITH_AES_128_CBC_SHA256)

      4. Locate the generated AMQCLCHL.TAB file on the client machine.
      5. Set the following environment variables for MQ client:
        
set MQCHLTAB = AMQCLCHL.TAB
set MQCHLLIB = <path of AMQCLCHL.TAB>
set MQSSLKEYR = <path of the key repository that holds the digital certificate>\key