[IBM i]

Installing IBM MQ for IBM i from a downloaded installation image

You can perform an installation of IBM® MQ for IBM i from an installation image downloaded from IBM.

Before you begin

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

About this task

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:
  • MQ92BASE - IBM MQ client and server base program objects
  • MQ92SAMP - IBM MQ client & server samples
  • MQ92EN24 - IBM MQ client and server English US (2924) language objects
plus the client only images:
  • MQ92CBASE - IBM MQ client
  • MQ92CSAMP - IBM MQ client samples
  • MQ92JBASE - IBM MQ Java
  • MQ92JSAMP - 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(MQ92PROD)
    CRTSAVF FILE(MQ92PROD/MQ92BASE) /* Server and Client */
    CRTSAVF FILE(MQ92PROD/MQ92SAMP) /* Server and Client Samples */
    CRTSAVF FILE(MQ92PROD/MQ92EN24) /* 2924 English */
    CRTSAVF FILE(MQ92PROD/MQ92CBASE) /* Standalone Client */
    CRTSAVF FILE(MQ92PROD/MQ92CSAMP) /* Standalone Client Samples */
    CRTSAVF FILE(MQ92PROD/MQ92JBASE) /* Java and JMS Classes */
    CRTSAVF FILE(MQ92PROD/MQ92JSAMP) /* Java and JMS Samples */
    
    For additional languages
    CRTSAVF FILE(MQ92PROD/MQ92EN09) /* 2929 Belgian English */
    CRTSAVF FILE(MQ92PROD/MQ92FR28) /* 2928 French */
    CRTSAVF FILE(MQ92PROD/MQ92JA30) /* 2930 Japanese */
    CRTSAVF FILE(MQ92PROD/MQ92ES31) /* 2931 Spanish */
    CRTSAVF FILE(MQ92PROD/MQ92IT32) /* 2932 Italian */
    CRTSAVF FILE(MQ92PROD/MQ92EN38) /* 2938 English DBCS UPPERCASE */
    CRTSAVF FILE(MQ92PROD/MQ92FR40) /* 2940 French MNCS */
    CRTSAVF FILE(MQ92PROD/MQ92IT42) /* 2942 Italian MNCS */
    CRTSAVF FILE(MQ92PROD/MQ92FR66) /* 2966 French MNCS */
    CRTSAVF FILE(MQ92PROD/MQ92FR81) /* 2981 French MNCS */
    CRTSAVF FILE(MQ92PROD/MQ92EN84) /* 2984 English DBCS */
    CRTSAVF FILE(MQ92PROD/MQ92CZ75) /* 2975 Czech */
    CRTSAVF FILE(MQ92PROD/MQ92HU76) /* 2976 Hungarian */
    CRTSAVF FILE(MQ92PROD/MQ92PL78) /* 2978 Polish */
    CRTSAVF FILE(MQ92PROD/MQ92PT80) /* 2980 Portugese/Brazilian */
    CRTSAVF FILE(MQ92PROD/MQ92JA62) /* 2962 Japanese */
    CRTSAVF FILE(MQ92PROD/MQ92KO86) /* 2986 Korean */
    CRTSAVF FILE(MQ92PROD/MQ92ZH89) /* 2989 Chinese */
    CRTSAVF FILE(MQ92PROD/MQ92DE29) /* 2929 German */
    CRTSAVF FILE(MQ92PROD/MQ92DE39) /* 2939 German */
    
  3. Start an ftp session to your IBM i machine and upload the required save files with the commands:
    ftp (your_ibmi_hostname)
    bin
    put MQ92BASE MQ92PROD/MQ92BASE
    put MQ92SAMP MQ92PROD/MQ92SAMP
    put MQ92EN24 MQ92PROD/MQ92EN24
    put MQ92CBASE MQ92PROD/MQ92CBASE
    put MQ92CSAMP MQ92PROD/MQ92CSAMP
    put MQ92JBASE MQ92PROD/MQ92JBASE
    put MQ92JSAMP MQ92PROD/MQ92JSAMP
    
    For additional language loads:
    put MQ92EN09 MQ92PROD/MQ92EN09
    put MQ92FR28 MQ92PROD/MQ92FR28
    put MQ92JA30 MQ92PROD/MQ92JA30
    put MQ92ES31 MQ92PROD/MQ92ES31
    put MQ92IT32 MQ92PROD/MQ92IT32
    put MQ92EN38 MQ92PROD/MQ92EN38
    put MQ92FR40 MQ92PROD/MQ92FR40
    put MQ92IT42 MQ92PROD/MQ92IT42
    put MQ92FR66 MQ92PROD/MQ92FR66
    put MQ92FR81 MQ92PROD/MQ92FR81
    put MQ92EN84 MQ92PROD/MQ92EN84
    put MQ92CZ75 MQ92PROD/MQ92CZ75
    put MQ92HU76 MQ92PROD/MQ92HU76
    put MQ92PL78 MQ92PROD/MQ92PL78
    put MQ92RU79 MQ92PROD/MQ92RU79
    put MQ92PT80 MQ92PROD/MQ92PT80
    put MQ92JA62 MQ92PROD/MQ92JA62
    put MQ92KO86 MQ92PROD/MQ92KO86
    put MQ92ZH89 MQ92PROD/MQ92ZH89
    put MQ92DE29 MQ92PROD/MQ92DE29
    put MQ92DE39 MQ92PROD/MQ92DE39
    
  4. To prepare for installation of IBM MQ for IBM i, sign on to your IBM i machine and ensure that you 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 you 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(MQ92PROD/MQ92BASE) +
    RSTOBJ(*PGM) OPTION(*BASE) OUTPUT(*PRINT)
    
    /* IBM MQ Client & Server English 2924 Language Load */
    RSTLICPGM LICPGM(5724H72) DEV(*SAVF) SAVF(MQ92PROD/MQ92EN24) +
    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(MQ92PROD/MQ92JA30) +
    RSTOBJ(*LNG) LNG(2930) OUTPUT(*PRINT)
    
    /* IBM MQ Client & Server Samples */
    RSTLICPGM LICPGM(5724H72) DEV(*SAVF) SAVF(MQ92PROD/MQ92SAMP) +
    OPTION(1) OUTPUT(*PRINT)
    
    /* IBM MQ Java */
    RSTLICPGM LICPGM(5724L26) DEV(*SAVF) SAVF(MQ92PROD/MQ92JBASE) +
    OPTION(*BASE) OUTPUT(*PRINT)
    
    /* IBM MQ Java Samples */
    RSTLICPGM LICPGM(5724L26) DEV(*SAVF) SAVF(MQ92PROD/MQ92JSAMP) +
    OPTION(1) OUTPUT(*PRINT)
    
    /* IBM MQ Client */
    RSTLICPGM LICPGM(5725A49) DEV(*SAVF) SAVF(MQ92PROD/MQ92CBASE) +
    OPTION(*BASE) OUTPUT(*PRINT)
    
    /* IBM MQ Client Samples */
    RSTLICPGM LICPGM(5725A49) DEV(*SAVF) SAVF(MQ92PROD/MQ92CSAMP) +
    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

If you want 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.