IPC PUSH
Enqueues a message at the top of an IPC queue.
Type
Interprocess Communication (IPC) function
Format
IPC(PUSH 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 in the queue. The maximum length is approximately 30K.
Return Codes
- 0
- Success.
- -4
- handle is not valid.
- -8
- msg_string is too large.
Usage Notes®
- IPC PUSH places a message at the top of the queue (last-in, first-out). Use IPC QUEUE to place a message at the bottom (first-in, first-out).
Example
The following example places the
message contained in the string variable Msg at the top of
the queue QHandle:
set RC (ipc(PUSH &QHandle '&Msg'))