Testing communication between a client and a server on Linux

On the IBM MQ MQI client workstation, use the amqsputc sample program to put a message on the queue at the server workstation. Use the amqsgetc sample program to get the message from the queue back to the client.

Before starting

Complete the previous topics in this section:

• Set up a queue manager, channels, and queue.
• Open a command window.
• Set system environment variables.

About this task

Note that IBM MQ object definitions are case-sensitive. Text entered as an MQSC command in lowercase is converted automatically to uppercase unless you enclose it in single quotation marks. Make sure that you type the examples exactly as shown.

We must be logged in with the appropriate authority. For example, user ivtid in the mqm group.

Procedure

1. Change to the MQ_INSTALLATION_PATH/samp/bin directory, which contains the sample programs. MQ_INSTALLATION_PATH represents the high-level directory in which IBM MQ is installed.
2. We must set certain environment variables so that the installation can be used in the current shell. We can set the environment variables by entering the following command:

   . MQ_INSTALLATION_PATH/bin/setmqenv -s
   

   where MQ_INSTALLATION_PATH refers to the location where IBM MQ is installed.
3. Start the PUT program for QUEUE1 on QUEUE.MANAGER.1 by entering the following command:

   ./amqsputc QUEUE1 QUEUE.MANAGER.1
   

   If the command is successful, the following messages are displayed:

   Sample AMQSPUT0 start 
   target queue is QUEUE1

   Tip: We might get the error, MQRC_NOT_AUTHORIZED (2035). By default, channel authentication is enabled when a queue manager is created. Channel authentication prevents privileged users accessing a queue manager as an IBM MQ MQI client. For verifying the installation, we can either change the MCA user ID to a non-privileged user, or disable channel authentication. To disable channel authentication run the following MQSC command:

   ALTER QMGR CHLAUTH(DISABLED)
   

   When you finish the test, if we do not delete the queue manager, re-enable channel authentication:

   ALTER QMGR CHLAUTH(ENABLED)
   

4. Type some message text, then press Enter twice. The following message is displayed:

   Sample AMQSPUT0 end
   

   Your message is now on the queue that is on the server queue manager.
5. Start the GET program for QUEUE1 on QUEUE.MANAGER.1 by entering the following command:

   ./amqsgetc QUEUE1 QUEUE.MANAGER.1
   

   The sample program starts, and your message is displayed. After a short pause (approximately 30 seconds), the sample ends and the command prompt is displayed again.

Results

We have now successfully verified the client installation.

What to do next

1. We must set various environment variables on the server so that the installation can be used in the current shell. We can set the environment variables by entering the following command:

   .  MQ_INSTALLATION_PATH/bin/setmqenv -s
   

   where MQ_INSTALLATION_PATH refers to the location where IBM MQ is installed.
2. On the server, stop the queue manager by entering the following command:

   endmqm QUEUE.MANAGER.1
   

3. On the server, delete the queue manager by entering the following command:

   dltmqm QUEUE.MANAGER.1
   

Parent topic: Verify a client installation on Linux