HP Business BASIC/XL Reference Manual - HP 3000 MPE/iX Computer Systems - Edition 1 (32715-90001)

4- 26
Syntax
DBDELETE dbname $, DATASET[=] dataset [, Status[=] status_array(*) ]
Parameters
dbname $ A string variable, whose value is a TurboIMAGE database
name. dbname must be the variable that was passed to a
successful DBOPEN.
dataset A string expression with a maximum length of 16
characters. Its value is the name of a data set. The
name must be left-justified and if shorter than 16
characters must be terminated by a semicolon or blank.
This parameter can also be an integer or short integer
corresponding to the desired dataset number.
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
and handle the error. The values returned by TurboIMAGE
to this array are detailed in the description of the
status parameter of the equivalent TurboIMAGE library
procedure.
Examples
110 DBDELETE Data_base$,DATASET=Data_set$,STATUS=Status(*)
120 DBDELETE Data_base$,DATASET Data_set$,STATUS Status(*)
DBERROR
The DBERROR statement moves a database error message as an ASCII string
to a string variable specified using the RETURN parameter. The
conversion of the error number in the status_array is as listed in the
DBERROR message table in the section describing the DBERROR library
procedure in the TurboImage/XL Database Management System .
Syntax
DBERROR STATUS[=] status_array(*) , RETURN[=] str_var
Parameters
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
and handle the error. The values returned by TurboIMAGE
to this array are detailed in the description of the
status parameter of the equivalent TurboIMAGE library
procedure.
str_var A string variable at least 72 characters in length that
serves as the buffer to which the multi-line error
message is returned.
Examples
110 DBERROR STATUS=Status(*),RETURN=Message$
DBEXPLAIN
DBEXPLAIN prints a multi-line message on MPE's standard list device,
usually a terminal, which describes the most recent TurboIMAGE library
procedure call. Information about the results of the call are explained
on the basis of the information contained in the status_array parameter.
In the event of an error, the message printed is more detailed than the
message returned by the DBERROR statement. This statement must be placed
immediately after the library procedure call.