home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / IM100.ZIP / IMHERE.DOC < prev    next >
Encoding:
Text File  |  1993-11-07  |  8.5 KB  |  308 lines
  1.  
  2.  
  3.        ■ I'M HERE (Multi-Line Utility) ■    by Serge Sozonoff (c)1993
  4. ──────────────────────────────────────────────────────────────────────────────
  5.  
  6.  
  7.  
  8.              ─────────────────────────────────────────────────
  9.                                RELEASE 1.00
  10.                                 07/11/1993
  11.              ─────────────────────────────────────────────────
  12.               FOR USE WITH RemoteAccess 2.xx and 2.xx/Pro ONLY
  13.  
  14.  
  15.  
  16. DISCLAIMER
  17. ──────────
  18.  
  19. This file may be distributed freely as long as all the file are left untampered
  20. and they are all present in the actual archive. Do not try and change anything
  21. as this will cause the program to stop working.
  22.  
  23. Use of this program is at your own risk, there is no guarantee and if this
  24. thing kills your system, I can not be held responsible !
  25. Like always it is recomended to make a back up first !!
  26. But since you are all serious users this should be done allready.
  27.  
  28.  
  29. The program has been succesfully run under OS/2, Netware 3.11, Netware Lite,
  30. and Dos 5.0 and 6.0.
  31.  
  32.  
  33. REGISTRATION
  34. ────────────
  35.  
  36. This is a small utility written for Remote Access 2.xx. It is ShareWare !
  37. Meaning that you may freely test this program for a limited period of 30
  38. days. If you continue to use this program after the 30 day period then you
  39. must register the product. See the TXT file "Register.Eng" for more info.
  40. Registering entitles you to use this program on your Multi-Line BBS for
  41. all nodes. Your key and registration will be valid for all future versions.
  42.  
  43.  
  44. ABOUT THIS PROGRAM
  45. ──────────────────
  46.  
  47. Well this is a little program I wrote that enables users who connect to your
  48. BBS to see who is allready on line. As well as this it sends an On-Line message
  49. in ANSI or ASCII to each connected user telling him in his language when the 
  50. other users LogIn and LogOut. It respects the quite flag and if a user has this 
  51. set then it will not send any messages to him/her. If the hidden  flag is set 
  52. then the user will NOT be show nor will a message be sent to the other users 
  53. about him.
  54. ImHere also has a feature which will post a message to the SysOp telling him he
  55. has a new user and the information the new user has entered EG. Address etc ..
  56.  
  57.  
  58. It is a very easy to use thing and there should be no problems in setting it
  59. up. ALL ideas are welcome.
  60.  
  61.  
  62.  
  63.  
  64.  
  65. Installation
  66. ────────────
  67.  
  68. Make sure you have the RA environment variable set.
  69.  
  70. EG. SET RA=C:\RAX
  71.  
  72.  
  73. Make sure you have Share loaded.
  74.  
  75. Make sure you have defined a Semaphore directory in RAConfig.
  76.  
  77. Unpack archive in any Sub-Dir you want. ImHere will use the RA environment
  78. variable as well as the Config.RA file to find what it needs. It will look for
  79. the DORINFO1.DEF, EXITINFO.BBS in the CURRENT directory.
  80. If not found the program will halt.
  81.  
  82. Copy and Edit the ImHere.CTL file in the same place as the ImHere.Exe file.
  83.  
  84. The ImHere.CTL file should have SIX options :
  85.  
  86. AnnounceNew = ON/OFF  : Turn post message to SysOp about newuser ON or OFF
  87.  
  88. Board = x             : Msg. Board Number to post new user message too sysop
  89.  
  90. NewFlag = A1..D8      : This tells ImHere which Flag you are using for the
  91.                         New User Announce feature. You must set this flag in
  92.                         RaConfig|Options|New Users so that when a NewUser logs
  93.                         in ImHere will see the flag and announce the user.
  94.                         ImHere will turn the flag OFF afterwards so you do not
  95.                         need to worry about this.
  96.  
  97.  
  98. Log  = ON/OFF         : Turns logging to Ra.log ON or OFF.
  99.  
  100.  
  101. Name =                : This is your System Name and is used when making
  102.                     your key.
  103.  
  104. Key  =              : This is your key when registered. Otherwise leave 
  105.                         it to the 12 Zeros "000000000000".
  106.      
  107.  
  108. Thats all for the ImHere.CTL file.
  109.  
  110.  
  111.  
  112.  
  113. RUNNING ImHere
  114. ──────────────
  115.  
  116. The program needs to be run twice once at login and once at logoff.
  117. The parameters are IMHERE.EXE <ON|OFF> <NODENUMBER>
  118.  
  119. <ON|OFF> Stand for logON and logOFF depending if the user is logging in or out.
  120.  
  121. <NODE NUMBER> I use the *N to pass the node number to imhere.
  122.  
  123. <*M> Optional see NOTES
  124.  
  125.  
  126. Now you have to ways to set it up.
  127.  
  128.  
  129. You can either make a menu type 7 that only executes once using flags,
  130. or you can use the Remote Access option which allows a text file to
  131. shell to DOS. This is the way I do it and it works fine.
  132.  
  133. EG. I don't use the welcome1.ans file for anything so I just created one and in
  134. it I put:
  135.  
  136. ^XC:\RAX\IMHERE.EXE ON *N|
  137.  
  138. You can also put it at the beggining of Welcome.ans or wherever you want
  139. it to be executed.
  140.  
  141. Don't forget that when executing a prog from within a text file you need to put
  142. a "|" character at the END.
  143.  
  144. Then at the begining of the GOODBYE.ANS file I put:
  145.  
  146. ^XC:\RAX\IMHERE.EXE OFF *N|
  147.  
  148.  
  149. ** NOTE ** if this options is used make sure that you have set the 
  150.    Raconfig|System|Text Shells| option to YES !!
  151.  
  152.  
  153. And thats it. The program is run once at LOGIN with the ON parameter and once at
  154. LOGOFF with the OFF parameter. If you want to use menus to run ImHere and you
  155. don't really understand how, then feel free to contact me.
  156.  
  157.  
  158.  
  159.  
  160. NOSHOW.CTL
  161. ──────────
  162.  
  163. Now you can also Optionally create an NoShow.CTL file. This file should contain
  164. ONE name per line of the users that are not shown at all. This is like setting
  165. the Hidden flag in RA for the user. If this file is found, then it will be used.
  166.  
  167. ** NoShow.CTL must be in the same Sub-Dir as the ImHere.exe.
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185. LANGUAGE FILES
  186. ────────────── 
  187.  
  188. ***   NOTE : This is only availiable when REGISTERED !! ***
  189.  
  190. Language files can also be created. Each language file you create should be
  191. named after the first 8 characters of the name of the language you have defined
  192. in RaConfig, NOT the name of the .RAL file !!. So if I have a language called 
  193. English I would call my Language file English.CTL.
  194. Create one of these files for each language you want to change from the default.
  195.  
  196.  
  197.  
  198. There are two lines in the Language file :
  199.  
  200. LogOn  =
  201. LogOff =
  202.  
  203. Define the text for the LogOn and LogOff. 
  204. These are the texts used in the On-Line messages sent to users about other
  205. users who are logging in and out of the system.
  206.  
  207. You can use to special definitions :
  208.  
  209. %NODE  will be replaced by the node that the user being announced is on.
  210.  
  211. %NAME  will be replaced by the name of the user being announced.
  212.  
  213. %LOCATION will be replaced by the location of the user being announced.
  214.  
  215.  
  216.  
  217. Example : 
  218.  
  219. Logon = %Name has just logged in on node %Node !
  220. LogOff = %Name has just logged off of node %Node !
  221.  
  222.  
  223. If the language files are not found or used then the default message is sent.
  224. This is the default messsage :
  225.  
  226. Logon = %NAME LOGGED IN on node %Node.
  227. LogOff = %NAME LOGGED OFF on node %Node.
  228.  
  229. You can use and modify the included examples.
  230.  
  231. ** Note that the Language .CTL file must be placed in the same sub-directory as
  232.    the ImHere.EXE file.
  233.  
  234.  
  235.  
  236. NOTES
  237. ─────
  238.  
  239. ■ If the user has Ansi enabled he will receive the message in ANSI unless he is 
  240.   in an external door, since I cannot gurantee the doors programs will translate
  241.   the ANSI sequence, but RA does. 
  242.  
  243. ■ Also when using the multi-language support, if the user changes langauges and
  244.   stays On-Line the messages will still be in the previous language. The change
  245.   does NOT take place until the user has logged off and logged on again.
  246.  
  247. ■ ImHere should work fine on most systems without the EXTRA *M parameter telling
  248.   RA to Swap. If you are having probs then try using *M in the command line.
  249.  
  250. How to reach me
  251. ───────────────
  252.  
  253. If you have questions you may reach me here:
  254.  
  255. Serge Sozonoff
  256. 29 Ch. Sur-le-Beau
  257. 1232 Confignon
  258. GE-Switzerland
  259.  
  260. BUG reports ideas etc .... can be sent here :
  261.  
  262. BBS & Mailer & Fax : (+41 22) 777 12 75
  263. BBS Line2          : (+41 22) 777 12 70
  264.  
  265. FIDO  2:301/329
  266. RANET 73:7410/329
  267.  
  268.  
  269. IMHERE is allways availiable as a FileRequest using the MagicName IMHERE
  270.  
  271.  
  272. Special Thanks To
  273. ─────────────────
  274.  
  275. Tom Nielsen and Gerard Saloukvadze and Sergio Creimer for there help, ideas and
  276. Beta testing.
  277.  
  278. David Clerc, The Geneva Team for some hints and help with some of the code.
  279.  
  280.  
  281. Credits
  282. ───────
  283.  
  284. Hans Siemons for his great (tm)RADU unit.
  285.  
  286. Support site BBS's
  287. ──────────────────
  288.  
  289. Switzerland
  290. ───────────
  291. Espace Info BBS
  292. SysOp : Gerard Saloukvadze
  293. (+41) 22 3423369
  294. Fido 2:301/326
  295.  
  296. Evening Light's BBS
  297. SysOp : Tom Nielsen
  298. (+41) 22 7885616
  299. Fido 2:301/324
  300.  
  301. Brazil
  302. ──────
  303. Horizontes BBS
  304. SysOp : Sergio Creimer
  305. (+55) 33 281 2925
  306. Fido 4:803/2
  307.  
  308.