Managing 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, you 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.
Starting and stopping 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:
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.
to perform an
immediate stop, where saturn.queue.manager is the queue manager for which the
command server is being stopped.
Displaying 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