
<<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.

Normally, 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
Programmer'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, Report, 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, Report,
     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 four 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 four 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 four 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 Report...>
Load Report...                            ( F7 or ALT-C R )
     Allows you to select one of the last four Report files in
     which you worked, or to create or open a Report not on the
     task list.  This selection takes you directly into the
     Report Writer with the selected file loaded.  SHIFT-F7
     immediately loads the last Report on which you worked.

<Load Text...>
Load Text...                              ( F8 or ALT-C T )
     Allows you to select one of the last four 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 four 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 Clarion Software (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 Programmer'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 Programmer'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 Database Developer 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 Database
     Developer.


<<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:   FIL:Date > TODAY() - 365


<<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.

