1. How user IDs and passwords are handled is controlled by the ADOPTCTX attribute on the authentication information object. ADOPTCTX(YES) All authorization checks for an application are made with the same user ID that you authenticated by password, by selecting to adopt the context as the application context for the rest of the life of the connection.
  2. Launching IBM MQ Explorer You can launch IBM® MQ Explorer by using one of three methods; by using the system menu, the MQExplorer command, or the strmqcfg command. To launch IBM MQ Explorer by using the system menu on Linux®, or the start menu on Windows, you must left-click on the installation that you want to launch.
  1. Ibm Mq Explorer Macos
  2. Ibm Mq Explorer Documentation
  3. Ibm Mq Explorer

Mq explorer download free. Development Tools downloads - IBM WebSphere MQ Explorer by IBM and many more programs are available for instant and free download.

-->

The MQ connector helps you connect your logic app workflows to an IBM MQ server that's either on premises or in Azure. You can then have your workflows receive and send messages stored in your MQ server. This article provides a get started guide to using the MQ connector by showing how to connect to your MQ server and add an MQ action to your workflow. For example, you can start by browsing a single message in a queue and then try other actions.

This connector includes a Microsoft MQ client that communicates with a remote MQ server across a TCP/IP network. You can connect to the following IBM WebSphere MQ versions:

  • MQ 7.5
  • MQ 8.0
  • MQ 9.0, 9.1, and 9.2

Available operations

The IBM MQ connector provides actions but no triggers.

  • Multi-tenant Azure Logic Apps: When you create a consumption-based logic app workflow, you can connect to an MQ server by using the managed MQ connector.

  • Single-tenant Azure Logic Apps (preview): When you create a preview logic app workflow, you can connect to an MQ server by using either the managed MQ connector or the built-in MQ operations (preview).

For more information about the difference between a managed connector and built-in operations, review key terms in Logic Apps.

Ibm Mq Explorer Macos

The following list describes only some of the managed operations available for MQ:

  • Browse a single message or an array of messages without deleting from the MQ server. For multiple messages, you can specify the maximum number of messages to return per batch. Otherwise, all messages are returned.
  • Delete a single or an array of messages from the MQ server.
  • Receive a single message or an array of messages and then delete from the MQ server.
  • Send a single message to the MQ server.

For all the managed connector operations and other technical information, such as properties, limits, and so on, review the MQ connector's reference page.

The following list describes only some of the built-in operations available for MQ:

Ibm Mq Explorer Documentation

  • Receive a single message or an array of messages from the MQ server. For multiple messages, you can specify the maximum number of messages to return per batch and the maximum batch size in KB.
  • Send a single message or an array of messages to the MQ server.

These built-in MQ operations also have the following capabilities plus the benefits from all the other capabilities for logic apps in the single-tenant Logic Apps service:

  • Transport Layer Security (TLS) encryption for data in transit
  • Message encoding for both the send and receive operations
  • Support for Azure virtual network integration when your logic app uses the Azure Functions Premium plan

Limitations

The MQ connector doesn't use the message's Format field and doesn't make any character set conversions. The connector only puts whatever data appears in the message field into a JSON message and sends the message along.

Prerequisites

IbmIbm Mq Explorer
  • An Azure account and subscription. If you don't have an Azure subscription, sign up for a free Azure account.

  • If you're using an on-premises MQ server, install the on-premises data gateway on a server within your network. For the MQ connector to work, the server with the on-premises data gateway also must have .NET Framework 4.6 installed.

    After you install the gateway, you must also create a data gateway resource in Azure. The MQ connector uses this resource to access your MQ server. For more information, review Set up the data gateway connection.

    Note

    You don't need the gateway in the following scenarios:

    • You're going to use the built-in operations, not the managed connector.
    • Your MQ server is publicly available or available in Azure.
  • The logic app workflow where you want to access your MQ server. Your logic app resource must have the same location as your gateway resource in Azure.

    The MQ connector doesn't have any triggers, so either your workflow must already start with a trigger, or you first have to add a trigger to your workflow. For example, you can use the Recurrence trigger.

    If you're new to Azure Logic Apps, try this quickstart to create an example logic app workflow, which runs in the multi-tenant Logic Apps service.

