mqsistop command - Windows, Linux, and AIX systems
Use the mqsistop command to stop the specified integration node, or integration servers that are managed by an integration node. The command can also be used to stop any components that are deployed to either an integration server that is managed by an integration node, or to an independent integration server.
Purpose
The mqsistop command stops an integration node that is running. It does not stop a queue manager that is associated with the integration node. To stop the associated queue manager, use the command line. For more information, see the topics on starting and stopping a queue manager in the IBM® MQ documentation.
Depending on which parameters you specify with the command, you can stop one, or all of the integration servers, applications or message flows under the integration node.
An integration node cannot be stopped by using the mqsistop command with the -n | --integration-node-file parameter. This syntax can be used only to stop components under the integration node, for example an integration server. To stop an integration node, use the mqsistop command with the integrationNodeName parameter.
Syntax
Some parameters have alternative long names; for example, -e and --integration-server are alternative parameter names of the integration server. The long names available are listed in the Parameters section.
Syntax for use with integration nodes
Syntax for use with independent integration servers
Parameters
- integrationNodeName
- (Required) Specify the name of the integration node that you want to stop.
On Linux® and AIX® systems, all names are case-sensitive.
- -s | --admin-host hostname -p | --admin-port port
- Specify the hostname and port of the independent integration server where the
components that you want to stop are deployed.
On Linux and AIX systems, all names are case-sensitive.
- -n | --integration-node-file filename
-
File containing integration node connection parameters (*.broker)
Other parameters:
- -e | --integration-server integration server name
- (Optional) Specify the name of the integration server that you want to stop.
On Linux and AIX systems, all names are case-sensitive.
- --all-integration-servers
-
(Optional) Indicates all integration servers under the specified integration node.
- -k | --application application name
-
(Optional) Name of an application that is deployed to the specified integration server.
- --all-applications
-
(Optional) Indicates all applications that are deployed to the specified integration server.
- -y | --librarylibrary
-
(Optional) Static library name.
- -f | --flow messageflow
-
(Optional) message flow name.
- --all-flows
-
(Optional) Indicates all message flows.
- --timeout-seconds -w
-
(Optional) The number of seconds before the action is aborted.
- --immediate
-
(Optional) Indicates to the integration node to shut down immediately. Specify this flag only if you previously tried, and failed, to stop the integration node in a controlled fashion by using the mqsistop command without the --immediate flag.
- --detail-level
- This parameter controls the detail level of response messages.
- 0 = display summary information
- 1 = display standard information (default)
- 2 = display detailed information
Responses
- BIP8012 Unable to connect to system components.
- BIP8013 Component does not exist.
- BIP8016 Component cannot be stopped.
- BIP8030 Unable to modify user privileges.
- BIP8071 Command successfully completed
Examples
mqsistop IBNODE
mqsistop INODE -e intServer
mqsistop INODE --all-integration-servers
mqsistop INODE -e intServer -k testApp
mqsistop INODE -e intServer -k testApp -f testFlow
mqsistop --admin-host localhost --admin-port 7600 --application testApp
mqsistop --admin-host localhost --admin-port 7600 --application testApp --flow testFlow