Utility Error Messages [ TurboIMAGE/XL Database Management System Reference Manual ] MPE/iX 5.0 Documentation
TurboIMAGE/XL Database Management System Reference Manual
Utility Error Messages
Two types of error messages are generated by the utility programs. The
first type is conditional errors, which occur when a utility cannot begin
a function. Conditional errors do not cause utility program termination;
this is discussed in more detail below. The second type is unconditional
errors, which occur when a utility cannot complete a function.
Unconditional errors usually cause program termination.
Conditional errors are associated with accessing the specified database.
If you are in session mode, conditional errors can be corrected without
terminating the run. After printing the error message, all utility
programs, with the exception of DBUTIL, reprompt with the message "WHICH
DATABASE?", allowing you to reenter the database reference. If you wish
to terminate the utility program at this point, you can type a carriage
return with or without leading blanks. DBUTIL, after printing the error
message, reprompts with two greater than symbols (>>) at which point you
can exit or enter another command. When DBUTIL encounters any errors
while executing, a job control word (JCW) is set to 99. You can check
the JCW in batch mode to determine whether or not a command was accepted.
If you are in job mode and a conditional error occurs while a function is
executing, that function is terminated.
The messages associated with conditional and unconditional errors are
described along with their meanings in the sections entitled "Utility
Program Conditional Messages" and "Utility Program Unconditional
Messages."
Utility Program Conditional Messages
---------------------------------------------------------------
MESSAGE ACCESS DISABLED UNTIL RECOVERY HAS COMPLETED
MEANING Database is disabled for access, and recovery is
enabled.
ACTION Users will be able to access the database after the
recovery process has completed.
---------------------------------------------------------------
MESSAGE ACCT NAME MORE THAN 8 CHARACTERS
MEANING The acctname part of DBNAME2 is too long.
ACTION Use EDITOR to change the FILE command.
---------------------------------------------------------------
MESSAGE APPARENT BACKUP/LOGFILE MISMATCH
MEANING A call to DBPUT, DBUPDATE, or DBDELETE, that
apparently succeeded when logging to the original
database has failed during recovery.
ACTION Make sure the proper backup database was restored
and that the matching log file was used for
recovery.
---------------------------------------------------------------
--------------------------------------------------------------
MESSAGE AUTODEFER MUST BE DISABLED BEFORE ILR CAN BE
ENABLED
MEANING AUTODEFER option in DBUTIL has been enabled for the
database. ROLLBACK or ILR cannot be enabled while
deferred output is enabled.
ACTION Use DBUTIL to disable AUTODEFER and enable ILR or
ROLLBACK for the database.
---------------------------------------------------------------
MESSAGE AUTODEFER MUST BE DISABLED BEFORE ROLLBACK CAN BE
ENABLED
MEANING The rollback recovery option cannot be used when
the database has been enabled for AUTODEFER.
ACTION Use DBUTIL to disable AUTODEFER and enable ROLLBACK
for the database. (Refer to chapters 7 and 8 for
more information on roll-back recovery.)
---------------------------------------------------------------
MESSAGE BACKUP DATABASE AND LOG FILE DO NOT MATCH
MEANING The logid of the log file and the logid in the
database being recovered do not match; i.e., the
correct log file is not being used for recovery.
ACTION Make sure that the database is using the correct
log file.
---------------------------------------------------------------
MESSAGE BAD DATABASE REFERENCE
MEANING Database reference following the utility program
:RUN command has a syntax error.
ACTION Correct the error in session mode or press return
to terminate the program.
---------------------------------------------------------------
MESSAGE BAD MAINTENANCE WORD
MEANING User invoking the utility is not the creator of the
referenced database and has not supplied the
correct maintenance word.
ACTION Correct the error in session mode or press return
to terminate the program.
---------------------------------------------------------------
MESSAGE CANNOT ENABLE BREAK KEY
MEANING Internal error.
ACTION Contact your database administrator.
---------------------------------------------------------------
MESSAGE CANNOT OPEN DATABASE
MEANING The database cannot be opened at this time. It
could already be open in a mode that does not allow
concurrent access.
ACTION Try the DBUTIL command again later.
---------------------------------------------------------------
MESSAGE CANNOT PARSE LOG FILE NAME
MEANING Internal error.
ACTION Contact your database administrator.
---------------------------------------------------------------
[REV BEG]
MESSAGE Cannot process data set file filename
MEANING Cannot read/write to the file due to a file system
error. Another process may have exclusive access
to the data set.
ACTION Check if the data set file exists or is locked.
Retry.
--------------------------------------------------------------- [REV END]
MESSAGE CAN'T RECOVER DATA BASES IN STATISTICAL MODE
MEANING The CONTROL STATS command was entered subsequent to
a RECOVER command.
ACTION Rerun DBRECOV without using statistical mode, or
use statistical mode without specifying databases
or recovery.
---------------------------------------------------------------
MESSAGE CAN'T OPEN DATABASE- DBERROR message
MEANING Database cannot be opened.
ACTION Check the DBERROR message to determine the problem.
---------------------------------------------------------------
MESSAGE CHECKSUM FAILURE ON LOG RECORD #n -EOF ASSUMED
MEANING Can occur if the system failed and a startup
recovery is not performed. Also can occur if a
statistical recovery is used against an open log
file.
ACTION You may want to use a start recovery operation in
the future, but this is not absolutely necessary.
---------------------------------------------------------------
MESSAGE COULD NOT FIND OPEN DATABASE IN DATABASE TABLE
MEANING Internal error.
ACTION Contact your database administrator.
---------------------------------------------------------------
MESSAGE CURRENT SINGLE TRANSACTION DOESN'T MATCH LOG
TRANSACTION
MEANING Internal error.
ACTION Contact your database administrator.
---------------------------------------------------------------
MESSAGE CURRENT TRANSACTION DOESN'T MATCH LOG FILE
TRANSACTION
MEANING Internal error.
ACTION Contact your database administrator.
---------------------------------------------------------------
MESSAGE DATABASE-ACCESS FILE DOES NOT EXIST
MEANING No such file exists in the logon user or account.
ACTION Check the files in group to determine the correct
file name.
---------------------------------------------------------------
MESSAGE DATABASE-ACCESS FILE NAME MAY NOT BE QUALIFIED
MEANING The DBA file name cannot be qualified with group
and account.
ACTION Log on in the same group and account as the
database- access file.
---------------------------------------------------------------
MESSAGE DATABASE-ACCESS FILENAME TOO LONG
MEANING The file name has more than six characters.
ACTION Rename the file and try DBUTIL again.
---------------------------------------------------------------
MESSAGE DATABASE ALREADY CREATED
MEANING You have invoked DBUTIL in the CREATE mode and
specified the name of a database which already
exists.
ACTION In session mode, correct the error or press return
to terminate program.
---------------------------------------------------------------
MESSAGE DATABASE ALREADY DISABLED FOR option
MEANING The option has already been disabled for this
database.
ACTION Press return to terminate the program.
---------------------------------------------------------------
MESSAGE DATABASE ALREADY ENABLED FOR INDEXING USING
third-party product name
MEANING This message is returned if you are using
third-party indexing (TPI). The message is
generated from the DBUTIL ENABLE database name FOR
INDEXING command if this database has already been
enabled for indexing.
ACTION This message is generated from the DBUTIL ENABLE
command, and you can disregard it if you want the
database to remain enabled for indexing. You can
use the DBUTIL SHOW command to verify whether or
not indexing is enabled for a particular
third-party product.
---------------------------------------------------------------
MESSAGE DATABASE ALREADY ENABLED FOR option
MEANING The option has already been enabled for this
database.
ACTION Press return to terminate the program.
---------------------------------------------------------------
MESSAGE DATABASE CANNOT BE ERASED UNTIL RECOVERY HAS
COMPLETED
MEANING Erasing database is attempted when recovery was
started but not completed, or while recovery is in
RESTART mode.
ACTION Press return to terminate program. After the
recovery process has completed, the user can run
DBUTIL again.
---------------------------------------------------------------
MESSAGE DATABASE CANNOT BE PURGED UNTIL RECOVERY HAS
COMPLETED
MEANING Purging the database is attempted when recovery was
started but not completed, or while recovery is in
RESTART mode.
ACTION Press return to terminate program. After the
recovery process has completed, the user can run
DBUTIL again.
---------------------------------------------------------------
MESSAGE DATABASE CONFIGURED FOR INDEXING USING third-party
product name, BUT NOT ENABLED FOR INDEXING
MEANING This message is returned if you are using
third-party indexing (TPI). The message is
generated from the DBUTIL DISABLE database name FOR
INDEXING command if the database has not yet been
enabled for indexing. Even if the database is
configured for indexing, by default it remains
disabled for indexing until the database is enabled
for indexing either by the TPI configuration
utility or the DBUTIL ENABLE command.
ACTION Disregard the message if you want the database to
remain disabled for indexing.
---------------------------------------------------------------
MESSAGE DATABASE CONTAINS INVALID LOGGING IDENTIFIER
MEANING The log identifier in the database root file does
not exist in the MPE logging identifier table.
ACTION Use DBUTIL to set a valid log identifier into the
database.
---------------------------------------------------------------
MESSAGE DATABASE HAS BEEN MODIFIED SINCE LAST RESTORE
MEANING The DBSTORE flag has not been reset. This can mean
a backup database has not been restored, or that
there have been modifications since the last
restoration.
ACTION Restore the backup database, or use the CONTROL
NOSTORE option and reenter the RECOVER command.
---------------------------------------------------------------
MESSAGE DATABASE n HASN'T BEEN CREATED YET
MEANING The database creator must run DBUTIL and CREATE the
database.
ACTION In session mode, correct the error or press return
to terminate the program.
---------------------------------------------------------------
MESSAGE DATABASE IN USE
MEANING Utility program cannot get exclusive access to the
referenced database due to other current users.
ACTION In session mode, press return to terminate the
program.
---------------------------------------------------------------
MESSAGE DATABASE IS NOT ATTACHED TO ANY HP SQL
DBEnvironment
MEANING This message is returned if you are not using
ALLBASE/Turbo CONNECT (ATC) and specify an
ATC-specific option. In this case, the DETACH
option of the DBUTIL PURGE command is specified,
but the database is not attached to any ALLBASE/SQL
database environment (DBEnvironment).
ACTION Contact your database administrator.
---------------------------------------------------------------
MESSAGE DATABASE IS NOT EMPTY. LANGUAGE CANNOT BE CHANGED
MEANING The language can be changed only on a virgin root
file or an empty database.
ACTION In session mode, press return to terminate the
program.
---------------------------------------------------------------
MESSAGE DATABASE IS REMOTE
MEANING You must be logged on to the same group and account
containing the root file to use DBUTIL.
ACTION Do a remote logon and run DBUTIL from your remote
session.
---------------------------------------------------------------
MESSAGE DATABASE LANGUAGE NOT SYSTEM SUPPORTED
MEANING The language of the database is not currently
configured on your system.
ACTION Notify the database administrator.
---------------------------------------------------------------
MESSAGE DATABASE NAME MAY NOT BE QUALIFIED
MEANING The database name cannot be qualified with group
and account.
ACTION Log on to the same group and account as the
database and reenter the command.
---------------------------------------------------------------
MESSAGE DATABASE NAME TOO LONG
MEANING The database name you specified has more than six
characters.
ACTION Try the command again with the correct name.
---------------------------------------------------------------
MESSAGE DATABASE NOT ENABLED FOR RECOVERY
MEANING The recovery flag in the database root file is
disabled.
ACTION Be sure you are running recovery against the
appropriately restored database. You can override
the disable flag with DBUTIL if necessary.
---------------------------------------------------------------
MESSAGE DATABASE OR ACCESS FILE DOES NOT EXIST
MEANING No such file exists in logon group or account.
ACTION Check the files in your group to find the correct
file name.
---------------------------------------------------------------
MESSAGE DATABASE OR FILE ACCESS NAME REQUIRED
MEANING The command must include the database or access
file name.
ACTION Reenter the command.
---------------------------------------------------------------
MESSAGE DATABASE OR FILE ACCESS NAME TOO LONG
MEANING File name has more than six characters.
ACTION Reenter the command with the correct name.
---------------------------------------------------------------
MESSAGE DATABASE REQUIRES CREATION
MEANING The database creator must run the DBUTIL program in
CREATE mode prior to executing DBUNLOAD, DBLOAD, or
DBUTIL in ERASE mode.
ACTION In session mode, correct the error or press return
to terminate the program.
---------------------------------------------------------------
MESSAGE DATA SET n IS MISSING
MEANING The data set could have been purged, or was not
restored.
ACTION Contact your database administrator or system
manager.
---------------------------------------------------------------
MESSAGE DBLOAD TO DIFFERENT DATABASE NAME
MAINTENANCE WORD IS NOT ALLOWED
MEANING The DBLOAD database name and maintenance word must
be the same as those used for DBUNLOAD.
ACTION Use a database name and maintenance word which were
used for the DBUNLOAD.
---------------------------------------------------------------
MESSAGE DBLOAD TO DIFFERENT GROUP OR ACCOUNT IS NOT
ALLOWED.
MEANING DBLOAD must be done from the same group and account
as the DBUNLOAD file.
ACTION Log on to the same group and account from which the
DBUNLOAD was done. Then use DBLOAD again.
---------------------------------------------------------------
MESSAGE DBNAME DBSTORE OF TIME, DATE REQUIRED
MEANING DBSTORE timestamp in database does not match those
in DBOPEN records.
ACTION Restore the proper database or use the proper log
file. You can also use the NOSTAMP option in
recovery.
---------------------------------------------------------------
MESSAGE DBNAME1 MORE THAN SIX CHARACTERS
MEANING dbname1 is too long.
ACTION Use EDITOR to change the FILE command.
---------------------------------------------------------------
MESSAGE DETACH FAILED FROM DBEnvironment name
MEANING This message is returned if you are using
ALLBASE/Turbo CONNECT (ATC). The message is
generated from the DBUTIL PURGE command used with
the DETACH option. The database is attached to the
indicated ALLBASE/SQL database environment
(DBEnvironment), but the DETACH option is
unsuccessful due to ATC error nn. The PURGE
command will continue processing after the warning
is issued.
ACTION Notify your database administrator.
---------------------------------------------------------------
MESSAGE 'DEV' MISSING
MEANING Either the keyword DEV or the equal sign (=)
following it was not found.
ACTION Use EDITOR to change the FILE command.
---------------------------------------------------------------
MESSAGE DEVICE NOT 'DISC'
MEANING The string following the "#" sign was not "DISC."
ACTION Use EDITOR to change the FILE command.
---------------------------------------------------------------
MESSAGE DSDEVICE DOESN'T MATCH FILE COMMAND
MEANING The dsdevice name in the DSLINE command was not the
same as the dsdevice name in the FILE command.
ACTION Use EDITOR to change the command which is in error.
---------------------------------------------------------------
MESSAGE DSDEVICE NAME MORE THAN 8 CHARACTERS
MEANING The dsdevice name is too long.
ACTION Use EDITOR to change the command which is in error.
---------------------------------------------------------------
MESSAGE DUPLICATE FILE NAME
MEANING The required file name is already assigned to
another file. Example: If the ORDERS database
requires six data sets (ORDERS01-ORDERS06), then a
previously defined file ORDERS03 will trigger this
message. This can occur if a database is not
purged before running DBRESTOR.
ACTION In session mode, correct the error or press return
to terminate the program.
---------------------------------------------------------------
MESSAGE EMBEDDED BLANK IN DBNAME2
MEANING One of the periods separating the user name from
the group name or the group name from the account
name was preceded or followed by a blank.
ACTION Use EDITOR to change the MPE FILE command.
---------------------------------------------------------------
MESSAGE ERROR READING ROOT FILE LABEL
MEANING DBUTIL is unable to read the root file.
ACTION Contact your HP systems engineer.
---------------------------------------------------------------
MESSAGE ERROR READING ROOT FILE RECORD
MEANING DBUTIL is unable to read a root file record.
ACTION Contact your HP systems engineer.
---------------------------------------------------------------
MESSAGE ERROR WRITING ROOT FILE LABEL
MEANING DBUTIL found an error while writing the root file
label.
ACTION Contact your HP systems engineer.
---------------------------------------------------------------
MESSAGE ERROR WRITING ROOT FILE RECORD
MEANING DBUTIL found an error while writing to a root file
record.
ACTION Contact your HP systems engineer.
---------------------------------------------------------------
MESSAGE EXCEEDS ACCOUNT DISC SPACE
MEANING Amount of space required by the database plus the
space already assigned to other files exceeds the
disk space available to the account.
ACTION Request the system manager to increase account's
disk space.
---------------------------------------------------------------
MESSAGE EXCEEDS GROUP DISC SPACE
MEANING The amount of disk space required by the database
plus the space assigned to other files in the group
exceeds the amount of disk space available to the
account.
ACTION Request the system manager to increase the group's
disk space.
---------------------------------------------------------------
MESSAGE EXPECTED DATABASE STATE TO BE "CLOSED"
MEANING Internal error.
ACTION Contact your database administrator.
---------------------------------------------------------------
MESSAGE FCHECK FAILURE
FCLOSE FAILURE
FCONTROL FAILURE
FENTRY FAILURE
FGETINFO FAILURE
MEANING These are exceptional errors indicating a hardware
or software failure.
ACTION Notify your database administrator of the failure.
---------------------------------------------------------------
MESSAGE FFILEINFO INTRINSIC FAILED
MEANING Internal error.
ACTION Contact your database administrator.
---------------------------------------------------------------
MESSAGE FGETINFO CANNOT VERIFY THAT FILE IS TYPE "LOG"
MEANING Internal error.
ACTION Contact your database administrator.
---------------------------------------------------------------
MESSAGE FGETINFO INTRINSIC FAILED
MEANING Internal error.
ACTION Contact your database administrator.
---------------------------------------------------------------
MESSAGE FILE CODE IS NOT 0.
MEANING The database-access file to be activated has a file
code of other than 0.
ACTION Be sure you have the correct EDITOR file.
---------------------------------------------------------------
MESSAGE FILE EQUATES ARE ILLEGAL FOR DATABASE AND DATABASE
ACCESS FILE
MEANING DBUTIL does not allow you to equate the name of the
database or database-access file to another file
with the MPE FILE command.
ACTION Use the MPE RESET command to cancel the FILE
command. You can either break and resume execution
or exit DBUTIL and run it again.
---------------------------------------------------------------
MESSAGE FILE file name RECSIZE TOO SMALL: LOG(S) TRUNCATED.
MEANING User recovery file size is too small to hold the
largest log record.
ACTION Increase record size or use variable length
records.
---------------------------------------------------------------
MESSAGE FILE NAME MAY NOT BE QUALIFIED
MEANING The file name cannot be qualified with group and
account.
ACTION Log on to the same group and account and reenter
the command.
---------------------------------------------------------------
MESSAGE FILE NAME MORE THAN SIX CHARACTERS
MEANING The file name part of dbname2 is too long.
ACTION Use EDITOR to change the FILE command.
---------------------------------------------------------------
MESSAGE FOPEN FAILURE ON logfilename:ferrmsg
MEANING You cannot open the log file.
ACTION Examine ferrmsg to determine the cause.
---------------------------------------------------------------
MESSAGE FREAD ERROR ON ASCII ACCESS FILE
MEANING Exceptional errors indicate a hardware or software
failure.
ACTION Notify the database administrator of the error.
---------------------------------------------------------------
MPE/iX 5.0 Documentation