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

148 Chapter5
TurboIMAGE/XL Library Procedures
DBCONTROL
Mode 14: Allow a privileged mode caller to set BTREEMODE1 option
to ON or OFF and set wildcard character for the database
(permanent). Refer to chapter 11, "B-Tree Indices" for the
qualifier layout.
Mode 15: Enable B-Tree wildcard search for DBFIND mode 1, X and
U types, for the master data set's key item and its
corresponding search items in details, if the key item has a
B-Tree index. In other words, turn on the BTREEMODE1
flag for the current database open. The first byte of the
qualifier is examined. If it is null or blank, then the
current wildcard character is not changed. If it is in the
ASCII range (33...126), then the wildcard character is
changed to that value for the current DBOPEN. If the
qualifier is any other value, DBCONTROL returns an error.
Affects only the current database open. It needs to be done
once per database and remains activated until the
database is closed or the application terminates. This
mode allows you to perform B-Tree searches on ASCII
types without making application changes.
Mode 16: Disable B-Tree wildcard search for DBFIND mode 1
regardless of the existence of a B-Tree index. That is, turn
off the BTREEMODE1 flag for the current database open.
The qualifier is ignored, and BTREEMODE 1 is turned off.
Affects the current database open only. It needs to be done
once per database and remains activated until the
database is closed or the application terminates.
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.