Requires: Base Development System
Use the Messenger channel to transfer command-like messages among multiple writers and/or multiple readers. Messages can optionally be synchronous when the writer waits until the message is acknowledged by the reader. The Messenger channel is also capable of consolidating repetitive messages and disposing orphaned messages when the channel aborts.
| Endpoint | Description |
|---|---|
| Read | Waits to read an element from a Messenger channel. |
| Read Ack | Waits for an acknowledgement from a Messenger channel. If no acknowledgement from the channel, this endpoint waits until the acknowledgement is available. |
| Read Ack With Abort | Waits for an acknowledgement from a Messenger channel or signals the channel to abort. This endpoint is the same as the Read Ack endpoint except that it has an abort input and an aborted? output. You can use the abort capability of the Messenger channel to close a channel abruptly, ignoring any data left in the channel buffer. You must use this endpoint together with the Write With Abort endpoint. |
| Read Scheduled | Reads an element from a Messenger channel at a scheduled time. The endpoint waits if no element is available in the channel at the scheduled time. |
| Read With Abort | Reads an element from a Messenger channel or signals the channel to abort. This endpoint is the same as the Read endpoint except that it has an abort input and an aborted? output. You can use the abort capability of the Messenger channel to close a channel abruptly, ignoring any data left in the channel buffer. You must use this endpoint together with the Write With Abort endpoint. |
| Write | Writes an element to a Messenger channel. The endpoint waits if the channel is full. |
| Write Ack | Writes an acknowledgement to a Messenger channel that the message with the given id has been read. |
| Write Scheduled | Writes an element to a Messenger channel at a scheduled time. The endpoint waits until the scheduled time and continues waiting if the channel is full at the scheduled time. |
| Write With Abort | Writes an element to a Messenger channel or signals the channel to abort. The endpoint waits if the channel is full. This endpoint is the same as the Write endpoint except that it has an abort input and an aborted? output. You can use the abort capability of the Messenger channel to close a channel abruptly, ignoring any data left in the channel buffer. You must use this endpoint together with the Read With Abort endpoint. |