home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / dizit20.zip / DIZIT.DOC < prev    next >
Text File  |  1993-05-11  |  12KB  |  282 lines
  1.                                 DizIt v2.0
  2.                        
  3.                              For PCBoard v14.5a
  4.  
  5.                                     By
  6.  
  7.                               Copyright 1993
  8.                                 Robert Neal
  9.                                 317 Hickory
  10.                            Romeoville, IL  60441
  11.  
  12.                                 Support BBS:
  13.                          Corporate Headquarters BBS
  14.                   Node #1: (815) 886-3233  14400 v.32bis
  15.                   Node #2: (815) 886-9381  14400 v.32bis
  16.  
  17.  
  18. |       Text marked with "|" indicates a change since last version.
  19.  
  20.  
  21. |v2.0 is a major rewrite of the original DizIt v1.x code. Sysops
  22. |upgrading please refer to documentation for changes.
  23.  
  24.  
  25.  
  26.                             PROGRAM INFORMATION
  27.                             ===================
  28.  
  29. As a sysop, you've probably downloaded hundreds of files to add to your
  30. board. You've probably used the local upload option in PCBoard to add
  31. these files to your system, or you've used PCBFiler to read the new
  32. files and manually typed in each file description. But with many files
  33. now including their own description file, FILE_ID.DIZ and DESC.SDI,
  34. wouldn't it be nice to have a program do all the work for you?
  35.  
  36. DizIt is a utility written for PCBoard v14.5a to do just that. DizIt was
  37. written to aid sysops in adding files which contain FILE_ID.DIZ or
  38. DESC.SDI into their upload directory from the command line. The entire
  39. process is simple to do, even easier than using the "local upload"
  40. option of PCBoard.
  41.  
  42. |DizIt will read the names of all files in a directory you indicate and
  43. |then quickly snoop through each file looking to see if FILE_ID.DIZ or a
  44. |DESC.SDI file can be found. If found, the file is processed.
  45.  
  46. |Additionally, if FILE_ID.DIZ or DESC.SDI is not found in an archived
  47. |file, DizIt can be configured to scan a text file, that is in PCBoard
  48. |directory format, and import descriptions directly from that file. Great
  49. |for importing files from captured file listings of other BBS, file
  50. |listings from CDROM's, etc. Text files do NOT need to include the "|"
  51. |character which PCBoard requires. DizIt will import any file which
  52. |includes the description starting in the 34th column.
  53.  
  54. If no description file is found DizIt will do no further processing of
  55. the file except for moving the file to the holding directory you've
  56. indicated. This allows you to place all your files you want to add in
  57. the directory and let DizIt search for those that can be automatically
  58. added to your PCB File directory listing.
  59.  
  60. Currently, DizIt is written to process ZIP and ARJ archived files.
  61. Based on my experiences, the majority of files being distributed are in
  62. these two formats and these two formats will suffice for almost all
  63. PCBoard sysops. If you would like to see another format included, please
  64. feel free to write me and I'll look to add the format to DizIt.
  65.  
  66. My thanks to Marc Medow of Midas Touch BBS and Ray Sulich of Straight
  67. Board BBS for taking the time to beta test this program. Having someone
  68. else look over your work helps get the cobwebs out.
  69.  
  70.  
  71.  
  72.                         PROGRAM INSTALLATION/OPERATION
  73.                         ==============================
  74.  
  75. INSTALL
  76. -------------------------
  77.  
  78. Place the DIZIT files into a directory in your path. You may place DIZIT
  79. in it's own directory if you so choose, but you must be sure to properly
  80. configure the batch files to make the call to the proper directory when
  81. running DIZIT.
  82.  
  83. Ensure that the appropriate archiving programs are available in your
  84. directory path. For ZIP files, you'll need PKZIP.EXE and PKUNZIP.EXE.
  85. For ARJ files you'll need ARJ.EXE. DIZIT makes a call to these programs
  86. to extract the description files as well as importing your BBS comment
  87. file.
  88.  
  89.  
  90.  
  91. CREATE CONFIGURATION FILE
  92. --------------------------
  93.  
  94. Edit DizIt configuration file, DizIt.CFG. Use your favorite text
  95. editor to edit this file.
  96.  
  97. The items in the configuration file are as follows, do not include the
  98. line number references. Refer to detailed explanation below for each
  99. line:
  100.  
  101.         DizIt.CFG
  102.         --------------------------
  103. Line 1: Corporate Headquarters BBS
  104. Line 2: 0
  105. Line 3: G:\WORK
  106. Line 4: C:\UPLOAD
  107. Line 5: C:\HOLD
  108. Line 6: D:\PCB\MAIN\UPLD
  109. Line 7: D:\BBS.CMT
  110. |Line 8: D:\IMPFILE
  111. |Line 9: D:\DIZIT\DIZIT.LOG
  112.  
  113. Line 1: BBS Name
  114.  
  115. Line 2: Registration number, leave as 0 if unregistered.
  116.  
  117. Line 3: Drive/path to be used for temporary work area. A RAM disk, if
  118.         available, is recommended. Ensure that this directory exists
  119.         before using DizIt. Do not include the trailing "\" at the
  120.         end of the directory name.
  121.  
  122. Line 4: Drive/path of where files are to be moved to once they are
  123.         processed. This could be your public upload directory, private
  124.         directory or any other directory you choose. Again, ensure that
  125.         this directory exists before using DizIt. Do not include the
  126.         trailing "\" at the end of the directory name.
  127.  
  128. Line 5: Drive/path of where files should be moved if either FILE_ID.DIZ
  129.         or DESC.SDI is not found. Enter "NONE" on this line if you want
  130.         DIZIT to keep the files in the directory they are currently
  131.         located.
  132.  
  133. Line 6: Full path/filename of the file to which is to be updated with
  134.         the files imported. Typically this will be your public upload
  135.         directory, but you may want to instead move the files to your
  136.         private upload directory so that you may preview the files
  137.         before making them public. This file should relate to the
  138.         directory choosen above.
  139.  
  140. Line 7: Full path/filename of a comment file you want to have added to
  141.         the ZIP file. Typically, this may be your "BBS AD" comment.
  142.  
  143.  
  144. |Line 8: Full path/filename of a text file to be scan and descriptions
  145. |        extracted from for import. File must be in PCBoard file
  146. |        directory format.
  147.  
  148. |Line 9: Log file for DizIt, records name of files imported and if
  149. |        description file was found or not.
  150.  
  151.  
  152.  
  153. PROGRAM OPERATION
  154. ------------------
  155.  
  156. |Move all files to be processed into a temporary file directory. This
  157. |directory should only contain files you wish to have imported into your
  158. |PCBoard directory.
  159. |
  160. |Enter the following command at the DOS prompt:
  161. |
  162. |DIZIT DIZIT.CFG C:\DIZTEMP
  163. |----- --------- ----------
  164. |  ^       ^          ^
  165. |  |       |          \ Location of your temporary file directory
  166. |  |        \ Name of your configuration file
  167. |   \ Name you have used for the DizIt .EXE program
  168. |
  169.  
  170.  
  171.  
  172. |Once the prorgam starts, it will read the names of all files in your
  173. |temporary file directory. DizIt will then, if instructed, add the ZIP
  174. |COMMENT specified on line 7 of the DizIt.CFG file to the ZIP file.
  175.  
  176. DizIt will then check the ZIP file to see if the FILE_ID.DIZ or
  177. DESC.SDI file exists in the ZIP file. If not found, DizIt will skip the
  178. file -- it will not place the filename in the PCBoard file directory
  179. listing.
  180.  
  181. If FILE_ID.DIZ or DESC.SDI is found, DizIt will extract the file to
  182. your temporary work directory and then begin to add the file to the end
  183. of your PCBoard file directory indicated in the configuration file.
  184. Unlike other similar programs, DizIt will update your PCBoard file
  185. listing with the file size and the current date of the upload, no
  186. further processing of the PCBoard file directory list is required.
  187.  
  188. |If FILE_ID.DIZ or DESC.SDI is not found, DizIt will optionally scan the
  189. |text file indicated in line 8 of the DIZIT.CFG file for filename
  190. |matches. If a match is found, DizIt will automatically import the
  191. |description from the text file.
  192.  
  193. Once DizIt has imported the file and description into your PCBoard file
  194. directory list, DizIt will move the file from the current directory to
  195. the directory specified in line 4 in the configuration file.
  196.  
  197.  
  198.  
  199.                               REGISTRATION
  200.                               ============
  201.  
  202. DizIt is released as user support software (aka SHAREWARE). I don't
  203. expect you to register the program if you don't like it or if it doesn't
  204. meet your needs (just stop using it). But if you continue to use DizIt
  205. after a reasonable evaluation period of up to 30 days, you are required
  206. to make payment for the program or stop using it.
  207.  
  208. DizIt is NOT crippled in any way other than a marker "->DizIt" will be
  209. added to the last line of the file description field. This function has
  210. been added as an incentive to register the program. Once you have
  211. registered the program, the marker will no longer added to the imported
  212. description.
  213.  
  214. Registration is only $10 and will include unlimited free upgrades and
  215. support via my BBS.
  216.  
  217. Please use the form REGISTER.FRM included with the program to register
  218. DizIt. If this file is missing, send a check for $10 (US funds) to:
  219.  
  220.         Robert Neal
  221.         317 Hickory
  222.         Romeoville, IL  60441
  223.  
  224. Please include your BBS name as this information will be used to create
  225. your unique registration key file. You may receive your registration
  226. file via my support BBS (but please be sure you have an account
  227. established on my BBS so that I can leave this information in a private
  228. message to you) or via the US Mail. Please indicate your preference.
  229.  
  230. Keep your eye open for other utility programs from me written for
  231. PCBoard. Several programs are now in the works and should be released
  232. soon. Also, look for my door programs, Card Sharks and Links Golf
  233. (available on my BBS as well), I think your users will enjoy playing
  234. them. See the file OTHER.TXT for a listing of all my currently available
  235. programs.
  236.  
  237. You may register online with your Visa, MasterCard, Amex or Discover
  238. card by calling my BBS and typing CHARGE at the main menu prompt.
  239.  
  240.  
  241.  
  242.                                   SUPPORT
  243.                             ===================
  244.  
  245. If you have any questions, comments, problems, suggestions for enhancements,
  246. etc., I may be reached at my support BBS or by mail. In addition, you may send
  247. a message to me on the RIME conferences to my BBS "CHQBBS", I regularly
  248. monitor the messages in the Sysop, BBS and PCBoard Support conferences. I can
  249. also be reached via Prodigy, PNSP01A.
  250.  
  251.  
  252.  
  253.                              LEGAL INFORMATION
  254.                       ===============================
  255.  
  256. This program is provided on an "AS IS" basis.  No warranty of any kind is
  257. expressed or implied.  YOU USE THIS PROGRAM AT YOUR OWN RISK.  I take no
  258. responsibility for any damage caused directly or indirectly from the use or
  259. the inability to use this program.
  260.  
  261.  
  262.  
  263. VERSION HISTORY:
  264.  
  265.         v1.0 - Initial release
  266.         v1.1 - Fixed bug where if NONE was selected as the directory to
  267.                  move files to, DIZIT would rename file to NONE.
  268.                If DIZIT processed a file at the same time that the
  269.                  PCBoard upload directory was being browsed on a 2nd
  270.                  node, DIZIT would return error. Revised file handling
  271.                  so that this no longer occurs - DIZIT updates file
  272.                  without an error.
  273.         v2.0 - Rewrite of original code for improved status display and
  274.                  speed.
  275.                Added option to scan text file listing for descriptions
  276.                  to be imported if FILE_ID.DIZ or DESC.SDI file is not
  277.                  found.
  278.                Program now includes internal routines to read directory
  279.                  information. No need to use batch files to process a
  280.                  group of files.
  281.                Added LOG FILE feature.
  282.