mqsireload command

Supported platforms

  • Windows
  • Linux and UNIX systems
  • z/OS

Purpose

Use the mqsireload command to request the broker to stop and restart execution groups.

When you issue this command, a message is sent to the broker, which stops and restarts all its execution groups. You can specify a single execution group to be reloaded, but you are recommended to use the default form of this command to reload all execution groups.

Because an execution group does not stop until all message flows within it terminates, the ability of the broker to reload quickly depends on the processing time for the longest running message flow. This affects the performance of this command, and you are recommended to review any long-running message flows.

If you have included a user-defined node or parser within a message flow on the broker, these are deleted by this command, and the relevant termination functions called. When message flows are restarted, the resources used by user-defined nodes and parsers are re-accessed and reacquired. However, you are recommended to ensure that user-defined nodes and parsers provide their own mechanism to reload persistent state and data dynamically, and do not rely on the use of this command.

Syntax

Windows platforms, Linux and UNIX systems

z/OS

Synonym: re

Parameters

brokername
(Required - Windows platforms, Linux, and UNIX systems) The name of the broker to which the reload request is sent.
-e egroup
(Optional) The name of the execution group that is to be reloaded. If this parameter is not specified, all execution groups on the specified broker are stopped and restarted.

Authorization

The user ID used to issue the command must be a member of the group mqbrkrs.

Responses

No additional responses are returned.

Examples

Windows platforms and UNIX platforms:
mqsireload broker1 
z/OS:
F MQP1BRK,re
Related concepts
Broker domains
Related tasks
Deleting a broker