Installing IBM MQ for IBM i from an Electronic Software Download

We can perform an installation of IBM MQ for IBM i Version 9.0 from an installation image downloaded from IBM.


Before starting

Before starting the installation procedure, make sure that we have completed the necessary steps outlined in Preparing the system on IBM i.


Two installation images are provided as zip files, a client and server image. These images contain all the licensed programs, and a client only image for the clients only.

The client and server image contains all seven compressed IBM i save files ( SAVF ), while the client image contains four save files. The save files are:

  • MQ90BASE - IBM MQ client and server base program objects
  • MQ90SAMP - IBM MQ client & server samples
  • MQ90EN24 - IBM MQ client and server English US (2924) language objects

plus the client only images:

  • MQ90CBASE - IBM MQ client
  • MQ90CSAMP - IBM MQ client samples
  • MQ90JBASE - IBM MQ Java
  • MQ90JSAMP - IBM MQ Java samples


Procedure

  1. Download one of the installation images and extract it to a temporary directory.
  2. On IBM i, create a library containing sufficient empty save files to hold the uploaded files by using the commands: 
    CRTLIB LIB(MQ90PROD)
CRTSAVF FILE(MQ90PROD/MQ90BASE) /* Server and Client */
CRTSAVF FILE(MQ90PROD/MQ90SAMP) /* Server and Client Samples */
CRTSAVF FILE(MQ90PROD/MQ90EN24) /* 2924 English */
CRTSAVF FILE(MQ90PROD/MQ90CBASE) /* Standalone Client */
CRTSAVF FILE(MQ90PROD/MQ90CSAMP) /* Standalone Client Samples */
CRTSAVF FILE(MQ90PROD/MQ90JBASE) /* Java and JMS Classes */
CRTSAVF FILE(MQ90PROD/MQ90JSAMP) /* Java and JMS Samples */
    For additional languages 
    CRTSAVF FILE(MQ90PROD/MQ90EN09) /* 2909 Belgian English */
CRTSAVF FILE(MQ90PROD/MQ90FR28) /* 2928 French */
CRTSAVF FILE(MQ90PROD/MQ90JA30) /* 2930 Japanese */
CRTSAVF FILE(MQ90PROD/MQ90ES31) /* 2931 Spanish */
CRTSAVF FILE(MQ90PROD/MQ90IT32) /* 2932 Italian */
CRTSAVF FILE(MQ90PROD/MQ90EN38) /* 2938 English DBCS UPPERCASE */
CRTSAVF FILE(MQ90PROD/MQ90FR40) /* 2940 French MNCS */
CRTSAVF FILE(MQ90PROD/MQ90IT42) /* 2942 Italian MNCS */
CRTSAVF FILE(MQ90PROD/MQ90FR66) /* 2966 French MNCS */
CRTSAVF FILE(MQ90PROD/MQ90FR81) /* 2981 French MNCS */
CRTSAVF FILE(MQ90PROD/MQ90EN84) /* 2984 English DBCS */
CRTSAVF FILE(MQ90PROD/MQ90CZ75) /* 2975 Czech */
CRTSAVF FILE(MQ90PROD/MQ90HU76) /* 2976 Hungarian */
CRTSAVF FILE(MQ90PROD/MQ90PL78) /* 2978 Polish */
CRTSAVF FILE(MQ90PROD/MQ90RU79) /* 2979 Russian */
CRTSAVF FILE(MQ90PROD/MQ90PT80) /* 2980 Portugese/Brazilian */
CRTSAVF FILE(MQ90PROD/MQ90JA62) /* 2962 Japanese */
CRTSAVF FILE(MQ90PROD/MQ90KO86) /* 2986 Korean */
CRTSAVF FILE(MQ90PROD/MQ90ZH89) /* 2989 Chinese */
CRTSAVF FILE(MQ90PROD/MQ90DE29) /* 2929 German */
CRTSAVF FILE(MQ90PROD/MQ90DE39) /* 2939 German */
  3. Start an ftp session to the IBM i machine and upload the required save files with the commands: 
    ftp (your_ibmi_hostname)
bin
put MQ90BASE MQ90PROD/MQ90BASE
put MQ90SAMP MQ90PROD/MQ90SAMP
put MQ90EN24 MQ90PROD/MQ90EN24
put MQ90CBASE MQ90PROD/MQ90CBASE
put MQ90CSAMP MQ90PROD/MQ90CSAMP
put MQ90JBASE MQ90PROD/MQ90JBASE
put MQ90JSAMP MQ90PROD/MQ90JSAMP
    For additional language loads: 
    put MQ90EN09 MQ90PROD/MQ90EN09
