How to get the agent to monitor (qpmon) and display a queue manager (qpcfg)

If error messages are displayed that indicate dlopen failed: libmqm.so, and WebSphere MQ queue managers cannot be displayed (qpcfg) or monitored (qpmon), this refers to the agent being unable to monitor (qpmon) and to display a queue manager (qpcfg). This is due to the LD_LIBRARY_PATH or LIBPATH (depending on the platform) not being configured to point the MQ Monitoring and the MQ Configuration extensions (qpmon and qpcfg) to the WebSphere MQ libraries, and no links to the MQ libraries have been created in the default places (/usr/bin, /usr/lib, ...).

Error messages such as these will be seen in the logs:

qpcfg.log:
Mon Jun 29 17:05:14.622 2015:dynaload.c(46)[1]:logLevel:8320-4151658176:load_library (libmqm.so) dlopen failed: libmqm.so: cannot open shared object file: No such file or directory.

qpmon.log:
Tue Jun 30 10:38:51.742 2015:dynaload.c(46)[1]:logLevel:22052-4151297728:load_library (libmqm.so) dlopen failed: libmqm.so: cannot open shared object file: No such file or directory.

To resolve this issue, make one of the installations (preferably the one with the highest MQ version) a primary installation by running the following WebSphere MQ command:

/opt/mqm/bin/setmqinst -i -p /opt/mqm

For further information on when and how to run the setmqinst command, consult the IBM WebSphere MQ documentation.