Communicator e3000 MPE/iX Release 7.0 Express 1 (Software Release C.70.01) (30216-90328)

Chapter 6 131
Technical Articles
Limits in TurboIMAGE/iX
DBUTIL changes:
New flag in DBUTIL, when enabled, will return an error message if the buffer returned in
DBINFO exceeds the old limit. This flag is disabled by default, and is introduced mainly
for debugging purposes. To enable this flag, use the enable command in DBUTIL
>>ENABLE dbname FOR OLDINFOLIMITS
DBINFO changes:
DBINFO modes 103, 203, 204, 301 have been modified to add the following check. If the
flag is enabled and if the limit exceeds the earlier limits, for instance in DBINFO mode
103, if the number of items > 1023 and flag in DBUTIL is enabled, an error message is
displayed which says "Data returned by DBINFO may overrun the buffer of the
application." So, before calling DBINFO modes 103, 203, 204, 301 be sure that the
buffersize allocated is sufficient to hold the data returned in view of the increased limits.
Or else, DBINFO buffer may be overwritten resulting in erroneous information. DBINFO
has been modified to return information on various features used by the database. Now
DBINFO Mode 406 will return in the buffer element # 17 the various features used in the
database. The bit # needs to be interpreted as below:
DBCONTROL changes:
A new mode, 20, has been introduced in DBCONTROL, by which users can indicate to
TurboIMAGE/iX that the application program is aware of increased buffer requirements
for certain DBINFO calls on databases with new limits.
SYNTAX: DBCONTROL(base,qualifier,mode,status) where
If oldinfolimits flag is set through DBUTIL and you are sure that the buffer sizes are
enough for the new limits, use dbcontrol mode 20 to disable the flag.
Bit # Vaule/Description
09 1: Database uses new limits
(# of sets = 240, # of items =1200, # paths permaster = 64)
0: Database uses old limits
(# of sets = 199, # ofitems = 1023, #paths per master= 16)
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.
qualifier ignored for mode 20
mode should be 20 for the above mentioned functionality. Mode 20 tells TurboIMAGE/iX
that the user is aware of increased buffer requirements for certain DBINFO modes
(like 103,203,204,301) for databases with new limits.This mode would cause the
above mentioned DBINFO modes to skip the check for database with new limits.
This mode would be in effect for the current user only.
status is the name of the array of 10 halfwords in which TurboIMAGE/iX returns status
information.