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

222 Chapter5
TurboIMAGE/XL Library Procedures
DBPUT
DBPUT
INTRINSIC NUMBER 407
Adds new entries to a manual master or detail data set. The database must be opened in
access mode 1, 3, or 4.
Syntax
DBPUT, 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
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 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 DBPUT 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-21. describes the contents of element 1 when the
procedure does not succeed.
2 Length of logical entry in buffer array (in halfwords).
3-4 Word record number of new entry.
5-6 Word count of number of entries in chain. If master data
set, chain is synonym chain. If detail data set, chain is
current chain of new entry.
7-8 If master, word record address of predecessor on synonym
chain. If detail, word record number of predecessor on
current detail chain.
9-10 If detail, word record number of successor on current
chain. If master, word zero.