home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / comm / tm412_3.zip / HOST.EXE / HOST.DOC < prev    next >
Text File  |  1993-07-20  |  10KB  |  282 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.           J: Close system       : OFF
  93.  
  94.           S: Save configuration and run host mode
  95.           Q: Abort configration
  96.  
  97.  
  98.  
  99.         Telemate's host uses two user levels. Level 2 (the sysop level)
  100.         can use the [S]hell, [R]un remote program and [Z] shut down
  101.         commands while level 1 cannot.
  102.  
  103.         As an open system, new user can join the system freely. Each of
  104.         them have his own password. If the <Close system> option is
  105.         turned on, new user is not allowed until the sysop adds his name
  106.         and password to the user file. (See Format Of The User File.)
  107.  
  108.         Some modems can lock the COM port at a certain baud rate. For
  109.         example, a 2400 baud MNP modem can lock at 4800 or 9600 baud with
  110.         the "AT &B1" command. For these modems, the <Detect baud rate>
  111.         option should be turned off.
  112.  
  113.         <Initial baud rate> should be the highest possible baud rate of your
  114.         modem.
  115.  
  116.         <Yell time> and <Yell sound> are the amount of time, in second, that
  117.         the alarm appears and yells when the [C]hat command is issued. To
  118.         disable the [C]hat command, you can set the <Yell time> to 0.
  119.  
  120.         <Host directory> is the directory containing all the H*.HST and
  121.         H*.BAT files, they  are the bulletin, the menu and the batch file
  122.         for shelling to DOS.
  123.  
  124.         <Download directory> is the host download directory. The [F]ile,
  125.         [T]ype and [D]ownload commands can only access files in this
  126.         directory. If multiple directories are specified, only the first
  127.         directory will be used.
  128.  
  129.         <Upload directory> is the host upload directory. All upload will
  130.         go to this directory.
  131.  
  132.         After setting up these parameters, you can press 'S' to save the
  133.         configuration and it will chain to the host script automatically.
  134.  
  135.       . However, installation is not completed yet. To make full use of the
  136.         host script, you should also modify the HSHELL.BAT, HLOCAL.BAT and
  137.         HREMOTE.BAT batch file.
  138.  
  139.         HSHELL.BAT will be executed when the [S]hell command is issued.
  140.         Although it is already created by the HCONFIG.SCR, the batch file
  141.         does not monitor carrier signal. That means the computer will hang
  142.         up when the remote user drop carrier. You should use a third-party
  143.         product such as WATCHDOG or DOORWAY for maximum security.
  144.         Note: In local mode, HOST will shell to DOS directly and will not
  145.         use this batch file.
  146.  
  147.         HREMOTE.BAT will be executed when the [R]un remote program command
  148.         is issued by a caller. This program can be a game or an BBS editor.
  149.  
  150.         HLOCAL.BAT is similar to HREMOTE.BAT but it is executed when the [R]
  151.         command is issued in local mode. You may use the same program but
  152.         different options or use a completely different program in this
  153.         batch file.
  154.  
  155.         Of course, you should customize your own welcome message and
  156.         bulletin. A warm welcome will make the user feel much better. If
  157.         you don't have any bulletin, you may delete the HNOTICE.HST.
  158.  
  159.  
  160.  
  161.   Running The Host Mode
  162.   ──────────────────────────────────────────────────────────────────────────
  163.  
  164.       To run the HOST.SCR, you could press [Alt S] while you are in
  165.       Telemate. Or type
  166.           C>TM HOST
  167.       while you are in DOS command line.
  168.  
  169.       When the host mode begin, you could press
  170.           'L'     for local mode
  171.           'C'     for configuration (run HCONFIG.SCR)
  172.           [Esc]   to terminate host
  173.           [Alt H] to temrinate the user (hang up the phone)
  174.  
  175.       When a call is encounter, the user will be asked for his name and
  176.       password. The name and password must be or longer than 4 characters.
  177.       After that, the user can choose a command from the menu.
  178.  
  179.       Most of the users should have experiences with different types of
  180.       BBSs. But they all have the commands
  181.  
  182.           [F]ile directory
  183.           [U]pload a file
  184.           [D]ownload a file
  185.           [T]ype a file
  186.           [C]hat with sysop
  187.           [X]pert mode
  188.           [G]oodbye
  189.  
  190.       The [F]ile command will shell to DOS and execute the DOS command
  191.           DIR >\HOST.DIR
  192.       which store the file list into a file. Then HOST.SCR will display
  193.       the file. So don't worry when it shell to DOS, it is just a [F]ile
  194.       command.
  195.  
  196.       When the user issues the [C]hat command, the alarm will be pop-up.
  197.       Sysop should press
  198.           [Enter] to accept
  199.           [Esc] to deny
  200.       If [Enter] is pressed, HOST.SCR will begin a chat mode. The sysop
  201.       should press [Esc] to terminate the chat mode.
  202.  
  203.       There are three commands provided for sysop. They are
  204.  
  205.           [S]hell to DOS
  206.           [R]un remote program
  207.           [Z] shut down
  208.  
  209.       The [S]hell command will jump to DOS directly in local mode; and run
  210.       the HSHELL.BAT to shell to DOS if it is a remote call.
  211.  
  212.       The [R]un command will run HLOCAL.BAT in local mode; and run
  213.       HREMOTE.BAT in remote mode.
  214.  
  215.       The [Z] shut down command should be issued only if you don't need the
  216.       host mode any more. It will ask you 'Are you sure ?'. If you said
  217.       'Y'es, the call will be disconnected and will not answer any more
  218.       callers.
  219.  
  220.  
  221.  
  222.   Format Of The User File   (HUSER.HST)
  223.   ──────────────────────────────────────────────────────────────────────────
  224.  
  225.       A user's name, password and access level are stored in the file
  226.       HUSER.HST. The format is
  227.  
  228.           first last;password#<level>
  229.  
  230.       where <level> is 1 or 2. For example, my record will look like
  231.  
  232.           first last;mypass#1
  233.  
  234.       To raise a user's access level, you can use a text editor to
  235.       change the 1 to 2. After that, the record will look like
  236.  
  237.           first last;mypass#2
  238.  
  239.       There may be several records in the file, they all have the same
  240.       format.
  241.  
  242.       If the <Close system> option is turned on, the sysop must add the
  243.       user's name and password manually.
  244.  
  245.  
  246.   Further Improvement
  247.   ──────────────────────────────────────────────────────────────────────────
  248.  
  249.       There are a lot of space for improvements. Here are a few
  250.       suggestions:
  251.  
  252.       . More access levels and different menu for different level.
  253.  
  254.       . Usage log: If you would like to keep track of a user's activities,
  255.         you could add
  256.           USAGE "Host: User attempts to shell to DOS"
  257.         etc.
  258.  
  259.       . Inactive timeout: This can be done by
  260.           IF NOT LOCAL
  261.              WHENIDLE 600,"^*"
  262.           ENDIF
  263.         which send the modem hangup string if there is no activity through
  264.         the COM port in 10 minutes.
  265.  
  266.       . Time limit: You may calcuate the connect time using the procedure
  267.         DIFFTIME in toolbox #3.
  268.  
  269.       . ANSI graphics or full screen command: Toolbox #1 is a good start
  270.         for this attempt.
  271.  
  272.       If you need any assistance, you can contact Winfred Hu at the
  273.       Telemate support BBS's or the following network:
  274.  
  275.           SmartNet    Telemate conference
  276.           RelayNet    Telemate conference
  277.           FidoEcho    National Telemate Echo
  278.           CompuServe  [72070,3515]
  279.           InterNet    72070.3515@compuserve.com
  280.  
  281.  
  282.