UniBasic Commands Reference - Rocket Software

Parameter Description
ON ERROR statements Specifies statements to execute if the MATREADL statement
fails with a fatal error because the file is not open, an I/O error
occurs, or UniData cannot find the file.
If you do not specify the ON ERROR clause and a fatal error
occurs, the program terminates.
LOCKED statements Specifies statements to execute if the record is locked by another
user. If you do not specify a LOCKED clause, the program waits
until UniData releases the lock on the record. You can place the
LOCKED clause after the FROM clause.
Use the ECL command DEFAULT.LOCKED.ACTION BELL
to make the terminal beep while you wait for UniData to unlock
the record.
THEN statements END THEN executes if the read is successful. END is required to
terminate multiline THEN statements.
ELSE statements END ELSE executes if the read is not successful or the record (or ID)
does not exist. END is required to terminate multiline ELSE
statements.
INMAT Function Return Values
After you execute MATREADL, the INMAT function returns one of the values
described in the following table.
Value Description
MATREADL Parameters (continued)
n The number of attributes loaded into the array.
0 The array was too small to contain all attributes in the record. The excess data
(including delimiters) is placed in the zero element.
INMAT Function Return Values
Note: BASICTYPEs P and R do not support the 0,0 element. If UniData reads more
attributes from the file than it can place in the dimensioned array, a runtime error
results and data is lost.
MATREADL 1-453