Installing IBM MQ server on IBM i

You install IBM® MQ for IBM i by installing the IBM MQ server in its primary language, installing samples and installing additional languages.

1. Sign on to the system with a user profile that has *ALLOBJ special authority, for example QSECOFR.
2. Install the IBM MQ for IBM i base product, and primary language.

   RSTLICPGM LICPGM (5724H72) DEV (installation device) OPTION (*BASE) OUTPUT (*PRINT)
   

   where the parameters of RSTLICPGM are,

   LICPGM(5724H72)

   The product identifier 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)

   Install the IBM MQ for IBM i base product.

   Unspecified parameters

   Unspecified parameters, such as RSTOBJ (*ALL), revert to defaults. The command installs both IBM MQ and the language files for the primary language of your system. For installing additional languages, see step 4.

3. Optional: Install the samples using the command:

   RSTLICPGM LICPGM (5724H72) DEV (installation device) OPTION (1) OUTPUT (*PRINT)
   

   Where the parameters of RSTLICPGM are,

   LICPGM (5724H72)

   The product identifier 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)

   Install the samples for IBM i.

   OUTPUT (*PRINT)

   The output is printed with the spooled output of the job.

4. Optional: Install the AMS component by using the following command:

   RSTLICPGM LICPGM (5724H72) DEV (installation device) OPTION (2) OUTPUT (*PRINT)
   

   Where the parameters of RSTLICPGM are,

   LICPGM (5724H72)

   The product identifier for IBM i.

   DEV (installation device)

   The device from which the product is to be loaded, typically an optical drive, for example, OPT01.

   OPTION (2)

   Install AMS for IBM i.

   OUTPUT (*PRINT)

   The output is printed with the spooled output of the job.

5. Optional: Install the WEB component by using the following command:

   RSTLICPGM LICPGM (5724H72) DEV (installation device) OPTION (3) OUTPUT (*PRINT)
   

   Where the parameters of RSTLICPGM are,

   LICPGM (5724H72)

   The product identifier for IBM i.

   DEV (installation device)

   The device from which the product is to be loaded, typically an optical drive, for example, OPT01.

   OPTION (3)

   Install the WEB component for IBM i.

   OUTPUT (*PRINT)

   The output is printed with the spooled output of the job.

   Note: To use this feature, you must install the following prerequisites:

   • 5724L26 IBM MQ Java Messaging and Web Services
   • 5770JV1 Java SE 8
6. Optional: To install additional languages, sign on to the system with a user profile that has *ALLOBJ special authority. Choose a language code from the table.

   Table 1. Globalizations of IBM MQ for IBM i.

   Language ID	Language
   2909	Belgian English
   2966	Belgian French MNCS (Multi-National Character Set)
   2980	Brazilian Portuguese
   2981	Canadian French MNCS
   2975	Czech
   2924	English uppercase and lowercase
   2984	English US DBCS
   2938	English US uppercase DBCS
   2928	French
   2940	French MNCS
   2929	German
   2939	German MNCS
   2976	Hungarian
   2932	Italian
   2942	Italian MNCS
   2962	Japanese
   2930	Japanese Universal
   2986	Korean
   2978	Polish
   2989	Simplified Chinese
   2931	Spanish

   • If installing Japanese language feature code 2962, ensure the CCSID of the job installing the product is set to 939 and not 930. Do this to avoid problems with invariant lowercase characters in CCSID 930

     CHGJOB CCSID(939)
     

   • If the language feature code is not in the table then the product has not been translated into your language. You must choose one of the available language feature codes and install that version instead. You must manually change the system library list to use IBM MQ in that language load.

     CHGSYSLIBL LIB(QSYS2924)
     

     See also How a language of your choice is displayed for licensed programs in How a language is displayed for IBM i functions in the IBM i product documentation.

   • If you are using Korean DBCS and you configure your terminal emulators to 24*80 sessions you might find that EDTF incorrectly displays DBCS characters in MQ error log messages that extend beyond 80 columns. To avoid this, configure your terminal emulators to use sessions capable of displaying 132 columns, for example 27*132.
   • Issue the following command specifying the appropriate language ID:

     RSTLICPGM LICPGM(5724H72) DEV( installation device ) RSTOBJ(*LNG) LNG( language ID )
     

     This installs the commands, message file, and panel groups into the relevant QSYS library for the language. For example, library QSYS2928 is used for French. If this QSYS29nn library does not exist, it is created by the RSTLICPGM command.
7. To ensure that the product has loaded correctly, issue the Display Software Resources (DSPSFWRSC) command and check that the licensed program 5724H72 is listed. If you have installed the base and the optional samples, you see:

   Resource
   ID       Option Feature Description
   5724H72  *BASE  5050    IBM MQ for IBM i
   5724H72  *BASE  2924    IBM MQ for IBM i
   5724H72  1      5050    IBM MQ for IBM i - Samples
   

8. Press F11, while viewing the Display Software Resources screen, and you see the library and version number of the products installed:

   Resource         Feature
   ID       Option Feature  Type    Library  Release
   5724H72  *BASE  5050     *CODE   QMQM     V9R4M0
   5724H72  *BASE  2924     *LNG    QMQM     V9R4M0
   5724H72  1      5050     *CODE   QMQMSAMP V9R4M0
   

9. If you have installed additional language versions, you also see entries for these versions. For example, if you have installed the French version, for which the language ID is 2928, you see:
   1. 
      

      Resource
      ID       Option Feature Description
      5724H72  *BASE  2928    IBM MQ for IBM i
      

   2. and when you press F11:

      Resource         Feature
      ID       Option Feature  Type    Library   Release
      5724H72  *BASE  2928     *LNG    QSYS2928  V9R4M0
      

10. Use the command DSPMQMVER to check exactly what version you have installed. For V9R4M0 with the latest fix pack applied, it reports:

    Version: 9.4.0.1
    

11. Do the post installation tasks of checking for updates, checking program authorities and starting the IBM MQ subsystem, see Performing post installation tasks for IBM MQ on IBM i.