home *** CD-ROM | disk | FTP | other *** search
/ Boot Disc 8 / boot-disc-1997-04.iso / PDA_Soft / Psion / utils / Dutil2 / DATAUTIL.TXT < prev    next >
Text File  |  1994-08-08  |  16KB  |  356 lines
  1.                                DATAUTIL 2.0
  2.  
  3.  
  4. INTRODUCTION
  5.  
  6. DATAUTIL is a utility for the PSION 3A for viewing, searching and sorting Database
  7. files.  The utility makes use of the increased screen resolution of the 3A, and will
  8. therefore not run on the PSION 3.
  9.  
  10. The utility allows the records to be displayed in one of two modes:-
  11.  
  12. In the 'LIST' mode multiple records are shown with the fields  being displayed
  13. horizontally on the screen.  The 'screen' can be scrolled horizontally in order to view fields
  14. which are off the screen.
  15.  
  16. In the 'INDIVIDUAL RECORD' mode, the records are shown in a similar manner to the
  17. normal PSION application, but with the facility to scroll the 'screen' both horizontally and
  18. vertically to show fields which are off the screen.
  19.  
  20. Facilities are also included to allow searching and sorting.  In the search mode, all records
  21. meeting the search string can be shown in a 'list' mode, with the facility to scroll up and
  22. down the list, and to view fields off the 'screen'.
  23.  
  24.  
  25. INSTALLATION:
  26.  
  27. The file DATAUTIL.OPA should be copied into the \APP subdirectory either on the
  28. machine or external ram.  The program is then installed by pressing the keys PSION and I
  29. together, selecting the file DATAUTIL and pressing ENTER.  A new Icon for
  30. DATAUTIL should then appear on the system screen, together with a list of 'DBF' files in
  31. the \DAT sub-directories on all drives.
  32.  
  33. The utility itself will create files with a '.DUT' extension in the main internal \DAT sub-
  34. directory  for each database in which current program settings are saved.  The '.DUT'
  35. being prefixed with the name of the database being used.  These settings are saved to the
  36. internal ram, even if the database itself resides on an external 'disk', this avoids problems
  37. with writing to flash rams.
  38.  
  39.  
  40.                             USING THE PROGRAM
  41.  
  42. 1.   Select the database required from those listed under the DATAUTIL icon. 
  43.  
  44. 2.   On pressing the ENTER key, the database will be loaded.  If it is the first time that
  45.      this particular database has been used by the program, various parameters will be read
  46.      and calculated, on a large database this may take some time.  If you wish, you can
  47.      press ESC at any time, the utility will then calculate program settings from the data
  48.      read up to that point.  
  49.  
  50.      On exiting the database you will be given the option of saving these parameters and
  51.      other settings so that they can be used again the next time the database is used. (Thus
  52.      making loading the second time a lot quicker).
  53.  
  54. 3.   Once loaded the Database will be shown in the 'list mode', where all records are
  55.      displayed in record order as a list, and  with the record fields being shown
  56.      horizontally.
  57.  
  58. 4.   The utility will 'Toggle' between 'LIST' and 'INDIVIDUAL RECORD' mode by
  59.      pressing PSION-D.
  60.      Note: In order to get out of the 'individual record' mode,  it may be necessary to press
  61.      'ESC' before pressing PSION-D.   
  62.  
  63. GENERAL
  64.  
  65. 1.   The font used can be changed to any of the normal PSION types/sizes by pressing
  66.      PSION-SHIFT-F together.  The setting currently used will then be shown.  This can
  67.      then be changed by pressing 'TAB' to bring up a list and selecting the required font,
  68.      or alternatively using the horizontal cursor keys to scroll through the options.
  69.  
  70.      Changing the font will affect the number of lines and columns displayed on the screen.
  71.  
  72. 2.   The effective width of the display is the sum of the maximum lengths of all fields in
  73.      a record, which means that a lot of information could be off screen.  In order to see
  74.      this off screen information, the 'viewing screen' can be scrolled to the left and right
  75.      by use of the horizontal cursor keys.  To quickly reach the left or right field
  76.      extremities, press 'SHIFT' and the appropriate horizontal cursor key.  (Note.,
  77.      positioning  to the 'hard right' is only approximate.
  78.  
  79. 3.   To change the amount by which the screen scrolls, press PSION-M.  Enter a figure
  80.      indicating the approximate percentage of screen width for scroll required. (The dialog
  81.      indicates the current setting).
  82.  
  83. 4.   Sometimes it is useful to blank out, or partially clip some fields in order to maximise
  84.      the amount of information shown on the screen.  Pressing PSION-W will bring up a
  85.      screen showing the current field width settings, and the maximum and average values
  86.      of all the field widths in the database.  In order to calculate these figures, the utility
  87.      has to read every field of every record, on a large database this may take some time. 
  88.      Pressing 'ESC' will abort this process, and values will be calculated on the records
  89.      read up to that point.
  90.  
  91.      To change the field width settings:-
  92.  
  93.      a.   To set all field widths to their max values, press 'M'
  94.  
  95.      b.   To set all field widths to their average values, press 'A'
  96.  
  97.      c.   To manually set any field width:-
  98.           
  99.           Press the first digit of the field number to be changed.
  100.           
  101.           This will bring up a dialog, complete the field number and press enter.
  102.           
  103.           Enter  the value of field width required.  Entering '0' will cause this field to
  104.           be blanked.
  105.  
  106.           Repeat for all fields which need changing.
  107.  
  108.      d.   If there are more fields in the database than can be shown on one screen, the
  109.           vertical cursor keys can be used to scroll and view the additional fields.  An
  110.           asterisk next to the top or bottom field number indicates that there are more
  111.           fields to be viewed.
  112.  
  113.      e.   To use these new settings and return to the database, press 'S'.
  114.  
  115.      f.   To abort the setting process, lose all changes and return to the database press
  116.           'ESC'.    
  117.  
  118. 5.   Pressing 'END'  (PSION-Rt Cursor) will display the last record in the database.
  119.  
  120. 6.   Pressing 'HOME' (PSION-Lt Cursor) will display the first record in the database.
  121.  
  122. 7.   Pressing PSION-J will allow you to jump a specific record number in the database.
  123.      (Record numbers can be displayed on the left hand of the screen in list mode, and at
  124.      the bottom of the screen in individual mode).
  125.  
  126. 8.   Pressing PSION-S will save all the current field width and display mode settings to
  127.      a specific file for the database being used.  This file will be loaded automatically next
  128.      time the database is loaded.
  129.  
  130. 9.   Pressing the MENU key will bring up a menu in the normal PSION fashion.
  131.  
  132. 10.  Pressing the HELP key will give various help screens showing the keys used in the
  133.      database.
  134.  
  135. 11.  Pressing PSION-O will cause the current database to be closed, and another one
  136.      opened.  You will be given the option to save the current settings before closing the
  137.      file.
  138.  
  139. 12.  Pressing PSION-X will cause the current database to be closed, and the program
  140.      exited.  You will be given the option to save the current settings before saving the
  141.      file.
  142.  
  143.        
  144. LIST MODE
  145.  
  146. 1.   A list of records will be shown.  Each record occupying one line, and having its fields
  147.      displayed horizontally.  
  148.  
  149. 2.   The next or previous screenful of records can be shown by using the vertical cursor
  150.      keys.  To quickly jump to the beginning or end of the database, use the HOME
  151.      (PSION-Left) or END (PSION-Right) keys.
  152.  
  153. 3.   Fields, or parts of fields which extend past the current viewing screen can be seen by
  154.      using the horizontal cursor keys.  To quickly jump to the beginning or the end of the
  155.      horizontal line, press SHIFT-Left or SHIFT-Right.
  156.  
  157. 4.   Pressing PSION-T will toggle the display of the field labels (or titles) at the top of the
  158.      screen.
  159.  
  160. 5.   Pressing PSION-R will cycle between three display modes of the left hand column of
  161.      the display.  This left hand column is 'locked' during horizontal screen scrolling, and
  162.      is thus visible at all times.
  163.  
  164.      Mode 1:   No additional information is shown, only the current record line. (This
  165.                shows the maximum information on one line).
  166.  
  167.      Mode 2:   The current Record Number Prefixes the current record line.
  168.  
  169.      Mode 3:   The first field of the current record (may be truncated) prefixes the
  170.                current record line.
  171.  
  172.  
  173. INDIVIDUAL RECORD MODE
  174.  
  175. 1.   Each record occupies one screen.  Each field in the record occupies a new line.
  176.  
  177. 2.   The field information may extend off the screen, to see this additional information use
  178.      the horizontal cursor keys.  SHIFT-LEFT and SHIFT-RIGHT will move the display
  179.      screen to the beginning or end of the field.
  180.  
  181. 3.   If there are more fields than can be fitted vertically on the screen, the message "more
  182.      fields" will be shown at the bottom left corner of the screen.  The vertical cursor keys
  183.      will scroll the display up and down.
  184.  
  185. 4.   The current record number is shown at the bottom right of the screen.
  186.  
  187. 5.   Pressing the ENTER key will advance the display to the next record.
  188.  
  189. 6.   Pressing the DELETE key will show the previous record.
  190.  
  191. 7.   If the 'display title' setting is currently on, the field labels will be shown in the left
  192.      hand column of the display.
  193.  
  194. 8.   In order to change display modes, fonts, and other settings you have to be back at the
  195.      'MAIN MENU', pressing the 'ESC' key will take you back to the main menu.
  196.  
  197.      Whilst in the view record mode, the message 'VIEW RECORD' will be shown on the
  198.      bottom line of the display, this will change to 'MAIN MENU' when the main menu
  199.      is active. 
  200.  
  201. 9.   To change system settings, such as fonts, titles, scroll widths etc, and also to toggle
  202.      display modes, if the message 'MAIN MENU' is not shown on the bottom line of the
  203.      display, pressing the 'ESC' key will take you  back to the main menu,  '***  MAIN
  204.      MENU ***   will then be shown at the bottom of the screen.
  205.  
  206.  
  207. SORTING THE DATABASE
  208.  
  209. Pressing PSION, SHIFT and S, will sort the database into alphabetical order, based on the
  210. first field.   NOTE:  This sort modifies the positioning of the records in the database being
  211. read, and actually writes to that file.  Ensure any valuable data is backed up before
  212. performing a sort.  
  213.  
  214. Sorting is not recommended for files on a FLASH device, and large files may take some time
  215. to complete.   
  216.  
  217.  
  218. SEARCHING THE DATABASE
  219.  
  220. The utility has two modes of searching the database:-
  221.  
  222.      a.   A List mode where all records matching the search criteria are as a list of
  223.           records.  This list can be scrolled using the cursor keys, in a similar manner
  224.           to the main database.  Whilst in the 'list search'  mode, 'SEARCH FOR: + the
  225.           search string' will be shown on the top line of the display.  
  226.  
  227.           1.   To select the 'LIST' Search mode, press PSION-L.       
  228.  
  229.           2.   To exit the search mode, press the 'ESC' key.
  230.  
  231.           3.   The keys used to scroll the display etc, are the same as those used in
  232.                the main DATABASE LIST mode.
  233.  
  234.      b.   An 'individual record' mode where each record matching the search criteria is
  235.           shown one per screen, in a similar manner to the 'individual record' mode of
  236.           the main database.
  237.  
  238.           1.   To select the 'INDIVIDUAL RECORD' Search mode, press PSION-F
  239.      
  240.           2.   The display shown is similar to that used in the main database
  241.                INDIVIDUAL RECORD mode.
  242.  
  243.           3.   To view the next occurance of the search string you have to first exit
  244.                the VIEW RECORD display by pressing 'ESC', the message 'SEARCH
  245.                MODE' will then be shown on the bottom line of the display.
  246.  
  247.                Pressing PSION-N will then show the next occurance of the search
  248.                string, and PSION-P will show the previous occurance.
  249.  
  250.           4.   Whilst in the VIEW RECORD mode the keys used are the same as
  251.                those used in the INDIVIDUAL RECORD mode of the main database.
  252.  
  253.           5.   To exit the search mode, press the 'ESC' key until 'MAIN MENU' is
  254.                shown at the bottom of the screen. 
  255.  
  256.  
  257. JUMPING TO A SPECIFIC RECORD
  258.  
  259. Pressing PSION-J, will position the display at a specified record number.  
  260.  
  261.  
  262. HELP and MENU KEYS
  263.  
  264. In most instances, pressing the 'HELP' key will give a list of key presses, and pressing the
  265. 'MENU' key will allow operation of the program from a menu.
  266.  
  267. EXITING THE PROGRAM:
  268.  
  269. The program is exited by pressing PSION and X.  On exiting you will be given the option
  270. of saving the settings.  These settings include the current field widths and fonts, and are saved
  271. for each database used.  Alternatively these settings can be saved at any time by pressing
  272. PSION and S.
  273.  
  274.  
  275. LOADING A NEW DATABASE
  276.  
  277. A new database can be loaded by pressing PSION and O.
  278.  
  279.  
  280. LIMITATIONS   
  281.  
  282. Up to 26 fields having a maximum length of 255 characters can be displayed.
  283.  
  284. Any fields having 'TABs' included as part of the text will be shown as the 'TABs' being
  285. replaced by a single space.  The database file being read is not changed in any way, only the 
  286. way it is displayed.
  287.  
  288.  
  289. FILE CLOSE ERRORS and DATA COMPRESSION
  290.  
  291. Some database files which have recently been changed may give loading and saving
  292. problems, these being shown by the utility giving an error message.  This is because in order
  293. to safeguard data, and to prevent  writing to flash rams, the database is opened as read only. 
  294. Unfortunately when the files are closed the PSION automatically attempts to compress the
  295. datafiles.   
  296.  
  297. If this happens, either, try COMPRESSING the file using the option in the file menu of the
  298. built in PSION database program, and then reload the database using DATAUTIL, or use
  299. DATAUTIL to sort the data.  Remember sorting is not recommended on a flash ram, and may
  300. take some time on a large database.  Using the PSION option is probably easiest.
  301.  
  302. Alternatively, the error message may be ignored altogether, as long as no other error messages
  303. are displayed, the program should behave normally.
  304.  
  305.  
  306. DISCLAIMER
  307. Whilst every care has been taken to ensure correct operation of this program, the author
  308. accepts no liability for any loss of data, program malfunction, or any other problem, however
  309. caused.
  310.  
  311.  A.T. Abbey.  4 Broadacre Close, Bredon, Tewkesbury, Glos.  GL20 7NW CHANGES FROM VERSION 1.0
  312.  
  313. 1.   If updating from ver 1.0 please note that any *.DAT files which may have been
  314.      generated by the previous version of the utility,  in the \DAT subdirectory  of the
  315.      internal disk can be deleted.  These files are not used with the latest version.
  316.  
  317. 2.   Now caters for a total of 26 fields.
  318.  
  319. 3.   Now has horizontal and vertical scrolling of the window, thus allowing all the
  320.      database to be viewed.
  321.  
  322. 4.   Allows the screen width calculation to be terminated early.
  323.  
  324. 5.   Has an improved set field width facility.
  325.  
  326. 6.   Has several cosmetic improvements.
  327.  
  328. 7.   Has had several bugs fixed, (and no doubt a few new ones added with the new
  329.      facilities!).
  330.  
  331.      
  332.  
  333.                                  SHAREWARE
  334.  
  335. This program is issued as shareware, this means that you may try it for a short period to
  336. see if it suits your purpose.  If you wish to continue using it you should then register it,
  337. otherwise  you should remove the copy from your machine.  Please pass a copy onto other
  338. users for their evaluation, making sure that you include this documentation.  In no instance
  339. may registered copies be passed onto other users.
  340.  
  341. If you find this program useful and wish to register it, please send £8.00 to the author
  342.  
  343.                     A.T. Abbey
  344.                     4 Broadacre Close
  345.                     Bredon
  346.                     Tewkesbury
  347.                     Glos
  348.                     GL20 7NW
  349.  
  350. In return you will be sent a disk containing the latest program, and without the annoying
  351. 'NAG' screens beeps and delays.  If you require the disk to be sent to a destination other than
  352. the UK mainland, please enclose a suitable additional sum to cover postage costs.
  353.  
  354.  
  355.  
  356.