JBData                                                          Page 1
----------------------------------------------------------------------

                                JBData
                             Version 1.2
                           (c)JBSoft 1994/5

                                 
                                 Ŀ
                               
                                Ŀ
                                


     Description                                                2
     Installation                                               2
     Operation                                                  2
     Marked Files List                                         12
     Edit Window                                               14
     Link/Paste                                                16
     Help                                                      17
     Thanks                                                    17
     Get-out                                                   18
     Limitations                                               18
     Known Problems                                            18
     Contact                                                   18
     Version History                                           19
     Index                                                     22






































JBData                                                          Page 2
----------------------------------------------------------------------

Description
-----------

JBData is a free application for the enhanced display of database
files (either those created by Data or those made by an OPL program).

If the data file has fields made up of types other than strings then,
after editing, a simple check will be made to check that the field is
still acceptable in its original form (the editor only works on text
so conversions take place before and after edits).

The program allows for extra display modes, sorting of the file,
better search utilities, a simple password system  and other
improvements (but see the section called 'Known Problems').


Installation
------------

   1. Copy JBDATA.APP to any \APP\ directory.
   2. From the System screen navigate to the place you wish to
      install the application on the System screen and press
      Psion-I.
   3. Select the drive on which JBDATA.APP resides.
   4. Select JBDATA.APP in the file list.
   5. Press Enter.

The application will install on the screen at the chosen place. A file
list of Data files that are in the \DAT\ directories on all drives
will be displayed under the JBData icon in the same way as they are
under Data.

There is no need to remove Data for JBData to work but, because of the
vague similarity of icons, some care should be exercised that the
required application is selected before running it.


Operation
---------

To start the application highlight a file under the JBData icon and
press Enter.

Alternatively, on any file under the JBData icon, press Tab and
navigate to the file you wish to open using the cursor keys and Enter.
Once the cursor is on that file, press Enter twice (the first press
will show a dialog with the name of the file inserted - the second
press will open that file).

N.B. There is a possibility that, if there is insufficient memory
     available to run the application, you may be presented with a
     blank screen. If this happens just press Psion-Esc. This will
     take you back to the System screen where you can close down some
     applications to free some memory. I have intercepted this problem
     as much as possible but have been unable to eliminate it
     completely.

When the application is running use the following keys to operate it.





JBData                                                          Page 3
----------------------------------------------------------------------

Movement
--------
           Down - moves to the next record. In Page mode, if at the
                  last record, will move to the first record.
             Up - moves to the previous record. In Page mode, if at
                  the first record, will move to the last record.
           PgUp - In Line mode shows the previous page of records.
           PgDn - In Line Mode shows the next page of records.
      Ctrl-PgUp - Show the first record in the file.
      Ctrl-PgDn - Show the last record in the file.
           Left - In Line mode moves the display one field to the
                  left.
          Right - In Line mode moves the display one field to the
                  right.
           Home - In Line mode moves the display to the first field.
            End - In Line mode moves the display to the last field
                  with data.
          Enter - Either move to next record or toggle the Page/Line
                  mode display (depending how set with Shift-Psion-R).
    Shift-Enter - Move to previous record (dependant on state of
                  Shift-Psion-R).
            Esc - One press clears the quick find.
                  Two presses in quick succession will clear the line
                  display back to the frozen fields (if any are
                  defined) and the next field. This is a quick method
                  of resetting the visible fields to a consecutive
                  sequence starting with field one.
            Tab - In Page mode this will allow the use of the cursor
                  keys for missing lines to be scrolled onto the page
                  using the cursor keys.
                - In Line mode this key finds the next match for
                  QuickSearch (this option is not available in Page
                  mode).

Open File Psion-O
---------
This option opens a previously existing file. If the file has been
previously opened in JBData, configured, and that configuration saved,
then this configuration will be used to setup the display. Any
Datafile created by Data, JBData, or an OPL program can be opened. At
the moment I know of no datafile that cannot be opened by this
application. If you come across one please let me know.

If a password has been set then this will be prompted for before the
file will open.

Merge File Psion-M
----------
To merge two files into one. Normally this would be used to combine
two data files. A selection box is shown in order that you can choose
the file to merge with the existing database. It is necessary that the
two files to be merged have identical fields types in the same order
unless merging in text when there is a field check before the record
can be saved. After the filename has been given another dialog appears
that provides the option of either merging the two files or over-
writing the current file with the new file. The setup will be
transferred at the same time.

It is also possible to merge a text file with a data file. The data
file must consist only of fields with strings for this to work unless



JBData                                                          Page 4
----------------------------------------------------------------------

the text has been formatted to suit the field types. In this dialog
another option is given to allow overwriting the current data (i.e.
make a new file from the data). In this instance the setup will be
taken from the existing file (unlike over-writing .DBF files).

Start off as above. Once the filename has been selected then a further
dialog will prompt for the character delimiter to be used as a field
terminator. If 'Newline' is chosen then a record will consist either
of the number of lines that are the equivalent of the number of fields
set when the datafile was created, or until two Newlines are
encountered with no data between them. Otherwise, records will consist
of either the number of fields originally created, or until a new line
is encountered in the text file (whichever occurs first). If the
maximum number of fields comes first then the remaining data will be
placed in the next record.

