home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / WP / WP054.ZIP / BMAIL.DOC next >
Text File  |  1989-12-29  |  5KB  |  131 lines
  1.                 Blackmail
  2.  
  3. Blackmail is a very simple program.  It extracts information from a dBase III
  4. database and merges it into a form file.  The form file designates dBase III
  5. fields by enclosing them inside delimiting characters.  It should accept all
  6. word processing document formats.  Although, you may have to re-adjust the
  7. paragraph breaking (justification) of the resultant form letters.
  8.  
  9. RUNNING BLACKMAIL:
  10.  
  11. To run Blackmail use the following command:
  12.  
  13. BMAIL text_file dbaseIII_file output_file delimiter
  14.  
  15.    text_file is a standard ASCII text file with fields delimited
  16.    dbaseIII_file is a dBase III file (include .dbf), e.g, mail.dbf
  17.    output_file is the new file created by the merge
  18.       if this output_file already exists then it is overwritten.
  19.    delimiter is a single character used in the text_file to mark db fields
  20.       default is the @ character.
  21.  
  22. INPUT
  23. Blackmail expects an ASCII text file as input.  The program design, however,
  24. permits it to work on any file, e.g., a WordPerfect 4.2 file.  It does this by
  25. looking through the file for the field delimiter, and examining the field name
  26. between the delimiters.  If the field name is valid, then it is replaced by the
  27. dBase III record contents.  If the field name is invalid, then the field name
  28. is ignored.  This enables, Blackmail to ignore extraneous fields in non-ASCII
  29. text files.  In some cases, although rare, the text file will accidentally
  30. contain a valid field name, e.g., @D@ for the delete field.  In this case,
  31. change your delimiter and try again.
  32.  
  33. For WordPerfect 5.0 users BMAIL requires field names be defined as comment
  34. fields. The comment should have the dBase field name enclosed in the
  35. specified delimiter. I have enclosed two WordPerfect example files.
  36.  
  37. Blackmail permits you to define where to begin replacing field names at
  38. with the keyword field name START.  This is essential for many form letters,
  39. and quite often required for non-ASCII input, e.g., WordPerfect 5.0.  The
  40. format for this keyword is *START* enclosed in delimiters.
  41.  
  42. FIELD NAMES:
  43.  
  44. In addition to simple field name substitution, Blackmail can substitute
  45. substrings of the field.  This is specified using a bracketing convention:
  46.  
  47. @Field[<start>,<length>]@,
  48.  
  49.  where <start> is the offset position to start the substring and <length> is
  50. the number of characters to use.  NOTE: You may not have any spaces before or
  51. after the comma separating the start and length, i.e., FIELD[0 , 3] is invalid
  52. and should be FIELD[0,3].  A zero length indicates field trimming.  For
  53. example, consider the ten character field, FIELD_ABC, as follows:
  54.  
  55. ABCDEFGHIJ
  56.  
  57. The expression @FIELD_ABC@ will produce ABCDEFGHIJ.
  58. The expression @FIELD_ABC[0,2] will produce AB.
  59. The expression @FIELD_ABC[6,3] will produce GHI.
  60. The expression @FIELD_ABC[3,0] will produce DEFGHIJ. (field is trimmed)
  61. The expression @FIELD_ABC[3] will produce DEFGHIJ   . (field isn't trimmed)
  62.  
  63.  
  64. OPTIONS:
  65.  
  66. /N - do not put CRLF breaks in memo fields. Use this for WordPerfect.
  67. /R<value> - set the right margin for CRLF breaks to <value>, e.g, /R72
  68.  
  69. Examples:
  70.  
  71. 1. ASCII TEXT
  72.  
  73. Example 1: Simple Form Letter
  74.  
  75. BMAIL sample.txt sample.dbf sample.out @
  76.  
  77. Sample.txt is a standard ASCII file; a simple form letter. It was created
  78. with Captain Blackbeard. Running the command will produce a set of four
  79. letters in the file sample.out.
  80.  
  81. Example 2: Labels
  82.  
  83. BMAIL label.txt sample.dbf label.out %
  84.  
  85. Will produce a simple list of mailing addresses.
  86.  
  87. Example 3: Inventory
  88.  
  89. BMAIL invent.txt invent.dbf invent.out
  90.  
  91. Will produce a simple room inventory.
  92.  
  93.  
  94. 2. WordPerfect 4.2
  95.  
  96. BMAIL sample.wpf sample.dbf sample.out @ /N
  97.  
  98. Sample.wpf is a WordPerfect 4.2 file with underline and bold.  Running the
  99. command will produce a set of four letters in the file sample.out.
  100.  
  101.  
  102. 3. WordPerfect 5.0
  103.  
  104. Example 1: Purchase Requisition using dBase IV
  105.  
  106. BMAIL req.wp req1 req.out ~
  107.  
  108. Produces a purchase requisition.  This form is set up for printing on a
  109. pre-printed purchase requisition form.
  110.  
  111. Example 2: Complex College Class Information Form
  112.  
  113. BMAIL class.wp class.f89 class.out ~ /n
  114.  
  115. Creates a filled in form about college classes.
  116.  
  117. J K Powers is committed to the principle of free distribution and voluntary
  118. contributions after you have tried and liked the product.  While Blackmail is
  119. copyrighted, the copyright owner has made it available for free distribution.
  120. Please feel free to give Blackmail to your friends.  We are counting on you as
  121. a participant in the largest distribution network in the nation (the owners and
  122. users of PCs) to make Blackmail a popular product.  You can register Blackmail
  123. for 25 dollars.  Dealer inquiries are welcome.  The mailing address for
  124. Blackmail is:
  125.  
  126.    J K Powers
  127.    222 W. Spruce St.
  128.    Sequim, WA  98382
  129.  
  130.  
  131.