IBM App Connect Enterprise, Version 11.0.0.2 Operating Systems: Windows, Linux


MQEndpoint policy

Attach an MQEndpoint policy to one or more WebSphere® MQ nodes to control connection properties at run time.

You configure a connection to WebSphere MQ so that the following nodes in your message flows can access messages on WebSphere MQ queues: You can configure MQ Connection properties on these nodes to control a connection to WebSphere MQ, or you can attach an MQEndpoint policy to override the node properties and control the values 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).

The properties of this policy are described in the following table.
Table 1. Properties of the MQEndpoint policy
Property Property name in .policyxml file Value
Connection connection This property specifies how you connect to WebSphere MQ. Choose from the following values:
  • Client (the default)
  • Server
  • CCDT
If you set this property to Client to make a client connection to the WebSphere MQ queue manager, you must also set values for the Queue manager name, Queue manager host name, Listener port number, and Channel name properties.

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


py00119_.htm | Last updated 2018-11-02 14:46:47