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

Chapter 5 189
TurboIMAGE/XL Library Procedures
DBINFO
DBINFO
INTRINSIC NUMBER 402
Provides information about the database being accessed. The information returned is
restricted by the user class number established when the database is opened; any data
items, data sets, or paths of the database which are inaccessible to that user class are
considered to be non-existent.
Syntax
DBINFO, base,qualifier,mode,status,buffer
Parameters
base is the array name used as the base parameter when opening the database;
must contain the base ID returned by DBOPEN. (Refer to DBOPEN for
additional base ID information.)
qualifier is the name of an array containing a data set/data item name or an integer
referencing a data item/data set, depending on the value of the mode
parameter (refer to "Discussion" for mode/qualifier relationship). This
parameter form is identical to the dset and item parameters for DBFIND,
and the dset and list parameters for DBPUT.
mode is an integer indicating the type of information desired. Refer to
"Discussion" for
mode integer information (data item modes 1nn; data set
modes 2nn; path modes 3nn; logging, dynamic roll-back recovery, and
multiple database transaction modes 4nn; subsystem and critical item
update modes 5nn; third-party indexing modes 8nn; and language modes
9nn.)
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-14. describes the contents of element 1 when the
procedure does not succeed.
2 Length of information in buffer array (in halfwords).
3-4 Unchanged from previous procedure call using this array.
5-10 Information about the procedure call and its results. Refer
to "Library Procedure Error Messages" in appendix A for a
description of this information.
buffer is the name of an array in which the requested information is returned.
The contents of the buffer array vary according to the mode parameter