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

84 Chapter3
Defining a Database
$CONTROL
$CONTROL
The $CONTROL command allows you to specify options in relation to processing the schema.
Syntax
$CONTROL [LIST
NOLIST] [,ERRORS= nnn ][,LINES= nnnn ][,ROOT
,NOROOT]
[,BLOCKMAX= nnnn ] [,TABLE ,NOTABLE] [,JUMBO ,NOJUMBO]
[, ODDPALLOWED] [,UNSIGNED BLOCKS ,NOUNDIGNED BLOCKS] [,LARGESET]
Parameters
LIST causes each source record of the schema to be printed on the list file.
NOLIST specifies that only source records with errors be printed on the list file. An
error message is printed after these records.
ERRORS=
nnn sets the maximum number of errors to nnn. If more than nnn errors are
detected, the Schema Processor terminates. nnn can have a value between
0 and 999, inclusive. The default value is 100.
LINES=
nnnnn sets the number of lines per page on the list file to nnnnn which can be
between 4 and 32767, inclusive. The default value is 60 if the list file is a
line printer and 32767 if it is not.
ROOT causes the Schema Processor to create a root file if no errors are detected
in the schema. This is the default.
NOROOT prevents the Schema Processor from creating a root file.
BLOCKMAX=
nnnn sets the maximum physical block length (in halfwords) for any data set in
the database. nnnn can have a value between 128 and 2560, inclusive. The
default value is 512. This is an important parameter and is discussed in
detail in the section "Selecting the Block Size."
TABLE causes the Schema Processor to write a table of summary information
about the data sets to the list file device if no errors are detected. This is
the default.
NOTABLE suppresses the TABLE option.
JUMBO allows a data set, defined following this option whose capacity is greater
than 4 GB, to automatically become a jumbo data set.
NOJUMBO disallows data sets, defined following this option, to be jumbo data sets.
ODDPALLOWED DBSCHEMA will return an error if the sub-item length of the P data type
is an odd number. Use this option to bypass the checking. However, the
product of the sub-item length and sub-item count still needs to be evenly
divisible by 4.
UNSIGNEDBLOCKS DBSCHEMA will use the sign bit of the record name (internal pointer