+

Search Tips | Advanced Search

Installing an IBM MQ client on IBM i

The IBM MQ client for IBM i is a part of the IBM MQ product.


Before starting

Attention: If we have already installed the IBM MQ server, you already have a client and must not attempt to install the stand-alone client.

We can install only one instance of IBM MQ client for IBM i in each partition of our server.

When you install IBM MQ client for IBM i two user profiles are created:

  • QMQM
  • QMQMADM

These two objects are central to the correct running of IBM MQ for IBM i. Do not alter or delete them. If you do, IBM cannot guarantee correct behavior of our product. These profiles are retained when the product is deleted.


This procedure covers the installation of both the client and the client samples. If we do not want to install the client samples, then do not complete the steps specific to the samples.

After following the optional step to pre-agree the license, and then issuing the RSTLICPGM command, the installation runs without requiring any interactive input.


Procedure

  1. Sign on to the system with a user profile that has *ALLOBJ special authority, for example QSECOFR.
  2. Optional: Pre-agree the license terms and conditions. If we do not choose to pre-agree the license, the license agreement is displayed for you to accept. Run the following commands to pre-agree the license terms and conditions:
    1. For the client:
      CALL PGM (QSYS/QLPACAGR) PARM ('5725A49' 'V9R1M0' '0000' 0)
      
      The parameters of PARM are:

        5725A49
        The product identifier for IBM MQ client for IBM i

        V9R1M0
        The version, release, and modification level

        0000
        The option number for the base IBM MQ client for IBM i product

        0
        Unused error structure

    2. For the client samples:
      CALL PGM (QSYS/QLPACAGR) PARM ('5725A49' 'V9R1M0' '0001' 0)
      
      The parameters of PARM are:

        5725A49
        The product identifier for IBM MQ client for IBM i

        V9R1M0
        The version, release, and modification level

        0001
        The option number for the samples

        0
        Unused error structure

  3. Issue the installation command to run the installation without requiring any interactive input:
    1. Install the client by issuing the following command:
      RSTLICPGM LICPGM (5725A49) DEV (installation device) OPTION (*BASE) OUTPUT (*PRINT)
      
      The parameters of RSTLICPGM are:

        LICPGM (5725A49)
        The product identifier for IBM MQ client for IBM i

        DEV (installation device)
        The device from which the product is to be loaded, typically an optical drive, for example, OPT01

        OPTION (*BASE)
        The level of IBM MQ client for IBM i product installed

        OUTPUT (*PRINT)
        Whether the spooled output of the job is printed

    2. Install the samples by issuing the following command:
      RSTLICPGM LICPGM (5725A49) DEV (installation device) OPTION (1) OUTPUT (*PRINT)
      
      The parameters of RSTLICPGM are:

        LICPGM (5725A49)
        The product identifier for IBM MQ client for IBM i

        DEV (installation device)
        The device from which the product is to be loaded, typically an optical drive, for example, OPT01

        OPTION (1)
        The samples option

        OUTPUT (*PRINT)
        Whether the spooled output of the job is printed

  4. To ensure that the product has loaded correctly, issue the Display Software Resources ( DSPSFWRSC ) command and check that the licensed program 5725A49 is listed. If we have installed the base and the optional samples, you see:
    Resource
    ID    Option Feature Description
    5725A49  *BASE  5050   IBM MQ client for IBM i
    5725A49  1    5050   IBM MQ client for IBM i -Samples
    
  5. To see the library and version number of the products installed, press F11, while viewing the Display Software Resources screen. The following screen is displayed:
    Resource          Feature
    ID    Option Feature  Type  Library  Release
    5725A49  *BASE  5050   *CODE  QMQM    V9R1M0
    5725A49  1    5050   *CODE  QMQMSAMP  V9R1M0
    
  6. To check exactly what version you have installed, use the DSPMQMVER program. For example, CALL PGM(QMQM/DSPMQVER) from the command line or /QSYS.LIB/QMQM.LIB/DSPMQVER.PGM -a in a qshell.


What to do next

To see how the installation went in more detail, perform one or more of the following tasks:

  • View the log file using the DSPJOBLOG command.
  • View the spoolfile generated from the RSTLICPGM command.

If the installation of IBM MQ client for IBM i failed, see Handling installation failures for IBM i

Parent topic: Install and uninstall IBM MQ on IBM i


Related concepts

Last updated: 2020-10-04