home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / next230.zip / NEXT.TXT < prev   
Text File  |  1993-02-12  |  7KB  |  169 lines
  1.                          ======== ======   =======
  2.                             ==    ==   ==     ===
  3.                             ==    ==   ===   ===
  4.                             ==    ==   ==   ===
  5.                             ==    ======   =======
  6.  
  7.                    =======================================
  8.                    The DeAdZoNe Utilities for RemoteAccess
  9.                    =======================================
  10.  
  11.                                       NeXt
  12.                        Sysop Next Utility for RemoteAccess
  13.                          Version 2.30   January 8, 1993
  14.                        (C) Copyright Victor Magdic 1991-93
  15.                                All Rights Reserved
  16.  
  17. Description
  18. -----------
  19. NeXt is a utility for RemoteAccess which allows you to toggle the status of the
  20. "sysop next" flag even though the user is outside of the BBS (i.e. he/she is
  21. running a door or some other external program).
  22.  
  23. NeXt works by toggling the sysop next flag in the user's EXITINFO.BBS (which is
  24. generated whenever RA calls a door). When the user returns from the door, RA
  25. reads in the EXITINFO.BBS and sets the internal "sysop next" flag to whatever
  26. the setting in EXITINFO.BBS is.
  27.  
  28. NeXt is written for RA 1.10/1.11. It is not gauranteed to work with future
  29. versions.
  30.  
  31.    Note: In order for RA's "sysop next" feature to work, you need to have a
  32.          registered version of RemoteAccess. NeXt will toggle the flag even if
  33.          your version of RA is unregistered, however; RA will just ignore it.
  34.  
  35.  
  36. How much does it cost?
  37. ----------------------
  38. This utility is FREE!  If you like it you can continue to use it for as long as
  39. you like free of charge!
  40.  
  41. If you do decide to use it, I would be excited to hear from you !! I encourage
  42. you to send me a postcard at the address listed below (see the end of this text
  43. file), or a message via netmail. It will cost you practically nothing, and will
  44. let me know you're enjoying the program. It will also give me incentive to keep
  45. improving the program and make it even better!
  46.  
  47. Or course donations are graciously accepted <grin>. See the address listed at
  48. the end of this document if you want to send a donation.
  49.  
  50.  
  51. How to Use NeXt
  52. ---------------
  53. NeXt can be used in two different ways, depending on whether you are running
  54. your sytem under a multitasker or not. Both methods are explained below.
  55.  
  56. NeXt looks in the current directory for EXITINFO.BBS. So you can easily use NeXt
  57. on a multinode system by putting NEXT.EXE somewhere in your path and executing
  58. it from the appropriate Node directory.
  59.  
  60.    Note: NeXt simply *toggles* the status of the sysop next flag. In other
  61.          words, if the sysop next flag is OFF when you run NeXt, it will be
  62.          turned ON, and vice versa.
  63.  
  64.  
  65. Using NeXt without a Multitasker
  66. --------------------------------
  67. Using NeXt without a multitasker is quite simple, and just requires a little
  68. preparation. If you want to toggle the sysop-next flag while a user is in a
  69. door, simply turn ON Scroll-Lock. When the user exits the door, NeXt will check
  70. to see if the Scroll-Lock is ON, and if it is, then the sysop-next flag will be
  71. toggled. If Scroll-Lock is OFF when NeXt is executed, then the status of the
  72. sysop-next flag will not be changed.
  73.  
  74. In order for NeXt to do its job it must be called sometime between when a door
  75. is exited, and before RA reloads. So if you were running a type 7 exit for
  76. TW2002, you would call NeXt as follows:
  77.  
  78.            REM batch file for TW2002 -game one
  79.            @echo off
  80.            cd \ra\doors\tw2002
  81.            tw2002 -qbbs
  82.            cd \ra
  83.            next
  84.  
  85. Notice how the door (tw2002) is run first, and after the user quits the door
  86. control passes back to the batch file, at which point NeXt is executed. If you
  87. are using a type 15 exit, the idea is the same.
  88.  
  89.    Remember: When NeXt is called in this manner, it will check to see if the
  90.               SCROLL-LOCK is ON. If it is ON, then the sysop-next flag will be
  91.               toggled. If the SCROLL-LOCK is OFF when NeXt is called, then the
  92.               sysop next flag will not be changed.
  93.  
  94.    Note: After NeXt toggles the sysop-next flag, it will automatically turn
  95.          Scroll-Lock OFF. This is necessary, because otherwise if the user went
  96.          into another door then the sysop-next flag would be toggled again, and
  97.          you would be right back where you started!
  98.  
  99.  
  100. Using NeXt with a Multitasker
  101. -----------------------------
  102. Using NeXt with a multitasker is very simple. Essentially what you do is open
  103. another window (while the user is online and in a door), and run NEXT.EXE with
  104. the /M command line switch, then just close the window. You can setup up your
  105. window to automate the whole process. NeXt requires approximately 22k to run, so
  106. the window does not have to be large.
  107.  
  108.          For Multitasker use:  NEXT /M
  109.  
  110.    Note: When using NeXt with the /M switch, the status of the Scroll-Lock is
  111.          ignored. So it does not matter whether it is on or off.
  112.  
  113.  
  114. Writing a Semaphore File
  115. ------------------------
  116. If you run NeXt with the /S switch, it will write a file called NEXT.NOW in the
  117. main RA directory (as pointed to by the RA environment variable).  You can check
  118. for this in your batch file and act on it accordingly.
  119.  
  120.        
  121. Legal Stuff and Disclaimer
  122. --------------------------
  123. "NeXt" refers to the executables and documentation in the original distribution
  124. archive. NeXt is copyrighted material by the author, Victor Magdic. All rights
  125. are reserved.  The author grants you a licence to use this software free of
  126. charge.
  127.  
  128. The program is provided "as is", without warranty or guarantee of any kind,
  129. either expressed or implied, as to its quality or performance. The author will
  130. not be held liable to you or anyone for any direct, indirect, incidental or
  131. consequential damages, including but not limited to any lost profits, or lost
  132. savings which may result from the use or inability to use this program.
  133.  
  134. The author is in no way obligated to provide future versions of this software.
  135.  
  136. Your use of the program constitutes your agreement to these terms and to this
  137. disclaimer.
  138.  
  139. All mentioned products are copyrighted by and trademarks of their respective
  140. holders.
  141.  
  142.  
  143. Updates
  144. -------
  145. Please see the enclosed file DEADZONE.TXT for information on how to obtain the
  146. latest version of NeXt.
  147.  
  148.        
  149. Suggestions always welcome!
  150. ---------------------------
  151. If you have any suggestions for improvement or wish to  report any bugs, you can
  152. reach me via netmail:
  153.        
  154.        The DeAdZoNe
  155.        Victor Magdic
  156.        FidoNet: 1:259/427
  157.        TeleNet Canada: 20:22/104
  158.        
  159.        or by writing to:
  160.        
  161.        Victor Magdic
  162.        424 Camden Circle
  163.        Mississauga, Ontario
  164.        L4Z 2P4
  165.        CANADA
  166.        
  167. ------------------------------------------------------------------ end
  168.  
  169.