11.04.2013 Views

UniBasic Commands Reference - Rocket Software

UniBasic Commands Reference - Rocket Software

UniBasic Commands Reference - Rocket Software

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

GETQUEUE<br />

Syntax<br />

GETQUEUE()<br />

Description<br />

The <strong>UniBasic</strong> GETQUEUE function returns a dynamic array containing information<br />

about all records currently locked and waiting to be released.<br />

<strong>UniBasic</strong> commands that check for locks, such as READU and READVU, cause<br />

processes to wait for locks to be released before proceeding.<br />

This command delivers the same information as the ECL command LIST.QUEUE,<br />

but in a different format. A value mark separates these pieces of information. An<br />

attribute mark separates the information about different locks.<br />

If GETQUEUE is successful, UniData sets @SYSTEM.RETURN.CODE to the<br />

number of locks waiting to be released. If unsuccessful, UniData sets<br />

@SYSTEM.RETURN.CODE to -1.<br />

Note: <strong>UniBasic</strong> locks are advisory only. For more information, see Developing<br />

<strong>UniBasic</strong> Applications.<br />

GETQUEUE Function Return Values<br />

The GETQUEUE function returns the values described in the following table.<br />

Value Description<br />

1-302 <strong>UniBasic</strong> <strong>Commands</strong> <strong>Reference</strong><br />

UDTNO The number of the UniData process that locked the file.<br />

USERNBR The ID of the process that ran the UniData application that locked the<br />

file.<br />

UID The user ID of the user who ran the UniData application that locked the<br />

file.<br />

GETQUEUE Function Return Values

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!