home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / c / csxtm106.zip / CSXTIM.DOC < prev    next >
Text File  |  1992-05-29  |  6KB  |  114 lines
  1.         (****************************************************)
  2.         (* CSXTIME Ver 1.0    Written by Gary Bouchard      *)
  3.         (* SysOp - The Computer Store BBS                   *)
  4.         (* St. Augustine, Florida (904)794-0063             *)
  5.         (* Copyright(c) 1992....All Rights Reserved         *)
  6.         (* Released May 29, 1992    Modified                *)
  7.         (****************************************************)
  8.  
  9.                            Description
  10.  
  11. CSXTIME is a small PCBoard utility written for PCBoard 14.5a or greater
  12. that will allow your users to find out how long it would take to
  13. transfer a file from your BBS. The program was written to operate as a
  14. seamless menu option type utility, which will very quickly tell the user
  15. the desired information without trying to use the "D"ownload function
  16. and aborting for his/her answer.
  17.  
  18.                               Setup
  19.  
  20. You need to copy at very least the CSXTIM.EXE program and the associated
  21. configuration file CSXTIM.CNF to a directory accessible by PCBoard. If
  22. you have room I suggest the \pcb home directory.
  23.  
  24. Edit your CSXTIM.CNF file to reflect the desired information. There are
  25. 3 pieces of information that go into the config file.
  26.  
  27. Line 1) INTERRUPT.  ; This is used in all ProKit type Doors.
  28. Line 2) ZIP         ; This is the default file extension to use.
  29. Line 3) User Prompt ; Definable user prompt with a max of 60 chars in
  30.                       length. You may also use @X## Color macros to
  31.                       define this prompt. See the sample config file
  32.                       enclosed.
  33.  
  34. You must then go into PCBoard setup, select option "J" - Main Board
  35. configuration. Add an entry into the PCBoard Doors.lst file to allow
  36. proper operation of the program. On my BBS it looks like this;
  37.  
  38. ╔═════════════════════════════════════════════════════════════════════════════
  39. ║                               Edit DOORS File
  40. ║
  41. ║                                     USER DOOR
  42. ║    Filename    Password   Sec Login SYS  SYS  Shell    Path to DOOR Files
  43. ║   ══════════ ════════════ ═══ ═════ ════ ════ ═════ ════════════════════════
  44. ║  1) @                      30   N    N    N     Y   C:\PCB\
  45. ║
  46. ║
  47. ║
  48. ║                       Press F2 to edit the DOOR file
  49. ║
  50. ║  ESC=Exit   Alt-R=Repeat a Line   Alt-I=Insert a Line   Alt-D=Delete a Line
  51. ╚══ 09:51:25 ═══ 05-29-92 ══════ F1 ═ help ════ caps: OFF  num: ON   ins: OFF
  52.  
  53. I created a PCBoard type batch file (no extension) called "@". Inside
  54. this PCBoard bat file I have the following;
  55.  
  56. @echo off
  57. c:\pcb\xtime.exe c:\pcb\xtime.cnf c:\pcb
  58.  
  59. Notice that I placed path names on both the executable program AND the
  60. config file. PCBoard is much more efficient in running programs that are
  61. executed in this manner.
  62.  
  63. I then added the "@" command to my PCBoard menu, and you can also add
  64. help text to it, following the PCBoard format.
  65.  
  66.                             OPERATION
  67.  
  68. Operation is simply this; At the PCBoard command prompt, whether at the
  69. Main Board or in a conference, the user would type "@ <filename>" and
  70. press <enter>. If the user types the "@" command without any filename,
  71. it will respond with your user defined prompt, asking for a file name.
  72. If the user responds with an <enter> with no file name, it simply
  73. returns to the PCBoard command prompt. In other words, the user never
  74. knows that he left PCBoard. Once the program begins, it will go through
  75. all of the DL paths you have specified in your PCBoard setup, looking
  76. for this file. Once found, the program will display the file size,
  77. estimated transfer time, and then current connect speed. Pressing enter
  78. from this point returns you back to the PCBoard command prompt.
  79.          
  80.                              DETAILS
  81.  
  82. CSXTIME is a copyrighted program. It is not Public Domain Software. I
  83. retain the rights to the source code for CSXTIME, and any modification,
  84. de compilation, or otherwise general hacking of CSXTIME is prohibited.
  85.  
  86. I cannot be held responsible for any damages caused by the use of this
  87. program. All know bugs have been squashed, but as with any new program,
  88. it has not been tested in every possible environment
  89.  
  90. There is no charge for CSXTIME. The program is being offered as
  91. FREEWARE to the thousands of PCBoard SysOps who are partially
  92. responsible for the BBS revolution. I am not a professional programmer, and
  93. I have a full time job (fortunately!). I program for a hobby, and write
  94. utilities for my personal PCBoard BBS. I share my utilities with other
  95. PCBoard SysOps, because I know of the hardships that can sometimes come
  96. about from running a BBS, including the many dollars put in to each
  97. system for the software and hardware needed to run a good system. SysOps
  98. like myself cannot afford to pay for all of the utilities authored by
  99. all of these people which make the job of running a BBS some much
  100. easier. There are many quality programs out there, that are well worth
  101. the small amount of money that is requested, but it all adds up, and
  102. fast! That is why I write FREEWARE programs..
  103.  
  104. As you might have noticed, I am not a good writer when it comes to
  105. documentation. If you do not understand something relating to this
  106. program please feel free to call my free access BBS at the phone number
  107. written at the top of this document. I will try to clarify whatever
  108. problem your having.
  109.  
  110.                            Acknowledgements
  111.  
  112. Portions of this program have been written with the aid of routines
  113. written by Samuel H. Smith of the ToolShop BBS (Prodoor).
  114.