It should be noted that, if a delimiter occurs within the text, this
will be taken as a delimiter regardless of whether the text is within
quotes or not - the delimiter should be chosen with that in mind.

If the text is enclosed in quotes (") then an option to remove these
quotes should be set to Yes (otherwise the default is No). There is
also an option to give a Labels file. This is for labels saved during
'Save As' and the data will over-write any Labels in the file. The
Labels file is always in the format one line per field (whether that
field has a label or not) and the data is not enclosed in quotes.
Finally, there is the choice of Merge or Overwrite to allow the text
to either add records to the existing file or to replace the data
currently there.

The 255 character limitation that exists for the Data application in
Merge mode is not applicable and the limitation is that of the Psion
in that no record can be greater than 4096 bytes in total (this
includes some headers and string length bytes so a more realistic
maximum length is 4000 bytes).

N.B. This text merge option is not as fast as the one in Data for at
     least two reasons:

     1. Strings longer than 255 are permitted. This requires a
        different technique to that of Data to merge the data.
     2. Field types other than strings are permitted. This requires a
        check to make sure that the types agree.

New File Psion-N
--------
To create a new file use this option. A dialog box is shown to choose
the new filename. Once this has been chosen a dialog will prompt for
the number of fields to include (the default (and maximum number) is
32). Another dialog will then ask for the type of fields required (the
default is String) - all the fields should be correctly entered. The
file will then be created and you will end up in the Edit screen as a
prompt to input some data.

If the directory for the file does not exist, it is automatically
created.

If it is desired to make a Data file from a text file then create a
file using this option with 32 fields (all strings). When presented
with the Edit screen to input the first record, press Escape. A



JBData                                                          Page 5
----------------------------------------------------------------------

message will appear 'File Empty'. From there select Merge and merge in
the text file as per normal.

Save As Psion-A
-------
To save the current file with a different name, save selected records,
or to save as text, use this option.

A dialog box will be displayed to prompt for the new name to use. Once
this new name has been input (along with any path that is needed) then
another dialog may be shown asking if All records should be saved or
the Selected records only. This dialog will only show if a MultiFind
or Marked File display is current.

Another dialog will then be shown which allows for the data to be
saved either as another data file or as text. If the Data option is
selected then the data will be saved complete with any setup. If the
text option is selected then a delimiter character must be set to
distinguish between the fields. This works in a similar way to that of
the Data application but without the 255 character limit of that
application. The options for the delimiter are:

     New Line
     Tab
     Comma
     Semicolon
     Other - specify the character on the Char Code line.

If it is required to re-import the data then the delimiter should be
chosen accordingly (i.e. there should be no occurrence of the
delimiter within the data, otherwise this will be taken to be a
delimiter. Quotes will not affect this situation).

There are also options to save the data enclosed in quotes (") and to
save the Labels into a separate file. This file has a default
extension of .LAB. The Labels are always saved without quotes and each
field ending in a carriage return. Quotes will not be put around
fields that were originally values.

Compress File Psion-K
-------------
This option compresses the current file, clearing all deleted records
from the database. If the file is on a Flash SSD then a dialog is
shown to give the opportunity to abort the process (it will use as
much again space as the original file on a Flash pack).

Sort File Psion-S
---------
The current file may be sorted. Any sort will automatically update the
file saved on the disk and over-write the original file. A dialog box
is shown with a choice of three fields to sort on. If you wish to sort
on less than three fields then make the fields the same. The default
is to sort on the first three fields. There is also the choice to
choose the direction of the sort (either Forwards or Reverse - the
reverse sort would put Z before A rather than A before Z. If you wish
to ignore NULL fields (i.e. ones that are empty of data) then select
'Ignore' in that option otherwise the default is 'Seed with Space'
which seeds NULL fields with a space.





JBData                                                          Page 6
----------------------------------------------------------------------

If the file is sorted outside of JBData any setup stored with the file
may be lost (JBSort does keep the setup and should be used for large
files as it will have more room for data and therefore is less likely
to fail due to lack of memory).

The fields used to sort the file are saved with the file on exit.

If the file resides on a Flash pack then an option to abort the sort
is given as the space used up on the pack will double.

N.B. The sort that takes place is always an ASCII sort so numbers will
     not necessarily appear in the correct order (i.e. 666 will appear
     before 69). The sort takes no account of the length of the field.

Memory Sort Shift-Psion-S
-----------
This option will sort the file in memory only - the sorted items are
only seen in sorted mode in the Line (or Table) mode. Any alteration
to the file (i.e. Delete, Add or Edit a record) will disable the sort
and a new sort will have to be made. It works in exactly the same way
as the ordinary sort but leaves out the final write to disk.

To inhibit the sort use Ctrl-Psion-O. If this is used then a new sort
will have to be implemented if required - it does not act as a toggle.

N.B. Whilst in the sort display mode most options relating to records
     are inhibited. This is because a look-up table is used to achieve
     the sort display and the program is unaware of the actual
     position of the record highlighted. It is possible to quick
     search in this mode - an ordinary search will actually disable
     the sort before carrying out the search.

The fields used to sort the file are saved on exit.

Reset Sort Fields - Shift-Psion-O
-----------------
The fields used for sorting the database are saved. It you wish to
reset these fields to the first three fields again (the initial
option) then use this keypress combination before accessing the Sort
procedure.

Update Record Psion-U
-------------
A record can be edited by using this function - to save the changed
data press Tab when the edit is complete. Care should be taken with
field types as it would be possible to input a string where a number
should be. A check is made when Tab is pressed and, if a field is
incorrect, the edit box will remain. Pressing Escape will abort any
changes.

Delete Record Psion-D
-------------
Individual or marked records can be deleted using this option. The
record to be deleted should be highlighted in the Line mode or
displayed using the Page mode. If this option does not appear to work,
press Esc and try again.

If this option is accessed in a marked files display then an option to
delete all the marked files is given. If 'Y' is selected then another




JBData                                                          Page 7
----------------------------------------------------------------------

dialog is displayed just to make sure you want to delete these marked
records. There is no going back once 'Y' is pressed!

Add Record Psion-E
----------
This option creates a new record. Use Tab to save the new record or
Escape to abandon the creation. See Update Record for information
concerning field types.

Print Record Shift-Psion-P
------------
An individual record or marked record list can be printed using this
option. The Print Setup (Psion-Y) should be accessed first to set up
the print option as required. The record(s) will be printed in the
form it is displayed on the screen. There is the option of printing
the Labels as well (via a dialog) but, if in a Line display, the
labels are only printed once at the start of the print. If in a Marked
Record list then a dialog will be shown asking if this list should be
printed. If No is selected then the highlighted record only will be
printed.

In Line mode the amount of data printed is restricted to what will fit
on one line. This can be adjusted a little by modifying the field
widths before printing as this will define the maximum length of each
field to print.

Edit Labels Psion-L
-----------
The labels as displayed can be added or edited using this option. This
procedure uses the same editor as that used for records. To save the
changes press Tab - use Escape to abandon this option. The type of
field is shown where the labels normally appear - this is just a guide
and the information contained in the labels field cannot be saved or
copied.

N.B. The labels are actually only updated on disk when exiting the
     file so changes can be circumvented by pressing Psion-Esc to quit
     the file. Alternatively, to update and continue within the file
     just use Open on the same file.

Edit Widths/Line Wrap Psion-W
---------------------
In Line mode the widths of the individual fields are adjustable using
this option. It uses dialog boxes to display up to 5 fields at a time.
To move to the next set of fields press N, use P to go to the previous
selection. When the changes have been completed, press A. This option
will only have any effect on the display in Line mode. The width is
displayed in character units but it should be remembered that most of
the fonts on the computer are proportional and the numbers shown are
just a guide.

In Page mode when viewing a record the line wrap can be toggled on and
off using this same key combination. In Edit and Update line wrap is
automatically switched off.

Calculate Widths Psion-I
----------------
This option will look at each record in the file in turn and adjust
the display widths of each field accordingly. It will take the record
with the longest field as its base for that field. Because this



JBData                                                          Page 8
----------------------------------------------------------------------

procedure looks at every record, on a large file this can take some
time to complete. There is a dialog confirmation that appears before
the operation commences to trap unintentional keypresses.

Reset Widths Shift-Psion-I
------------
Widths are reset to the default size of 20 characters for each field
when this option is activated. Please note that with proportional
fonts more characters than specified may be shown.

Page/Line View Psion-R
--------------
To toggle between the Line and Page View use this option. Page View
shows one record (or as much as possible) per page, Line View shows
several records per page, one per line. It is also possible to switch
the Enter key to toggle as well (use Shift-Psion-R).

Record Number Toggle Shift-Psion-N
--------------------
This option toggles the record numbers on and off. In Line mode the
record number is shown at the start of the line, In Page mode the
record number and the total number of records is displayed in the
bottom right hand corner.

Labels Toggle Psion-H
-------------
Labels display can be toggled on and off using this key combination.
It is operative in both Line and Page mode but the selected display is
independent of the other (e.g. it is possible to have Labels shown in
Line mode but not Page mode).

Blank Lines Toggle/Grid Lines Psion-B
-----------------------------
In Page mode blank lines can be shown or hidden using this option. To
detect which method is in use, the Menu will show the opposite option
to that in force.

In Line mode this command will bring up a dialog box in order that you
might select the visibility of grid lines for each record. In certain
circumstances it is not easy to follow the individual lines or fields
- this option will help. You can select a horizontal line between
records and/or a vertical line between fields. The lines are shown in
grey so as not to be too obtrusive and also to distinguish between
frozen fields and the others.

Freeze Fields Shift-Psion-K
-------------
In Line mode it is possible to keep some fields always visible. The
only option selectable is the end field to freeze - the first visible
field will always be field 1. The next visible field is adjustable
using the Left and Right cursor keys. If Freeze is selected then the
next visible field position is saved in the setup file and the
position restored when re-opening the database. The end of the frozen
portion is displayed with a vertical black line.

Enter Page/Line mode display toggle Shift-Psion-R
-----------------------------------
This switch allows the Enter key to toggle between Page and Line mode
or to move to the next record. The current mode is saved in the setup




JBData                                                          Page 9
----------------------------------------------------------------------

and restored when re-opening the database. The current mode can be
displayed on the menu under Display.

Dialling Psion-Help
--------
It is possible to use the program in a similar way to Data and dial
telephone numbers whose fields are marked with the telephone symbol. A
list of telephone numbers relating to the selected record is shown.
Choose one by highlighting it and press Enter (you can edit the data
before pressing Enter). Another dialog will show giving the options of
Dial, Dial Out or Cancel. If Dial Out is chosen then the method of
dialling out is taken from the Dialling setup available from the
System screen as are the other parameters used for this option. Should
there not be a Dial Out specified then the program will resort to '9,'
for the method used.

N.B. The key options are intentionally reversed from that of Data as I
     find the combination I have chosen easier to use!

QuickSearch
-----------
There is a quick find which is used by just typing the word you
require to find. Normally, this would only be used from the Line view
although it is available in the Page view. This normally operates on
the first visible field (in Freeze either one of the frozen fields or
the first moveable field is used). In field one the inputted string
will only work from the first letter of the field, in other fields the
string to be found can occur anywhere within the field.

The search string is cleared by pressing Escape. There is also a
timeout which clears the search string after a minute of not
searching. The next find using the same string can be shown using Tab
(in Line mode only).

Numeric fields can also be searched in this manner.

N.B. When used in the Page view strange results may occur if the first
     visible field in Line mode is something other than field one as
     the procedure takes the field set in Line mode for its search
     even in Page mode. This search field can be displayed using
     Psion-T.

     In Memory Sort mode Tab will take you to the next match but the
     displayed order may not match the order in which the items are
     found (i.e. if, in reality, a record with the search field
     'Brake' has been edited and is therefore positioned at the end of
     the file, then this would be displayed after the search field
     'Broke' although the sorted display will still be shown
     correctly.

Find Psion-F
----
This is a normal type search and works in the same way as that of
other Apps. There are four additional options:

1. Reverse search  - this searches from the end of the database rather
                     than the front.
2. Single/Multiple - Single works in the usual way, Multiple will
                     gather all the matches and then display only the
                     found files.



JBData                                                         Page 10
----------------------------------------------------------------------

3. Wildcards       - This allows wildcards to be used in the search
                     string (e.g. * and ?). It is important that, if
                     the compete field is not given, a '*' is placed
                     at the front and the rear of the string. To
                     search from the first character of a field omit
                     the leading '*'.
4. Case Dependent  - This allows the selection of case dependency in
                     the search - the default is case independent.

It is also possible to narrow the search with logical statements.
There are two sorts available - the first sort is self explanatory,
the second a little quicker to type.
Currently these are:

      and - &&
       or - ^^
      xor - ^&
      not - --

so to look for a record that has 'David' and 'Road' then input 'david
&& road' or 'david and road'. If you wish to use the 'and' variation
and also wish to search for the word 'and' then enclose it in
quotation marks (e.g. "and").

If nothing is found the display will remain where it was before the
search was started.

If you wish to use one of the logical search parameters at the start
of the search string (e.g. 'not road') then preface the string with a
space (i.e. ' not road' - rather than  'not road'). This is also true
for the alternative characters (e.g. ' -- road' rather than
'-- road').

To search for a blank field then use ' not ?'. Do not use the '*' as
this will match none as well as some characters.

To search numeric fields with this command (or Find Field) then a
logical search parameter must be used. This is because the internal
Psion search routine ignores numeric fields so it is necessary to use
the slower routine written by me - to direct to this requires a
logical statement. If only one number is required to be found then,
assuming that number is 12, use ' and 12' with a space before the
'and'. Of course, this will also find 121 or 112 or any number or
string that has 12 in it.

N.B. When searching in Single mode and in Page mode, the find will be
     highlighted on the screen. However - the Labels will almost
     certainly not be in step with the data. At present there is no
     way round this but I hope to fix it in the future.

Find Field Shift-Psion-F
----------
Searches in the same way as the normal search but allows a specific
field only to be searched. If the enhanced logical statements are used
then the find works in exactly the same way as that of the normal find
(i.e. it does not take into account the field selected).







JBData                                                         Page 11
----------------------------------------------------------------------

Find Again Psion-G
----------
In Single Find mode this will display the next record that matches the
search criteria.

Global Search and Replace Ctrl-Psion-F
-------------------------
This is a similar function to the Record Search and Replace but allows
the Search to be global (throughout the file). The options are the
Search item and the Replace item and, optionally, the field to search
on. For this field selection to work the choice must be for Single in
'Fields to search'. The choice of the actual field is made in the
'Field' slot. The search is selectable between case dependent and case
independent but, whatever case dependency is selected, the Replace
will substitute the found data with the replacement as typed. Escape
will terminate the Search and Replace option.

During the operation of this procedure the screen will automatically
revert to Page mode - this is not selectable but, after the procedure
has ended, the screen will revert to the previous display.

Once the search string has been found the record in which the item is
will be displayed and the found string highlighted. An option to
replace just this one, not replace, or replace all found matches will
be given. Pressing Escape at this point will terminate the operation
completely.

Jump to Record Psion-J
--------------
To jump to a specific record, if the number of that record is known,
use Psion-J. If an illegal number is inputted then the dialog will
remain active.

Display QuickSearch field Psion-T
-------------------------
To quickly find out which field the QuickSearch will look in use this
key combination. The search field will display in the bottom right
hand corner of the screen for around 2 seconds. The field selected can
only be altered in Line mode.

Display QuickSearch string Shift-Psion-T
--------------------------
This key combination will display the current QuickSearch string in
the bottom right hand corner for around 2 seconds. This string is
cleared after 2 minutes of non-use.

Remove records from list Psion-- / -
------------------------
A record may be removed from a MultiFind list or a marked file list
using this key combination. This command does not delete the record,
it only hides it from the display.

Add record to list Psion-+ / Shift-Up / Shift-Dn / +
------------------
This command is only active in the main display and allows the marking
of records for display as a marked file. The mark is not shown visibly
other than in the marked files list. A message will be shown marking a
record.





JBData                                                         Page 12
----------------------------------------------------------------------

The only way of telling whether you are looking at a marked files list
or the normal list is, in marked files, the headings are printed in
negative (reverse video) mode. This is only true of the Line mode.
Page mode currently has no clue as to whether a marked list or normal
list is being displayed.

Toggle between marked records and main file Psion-V
-------------------------------------------
This command will toggle the display between the marked records list
and the main list.

Reset marked records Shift-Psion-V
--------------------
To reset all marked records to unmarked, use this command. If used
within the marked files display, it will change to the normal display.

About Shift-Psion-A
-----
This option displays a dialog box with contact details for the author
and the current version number of JBData.

Zoom In Psion-Z
-------
This will change the font used in the display by incrementing the font
number. When it gets to the highest number font it will start again at
the first relevant font. Separate fonts are used for the Line and
Page/Edit views so altering one will not affect the other.

Zoom Out Shift-Psion-Z
--------
This will change the font used in the display by decrementing the font
number. It is the exact opposite of Zoom In.

Print Setup Psion-Y
-----------
This option allows the Print setup to be changed in a similar way to
other Applications.

Delete Setup Psion-Q
------------
To delete the setup of the current database, use this option. The
setup referred to is the setup of whether Page or Line mode, if Freeze
is implemented, the font used, and other similar options.

Save Setup Shift-Psion-Q
----------
This option will force a save of the database setup - it is normally
saved when exiting the database or application. This procedure works
independently of the Suspend Setup Save option.

Suspend Setup Save Ctrl-Shift-Psion-Q
------------------
This key combination will bring up a dialog which allows for the Setup
Save to be suspended with the file in question. If you have the setup
just as you want it then this could be implemented as it will
effectively stop the setup being changed between sessions and any
changes made will only work whilst the file is currently open. Once
the file has been closed down then any changes made will have been
forgotten.




JBData                                                         Page 13
----------------------------------------------------------------------

There are only two choices:

     1. Save Setup (the default - the setup is saved every time it is
        changed).
     2. No Save (suspend) - this stops the setup being saved with the
        file.

Status Window Psion-Menu
-------------
A status window can be toggled between large, small and off in
rotation using the Psion-Menu key combination. This window is similar
to that available in the Psion applications.

Exit Program Psion-X
------------
This key combination will exit (terminate) the program. This also
works in the Edit window. In an emergency you can also use Psion-Esc
but this will not save any setup and terminates the program without
any warning. It is also possible that any changes made to the database
may not be saved. To leave without saving any setup use Shift-Psion-X.

Password Control
----------------
Passwords can be set by using Shift-Psion-C. If setting the password
to On then a dialog will appear that requires the password to be given
twice in identical fashion. The password will only be set if both
passwords are identical (including case). If there was a previous
password set then this old word has to be given in a separate dialog
before the password can be changed. The password is limited to 19
characters in length.

To remove a password then proceed as if changing the password, when
confronted with the password dialog for the new word, just press
Enter. This will automatically disable any password control.

It is not possible to preset a password for a file. If a password is
set then the file will be password protected.

The password system is extremely simple in operation and will only
deter the casual browser. The file itself is not encrypted, neither is
the password, although Data will not open the file at all.

N.B. Passwords have not been inhibited on Flash media but a warning
     appears if an attempt is made to password control a file on this
     media. This is because there is some overwriting of the file
     which could rapidly use up any spare space on the Flash pack if
     the passwords are switched on and off (Flash media can't always
     be overwritten, so there would be considerable growth of the
     amount of media used every time the password is changed or
     switched on or off). It is suggested that, if passwords are
     wanted on Flash media, then they are left on until such time as
     the requirement goes away completely.

     My brief experiments show that there is growth of around 200
     bytes each time the password is altered but this should not be
     taken as gospel and may well vary with the size of file.

     Please also note that if the Setup within the file is deleted on
     a Password protected file then the file will still be password




JBData                                                         Page 14
----------------------------------------------------------------------

     protected but with a zero length password (i.e. just press Enter
     when confronted with the Password dialog).

Sound toggle Shift-Psion-B
------------
This option will toggle the sound (beeps) on and off - the status is
not saved and only works for the session (i.e. it will be remembered
when switching files but forgotten when JBData is closed down).

Edit Window Psion-E/Psion-U
-----------
At present it is not possible to alter the number of fields or change
their types once they have been set. The obvious way of doing this
(should it be necessary) would be to create a new file and import the
data to it.

The line wrap is always off in the Edit window. It cannot be switched
on. This is to restrict problems with the labels getting out of step
with the data.

There are a few keys that operate in an edit window at present. These
are:

Find Psion-F
----
Allows a search to take place in the current record being edited.

Find Again Psion-G
----------
Once an item has been found, this allows the search to continue
through the record to find the next match.

Find and Replace Psion-R
----------------
Allows a search and, if found, then the item can be replaced with a
given string. If a find is made then a dialog will appear allowing you
to ignore the replacement of this item, replace all the items without
a further prompt, or just replace this one and continue the search.
Escape from the dialog will terminate this procedure.

Copy Psion-C
----
Copies highlighted text to a clipboard. The clipboard is saved between
edits so that text can be moved from one item to another.

It is also possible to copy data to the clipboard in Page mode. Press
Tab and mark accordingly. No cursor is shown so only whole lines can
be copied normally.

Although the option is shown on the menu in Line (Table) mode it is
not applicable as there is no method of highlighting data.

Delete Psion-D
------
Copies highlighted text to a clipboard and then deletes the text in
the record. The clipboard is saved between edits but is discarded when
the application is closed down.






JBData                                                         Page 15
----------------------------------------------------------------------

Insert Psion-I
------
Inserts previously copied text from the clipboard to the present
cursor position.

Bring Psion-B
-----
Brings highlighted text from other applications (only if they support
this option).

Evaluate Psion-V
--------
Evaluates a highlighted expression and shows the result on the screen
with the original expression highlighted for deletion purposes. If
this is used in a Integer or Long field then the result may not be
acceptable unless there are no significant numbers in the decimal
field (i.e. 12.00 is OK but 12.01 isn't).

Zoom (Shift-)Psion-Z
----
This works in the same way as that of the main window allowing the
font size to be changed up and down. See under Zoom In and Zoom Out
above. This also affects the font in the Page view.

Tab width Psion-T
---------
To alter the width between Tabs (which are entered with Shift-Tab) use
this command which enables the distance to be specified. Under normal
circumstances 4 characters per Tab is usual. The distance previously
set is shown in the dialog initially. This data is saved along with
the file.

Toggle Symbols Shift-Psion-C
--------------
This key combination will toggle the viewing of Tabs, Carriage Returns
and New Lines within Fields. The state of this toggle is remembered
between edits and sessions.

Labels toggle Psion-H
-------------
This option will switch the labels display on or off. If no labels
have been set then the type of field will show in brackets in place of
the labels.

Link/Paste
----------
This option is implemented in a similar way to that of other Psion
applications.

What this means is that, in an edit mode, highlighted text from other
applications that allow Link/Paste (e.g. Word/Data/Agenda) can be
brought in to the edit window at the cursor location by using Psion-B.
Also, any highlighted text in an edit window can be 'grabbed' by the
other applications (normally Psion-B).

For this to work successfully, the application which has the
information to be grabbed should have been the last one to be used
before the application who requires the text.





JBData                                                         Page 16
----------------------------------------------------------------------

N.B. It is possible to export from the Edit and Page view mode only.
     The Page view is restricted in its marking in that there is no
     visible cursor so whole lines only would normally be marked in
     this mode.

Labels in Edit mode
-------------------
If labels have been setup then these will be displayed as in Data. If
no labels have been set then the type of field will be displayed in
brackets as an aide mmoire - e.g. (String) or (Integer). The labels
can be toggled on and off using Psion-H.

Special Keys in Edit
--------------------
To end an Edit, press Tab - to leave the edit without changing
anything use Escape. If there is data beyond the last field of the
record then this data will be lost on Save so, under these
circumstances, a dialog box will display requesting confirmation that
it is OK to save as it is. 'Return' and Escape will take you back to
the Edit.

N.B. It is not possible to use Tab or Esc from the Menu, the actions
     are listed there as an aide mmoire. First remove the Menu with
     Esc and then press either Tab or Esc.

To toggle the display of Symbols (Enter/Tab etc.) in the Edit mode use
Shift-Psion-C.

There are a few special characters (or key-presses) in the Edit mode.

           Tab character - use Shift-Tab
   New Line within field - use Shift-Enter
             Dial symbol - use Shift-Dial
                  Ctrl-D - enters todays date in DD/MM/YY format


Help
----
There is a brief on-line help available using the Help key. It does
not cover all options but should assist under normal circumstances.


Brief notes of the way JBData Setup works
-----------------------------------------
The setup is stored in a record which has the type number 13 (for
those that are aware of the way that datafiles operate). This record
is always the same length in each file but may vary from version to
version of JBData. If the setup is changed then the revised setup is
saved when the datafile is closed (either by exiting JBData or by
opening a new file). This record is ignored by Data, DataDeLuxe, OPL
programs and, hopefully, all other applications (there can be no
guarantee of this though).

Once the setup has been saved then the datafile will grow slightly in
size (around 100 bytes).

To make the datafile revert to an ordinary datafile (without this
setup record), delete the record using Psion-H and then exit the
application using Shift-Psion-X. It should not be necessary to do this
for the datafile to work with other applications. Note that this does



JBData                                                         Page 17
----------------------------------------------------------------------

not effect the Password control and, if the setup is deleted on a
Password protected file then the file will still be protected albeit
with a null password (just press Enter to get in)!


Thanks
------
Thanks are especially due to Wolfgang Schirmer (for help above and
beyond anything I could have hoped for), Andre Rodach, Andy Clarkson,
Mark Avey, Nigel Wright, Jim Cooke and Tom Dolbilin for their help
with this project. Without them (and others) it would not be half as
good as it is. Thank you very much.

Please do not contact any of the above for support, they have no
access to the source code and therefore it is unlikely that they will
be able to answer any queries.

Get-out
-------
As is usual with programs of this sort, I shall not be held
responsible for any loss of data , however caused, as a result of
using this program. The user must take responsibility for his actions
and uses the program at his own risk. I reserve all rights of
copyright to the program although neither registration nor payment are
required to use it.


Limitations
-----------

Only finds up to 999 finds in MultiFind.
Only 999 marked files can be used at any one time.

The program needs around 100k of memory to work.


Known Problems
--------------

There is a known problem with Label displays in the Edit box sometimes
getting out of step with the appropriate fields. At the moment, this
requires a major re-write which I hope to accomplish for Version 2.

At present the program does not accept remote commands from programs
such as Tom Dolbilin's MACRO or KMAC. It is hoped to rectify this in a
later version.

If the program freezes for any reason then do not play, trying to un-
freeze it. This is extremely unlikely to be successful and may cause
greater problems in the long run (such as a complete hard reset of the
computer - I know because this happened to me!). Instead, escape using
Psion-Esc immediately - please let me know if this happens to you and
under what circumstances.










JBData                                                         Page 18
----------------------------------------------------------------------

Contact
-------
John Boyce
CompuServe: 100014,1240
CIX/Internet: jboyce@cix.compulink.co.uk


























































JBData                                                         Page 19
----------------------------------------------------------------------

Version History
---------------
Version 1.0
-----------
First Public release.

Version 1.0a
------------
Fixed problem with Escape in Save Setup dialog.
Fixed problem with QuickSearching and FreezeFields (only allowed on
field 1 originally).
Fixed problem with Tab being inserted when exiting Edit and Caps Lock
was on.
Fixed problem with initial display of Marked records if the cursor was
at a record greater than the total Marked record list.
Fixed problem of inability to switch off Labels in Page mode.
Fixed problem with logical search only accepting one logical statement
correctly.
Added Shift-Psion-X to the menu.
Switched window size options for Status Window to more closely
resemble Psion Apps.
Added Shift-Enter to go back a record (similar to Data).
Added cursor saving between Marked and Normal list so that cursor will
remain where it was in the list (this does not work at the first
display - the cursor always will go to the top of the list initially).
QuickSearch string is now cleared after 1 minute of non-use.
Busy note added for closing down large files.
Added e-mail addresses to About dialog.

Version 1.0b
------------
Fixed problem with Label Edit not always showing field type correctly.
Fixed problem of Help not working in Edit mode.
Fixed Link/Paste outward-bound (broken in 1.0a).
Fixed problem with saving marked records sometimes failing with
'Unable to create ...'.
Fixed problem with Ctrl-Shift-Psion-Help causing app to fail - it now
does nothing! (it is not easy to implement)
Fixed problem of Delete not copying data to Clipboard first (not sure
when this was broken - maybe not in a release).
Fixed problem of Wrap characters in View Page and Edit working in
reverse (now no wrap on Edit - switchable in View).
Fixed problem of 'spurious' Cannot compress Flash media messages
appearing.
Fixed problem of field types not appearing when entering first record
of new file.
Fixed problem of find sometimes corrupting the screen when nothing
found.
Fixed problem of altering font in Edit mode causing Line mode spacing
to be corrupted.
Hopefully fixed problem with occasional panic #82.
Changed the method of displaying reversed labels in Marked Files List.
Added Mark records with Shift-Up and Shift-Down.
Added ability to switch and create files from System Screen (using
Enter).
Added Search (and Replace) in Edit window.
Added Highlight to single search find in Page mode (see appropriate
section for getout though).
Extended Dial check so that telephone symbol can be embedded in the
data.



JBData                                                         Page 20
----------------------------------------------------------------------

Label display status is now different for Page and Line modes (the
selection is independent).

Version 1.1
-----------
Fixed problem of not showing more than 32 fields.
Fixed problem of Enter from the System screen to change the open file
hanging the keyboard.
Fixed the problem of the name on the System screen being wrong when
the file was changed using Enter.
Fixed problem of Status window confusing the Edit window.
Fixed problem of merging text files with very long lines - now breaks
them down correctly.
Fixed problem of Setup sometimes not being saved and corrupting setup
of next file when file changed from System screen.
Fixed problem of, when saving selected records to text, first record
in database always included.
Fixed requirement to Tab twice when moving to Page display from
QuickSearch in Line mode.
Fixed small problem with scroll in Line mode sometimes leaving the
occasional dot on the screen.
Added Wildcard search.
Added display of QuickSearch string.
Added Global Search and Replace with optional selected field.
Added Dialog to suspend saving Setup.
Added options in Save As text to save data in quotes and also save the
Labels in a separate file.
Changed Labels only saved when exiting the file.
Sort now dynamically allocates memory so there is no absolute limit to
the number of records in a file that can be sorted (it may fail around
1500-2000 records because of memory limitations though).
Added 'Are you sure' dialog to auto set widths (Psion-I).
Added Fieldname to giPrint during QuickSearch.
QuickSearch now works after a memory sort.
QuickSearch now accepts Umlaute's etc.
Added very simple password control.
Added sound toggle for session (Shift-Psion-B).
Added option to overwrite file rather than merge in Merge.
Added option to toggle Labels within Edit.
Adapted Wrap lines on menu to reflect state.

Version 1.1a
------------
Fixed problem with importing a file with the fields in quotes when the
quotes are missing.
Fixed problem of Edit eating memory.
Slightly speeded up Merge although it's still a good imitation of a
tortoise.
Added Merge Busy message.
Changed Save As quotes so that value fields are not 'quoted' (similar
to most other databases).
Added smallest font to selection.
Dial now ignores brackets round numbers.

Version 1.1b
------------
Dialogs now remember what was set earlier consistently.
Added Case dependency selection to Searches.
Added ability to use commas in Dial.




JBData                                                         Page 21
----------------------------------------------------------------------

Fixed problem of Shift-Enter cutting off last character of preceding
line in Line Mode.
Fixed problem with Find with wildcard not finding all matches.
Fixed problem with zero width fields upsetting line display.

Version 1.1c
------------
Fixed problem with edited Phone Number in dial system giving incorrect
numbers.
Fixed problem of record numbers font not changing in Page display.
Fixed problem of Global Search and Replace showing finds other than in
a single field when that mode selected.
Fixed problem of Dial dialog showing wrong number from marked record
list.
Removed failure statement when Escape is pressed in 'No. of fields'
dialog after Create a new file is used from the System screen.
Adjusted Wildcard search so that '*' is not automatically put on the
front of the search string.
Improved printing so that a marked record list can be printed.
Now allows Read Only files to be viewed (not edited).
Improved Global Search and Replace so that more than one find in a
record is dealt with correctly.
Tidied up how and when Labels appear when editing.
Added a method of puting the date in automatically (Ctrl-D).
Added QuickSearch to Marked records lists.






































JBData                                                         Page 22
----------------------------------------------------------------------

Index
-----
About                                                           12
Add Record                                                       7
Add record to list                                              12

Blank Lines Toggle                                               8
Bring                                                           15

Calculate Widths                                                 8
Compress File                                                    5
Contact                                                         18
Copy                                                            15

Delete                                                          15
Delete Record                                                    7
Delete Setup                                                    13
Description                                                      2
Dialling                                                         9
Display QuickSearch field                                       12

Edit Labels                                                      7
Edit Widths                                                      8
Edit Window                                                     14
Enter Key Toggle                                                 8
Enter Page/Line mode display toggle                              9
Evaluate                                                        15
Exit Program                                                    13

File Conversion                                                  5
Find                                                        10, 15
Find Again                                                  11, 15
Find and Replace                                                15
Find Field                                                      11
Freeze Fields                                                    9

Get-out                                                         18
Global Search and Replace                                       11
Grid Lines                                                       8

Help                                                            17

Index                                                           22
Insert                                                          15
Installation                                                     2

JBData Setup                                                    17
Jump to Record                                                  11

Known Problems                                                  18

Labels in Edit mode                                             16
Labels Toggle                                                    8
Labels toggle                                                   16
Limitations                                                     18
Line Wrap                                                        8
Link/Paste                                                      16
List
  add record                                                    12
  remove record                                                 12



JBData                                                         Page 23
----------------------------------------------------------------------

  reset                                                         12
  toggle                                                        12

Marked records
  add records                                                   12
  remove record                                                 12
  reset to none                                                 12
  toggle display                                                12
Memory Sort                                                      6
Merge File                                                       3
Movement                                                         3

New File                                                         4

Open File                                                        3
Operation                                                        2

Page/Line View                                                   8
Password                                                        13
Password Control                                                13
Print Record                                                     7
Print Setup                                                     13

QuickSearch                                                      9

Record Number Toggle                                             8
Remove records from list                                        12
Reset marked records                                            12
Reset Sort Fields                                                6
Reset Widths                                                     8

Save As                                                          5
Save Selected                                                    5
Save Setup                                                      13
Search and Replace                                              15
  Global                                                        11
Setup
  Delete                                                        13
  Save                                                          13
  Suspend Save                                                  13
Sort
  memory                                                         6
  reset fields                                                   6
Sort File                                                        6
Sound toggle                                                    14
Special Keys in Edit                                            16
Status Window                                                   13
Support                                                         18
Suspend Setup Save                                              13

Tab width                                                       16
Thanks                                                          17
Toggle between marked records and main file                     12
Toggle Symbols                                                  16

Update Record                                                    7

Version History                                                 19

Zoom                                                            15



JBData                                                         Page 24
----------------------------------------------------------------------

Zoom In                                                         12
Zoom Out                                                        13


                                           John Boyce 23 February 1995