[UNIX, Linux, Windows, IBM i]

Deleting data items from a bag using the mqDeleteItem call

The mqDeleteItem call removes one or more user items from a bag. The index is used to delete either:
  1. A single occurrence of the specified selector. (See Figure 1.)
    Figure 1. Deleting a single data item
    The diagram shows the index pointing to a data item that is to be deleted from the data bag.

    or

  2. All occurrences of the specified selector. (See Figure 2.)
    Figure 2. Deleting all data items
    The diagram shows the index pointing to two data items that are to be deleted from the data bag.
Note: The index preserves the insertion order within the bag but can affect the indices of other data items. For example, the mqDeleteItem call does not preserve the index values of the data items that follow the deleted item because the indices are reorganized to fill the gap that remains from the deleted item.

For a full description of the mqDeleteItem call, see mqDeleteItem.