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
-
Download one of the installation images and extract it to a temporary directory.
-
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 */
-
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
-
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.
-
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)
-
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.