UMF Send Request

This tool sends the message specified by the supplied handle to another handler on the same server. Which handler gets triggered by the message is determined by the event and object IDs that are specified of this tool. Handler execution continues only after a response is received or the timeout period expires.

Inputs

Message Handle

A valid handle to a message.

Object ID

The value to use for the object ID that will be included with the message notification to the receiving handler. To trigger a handler this value must match the value specified in the Object ID input on the UMF Message Received initiator.

Event ID

The value to use for the event ID that will be included with the message notification to the receiving handler. To trigger a handler this value must match the value specified in the Notification Event input on the UMF Message Received initiator.

Timeout

The number of milliseconds to wait for a response to the message. A value of zero means the timeout period is infinite.

Outputs

Response Message Handle

A handle to the response message if one was received in time. This output will only contain a valid value if the success path is taken.

Exit Paths

Success

This path is taken if the message is successfully sent and a response is received within the timeout period.

Failure

This path is taken if the operation fails.

Timeout

This path is taken if the timeout period expires before a response message has been received.