MQ Close

This WebSphere MQ tool executes the MQClose call to relinquish access to an object, and is the opposite of the MQ Open tool. See the MQClose call documentation in your WebSphere MQ Application Programming Guide for more information.

Inputs

Hconn

The connection handle to the Queue Manager. The MQConnect tool generates this connection handle. This value corresponds to the Hconn input parameter in the MQClose call.

Hobj

The handle to the object that is being closed. The object can be of any type. This value corresponds to Hobj in the MQClose call. The MQ Open tool generates Hobj values. On successful completion, the queue manager sets this parameter to a value that is not a valid handle for the environment.

Options

Options that control how the object is closed. You may specify only one option. Valid options are listed in the MQSeries Application Programming Reference guide. This value corresponds to the Options parameter in the MQClose call.

Outputs

Reason Code

For each call, a completion code and a reason code are returned by the queue manager or by an exit routine, to indicate the success or failure of the call. This value corresponds to the Reason code parameter in the MQClose call. The WebSphere MQ Application Programming Guide contains a list of reason codes and their meanings.

Exit Paths

Success

This step takes the Success exit path if the completion code indicates success.

Failure

This step takes the Failure exit path if the completion code indicates failure. The reason for tool failure is contained in the Reason Code parameter.