Attach an MQEndpoint policy to one or more WebSphere® MQ nodes to control connection properties at run time.
To attach an MQEndpoint policy to a WebSphere MQ node, set the Policy property of the MQInput, MQOutput, MQReply, or MQGet node to the name of the policy, in the format {policyProjectName}:policyName. You must deploy this policy before the associated message flow is started.
To specify a default MQEndpoint policy for all message flows that are deployed to an integration server, set the mqConnector property in the server.conf.yaml file to the name of an MQEndpoint policy (see Configuring an integration server by using the server.conf.yaml file). If the default policy is in the default policy project, you do not need to specify the name of the policy project. If the default policy is in a non-default policy project, qualify the name of the policy with the name of the policy project ({policyProject}:PolicyName).
Property | Property name in .policyxml file | Value |
---|---|---|
Connection | connection | This property specifies how you connect to WebSphere MQ. Choose from
the following values:
If you set this property to CCDT to use client connection details in a client channel definition table (CCDT), you must set the Queue manager name property. You must also specify the location of the CCDT file by using the mqsichangeproperties command (see Configuring a client connection to WebSphere MQ). Value type: String |
Queue manager name | destinationQueueManagerName | This property specifies the name of the destination queue manager where message queues are
defined. Value type: String |
Queue manager host name | queueManagerHostname | This property specifies the host name of the queue manager. To achieve high availability, you can specify more than one host name by separating each host name with a comma. The first host name in the list is used as the primary host name. If the connection to the host name becomes unavailable, the next host name is used, and so on. Value type: String |
Listener port number | listenerPortNumber | This property specifies the port number on which the queue manager is listening. This
property has a default port number of 1414. Value type: Integer |
Channel name | channelName | This property specifies the name of the channel that is used by the queue manager to send
messages. Value type: String |
Security identity (DSN) | securityIdentity | This property specifies an identity that is used to provide user name and password
credentials when you connect to a secured queue manager. If you set this property, you must also define the identity by running the mqsisetdbparms command (see Connecting to a secured WebSphere MQ queue manager). Value type: String |
Use SSL | useSSL | This property controls whether the SSL protocol is used when a client connection is made to a
remote queue manager. Select this property to provide confidentiality on the client connection by
using SSL. This property has a default value of False. If you set this property to True to provide confidentiality on the client connection, you must also specify the location of the key repository by running the mqsichangeproperties command (see Connecting to a secured WebSphere MQ queue manager). Value type: Boolean |
SSL peer name | SSLPeerName | This property specifies the name that is passed to the remote queue manager when you connect
to the remote queue manager. The value of this property must match the value that is specified in
the SSLCIPH property in the remote channel
definition. You can specify this property if the Use SSL property is set. This property is not used for client connections that use a client channel definition table (CCDT) because you can specify this information in the CCDT. Value type: String |
SSL cipher specification | SSLCipherSpec | This property specifies the name of the symmetric key cryptography algorithm that is used to
secure the remote queue manager. You can specify this property if the Use SSL property is set. This property is not used for client connections that use a client channel definition table (CCDT) because you can specify this information in the CCDT. Value type: String |