Switching between console types

We can switch between the New Web Console (which is the default web console for IBM MQ Version 9.2) and the Dashboard Web Console (which was the web console for earlier versions of IBM MQ).

About this task

You switch between consoles by using the setmqweb command.

If you switch back to using the Dashboard Web Console, consult The Dashboard Web Console in the IBM MQ Version 9.1 documentation. for usage instructions.

To complete this task, we must be a user with certain privileges so that we can use the dspmqweb and setmqweb commands:

• On z/OS, we must have authority to run the dspmqweb and setmqweb commands, and write access to the mqwebuser.xml file.
• On all other operating systems, we must be a privileged user.

Attention:

Before issuing either the setmqweb or dspmqweb commands on z/OS, we must set the WLP_USER_DIR environment variable, so that the variable points to your mqweb server configuration.

To do this, issue the following command:

export WLP_USER_DIR=WLP_user_directory

where WLP_user_directory is the name of the directory that is passed to crtmqweb. For example:

export WLP_USER_DIR=/var/mqm/web/installation1

For more information, see Create the mqweb server.

Procedure

• To switch to the Dashboard Web Console, use the following command:

  setmqweb properties -k mqConsoleEarName -v com.ibm.mq.console

• To revert to the default settings for the mq web server (which includes the New Web Console), use the following command:

  setmqweb properties -r

• To revert to the New Web Console while preserving any other customizations you have made to the mq web server, use the following command:

  setmqweb properties -k mqConsoleEarName -v com.ibm.mq.webconsole

Parent topic: Administration using a web console

Related information

• setmqweb