Switching console types on IBM MQ for Multiplatforms

You can choose to continue using the legacy Dashboard Web Console rather than the New Web Console on IBM® MQ for Multiplatforms.

About this task

By default the New Web Console is enabled on multiplatforms. You can switch to using the original web console (now known as the Dashboard Web Console) by editing a setting in the mqwebuser.xml file. On UNIX and Linux®, mqwebuser.xml is located in the directory var/mqm/web/installations/installationName/servers/mqweb. On Windows, mqwebuser.xml is located in the directory MQ_DATA_PATH\web\installations\installationName\servers\mqweb.

Procedure

To switch to using the Dashboard Web Console:
1. In the mqwebuser.xml file, locate the property named mqConsoleEarName.
2. Change the property value to set it to com.ibm.mq.console:
```
<variable name="mqConsoleEarName" value="com.ibm.mq.console"/>
```
To switch back to using the New Web Console:
1. In the mqwebuser.xml file, locate the property named mqConsoleEarName.
2. Change the property value to set it to com.ibm.mq.webconsole:
```
<variable name="mqConsoleEarName" value="com.ibm.mq.webconsole"/>
```

Results

When you enter the web console URL into a browser, the selected type of web console appears.

Note: The only valid values for the mqConsoleEarName property are com.ibm.mq.webconsole and com.ibm.mq.console. Any other value causes the following error:

00000107 com.ibm.ws.app.manager.AppMessageHelper                      W CWWKZ0014W: The application com.ibm.mq.console could not be started as it could not be found at location C:/Program Files/IBM/MQ/web/mq/apps/com.ibm.mq.invalid.ear.