11.04.2013 Views

UniBasic Commands Reference - Rocket Software

UniBasic Commands Reference - Rocket Software

UniBasic Commands Reference - Rocket Software

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Parameters<br />

The following table describes each parameter of the syntax.<br />

Parameter Description<br />

dyn.array.var Specifies a target dynamic array to receive the data read.<br />

FROM file.var Specifies a file variable from which to read the record.<br />

If you do not specify a file.var, UniData reads from the default<br />

file. If no default file is open, a fatal error occurs.<br />

The default file is one for which no file variable is assigned in<br />

the OPEN statement.<br />

ON ERROR statements Specifies statements to execute if the READBCKL statement<br />

fails with a fatal error because the file is not open, an I/O error<br />

occurs, or UniData cannot find the file.<br />

If you do not specify the ON ERROR clause and a fatal error<br />

occurs, the program terminates.<br />

LOCKED statements Specifies statements to execute if the record is already locked.<br />

If you do not specify the LOCKED clause, and if the record is<br />

locked, UniData waits until the record is available.<br />

Use the ECL command DEFAULT.LOCKED.ACTION BELL<br />

to make the terminal beep while you wait for UniData to<br />

unlock the record.<br />

THEN statements END THEN executes if the read is not successful. END is required<br />

to terminate multiline THEN statements.<br />

ELSE statements END ELSE executes if the read is not successful, the current<br />

alternate key value is not set by the SETINDEX command, or<br />

UniData cannot locate the current alternate key value (for<br />

example, when UniData reaches the end of the alternate<br />

index). END is required to terminate multiline ELSE<br />

statements.<br />

READBCKL Parameters<br />

READBCKL 1-603

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

Saved successfully!

Ooh no, something went wrong!