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

226 Chapter5
TurboIMAGE/XL Library Procedures
DBPUT
information as the time, date, user identification number, and a copy of the new record to
be added.
If DBPUT is called within a dynamic transaction, a log record is written after the physical
transaction has been successfully completed. If the intrinsic cannot be completed, an error
is returned. This error condition must be checked, and you must decide to use DBXUNDO,
DBXEND, or continue with the remainder of the dynamic transaction. DBXUNDO will abort the
entire dynamic transaction. DBXEND will terminate the dynamic transaction; the
modifications completed thus far within the transaction will remain in the database.
Table 5-21. DBPUT Return Status Values
File System,
Memory
Management,and
Transaction
Management
Failures:
-1 FOPEN failure.
-3 FREADDIR failure.
-4 FREADLABEL failure.
-5 FWRITEDIR failure.
-6 FWRITELABEL failure.
-167 Cannot begin MPE XL XM transaction: XM error nn .
-168 Cannot attach n to MPE XL XM: file system error nn .
-169 Invalid mode for XM attach options.
-175 Cannot attach n to MPE XL XM: XM error nn .
-176 Cannot detach n from MPE XL XM: XM error nn .
-178 Cannot detach n from MPE XL XM: file system error nn .
-199 Cannot end MPE XL XM transaction: XM error nn .
-209 Invalid mode for XM detach options.
Calling Errors: -11 Bad database reference.
-12 No lock covers the data entry to be added. (Occurs only if
database is open in access mode 1.)
-14 Illegal intrinsic in current access mode.
-21 Bad data set reference.
-23 Data set not writable.
-24 Operation not allowed on automatic master data set.
-31 Bad mode.
-51 Bad list length.
-52 Bad list or bad item.
-53 Missing search or sort item.
-222 Only DBXUNDO allowed when a dynamic transaction
encounters an error.