MQ
![](https://connectoricons-prod.azureedge.net/releases/v1.0.1702/1.0.1702.3810/mq/icon.png)
Microsoft Connector for MQ integrates Azure applications with resources stored in an IBM WebSphere MQ server. Supports message send and receive operations.
This connector is available in the following products and regions:
Service | Class | Regions |
---|---|---|
Logic Apps | Enterprise | All Logic Apps regions and Integration Service Environments (ISEs) except the following: - US Department of Defense (DoD) |
Contact | |
---|---|
Name | Microsoft |
URL | Microsoft LogicApps Support |
Connector Metadata | |
---|---|
Publisher | Microsoft |
Website | https://www.ibm.com/products/mq |
Privacy policy | https://www.ibm.com/privacy/us/en/?lnk=flg-priv-usen |
Creating a connection
The connector supports the following authentication types:
Default | Parameters for creating connection. | All regions | Shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is shareable connection. If the power app is shared with another user, connection is shared as well. For more information, please see the Connectors overview for canvas apps - Power Apps | Microsoft Docs
Name | Type | Description | Required |
---|---|---|---|
Server | string | The host name and port the MQ server is running on (host:port). | True |
Queue Manager name | string | The name of the Queue Manager to connect to. | True |
Channel name | string | The channel to connect to the Queue Manager on. | True |
Default queue name | string | The name of the default queue, may be overriden. | True |
Connect As | string | The user name to use when connecting to MQ. | True |
Authentication | string | Authentication type to connect to your Queue Manager | True |
Username | securestring | Username credential | |
Password | securestring | Password credential | |
Enable SSL? | bool | Enable SSL? (True/False) | |
Gateway | gatewaySetting | On-prem gateway (see https://docs.microsoft.com/data-integration/gateway for more details |
Throttling Limits
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
Actions
Browse message |
Browse one message from the queue. |
Browse message (v2) (Preview) |
Browse one message from the queue. |
Browse messages |
Browse messages in a queue. |
Browse messages (v2) (Preview) |
Browse messages in a queue. |
Delete message |
Deletes one message from the queue, by doing a destructive get. |
Delete message (v2) (Preview) |
Deletes one message from the queue, by doing a destructive get. |
Delete messages |
Deletes messages from the queue, by doing a destructive get. |
Delete messages (v2) (Preview) |
Deletes messages from the queue, by doing a destructive get. |
Receive message |
Returns one message from the queue, by doing a destructive get. |
Receive message (v2) (Preview) |
Returns one message from the queue, by doing a destructive get. |
Receive messages |
Returns messages from the queue, by doing a destructive get. |
Receive messages (v2) (Preview) |
Returns messages from the queue, by doing a destructive get. |
Send message |
Send a message to a queue. |
Send message (v2) (Preview) |
Send a message to a queue. |
Browse message
Browse one message from the queue.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
Returns
- Body
- Item
Browse message (v2) (Preview)
Browse one message from the queue.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
Returns
- Body
- Item
Browse messages
Browse messages in a queue.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
|
BatchSize
|
BatchSize | integer |
Maximum number of messages to be retrieved from the queue. |
Returns
- Body
- ItemsList
Browse messages (v2) (Preview)
Browse messages in a queue.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
|
BatchSize
|
BatchSize | integer |
Maximum number of messages to be retrieved from the queue. |
Returns
- Body
- ItemsList
Delete message
Deletes one message from the queue, by doing a destructive get.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
Returns
- Body
- Item
Delete message (v2) (Preview)
Deletes one message from the queue, by doing a destructive get.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
Returns
- Body
- Item
Delete messages
Deletes messages from the queue, by doing a destructive get.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
|
BatchSize
|
BatchSize | integer |
Maximum number of messages to be retrieved from the queue. |
Returns
- Body
- ItemsList
Delete messages (v2) (Preview)
Deletes messages from the queue, by doing a destructive get.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
|
BatchSize
|
BatchSize | integer |
Maximum number of messages to be retrieved from the queue. |
Returns
- Body
- ItemsList
Receive message
Returns one message from the queue, by doing a destructive get.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
Returns
- Body
- Item
Receive message (v2) (Preview)
Returns one message from the queue, by doing a destructive get.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
Returns
- Body
- Item
Receive messages
Returns messages from the queue, by doing a destructive get.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
|
BatchSize
|
BatchSize | integer |
Maximum number of messages to be retrieved from the queue. |
Returns
- Body
- ItemsList
Receive messages (v2) (Preview)
Returns messages from the queue, by doing a destructive get.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
GroupId
|
GroupId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageToken
|
MessageToken | string |
Base64 string that represents a byte array with 16 bytes. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
LogicalSequenceNumber
|
LogicalSequenceNumber | integer |
Sequence number of a logical message within a group. |
|
IncludeInfo
|
IncludeInfo | string |
Indicates if additional message info should be included. Expects true or false. |
|
Timeout
|
Timeout | time |
Wait time for a message to appear in the queue, expects an XML duration or hh:mm:ss. |
|
BatchSize
|
BatchSize | integer |
Maximum number of messages to be retrieved from the queue. |
Returns
- Body
- ItemsList
Send message
Send a message to a queue.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
Message
|
Message | True | string |
Message data |
MessageType
|
MessageType | string |
Message type |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
ReplyToQueue
|
ReplyToQueue | string |
Reply-to queue |
|
ReplyToQueueManager
|
ReplyToQueueManager | string |
Reply-to queue manager |
|
CodeCharSetId
|
CodeCharSetId | integer |
Character set for the message. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
Format
|
Format | string |
Format field for the message. |
Returns
Name | Path | Type | Description |
---|---|---|---|
MessageData
|
MessageData | string | |
MessageId
|
MessageId | string | |
CorrelationId
|
CorrelationId | string |
Send message (v2) (Preview)
Send a message to a queue.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Queue
|
Queue | string |
When specified, overrides the queue defined in the connection. |
|
Message
|
Message | True | string |
Message data |
MessageType
|
MessageType | string |
Message type |
|
CorrelationId
|
CorrelationId | string |
Base64 string that represents a byte array with 24 bytes. |
|
MessageId
|
MessageId | string |
Base64 string that represents a byte array with 24 bytes. |
|
ReplyToQueue
|
ReplyToQueue | string |
Reply-to queue |
|
ReplyToQueueManager
|
ReplyToQueueManager | string |
Reply-to queue manager |
|
CodeCharSetId
|
CodeCharSetId | integer |
Character set for the message. |
|
Offset
|
Offset | integer |
Offset in bytes of the data in the physical message from the start of the logical message. |
|
Format
|
Format | string |
Format field for the message. |
Returns
Name | Path | Type | Description |
---|---|---|---|
MessageData
|
MessageData | string | |
MessageId
|
MessageId | string | |
CorrelationId
|
CorrelationId | string |
Definitions
Item
Name | Path | Type | Description |
---|---|---|---|
MessageData
|
MessageData | string | |
MessageId
|
MessageId | string | |
CorrelationId
|
CorrelationId | string | |
PutDateTime
|
PutDateTime | date-time | |
UserIdentifier
|
UserIdentifier | string | |
PutApplicationName
|
PutApplicationName | string | |
PutApplicationType
|
PutApplicationType | string | |
Format
|
Format | string | |
AccountingToken
|
AccountingToken | byte | |
Ccsid
|
Ccsid | integer | |
GroupId
|
GroupId | string | |
LogicalSequenceNumber
|
LogicalSequenceNumber | integer | |
MessageType
|
MessageType | string | |
Offset
|
Offset | integer | |
OriginalLength
|
OriginalLength | integer | |
Persistence
|
Persistence | string | |
Priority
|
Priority | integer | |
ReplyToQueue
|
ReplyToQueue | string | |
ReplyToQueueManager
|
ReplyToQueueManager | string |
ItemsList
Name | Path | Type | Description |
---|---|---|---|
value
|
value | array of Item |