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

176 Chapter5
TurboIMAGE/XL Library Procedures
DBEXPLAIN
Figure 5-1. contains four examples of messages generated by DBEXPLAIN for a Native Mode
Table 5-11. DBEXPLAIN Message Format
Line Format
1 (a blank line)
2 TurboIMAGE{ ERROR
RESULT } [AT
offset ] RETURN STATUS=retstat
3{ intrinsicname ,MODE x ,ON [ setname OF] basename
[ ;PASSWORD= password ]
TurboIMAGE CALL INFORMATION NOT AVAILABLE }
4{
message
UNRECOGNIZED RETURN STATUS: retstat }
5 [ HEX DUMP OF STATUS ARRAY FOLLOWS
OCTAL DUMP OF STATUS ARRAY FOLLOWS ]
6[
hex display
octal display
]
7 (a blank line)
Parameter Explanation
offset The code offset of the TurboIMAGE/XL procedure call in a CM procedure. It is the
virtual memory address of the TurboIMAGE/XL procedure call in a NM procedure.
retstat The return status (from the first element of status) printed as a decimal integer and
corresponding to the return statuses described in appendix A.
intrinsicname The name of the TurboIMAGE/XL library procedure (intrinsic) which was called and
which sets the contents of the status array.
x The value of the mode parameter as a decimal integer.
setname The value of the second parameter, usually a data set name or number, as passed to
the procedure which set the status array contents. The second parameter can be a
data item name or number if the procedure in question is DBINFO. If the procedure is
DBOPEN, DBLOCK, DBUNLOCK, or certain modes of DBINFO or DBCLOSE,
setname is
omitted.
password The word printed at the end of line 3 only if the error relates to the password
parameter of DBOPEN.
basename The database specified in the procedure which was called and set the status array
contents.
message A description of the result based on the condition word and other status array
information. The message is generated by the DBERROR procedure which is also
described in this chapter. See Table 5-9 for all possible messages returned in line 4.
hex display A listing of each halfword of status printed as a string of 4 hex digits. Adjacent status
elements are separated by a blank and the entire line is 49 characters long. The hex
display is generated for NM applications only.
octal display A listing of each halfword of status printed as a string of 6 octal digits. Adjacent status
elements are separated by a blank and the entire line is 49 characters long. The octal
display is generated for CM applications only.