Configuring HTTP tunneling

In this scenario, you can test a simple connection between two instances of MQIPT over HTTP.

About this task

This diagram shows the connection from the IBM MQ client (called client1.company1.com on port 1415) through two instances of MQIPT, tunnelling the connection over HTTP, and finally to the IBM MQ server (called server1.company2.com on port 1414).

To configure HTTP tunneling between two instances of MQIPT, complete the following steps:

1. On the MQIPT 1 system:
   1. Edit mqipt.conf and add the following route definition:

      [route]
      ListenerPort=1415
      Destination=10.100.6.7
      DestinationPort=8080
      HTTP=true
      HTTPServer=10.100.6.7
      HTTPServerPort=8080

   2. Open a command prompt and start MQIPT:

      C:\mqipt\bin\mqipt C:\mqiptHome -n ipt1

      where C:\mqiptHome indicates the location of the MQIPT configuration file, mqipt.conf, and ipt1 is the name to be given to the instance of MQIPT.
      The following messages indicate that MQIPT has started successfully:

      5724-H72 (C) Copyright IBM Corp. 2000, 2024. All Rights Reserved
      MQCPI001 IBM MQ Internet Pass-Thru V9.2.0.0 starting
      MQCPI004 Reading configuration information from mqipt.conf
      MQCPI152 MQIPT name is ipt1
      MQCPI021 Password checking has been enabled on the command port
      MQCPI011 The path C:\mqiptHome\logs will be used to store the log files
      MQCPI006 Route 1415 is starting and will forward messages to :
      MQCPI034 ....10.100.6.7(8080)
      MQCPI035 ....using HTTP
      MQCPI066 ....and HTTP server at 10.100.6.7(8080)
      MQCPI078 Route 1415 ready for connection requests

2. On the MQIPT 2 system:
   1. Edit mqipt.conf and add the following route definition:

      [route]
      ListenerPort=8080
      Destination=Server1.company2.com
      DestinationPort=1414

   2. Open a command prompt and start MQIPT:

      C:\mqipt\bin\mqipt C:\mqiptHome -n ipt2

      where C:\mqiptHome indicates the location of the MQIPT configuration file, mqipt.conf, and ipt2 is the name to be given to the instance of MQIPT.
      The following messages indicate that MQIPT has started successfully:

      5724-H72 (C) Copyright IBM Corp. 2000, 2024. All Rights Reserved
      MQCPI001 IBM MQ Internet Pass-Thru V9.2.0.0 starting
      MQCPI004 Reading configuration information from mqipt.conf
      MQCPI152 MQIPT name is ipt2
      MQCPI021 Password checking has been enabled on the command port
      MQCPI011 The path C:\mqiptHome\logs will be used to store the log files
      MQCPI006 Route 8080 is starting and will forward messages to :
      MQCPI034 ....Server1.company2.com(1414)
      MQCPI035 ....using MQ protocols
      MQCPI078 Route 8080 ready for connection requests

3. At a command prompt on the IBM MQ client, enter the following commands:
   1. Set the MQSERVER environment variable:

      SET MQSERVER=MQIPT.CONN.CHANNEL/tcp/10.9.1.2(1415)

   2. Put a message:

      amqsputc MQIPT.LOCAL.QUEUE MQIPT.QM1
      Hello world

      Press Enter twice after typing the message string.
   3. Get the message:

      amqsgetc MQIPT.LOCAL.QUEUE MQIPT.QM1

      The message, "Hello world" is returned.