home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / MODEMS / OFFHOOK.ZIP / OFFHOOK.DOC next >
Encoding:
Text File  |  1988-07-22  |  5.5 KB  |  105 lines
  1.  
  2.  
  3.                                    OFFHOOK
  4.                              Written by Mike Woltz
  5.                              Buffalo Creek Software       
  6.           
  7.           OFFHOOK is a complimentary SPITFIRE BULLETIN BOARD SYSTEM
  8.        utility designed to set the modem off hook to simulate a busy
  9.        phone line.  The purpose for this is to allow the Sysop to exit
  10.        SPITFIRE and execute commands from the DOS prompt, during which
  11.        time the modem will generate a busy signal to users attempting 
  12.        to call the BBS.
  13.        
  14.           At the C:> prompt, type "OFFHOOK" to execute the program.
  15.        The program title, "OFF HOOK" (at the top of the Buffalo Creek
  16.        Software logo) will appear in the upper left hand corner of your
  17.        screen.  The program will then display the message, "Would you
  18.        like to set modem off hook? [y/N]"  If you respond with a N (for
  19.        No) the program is terminated.  The default response to this
  20.        prompt is No and pressing return here will also halt the program's
  21.        execution. If you respond with a Y (for Yes) the program will
  22.        then ask, "Which serial port? [1..4]".  Enter the corresponding
  23.        comm port your modem utilizes.  For instance, if your modem uses
  24.        comm port 2, enter 2.
  25.        
  26.           The first time you execute the program, OFFHOOK will display
  27.        the following messages:
  28.        
  29.        OFFHOOK.DAT not found!
  30.        Creating OFFHOOK.DAT!
  31.        
  32.        During the process of creating the OFFHOOK.DAT file, a beeping 
  33.        is transmitted through your computer speaker to notify you that
  34.        the program is working.  OFFHOOK.DAT is a text file which contains 
  35.        a series of modem commands. OFFHOOK.EXE reads each line in OFFHOOK.DAT
  36.        and sends them to the modem.  OFFHOOK pauses 1 second after each line.
  37.        OFFHOOK.DAT can be modified using your favorite text editor to include
  38.        any valid modem commands you wish to relay to the modem.
  39.        
  40.           As OFFHOOK continues its initialization process, the message
  41.        "Setting modem off hook!" appears on the screen and a beeping is
  42.        transmitted to indicate the program is actively setting the
  43.        modem.  When completed, "Finished!" is displayed to the screen
  44.        and you are returned to the DOS prompt.  You may now enter any
  45.        valid DOS command without concern about callers trying to log
  46.        onto the BBS.  When you have finished performing the DOS
  47.        commands, rebooting SPITFIRE will return the modem back on line.
  48.        
  49.           OFFHOOK can also be placed in your SF.BAT file (which is
  50.        included in your SPITFIRE package) so that OFFHOOK will automatically
  51.        be executed each time you exit SPITFIRE.  To do this, use your favorite
  52.        text editor to edit SF.BAT, type "OFFHOOK" after the :END command at 
  53.        the bottom of the SF.BAT file.
  54.        
  55.           You will notice that upon executing OFFHOOK if you do not respond
  56.        to the "Would you like to set modem off hook? [Y/n]" prompt
  57.        within 15 seconds, the following message is displayed:
  58.        
  59.        Timed out!
  60.        Did not take modem off hook!
  61.        
  62.  
  63.  
  64.  
  65.                                                                        Page 2
  66.                                                                        
  67.        This terminates the program and returns you to the DOS prompt.
  68.        The purpose for this is so that if SPITFIRE would accidently be
  69.        exited, and OFFHOOK was included at the end of the SF.BAT file,
  70.        your system is not hung up waiting for a response to the message
  71.        prompt.
  72.        
  73.           OFFHOOK has two switches (command line parameters) available 
  74.        which may be used individually or combined together.  These 
  75.        are:
  76.        
  77.           /Y         -  Attaching this switch at the end of the command
  78.                         allows for an automatic response to the "Would you
  79.                         like to set modem off hook? [Y/n]" prompt.  By using
  80.                         /Y this prompt is not displayed when executing OFFHOOK.
  81.                    
  82.           /C[1..4]    - By including a /C and the number corresponding
  83.                         to the comm port your modem utilizes you will
  84.                         not receive the "Which serial port? [1..4]" prompt.
  85.                         For instance, if your modem uses comm port 2,
  86.                         you would enter /C2. 
  87.        
  88.           /y /c[1..4] - In the event you should only use the /Y switch, then
  89.                         OFFHOOK defaults to comm 1.  If you are planning to
  90.                         use the switches and you are using a comm port other
  91.                         than 1, then /C[2..4] must be included in the 
  92.                         command.  For instance, if you are using comm port
  93.                         2, you would need to enter OFFHOOK /Y /C2.  The
  94.                         combination of the previous switches will provide
  95.                         an automatic response to both of above-mentioned
  96.                         prompts and allow OFFHOOK to be executed immediately
  97.                         with no other input required. 
  98.  
  99.  
  100.           OFFHOOK is place in the public domain and Mike Woltz and Buffalo 
  101.        Creek Software shall not be held responsible for any damage incurred by
  102.        the user to hardware, software, or peripheral devices while running
  103.        OFFHOOK.  All responsibility lies with the user of the software.
  104.  
  105.