Scenario: Allocating port numbers

We can control the local port addresses used when making outgoing connections. For example, if your firewall allows only certain ranges of port numbers, we can use MQIPT to ensure that output originates from a valid port.

Before you begin

• Before you start to use this scenario, make sure that we have completed the prerequisite tasks listed in Scenarios: Getting started with MQIPT.
• Install MQIPT on a multihomed computer.

About this task

This diagram shows the connection from a IBM MQ client (client1.company1.com on port 1415) through MQIPT to a IBM MQ server (server1.company2.com on port 1414).

Procedure

To allocate port numbers, complete the following steps:

1. Set up MQIPT. Edit mqipt.conf and add a route definition:

   [route]
   ListenerPort=1415
   Destination=server1.company2.com
   DestinationPort=1414
   LocalAddress=10.10.6.7
   OutgoingPort=2000
   MaxConnectionThreads=20

2. Start MQIPT. Open a command prompt on the IBM MQ client, and enter the following command:

   C:\mqipt\bin\mqipt C:\mqiptHome

   where C:\mqiptHome indicates the location of the MQIPT configuration file, mqipt.conf. The following message indicates successful completion:

   5639-L92 (C) Copyright IBM Corp. 2000, 2017 All Rights Reserved
   MQCPI001 IBM MQ Internet Pass-Thru Version 2.1.0.3 starting
   MQCPI004 Reading configuration information from mqipt.conf
   MQCPI021 Password checking has been enabled on the command port
   MQCPI008 Listening for control commands on port 1881
   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 ....server1.company2.com(1414)
   MQCPI035 ....using MQ protocols
   MQCPI069 ....binding to local address 10.10.6.7 when making new connections
   MQCPI070 ....using local port address range 2000-2019 when making new connections
   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.7.20.5(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.