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.

Parameters<br />

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

Parameter Description<br />

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

dim.array Specifies the dimensioned array into which the values are read.<br />

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

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

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

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

OPEN statement.<br />

record.ID.expr Specifies the record from which to read the attributes.<br />

ON ERROR statements Specifies statements to execute if the MATREADU 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 locked by another<br />

user. If you do not specify a LOCKED clause, the program waits<br />

until the lock on the record is released. You can place the<br />

LOCKED clause after the FROM clause.<br />

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

to beep the terminal while waiting for the record to be unlocked.<br />

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

terminate multiline THEN statements.<br />

ELSE statements END ELSE executes if the read is not successful or the record (or ID)<br />

does not exist. END is required to terminate multiline ELSE<br />

statements.<br />

MATREADU Parameters

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

Saved successfully!

Ooh no, something went wrong!