[IBMi]

IBM MQ for IBM i Electronic Software Download Installation

You can perform an installation of IBM® MQ for IBM i Version 8.0 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.

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:
  • MQ80BASE - IBM MQ client & server base program objects
  • MQ80SAMP - IBM MQ client & server samples
  • MQ80EN24 - IBM MQ client & server English US (2924) language objects
plus the client only images:
  • MQ80CBASE - IBM MQ client
  • MQ80CSAMP - IBM MQ client samples
  • MQ80JBASE - IBM MQ Java
  • MQ80JSAMP - IBM MQ Java samples

Procedure

  1. Download one of the installation images and unzip 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(MQ80PROD)
    CRTSAVF FILE(MQ80PROD/MQ80BASE) /* Server and Client */
    CRTSAVF FILE(MQ80PROD/MQ80SAMP) /* Server and Client Samples */
    CRTSAVF FILE(MQ80PROD/MQ80EN24) /* 2924 English */
    CRTSAVF FILE(MQ80PROD/MQ80CBASE) /* Standalone Client */
    CRTSAVF FILE(MQ80PROD/MQ80CSAMP) /* Standalone Client Samples */
    CRTSAVF FILE(MQ80PROD/MQ80JBASE) /* Java and JMS Classes */
    CRTSAVF FILE(MQ80PROD/MQ80JSAMP) /* Java and JMS Samples */
    
    For additional languages
    CRTSAVF FILE(MQ80PROD/MQ80EN09) /* 2909 Belgian English */
    CRTSAVF FILE(MQ80PROD/MQ80FR28) /* 2928 French */
    CRTSAVF FILE(MQ80PROD/MQ80JA30) /* 2930 Japanese */
    CRTSAVF FILE(MQ80PROD/MQ80ES31) /* 2931 Spanish */
    CRTSAVF FILE(MQ80PROD/MQ80IT32) /* 2932 Italian */
    CRTSAVF FILE(MQ80PROD/MQ80EN38) /* 2938 English DBCS UPPERCASE */
    CRTSAVF FILE(MQ80PROD/MQ80FR40) /* 2940 French MNCS */
    CRTSAVF FILE(MQ80PROD/MQ80IT42) /* 2942 Italian MNCS */
    CRTSAVF FILE(MQ80PROD/MQ80FR66) /* 2966 French MNCS */
    CRTSAVF FILE(MQ80PROD/MQ80FR81) /* 2981 French MNCS */
    CRTSAVF FILE(MQ80PROD/MQ80EN84) /* 2984 English DBCS */
    CRTSAVF FILE(MQ80PROD/MQ80CZ75) /* 2975 Czech */
    CRTSAVF FILE(MQ80PROD/MQ80HU76) /* 2976 Hungarian */
    CRTSAVF FILE(MQ80PROD/MQ80PL78) /* 2978 Polish */
    CRTSAVF FILE(MQ80PROD/MQ80RU79) /* 2979 Russian */
    CRTSAVF FILE(MQ80PROD/MQ80PT80) /* 2980 Portugese/Brazilian */
    CRTSAVF FILE(MQ80PROD/MQ80JA62) /* 2962 Japanese */
    CRTSAVF FILE(MQ80PROD/MQ80KO86) /* 2986 Korean */
    CRTSAVF FILE(MQ80PROD/MQ80ZH89) /* 2989 Chinese */
    CRTSAVF FILE(MQ80PROD/MQ80DE29) /* 2929 German */
    CRTSAVF FILE(MQ80PROD/MQ80DE39) /* 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 MQ80BASE MQ80PROD/MQ80BASE
    put MQ80SAMP MQ80PROD/MQ80SAMP
    put MQ80EN24 MQ80PROD/MQ80EN24
    put MQ80CBASE MQ80PROD/MQ80CBASE
    put MQ80CSAMP MQ80PROD/MQ80CSAMP
    put MQ80JBASE MQ80PROD/MQ80JBASE
    put MQ80JSAMP MQ80PROD/MQ80JSAMP
    
    For additional language loads:
    put MQ80EN09 MQ80PROD/MQ80EN09
    put MQ80FR28 MQ80PROD/MQ80FR28
    put MQ80JA30 MQ80PROD/MQ80JA30
    put MQ80ES31 MQ80PROD/MQ80ES31
    put MQ80IT32 MQ80PROD/MQ80IT32
    put MQ80EN38 MQ80PROD/MQ80EN38
    put MQ80FR40 MQ80PROD/MQ80FR40
    put MQ80IT42 MQ80PROD/MQ80IT42
    put MQ80FR66 MQ80PROD/MQ80FR66
    put MQ80FR81 MQ80PROD/MQ80FR81
    put MQ80EN84 MQ80PROD/MQ80EN84
    put MQ80CZ75 MQ80PROD/MQ80CZ75
    put MQ80HU76 MQ80PROD/MQ80HU76
    put MQ80PL78 MQ80PROD/MQ80PL78
    put MQ80RU79 MQ80PROD/MQ80RU79
    put MQ80PT80 MQ80PROD/MQ80PT80
    put MQ80JA62 MQ80PROD/MQ80JA62
    put MQ80KO86 MQ80PROD/MQ80KO86
    put MQ80ZH89 MQ80PROD/MQ80ZH89
    put MQ80DE29 MQ80PROD/MQ80DE29
    put MQ80DE39 MQ80PROD/MQ80DE39
    
  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
  5. Enter the RSTLICPGM commands, specifying the install 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 standalone 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 install upgrade, replacing the client with the server licensed program.

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

    For example:
    /* IBM MQ Client and Server program objects */
    RSTLICPGM LICPGM(5724H72) DEV(*SAVF) SAVF(MQ80PROD/MQ80BASE) +
    RSTOBJ(*PGM) OPTION(*BASE) OUTPUT(*PRINT)
    
    /* IBM MQ Client & Server English 2924 Language Load */
    RSTLICPGM LICPGM(5724H72) DEV(*SAVF) SAVF(MQ80PROD/MQ80EN24) +
    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(MQ80PROD/MQ80JA30) +
    RSTOBJ(*LNG) LNG(2930) OUTPUT(*PRINT)
    
    /* IBM MQ Client & Server Samples */
    RSTLICPGM LICPGM(5724H72) DEV(*SAVF) SAVF(MQ80PROD/MQ80SAMP) +
    OPTION(1) OUTPUT(*PRINT)
    
    /* IBM MQ Java */
    RSTLICPGM LICPGM(5724L26) DEV(*SAVF) SAVF(MQ80PROD/MQ80JBASE) +
    OPTION(*BASE) OUTPUT(*PRINT)
    
    /* IBM MQ Java Samples */
    RSTLICPGM LICPGM(5724L26) DEV(*SAVF) SAVF(MQ80PROD/MQ80JSAMP) +
    OPTION(1) OUTPUT(*PRINT)
    
    /* IBM MQ Client */
    RSTLICPGM LICPGM(5725A49) DEV(*SAVF) SAVF(MQ80PROD/MQ80CBASE) +
    OPTION(*BASE) OUTPUT(*PRINT)
    
    /* IBM MQ Client Samples */
    RSTLICPGM LICPGM(5725A49) DEV(*SAVF) SAVF(MQ80PROD/MQ80CSAMP) +
    OPTION(1) OUTPUT(*PRINT)
    
  6. Do the post installation tasks of checking for updates, checking program authorities and starting the IBM MQ subsystem, see 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 Installation failures for IBM i.