SAND CDBMS Error Messages Guide
Nconfig Error Messages, Warnings, and Prompts

 

This document lists each of the error, warning, and prompt messages that may be displayed by the SAND Database Configuration tool (nconfig). Each message is accompanied by a description of the circumstances under which the message might be issued, along with some recommended course of action.

 

Bad numeric value 'x'
This error message is displayed when a non-numeric value (x) is entered at the ‘Enter drive number to modify: ’ prompt in the File Configuration menu (Modify option). The input value must be a number from 0 to n, where n is the highest data drive number defined for the database.

Bad numeric value: x
This error message is displayed when a non-numeric value (x) is entered at the ‘Enter file size limit...’ prompt in the File Configuration menu (Add or Modify option), or at the ‘Enter tempfile size limit...’ prompt after selecting the Tempfile Directory command. The desired file size must be a numeric value.

Block count must be <= n
This error message is displayed when the value entered at the ‘Enter file size limit...’ prompt in the File Configuration menu (Add or Modify option) exceeds the maximum number of record blocks (n). This message is also returned when, after selecting the Tempfile Directory command, the value entered at the ‘Enter tempfile size limit...’ prompt exceeds the maximum temporary file size (n). Ensure that the desired file size limit is less than or equal to n.

Enter drive number to modify:
This prompt is displayed in the File Configuration menu (Modify option). Select the desired drive number from the list of defined data drives for the database.

Enter file path (x):
This prompt is displayed in the File Configuration menu (Add or Modify option). Enter the desired file path for the data drive, or enter a period (.) to specify the database server program (nserv) execution directory as the drive path. The default data drive path is x.

Enter file size limit (in x blocks) (n)
This prompt is displayed in the File Configuration menu (Add or Modify option). Enter the desired file size limit (in blocks of size x) for the new or modified data drive. The default file size limit is n.

Enter tempfile directory (x):
This prompt is displayed after selecting the Tempfile Directory command. Enter the desired temporary file directory path, or enter a period (.) to specify the database server program (nserv) execution directory. The default temporary file path is x.

Enter tempfile size limit (in x blocks) (n)
This prompt is displayed after selecting the Tempfile Directory command. Enter the desired temporary file size limit (in blocks of size x). The default temporary file size limit is n.

ERROR! Cannot open seed database in support directory
The seed database, ndb.n00 in the SAND CDBMS support directory, cannot be opened. Make sure that the ndb.n00 file is located in the support directory. If it is already there, it might be corrupted. Overwrite it with another copy of the seed database from the SAND CDBMS installation CD and run nconfig again.

ERROR! Cannot read seed database in support directory
The seed database, ndb.n00 in the SAND CDBMS support directory, cannot be read. This may be caused by one of the following conditions:

Ensure that no other process is using the seed database file before attempting the operation again. If the seed database file is corrupted, overwrite it with another copy of the seed database from the SAND CDBMS installation CD and run nconfig again. If the problem persists, consult the host machine or network administrator.

ERROR! Cannot reduce database drive x to less than the y records required by file z
This error message is displayed when the value entered at the ‘Enter file size limit...’ prompt in the File Configuration menu (Add or Modify option) is less than the number of data records currently stored in the drive. The drive file size must be at least as large as the number of records stored in it. It may be possible to decrease the size of the database file by executing the ndbchk -p database-name command to compact the database. In this case, run nconfig again to further reduce the file size of the data drive in question.

ERROR! Cannot reduce root database file size to less than the number of records that are currently in use: n
This error message is displayed when an attempt is made to reduce the maximum block setting for the primary partition to a number that is less than the number of blocks currently in use.

ERROR! Cannot reduce the number of database files to less than the current count of non-empty files in the target database.
This error message is displayed when an attempt is made to reduce the maximum number of blocks for a particular data file to less than the number of blocks already in use for the indicated file.

ERROR! Target database incompatible
This error message is displayed when attempting to access a database that was created by a version of nconfig that is not compatible with the current version of nconfig.

ERROR! Write error copying seed database
This error message is displayed following the nconfig invocation when no database name is included as a parameter and nconfig fails to copy the seed database (ndb.n00). Make sure that you have adequate access privileges on the current directory before attempting to invoke nconfig.

Exceeded drive maximum of n
This error message is displayed after attempting to add a data drive when the maximum number of data drives has already been reached. The number of data drives defined for the database must not exceed n.

FATAL ERROR: fm_read_spw(): can't find NUCLEUS environment variable
This message appears if the Nucleus environment variable has not been set. Consult the SAND CDBMS Program Installation and Configuration section in the SAND CDBMS Administration Guide for information about setting the Nucleus environment variable.

