
<<Database Manager General Information>>

The Clarion Database Manager allows you to interactively browse
through your data files.  While browsing through a file you may add,
delete, or change records.  This tool is provided to allow you
direct access to your data files without the need of creating an
application.

<Database Integrity Warning>
Database Integrity Warning

Caution should be used when making any changes to a data file in the
Database Manager.  There are no controls to prevent you from making
changes which could compromise the Data Integrity (invalid data
values) or the Referential Integrity ("orphan" Child records) of
your Database.

In an application, Data Integrity is ensured by the Edit Procedures
you put in your applications and the Validity Checks you specify in
the database Dictionary.  Edit Procedure code should be written to
allow the user to input only valid values in the field to which it
applies.

Referential Integrity maintenance is ensured by the Relationship
Constraints you specify in the Database Dictionary.  Changing the
values in fields which link records in two files, or deleting a
Parent record with existing Child records can compromise the
Referential Integrity of your Database.  This is discussed further
in the Database Design essay of the User's Guide, which is
recommended reading.

<Creating Empty Data Files>
Creating Empty Data Files

The Database Manager also creates empty data files for your
applications.  This allows you to leave the CREATE attribute off
the FILE declaration and provide your end-users with empty (or
pre-loaded) data files.  The advantage of this is the end-user
cannot create new data files through the application, forcing an
error if the data files are not found when the application
attempts to open them.

To create an empty data file, select New... from the pulldown menu
and create a Database file.  The Database Manager automatically asks
you for the Database Dictionary and file definition to use to create
the file, creates the data file for you, then allows you to
immediately add records (if you choose).


<<File Menu>>

The File menu contains selections for the normal file operations of
the Database Manager.

<New...>
New...                                    ( F2 or ALT+F N )

     Creates a new file. You specify the type of file you are
     creating (Application, Dictionary, Database, Text, or Help) and
     its name.  The new file is created and you are automatically
     placed in that file type's functional area.

<Open...>
Open...                                   ( F3 or ALT+F O )

     Opens an existing file. You specify the type of file you are
     opening (Application, Dictionary, Database, Text, or Help) and
     the name of the file.  You are automatically placed in that
     file type's major functional area.

<Close>
Close                                     ( ALT+F C )

     Closes the open Database file and returns you to the Clarion
     opening screen.

<Change Directory...>
Change Directory...                       ( ALT+F D )

    Allows you to change the DOS current directory. It is always a
    good idea to create applications in their own separate sub-
    directories.  Doing this makes it easy to identify the files
    that are part of an application and to delete those that are no
    longer needed when the application is complete (.OBJ files are
    one good example).

<Order...>
Order...                                  ( CTRL+O or ALT+F O )

     Allows you to change the display sequence of the file.

<Printer Setup...>
Printer Setup...                          ( ALT+F T )

     Allows you to setup your printer for the printing tasks you do
     through the Clarion environment.  It allows you to specify the
     destination (a file or the port to which your printer is
     connected), lines and columns per page, and pre-print and
     post-print printer control code strings.

<Print>
Print                                     ( ALT+F P )

     Calls the Print window to print one or more records from the
     Database file in Column or Form format.

<Exit>
Exit                                      ( CTRL+X or ALT+F X )

     Closes the open Database file and returns you to the Clarion
     opening screen.


<<Edit Menu>>

The Edit menu contains selections which allow you to maintain the
records contained in the data file.

<Insert>
Insert                                    ( INSERT or ALT+E I )

     Allows you to add a record to the data file.

<Change>
Change                                    ( ENTER or ALT+E H )

     Allows you to modify an existing record.

<Delete>
Delete                                    ( DELETE or ALT+E D )

     Allows you to remove a record from the data file.

<Search...>
Search...                                 ( CTRL+S or ALT+E S )

     Searches for the first record containing the value you specify.
     The search may be limited to one field or all fields in the
     record.  You may search for:  an exact match, a record with a
     field beginning with the value specified, a record with a field
     ending with the value specified, or a record with a field
     containing the value anywhere within it.

<Find Next >
Find Next                                 ( CTRL+N or ALT+E N )

     Places the cursor at the next occurrence of the value searched
     for with the Search... selection.

