TurboIMAGE/XL Database Management System Reference Manual (30391-90012)

Chapter 5 149
TurboIMAGE/XL Library Procedures
DBCONTROL
sets with an item and DBINFO mode 301 returns paths
for a specific data set. If a user program allocates arrays
to store the data returned from above DBINFO calls and
the size of the arrays are defined by the old
TurboIMAGE/XL item/set limit. Then a database with
new item/set limit may cause the program to abort. User
can enable a DBUTIL flag – OLDINFOLIMITS to prevent
program abort, instead, the program will return an error
stated that data returned may overrun the buffer.
However, for a new program, which already change the
array size to new limit, doesn’t want this error. The
program can call DBCONTROL mode 20 before calling
DBINFO to prevent the error.
If your database is enabled for third-party indexing (TPI), refer to your
vendor documentation for additional DBCONTROL modes. 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. If the procedure executes successfully, the status array
contents are as follows:
Element Contents
1 If the procedure succeeds, the return status is 0. Table 5-6.
describes the contents of element 1 when the procedure
does not succeed.
2-4 Unchanged from previous procedure call using this array.
5-10 Procedure call information. Refer to "Library Procedure
Error Messages" in appendix A for a description of this
information.