Function EN Version 4.60

@PutQueue

List Misc Text TimeDate

Syntax

@PutQueue(QUEUEHANDLE;FNPRIORITY;TEXTMESSAGE);

Description

Places the message TEXT TEXTMESSAGE with priority FN FNPRIORITY into the message queue with queue handle VSPECQUEUEHANDLE QUEUEHANDLE.
On success, TRUE is returned; otherwise @ERROR.

FN FNPRIORITY:
1   = Highest priority.

65534   = Lowest priority
65535   = No priority (placed at the end of the message queue.)

Example: @PutQueue(QUEUEHANDLE;FNPRIORITY;TEXTMESSAGE);

TEXTQUEUENAME:="QUEUE_NAME_1";
Ret:=@CreateQueue(TEXTQUEUENAME);
QUEUEHANDLE:=@OpenQueue(TEXTQUEUENAME);

TEXTMESSAGE:="Test Message";
FNPRIORITY:=1;
Ret:=@PutQueue(QUEUEHANDLE;FNPRIORITY;TEXTMESSAGE);
@LogReport(Ret);

QUEUEHANDLE:=@CloseQueue(QUEUEHANDLE);

A message queue with the name "QUEUE_NAME_1" is created and opened.
The message "Test Message" is placed into the message queue; afterwards, the message queue is closed again.
The return value of @PutQueue is output in the APILog.

Note : This text was machine-translated and may contain inaccuracies.