<Locate...>
Locate...                                 ( CTRL+L or ALT+E L )

     Searches for the first record containing the value you specify
     in the key field(s).  This option is only available when the
     data file is displayed in a keyed sequence, not in Record
     Number order.

<Filter...>
Filter...                                 ( CTRL+F or ALT+E F )

     Allows you to display a sub-set of the records based upon the
     filter criteria you specify.

<Edit Memo...>
Edit Memo...                              ( CTRL+T or ALT+E E )

     Allows you edit the text in a MEMO field associated with
     the currently highlighted record.

<Hex Edit Memo>
Hex Edit Memo                             ( ALT+E H )

     Toggles the mode in which you edit a MEMO field associated
     with the currently highlighted record from ASCII Text to
     Hexadecimal format.

<Adjust Dimension...>
Adjust Dimension                          ( CTRL+D or ALT+E A )

     Allows you to specify the array element you want to be
     displayed in the array field's column.

<Next Dimension>
Next Dimension                            ( Grey + or ALT+E N )

     Displays the next array element.

<Previous Dimension>
Previous Dimension                        ( Grey - or ALT+E P )

     Displays the previous array element.


<<Column Menu>>

The Column menu contains selections which govern the manner in which
the data file's records are displayed.

<Hide>
Hide                                      ( ALT+L H )

     Removes the currently highlighted column from the display.

<Show...>
Show...                                   ( ALT+L S )

     Displays a field not already displayed in a column of the
     display.

<Width...>
Width...                                  ( CTRL+W or ALT+L W )

     Re-sizes the currently highlighted column (or all columns)
     in the Database Manager's display.

<Picture...>
Picture...                                ( CTRL+P or ALT+L P )

     Re-formats the currently highlighted column in the display
     to the picture you specify.

<Justify...>
Justify...                                ( CTRL+J or ALT+L J )

     Right, left, or center justifies the currently highlighted
     column (or all columns) in the display.

<Reformat...>
Reformat...                               ( CTRL+R or ALT+L R )

     Allows you to choose fields from the data file and the
     order in which they appear in the display.

<Header>
Header                                    ( ALT+L E )

     Displays a sub-menu of choices to display at the head of
     each column in the display.

<Column Heading>
Column Heading                            ( ALT+L E C )

     Displays the Default Column Heading from the Database
     Dictionary at the head of each column in the display.  This
     item is a toggle switch with a check mark () displayed
     when toggled ON.

<Label>
Label                                     ( ALT+L E L )

     Displays the field's label from the Database Dictionary at
     the head of each column in the display.  This item is a
     toggle switch with a check mark () displayed when toggled
     ON.

<Picture>
Picture                                   ( ALT+L E P )

     Displays the field's display picture from the Database
     Dictionary at the head of each column in the display.  This
     item is a toggle switch with a check mark () displayed
     when toggled ON.

<Type>
Type                                      ( ALT+L E T )

     Displays the field's data type from the Database Dictionary
     at the head of each column in the Database Manager display.
     This item is a toggle switch with a check mark ()
     displayed when toggled ON.

<Group Information>
Group Information                         ( ALT+L E G )

     Displays the field's GROUP information from the Database
     Dictionary at the head of each column in the Database
     Manager display.  This item is a toggle switch with a check
     mark () displayed when toggled ON.

<Grid>
Grid                                      ( CTRL+G or ALT+L G )

     Toggles display of vertical lines between columns in the
     Database Manager display.  This item is a toggle switch
     with a check mark () displayed when toggled ON.

<Split View>
Split View                                ( CTRL+V or ALT+L V )

     Displays the data file in two side-by-side columns.  This
     allows you to view non-contiguous columns at the same time
     without moving them or hiding other columns.

<Condensed Text>
Condensed Text                            ( CTRL+C or ALT+L C )

     Toggles video between 25-line mode and the most condensed
     text mode possible on your computer's hardware. This item
     is a toggle switch with a check mark () displayed when
     toggled ON.


<<Tools Menu>>

The Tools menu contains a number of utilities which are useful
throughout the environment.

<DOS Shell>
DOS Shell                                 ( F10 or ALT+T D )

     Calls Clarion's built-in disk maintenance program (CSHELL).

