home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ALIASIT3.ZIP / SLAM30.ZIP / SLAM.DOC next >
Encoding:
Text File  |  1993-02-21  |  10.9 KB  |  280 lines

  1.  
  2.                       ------------------------------------
  3.                       Searchlight Alias Maker (SLAM) V.3.0
  4.                       ------------------------------------
  5.  
  6.                                By: Greg Belanger
  7.                            Late-Night Software, Inc.
  8.                          Late-Night BBS (403) 273-3503
  9.                                    (c) 1992
  10.  
  11.  
  12.  
  13. =-=-=-=-=-=-=
  14. What is SLAM?
  15. =-=-=-=-=-=-=
  16.  
  17. SLAM is for SLBBS V.2.15+ And is *NOT* compatible with any version prior
  18. to version 2.15...It was tested with 2.15C, 2.25 and 3.0 Beta, but should work with any other 2.25X, 3.XX ugrade version.  I strongly recommend you switch to the LATEST version of SLBBS to be sure.  SLAM optionally writes to ALIAS.DEF, depending on the Sysops needs.
  19. The basic purpose of SLAM is to automatically add a user's REAL name to the
  20. Alias field in SL's USER.SLX data file.  For this system to be effective, you
  21. should modify your STRINGS.SYS file to inform the user of your Alias format.
  22. What I did was to change the "Enter Your Name, or type NEW" line to read:
  23.  
  24. Enter your Name/Alias, or type NEW
  25.  
  26. Next, I changed the line in the New User registration process.  It originally
  27. prompts for "Name" and thus I changed it to read "Alias <OR> Full Real Name"
  28. thereby giving the user the OPTION to either use a REAL NAME or an ALIAS
  29. NAME.
  30.  
  31. SLAM was written as an ADDITION to another program I released
  32. called RENAME.  Anyone familliar with Glen Johnson's SLRENAME program
  33. will recognize RENAME's purpose -- to change Alias names to Real names
  34. on EXPORT and Real names to Alias names on IMPORT to the SL subboards.
  35. RENAME uses the Config.Slx file as a DATA file in changing the
  36. names in the .MSG files.  Previous versions of SLAM had SUPPORT for
  37. SLRENAME...This is no longer the case.  From v.1.7 on, SLAM will
  38. ONLY work with RENAME.  Glen Johnson never has shown support for a
  39. utility for SLRENAME, so I have DISCONTINUED support.
  40.  
  41. SLAM is a simple little program that will save Sysops who allow ALIASES alot
  42. of time.  I don't like the idea of MANUALLY adding a user's name AND alias
  43. to a the Aliases.Txt file EACH time a New User registers.
  44. SLAM does it automatically.  SLAM is a simple program which can be placed
  45. in the NEW USER autodoor or Autodoor BATCH FILE to question the user
  46. about an alias.  SLAM will send the sysop a message with the info
  47. (Users real name and Alias) and add the User's REAL NAME to the Alias
  48. field in the USER.SLX file.
  49. As well, it OPTIONALLY adds the Alias to the Searchlight ALIAS.DEF file.
  50. It will also check for a DUPLICATE name before adding that name to the
  51. files.  Simple.
  52.  
  53.  
  54. =-=-=-=-=-=-=-=
  55. Setting up SLAM
  56. =-=-=-=-=-=-=-=
  57.  
  58. Setting up SLAM is SUPER-EASY.  You only need to pass it five parameters:
  59. (Use the NEW USER Autodoor or place it in a BATCH FILE)
  60.  
  61.  
  62. Param 1:  Users Name (Use %U)
  63. Param 2:  C, M or N Ansi (Use %G)
  64. Param 3:  The Sysop's account name (Spaces replaced by underscores)
  65. Param 4:  Y or N for whether you want SLAM to add the Alias to ALIAS.DEF
  66. Param 5:  The DIR/PATH of ALIAS.DEF file
  67. Param 6:  The DIR/PATH of the CONFIG.SLx and other SLBBS data files
  68.           (You *MUST* use a trailing backslash after the DIR\PATH of
  69.            parameters 5 and 6)
  70.  
  71. Set the COMM Support to STANDARD, ABORT method to TERMINATE or 
  72. REBOOT and WRITE PROTECT to NO.  If you have trouble with SLAM
  73. hanging when carrier is dropped, you may have to EXPERIMENT with
  74. the COMM and ABORT methods based on your configuration.
  75.  
  76.  
  77. ** ALIAS.DEF NEED ONLY BE CREATED IF YOU WANT SLAM TO ADD THE NEW USERS
  78.    ALIAS TO ALIAS.DEF (Fourth command-line parameter) **
  79.  
  80.  
  81. EXAMPLE #1:
  82.  
  83. SLAM %U %G SYSOP Y C:\BBS\ C:\BBS\
  84.                          ^
  85.                     Don't forget the trailing backslash at the
  86.                     end of the path!
  87.  
  88. --This will load SLAM with the current users name, graphics mode, send the
  89. message to SYSOP and will look for and use the ALIAS.DEF file and SL 
  90. data/config file in C:\BBS\.  It WILL Add the users Alias
  91. to ALIAS.DEF as indicated by the "Y" as the fourth parameter.
  92.  
  93.  
  94. EXAMPLE #2:
  95.  
  96. SLAM %U %G MERLIN_THE_MAGICIAN N D:\SLBBS\NODE1\ C:\BBS\
  97.  
  98. --This will load SLAM with the current users name, graphics mode, send the
  99. message to MERLIN THE MAGICIAN and will look for the ALIAS.DEF
  100. file in D:\SLBBS\NODE1\.  It WILL NOT Add the users Alias to ALIAS.DEF,
  101. as indicated by the "N" as the fourth parameter.  Again, in this case,
  102. the SL config/data files are located in C:\BBS\.
  103.  
  104.  
  105. EXAMPLE #3 (Batch File--Loaded by the NEW USER Autodoor):
  106.  
  107. NEWUSER.BAT
  108.  
  109. @Echo Off
  110. CLS
  111. SLAM.EXE %1 %2 SYSOP Y C:\BBS\ C:\BBS\  <--- Make sure you call NEWUSER.BAT
  112.                                              with %U %G on the line
  113.                                              Ex: NEWUSER.BAT %U %G
  114.  
  115. That's it.  Pretty straight-forward.
  116.  
  117.  
  118. =-=-=-=-=-=-=-=-=
  119. The SYSOP Account
  120. =-=-=-=-=-=-=-=-=
  121.  
  122. Dont forget:  If you use a name with more than one word, such as MERLIN THE
  123. MAGICIAN, you *MUST* replace the spaces with underscores.  So that SLAM
  124. reads the WHOLE name.  Don't forget now...
  125.  
  126.  
  127. =-=-=-=-=-
  128. Sysop Mail
  129. =-=-=-=-=-
  130.  
  131. SLAM automatically sends the sysop a notice that the new user has chosen to
  132. use an alias, and provides that ALIAS as well as their REAL name.   
  133.  
  134.  
  135. =-=-=-=-=-=-=-=-=-
  136. The Future of SLAM
  137. =-=-=-=-=-=-=-=-=-
  138.  
  139. Hopefully there wont be a future for SLAM.  I would much rather have an
  140. ALIAS routine BUILT-IN to SLBBS. Let's all bug Frank some more, ok?  :-)
  141. SLAM and RENAME go hand-in-hand.  If you do not have RENAME, you can
  142. get it from any of the Addresses listed at the end of this DOC.
  143.  
  144.  
  145.  
  146. -=-=-=-=-=-=
  147. DRDOS USERS:
  148. -=-=-=-=-=-=
  149.  
  150. It may be necessary to load SLAM in the following manner when dealing with
  151. DRDOS. First, indicate your COMMAND.COM path and load SLAM with the /C
  152. option, or just add .EXE to the end of SLUF and it should run.
  153.  
  154. EX: (Using the example format above)
  155.  
  156. C:\COMMAND.COM /CSLAM %U %G SYSOP Y C:\BBS\ C:\BBS\
  157.  
  158. <<OR>>
  159.  
  160. SLAM.EXE %U %G SYSOP Y C:\BBS\ C:\BBS\
  161.  
  162. (Apparently DRDOS needs the .EXE extension of the filename.)
  163.  
  164.  
  165. =-=-=-=-=-=-=-=
  166. Error Messages:
  167. =-=-=-=-=-=-=-=
  168.  
  169. In the event that the Searchlight Config files cannot be found or are
  170. damaged, SLAM will inform the user by flashing the appropriate message.
  171. Standard messages that may be displayed in the event of an error are:
  172.  
  173. CONFIG FILE ERROR -- CONTACT SYSOP
  174. SUBBOARD ERROR -- CONTACT SYSOP
  175.  
  176. These will only be displayed if the files are DAMAGED or are NOT FOUND.
  177.  
  178.  
  179. -=-=-=-=-=-
  180. Disclaimer:
  181. -=-=-=-=-=-
  182.  
  183. While this program may not be completely bug-free, I have done significant
  184. testing to ensure that all MAJOR bugs have been squashed.  I do NOT
  185. guarantee that this software will run properly, nor will I be responsible
  186. for any damage that may occur to your computer hardware or software while
  187. using SLAM.  I feel that SLAM is relatively safe to run.   All the
  188. safeguards possible have been installed to provide maximum security for your
  189. system and files while SLAM is in operation.
  190.  
  191. SLAM was tested ONLY with MSDOS 5.0, if you encounter problems with SLAM,
  192. please discontinue using the product and inform me.  I will do my best
  193. to correct the problems.  SLAM *SHOULD* run fine under IBM DOS
  194. and MSDOS 3.0 or later.  DRDOS users, please see the section ABOVE about
  195. loading SLAM under DRDOS.
  196.  
  197.  
  198. -=-=-=-=-=-
  199. About SLAM:
  200. -=-=-=-=-=-
  201.  
  202. I have been programming in Pascal for several years.  It started with my
  203. first introduction to Turbo Pascal 4.0 in High School and I have continued
  204. to enjoy (sometimes!) programming various personal utilities and programs in
  205. my spare time.  I have tried virtually every SL 3rd party utility in
  206. existance.  I HATE messing with ALIAS programs, and I wanted a quick and
  207. EASY solution to the current ALAIS hassle.  So, here it is!  Thankfully
  208. there is already a good RENAME utility to do all the dirty work (RENAME).
  209.  
  210. As you might have guessed, SLAM is written entirely in Turbo Pascal
  211. version 6.0, and incorperates several TPU's from Frank LaRosa's great
  212. SL Programmer's Library kit.
  213.  
  214.  
  215. -=-=-=-=-=-=-=-=-=-=-=-=-=-=
  216. A Word About 3rd Party-ware:
  217. =-=-=-=-=-=-=-=-=-=-=-=-=-=-
  218.  
  219. Over the last couple of years,  I have noticed more and more authors
  220. DEMANDING payment for programs they create.  While I understand the work put
  221. into these BBS 'helpers' I am distressed by the fact that BBS operators
  222. should have to CONTINUOUSLY and NEVER-ENDINGLY pay for these utilities.
  223. That's why I choose to write FREE-WARE.  I support the idea of a bbs, where
  224. utilities and programs are shared.  Bbs operators are an amateur group
  225. of hobbyists and I don't believe a BBS operator should have to continuously
  226. pay for a hobby he/she already pays enough for.  The BBS operator is a fine
  227. species..One who allows people he/she doesn't even know to gain access to
  228. their system, out of the goodness of his/her heart.  I ask all you authors
  229. who are so valuable to the Searchlight community to join me in providing
  230. all our fellow SL sysops with quality FREE-WARE.  Donate some of your time
  231. and expertise to the cause...It'll make the BBS community a much better
  232. place!
  233.  
  234.  
  235. =-=-=-=-=-=-=-=-=
  236. Closing Comments:
  237. =-=-=-=-=-=-=-=-=
  238.  
  239. SLAM is FREE.  COMPLETELY FREE.  I ask no fee for using this software, but I
  240. do however ask that you do NOT modify the file, or crack (dis-assemble) the
  241. code in any manner.  If you find this program of value, and you want to
  242. contribute something, by all means send whatever you feel is fair.  My real
  243. payment is that you find this program of value, and I thank you for taking
  244. the time to read about SLAM.  If you have any problems, bug reports, general
  245. questions or concerns, please address them to the following address:
  246.  
  247.                                Greg Belanger
  248.                          3241 Doverville Crescent S.E.
  249.                              Calgary, Alberta
  250.                                   CANADA
  251.                                   T2B1V1
  252.  
  253.             ...Or contact me at any of these Network Addresses:
  254.  
  255.                            1:134/48  -- FidoNet
  256.                          201:5500/48 -- MetroNet
  257.                           99:9305/48 -- EggNet
  258.                          250:420/750 -- SL_Net
  259.  
  260.  
  261.            ...Or Call my bbs at (403) 273-3503  (24 Hours & HST)
  262.  
  263.  
  264.  
  265.                    Thanks for taking an interest in SLAM!
  266.  
  267.  
  268.  
  269. -------------------------------------------------------------------------------
  270. Created with Searchlight Programmer's Library
  271. Portions Copyright (c) 1991 Searchlight Software And Frank LaRosa
  272. SEARCHLIGHT, SL & SLBBS are registered trademarks of Searchlight Software, Inc.
  273. RENAME is copyrighted by Greg Belanger and Late-Night Software, Inc.
  274. SLRENAME is copyrighted by Glen Johnson 1:269/101@FidoNet
  275. MSDOS is a registered trademark of Microsoft, Inc.
  276. IBM is a registered trademark of International Business Machines, Inc.
  277. TURBO PASCAL & TP are registered trademarks of Borland International.
  278. DRDOS is a registered trademark of Digital Research, Inc.
  279. -------------------------------------------------------------------------------
  280.