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

152 Chapter5
TurboIMAGE/XL Library Procedures
DBDELETE
DBDELETE
INTRINSIC NUMBER 408
Deletes the current entry from a manual master or detail data set. The database must be
opened in access mode 1, 3, or 4.
Syntax
DBDELETE, base,dset,mode,status
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 the base ID.)
dset is the name of an array containing the left-justified name of the data set
from which the entry is to be deleted, 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 must be an integer equal to 1.
If your database is enabled for third-party indexing (TPI), refer to your
vendor documentation for additional DBDELETE mode information. The
section on DBUTIL in chapter 8 of this book has a brief description of the
TPI option.
status is the name of an array of 10 halfwords in which TurboIMAGE/XL returns
status information about the procedure. If the procedure executes
successfully, the status array contents are:
Element Contents
1 If the procedure succeeds, the return status is 0. Table 5-8.
describes the contents of element 1 when the procedure
does not succeed.
2 Zero.
3-4 Unchanged current record number.
5-6 Number of entries in a chain.
If master data set, the number is zero unless the deleted
entry was a primary entry with synonyms. In this case,
the number is one less than its previous value.
If detail data set, the number is unchanged from the
preceding procedure call.