TurboIMAGE/XL Database Management System Reference Manual (30391-90012)

88 Chapter3
Defining a Database
Schema Processor Output
commands. The error count is also sent to $STDLIST if it is different from the list file.
• If no schema syntax or logical errors are encountered, a third line is printed. The form
of this line is:
ROOT LENGTH: r BUFFER LENGTH: b TRAILER LENGTH: t
ROOT LENGTH is the length in halfwords of the body of the root file. BUFFER
LENGTH is the length in halfwords of each of the data buffers (unused by
TurboIMAGE/XL but provided for compatibility with TurboIMAGE on MPE V; refer to
the discussion on buffer specifications in appendix H). TRAILER LENGTH is the length
in halfwords of an area in the control block used by TurboIMAGE/XL to transfer
information to and from a calling program's stack.
• If no errors are detected and the ROOT option is active, the following message is sent to
the list file:
ROOT FILE database name CREATED
where database name is the name given in the BEGIN DATABASE statement in the
schema.
• The initial capacity and increment entries are optional parameters. If dynamic
expansion is required, include these parameters when defining the detail data set (See
chapter 3.) For existing databases, use DBChange Plus or other third-party tools you
may be using to specify the expansion parameters.
Schema Errors
When the Schema Processor detects an error, it prints a message to the list file. If the LIST
option is active, it is printed immediately after the offending statement. If NOLIST is
active, the current line of the schema is printed, followed by the error message.
Schema Processor error messages are explained in appendix A. The root file is not created
if any of the listed errors are detected. However, the Schema Processor attempts to
continue checking the schema for logical and syntactical correctness.
One error can obscure detection of subsequent errors, particularly if it occurs early in a
data set. It may be necessary to process the schema again after the error is corrected to
find subsequent errors. Conversely, some errors early in the schema can generate
subsequent apparent errors which will disappear after the original error has been
corrected.
If schema errors prohibit creation of the root file, the following message is sent to the list
file and to $STDLIST if it is not the same as the list file:
PRECEDING ERRORS -- NO ROOT FILE CREATED
A few conditions, including the number of errors exceeding the total number allowed,
cause immediate termination of the Schema Processor without the normal summary lines.
In this case, the following message is printed:
SCHEMA PROCESSING TERMINATED