home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / b / batdoor.zip / GETKEY_R.ZIP / GETKEY_R.DOC < prev    next >
Text File  |  1986-12-07  |  2KB  |  64 lines
  1.                            Documentation for
  2.                               GETKEY_R.COM
  3.  
  4. BACKGROUND
  5.  
  6.    Many more BBS systems are implementing the "DOORS" concept. What this
  7. means is that the user slips out of the BBS and into another application
  8. while still in remote mode. There are two ways of doing this. One way is
  9. to use the "CTTY" command. This can be a security problem, in that the
  10. local control is lost, and a user who breaks out of a program can literally
  11. wipe out your system.
  12.  
  13.    A second method is to have all remote users exit into a program or
  14. system of programs that output to COMx: and the local CRT as well as read
  15. input from COMx: and the local keyboard. This way there is no danger in
  16. losing valuable information.
  17.  
  18.    GETKEY_R is one such program. It allows the SysOp to create a Batch file
  19. system for remote users. GETKEY_R will wait for a key to be pressed, either
  20. remotely or locally. Then it will return the ASCII code the the key pressed
  21. in the ERRORLEVEL for a .BAT file compare. It will only allow the keys
  22. 1-9, and A-Z to be pressed. Upper case translation is done automatically,
  23. so you do not have to check for "a" as well as "A".
  24.  
  25.    You can also limit the keys allowed to be pressed by placing these in
  26. the command line.
  27.  
  28.    Example:
  29.         To await a "Y" or "N" response, you could have:
  30.  
  31.      ECHO OFF
  32.      WATCHDG1 ON
  33.      ECHO_R You are about to meet RACTER
  34.      ECHO_R
  35.      ECHO_R Do you want to continue [Y] or [N]?
  36.      GETKEY_R YN
  37.      IF ERRORLEVEL 89 GOTO RACTER
  38.      IF ERRORLEVEL 78 GOTO EXIT
  39.      :RACTER
  40.      RACTER
  41.      WATCHDG1 OFF
  42.      ECHO_R Returning to The BBS of Excellence
  43.      :EXIT
  44.      BOARD
  45.  
  46.  
  47.    The constants for COM1: can be modified easily. For this reason, I
  48. have provided the source code. For COM2:, use GETKEYR2.COM.
  49.  
  50. Important!!!
  51.  
  52.    This program make two assumptions:
  53.  
  54.                 1. That the COMx: serial board is installed
  55.                 2. That the Modem is functioning
  56.  
  57.    $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
  58.    $                                                         $
  59.    $   This program was writen by Leo Langevin, SysOp of:    $
  60.    $                                                         $
  61.    $    The BBS of Excellence - Data: (312) 398-2872         $
  62.    $                                                         $
  63.    $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
  64.