Manage the command server for remote administration on IBM i

Use this information to learn about the remote administration of IBM MQ for IBM i command server.

Each queue manager can have a command server associated with it. A command server processes any incoming commands from remote queue managers, or PCF commands from applications. It presents the commands to the queue manager for processing and returns a completion code or operator message depending on the origin of the command.

A command server is mandatory for all administration involving PCFs, the MQAI, and also for remote administration.

Note: For remote administration, we must ensure that the target queue manager is running. Otherwise, the messages containing commands cannot leave the queue manager from which they are issued. Instead, these messages are queued in the local transmission queue that serves the remote queue manager. Avoid this situation if at all possible.

There are separate control commands for starting and stopping the command server. We can perform the operations described in the following sections using the IBM MQ Explorer.

Start and stop the command server

To start the command server, use this CL command:

STRMQMCSVR MQMNAME('saturn.queue.manager')

where saturn.queue.manager is the queue manager for which the command server is being started. To stop the command server, use one of the following CL commands:

```
ENDMQMCSVR MQMNAME('saturn.queue.manager') OPTION(*CNTRLD)
```
to perform a controlled stop, where saturn.queue.manager is the queue manager for which the command server is being stopped. This is the default option, which means that the OPTION(*CNTRLD) can be omitted.
```
ENDMQMCSVR MQMNAME('saturn.queue.manager') OPTION(*IMMED)
```
to perform an immediate stop, where saturn.queue.manager is the queue manager for which the command server is being stopped.

Display the status of the command server

For remote administration, ensure that the command server on the target queue manager is running. If it is not running, remote commands cannot be processed. Any messages containing commands are queued in the target queue manager's command queue SYSTEM.ADMIN.COMMAND.QUEUE.

To display the status of the command server for a queue manager, called here saturn.queue.manager, the CL command is:

DSPMQMCSVR MQMNAME('saturn.queue.manager')

Issue this command on the target machine. If the command server is running, the panel shown in Figure 1 appears:

Figure 1. Display MQM Command Server panel

Display MQM Command Server (DSPMQMCSVR)


Queue manager name . . . . . . . > saturn.queue.manager

MQM Command Server Status. . . . > RUNNING







F3=Exit  F4=Prompt  F5=Refresh  F12=Cancel  F13=How to use this display
F24=More keys

Parent topic: Alternative ways of administering IBM MQ for IBM i