copyright | lastupdated | ||
---|---|---|---|
|
2017-02-01 |
{:new_window: target="_blank"} {:shortdesc: .shortdesc} {:screen: .screen} {:codeblock: .codeblock} {:pre: .pre}
{: #mql_exist_apps}
You can connect existing applications that currently run against either {{site.data.keyword.IBM_notm}} MQ or the {{site.data.keyword.mql}} {{site.data.keyword.Bluemix_notm}} service to the service. The apps continue to work in the same way. {:shortdesc}
To connect existing apps, complete the following checks:
-
Ensure that the app is using the latest available {{site.data.keyword.mql}} API client version for your language.
-
Check that the connection details extracted from VCAP_SERVICES reference the
messagehub
service type and retrieve the connections user name from thecredentials.user
property rather than thecredentials.username
property, and retrieve the connection lookup URL from thecredentials.mqlight_lookup_url
property rather than thecredentials.connectionLookupURI
property. For more information, see VCAP_SERVICES environment variable.Note that this step is done for you if you use the Java™ client and specify 'null' as the endpointService parameter in the create() call, so that the client retrieves the information itself.
-
Your app must support TLS v1.2 connections. VCAP_SERVICES no longer contains a
credentials.nonTLSConnectionLookupURI
property for creating a non-TLS connection.
You should also note the following information:
- Message limits are consistent with {{site.data.keyword.messagehub}} but might be different from other servers supporting the {{site.data.keyword.mql}} API. For more information, see Maximum limits.
- JMS is not supported.
- You can have only one {{site.data.keyword.messagehub}} instance for each {{site.data.keyword.Bluemix_notm}} space.