home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ALIASIT3.ZIP / RENAME30.ZIP / RENAME.DOC < prev    next >
Encoding:
Text File  |  1993-02-21  |  10.9 KB  |  263 lines
  1.  
  2.                       ---------------------------------------
  3.                       Searchlight .MSG RENAME (RENAME) v.3.00
  4.                       ---------------------------------------
  5.  
  6.                                 By: Greg Belanger
  7.                             Late-Night Software, Inc.
  8.                           Late-Night BBS (403) 273-3503
  9.                                  (c) 1992, 1993
  10.  
  11.  
  12.  
  13. =-=-=-=-=-=-=-=
  14. What is RENAME?
  15. =-=-=-=-=-=-=-=
  16.  
  17. Rename is a program that allows SL Sysops to provide Alias support for their
  18. users.  RENAME replaces the FROM and/or TO fields of a .MSG file with the
  19. users ALIAS or REAL name depending on whether RENAME is in IMPORT or EXPORT
  20. mode.  I wrote another UTILITY called SLAM which you can use
  21. to AUTOMATICALLY update the SL data file each time a new user registers.
  22. You can get SLAM from any of the addresses listed at the end of this DOC.  
  23. RENAME can handle a maximum of 1500 Alias and Real names.  This should be sufficient for most bbs operators.
  24. As well, RENAME will check the SIZE of the .MSG file, and will process
  25. it *IF* it's less than 64K...I have NEVER seen a .MSG file that large, nor
  26. do I think it would make it through any of the networks, but the safety
  27. feature has been installed JUST IN CASE.
  28.  
  29.  ***********************************************************************
  30.  *                                                                     *
  31.  *   If you previously used SLRENAME, you can QUICKLY convert over     *
  32.  *   by RENAMING the IMPORT.CFG file to Aliases.Txt.  Also, you        *
  33.  *   don't have to worry about CASE sensitivity for the Alias or       *
  34.  *   Real names.  They can be either Upper and/or Lower case.          *
  35.  *   BUT, make sure the format of the file is:                         *
  36.  *                                                                     *
  37.  *   ALIAS=REALNAME                                                    *
  38.  *                                                                     *
  39.  *   If it is NOT in that format, check the EXPORT.CFG and see if      *
  40.  *   you can use that file instead.                                    *
  41.  *                                        *
  42.  *   Next, run the ALIAS2SL.EXE utility included in this package and   *
  43.  *   it will write the Aliases DIRECTLY to your SL data file.          *
  44.  ***********************************************************************
  45.  
  46.  
  47. RENAME is unique in that it will use a DIRECTORY list file to
  48. scan MANY directories all at once.  Another nice feature is that
  49. it uses only ONE Data file (The SL USER.SLx data file) instead of TWO
  50. TEXT files like the SLRENAME (c).  As well, RENAME will CONVERT the
  51. FROM and TO fields of an IMPORTED message to the ALIAS equivelent name,
  52. unlike SLRENAME (c) which only converts the TO field on IMPORT.
  53. On EXPORT mode, RENAME will change BOTH the TO and FROM fields
  54. to the REAL equivelent.  Otherwise, it operates in much the same
  55. manner as SLRENAME (c), well...Actually there is one other 
  56. MAJOR difference..IT'S COMPLETELY FREE.
  57.  
  58.  
  59. =-=-=-=-=-=-=-=-=-
  60. Setting up RENAME:
  61. =-=-=-=-=-=-=-=-=-
  62.  
  63. Setting up RENAME is EASY.  You only need to pass it two parameters:
  64.  
  65.  
  66. Param 1:  E or I (for EXPORT or IMPORT)
  67. Param 2:  Name of DIRECTORY LIST FILE
  68.  
  69. Ex:
  70.      RENAME30 I DIRS.LST
  71.  
  72.  Or
  73.  
  74.      RENAME30 E DIRS.LST
  75.  
  76.  
  77. The Directory List file is just a plain TEXT file of all the
  78. Subdirectories (Where the .MSG files are STORED) that you want
  79. RENAME to scan.  The format of the file is:
  80.  
  81. C:\BBS\BINK\SIERRA\
  82. C:\BBS\BINK\COMM\BINKLEY\
  83.  
  84. Etc..
  85. However, make sure the PATH length is less than 50 characters long.
  86. As well, the paths DO NOT have to be capitalized.  Be sure to use a
  87. TRAILING backslash at the end of each path line.
  88.  
  89.  
  90. =-=-=-=-=-=-=-=-=
  91. Operating RENAME:
  92. =-=-=-=-=-=-=-=-=
  93.  
  94. RENAME can be placed in your BATCH files for PACKING/UNPACKING your mail.
  95.  
  96.  
  97. EXAMPLE #1:
  98.  
  99. Unpack.Bat
  100. ----------
  101.  
  102. cd\                     |  This will UNPACK and TOSS all the .MSG   |
  103. cd bbs\bink             |  files into their respective DIRECTORIES  |
  104. QM TOSS -AAREAS.BBS     |  (Command will vary depending on ou MAIL  |
  105. cd\                     |  Packer/Tosser software).  Then, RENAME   |
  106. cd bbs                  |  will be executed in the BBS home DIR     |
  107. RENAME30 I DIRS.LST     |  and will scan ALL the directories in the |
  108. SLMAIL @IMPORT.LST      |  text file DIRS.LST, and modify the .MSG  |
  109. [..]                    |  files if necessary.                      |
  110.                         |  ** Make sure DIRS.LST is located in the  |
  111.                         |  SAME directory as RENAME, in this case   |
  112.                         |  C:\BBS. **                               |
  113.                         |  Then, the mail is imported into SL using |
  114.                         |  SLMAIL. Check the docs for SLMAIL if you |
  115.                         |  are unsure of the @ parameter.           |
  116.  
  117. Example #2:
  118.  
  119. Export.Bat
  120. ----------
  121.  
  122. cd\                        |  Basically the same procedure as above,   |
  123. cd bbs                     |  except in the reverse order.  SLMAIL is  |
  124. SLMAIL @EXPORT.LST         |  used to TOSS all the messages from the   |
  125. RENAME30 E DIRS.LST        |  subboards and then RENAME is called to   |
  126. cd\                        |  scan all the directories in DIRS.LST.    |
  127. cd bbs\bink                |  The final step invokes the MAIL packer/  |
  128. QM SCAN PACK -AAREAS.BBS   |  tosser to pack up all the messages.      |
  129. [..]                       |  (Again, commands will vary from MAIL     |
  130.                            |  utility to MAIL utility.                 |
  131.                            |  ** Once again, you MUST have the two     |
  132.                            |  Dirs.Lst file in the same directory as   |
  133.                            |  RENAME is run.                           |
  134.  
  135.  
  136. In Summary:
  137. -----------
  138.  
  139.  
  140. When Exporting Messages:
  141.  
  142. RENAME30 E is called IMMEDIATELY AFTER you have run SLMAIL EXPORT MODE and
  143. IMMEDIATELY BEFORE you pack up the .MSG files using your MAIL
  144. packer/tosser.
  145.  
  146.  
  147. When Importing Messages:
  148.  
  149. RENAME30 I is called IMMEDIATELY AFTER you have UNPACKED the .MSG's
  150. into their subdirectories with your packer/tosser and
  151. IMMEDIATELY BEFORE you run SLMAIL IMPORT MODE to import .MSG's into
  152. your subboards.
  153.  
  154.  
  155.  
  156. =-=-=-=-=-=-=-=-=-=-=
  157. The Future of RENAME:
  158. =-=-=-=-=-=-=-=-=-=-=
  159.  
  160. Hopefully there wont be a future for RENAME.  I would much rather have an
  161. ALIAS routine BUILT-IN to SLBBS. Let's all bug Frank some more, ok?  :-)
  162. RENAME and SLAM go hand-in-hand.  If you do not have SLAM, you can
  163. get it from any of the Addresses listed at the end of this DOC.
  164.  
  165.  
  166. -=-=-=-=-=-
  167. Disclaimer:
  168. -=-=-=-=-=-
  169.  
  170. While this program may not be completely bug-free, I have done significant
  171. testing to ensure that all MAJOR bugs have been squashed.  I do NOT
  172. guarantee that this software will run properly, nor will I be responsible
  173. for any damage that may occur to your computer hardware or software while
  174. using RENAME.  I feel that RENAME is relatively safe to run.   All the
  175. safeguards possible have been installed to provide maximum security for your
  176. system and files while RENAME is in operation.
  177.  
  178. RENAME was tested ONLY with MSDOS 5.0, if you encounter problems,
  179. please discontinue using the product and inform me.  I will do my best
  180. to correct the problems.  RENAME *SHOULD* run fine under IBM DOS
  181. and MSDOS 3.0 or later.
  182.  
  183.  
  184. -=-=-=-=-=-=-
  185. About RENAME:
  186. -=-=-=-=-=-=-
  187.  
  188. I have been programming in Pascal for several years.  It started with my
  189. first introduction to Turbo Pascal 4.0 in High School and I have continued
  190. to enjoy (sometimes!) programming various personal utilities and programs in
  191. my spare time.  I have tried virtually every SL 3rd party utility in
  192. existance.  I HATE messing with ALIAS programs, and I wanted a quick and
  193. EASY solution to the current ALAIS hassle.  So, here it is!  Thankfully
  194. there is already a good utility (SLAM) to update the Aliases.Txt file
  195. which RENAME uses.
  196.  
  197. As you might have guessed, RENAME is written entirely in Turbo Pascal
  198. version 6.0.  Thanks to Ross Himes and many of the other people who
  199. provided support, answers and in some cases even CODE to make RENAME
  200. a reality, without you guys RENAME could have been shelved.
  201.  
  202.  
  203. -=-=-=-=-=-=-=-=-=-=-=-=-=-=
  204. A Word About 3rd Party-ware:
  205. =-=-=-=-=-=-=-=-=-=-=-=-=-=-
  206.  
  207. Over the last couple of years,  I have noticed more and more authors
  208. DEMANDING payment for programs they create.  While I understand the work put
  209. into these BBS 'helpers' I am distressed by the fact that BBS operators
  210. should have to CONTINUOUSLY and NEVER-ENDINGLY pay for these utilities.
  211. That's why I choose to write FREE-WARE.  I support the idea of a bbs, where
  212. utilities and programs are shared.  Bbs operators are an amateur group
  213. of hobbyists and I don't believe a BBS operator should have to continuously
  214. pay for a hobby he/she already pays enough for.  The BBS operator is a fine
  215. species..One who allows people he/she doesn't even know to gain access to
  216. their system, out of the goodness of his/her heart.  I ask all you authors
  217. who are so valuable to the Searchlight community to join me in providing
  218. all our fellow SL sysops with quality FREE-WARE.  Donate some of your time
  219. and expertise to the cause...It'll make the BBS community a much better
  220. place!
  221.  
  222.  
  223. =-=-=-=-=-=-=-=-=
  224. Closing Comments:
  225. =-=-=-=-=-=-=-=-=
  226.  
  227. RENAME is FREE.  COMPLETELY FREE.  I ask no fee for using this software, I
  228. do however ask that you do NOT modify the file, or crack (dis-assemble) the
  229. code in any manner.  If you find this program of value, and you want to
  230. contribute something, by all means send whatever you feel is fair.  My real
  231. payment is that you find this program of value, and I thank you for taking
  232. the time to read about it.  If you have any problems, bug reports, general
  233. questions or concerns, please address them to the following address:
  234.  
  235.                                Greg Belanger
  236.                          3241 Doverville Crescent S.E.
  237.                              Calgary, Alberta
  238.                                   CANADA
  239.                                   T2B1V1
  240.  
  241.             ...Or contact me at any of these Network Addresses:
  242.  
  243.                            1:134/48  -- FidoNet
  244.                          201:5500/48 -- MetroNet
  245.                           99:9305/48 -- EggNet
  246.                          250:420/750 -- SL_Net
  247.  
  248.  
  249.            ...Or Call my bbs at (403) 273-3503  (24 Hours & HST)
  250.  
  251.  
  252.                    Thanks for taking an interest in RENAME!
  253.  
  254.  
  255. -------------------------------------------------------------------------------
  256. SEARCHLIGHT, SL & SLBBS are registered trademarks of Searchlight Software, Inc.
  257. SLAM is copyrighted by Greg Belanger and Late-Night Software, Inc.
  258. SLRENAME is copyrighted by Glen Johnson 1:269/101@FidoNet
  259. MSDOS is a registered trademark of Microsoft, Inc.
  260. IBM is a registered trademark of International Business Machines, Inc.
  261. TURBO PASCAL & TP are registered trademarks of Borland International.
  262. -------------------------------------------------------------------------------
  263.