Getting started with IBM MQ Internet Pass-Thru

The scenarios in this section show you how to set up some simple IBM® MQ Internet Pass-Thru (MQIPT) configurations. You can also use these tasks to confirm that the product has been installed successfully.

Before you begin

Before you start to use these scenarios, make sure that the following prerequisites have been completed:
  • You are familiar with defining queue managers, queues, and channels on IBM MQ.
  • You have already installed an IBM MQ client and server.
  • MQIPT is installed in a directory called C:\mqipt on Windows systems. (The examples are written for Windows systems but will run on any of the supported platforms.) For more information on installing MQIPT, see Installing MQIPT.
  • The client, server, and each instance of MQIPT are installed on separate computers.
  • You are familiar with putting messages on a queue by using the amqsputc command.
  • You are familiar with getting messages from a queue using the amqsgetc command.
  • You are familiar with setting client authorities in IBM MQ.

About this task

Procedure

  1. On the IBM MQ server, complete the following tasks:
    • Define a queue manager called MQIPT.QM1.
    • Define a server connection channel called MQIPT.CONN.CHANNEL.
    • Define a local queue called MQIPT.LOCAL.QUEUE.
    • Start a TCP/IP listener for MQIPT.QM1 on port 1414. If port 1414 is already in use by another application choose a free port address and substitute it in the following examples.
    • Ensure that connection authentication and channel authentication is configured to allow client connections from the client machine with your user ID. If connection authentication is set to require a user ID and password for client connections, you will need to set the MQSAMP_USER_ID environment variable to the user ID to be used for connection authentication before running the amqsputc and amqsgetc commands.
  2. Test the route from the IBM MQ client to the queue manager by putting a message on the local queue of the queue manager, by using the amqsputc command, and then retrieving it, by using the amqsgetc command.
    To prepare for the scenarios in this section, create and edit the mqipt.conf file as follows:
    1. Copy the mqiptSample.conf file, which you can find in the samples subdirectory of the MQIPT installation directory, to mqipt.conf in your chosen MQIPT home directory. The following scenarios use C:\mqiptHome as the MQIPT home directory.
    2. Create two directories alongside mqipt.conf named errors and logs. Set the file permissions on these directories so that they are writeable by the user ID that will run MQIPT.
    3. Delete all routes from the mqipt.conf file.
    4. In the remaining [global] section, check that ClientAccess exists and is set to true.

What to do next

After setting up your system, you are ready to start the following scenarios: