Performing post installation tasks for IBM MQ on IBM i

Tasks to perform after you have installed IBM MQ for IBM i, and before using it.

When you have correctly installed IBM MQ for IBM i on the system:

Procedure

1. See the IBM MQ website at IBM MQ product page for the latest product information.
2. Install and apply all fix packs.
3. Where you have more than one system and a mixture of releases of OS/400 or IBM i, and IBM MQ, we must take care when compiling CL programs. We must compile CL programs either on the system they are to run on, or on one with an identical combination of releases of OS/400 or IBM i, and IBM MQ. When you install later versions of IBM MQ, delete all IBM MQ commands from previous releases in any QSYSVvRrMm libraries using the QSYS/DLTCMD command.
4. If we have not installed IBM MQ on the system before, we must add user profiles to the QMQMADM group profile. Make all user profiles that are to be used for creating and administering queue managers members of the QMQMADM group profile, using the command CHGUSRPRF.
   1. Start the IBM MQ subsystem, by issuing the command:

      STRSBS SBSD(QMQM/QMQM)
      

      Note: The subsystem must be started after each IPL of the system, so you might choose to start it as part of our system startup process.

5. Create the system-default objects. The system-default objects are created automatically when we issue the CRTMQM command to create a queue manager. For example: CRTMQM MQMNAME(QMGRNAME) ASP(*SYSTEM). We can refresh them using the STRMQM command (Warning: this command will replace any existing default objects). For example: STRMQM MQMNAME(QMGRNAME) RDEFSYS(*YES). Refer to the onscreen help for information about using this command. Note: on the command STRMQM MQMNAME(QMGRNAME) RDEFSYS(*YES):
   • The command does not re-create the objects, it performs a CRTxxxx REPLACE(*YES) for all of the SYSTEM.* objects.
   • This means that it refreshes the parameters on the objects back to their defaults. So if, for example, on the SYSTEM.DEFAULT.LOCAL.QUEUE object, TRGENBL had previously been changed to *YES, then, when the command is run, it is changed back to TRGENBL(*NO).
   • If any messages exist on a queue, they are not removed, because the queues are not physically deleted.
   • The contents of the SYSTEM.AUTH.DATA.QUEUE are untouched when this command is run.
   • So, if the contents of this (or any other significant queue) become corrupt, it must be physically deleted and re-created either from scratch, or from a backup.

Results

You are now ready to start using IBM MQ for IBM i. Note: When you install IBM MQ for IBM i, two user profiles are created:

• QMQM
• QMQMADM

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 our product.

If you uninstall IBM MQ and data, these profiles are deleted. If you uninstall IBM MQ only, these profiles are retained.

Parent topic: Installing IBM MQ server on IBM i