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
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.