|
Deletes the current entry from a manual master or detail data set.
The database must be opened in write mode.
DBDELETE(base,dset,mode,status)
- base
-
is the name of an 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 to which the entry is to be added, 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, a space or the NUL character.
- mode
-
must be an integer equal to 1.
- status
-
is the name of an array of 10 halfwords in which the database 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.
Otherwise it provides a status code to describe the failure.
|
2 |
Zero.
|
3-4 |
Word record number of new entry (32 bit).
|
5-6 |
Word count of number of entries in chain (32 bit).
If detail data set, chain is current chain of entry.
|
7-8 |
If detail, word record number of predecessor on current
detail chain (32 bit).
|
9-10 |
If detail, word record number of successor on current
detail chain (32 bit).
|
Notes:
-
With the Eloquence database, locking is optional.
A write attempt which is covered by a concurrent DBLOCK
returns status -12.
-
Synonym chain information (for master data set) is always zero.
-
Status elements 3-10 were left unchanged by TurboIMAGE for
detail data sets but are modified by Eloquence.
|
|