iX V6.5 (30391-90011)

ManualsBrandsHP ManualsSoftwareMPE/iX 6.5 Operating System

211

212

213

214

215

216

217

218

219

220

Chapter 5 217

TurboIMAGE/XL Library Procedures

DBOPEN

NOTE

If the database is open in database access mode 1, a lock must be in effect on

either the data set or the whole database when adding to or deleting from

master data sets. If a data entry level lock is speciﬁed, any subsequent

DBPUTs or DBDELETEs will fail with error number −12 and the following

message is returned:

intrinsic name

CALLED WITHOUT COVERING LOCK IN EFFECT

Lock either the entire database or data set with a data entry lock by using an

@ sign to specify all data sets or all data items.

The ﬁgure in appendix B summarizes the results of multiple access to the

same database. If a database cannot be opened successfully in a particular

mode, this information can be used to determine the problem and to select

an alternate mode.

If your database is enabled for third-party indexing (TPI), refer to your

vendor documentation for additional DBOPEN 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-19. describes the contents of element 1 when the

procedure does not succeed.

2 User class number, 0 to 63 (or a 64 if the database creator

enters a semicolon ";" in place of a password).

3 Current size of the DBG (in halfwords) or 32767,

whichever is smaller. If it is 32767, the DBG size exceeds

the maximum halfword value limit.

4 Size of the DBU (in halfwords) or 32767, whichever is

smaller. If it is 32767, the DBU size exceeds the maximum

half-word value limit.

5-10 Information about the current procedure call and its

results. This same information is returned for all

TurboIMAGE/XL procedures if an error occurs. It is

described in "Library Procedure Error Messages" in

appendix A.