IPC QUEUE

Enqueues a message at the bottom of an IPC queue.

Type

Interprocess Communication (IPC) function

Format

IPC(QUEUE handle 'msg_string')
handle
Queue handle returned by IPC ACCESS or IPC CREATE. A non-numeric value fails the dialog.
msg_string
A string representing the message to be placed on the queue. The maximum length is approximately 30K.

Return Codes

0
Success.
-4
handle is invalid.
-8
msg_string is too long.

Usage Notes®

  1. IPC QUEUE places a message at the bottom of the queue (first-in, first-out). Use IPC PUSH to place a message at the top (last-in, first-out).

Example

The following example places the message contained in the string variable Msg at the end of the queue QHandle:
set RC (ipc(QUEUE &QHandle &Msg))

See Also

IPC DEQUEUE

IPC PUSH