Create an MQ connection

When you add an MQ action for the first time, you're prompted to create a connection to your MQ server.

Note

The MQ connector currently supports only server authentication, not client authentication.For more information, see Connection and authentication problems.

  1. If you're connecting to an on-premises MQ server, select Connect via on-premises data gateway.

  2. Provide the connection information for your MQ server.

    PropertyOn-premises or AzureDescription
    GatewaysOn-premises onlySelect Connect via on-premises data gateway.
    Connection nameBothThe name to use for your connection
    ServerBothEither of the following values:

    - MQ server host name
    - IP address followed by a colon and the port number

    Queue Manager nameBothThe Queue Manager that you want to use
    Channel nameBothThe channel for connecting to the Queue Manager
    Default queue nameBothThe default name for the queue
    Connect AsBothThe username for connecting to the MQ server
    UsernameBothYour username credential
    PasswordBothYour password credential
    Enable SSL?On-premises onlyUse Transport Layer Security (TLS) or Secure Sockets Layer (SSL)
    Gateway - SubscriptionOn-premises onlyThe Azure subscription associated with your gateway resource in Azure
    Gateway - Connection GatewayOn-premises onlyThe gateway resource to use

    For example:

  3. When you're done, select Create.

  1. Provide the connection information for your MQ server.

    PropertyOn-premises or AzureDescription
    Connection nameBothThe name to use for your connection
    Server nameBothThe MQ server name or IP address
    Port numberBothThe TCP port number for connecting to the Queue Manager on the host
    ChannelBothThe channel for connecting to the Queue Manager
    Queue Manager nameBothThe Queue Manager that you want to use
    Default queue nameBothThe default name for the queue
    Connect AsBothThe username for connecting to the MQ server
    UsernameBothYour username credential
    PasswordBothYour password credential
    Use TLSBothUse Transport Layer Security (TLS)

    For example:

  2. When you're done, select Create.

Add an MQ action

In Azure Logic Apps, an action follows the trigger or another action and performs some operation in your workflow. The following steps describe the general way to add an action, for example, Browse a single message.

  1. In the Logic Apps Designer, open your workflow, if not already open.

  2. Under the trigger or another action, add a new step.

    To add a step between existing steps, move your mouse over the arrow. Select the plus sign (+) that appears, and then select Add an action.

  3. In the operation search box, enter mq. From the actions list, select the action named Browse message.

  4. If you're prompted to create a connection to your MQ server, provide the requested connection information.

  5. In the action, provide the property values that the action needs.

    For more properties, open the Add new parameter list, and select the properties that you want to add.

  6. When you're done, on the designer toolbar, select Save.

  7. To test your workflow, on the designer toolbar, select Run.

    After the run finishes, the designer shows the workflow's run history along with the status for step.

  8. To review the inputs and outputs for each step that ran (not skipped), expand or select the step.

    • To review more input details, select Show raw inputs.
    • To review more output details, select Show raw outputs. If you set IncludeInfo to true, more output is included.

Troubleshoot problems

License

Failures with browse or receive actions

If you run a browse or receive action on an empty queue, the action fails with the following header outputs:

Connection and authentication problems

When your workflow tries connecting to your on-premises MQ server, you might get this error:

'MQ: Could not Connect the Queue Manager '<queue-manager-name>': The Server was expecting an SSL connection.'

  • If you're using the MQ connector directly in Azure, the MQ server needs to use a certificate that's issued by a trusted certificate authority.

  • The MQ server requires that you define the cipher specification to use with TLS connections. However, for security purposes and to include the best security suites, the Windows operating system sends a set of supported cipher specifications.

    The operating system where the MQ server runs chooses the suites to use. To make the configuration match, you have to change your MQ server setup so that the cipher specification matches the option chosen in the TLS negotiation.

    When you try to connect, the MQ server logs an event message that the connection attempt failed because the MQ server chose the incorrect cipher specification. The event message contains the cipher specification that the MQ server chose from the list. In the channel configuration, update the cipher specification to match the cipher specification in the event message.

Connector reference

For all the operations in the managed connector and other technical information, such as properties, limits, and so on, review the MQ connector's reference page.

Next steps

Ibm Mq Explorer

  • Learn about other Logic Apps connectors