TurboIMAGE/XL Database Management System Reference Manual MPE/iX V6.5 (30391-90011)
230 Chapter5
TurboIMAGE/XL Library Procedures
DBUPDATE
DBUPDATE
INTRINSIC NUMBER 406
Modifies values of data items in the entry residing at the current record address of a
specified data set. To call DBUPDATE, you must open the database in access mode 1, 2, 3, or
4. The update is always carried out correctly against the latest version of the data,
regardless of modifications made by other users.
In database access mode 1, 3, or 4, you can use DBUPDATE to modify the values of detail
data set search and sort items if permitted by the critical item update (CIUPDATE) option
settings for the database and the current process. Master data set key item values cannot
be modified even if CIUPDATE is permitted.
Syntax
DBUPDATE,
base,dset,mode,status,list,buffer
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
must be an integer equal to 1.
If your database is enabled for third-party indexing (TPI), refer to your
vendor documentation for additional DBUPDATE 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 operates
successfully, the status array contents are:
Element Contents
1 If the procedure succeeds, the return status is 0. Table
5-23. describes the contents of element 1 when the
procedure does not succeed.
2 Length of the values in buffer (in halfwords).
3-10 Same word values set by preceding procedure call which
positioned the data set at the current entry. If critical item
update is permitted, the value contained in element 3
determines the message returned.