MQ Connect

This WebSphere MQ tool executes the MQCONN call to connect an application program to a queue manager. MQ Connect provides a queue manager connection handle (Hconn), which is used by other MQSeries tools. See the MQCONN call documentation in your WebSphere MQ Application Programming Guide for more information.

Inputs

QMgrName

Name of queue manager. The name specified must be the name of a connectable queue manager. See the QMgrName parameter documentation in the MQSeries Application Programming Reference guide for syntax guidelines.

ConnectOptions (MQCNO)

An integer input parameter used with the MQCNO structure. This parameter is specific to the Options field during an MQCONNX connect operation, and defaults to 64.

If MQCNO_NONE is specified as input, the tool uses the MQCONN call to connect an application to a queue manager. Otherwise, it uses the MQCONNX call.

The following table lists the connect option fields in MQCNO:

Field	Description	Topic
StrucId	Structure identifier	StrucId
Version	Structure version number	Version
Options	Options that control the action of MQCONNX	Options

The Options field in an MQCNO structure is of type MQLONG and corresponds to an integer in Interaction Designer. For more information about MQCNO options, see the WebSphere MQ documentation on IBM's Knowledge Center at: https://www.ibm.com/support/knowledgecenter/SSFKSJ_7.0.1/com.ibm.mq.helphome.v70.doc/WelcomePagev7r0.htm

Use connection cache

Select this check box to use connection caching.

Outputs

Hconn

The connection handle that can be used by other MQSeries tools. This value corresponds to the Hconn parameter in the MQCONN call.

Reason Code

For each call, a completion code and a reason code are returned by the queue manager or by an exit routine, to indicate the success or failure of the call. This value corresponds to the Reason code parameter in the MQCONN call. The WebSphere MQ Application Programming Guide contains a list of reason codes and their meanings.

Exit Paths

Success

This step takes the Success exit path if the completion code indicates success.

Failure

This step takes the Failure exit path if the completion code indicates failure. The reason for tool failure is contained in the Reason Code parameter. This step will also fail if the Queue Manager isn't running or is configured incorrectly, or if the name specified in the QMgrName is incorrect.