Non-interactive installation of IBM MQ server on IBM i
You can perform a non-interactive installation of IBM® MQ using the CALL PGM(QSYS/QLPACAGR)
command. A non-interactive installation is also known as a silent, or unattended installation.
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
Procedure
-
Pre-agree the license terms and conditions for the base by running the command,
Where the parameters of PARM are,CALL PGM ( QSYS/QLPACAGR ) PARM ( '5724H72' 'V8R0M0' '0000' 0 )
5724H72
- The product identifier for IBM MQ for IBM i.
V8R0M0
- The version, release, and modification level.
0000
- The option number for the IBM MQ product.
0
- Unused error structure.
-
Optionally pre-agree the license terms and conditions for the samples by running the command,
Where the parameters of PARM are,CALL PGM ( QSYS/QLPACAGR ) PARM ( '5724H72' 'V8R0M0' '0001' 0 )
5724H72
- The product identifier for IBM MQ for IBM i.
V8R0M0
- The version, release, and modification level.
0001
- The option number for the IBM MQ product.
0
- Unused error structure.
-
Install the IBM MQ for IBM i base product, and primary
language.
where the parameters of RSTLICPGM are,RSTLICPGM LICPGM ( 5724H72 ) DEV ( install device ) OPTION ( *BASE ) OUTPUT ( *PRINT )
LICPGM ( 5724H72 )
- The product identifier for IBM MQ for IBM i.
DEV ( install 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.
- Optional:
Install the samples using the command:
Where the parameters of RSTLICPGM are,RSTLICPGM LICPGM ( 5724H72 ) DEV ( install device ) OPTION ( 1 ) OUTPUT ( *PRINT )
LICPGM ( 5724H72 )
- The product identifier for IBM MQ for IBM i.
DEV ( install 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 MQ for IBM i.
OUTPUT ( *PRINT )
- The output is printed with the spooled output of the job.
- 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) 2981 Canadian French MNCS 2975 Czech 2950 English uppercase 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 2986 Korean 2978 Polish 2979 Russian 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:
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.RSTLICPGM LICPGM(5724H72) DEV( install device ) RSTOBJ(*LNG) LNG( language ID )
- 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
-
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
-
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 V8R0M0 5724H72 *BASE 2924 *LNG QMQM V8R0M0 5724H72 1 5050 *CODE QMQMSAMP V8R0M0
-
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:
-
Resource ID Option Feature Description 5724H72 *BASE 2928 IBM MQ for IBM i
-
and when you press F11:
Resource Feature ID Option Feature Type Library Release 5724H72 *BASE 2928 *LNG QSYS2928 V8R0M0
-
-
Use the command DSPMQMVER to check exactly what version you have installed. For V8R0M0, it reports:
Version: 8.0.0.0
- 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.