SelectionString (MQCHARV)

This is the string used to provide the selection criteria used when retrieving messages off a queue.

SelectionString must not be provided in the following cases:
  • If ObjectType is not MQOT_Q
  • If the queue being opened is not being opened using one of the MQOO_BROWSE, or MQOO_INPUT_* options
If SelectionString is provided in these cases, the call fails with reason code MQRC_SELECTOR_INVALID_FOR_TYPE.

If SelectionString is specified incorrectly, according to the description of how to use the MQCHARV - Variable Length String structure, or if it exceeds the maximum length, the call fails with reason code MQRC_SELECTION_STRING_ERROR. The maximum length of SelectionString is MQ_SELECTOR_LENGTH.

SelectionString usage is described in Selectors.