put MQ90FR28 MQ90PROD/MQ90FR28
put MQ90JA30 MQ90PROD/MQ90JA30
put MQ90ES31 MQ90PROD/MQ90ES31
put MQ90IT32 MQ90PROD/MQ90IT32
put MQ90EN38 MQ90PROD/MQ90EN38
put MQ90FR40 MQ90PROD/MQ90FR40
put MQ90IT42 MQ90PROD/MQ90IT42
put MQ90FR66 MQ90PROD/MQ90FR66
put MQ90FR81 MQ90PROD/MQ90FR81
put MQ90EN84 MQ90PROD/MQ90EN84
put MQ90CZ75 MQ90PROD/MQ90CZ75
put MQ90HU76 MQ90PROD/MQ90HU76
put MQ90PL78 MQ90PROD/MQ90PL78
put MQ90RU79 MQ90PROD/MQ90RU79
put MQ90PT80 MQ90PROD/MQ90PT80
put MQ90JA62 MQ90PROD/MQ90JA62
put MQ90KO86 MQ90PROD/MQ90KO86
put MQ90ZH89 MQ90PROD/MQ90ZH89
put MQ90DE29 MQ90PROD/MQ90DE29
put MQ90DE39 MQ90PROD/MQ90DE39
  4. To prepare for installation of IBM MQ for IBM i, sign on to the IBM i machine and ensure that we have followed the instructions detailed in Preparing the system on IBM i.
  5. Enter the RSTLICPGM commands, specifying the installation device as *SAVF and naming the save file containing the options that we want to install. The IBM MQ Java licensed program can be installed stand-alone or can coexist with any of the other licensed programs.

    The IBM MQ client can be installed standalone, but it can only coexist with the IBM MQ Java on the same system.

    Attempting to install the IBM MQ server on a system where the IBM MQ client is already installed performs a slip installation upgrade, replacing the client with the server licensed program.

    Attempting to install the IBM MQ client stand-alone over the top of an existing server licensed program is not possible, and the installation fails.

    For example: 
    /* IBM MQ Client and Server program objects */
RSTLICPGM LICPGM(5724H72) DEV(*SAVF) SAVF(MQ90PROD/MQ90BASE) +
RSTOBJ(*PGM) OPTION(*BASE) OUTPUT(*PRINT)

/* IBM MQ Client & Server English 2924 Language Load */
RSTLICPGM LICPGM(5724H72) DEV(*SAVF) SAVF(MQ90PROD/MQ90EN24) +
RSTOBJ(*LNG) LNG(2924) OUTPUT(*PRINT)

/* Additional languages - alter SAVF and LNG parameters... */
/* IBM MQ Client & Server Japanese 2930 Language Load */
RSTLICPGM LICPGM(5724H72) DEV(*SAVF) SAVF(MQ90PROD/MQ90JA30) +
RSTOBJ(*LNG) LNG(2930) OUTPUT(*PRINT)

/* IBM MQ Client & Server Samples */
RSTLICPGM LICPGM(5724H72) DEV(*SAVF) SAVF(MQ90PROD/MQ90SAMP) +
OPTION(1) OUTPUT(*PRINT)

/* IBM MQ Java */
RSTLICPGM LICPGM(5724L26) DEV(*SAVF) SAVF(MQ90PROD/MQ90JBASE) +
OPTION(*BASE) OUTPUT(*PRINT)

/* IBM MQ Java Samples */
RSTLICPGM LICPGM(5724L26) DEV(*SAVF) SAVF(MQ90PROD/MQ90JSAMP) +
OPTION(1) OUTPUT(*PRINT)

/* IBM MQ Client */
RSTLICPGM LICPGM(5725A49) DEV(*SAVF) SAVF(MQ90PROD/MQ90CBASE) +
OPTION(*BASE) OUTPUT(*PRINT)

/* IBM MQ Client Samples */
RSTLICPGM LICPGM(5725A49) DEV(*SAVF) SAVF(MQ90PROD/MQ90CSAMP) +
OPTION(1) OUTPUT(*PRINT)
  6. 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.


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 fails, see Handling installation failures for IBM i.

Parent topic: Installing IBM MQ server on IBM i