home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / hamrags / pcfilter.doc < prev    next >
Text File  |  1987-01-07  |  5KB  |  108 lines
  1.                          PCFILTER.EXE
  2.                          Version 3.0
  3.                          ------------
  4.  
  5. Noisy telephone lines during ASCII data transfer often inject
  6. printer control codes into the download file.  Later, when
  7. the file is printed, these extraneous control codes may put
  8. the printer into various unwanted print modes.  PCFILTER will
  9. remove all ASCII codes below SPACE (32) except CR and LF.
  10. Additionally, PCFILTER will optionally remove all ASCII codes
  11. from 128 to 159 (since some editors may ignore the high bit
  12. and interpret them as ASCII 0 to 31), restrict the file to a
  13. particular line width, expand tabs, expand tab stops, create
  14. output files with a maximum size limit, delete extra line
  15. feeds and blank lines, delete extra spaces, and create a disk
  16. file (.PRN) suitable for FILE IMPORT into LOTUS 1-2-3 for
  17. file editing and printing.
  18.  
  19. OPERATING PCFILTER-
  20.  
  21. PCFILTER will create output file(s) on the default drive.
  22. Other drives for input may be referenced but path names are
  23. not supported in this version. Therefore, before PCFILTER is
  24. run, make sure you have adequate space remaining for the
  25. creation of the output file(s) on the default drive.
  26.  
  27. A typical command is  'PCFILTER IBMSIG'.  This command will
  28. create a filtered file 'IBMSIG.PRN' on the default disk drive
  29. using the default parameters.
  30.  
  31. The default parameters values are-
  32.      Maximum line width (W) - 132 characters
  33.      Replacement ASCII code (R) - SPACE (ASCII 32)
  34.      Output file extension (E) - 'PRN'
  35.      Tab stop expansion (T) - every 8 print positions
  36.      Tab expansion (X) - defaults to (T), above
  37.      Filter of ASCII 128-159 (N) - these codes are filtered
  38.      Remove extra spaces (S) - extra spaces NOT filtered
  39.      Limit file size (L) - limited to approximately 63K
  40.      Delete line feeds (D) - extra line feeds NOT deleted
  41.  
  42. Parameter (T) converts TAB STOPS (ASCII 9) in a file to the
  43. number of SPACES (ASCII 32) necessary to create tabular
  44. columns at the specified print positions.  Parameter (X)
  45. converts TAB STOPS to the specified number of ASCII SPACES.
  46. These parameters are MUTUALLY EXCLUSIVE.
  47.  
  48. The general format for PCFILTER is-
  49.  
  50. PCFILTER [d:]filename[.ext][-Optionxxx]
  51.  
  52. where  -Wx sets maximum line width
  53.        -Rx selects replacement ASCII code
  54.        -Ex specifies output file extension
  55.        -Tx sets tab stop positions
  56.        -Xx specifies tab stop SPACE expansion
  57.        -N  no filter of ASCII 128-159
  58.        -S  no repeat spaces
  59.        -Lx specifies maximum output file size
  60.        -D  no blank lines or extra line feeds
  61.  
  62. PCFILTER will now filter any size input file as long as there
  63. is enough room for output on the default drive.  Output files
  64. are limited to a maximum of approximately 63K (or less with
  65. the -L option).  Any additional output files are named
  66. TOOBIG1.PRN, TOOBIG2.PRN, etc.
  67.  
  68. For example, 'PCFILTER IBMSIG.DOC -W80 -R42 -ETXT -X4'
  69. creates the output file IBMSIG.TXT on the default drive with
  70. a maximum line length of 80 characters, ASCII 0-31 and
  71. 128-159 filtered and  replaced with ASCII 42 (*), and all
  72. tabs replaced with 4 SPACES.
  73.  
  74. 'PCFILTER B:IBMSIG -T6 -N' creates the output file IBMSIG.PRN
  75. on the default drive, with a maximum line length ot 132
  76. characters, ASCII 0-31 filtered and replaced with ASCII 32
  77. (SPACE), and all tabs replaced with spaces to allow tabular
  78. column printing every 6 print positions.
  79.  
  80. 'PCFILTER C:K7NTV.TXT -l58000 -d -s' creates the output file
  81. K7NTV.PRN on the default drive with blank lines and extra
  82. linefeeds deleted, extra spaces removed and the maximum size
  83. of the output file(s) restricted to 58K.  For example, if
  84. K7NTV.TXT had a file size of 128k, three output files would
  85. be generated, K7NTV.PRN(58K), TOOBIG1.PRN(58K), and
  86. TOOBIG2.PRN(12K).
  87.  
  88. Using PCFILTER with LOTUS 1-2-3
  89. LOTUS 1-2-3 makes a very nice editor when used with PCFILTER
  90. files.  First, create a 'dummy' .WKS file that specifies your
  91. printer output format.  For instance, this .WKS file will
  92. have the page length, printer control codes, and optional
  93. header or footer information specified (for example, use
  94. '@|DATA TRANSFER FILE|PAGE #' as a header and you will get
  95. nicely formatted pages with date and page number at the top
  96. of every page).  File Retrieve this .WKS file, then use File
  97. Import to import your PCFILTER file to the upper left corner
  98. of your blank .WKS file.  Then edit the file with /WDR, F2,
  99. etc., and print the file.  Be sure to NOT use the '-N' option
  100. since Lotus 1-2-3 File Import Text only looks at the lower 7
  101. bits and ASCII 128-159 must therefore be filtered out.
  102.  
  103. Patrick E. O'Farrell K7NTV
  104. 3O9 Hillcrest Drive
  105. Selah, Wa 98942
  106.  
  107. (5O9) 697-3133
  108.