home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / CEREBRUM / WWUE110.ZIP / UPLDECHO.DOC < prev    next >
Text File  |  1999-03-01  |  5KB  |  135 lines
  1. ┌───────────────────[ A Cerebrum Programming Production ]────────────────────┐
  2. │                                                                            │
  3. │                           WWIV UpldEcho v1.10                              │
  4. │                   Copyright (c) 1993-1999 by Frank Reid                    │
  5. │                           All Rights Reserved                              │
  6. │                                                                            │
  7. │                      An External File Upload Utility                       │
  8. │                         for WWIV v4.30 BBS Systems                         │
  9. │                                                                            │
  10. └────────────────────────────────────────────────────────────────────────────┘
  11.  
  12. I. Introduction.
  13.  
  14. 1.  Description:  UpldEcho uploads files into your WWIV file areas directly
  15. from DOS.  UpldEcho is very useful in managing Fidonet "filebone" arrivals,
  16. which deliver files to your mailer.  It may also be used in conjunction with
  17. any utility that creates a FILES.BBS description file or to read in a newly
  18. added CD-ROM disk.  Before UpldEcho, you had to //UPLOADFILE in each defined
  19. area -- no more!
  20.  
  21. 2.  Operation:  UpldEcho searches the DOS directories defined as your transfer
  22. areas in //DIREDIT.  If a directory contains a FILES.BBS, it will upload those
  23. files into your WWIV file areas.  If the file is an archive and contains an
  24. extended description (FILE_ID.DIZ or DESC.SDI), it adds that as the extended
  25. description.  If the file is an image (GIF or JPEG), it puts the properties of
  26. that image (height/width/colors) into the extended description.
  27.  
  28. II. Installation.
  29.  
  30. 1.  Copy UPLDECHO.EXE to your main WWIV BBS directory.  UpldEcho takes the
  31. following, optional commandline parameters:
  32.  
  33.         UpldEcho [/F] [/C] [/D]
  34.  
  35.         /D - Delete the FILES.BBS after processing the file area.
  36.  
  37.              Default: FILES.BBS are retained after upload is complete.
  38.  
  39.         /C - Also include any areas defined as CD-ROM in the process.
  40.  
  41.              Default: CD-ROM areas are skipped during the search.
  42.  
  43.         /F - Use the alternate FILES.BBS format.
  44.  
  45.              Default: FILES.BBS format is two columns, e.g.:
  46.  
  47.              FILENAME.EXT   DESCRIPTION
  48.  
  49.              With the /F parameter, a four column FILES.BBS is used, e.g.:
  50.  
  51.              FILENAME.EXT   123456   01-23-45    DESCRIPTION OF THE FILE
  52.  
  53.  
  54. III. Usage.
  55.  
  56. Run UpldEcho directly from DOS and the Windows or OS/2 Command Prompt.  It can
  57. be called in a batch file, such as a WWIV external event, to check for files
  58. at prescribed times.  If you participate in the Fidonet filebone, you can call
  59. UpldEcho from your mailer batch file and upload files immediately after a new
  60. feed.  The popular AllFix file processor returns a traceable errorlevel if it
  61. processes inbound files.  You can use this to control UpldEcho, as indicated
  62. in the following example mailer batch file segment:
  63.  
  64.         REM Batch label to run AllFix
  65.         :filein
  66.         allfix file
  67.         REM errorlevel 8 indicates AllFix processed new files
  68.         if not errorlevel 8 goto nofiles
  69.         d:
  70.         cd\wwiv
  71.         upldecho
  72.         :nofiles
  73.         (continue with normal processing)
  74.  
  75. IV. About Cerebrum.
  76.  
  77. 1.  UpldEcho is another fine Cerebrum product.  Cerebrum is a group of loosely
  78. affiliated (and dwindling in membership) programmers providing innovative
  79. solutions for fellow WWIV sysops.  Several of Cerebrum's staff are also WWIV
  80. Support Sites!
  81.  
  82. 2.  Registration of UpldEcho is free!  Please drop me a note to one of the
  83. mailing addresses below to say you use it.
  84.  
  85. V. Disclaimer.
  86.  
  87. 1.  The author makes no warranties, expressed or implied, as to the quality or
  88. performance of this program.  Your use of this program constitutes your
  89. release of the author from liability or litigation for any indirect or
  90. consequential damages arising from the use of this program or its associated
  91. files.
  92.  
  93. 2.  In no event will the author be liable to you for any damages, including
  94. any lost profits, lost savings or other incidental or consequential damages
  95. arising out of your use or inability to use the program, or for any claim by
  96. any other party.
  97.  
  98. VI. History.
  99.  
  100. Version 1.00 (11/10/94)
  101.   - Initial release
  102.  
  103. Version 1.01 (11/14/94
  104.   - Forgot to include UPLDECHO.DOC in the archive!
  105.  
  106. Version 1.04 (07/21/95)
  107.   - Major rewrite using all file sharing routines.
  108.   - Eliminated configuration file.
  109.  
  110. Version 1.06 (06/01/96)
  111.   - Minor changes
  112.  
  113. Version 1.10 (02/01/99)
  114.   - Another major rewrite!
  115.   - Updated to use WWIV v4.30's ARCHIVER.DAT archive commands.
  116.   - Added capability to include image properties in description.
  117.  
  118. Thanks to all the Sysops who've made releasing modifications and utilities fun!
  119. Comments, criticisms, and suggestions for improvement should be directed to:
  120.  
  121.     WWIVnet  : 1@8213
  122.     IceNET   : 1@3104
  123.     TerraNet : 1@3104
  124.     WWIVLink : 1@13104
  125.     FILEnet  : 1@1160
  126.     Fidonet  : 1:109/568
  127.  
  128. You can always find the latest version (and tons of Sysop-specific utilities,
  129. doors and source modifications!) on:
  130.  
  131.             Eagle's Dare
  132.            (301) 498-1984
  133.            33.6k/24 Hours
  134.            telnet://bbs.filenet.wwiv.net
  135.