|
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.
DBINFO(base,qualifier,mode,status,buffer)
- base
-
is the name of an array used as the base parameter when opening the
database. The first element of the array must contain the base ID
returned by DBOPEN. (Refer to DBOPEN for more information about the
base ID.)
- 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. 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.
Please refer to the document on DBINFO
modes for detailed information on valid DBINFO modes, qualifiers
and buffer.
- status
-
is the name of an array of 10 halfwords in which the database 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.
Otherwise it provides a status code to describe the failure.
|
2 |
Length of information in buffer array (in halfwords).
|
3-4 |
Unchanged from previous procedure call using this array.
|
5-10 |
Information about the current procedure call and its results.
|
- 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 used.
Please refer to the document on DBINFO
modes for detailed information on valid DBINFO modes, qualifiers
and buffer.
|
|