IBM MQ Console: Adding a remote queue manager

You can use the IBM® MQ Console to administer a queue manager that is running on a remote system. A remote queue manager can be either a queue manager that is running in a different installation on the same system as the IBM MQ Console, or a queue manager that is running on a different system

About this task

This task covers the steps that are required to prepare the remote queue manager to be administered with the IBM MQ Console. After you complete these steps, you must complete one of the tasks in the what to do next section before the queue manager is ready to be used with the IBM MQ Console.

Note: The steps in this task require you to run MQSC commands:

On AIX®, Linux®, and Windows, you issue MQSC commands from a runmqsc command prompt. See Running MQSC commands interactively under runmqsc and Running MQSC commands from text files under runmqsc. For this task, if you are running on AIX, Linux, and Windows, open a runmqsc command prompt that uses QM1:
```
runmqsc QM1
```
On IBM i, you create a list of commands in a Script file, then run the file by using the STRMQMMQSC command. See Administration using MQSC commands on IBM i.
On z/OS®, MQSC commands can be issued from a number of sources, depending on the command. See Sources from which you can issue MQSC and PCF commands on IBM MQ for z/OS.

Attention: if you receive the following messages:

MQWB2026E: The request to connect to the remote queue manager 'rqmgr-qmgr_name' failed with the error message:
'JMSCC0051: The property 'JMS_IBM_MQMD_AccountingToken' should be set using type '[B', not 'java.lang.Object'.'

you are attempting to pass a java.lang.Object to the accounting token, when a Java object type byte[] is expected.

Procedure

If the mqweb server is not in a stand-alone IBM MQ Web Server installation, ensure that the mqweb server is configured to allow the IBM MQ Console to connect to remote queue managers:
1. Check whether the mqweb server allows remote queue manager connections by entering the following command on the command line:
  dspmqweb properties -u
  If the property mqConsoleRemoteSupportEnabled appears in the output, and the property is set to true, then connections to remote queue managers are allowed.
2. If the mqweb server does not allow remote queue manager connections, enable such connections by entering the following command on the command line:
  setmqweb properties -k mqConsoleRemoteSupportEnabled -v true
On the remote queue manager, create a server-connection channel to allow remote administration of the queue manager by using the DEFINE CHANNEL MQSC command.
For example, to create a server-connection channel QM1.SVRCONN for queue manager QM1, enter the following MQSC command:
```
runmqsc QM1
DEFINE CHANNEL(QM1.SVRCONN) CHLTYPE(SVRCONN) TRPTYPE(TCP)
end
```
For more information about DEFINE CHANNEL and the options available, see DEFINE CHANNEL.
Ensure that appropriate users are authorized to administer the queue manager and objects that are associated with the queue manager.
For more information, see Authorizing users to administer remote queue managers in the IBM MQ Console.
If no listener is running on the remote queue manager, create a listener to accept incoming network connections by using the DEFINE LISTENER MQSC command.
For example, to create a listener REMOTE.LISTENER on port 1414 for remote queue manager QM1, enter the following MQSC command:
```
runmqsc QM1
DEFINE LISTENER(REMOTE.LISTENER) TRPTYPE(TCP) PORT(1414)
end
```
Ensure that the listener is running by using the START LISTENER MQSC command.
For example, on AIX, Linux, and Windows to start the listener REMOTE.LISTENER for queue manager QM1, enter the following MQSC command:
```
runmqsc QM1
START LISTENER(REMOTE.LISTENER)
end
```
For example, on z/OS, to start the listener, enter the following MQSC command:
```
/cpf START LISTENER TRPTYPE(TCP) PORT(1414)
```
The channel initiator address space must be started before you can start a listener on z/OS.

What to do next

Add the remote queue manager to the IBM MQ Console by using one of the following methods: