The YottaDB Message and Recovery Procedures Reference Manual describes the meaning of messages issued by YottaDB components, including the M compiler, the run-time system and utility programs.
This manual is organized alphabetically according to the message identifier. The meaning of each message is provided, as well as suggestions for locating and addressing the cause of error-type messages.
The YottaDB Message and Recovery Procedures Reference Manual helps you understand and act on YottaDB messages. This manual complements the other YottaDB manuals.
The YottaDB Message and Recovery Procedures Reference Manual is intended to be used primarily to determine the nature of a message and interpret its meaning. Therefore, messages are listed in alphabetical order, according to the mnemonic that precedes them. Cross references to additional information are provided in individual entries, as appropriate.
YottaDB messages are identified by a signature of the form YDB-s-abcdef where -s- is a severity indicator and abcdef is an identifier. The severity indicators are: -I- for informational messages, -W- for warnings, -E- for errors and -F- for events that cause a YottaDB process to terminate abnormally. For more information on monitoring YottaDB messages, refer to “Appendix B: Monitoring YottaDB Messages” in the Administration and Operations Guide.
Each entry in this manual is presented in the following format as illustrated by the NOTPRINCIO message.
1. NOTPRINCIO 2. NOTPRINCIO, Output currently directed to device xxxx 3. Run Time Warning: This message displays the current device xxxx when it is not the principal device and the process enters Direct Mode. 4. Action: To redirect all I/O to the terminal, note the current device or save it in a temporary variable and USE $P. If you decide to resume program execution, remember to restore the current device with a USE command.
- 1 indicates the unique mnemonic preceding the error message and is the component by which the entry is alphabetized.
- 2 indicates the mnemonic and the actual message that accompanies it.
- 3 indicates the YottaDB component that generates the message, its severity, and a short description of its implication(s).
- 4 suggests action(s) to take when the message appears.
This manual can be used with YottaDB on any of its supported platforms. However, because in some instances the suggested actions are more useful when platform-specific information is provided, the following conventions are used as necessary.
Although the terms “host shell command” and “file-specification” have some platform-specification connotations, they are used in their most generic sense throughout this manual. The former describes commands that originate from the host operating system, rather than from YottaDB. The latter may refer to a simple file name or a full directory path to that file.
An “initiating instance” is always the instance that first records a transaction (including non-TP mini-transactions). A “replicating instance” is always the instance following the action of an “originating instance”, previously called “root primary”. We have called secondaries that replicate propagating primaries, but they are not originating instances.
When the suggested action is to “Report the error to the group responsible for database integrity at your operation,” you may also refer to the Maintaining Database Integrity chapter in the Administration and Operations Guide.
For information about utility-generated messages, refer to the chapter that describes that utility in the Administration and Operations Guide.
If a MUPIP LOAD error occurs, ensure that the proper media is loaded and that the command input includes the proper file-specification.
If the input file is FORMAT=GO or ZWR, the database should contain the correct content to the point where the failure occurred and should be usable. You can edit and possibly correct the input file.
If the input file is FORMAT=BIN, the database is probably corrupt. Fix the database intergrity issues and EXTRACT the file again.
For more information on LOAD and EXTRACT, refer to the General Database Management chapter in the Administration and Operations Guide.
For information on salvaging damaged extracts, refer to the Maintaining Database Integrity chapter in the Administration and Operations Guide.
For details on the internals of spanning nodes, refer to the YottaDB Database Structure (GDS) chapter in the Administration and Operations Guide.
The plug-in architecture of YottaDB allows you to choose your preferred encryption software. Some plugin errors that you may encounter are as follows:
Database file <path> not found
Plugin error: The plugin is unable to find the specified database file.
Action: Verify that the database file exists, the corresponding entry in the master key file points to the database file, and appropriate authorizations exist in the directory path and the database file.
Encryption handle corrupted
Plugin error: The plugin detected an internal error.
Action: This error indicates that there is a communication error between YottaDB and the gtmcrypt plug-in. Replace the process with an undamaged one. Report the entire incident context to your YottaDB support channel.
Encryption key file <path> not found
Plugin error: The plugin was not able to find the key file on the specified path.
Action: Verify that the master key file entry for this key file points to the correct path. Verify that the key file itself exists. Verify proper authorizations on directory path and file.
Encryption library has not been initialized
Plugin error: A gtmcrypt function was called before gtmcrypt_init().
Action: Call gtmcrypt_init() before calling any other encryption functions.
For more information on the plug-in errors and their fixes, see the documentation of your preferred encryption software.
Appendix B: Reference Implementation Error messages lists some errors that the YottaDB team encountered while testing YottaDB’s plug-in architecture with GNU Privacy Guard, the widely available implementation of Pretty Good Privacy (see “PGP: Pretty Good Privacy” by Simson Garfinkel).
Database errors reported by MUPIP INTEG differ in impact and severity. Some require an immediate action to prevent extending the damage, action on other less severe errors may be delayed.
The following table outlines the MUPIP INTEG error messages with their severity using the codes as listed below:
|A||Access: Prevents Database Access|
|B||Benign: Presents no risk of additional damage and has little or no effect on database performance|
|D||Dangerous: Presents a high risk that continuing updates may cause significant additional damage|
|I||Index: If the block is an index block, continuing updates will be quite dangerous: treat as a D; if the block is a datablock, continuing updates can only cause limited additional damage.|
|T||Transient: Usually cleared by an update to the database.|
MUPIP INTEG Error Messages
|Error Name||Message||Severity||Section *|
|DBBADKYNM||Bad Key Name||I||K1|
|DBBADNSUB||Bad numeric subscript||I||K1|
|DBBADPNTR||Bad pointer value in directory||D||K4|
|DBBDBALLOC||Block doubly allocated||D||K3|
|DBBFSTAT||Block busy/free status unknown (local bitmap corrupted)||D||M1|
|DBBNPNTR||Bit map block number as pointer||D||K4|
|DBBPLMGT2K||Blocks per local map is greater than 2K||D||I3|
|DBBPLMLT512||Blocks per local map is less than 512||D||I3|
|DBBPLNOT512||Blocks per local map is not 512||D||I3|
|DBBSIZZRO||Block size equals zero||A||I3|
|DBCOMPTOOLRG||Record has too large compression count||I||O2|
|DBDATAMX||Record too large||B||O5|
|DBFGTBC||File size larger than block count would indicate||B||I4|
|DBFSTBC||File size smaller than block count would indicate||D||I4|
|DBFSTHEAD||File smaller than database header||A||I3|
|DBGTDBMAX||Key larger than database maximum||I||K7|
|DBHEADINV||Header size not valid for database||A||I3|
|DBINCLVL||Block at incorrect level||D||O1|
|DBINCRVER||Incorrect version of YottaDB database||A||I2|
|DBINVGBL||Invalid mixing of global names||D||K3|
|DBKEYGTIND||Key greater than index key||I or B||K2 or O5|
|DBKGTALLW||Key larger than maximum allowed length||I||K1|
|DBLOCMBINC||Local bitmap incorrect||B||M1|
|DBLRCINVSZ||Last record of block has invalid size||I||K5|
|DBLTSIBL||Key less than sibling’s index key||I||K2|
|DBLVLINC||Local map block level incorrect||B||M2|
|DBMAXKEYEXC||Maximum key size for database exceeds design maximum||D||I3|
|DBMAXRSEXBL||Maximum record size for database exceeds what the block size can support||D||I3|
|DBMBMINCFREZ||Master bit map incorrectly asserts this local map has free space.||B||M1|
|DBMBPFLDIS||Master bit map shows this map full, in disagreement with both disk and INTEG results||B||M1|
|DBMBPFLDLBM||Master bit map shows this map full, agreeing with disk local map||B||M1|
|DBMBPFLINT||Master bitmap shows this map full, agreeing with MUPIP INTEG||B||M1|
|DBMBPFRDLBM||Master bit map shows this map has space, agreeing with disk local map||B||M1|
|DBMBPFRINT||Master bit map shows this map has space, agreeing with MUPIP INTEG||B||M1|
|DBMBPINCFL||Master bit map incorrectly marks this local map full||B||M1|
|DBMBSIZMN||Map block too small||B||M2|
|DBMBSIZMX||Map block too large||B||M2|
|DBMBTNSIZMX||Map block transaction number too large||T||I6|
|DBMRKBUSY||Block incorrectly marked busy||B||M1|
|DBMRKFREE||Block incorrectly marked free||D||M1|
|DBMXRSEXCMIN||Maximum record size for database is less than the design minimum||D||I3|
|DBNOTDB||File does not have a valid GDS file header||A||I3|
|DBNOTMLTP||Block size not a multiple of 512 bytes.||A||I3|
|DBRBNLBMN||Root block number is a local bit map number||D||K4|
|DBRBNNEG||Root block number negative||D||K4|
|DBRBNTOOLRG||Root block number greater than last block number in file||D||K4|
|DBREADBM||Read error on bitmap||D||H7|
|DBRLEVLTONE||Root level less than one||D||O1|
|DBRLEVTOOHI||Root level higher than max||D||O1|
|DBSPANCHUNKORD||Chunk of blocks is out of order||B||O5|
|DBSPANGLOINCMP||Spanning node is missing||B||O5|
|DBSVBNMIN||Start VBN smaller than possible||A||I3|
|DBSZGT64K||Block size greater than 64K||A||I3|
|DBTNNEQ||Current tn and early tn are not equal||T||I6|
|DBTNTOOLG||Block transaction number too large||T||I6|
|DBTTLBLK0||Total blocks equal zero||A||I4|
|DBUNDACCMT||Cannot determine access method ; Trying with BG||T||I6|
Section * refers to the specified section in the Finding and Fixing Database Errors chapter of the Administration and Operations Guide. The section details a description along with the action item to be taken on encountering the error message.