If you encounter problems when using the Ensemble adapters to IBM WebSphere MQ, you should first determine whether the client is correctly installed and can communicate with the server. To perform such a test, you can use sample programs that are provided by IBM WebSphere MQ. The executables are in the bin directory of the IBM WebSphere MQ client.
The following steps describe how to use these sample programs on Windows. The details may be different on other operating systems; consult the IBM documentation and check the names of the files present in your client.
Create an environment variable called MQSERVER. Its value should be of the form channel_name/transport/server, where channel_name is the name of the channel to use, transport is a string that indicates the transport to use, and server is the name of the server. For example:S_antigua/TCP/antigua
At the command line, enter the following command:
amqsputc queue_name queue_manager_namewhere queue_name is the name of the queue to use and queue_manager_name is the name of the queue manager. For example:
amqsputc cachetest QM_antiguaIf theamqsputccommand is unrecognized, make sure that the PATH environment variable has been updated to include the bin directory of the IBM WebSphere MQ client.In case of other errors, consult the IBM documentation.
You should see a couple of lines like the following:
Sample AMQSPUT0 start target queue is cachetest
Now you can send messages. Simply type each message and press Enter after each message. For example:
sample message 1 sample message 2
When you are done sending messages, press Enter twice. You will then see a line like the following:
Sample AMQSPUT0 end
To complete this test, we will retrieve the messages you sent to the queue. Type the following command at the command line:
amqsgetc queue_name queue_manager_namewhere queue_name is the name of the queue to use and queue_manager_name is the name of the queue manager. For example:
You should then see a start line, followed by the messages that you sent previously, as follows:
Sample AMQSGET0 start message <sample message 1> message <sample message 2>
This sample program waits briefly to receive any other messages and then displays the following:
no more messages Sample AMQSGET0 end
If the test fails, consult the IBM documentation. Possible causes of problems include the following:
Queue is not defined correctly
Queue manager is not started