3.1.7.1.28 Add Message To Dispatch Collection

This event MUST be generated with the following arguments:

• iData: Protocol-specific data.

• iPosition: A reference to a MessagePosition (section 3.1.1.11) ADM element instance.

Return Value:

• None.

The queue manager MUST perform the following actions to process this event:

• Create a new DispatchEntry (section 3.1.1.18) ADM element instance, referred to as newDispatchEntry, and populate it as follows:

  • Set newDispatchEntry.MessagePositionReference to iPosition.

  • Set newDispatchEntry.ProtocolData to iData.

  • Set newDispatchEntry.Priority to the sum of iPosition.QueueReference.BasePriority and the Priority ADM attribute of the Message (section 3.1.1.12) ADM element instance referenced by iPosition.MessageReference.

  • Set newDispatchEntry.SendInProgress to False.

• Atomically add newDispatchEntry to LocalQueueManager.DispatchCollection.

• Raise a Dispatch Send Message (section 3.1.7.3.9) event.