3.1.7.1 Send User Message Event

The Send User Message Event indicates that there exists in the OutgoingMessageTable ADM element an OutgoingMessagePosition ADM element instance with a UserMessage ADM attribute that has been constructed as described in section 3.1.7.11 and that is ready to be sent to the remote queue manager. The event provides a reference to the corresponding OutgoingMessagePosition ADM element.

The following arguments are passed when the Send User Message Event is raised:

• The iQueue argument: A reference to a Queue ADM element instance.

• The iPosition argument: A reference to an OutgoingMessagePosition ADM element instance.

The following steps MUST be performed to process this event:

• If iQueue.State is not equal to Connected, take no further action.

• If the UnAckedMessageCount ADM element is greater than or equal to the WindowSize ADM element, take no further action.

• If the OutgoingQueueReference ADM element of the session is NULL, set it to iQueue.

• General Processing (section 3.1.7.1.1).

• Checking for Message Expiration (section 3.1.7.1.2).

• Signing the Packet (section 3.1.7.1.4).

• Encrypting the Message Body (section 3.1.7.1.5).

• Updating the UserMessage Packet (section 3.1.7.1.3).

• Sending the Packet (section 3.1.7.1.6).

• Sending Trace Message (section 3.1.7.1.7).

Unless specifically noted in a subsequent section, this logic MUST be applied to any UserMessage Packet ([MS-MQMQ] section 2.2.20) sent.