Tutorial 3: Sending a message on a client-server configuration

A tutorial to set up messaging between client and server machines, sending a message from the client, and verifying its receipt.


Before starting

This tutorial builds upon IBM MQ objects that have been set up during the previous tutorial - we need to complete Tutorial 2: Sending a message to a remote queue first.

Before starting this tutorial, we need to find out the name which identifies the server which hosts queue manager QM_ORANGE on the network from the system administrator.

You are currently in the IBM MQ Explorer help. To grant the client the access rights to put messages on to a queue, see Preparing and running the sample programs in the main product documentation.


This tutorial shows you how to set up messaging between client and server machines. From the client machine, you put a message on queue manager QM_ORANGE, which is hosted on a server machine. QM_ORANGE sends the message to Q1 on QM_APPLE, which is hosted on another server machine.Important: This tutorial shows you how to work with a client-server installation, where the client is a third machine with IBM MQ Client installed, and the server is the machine which has the queue manager QM_ORANGE defined on it.

You set up the server by creating a server-connection channel. You then set up the client by defining the MQSERVER environment variable. Finally, you put a test message from the Client onto QM_ORANGE which sends it to queue Q1 on QM_APPLE and you verify that the message was sent.

When you have completed this tutorial, we should have a basic understanding of how to set up messaging on a IBM MQ MQI client-server configuration.

  1. Set up the server
  2. Set up the client on Windows and Linux
  3. Send a message from a client to a server
  4. Verify that the test message was sent

Parent topic: IBM MQ Tutorials Previous topic: Tutorial 2: Sending a message to a remote queue