mqsireload command

Use the mqsireload command to request the integration node to stop, and restart one, or all of the integration servers under an integration node.

Supported platforms

Windows
Linux®
AIX®
IBM® z/OS® Container Extensions (zCX). Run this command by modifying and submitting the supplied JCL or by using an IBM z/OS console command.

Purpose

This command is used to restart one or all integration servers for an integration node.

By default the integration servers do not stop until all message flows within it stop, so the processing time for the longest running message flow affects the performance of this command. Therefore, you must review any long-running message flows before you run this command.

When all integration servers are being reloaded, each integration server is stopped and restarted independently. Therefore, it is possible for one integration server to stop and restart and begin processing messages again, while another integration server is still stopping.

The mqsireload command also allows integration servers to be stopped 'immediately' which does not wait until message flows stop before the integration server is stopped.

If you include a user-defined node or parser within a message flow on the integration node, these resources are deleted by this command, and the relevant termination functions are called. When message flows are restarted, the resources that are used by user-defined nodes and parsers are reaccessed and reacquired. However, it is better programming practice to ensure that user-defined nodes and parsers provide their own mechanism to reload persistent state and data dynamically, and do not rely on this command.

The mqsireload command optionally allows the integration server to be restarted in 'safemode', which causes the applications, or a subset of the applications not to start when the integration server is restarted. When applications are not started due to a safemode restart, their persisted run state before the restart is maintained. Therefore, if you then restart the integration server, or redeploy the application, the application reverts to its run state at before the execution of the mqisreload command. Applications not started due to the safemode setting can also be manually restarted by using the mqsistart command.

If an integration server is already stopped, it is not started by the mqsireload command.

Select the appropriate link for details of this command on the platform, or platforms, that your enterprise uses:

mqsireload command - Windows, Linux, and AIX systems

Authorization

For more information about platform-specific authorizations, see the following topics:

If you enable administration security, you must also set up the authority that is detailed in Tasks and authorizations for administration security.

Responses

No additional responses are returned.