<DOS Prompt>
DOS Prompt                                ( ALT+T R )

     Temporarily exits to DOS to execute some DOS command(s).  It
     saves the current state of the Clarion environment to a
     temporary file, frees most of the memory used by the
     Clarion environment, and loads a second copy of COMMAND.COM.
     To return to Clarion from this DOS prompt, type "Exit" and
     press ENTER.

<Calculator...>
Calculator...                             ( ALT+T C )

     Calls Clarion's built-in programmer's calculator.

<ASCII Chart...>
ASCII Chart...                            ( ALT+T A )

     Brings up a list of all the ASCII codes. The chart
     contains each ASCII display character, and the Decimal,
     Hexadecimal, and Octal numbers which represent that
     character.

<Color Chart...>
Color Chart...                            ( ALT+T L )

     Displays a list of all the Color Style Codes. Each
     possible color combination is in the list along with the
     decimal number which represents it.

<Keycode Chart...>
Keycode Chart...                          ( ALT+T K )

     Displays a list of all the Clarion Keycodes.  Each possible
     key combination is in the list along with the decimal
     number which represents it.


<<Clarion Menu>>

The Clarion menu contains selections which allow you to navigate
between major functional areas of the Clarion environment.

<Load Application...>
Load Application...                       ( F4 or ALT+C A )

     Allows you to select one of the last several Application files
     in which you worked, or to create or open an Application not on
     the task list.  This selection takes you directly into the
     Application Generator with the selected file loaded. SHIFT+ F4
     immediately loads the last Application on which you worked.

<Load Dictionary...>
Load Dictionary...                        ( F5 or ALT+C D )

     Allows you to select one of the last several Dictionary files
     in which you worked, or to create or open a Dictionary not on
     the task list.  This selection takes you directly into the
     Dictionary Editor with the selected file loaded. SHIFT+F5
     immediately loads the last Dictionary on which you worked.

<Load Database...>
Load Database...                          ( F6 or ALT+C B )

     Allows you to select one of the last several Database files in
     which you worked, or to create or open a Database not on the
     task list.  This selection takes you directly into the Database
     Manager with the selected file loaded.  SHIFT+F6 immediately
     loads the last Database on which you worked.


<Load Text...>
Load Text...                              ( F8 or ALT+C T )

     Allows you to select one of the last several Text files in
     which you worked, or to create or open a Text file not on the
     task list.  This selection takes you directly into the Text
     Editor with the selected file loaded.  SHIFT+F8 immediately
     loads the last Text file on which you worked.

<Load Help...>
Load Help...                              ( F9 or ALT+C H )

     Allows you to select one of the last several Help files in
     which you worked, or to create or open an Help file not on the
     task list.  This selection takes you directly into the Help
     Editor with the selected file loaded.  SHIFT+F9 immediately
     loads the last Help file on which you worked.

<System Setup >
System Setup                              ( ALT+C S )

     Displays a sub-menu containing items which allow you to set
     system-wide options.  These are options that affect the entire
     Clarion Environment.

<Options...>
Options...                                ( ALT+C S O )

    Allows you to specify the use of your own text editor and DOS
    shell program.  These are programs other than the Text Editor
    and DOS Shell (CSHELL) which are part of the Clarion
    environment.   If you specify another editor in the Options...
    screen, the Clarion environment will run your editor and allow
    you to edit the file when you open or create a Text file. When
    you exit your editor, you return to the Clarion environment. A
    note of caution: text editors and word processing programs are
    not the same--this option must name a text editor.

    The main advantage of specifying your own text editor is your
    own familiarity with it, which eliminates the "learning curve"
    required before becoming proficient with the Clarion Text
    Editor.  The main disadvantage of specifying your own text
    editor is the loss of the use of the SCREEN, REPORT, and
    PULLDOWN menu formatting tools, which are all integral parts of
    the Clarion Text Editor. This means the only way to format a
    SCREEN, REPORT, or PULLDOWN menu would be to use the formatting
    tools in the Application Generator (or to directly edit the data
     structure code--not recommended).

<Database Drivers...>
Database Drivers...                       ( ALT+C S D )

     Registers new database file drivers. There are many more
     database file system drivers available than were provided in
     the shipping disks.  These extra file drivers are available
     directly from TopSpeed (call Customer Service at 800- 354-5444
     for more information).  Once you receive a new file system
     driver, you must register its presence before the Clarion
     environment will be able to use it.

