The IBM® MQ client for IBM i is a part of the IBM MQ product.
Before you begin
Note: If you have already installed the IBM MQ Version 8.0 server, you
already have a client and must not attempt to install the stand-alone
client.
You can install only one instance of IBM MQ client for IBM i in each partition
of your server.
When you install
IBM MQ client for
IBM i two user profiles
are created:
These two objects are central to the correct running of
IBM MQ for
IBM i. Do not alter
or delete them. If you do,
IBM cannot
guarantee correct behavior of your product. These profiles are retained
when the product is deleted.
About this task
This procedure covers the installation of both the client and the client samples. If you do not want to install the client samples, then do not complete the steps specific to the samples.
After following the optional step to pre-agree the license, and then issuing the RSTLICPGM command, the installation runs without requiring any interactive input.
Procedure
-
Sign on to the system with a user profile that has *ALLOBJ special authority, for example QSECOFR.
- Optional:
Pre-agree the license terms and conditions. If you do not choose to pre-agree the license, the license agreement is displayed for you to accept. Run the following commands to pre-agree the license terms and conditions:
-
For the client:
CALL PGM ( QSYS/QLPACAGR ) PARM ( '5725A49' 'V8R0M0' '0000' 0 )
The parameters of
PARM are:
5725A49
- The product identifier for IBM MQ client for IBM i
V8R0M0
- The version, release, and modification level
0000
- The option number for the base IBM MQ client for IBM i product
0
- Unused error structure
-
For the client samples:
CALL PGM ( QSYS/QLPACAGR ) PARM ( '5725A49' 'V8R0M0' '0001' 0 )
The parameters of
PARM are:
5725A49
- The product identifier for IBM MQ client for IBM i
V8R0M0
- The version, release, and modification level
0001
- The option number for the samples
0
- Unused error structure
-
Issue the installation command to run the installation without requiring any interactive input:
-
Install the client by issuing the following command:
RSTLICPGM LICPGM ( 5725A49 ) DEV ( install device ) OPTION ( *BASE ) OUTPUT ( *PRINT )
The parameters of
RSTLICPGM are:
-
LICPGM
(
5725A49
)
- The product identifier for IBM MQ client 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
)
- The level of IBM MQ client for IBM i product installed
-
OUTPUT
(
*PRINT
)
- Whether the spooled output of the job is printed
-
Install the samples by issuing the following command:
RSTLICPGM LICPGM ( 5725A49 ) DEV ( install device ) OPTION ( 1 ) OUTPUT ( *PRINT )
The
parameters of
RSTLICPGM are:
LICPGM ( 5725A49 )
- The product identifier for IBM MQ client 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 )
- The samples option
OUTPUT ( *PRINT )
- Whether the spooled output of the job is printed
-
To ensure that the product has loaded correctly, issue the Display Software Resources ( DSPSFWRSC ) command and check that the licensed program
5725A49
is listed. If you have installed the base and the optional samples, you see:
Resource
ID Option Feature Description
5725A49 *BASE 5050 IBM MQ client for IBM i
5725A49 1 5050 IBM MQ client for IBM i -Samples
-
To see the library and version number of the products installed, press F11, while viewing the Display Software Resources screen. The following screen is displayed:
Resource Feature
ID Option Feature Type Library Release
5725A49 *BASE 5050 *CODE QMQM V8R0M0
5725A49 1 5050 *CODE QMQMSAMP V8R0M0
-
To check exactly what version you have installed, use the
DSPMQMVER program.
For example, CALL PGM(QMQM/DSPMQVER)
from the command
line or /QSYS.LIB/QMQM.LIB/DSPMQVER.PGM -a
in a
qshell.
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 client for IBM i failed, see Installation failures for IBM i