Configuring Java CAPS Project Components for Application Adapters

Inbound WebSphere MQ Adapter Settings with GetMessageOptions and matchOptions

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

Table 1–22 Connectivity Map - Inbound WebSphere MQ Adapter Settings with GetMessageOptions and matchOptions

Name 

Description 

Required Value 

correlationId

Specifies the correlation identifier of the message to be retrieved. Normally the queue manager returns the first message with a message identifier and correlation identifier that matches the identifiers specified. 

The correlation identifier of the message. 

groupId

Specifies the byte string that identifies the message group to which the physical message belongs. 

A byte string that indicates the message group. 

messageId

For an MQGET call, this field specifies the message identifier of the message to be retrieved. Normally, the queue manager returns the first message with a message identifier and correlation identifier that matches those identifiers specified. 

For an MQPUT call, this specifies the message identifier to use. 

The message identifier. 

messageSequenceNumber

Specifies the sequence number of a logical message within a group. 

The sequence number of the logical message within a group. 

The configured default is 1.

MQMO_MATCH_CORREL_ID

Specifies that the retrieved message must have a correlation identifier that matches the value of the correlationId parameter. The values are:

  • True: Indicates that the message must have a matching correlation identifier.

  • False: Indicates that the correlation identifier is ignored and any correlation identifier will be accepted.

    This match is in addition to any other matches that may apply (for example, the message identifier).

True or False.

The configured default is False.

MQMO_MATCH_GROUP_ID

Specifies that the retrieved message must have a group identifier that matches the value of the groupId parameter. The values are:

  • True: Indicates that the message must have a matching group identifier.

  • False: Indicates that the group identifier is ignored and any group identifier is accepted.

    This match is in addition to any other matches that may apply (for example, the correlation identifier).

True or False.

The configured default is False.

MQMO_MATCH_MSG_ID

Specifies that the retrieved message must have a message identifier that matches the value of the messageId parameter. The values are:

  • True: Indicates that the message must have a matching message identifier.

  • False: Indicates that the message identifier is ignored and any message identifier is accepted.

    This match is in addition to any other matches that may apply (for example, the correlation identifier).

True or False.

The configured default is False.

MQMO_MATCH_MSG_SEQ_NUMBER

Specifies that the retrieved message must have a message sequence number that matches the value of the messageSequenceNumber parameter. The values are:

  • True: Indicates that the message must have a matching message sequence number.

  • False: Indicates that the message sequence number is ignored and any message sequence number is accepted.

    This match is in addition to any other matches that may apply (for example, the group identifier).

True or False.

The configured default is False.

MQMO_NONE

Specifies that no matches are to be used in selecting the message to be returned. All messages on the queue are eligible for retrieval (subject to some MQGMO_ options...). 

True or False.

The configured default is True.