HP Business BASIC/XL Reference Manual - HP 3000 MPE/iX Computer Systems - Edition 1 (32715-90001)
4-: 29
corresponding to the desired dataset number.
read_mode
Either a numeric expression that evaluates to one of the
following or a string expression that evaluates to one
of the equivalent mnemonics:
Value Mnemonic TurboIMAGE Mode
------------------------------------------------------------------------------------
--
1 READ Reread
2 SERIAL Serial forward read
3 SERIALBACK Serial backward read
4 DIRECT Direct read
5 CHAIN Chained forward read
6 CHAINBACK Chained backward read
7 CALCULATED Calculated read
8 PRIMARY Primary calculated read
If this parameter is not specified, the default value is
two, (serial).
item_list
The
list
parameter for the DBGET TurboIMAGE library
procedure. The name of a string or an array of one-word
integers containing an ordered set of data item
identifiers. The value for each element in the ordered
list of data item identifiers is packed into
str_var
in
the same order that they appear in the list.
If the
item_list
is a string variable, then the names of
the data items must be left-justified, separated by
commas and terminated with a semicolon or blank. The
embedded blanks are allowed and no name can appear more
than once.
The data
item_list
can contain special symbols such as
@, which specifies all data items in the data set.
Consult the Special List Parameter Constructs table in
the explanation of the DBPUT library procedure in the
TurboIMAGE/XL Database Management System
for additional
special symbols and their usage.
If referencing data items by number, the first word in
the short integer array must be the total number of
elements in the array. This number is followed by that
number of unique data item numbers contained in the
first word of the array.
The
item_list
specified is returned internally by
TurboIMAGE as the
current list
. Consult the
TurboIMAGE/XL Database Management System
for details
about the benefits of using TurboIMAGE's
current list
.
If the ITEMS option is not specified, HP Business
BASIC/XL sets the
item_list
to "@;".
num_expr
Used only with DIRECT read mode, mode 4. Its value is
the integer record number of the entry to be read.
str_expr
Used only with CALCULATED or PRIMARY read mode, modes 7
and 8, respectively. Its value is a search item value
for the master data set referenced in
dataset
.
status_array
A 10-element short integer array to which TurboIMAGE
returns an error code. If an HP Business BASIC/XL
database statement specifies the STATUS option, an error
does not abort the program. Following execution of the
database statement the program can check
status_array