Verify a client installation using the command line on AIX

We can verify a client installation using the command line. On the server you create a queue manager, a local queue, a listener, and a server-connection channel. We must also apply security rules to allow the client to connect and make use of the queue defined. On the client you create a client-connection channel, and then use the sample PUT and GET programs to complete the verification procedure.

The verification procedure shows how to create a queue manager called queue.manager.1, a local queue called QUEUE1, and a server-connection channel called CHANNEL1 on the server.

It shows how to create the client-connection channel on the IBM MQ MQI client workstation. It then shows how to use the sample programs to put a message onto a queue, and get the message from the queue.

The example does not address any client security issues. See Set up IBM MQ MQI client security for details if we are concerned with IBM MQ MQI client security issues.

• The full IBM MQ server product has been installed on a server.
• The server installation is accessible on your network.
• The IBM MQ MQI client software has been installed on a client system.
• The IBM MQ sample programs have been installed.
• TCP/IP has been configured on the server and client systems. For more information, see Configure connections between the server and client.

Procedure

1. Set up the server using the command line, using the instructions in Set up the server using the command line on AIX.
2. Set up the client, using the instructions in Connect to a queue manager, using the MQSERVER environment variable on AIX.
3. Test the communications between client and server, using the instructions in Testing communication between a client and a server on AIX.

• Set up the server using the command line on AIX
  Follow these instructions to create a queue manager, queue, and channel on the server. We can then use these objects to verify the installation.
• Connect to a queue manager, using the MQSERVER environment variable on AIX
  When an IBM MQ application is run on the IBM MQ MQI client, it requires the name of the MQI channel, the communication type, and the address of the server to be used. Provide these parameters by defining the MQSERVER environment variable.
• Testing communication between a client and a server on AIX
  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.

Parent topic: Verify an IBM MQ installation on AIX