File read error - default configuration used
The database file specified in the Read File command or in the nconfig invocation cannot be read by nconfig. In such a case, nconfig automatically reads the seed database and uses the default database configuration.

File to read (x):
This prompt is displayed when the Read File command is selected from the main menu. Enter the name of an existing database to open with nconfig, or enter a nonexistent database name to create a new database with that name. The default is x, which is the name of the database specified as a parameter during the invocation of nconfig, or else “db.n00” if no database name was specified.

File to write (x):
This prompt is displayed when the Write File command is selected from the main menu. Enter the name of the database file to save. The default is x, which is the name of the database specified as a parameter during the invocation of nconfig or through the Read File command, or else “db.n00” if no database name was specified.

Incompatible database - default configuration used
This error message is displayed when the Read File command specifies an existing database that was created with a version of nconfig that is not compatible with the current version. In such a case, the existing database configuration record is set to the default of the current nconfig.

Invalid response, try again (y/n):
This prompt is displayed whenever the letter typed in response to a “yes-or-no” prompt is neither ‘y’ nor ‘n’. Enter ‘y’ (yes) or ‘n’ (no) in response to the previous prompt question.

Maximal filesize limit for this drive
This message is displayed when zero (0) is entered at the ‘Enter file size limit...’ prompt in the File Configuration menu (Add or Modify option). This value specifies the maximum file size limit for the data drive.

No limit for the tmpfile drive
This message is displayed when zero (0) is entered at the ‘Enter tempfile size limit...’ prompt after selecting the Tempfile Directory command. This value specifies “no limit” for the maximum size of the temporary file.

Overwrite current configuration? (y/n):
This prompt is displayed when the Default Configuration command is selected from the main menu. Enter ‘y’ (yes) to overwrite the current database configuration with the default, or ‘n’ (no) to abort this command.

Overwrite old configuration? (y/n):
This prompt is displayed when the Write File command is selected from the main menu and the “File to write” value has the same name as an existing database. Enter ‘y’ (yes) to overwrite the configuration record in the existing database with the current one, or ‘n’ (no) to abort this command.

Total blocks in database must be <= n
This error message is displayed when an attempt is made to allocate space to a data file that brings the total block allocation to more than n 1 MB (UNIX) or 64 KB (Windows) blocks, the database maximum. Re-execute the File Configuration command and specify a sufficiently reduced block allocation figure.

Unable to obtain exclusive lock on file '<primary database file>'
This message is returned when an exclusive lock (to prevent any write conflict) could not be obtained for the database file. This error may be caused by one the following conditions:

If necessary, have the system administrator grant the required permissions on the database file. Ensure that no other process is using the database file, and then attempt the operation again. If the database file was not properly unlocked by another process on a Windows platform, the file will automatically be unlocked by the operating system after a set timeout period; wait briefly before attempting the operation again. If the problem persists, consult the host machine or network administrator for further help.

Unable to open file '<primary database file>'
This error message is displayed when attempting to create a new database with the Write File command, but the specified file could not be created. This might occur if the user executing nconfig does not have write privileges on the directory where the database file is to be written. In this case, have the system administrator grant the required permissions, and then attempt the operation again.

Unknown command
This error message is displayed when an unrecognized command is entered at the nconfig prompt. In the main menu, enter ‘H’ (help) to view a list of the valid nconfig commands.

Usage: nconfig [ <dbname> ]
This message is displayed when nconfig invocation arguments are specified incorrectly. Re-execute the invocation according to the indicated syntax (refer to the SAND Database Configuration Tool (nconfig) chapter in the SAND CDBMS Tools Reference Guide for more information).

Value exceeds drive count: n
This error message is displayed when the value entered at the ‘Enter drive number to modify: ’ prompt in the File Configuration menu (Modify option) does not correspond to any of the drive numbers in the data drives list. The input value must be a number from 0 to n, where n is the highest data drive number defined for the database.

Want to issue a W(rite) before quitting? (y/n):
This prompt is displayed when the Quit command is selected in the main menu after altering the configuration record for an existing database, or after configuring a new database. Enter ‘y’ (yes) to return to the nconfig command prompt, and then enter ‘w’ to write the configuration record; or enter ‘n’ (no) to exit nconfig without saving the configuration changes.

WARNING: Database file n: '<old data drive>/<database file>' must be moved to '<new data drive>/<database file>'
This warning message is displayed when a drive path that contains a database file is changed through the File Configuration menu (Modify option) and the altered configuration record is subsequently saved. After quitting nconfig, move the specified database file to the new data drive, otherwise the database server program (nserv) will not be able to start an instance of the database.