home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 26 / CD_ASCQ_26_1295.iso / vrac / sysop130.zip / SYSOPIS.DOC < prev    next >
Text File  |  1995-10-10  |  10KB  |  247 lines
  1.                         SYSOPIS v1.30 (Baja version)
  2.  
  3.                        Copyright 1995, Jeremy Bellwood
  4.                            AKA The Witch Docter
  5.                          SysOp of The Witch's Coven
  6.                       +81-6117-36-5233 (Outside Okinawa)
  7.                        636-5233 (From an Okinawan base)
  8.  
  9. I have tried to make this program simple to setup and use.  Although you
  10. never know, so I will take you through step-by-step.  SYSOPIS comes with 6
  11. files:
  12.         SYSOPIS.EXE - The main program (ran as a logoff event)
  13.                         this is for the random cycling of the strings
  14.  
  15.         SYSOPIS.BIN - This is the baja module to actully switch the text
  16.                                            
  17.         SYSOPIS.CFG - The configuration file with the location 
  18.                         of EXEC directory, SYSHOME.DAT and 
  19.                         SYSGONE.DAT
  20.  
  21.         SYSHOME.DAT - The data file containing the strings you
  22.                         want rotated thru when you are available
  23.  
  24.         SYSGONE.DAT - The data file containing the strings you 
  25.                         want rotated through when you are not
  26.                         available
  27.  
  28.         SYSOPIS.DOC - This file
  29.  
  30.  
  31. INSTALATION
  32. ~~~~~~~~~~~
  33.  1. BACK UP the LOGON.SRC and LOGON.BIN files.  You will be asked to add a
  34.     line then compile the LOGON module.  I will not and can not be held
  35.     responsible if you screw up and something happens.  I should not have to
  36.     say this, but if you continue without creating a back up then you probably
  37.     should not run a BBS and run the risk of screwing something up.  Besides,
  38.     when was the last time you made a backup of your ENTIRE BBS?
  39.  
  40.  2. Read this document in entirety.  Do not start to install this until you
  41.     feel comfortable with the steps needed to be done.  Once again, I will
  42.     not be responsible if you screw up a step and some unpredictable event
  43.     occurs.  This program works fine on my BBS and I installed it EXACTLY as
  44.     this documentiaion explains.
  45.  
  46.  2. Make a directory on your HD to place these files.  Since my BBS is on D:
  47.     my examples will include D: instead of C: or whatever.  In this example
  48.     I am asuming that SYSOP130.ZIP was unziped into D:\TEMP and that you know
  49.     a little bit about DOS.
  50.  
  51.     D:\> cd sbbs\xtrn
  52.     D:\SBBS\XTRN> md sysopis
  53.     D:\SBBS\XTRN> cd sysopis
  54.     D:\SBBS\XTRN\SYSOPIS> copy \temp\sys*.*
  55.  
  56.  3. Edit SYSGONE.DAT to contain the messages you want displayed when the SysOp
  57.     is unavailable.  Be sure to include quotes around the string.  Now go into 
  58.     your favorite text editor and edit SYSGONE.DAT.  Here are some examples of 
  59.     what it should look like:
  60.  
  61.     "Not avalible"
  62.     "No where to be found"
  63.     "At school"
  64.     "Asleep"
  65.  
  66.     Be careful not to exceed 60 characters.  If you have a string longer than
  67.     the acceptable length, it will automatically truncate the line.
  68.  
  69.  4. Edit SYSHOME.DAT to contain the messages you want displayed when the SysOp
  70.     is available.  Be sure to include the quotes around the string.  Now edit
  71.     SYSHOME.DAT.  Here are some examples of what it should look like:
  72.  
  73.     "Watching your every keystroke"
  74.     "Around here somewhere"
  75.     "Within ear shot"
  76.     "In the next room"
  77.  
  78.     Be careful not to exceed your 60 character limit.  If your string is longer
  79.     than the acceptable length, it would wrap around the screen, therefore the
  80.     line will be truncated if it is too long.
  81.  
  82.  5. Now save SYSGONE.DAT and SYSHOME.DAT.  Load SYSOPIS.CFG.  This is where 
  83.     you tell SYSOPIS where your EXEC directory, SYSHOME.DAT, and SYSGONE.DAT
  84.     files are as well as the number of strings to choose from in each file.
  85.     This is what my SYSOPIS.CFG looks like:
  86.  
  87.     D:\SBBS\EXEC\
  88.     D:\SBBS\XTRN\SYSOPIS\SYSHOME.DAT
  89.     4
  90.     D:\SBBS\XTRN\SYSOPIS\SYSGONE.DAT
  91.     4
  92.  
  93.     NOTICE: SYSHOME.DAT and SYSGONE.DAT can have a different number of lines.
  94.             For my example however, both file happen to have 4 lines each.
  95.             Also, the first line must have the \ at the end.
  96.  
  97.  6. Save SYSOPIS.CFG and exit your editor.  Now you are ready to load SCFG
  98.     and set it up as log-off event.
  99.  
  100.     D:\SBBS\XTRN\SYSOPIS> cd\sbbs\node1
  101.     D:\SBBS\NODE1> scfg
  102.  
  103.  7. Go to External Programs -> Fixed Events -> Logoff Event.  I suggest makeing
  104.     a batch file for all my logoff events then add to the .BAT file as you
  105.     add more events.  I will use a batch file for this example since you may
  106.     want to add have more than one logoff event.  Anyways, type:
  107.  
  108.     %!logoff.bat %#
  109.  
  110.  8. Exit the configuration program and change directories into \SBBS\EXEC and
  111.     create a file called LOGOFF.BAT if one doesn't exist already.
  112.  
  113.     D:\SBBS\NODE1> cd..\exec
  114.     D:\SBBS\EXEC> edit logoff.bat
  115.  
  116.  9. LOGOFF.BAT should include all the commands you want to happen when a user
  117.     logs off of your BBS.  Mine looks like:
  118.  
  119.     @echo off
  120.  
  121.     REM *** Other Logoff Events can go here ***
  122.  
  123.     cd\sbbs\xtrn\sysopis
  124.     sysopis %1
  125.  
  126. 10. Save LOGOFF.BAT and copy SYSOPIS.BIN to your EXEC directory.
  127.  
  128.     D:\SBBS\EXEC> copy \sbbs\xtrn\sysopis\sysopis.bin
  129.  
  130. 11. Add SYSOPIS to your LOGON module.  I suggest putting it toward the end of
  131.     LOGON.SRC.  Here is where I put it:
  132.  
  133. --------------------------Start of section of LOGON.SRC----------------------
  134. # Auto-message
  135. setstr "%jMSGS\\AUTO.MSG"
  136. get_file_length i str
  137. compare i 0 
  138. if_greater
  139.         printfile str P_NOATCODES
  140.         crlf
  141.         end_if
  142.  
  143. exec_bin sysopis            # Added for SYSOPIS v 1.30
  144.  
  145. # Automatically set shell to WIPSHELL
  146. compare_user_misc UM_WIP
  147. if_true
  148.         setstr "WIPSHELL"
  149.         set_shell
  150.         end_if
  151. -----------------------------End of LOGON.SRC--------------------------------
  152.  
  153. 12. Save LOGON.SRC and compile new LOGON module
  154.  
  155.     D:\SBBS\EXEC> baja logon
  156.  
  157. 13. Load SBBS and log on locally a couple times to verify that it works.
  158.  
  159. 14. Send me a postcard or letter telling me you are using SYSOPIS.  I am in the
  160.     U.S. Marine Corps currently stationed in Okinawa, Japan.  Mail is
  161.     important since we are kinda "cut-off" from the real world.  Send mail to:
  162.     
  163.          Cpl Bellwood, J. C.  570399071
  164.          1st Stinger Btry, Unit 37232
  165.          FPO-AP 96603-7232
  166.  
  167.     I will be here until at least March '96
  168.  
  169. This software is released as FreeWare.  I only ask that you send a letter or
  170. postcard letting me know you are using it.  I have a couple other programs on
  171. the drawing board that I may or may not release depending on how much support
  172. I get.
  173.  
  174. *** DISCLAIMER ***
  175. I, Jeremy Bellwood, will not be held responsible if your BBS crashes, you
  176. lose users, your computer dies completely, or if your cat takes a shit in
  177. your grandmothers handbag.  SYSOPIS works fine on my BBS and I have not had
  178. a problem yet.  This program carries no warranty implied or expressed.  I will
  179. try to help if you screw up on instalation, but if there is nothing I can do,
  180. you should have a back up of your original LOGON.SRC and LOGON.BIN or better
  181. yet, your entire BBS somewhere.
  182.  
  183. HISTORY
  184. ~~~~~~~
  185.  9/13/93 - Started programming SYSOPIS (In PASCAL)
  186.  
  187.  9/14/93 - Added the UNREGISTERED notice, pause, and the auto-truncate
  188.  
  189.  9/14/93 - SYSOPIS released into SHAREWARE.  No known bugs, Works fine on
  190.            The Witch's Coven
  191.  
  192. 10/ 3/93 - Added the support for "Available" status  ***
  193.  
  194. 10/11/93 - Refined support for "Available" status
  195.  
  196. 10/11/93 - Run NODE utility internally (allows users to be auto-deleted)
  197.  
  198. 12/10/93 - Converted SYSOPIS from PASCAL to C
  199.  
  200. 12/13/93 - Bug found - SYSOPIS was not stripping the line description for
  201.            all the lines. 
  202.  
  203. 12/15/93 - Fixed problems with stock TEXT.DAT, it wasn't stripping the
  204.            description from the line.  Problem fixed
  205.  
  206. 12/16/93 - Worked on improving the random function
  207.  
  208. 12/18/93 - SYSOPIS v1.20 ready for release.  No known bugs, Works fine on
  209.            The Witch's Coven
  210.  
  211.  4/15/95 - Made modifications to work with TEXT.DAT for SBBS 2.11a
  212.  
  213.  5/10/95 - Updated .DOC file and registered version released as FreeWare
  214.  
  215.  9/30/95 - Started learning the Baja language.  Created a test module to work
  216.            as a glass box to play with string manipulations.
  217.  
  218. 10/10/95 - Updated the SYSOPIS v1.21 .EXE program to work with the Baja
  219.            module.
  220.          
  221. 10/10/95 - Updated the Baja module to change text and improve speed
  222.  
  223. 10/10/95 - SYSOPIS v1.30 (Baja version) is released to the public.
  224.  
  225. FUTURE PLANS
  226. ~~~~~~~~~~~~
  227.        None currently
  228.  
  229.  
  230. If you have a comment or suggestion about this program, I can be reached
  231. through DOVE-Net's Synchronet SysOp's Sub, on my BBS +81-6117-36-5233
  232. (Outside Okinawa) or 636-5233 (From an Okinawan military base), or by mail to
  233. the address above.
  234.  
  235. I originally released SYSOPIS since several SysOp's have asked Digital Man how
  236. he changed his "Not Available" to something else after each caller logs off.
  237. Over the years there have been several "clones" running around.  I have not
  238. tested any of them so I can not comment on their reliabaility, strength's or
  239. weakness's.  What I do know is with the advances of Baja it has become much
  240. easier for people to customize things on their own without needing to wait for
  241. someone to "find the time" to release a modification.
  242.  
  243. This may be my LAST release of SYSOPIS since I don't have much time to support
  244. the further (future) development.  Besides there are many other programs
  245. available to do the same as this program.
  246.  
  247.