<Search Paths... >
Search Paths...                           ( ALT+C S S )

     Maintains Redirection files. Redirection files are used by the
     Project system.  They provide individual search paths for
     specific files the compiler and linker need to find to
     accomplish their tasks (see the Project and Redirection Files
     essay in the User's Guide).

<Edit Styles...>
Edit Styles...                            ( ALT+C S E )

     Maintains any Color Style Code file. Color Style Code files are
     ASCII files containing a list of color codes used in your
     application's SCREEN structures and the actual colors to be
     used for those codes (see the Screen Color Schemes essay in the
     User's Guide).

<Printer Controls...>
Printer Controls...                       ( ALT+C S P )

     Allows you to maintain Printer Control files for the Clarion
     environment and your applications (logical printer support
     through the PRINTER report attribute).  It allows you to
     specify the port to which each printer is connected and printer
     control code strings for the print effects of which each
     printer is capable.


<<Help Menu>>

Context-sensitive Help screens are available throughout the Clarion
for DOS environment through the F1 key.  The Help menu contains
selections which provide separate access to the Help system.

<Using Help >
Using Help                                ( ALT+H U )

     Provides information on how to use the Help system.

<Help Index >
Help Index                                ( ALT+H H )

     Displays an Index of all Help screens available in the
     major functional area, allowing you to view a Help screen
     for a particular context when not actively in that context.

<About >
About                                     ( ALT+H A )

     Displays a screen with the program and copyright
     information for this specific release of Clarion
     for DOS.


<<Select Order for Viewing Data Window>>

The Select Order for Viewing Data window allows you to select the
sort order of the records displayed by the Database Manager. The
list box displays all the available viewing orders.

<Select Button>
Select Button

     Press the Select Button to select the currently highlighted
     sort order.


<<Print Window>>

The Print window allows you to select the output format and records
which will be printed from the Database Manager.

<Print...>
Print...

     Select the record(s) to print:

() Current Record

     Prints only the currently highlighted record.

() Current Page

     Prints only the records currently displayed on screen.

() All Records

     Prints all records in the file.

() Use Filter

     Prints only those records for which the Filter Expression you
     set in the Filter Window evaluates as True.

<Print Format>
Print Format

     Select the style of printout to produce:

() Columnar Mode

     Prints the records in a "spreadsheet" type of format in which
     each field in the record is a separate column.

() Form Mode

     Prints the records in a "form" type of format in which each
     field in the record is on its own separate print line.

<Columns Across:>
Columns Across:

     In Form Mode, enter the number of records to print
     side-by-side.

<Preview Button>
Preview Button

     Press the Preview Button to see a "block character" version of
     the print format.

<Table Cols Length:>
Table Cols Length:

     Displays the total number of characters possible to print
     for one record.

<Print Header>
[] Print Header

     Check this box to print column headings in Columnar Mode,
     or field labels in Form Mode.

<Print Button>
Print Button

     Press the Print Button to send the selected record(s) to the
     default output device specified for the Clarion environment.

<<Print Preview Window>>

The Print Preview window displays a "block character" version of the
print format, allowing you to see the actual print format of the
data.  To return to the Print window, press the ESC key.


<<Insert Record Window>>

The Insert Record window allows you to add a record to the data
file.  Once you enter data into each field in the file, press the OK
button to add the record to the file.


<<Delete Record Window>>

The Delete Record window allows you to remove the currently
highlighted record from the data file.  Press the OK button to
delete the record from the file.


<<Search Window>>

The Search window allows you to specify a value for which search
through the records in the database to find records with matching
values.

<Search For:>
Search For:

     Enter the value for which to search.

<Exact Match>
() Exact Match

     Indicates that the record found must contain an exact match
     to the Search For: value.

<Contains>
() Contains

     Indicates that the record found must only contain the
     Search For: value.

<Starts With>
() Starts With

     Indicates that the record found must begin with the Search
     For: value.

<Ends With>
() Ends With

     Indicates that the record found must end with the Search
     For: value.

<Case Sensitive>
[] Case Sensitive

     Check this box to indicate that the search should take the
     character's case into account.

<All Fields>
[] All Fields

     Check this box to indicate that the search should look
     through all the fields of each record. If not checked,
     only the currently highlighted field of each record is
     searched.


<<Locate Record Window>>

The Locate Record window allows you to find the first record in the
database which contains a matching value in its key component
field(s) to the value you enter on this window.  Enter the search
value into the key component field(s) then press the OK button to
locate the record.


<<Filter Window>>

The Filter window allows you to specify an expression which is used
to display only those records in the database for which the filter
expression evaluates as True.

<Expression:>
Expression:

     Enter the expression to use to "filter" the records. For
     example, if the file has a date field (FIL:Date) and you only
     want to view records whose date is within the last year, the
     expression would be:   Date > TODAY() - 365

<<Edit Memo Window>>
Edit Memo Window

     Edit the Memo as desired. Press ENTER to save or ESC to cancel
     editing.

<<Adjust Dimension Window>>

The Adjust Dimension window allows you to select the element of an
arrayed variable to display.

<Dimension:>
Dimension:

     Enter the array element number you wish to be displayed.


<<Show Fields Window>>

The Show Fields window allows you to select a field which has been
"hidden" to re-display.  The List box contains all the fields which
have been "hidden" in the Database Manager with the Hide menu
selection.

<Select Button>
Select Button

     Press the Select Button to place the currently highlighted
     field in the Database Manager's display.


<<Column Width Window>>

The Column Width window allows you to set the display width of a
single field, or all fields, in the Database Manager display.

<Automatic Width>
() Automatic Width

     When selected, the default column-width is used.

<Custom Width>
() Custom Width

     When selected, the column-width you set is used.

<Custom Width:>
Custom Width:

     Enter the column-width to use.

<All Fields>
[] All Fields

     Check this box to enact the width selection for all fields
     displayed in the Database Manager.


<<Change Picture Window>>

The Change Picture window allows you to change the display format of
the currently highlighted field.

<Picture:>
Picture:

     Enter the display picture format to use for the field.


<<Justify Window>>

The Justify window allows you to set the display justification of
one or all fields displayed.

<Left>
() Left

     Places the beginning of the display value against the left edge
     of the display field.

<Center>
() Center

     Centers the display value in the display field.

<Right>
() Right

     Places the end of the display value against the right edge of
     the display field.

<All Fields>
[] All Fields

     Check this box to enact the justification selection for all
     fields displayed in the Database Manager.


<<Reformat Fields Window>>

The Reformat Fields window allows you to select the fields to
display in the Database Manager, along with their display order.

<Shown Fields>
Shown Fields

    This List box displays all the fields which will be displayed in
    the Database Manager, in the order of their display.

<Hidden Fields>
Hidden Fields

     This List box displays all the fields which are currently
     not displayed in the Database Manager.

<Hide  Button>
Hide  Button

     Press this button to move the currently highlighted field
     in the Shown Fields list to the Hidden Fields list.

<Before Button>
Before Button

     Press this button to move the currently highlighted field
     in the Hidden Fields list to the Shown Fields list.  The
     field will be positioned immediately Before the currently
     highlighted field in the Shown Fields list.

<After Button>
After Button

     Press this button to move the currently highlighted field
     in the Hidden Fields list to the Shown Fields list.  The
     field will be positioned immediately After the currently
     highlighted field in the Shown Fields list.

<Move  Button>
Move  Button

     Press this button to move the currently highlighted field
     in the Shown Fields list UP one position.

<Move  Button>
Move  Button

     Press this button to move the currently highlighted field
     in the Shown Fields list DOWN one position.

<Order... Button>
Order... Button

     Calls the Order Fields Window to allow you to re-order the
     fields displayed in the Shown Fields list.

<Show All Button>
Show All Button

     Press this button to move all fields to the Shown Fields
     list.

<Hide All Button>
Hide All Button

     Press this button to move all fields to the Hidden Fields
     list.


<<Order Fields Window>>

The Order Fields window allows you to select the display order of
all fields shown in the Database Manager.

<Select Button>
Select Button

     Press this button to select the currently highlighted field as
     the next field to display in the Database Manager.

