Share via


MQ

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