endmqcsv (end command server)
Stop the command server for a queue manager.
Purpose
Use the endmqscv command to stop the command server on the specified queue manager.
We must use the endmqscv command from the installation associated with the queue manager that we are working with. We can find out which installation a queue manager is associated with using the dspmq -o installation command.
If the queue manager attribute, SCMDSERV, is specified as QMGR then changing the state of the command server using endmqscv does not effect how the queue manager acts upon the SCMDSERV attribute at the next restart.
Syntax
Required parameters
- QMgrName
- The name of the queue manager for which to end the command server.
Optional parameters
- -c
- Stops the command server in a controlled manner. The command server can complete the processing of any command message that it has already started. No new message is read from the command queue.
This parameter is the default.
- -i
- Stops the command server immediately. Actions associated with a command message currently being processed might not complete.
Return codes
| Return code | Description |
|---|---|
| 0 | Command completed normally |
| 10 | Command completed with unexpected results |
| 20 | An error occurred during processing |
Examples
- The following command stops the command server on queue manager saturn.queue.manager:
endmqcsv -c saturn.queue.manager
The command server can complete processing any command it has already started before it stops. Any new commands received remain unprocessed in the command queue until the command server is restarted.
- The following command stops the command server on queue manager pluto immediately:
endmqcsv -i pluto
Related commands
| Command | Description |
|---|---|
| strmqcsv | Start a command server |
| dspmqcsv | Display the status of a command server |
Related reference