Verify a local server installation using the command line on Linux

On Linux systems, we can verify a local installation by using the command line to create a simple configuration of one queue manager and one queue.

Before starting

To verify the installation, we must first install the samples package.

Before beginning the verification procedure, you might want to check that we have the latest fixes for the system. For more information about where to find the latest updates, see Check requirements on Linux.

About this task

Use the following steps to configure your default queue manager from the command line. After the queue manager is configured, use the amqsput sample program to put a message on the queue. You then use the amqsget sample program to get the message back from the queue.

IBM MQ object definitions are case-sensitive. Any 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.

Procedure

1. On a Linux system, log in as a user in the mqm group.
2. Set up the environment:
   1. Set up environment variables for use with a particular installation 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. Check that the environment is set up correctly by entering the following command:

      dspmqver
      

      If the command completes successfully, and the expected version number and installation name are returned, the environment is set up correctly.

3. Create a queue manager called QMA by entering the following command:

   crtmqm QMA
   

   Messages indicate when the queue manager is created, and when the default IBM MQ objects are created.
4. Start the queue manager by entering the following command:

   strmqm QMA
   

   A message indicates when the queue manager starts.
5. Start MQSC by entering the following command:

   runmqsc QMA
   

   A message indicates when MQSC starts. MQSC has no command prompt.
6. Define a local queue called QUEUE1 by entering the following command:

   DEFINE QLOCAL (QUEUE1)
   

   A message indicates when the queue is created.
7. Stop MQSC by entering the following command:

   end
   

   Messages are shown, followed by the command prompt.

Note: Subsequent steps require that the samples package is installed.

8. Change into 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.
9. Put a message on the queue by entering the following commands

   ./amqsput QUEUE1 QMA
   

   The following messages are shown:

   Sample AMQSPUT0 start
   target queue is QUEUE1
   

10. Type some message text on one or more lines, where each line is a different message. Enter a blank line to end the message input. The following message is shown:

    Sample AMQSPUT0 end
    

    Your messages are now on the queue and the command prompt is shown.
11. Get the messages from the queue, by entering the following command:

    ./amqsget QUEUE1 QMA
    

    The sample program starts, and your messages are displayed.

Results

We have successfully verified your local installation. Parent topic: Verify an IBM MQ installation on Linux