---
schema_version: "1"
id: 34d1f97edfc1a7d170d7e2020bc5487ff0a1be64583caff1f0ee4171f29c0ea2
title: Using ADMIN.QUEUE to Refresh Connections
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/ibm-mq-connector/latest/ibm-mq-connection-refresh.md
canonical_url: https://docs.mulesoft.com/ibm-mq-connector/latest/ibm-mq-connection-refresh
source_site: docs.mulesoft.com
content_type: documentation
content_hash: e3dee4807a81669b20e36fe2c494bcd4656d13b0aa1dc902a88b632853089378
description: MuleSoft Documentation Site
release: "2.0"
latest: true
---
---
product: IBM MQ Connector
version: 2.0
is-latest-version: true
keywords: jms, ibm mq, connector, publish, administrative, reset, refresh, connection, queue
---

# Using ADMIN.QUEUE to Refresh Connections

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

IBM MQ Connector provides a special administrative queue, `ADMIN.QUEUE`, that allows you to refresh
the connection or reconnect listeners during runtime. This can be useful for maintenance or error
recovery without stopping the Mule application.

## Triggering Connection Refreshes

The `ADMIN.QUEUE` destination can be used within the **Publish** operation to initiate a connection
refresh. This operation helps you dynamically manage connection disruptions and improves the
resilience of your application.

```xml
<flow name="trigger-refresh-flow">
    <ibm-mq:publish config-ref="IBMMQ_Config"
                    destination="ADMIN.QUEUE"
                    destinationType="QUEUE">
        <ibm-mq:message-builder>
            <ibm-mq:text-payload value="Trigger connection refresh"/>
        </ibm-mq:message-builder>
    </ibm-mq:publish>
</flow>
```

## Configuration Requirements

Ensure you have a valid IBM MQ configuration that includes the correct connection details:

```xml
<ibm-mq:config name="IBMMQ_Config">
  <ibm-mq:ibm-mq-connection username="mq_user" password="mq_password">
    <ibm-mq:connection-mode>
      <ibm-mq:client host="your-mq-host" port="1414" queueManager="QM1" channel="YOUR.CHANNEL"/>
    </ibm-mq:connection-mode>
  </ibm-mq:ibm-mq-connection>
</ibm-mq:config>
```

This configuration is referenced in the **Publish** operation that targets the `ADMIN.QUEUE`.

## Important Considerations

- The `ADMIN.QUEUE` is reserved for administrative purposes and must be secured.

- Only trusted users or applications must be allowed to publish messages to this queue.

- Refreshing the connection might temporarily interrupt message processing but helps recover from
  network failures or other runtime issues.

## See Also

- [To Send Messages to Queues](https://docs.mulesoft.com/ibm-mq-connector/latest/ibm-mq-publish)

- [To Listen for New Messages](https://docs.mulesoft.com/ibm-mq-connector/latest/ibm-mq-listener)