TurboIMAGE/XL Database Management System Reference Manual MPE/iX V6.5 (30391-90011)

184 Chapter5
TurboIMAGE/XL Library Procedures
DBGET
DBGET
INTRINSIC NUMBER 405
Provides eight different methods for accessing the entries of a data set.
Syntax
DBGET, base,dset,mode,status,list,buffer,argument
Parameters
base is the name of the array used as the base parameter when opening the
database. The first element of the array must contain the base ID returned
by DBOPEN. (Refer to DBOPEN for more information about base ID.)
dset is the name of an array containing the left-justified name of the data set to
be read, or is an integer referencing the data set by number. The data set
name can be up to 16 characters long. If shorter, it must be terminated by
a semicolon or a blank.
mode contains an integer between 1 and 8, inclusive, which indicates the
reading method. The methods are:
Mode Method
1 Re-read. Read the entry at the internally maintained
current record number (argument parameter is ignored).
2 Serial Read. Read the first entry whose record number is
greater than the internally maintained current number
(argument parameter is ignored).
3 Backward Serial Read. Read the first entry whose
record number is less than the internally maintained
current number (argument parameter is ignored).
4 Directed Read. Read the entry, if it exists, at the record
number specified in the argument parameter (argument is
treated as a 32-bit record number).
5 Chained Read or Next Qualified Entry Read. Read
the next entry in the current chain, or read the next
qualified entry for a B-Tree DBFIND. This is the entry
referenced by the internally maintained forward pointer
(argument parameter is ignored). Super-chains are
traversed for detail data sets.
If your database is enabled for third-party indexing (TPI),
refer to your vendor documentation for additional
information.