Visara Master Console Center Scripting Guide - Manual (Page 170)

Chapter 5 Script Commands
Scripting Guide 170
QSKIP
Syntax:
QSKIP( %QueueID, %Skip)
Description:
Moves a current message pointer for a queue.
Action: The current message pointer for the specified message queue moves
according to the %Skip parameter.
Parameters:
%QueueID. Numeric expression. The message queue that the
message to skip is in. It is the unique queue ID created by QOPEN().
%Skip. Numeric expression. The amount of messages to skip.
Skip Constant. Description.
SKIPNEXT. Moves the message pointer to the next full message.
Used only to skip through the rest of a multi-line message.
SKIPEND. Moves the current message pointer to the end of the
messages, thereby quickly skipping any remaining messages (unread
with QREAD()) in the script’s queue. This is the same as executing:
QCLOSE( %QueueID)
%QueueID := QOPEN(.)
Returns: N/A.
Notes:
N/A
Example: QSKIP(%QID, SKIPNEXT) //skips remainder of multiline
//message
QSKIP(%QID, SKIPEND)
//skips all remaining messages
//in the message queue
See Also:
QCLOSE, QOPEN, QPREVIEW, QREAD