Configuring a SOCKS client

In this scenario, you can run MQIPT as though it was SOCKS-enabled, using an existing SOCKS proxy.

This is similar to the scenario Configuring a SOCKS proxy, except that MQIPT makes a SOCKS-enabled connection instead of the IBM® MQ client.

Before you begin

Before you start to use this scenario, make sure that you have completed the prerequisite tasks listed in Getting started with IBM MQ Internet Pass-Thru

About this task

Figure 1. SOCKS client network diagram
See text.

This diagram shows the network connection from the IBM MQ client (called client1.company1.com on port 1415) through MQIPT, then through the SOCKS proxy (on port 1080) to the IBM MQ server (called server1.company2.com on port 1414).

Procedure

To configure a SOCKS client, complete the following steps:

  1. Set up MQIPT.
    On the MQIPT computer, edit mqipt.conf and add a route definition: 
    [route]
ListenerPort=1415
Destination=server1.company2.com
DestinationPort=1414
SocksClient=true
SocksProxyHost=10.9.6.7
SocksProxyPort=1080
  2. Start MQIPT.
    Open a command prompt and enter:
    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 has started and will forward messages to :
MQCPI034 ....server1.company2.com(1414)
MQCPI035 ....using MQ protocol
MQCPI039 ....and SOCKS proxy at 10.9.6.7(1080)
MQCPI078 Route 1415 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.