home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / library / dos / database / dialbook / pbook.doc < prev    next >
Encoding:
Text File  |  1990-09-28  |  4.7 KB  |  93 lines
  1.                   Text File to Dialbook.DIR conversion
  2.  
  3. Dialbook is a program to convert a fixed length record text file into
  4. the Complete FAX/Communicator file format.  The input file can be
  5. created with a database by producing a text file report having the following
  6. format.  Each line will be a record.  Each record will have the
  7. following fields: Name - 20 characters
  8.                   CAMPhone - for FAX this will be blank. 27 characters
  9.                   FAXPhone - 27 characters
  10.                   Polling Password - 8 characters.
  11.  
  12. See the included TEST.DAT file for an example of an input file.
  13.  
  14. To run the program type
  15.  
  16.                          DIALBOOK <infilename>
  17.  
  18. There <infilename> is the name of the text file you wish to convert.
  19.  
  20. ┌───────────────────────────────────────────────────────────────────────────┐
  21. │                                                                           │
  22. │  This program and the accompanying source code are Copyright 1990 by      │
  23. │  Phil Miller.   You may feel free to make changes to the program for your │
  24. │  own use only.  Please do not change the program and then proffer it to   │
  25. │  others for sale!                                                         │
  26. │                     ALL RIGHTS RESERVED                                   │   │
  27. └───────────────────────────────────────────────────────────────────────────┘
  28.  
  29.                               Source Code
  30.  
  31. The souce code for this program is included.  Note that there is a
  32. TPString unit that must be obtained in order to compile this program as
  33. is.  There are only two functions used from it: Pad, which pads blank
  34. characters out (mostly used for Polling Password) and StUpCase which
  35. converts a string to upper case.  Both of these functions should be easy
  36. to reproduce if you need to.  The unit is from a Library of routines
  37. from Turbo Power called Turbo Professional 5.0.  If you are in any way
  38. serious about TP programming you should have them, or a similar library
  39. that you can substitute for these functions.
  40.  
  41. Source code is included to show how to BlockWrite your way to the ASCIIZ
  42. structure necessary to reproduce the file format.  Quick C and Turbo C
  43. programmers will be quick to notice that their language is easier to
  44. manipulate for this purpose than is Turbo Pascal.
  45.  
  46. If you improve this program, please upload a copy to me.  I would be
  47. happy to replace my copy with yours along with the credit for whatever
  48. changes you made.
  49.  
  50. If you distribute this program, make sure you do so intact.  This
  51. program was produced entirely by me, without supervision or assistance
  52. from The Complete PC Engineering.  As such is is to be used AS IS.
  53. In particular it will NOT catch errors such as:
  54.         You can convert more than 999 records into your Phone Book.
  55.         DON'T DO THIS!!!
  56.         Reading a phonebook with more than 999 entries will cause
  57.         unpredictable things with CFAX.
  58.         Create more than one DIALBOOK.DIR (Phone1.DIR, Phone2.DIR) and
  59.         rename with DOS to DIALBOOK.DIR to get what you need.
  60.  
  61. In the future, I will be improving this program.  In particular the
  62. following are on my list:
  63.         1. Create a Pascal file that can hold unlimited phone entries
  64.            including Company and a text annotation area.  The entries can
  65.            be selected for export to a DIALBOOK.DIR or Group files as needed.
  66.  
  67.         2. Read in the Send and Receive Logs in, sort them on a given field
  68.            and provide features to print and browse them.
  69.  
  70.         3. Provide a Group and Phonebook Editor: Browse, print, and
  71.            Edit functions
  72.  
  73. If you have other suggestions, please let me know.  I will address them
  74. as time allows.
  75.  
  76. Phil Miller
  77. 408-434-9702 Complete Communicator
  78. 408-434-9600 Voice
  79.  
  80.  
  81. ──────────────────────────────Further work History──────────────────────────┐
  82.                                                                             │
  83. 9-13-90 - 999 entry limit is now done.                                      │
  84.                                                                             │
  85. 9-20-90 - Fixed an error in CFAX groups.  They will read and write          │
  86. properly now.                                                               │
  87.                                                                             │
  88. 9-28-90 - Adding a CCOM unit to provide support for CCOM group files.       │
  89. CCOM groups have a slightly different format: They have a CAMPhone field    │
  90. (for Outgoing message recipient lists) that CFAX does not have.             │
  91.                                                                             │
  92. ────────────────────────────────────────────────────────────────────────────┘
  93.