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

Chapter 5 151
TurboIMAGE/XL Library Procedures
DBCONTROL
NOTE If HWMPUT is enabled, DBPUT will not inform you when it has reached the end
of file and has started using the delete chain head. In general, it is not a good
practice to toggle HWMPUT.
If you plan to use roll-forward recovery, do not toggle HWMPUT after storing the
database.
By default, DBPUT first checks the delete chain head, then if it is empty, DBPUT places the
new entry at the high-water mark. If the high-water mark option (HWMPUT) is enabled,
DBPUT will place the entry at the high-water mark first; after the high-water mark reaches
the file limit, DBPUT will use the delete chain head. Use DBCONTROL mode 9 to enable or
mode 10 to disable this feature.
DBCONTROL allows DBUTIL and privileged callers to perform several B-Tree index file
related functions such as adding, deleting, or rebuilding of a B-Tree index file for a
specified master dataset. There are four new DBCONTROL modes pertaining to B-Tree
indices: modes 13, 14, 15, and 16. Refer to chapter 11, "B-Tree Indices," for more
information.
Consult appendix A for more information about the conditions for the return status values
shown in Table 5-7.
Table 5-7. DBCONTROL Return Status Values
File System,
Memory
Management,and
Transaction
Management
Failures:
-4 FREADLABEL failure.
-168 Cannot attach n to MPE XL XM: file system error nn .
-175 Cannot attach n to MPE XL XM: XM error nn .
-176 Cannot detach n from MPE XL XM: XM error nn .
-178 Cannot detach n from MPE XL XM: file system error nn .
-179 Cannot begin MPE XL transaction for attach: XM error nn .
-189 Cannot begin MPE XL transaction for detach: XM error nn .
-280 DBCONTROL mode 18 not allowed inside a dynamic transaction.