About This Manual

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.

Intended Audience

This manual is for programmers and system managers who use YottaDB.

Purpose of the Manual

The YottaDB Message and Recovery Procedures Reference Manual helps you understand and act on YottaDB messages. This manual complements the other YottaDB manuals.

How to Use This Manual

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.

Conventions Used in this Manual

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 as follows:

  • -I- for informational messages

  • -W- for warnings

  • -E- for errors

  • -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.

where

  • 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.

Following Up on Suggested Actions

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.

MUPIP LOAD Errors

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.

Plug-In Errors

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).

MUPIP Integ Errors

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

Note

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.