Dbschema - Omron CX-Supervisor Reference Manual

Database Commands
Note:
Note:

6-17-10 DBSchema

110
values from the Recordsets current position will be copied into the Point
(number of elements copied = number of elements in the Point, no paging
applies at the Field level).
Syntax
returnstate = DBRead(level, reset)
Remarks
Argument Type
returnstate bool
level text
reset bool
Typical Examples
DBRead("Northwind.Customers")
Read the next page of records from the 'Customers' Recordset.
DBRead("Northwind.Customers", FALSE)
Read the next page of records from the 'Customers' Recordset, and leave the
cursor at the next record.
DBRead("Northwind.Customers.Address")
The Address field is read. If it is an array point, the Address is read from
subsequent records until the array has been filled.
Use with reset = TRUE is useful if the read operation is being combined with a
subsequent Write operation i.e. you can read in a set of records - resetting the
cursor, make modifications to some of the fields and then Write the changes
back to the Recordset.
Use with reset = FALSE will leave the current position at the start of the next
set of records. This option can be of benefit if the Provider only supports
forward moving cursors, or you simply want to step through the records a page
at a time.
Description
Issues commands to read schema results or properties or set up new schema
criteria. This function operates only at a Schema level.
Syntax
return = DBSchema(level, command, parameters...)
Remarks
Argument Type
return
level text
SECTION 6 Functions and Methods
Description
1 if the function is successful otherwise 0
A text point or constant specifying the
connection level. This must be a Recordset
level.
This argument is optional and may be omitted.
If omitted or TRUE, when the read is complete
the record cursor is reset to the position prior to
reading.
Description
Value returned by command. For some
commands e.g. "RecordCount" this is an
integer value, for other commands this is a text
value.
A text point or constant specifying the
connection level. This must be a Schema
level.