home *** CD-ROM | disk | FTP | other *** search
/ The Best of the Best / _.img / 02172 / tele1.exe / HOST.EXE / HOST.DOC < prev    next >
Text File  |  1992-08-01  |  10KB  |  273 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                    ▌█▌     ▌█▌ ▌████████▌ ▌███████▌ ▌█████████
  15.                    ▌█▌     ▌█▌ ▌█▌    ▌█▌ ▌█▌           ▌█▌
  16.                    ▌█▌     ▌█▌ ▌█▌    ▌█▌ ▌█▌           ▌█▌
  17.                    ▌█▌█████▌█▌ ▌█▌    ▌█▌ ▌█▌▌████▌     ▌█▌
  18.                    ▌█▌     ▌█▌ ▌█▌    ▌█▌       ▌█▌     ▌█▌
  19.                    ▌█▌     ▌█▌ ▌█▌    ▌█▌       ▌█▌     ▌█▌
  20.                    ▌█▌     ▌█▌ ▌████████▌ ▌███████▌     ▌█▌
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                               By  Tsung Hu
  29.  
  30.  
  31.                            White River Software
  32.  
  33.  
  34.  
  35.  
  36.   Introduction
  37.   ──────────────────────────────────────────────────────────────────────────
  38.  
  39.       Telemate host mode is written with its script language and can be
  40.       modified freely with no royalty. In Telemate 3.00, there are many
  41.       useful commands, such as file and string handling, which make the
  42.       host script easier to be written.
  43.  
  44.       The following are the host-related files:
  45.  
  46.           HCONFIG.SCR  - Host configuration script
  47.           HCONFIG.TMS  - Compiled script, C>TMS HCONFIG
  48.           HOST.SCR     - Host mode script
  49.           HOST.TMS     - Compiled script, C>TMS HOST
  50.  
  51.           HCONFIG.HST  - Configuration file  (created after first run)
  52.           HUSER.HST    - User information   (created after first run)
  53.           HWELCOME.HST - Welcome message
  54.           HNOTICE.HST  - Notice or bulletin
  55.           HMENU.HST    - Main menu
  56.           HPROT.HST    - Protocol menu
  57.           BGOODBYE.HST - Goodbye message
  58.  
  59.           HSHELL.BAT   - [S]hell batch file  (created during configuration)
  60.           HLOCAL.BAT   - [R]un local program
  61.           HREMOTE.BAT  - [R]un remote program
  62.           HOST.DIR     - [F]ile directory file (run-time temporary file)
  63.  
  64.  
  65.   To Install The Host Mode
  66.   ──────────────────────────────────────────────────────────────────────────
  67.  
  68.       . Set the modem answer string to "~~~+++~~~AT S0=1^M" under the
  69.         Options/Communication dialog
  70.  
  71.       . Run the HCONFIG.SCR by passing [Alt S]. HCONFIG will ask you which
  72.         COM port you are using. If it is COM1 or COM2, it will generate
  73.         the HSHELL.BAT batch file with the following content,
  74.           CTTY COM1
  75.           COMMAND
  76.           CTTY CON
  77.           EXIT
  78.         supposed the modem is in COM1. This batch file allows you to shell
  79.         to DOS with the [S]hell command.
  80.  
  81.         Then it will display the menu
  82.  
  83.           A: New user level     : 1
  84.           B: Sysop level        : 2
  85.           C: Detect baud rate   : ON
  86.           D: Initial baud rate  : 2400
  87.           E: Yell time          : 3 seconds
  88.           F: Yell sound         : 1 seconds
  89.           G: Host directory     : \TM
  90.           H: Download directory : \TM
  91.           I: Upload directory   : \TM
  92.  
  93.           S: Save configuration and run host mode
  94.           Q: Abort configration
  95.  
  96.  
  97.  
  98.         Telemate's host is an open system, which mean new user can join
  99.         the system freely. Each of them have his own password. In current
  100.         implementatation, only two levels are used. Level 2 can use the
  101.         [S]hell,  [R]un remote program and [Z] shut down commands while
  102.         level 1 cannot.
  103.  
  104.         Some modems can lock the COM port at a certain baud rate. For
  105.         example, a 2400 baud MNP modem can lock at 4800 or 9600 baud with
  106.         the "AT &B1" command. For these modems, the <Detect baud rate>
  107.         option should be turned off.
  108.  
  109.         <Initial baud rate> should be the highest possible baud rate of your
  110.         modem.
  111.  
  112.         <Yell time> and <Yell sound> are the amount of time, in second, that
  113.         the alarm appears and yells when the [C]hat command is issued. To
  114.         disable the [C]hat command, you can set the <Yell time> to 0.
  115.  
  116.         <Host directory> is the directory containing all the H*.HST and
  117.         H*.BAT files, they  are the bulletin, the menu and the batch file
  118.         for shelling to DOS.
  119.  
  120.         <Download directory> is the host download directory. The [F]ile,
  121.         [T]ype and [D]ownload commands can only access files in this
  122.         directory.
  123.  
  124.         <Upload directory> is the host upload directory. All upload will
  125.         go to this directory.
  126.  
  127.         After setting up these parameters, you can press 'S' to save the
  128.         configuration and it will chain to the host script automatically.
  129.  
  130.       . However, installation is not completed yet. To make full use of the
  131.         host script, you should also modify the HSHELL.BAT, HLOCAL.BAT and
  132.         HREMOTE.BAT batch file.
  133.  
  134.         HSHELL.BAT will be executed when the [S]hell command is issued.
  135.         Although it is already created by the HCONFIG.SCR, the batch file
  136.         does not monitor carrier signal. That means the computer will hang
  137.         up when the remote user drop carrier. You should use a third-party
  138.         product such as WATCHDOG or DOORWAY for maximum security.
  139.         Note: In local mode, HOST will shell to DOS directly and will not
  140.         use this batch file.
  141.  
  142.         HREMOTE.BAT will be executed when the [R]un remote program command
  143.         is issued by a caller. This program can be a game or an BBS editor.
  144.  
  145.         HLOCAL.BAT is similar to HREMOTE.BAT but it is executed when the [R]
  146.         command is issued in local mode. You may use the same program but
  147.         different options or use a completely different program in this
  148.         batch file.
  149.  
  150.         Of course, you should customize your own welcome message and
  151.         bulletin. A warm welcome will make the user feel much better. If
  152.         you don't have any bulletin, you may delete the HNOTICE.HST.
  153.  
  154.  
  155.  
  156.   Running The Host Mode
  157.   ──────────────────────────────────────────────────────────────────────────
  158.  
  159.       To run the HOST.SCR, you could press [Alt S] while you are in
  160.       Telemate. Or type
  161.           C>TM HOST
  162.       while you are in DOS command line.
  163.  
  164.       When the host mode begin, you could press
  165.           'L'     for local mode
  166.           'C'     for configuration (run HCONFIG.SCR)
  167.           [Esc]   to terminate host
  168.           [Alt H] to temrinate the user (hang up the phone)
  169.  
  170.       When a call is encounter, the user will be asked for his name and
  171.       password. The name and password must be or longer than 4 characters.
  172.       After that, the user can choose a command from the menu.
  173.  
  174.       Most of the users should have experiences with different types of
  175.       BBSs. But they all have the commands
  176.  
  177.           [F]ile directory
  178.           [U]pload a file
  179.           [D]ownload a file
  180.           [T]ype a file
  181.           [C]hat with sysop
  182.           [X]pert mode
  183.           [G]oodbye
  184.  
  185.       The [F]ile command will shell to DOS and execute the DOS command
  186.           DIR >\HOST.DIR
  187.       which store the file list into a file. Then HOST.SCR will display
  188.       the file. So don't worry when it shell to DOS, it is just a [F]ile
  189.       command.
  190.  
  191.       When the user issues the [C]hat command, the alarm will be pop-up.
  192.       Sysop should press
  193.           [Enter] to accept
  194.           [Esc] to deny
  195.       If [Enter] is pressed, HOST.SCR will begin a chat mode. The sysop
  196.       should press [Esc] to terminate the chat mode.
  197.  
  198.       There are three commands provided for sysop. They are
  199.  
  200.           [S]hell to DOS
  201.           [R]un remote program
  202.           [Z] shut down
  203.  
  204.       The [S]hell command will jump to DOS directly in local mode; and run
  205.       the HSHELL.BAT to shell to DOS if it is a remote call.
  206.  
  207.       The [R]un command will run HLOCAL.BAT in local mode; and run
  208.       HREMOTE.BAT in remote mode.
  209.  
  210.       The [Z] shut down command should be issued only if you don't need the
  211.       host mode any more. It will ask you 'Are you sure ?'. If you said
  212.       'Y'es, the call will be disconnected and will not answer any more
  213.       callers.
  214.  
  215.  
  216.  
  217.   Format Of The User File   (HUSER.HST)
  218.   ──────────────────────────────────────────────────────────────────────────
  219.  
  220.       When a new user is encountered, his name, password and access level
  221.       are stored in the file HUSER.HST. The format is
  222.  
  223.       first last;password#<level>
  224.  
  225.       where <level> is 1 or 2. For example, my record will look like
  226.  
  227.       first last;mypass#1
  228.  
  229.       To raise a user's access level, you can use an editor to change the 1
  230.       to 2. After that, the record will look like
  231.  
  232.       Tsung Hu;mypass#2
  233.  
  234.       There may be several records in the file, they all have the same
  235.       format.
  236.  
  237.  
  238.   Further Improvement
  239.   ──────────────────────────────────────────────────────────────────────────
  240.  
  241.       There are a lot of space for improvements. Here are a few
  242.       suggestions:
  243.  
  244.       . More access levels and different menu for different level.
  245.  
  246.       . Usage log: If you would like to keep track of a user's activities,
  247.         you could add
  248.           USAGE "User attempts to shell to DOS"
  249.         etc.
  250.  
  251.       . Inactive timeout: This can be done by
  252.           IF NOT LOCAL
  253.              WHENIDLE 600,"^*"
  254.           ENDIF
  255.         which send the modem hangup string if there is no activity through
  256.         the COM port in 10 minutes.
  257.  
  258.       . Time limit: You may calcuate the connect time using the procedure
  259.         DIFFTIME in toolbox #3.
  260.  
  261.       . ANSI graphics or full screen command: Toolbox #1 is a good start
  262.         for this attempt.
  263.  
  264.       If you need any assistance, you can contact Winfred Hu at the
  265.       Telemate support BBS's or the following network:
  266.  
  267.           SmartNet    Telemate conference
  268.           RelayNet    Telemate conference
  269.           FidoEcho    National Telemate Echo
  270.           CompuServe  [72070,3515]
  271.           InterNet    72070.3515@compuserve.com
  272.  
  273.