mqsireload command

Supported platforms

  • Windows 2000, Windows XP
  • UNIX platforms
  • 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 plug-in 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 these nodes and parsers are re-accessed and reacquired. However, you are recommended to ensure that user-written plug-in 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 and UNIX platforms

z/OS

Synonym: re

Parameters

brokername
(Required - Windows platforms and UNIX platforms) 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 domain

Related tasks
Deleting a broker

Related reference
Syntax preference
mqsicreatebroker command
mqsichangebroker command