Verify a local server installation using the command line on Windows

On Windows 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

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 Windows.

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. 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.

2. 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.
3. Start the queue manager by entering the following command:

   strmqm QMA
   

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

   runmqsc QMA
   

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

   DEFINE QLOCAL (QUEUE1)
   

   A message indicates when the queue is created.
6. 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.

7. Put a message on the queue by entering the following command:

   amqsput QUEUE1 QMA
   

   The following messages are shown:

   Sample AMQSPUT0 start
   target queue is QUEUE1
   

8. 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.
9. Get the messages from the queue, by entering the following command:

   amqsget QUEUE1 QMA
   

   The sample program starts, and your messages are displayed.

Results