Schema Processor Error Messages [ MPE/iX Error Messages Manual Volume III ] MPE/iX 5.0 Documentation
MPE/iX Error Messages Manual Volume III
Schema Processor Error Messages
The Schema Processor accesses three files:
* The text file (DBSTEXT) containing the schema records and Schema
Processor commands for processing.
* The list file (DBSLIST) containing the schema listing, if
requested, and error messages, if any.
* The root file, if requested, created as a result of an error-free
schema.
Any file error which occurs while accessing any of these files causes the
Schema Processor to terminate execution. A message indicating the nature
of the error is sent to $STDLIST (and to the list file, if the list file
is different from $STDLIST).
Schema Processor command errors may occur. They neither cause
termination nor do they prohibit the creation of a root file. In some
cases, however, the resultant root file will differ from what might have
occurred had the commands been error free. Command errors are added to
an error count which, if it exceeds a limit, will cause the Schema
Processor to terminate execution.
Note that if the LIST option is active, error messages for command errors
and syntax errors appear in the list file following the offending
statement. If the NOLIST option is active, only the offending statement,
followed by the error message, is listed.
Schema Processor File Errors
Various file error messages are listed in this section. Each such
message is preceded by the character string:
****** FILE ERROR ******
Additionally, the Schema Processor prints a standard MPE/iX file
information display on the $STDLIST file.
---------------------------------------------------------------
MESSAGE READ ERROR ON file name
CAUSE FREAD error occurred on the specified file.
ACTION Check text file or :FILE command.
---------------------------------------------------------------
MESSAGE FILE ALREADY EXISTS; UNABLE TO CLOSE file name
CAUSE FCLOSE error occurred on specified file. May be
caused by duplicate file in group with same name as
root file.
ACTION Change database name or purge file of same name.
Or, be sure correct file and file name used. Check
:FILE commands used. If other cause, consult
MPE/iX Intrinsics Manual (32650-90028) for similar
message.
---------------------------------------------------------------
MESSAGE UNABLE TO USE file name
CAUSE Specified file cannot be FOPENed or its
characteristics make it unsuitable for its intended
use.
ACTION Change database name or purge file of same name.
Or, be sure correct file and file name used. Check
:FILE commands used. If other cause, consult
MPE/iX Intrinsics Manual (32650-90028) for similar
message.
---------------------------------------------------------------
MESSAGE UNABLE TO WRITE LABEL OF file name
CAUSE FWRITELABEL error occurred on specified file.
ACTION Change database name or purge file of same name.
Or, be sure correct file and file name used. Check
:FILE commands used. If other cause, consult
MPE/iX Intrinsics Manual (32650-90028) for similar
message.
---------------------------------------------------------------
MESSAGE UNEXPECTED END-OF-FILE ON file name
CAUSE Call to FREAD or FWRITE on specified file has
yielded unexpected end of file condition.
ACTION Change database name or purge file of same name.
Or, be sure correct file and file name used. Check
:FILE commands used. If other cause, consult
MPE/iX Intrinsics Manual (32650-90028) for similar
message.
---------------------------------------------------------------
--------------------------------------------------------------
MESSAGE WRITE ERROR ON file name
CAUSE FWRITE error occurred on the specified file.
ACTION Change database name or purge file of same name.
Or, be sure correct file and file name used. Check
:FILE commands used. If other cause, consult
MPE/iX Intrinsics Manual (32650-90028) for similar
message.
---------------------------------------------------------------
Schema Processor Command Errors
Various Schema Processor command error messages are listed in this
section. Each such message is preceded by the character string:
***** ERROR ******
---------------------------------------------------------------
MESSAGE COMMAND CONTINUATION NOT FOUND
CAUSE If the schema processor command is continued to the
next record, the last non-blank character of the
preceding line must be an ampersand (&) and the
continuation record must start with a dollar sign
($).
ACTION Examine the schema text file to find any incorrect
commands. Edit the text file and run the Schema
Processor again.
---------------------------------------------------------------
MESSAGE COUNT HAS BAD FORMAT
CAUSE The numbers in ERRORS, LINES, or BLOCKMAX
parameters of the $CONTROL command are not properly
formatted integer values.
ACTION Examine the schema text file to find any incorrect
commands. Edit the text file and run the Schema
Processor again.
---------------------------------------------------------------
MESSAGE ILLEGAL COMMAND
CAUSE The Schema Processor does not recognize the
command. Valid commands are $PAGE, $TITLE, and
$CONTROL.
ACTION Examine the schema text file to find any incorrect
commands. Edit the text file and run the Schema
Processor again.
---------------------------------------------------------------
--------------------------------------------------------------
MESSAGE IMPROPER COMMAND PARAMETER
CAUSE One of the commands in the parameter is not valid.
ACTION Examine the schema text file to find any incorrect
commands. Edit the text file and run the Schema
Processor again.
---------------------------------------------------------------
MESSAGE MISSING QUOTATION MARK
CAUSE Character string specified in $PAGE or $TITLE
command must be bracketed by quotation marks (").
ACTION Examine the schema text file to find any incorrect
commands. Edit the text file and run the Schema
Processor again.
---------------------------------------------------------------
MESSAGE SPECIFIED TITLE IS TOO LONG
CAUSE Character string in $TITLE or $PAGE command exceeds
104 characters.
ACTION Examine the schema text file to find any incorrect
commands. Edit the text file and run the Schema
Processor again.
---------------------------------------------------------------
Schema Syntax Errors
Database definition syntax errors may be detected by the Schema
Processor. Their existence does not cause termination but does prohibit
root file creation. Discovery of one may trigger others which disappear
after the first is corrected. Also, detection of one may preclude
detection of others which appear after the first is corrected. Syntax
errors are also added to an error count which, if excessive, will cause
Schema Processor termination.
Various syntax error messages are listed in this section. As with
command errors, each syntax error is preceded by the character string:
***** ERROR ******
---------------------------------------------------------------
MESSAGE AUTOMATIC MASTER DATA SET MUST HAVE SEARCH ITEM
ONLY
CAUSE Automatic master data sets must contain entries
with only one data item. The data item must be a
key item.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD CAPACITY OR TERMINATOR
CAUSE Either the number in the CAPACITY: statement is not
an integer between 1 and 2 -1, or a semicolon is
missing.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD CHARACTER IN USER CLASS NUMBER
CAUSE User class number in password is not an integer
from 1 to 63.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD DATA BASE NAME OR TERMINATOR
CAUSE Database name in BEGIN DATA BASE statement is not a
valid database name beginning with an alphabetic
character and having up to 6 alphanumeric
characters. Or, the name is not followed by a
semicolon (;).
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD DATA SET TYPE
CAUSE The data set type designator is not AUTOMATIC (or
A), MANUAL (or M), or DETAIL (or D).
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD DEVICE CLASS NAME
CAUSE The device class name specified contains an invalid
character. The name must be less than eight
characters and begin with a letter.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD DEVICE CLASS NAME OR TERMINATOR
CAUSE The device class name specified contains an invalid
character or was not ended with a semicolon ";".
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD LANGUAGE
CAUSE Language name contains invalid characters, or the
language number is not a valid integer.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD PATH CONTROL PART DELIMITER
CAUSE Data item defined as sort item in detail data set
is not properly delimited with parentheses ().
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD PATH COUNT OR TERMINATOR
CAUSE The path count in the master data set definition is
not an integer from 1 to 16 (for an automatic
master), or 0 to 16 (for a manual master). This
message may also mean the path count is not
followed by a quotation mark (").
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD PATH SPECIFICATION DELIMITER
CAUSE Name of master data set following search item name
in detail data set definition is not followed by a
right parenthesis ")", or by a sort item name in
parentheses.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD READ CLASS OR TERMINATOR
CAUSE Read user class number defined for either a data
set or data item is not an integer from 0 to 63, or
it is not terminated by a comma (,) or slash (/).
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD SET NAME OR TERMINATOR
CAUSE The data set name does not conform to naming rules.
(Names must start with a letter and may have up to
16 alphanumeric characters including + - * / ? '
# % & @.) Or the data set name is not terminated
by the correct character for the context in which
it appears.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD SUBITEM COUNT OR TERMINATOR
CAUSE Subitem count for a data item defined in schema
item part is not an integer from 1 to 255.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD SUBITEM LENGTH OR TERMINATOR
CAUSE Subitem length for data item defined in schema item
is not an integer from 1 to 255.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD TERMINATOR-';' EXPECTED
CAUSE Password or capacity was not followed by a
semicolon.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD TERMINATOR- ';' OR ',' EXPECTED
CAUSE Items within an entry definition must be separated
from each other with commas and terminated with a
semicolon.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD TYPE DESIGNATOR
CAUSE Data item defined in schema item part is not
defined as type I, J, K, R, U, X, Z, or P.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE BAD WRITE CLASS OR TERMINATOR
CAUSE Write user class number shown for the data set or
data item is not an integer from 0 to 63, or it is
not terminated by a right parenthesis ")" or comma.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE 'CAPACITY:' EXPECTED
CAUSE CAPACITY statement must follow entry definition in
the definition of data sets in the set part of
schema.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE DATA BASE HAS NO DATA SETS
CAUSE No data sets were defined in the set part of
schema. The database must contain at least one
data set.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE DATA BASE NAME TOO LONG
CAUSE Database name has more than six characters.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE DUPLICATE ITEM SPECIFIED
CAUSE The same data item name was used more than once in
the entry definition of data sets.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE DUPLICATE SET NAME
CAUSE The same data set name was used to define more than
one data set in the set part of schema.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE 'ENTRY:' EXPECTED
CAUSE Each set defined in the set part of schema must
contain ENTRY: statement followed by the data item
names of the data items in entry.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE ENTRY TOO BIG
CAUSE The number and size of the data items defined for
an entry makes an entry too big for maximum block
size. The block size is specified by $CONTROL, or
BLOCKMAX= command, or default.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE ENTRY TOO SMALL
CAUSE A detail data set that is not linked to any master
data set must have a data entry length of two or
more halfwords. This length is determined by
adding the size in halfwords of each data item
defined in the data entry.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE ILLEGAL ITEM NAME OR TERMINATOR
CAUSE The data item name does not conform to naming
rules. (Names must start with a letter and may
have up to 16 alphanumeric characters including + -
? / # $ & * @ ). Or if in the item part, it is
not followed by a comma.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE ILLEGAL USER CLASS NUMBER
CAUSE User class number defined in schema password part
is not an integer between 1 and 63.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE ITEM TOO LONG
CAUSE The length of a single data item may not exceed
2047 halfwords.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE 'LANGUAGE:' EXPECTED
CAUSE The Schema Processor expected to find a LANGUAGE
statement after the comma following the BEGIN DATA
BASE name statement.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE LANGUAGE NOT SUPPORTED
CAUSE Language specified is not supported on your system,
or is not a valid language.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE MASTER DATA SET LACKS EXPECTED DETAIL(S)
CAUSE Master data set was defined with a non-zero data
count, but the number of detail search items which
back-referenced the master is less than the value
of the path count.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE MASTER DATA SET LACKS KEY ITEM
CAUSE A master data set was defined without defining one
of the data items in the set as a key item.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE MORE THAN ONE KEY ITEM
CAUSE A master data set cannot be defined with more than
one key item.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE MORE THAN ONE PRIMARY MASTER
CAUSE User has defined more than one primary path for a
detail data set.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE 'NAME:' OR 'END.' EXPECTED
CAUSE Schema Processor expected, at this point, to find
the beginning of another data set definition, or
the end of schema.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE NATIVE LANGUAGE SUPPORT ERROR
CAUSE NLS/3000 returned an error.
ACTION Notify the system manager
---------------------------------------------------------------
MESSAGE 'PASSWORDS:' NOT FOUND
CAUSE 'PASSWORDS:' statement must immediately follow the
BEGIN DATA BASE statement in schema. If it does
not, DBSCHEMA terminates execution.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE PASSWORD TOO LONG
CAUSE A password defined in data schema cannot exceed
eight characters.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE REFERENCED SET NOT MASTER
CAUSE The data set referenced by the detail data set
search item is another detail data set instead of a
master data set.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE SCHEMA PROCESSOR LACKS NEEDED TABLE SPACE
CAUSE Schema Processor is unable to expand its data stack
to accommodate all of the translated information
which will make up the root file. It continues to
scan the schema for the proper form, but will not
perform all of the checks for correctness nor will
it create a root file. To process the schema
correctly, the operating system must be configured
with a larger maximum stack size.
ACTION Ask system manager to increase maximum stack size.
---------------------------------------------------------------
MESSAGE SEARCH OR KEY ITEM NOT SIMPLE
CAUSE All data items defined in data schema as key or
search items must be simple items.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE SEARCH AND KEY ITEMS NOT OF SAME LENGTH
CAUSE Master key item must be the same length as any
related detail data set search item.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE SEARCH AND KEY ITEMS NOT OF SAME TYPE
CAUSE Master key item must be of the same type as any
related detail data set search item.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE SET HAS NO PATHS AVAILABLE
CAUSE More detail data set search items have specified a
relationship with a master data set than the number
specified in the master set's path count.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE SORT ITEM OF BAD TYPE
CAUSE Data item defined as sort item must be of type U,
K, or X.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE SORT ITEM NOT IN DATA SET
CAUSE Detail data set's entry definition does not include
an item which is specified as a sort item for
another item in the entry.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE SORT ITEM SAME AS SEARCH ITEM
CAUSE The same item cannot be both a search and a sort
item for the same path.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE TOO MANY DATA ITEMS
CAUSE The item part of schema cannot have more than 1023
data item names
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE TOO MANY DATA SETS
CAUSE The database cannot have more than 199 data sets.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE TOO MANY ERRORS
CAUSE The specified or default number of errors has been
exceeded. Processing is terminated.
ACTION Correct the errors, or increase the ERROR parameter
value.
---------------------------------------------------------------
MESSAGE TOO MANY ITEMS SPECIFIED
CAUSE The data set entry cannot have more than 255 data
items.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE TOO MANY PATHS IN DATA SET
CAUSE Detail data set entries cannot have more than 16
search items.
ACTION Examine the schema text file to find the error and
edit the file. Run the Schema Processor again.
---------------------------------------------------------------
MESSAGE UNDEFINED ITEM REFERENCED
CAUSE A data item appearing in the data set definition
was not previously defined in the item part of
schema.
ACTION Examine the schema text file and find the incorrect
statement. Edit it and run the Schema Processor
again.
---------------------------------------------------------------
MESSAGE UNDEFINED SET REFERENCED
CAUSE Master data set referenced by detail search item
was not previously defined in the set part of
schema.
ACTION Examine the schema text file and find the incorrect
statement. Edit it and run the Schema Processor
again.
---------------------------------------------------------------
MPE/iX 5.0 Documentation