Configuring Java CAPS Project Components for Application Adapters

Inbound WebSphere MQ Adapter Settings

The Inbound WebSphere MQ Adapter Settings section of the WebSphere MQ Adapter Connectivity Map properties contains the top-level parameters displayed in the following table.

Table 1–21 Connectivity Map - Inbound WebSphere MQ Adapter Settings

Name 

Description 

Required Value 

Queue Name

Specifies the name of the queue from which messages are picked up (subscribed). 


Note –

Inbound mode Adapters will not function if a non-local queue is specified. Non-local queues include alias queues and local queue definitions to remote queues. This limitation applies only applies to polling/receive mode Adapters, not outbound Adapters used to retrieve messages.


The name of the WebSphere MQ queue. 

The configured default is default.

Maximum Message Size

Specifies the maximum message size that the Adapter is able to get from a queue. A value of zero (0) instructs the Adapter to use the MQ-provided default size. If you specify a non-zero value, and a message on the queue is larger than this value, one of the following will occur: 

If the MQC.MQGMO_ACCEPT_TRUNCATED_MSG property is set to True, the Adapter processes as much of the message from the queue as possible, producing a truncated message.

If the MQC.MQGMO_ACCEPT_TRUNCATED_MSG property is set to False, the Adapter leaves the message on the queue and raises an MQException with a completion code of MQCC_WARNING, and with a reason code of MQRC_TRUNCATED_MSG_FAILED.

A number indicating the maximum message size in bytes. 

The configured default is 0 (use the MQ defined default size).

Schedule Interval

Specifies the polling interval in milliseconds at which the subscribed queue is polled for messages. This is the duration of the pause, in milliseconds, between attempts to get messages from the queue. 

The number of milliseconds at which the queue is polled. 

The configured default is 5000 (or 5 seconds).

Security Exit

Specifies the optional, package qualified name of a user-defined class that implements the com.ibm.mq.MQSecurityExit interface. WebSphere MQ invokes an instance of the class whenever the Adapter attempts to connect to the queue manager. The named class must include a default constructor.

This parameter is only used for client connections. Security Exits are not applicable to bindings connections. 

For more information about Security Exits, see the IBM document, WebSphere MQ Using Java (CSQZAW09) regarding MQSecurityExit.

The name of the user-defined class. This property also requires an assigned value for the Security Exit Jar Classpath property.

Security Exit JAR Classpath

Specifies the absolute path to the JAR file that contains the named Security Exit. This property is required if the Security Exit is specified. 

The specified JAR is packaged into the application (EAR) file that is generated during Project activation. If the specified JAR cannot be accessed or found, the activation will fail. 

If this property value is left blank, you must ensure that a JAR file containing the Security Exit is made accessible to the runtime Environment prior deploying the Project (for example, by manually copying the JAR file into the Integration Server’s lib directory prior to or during the Deployment Process). 

For more information about Security Exits, see the IBM document, WebSphere MQ Using Java (CSQZAW09) regarding MQSecurityExit.

The absolute path for the JAR file that contains the named Security Exit class.