home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SH11.ZIP / SH.DOC < prev    next >
Encoding:
Text File  |  1991-12-20  |  10.9 KB  |  285 lines
  1.           
  2.           
  3.           
  4.           
  5.                                    SuperHost
  6.           
  7.                                   Version 1.0
  8.           
  9.                                (C)Copyright 1988
  10.           
  11.                                        By
  12.           
  13.                                    Tom Bensky
  14.           
  15.           
  16.           
  17.               Any questions,  comments,  or  suggestions  can  be left
  18.               (data) on the home of SuperHost  (818)  701-1021  or  by
  19.               writing the  author  at  the  below  address.    Address
  20.               messages to Tom Bensky.  I will respond ASAP.
  21.           
  22.           
  23.           
  24.           
  25.           
  26.           
  27.           
  28.  
  29.  
  30.  
  31.           
  32.          Table of Contents
  33.           
  34.           
  35.          What is SuperHost..................................1
  36.           
  37.          Conditions of Distribution.........................2
  38.           
  39.          Using SuperHost....................................3
  40.           
  41.          The remote user and SuperHost......................7
  42.           
  43.          Registration form..................................8
  44.           
  45.           
  46.           
  47.           
  48.           
  49.           
  50.           
  51.           
  52.  
  53.  
  54.  
  55.  
  56.          What is SuperHost?
  57.           
  58.               SuperHost is  a  program  that  allows you to set up any
  59.          program THAT USES BIOS FOR SCREEN  OUTPUT  for  use  over the
  60.          modem for another user (like a door for a bbs  system) or for
  61.          your own use (to work from home for example).  Once a program
  62.          is running under  SuperHost,  many things are being performed
  63.          by SuperHost to insure security  as  well  as making sure the
  64.          program looks the same for the remote user  as  it  would  in
  65.          local mode.  Here  is a list of things SuperHost does while a
  66.          program is running under it:
  67.           
  68.           
  69.               1.  All screen output by BIOS  or DOS is redirected over
  70.                   the modem.
  71.           
  72.               2.  Carrier detection is constantly monitored.
  73.                   If the carrier is suddenly lost, the  SuperHost will
  74.                   warm-boot the system.
  75.           
  76.               3.  A time limit is enforced.
  77.                   You can specify a maximum time that a program can be
  78.                   used under  SuperHost.   This  prevents  people from
  79.                   spending hours using  a  program.  If the time limit
  80.                   is exceeded, SuperHost warm-boots the system.
  81.           
  82.               4.  Cursor locations are recognized.
  83.                   If a BIOS call is made to reposition  the cursor (as
  84.                   many programs  do),  SuperHost  will  intercept this
  85.                   call, translate  it the  corresponding  ANSI  cursor
  86.                   positioning codes, and send it over the modem so the
  87.                   remote user will get the cursor positioned as well.
  88.           
  89.               5.  BIOS colors are recognized.
  90.                   If the program running utilizes color  via BIOS, the
  91.                   color codes  will be intercepted and translated into
  92.                   their corresponding ANSI  color  codes and sent over
  93.                   the modem so the remote user can see  the  color  as
  94.                   well.
  95.           
  96.               6.  Disk writes can be prohibited or allowed.
  97.                   If, while running a program, the user tries to write
  98.                   to a  disk,  SuperHost can prohibit the write if you
  99.                   so request initially.
  100.           
  101.               SuperHost basically allows you to use non-modem programs
  102.          over the modem.  It works with any program as long as BIOS or
  103.          DOS screen writes  are used.  Other methods of screen writing
  104.          are direct screen writes which SuperHost does not recognize.
  105.           
  106.           
  107.           
  108.                                       -2-
  109.  
  110.  
  111.  
  112.  
  113.          Using SuperHost
  114.           
  115.               SuperHost is  basically  very easy to use.  No set up is
  116.          required.  All and any information is supplied at run time on
  117.          the command line.   The  SuperHost   runtime   syntax  is  as
  118.          follows:
  119.           
  120.            SH (path-of-file-to-run) (Tx) [Wx] [Px] [L]  [CxZZx]  [dZZ]
  121.               Note: The  parameters  in  ()'s  ARE  MANDATORY  and the
  122.                     parameters in []'s are optional.
  123.           
  124.           
  125.          (path-of-file-to-run):
  126.           
  127.          * Mandatory parameter *
  128.          This is the exact path of the file  to execute when SuperHost
  129.          is invoked.  NO DEFAULTS ARE ASSUMED.  Be sure to include any
  130.          drive letter, subdirectory,  and  extension   (.EXE  or  .COM
  131.          only).
  132.           
  133.           
  134.          [Tx]:
  135.           
  136.          * Mandatory parameter *
  137.          This is the  maximum  time  limit  (x)  in  minutes  that the
  138.          program can be used per run.  x can be from 1 to 99.
  139.           
  140.           
  141.          [Wx]:
  142.           
  143.          * Optional parameter *
  144.          This is the disk write prohibit/allow  flag  (x).   If x is a
  145.          plus sign (+), disk writes are allowed.  It x is a minus sign
  146.          (-) disk writes  are not allowed.  This flag  defaults  to  a
  147.          minus sign (-)  and  does  not allow disk writes if Wx is not
  148.          found on the command line.
  149.           
  150.           
  151.          [Px]:
  152.           
  153.          * Optional parameter *
  154.          This tells SuperHost which communications port to use (x).  x
  155.          is 1 for COM1: or 2 for COM2:.    If  not  specified  on  the
  156.          command line, Px  defaults  to  1 and communications  port  1
  157.          (COM1:) will be used when SuperHost is run.
  158.           
  159.  
  160.          [L]:
  161.           
  162.          * Optional parameter *
  163.          This tells SuperHost  to expect screen output from DOS.  This
  164.          may take some experimenting to  determine  if it is needed or
  165.          not.  If the program works with CTTY, include this parameter.
  166.          No defaults are  assumed.   Most  INFOCOM games  (like  Zork,
  167.          Infidel) require this parameter in order to run.
  168.           
  169.          [CxZZx]:
  170.           
  171.          * Optional parameter *
  172.          This tells SuperHost  to  pass command line parameters to the
  173.          program supplied earlier.  These parameters will be passed as
  174.          if typed on the command line when  the program is run without
  175.          SuperHost.  ZZ are  the actual parameters as you  would  type
  176.          them as if  running  the  program in local mode.  The two x's
  177.          should be indentical characters  NOT  FOUND in ZZ.  These two
  178.          characters delimit ZZ.   They must be supplied  so  SuperHost
  179.          knows where the  parameters to pass start and end.  See below
  180.          for examples.
  181.           
  182.          [Dfilename]:
  183.           
  184.          * Optional parameter *
  185.          This tells SuperHost to dump ASCII file filename at run time.
  186.          This is helpful  for  informing  the  user  of  time  limits,
  187.          instructions, etc. before the actual program is  run.  At the
  188.          end of dumping each 24 lines, SuperHost will pause and give a
  189.          'More - ( Y )es or ( N )o prompt.
  190.           
  191.           
  192.          Examples:
  193.           
  194.               SH c:\games\invade.exe T30
  195.                - runs  c:\games\invade.exe  over communications port 1
  196.                  (default), does not allow  disk writes (default), and
  197.                  allows 30 minutes in which to use the program.
  198.           
  199.               SH b:\util\door\sample.com t15 P2 w+ C"/w /u"
  200.                - runs b:\util\door\sample.com over communications port
  201.                  2, allows disk writes, allows 15 minutes  in which to
  202.                  use the  program,  and  passes  /w /u as command line
  203.                  parameters.  Note the delimiters " and ".
  204.           
  205.               SH c:\edlin.com L t10 w+ Dedlin.doc
  206.                - runs c:\edlin.com, allows  10 minutes to use the door
  207.                  allows disk  writes, and dumps file edlin.doc  before
  208.                  running c:\edlin.com.    The  L  option  is  included
  209.                  because we  all know this  program  uses  DOS  screen
  210.                  writes.
  211.           
  212.           
  213.  
  214.  
  215.               SH a:game.exe t15 w- dgame.doc c\hello, hi\
  216.                - runs  a:game.exe,  allows 15 minutes to use the door,
  217.                  does not  allow disk writes,  dumps  game.doc  before
  218.                  running it, and passes parameter:   hello, hi
  219.                  to a:game.exe.  Not the delimiters \ and \ .
  220.           
  221.           
  222.               That's all  there is to it!  You will probably  want  to
  223.          put this one  SH xxxxxxxxxxx  line in a .BAT file (since most
  224.          bbs systems require a .BAT file for doors) and simply set the
  225.          bbs up to call this .BAT file  when  this  door is requested.
  226.          You don't have to worry about carrier loss, time  limits,  or
  227.          unauthorized disk writes...SuperHost handles it all!
  228.           
  229.           
  230.          * Note:  The  order  of  parameters  on the SuperHost command
  231.                   line does not matter.  However, SuperHost MUST
  232.                   find the path of the  program  to  run  as the FIRST
  233.                   parameter.
  234.           
  235.           
  236.          * Note: Do not try to run SuperHost without a user logged
  237.                  on.  Without a carrier detected, SuperHost will reset
  238.                  the system before anything happens.
  239.           
  240.  
  241.  
  242.  
  243.  
  244.          The user and SuperHost
  245.           
  246.               When an  online  user  is  using a program running under
  247.          SuperHost, s/he would basically  do whatever s/he would do if
  248.          s/he was using  the  program  in  local mode.   However,  the
  249.          occasion may arise  when  a  function  key  or  arrow  key is
  250.          requested or required to use the  program.   If a function or
  251.          arrow key is pressed, it will undoubtedly invoke  a  terminal
  252.          program function depending  on  the terminal program a person
  253.          is using. (if in ProComm, and F10 is pressed, the help window
  254.          is brought up).  For this reason, SuperHost allows emulations
  255.          of these keys.  They are:
  256.           
  257.               For function keys F1 to F10, the user should press:
  258.           
  259.                 [CTRL]-[F] + 1..9 or 0
  260.           
  261.               [CTRL]-[F] + 1 means function key F1
  262.               [CTRL]-[F] + 2 means function key F2
  263.                               .
  264.                               .
  265.               [CTRL]-[F] + 9 means function key F9
  266.               [CTRL]-[F] + 0 means function key F10
  267.           
  268.               For arrow keys:
  269.           
  270.                              [CTRL]-[W] for up arrow
  271.           
  272.              [CTRL]-[A] for left arrow    [CTRL]-[S] for right arrow
  273.           
  274.                              [CTRL]-[Z] for down arrow
  275.           
  276.          (notice the "arrow key arrangement"  these  keys  form on the
  277.           keyboard)
  278.           
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.