2551 (09F7) (RC2551): MQRC_SELECTION_NOT_AVAILABLE

Explanation

An MQSUB call subscribed to publications using a SelectionString. IBM MQ is unable to accept the call because it does not follow the rules for specifying selection strings, which are documented in Message selector syntax. It is possible that the selection string is acceptable to an extended message selection provider, however no extended message selection provider was available to validate the selection string. If a subscription is being created, the MQSUB fails; otherwise MQSUB completes with a warning.

An MQPUT or MQPUT1 call published a message and at least one subscriber had a content filter but IBM MQ could not determine whether the publication should be delivered to the subscriber (for example, because no extended message selection provider was available to validate the selection string). The MQPUT or MQPUT1 call will fail with MQRC_SELECTION_NOT_AVAILABLE and no subscribers will receive the publication.

Completion code

MQCC_WARNING or MQCC_FAILED

Programmer response

If it was intended that the selection string should be handled by the extended message selection provider, ensure that the extended message selection provider is correctly configured and running. If extended message selection was not intended, see Message selector syntax and ensure that we have correctly followed the rules for specifying selection strings.

If an administratively defined subscription selector is using extended message syntax, this is indicated by the DISPLAY SUB parameter SELTYPE having the value EXTENDED. We can use the following command to identify the administratively defined subscribers that are being interpreted as extended message selectors:

DISPLAY SUB(*) WHERE(SELTYPE EQ EXTENDED)

If a subscription is being resumed, the subscription will not be delivered any messages until a extended message selection provider is available and a message matches the SelectionString of the resumed subscription.

Parent topic: API reason codes