home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / ca24_1.zip / BBS&HOST.ZIP / HOST.DOC < prev   
Text File  |  1988-07-06  |  8KB  |  427 lines
  1. COM-AND Scripted HOST
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.           -----------------------------------------
  22.                 COM-AND Scripted HOST
  23.             Script based Host mode for the IBM PC
  24.           -----------------------------------------
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.     COM-AND is distributed freely and may be copied by anyone for any
  33.     number of machines.  The author offers COM-AND and accessory
  34.     programs (e.g.    PC-VCO or CCHESS) as "shareware".  If the program
  35.     is found to be useful or entertaining, a registration of $35.00
  36.     is requested.  If response warrants, COM-AND will be enhanced
  37.     and more accessory programs developed.    The author may be reached:
  38.  
  39.  
  40.                  CABER Software
  41.                  R. (Scott) McGinnis
  42.                  P.O. Box 3607 Mdse Mart
  43.                  Chicago, IL 60654-0607
  44.  
  45.                  PLINK, GEnie id: TARTAN
  46.                  SOURCE: BEM823
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 1.0: 880706
  61.  
  62. COM-AND Scripted HOST
  63.  
  64.  
  65.                  Table of Contents
  66.                  -----------------
  67.  
  68. I.    Introduction  .............................................. page 1
  69.  
  70. II.    Installing the HOST ........................................ page 2
  71.  
  72. III.    Program Requirements ....................................... page 3
  73.  
  74. IV.    Program and Author Information    ............................ page 4
  75.  
  76.  
  77.                 Appendices
  78.                 ----------
  79.  
  80.  
  81. A.    Modem configuration ........................................ page 5
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121. Version 1.0: 880706
  122.  
  123. COM-AND Scripted HOST                             Page   1
  124.  
  125.  
  126. I.    Introduction
  127.  
  128.  
  129.     A. What is COM-AND?
  130.  
  131.  
  132.        COM-AND for the IBM PC and compatibles is a communications
  133.        program that may be used by itself, or with several integrated
  134.        accessory programs (which themselves may be used independently of
  135.        COM-AND).  COM-AND provides standard comm program functions:  a
  136.        dialing directory, macros, disc logging, binary and ASCII file
  137.        transfers, and so on.
  138.  
  139.  
  140.     B. The HOST
  141.  
  142.        This document details the HOST script provided with version 2.2 of
  143.        COM-AND.  Two levels of hosting are provided.  First, password
  144.        protected logon and a limited set of functions are provided.  The
  145.        functions are:
  146.  
  147.        o       C)hdir           Change current directory
  148.        o       F)ilelist           List files in current subdirectory
  149.        o       P)athlist           Graphically list paths
  150.        o       U)pload           Upload a file using WXMODEM, XMODEM,
  151.                        YMODEM or KERMIT
  152.        o       D)ownload           Download a file using WXMODEM,
  153.                        XMODEM, YMODEM or KERMIT
  154.        o       E)xit           Logoff
  155.  
  156.        A second level of function is supplied with a second password.
  157.        DOS commands may be executed at this level.    NOTE:  Only DOS
  158.        commands that allow redirected I/O are 'usable' here.  DOS
  159.        functions that prompt for keyboard input will 'hang' the HOST
  160.        mode.
  161.  
  162.        All host activity is captured to a log file.
  163.  
  164.        The supplied HOST script works best if your modem is set to report
  165.        the real state of Carrier Detect (CD).  However, it has been used
  166.        quite successfully with modems that report Carrier Detect always
  167.        true (when disconnect occurs, Hayes compatible modems report the
  168.        fact with 'NO CONNECT').
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182. Version 1.0: 880706
  183.  
  184. COM-AND Scripted HOST                             Page   2
  185.  
  186.  
  187. II.    Installation
  188.  
  189.  
  190.     A. Set the caller and DOS passwords
  191.  
  192.        The only modification required to the supplied script is setting
  193.        the caller (S0) and DOS passwords.  The values to hold for your
  194.        host mode are set in the first 2 lines of the script.  Edit the
  195.        script, and set passwords as you wish.
  196.  
  197.     B. Check your modem
  198.  
  199.        For best operation, your modem should report true carrier detect.
  200.        Check to see that your modem does so.  This is not required, but
  201.        does assure that loss of carrier during a file transfer will not
  202.        go undetected until timeout.
  203.  
  204.     C. To start, type:
  205.  
  206.        CD <the subdirectory you wish to be the default>
  207.        "d"> COM-AND/fHOST-SRC
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243. Version 1.0: 880706
  244.  
  245. COM-AND Scripted HOST                             Page   3
  246.  
  247.  
  248. III.    Program requirements
  249.  
  250.  
  251.     This program can only function on an IBM PC or DOS compatible
  252.     machine.  COM-AND does direct to screen buffer fetches and stores
  253.     (unless BIOS screen updates are directed using the /C switch or the
  254.     Alt-O options menu).
  255.  
  256.  
  257.     COM-AND supports MDA, CGA, EGA and Hercules.  COM-AND uses a Micro-
  258.     soft Mouse if one is available (not well, but it'll certainly get
  259.     better).
  260.  
  261.  
  262.     COM-AND disk I/O is done through the 'Handle' oriented I/O routines
  263.     added to DOS 2.0.  Therefore DOS 2.0 is a minimum requirement.
  264.  
  265.  
  266.     COM-AND (Version 2.2) requires 215K for itself.  You need 256K
  267.     (minimally), and more to take advantage of the DOS Gateway and
  268.     even more yet to load accessories.
  269.  
  270.  
  271.     This script requires a 300, 1200 or 2400 baud modem.  [Others could
  272.     be supported with modification to the script.]    This script is most
  273.     reliable if the modem is set to report true CD.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304. Version 1.0: 880706
  305.  
  306. COM-AND Scripted HOST                             Page   4
  307.  
  308.  
  309. IV.    Author information
  310.  
  311.  
  312.     COM-AND was written using Microsoft Macro-Assembler.  The
  313.     author likes assembler.  Assembly language is an entirely
  314.     appropriate vehicle for some of the program, and a not-inappro-
  315.     priate vehicle for the rest of it.  Everything, in moderation...
  316.  
  317.  
  318.     The author of this program is R. Scott McGinnis of Chicago,
  319.     Illinois.  PLINK and GEnie ID:    TARTAN.  Comment and suggestions
  320.     (and criticism in moderation) are welcomed:
  321.  
  322.              CABER Software
  323.              R. (Scott) McGinnis
  324.              P.O. Box 3607 Mdse Mart
  325.              Chicago, IL 60654-0607
  326.  
  327.  
  328.     I wish to say that my wife, Elizabeth, is the best reason I've ever
  329.     known for continuing to live.  Without her beside me (propping me up
  330.     alot of the time), I wouldn't be.
  331.  
  332.  
  333.     This script (Version 1.0) may be distributed freely (but it isn't a
  334.     whole lot of use without COM-AND).  Any improvements that are
  335.     returned to the author will get attention...  errors reported to the
  336.     author will be corrected.  COM-AND is shareware.  If COM-AND is
  337.     found entertaining or useful, a contribution of $35.00 is requested.
  338.     Should response warrant it, I will continue to develop and support
  339.     this product.
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365. Version 1.0: 880706
  366.  
  367. COM-AND Scripted HOST                             Page   5
  368.  
  369.  
  370. A.    Modem Configuration
  371.  
  372.  
  373.     COM-AND default values do not require your modem to be configured
  374.     in any particular manner.  However, certain features cannot be used
  375.     unless you configure your modem before you use COM-AND.
  376.  
  377.  
  378.     1. DTR (Data Terminal Ready)
  379.  
  380.        COM-AND, by default, hangs up using the command sequences defined
  381.        through the Alt-S setup (hangup and modem escape).  However, you
  382.        may alternately select 'Drop DTR to hangup' through the Alt-O
  383.        options.  Dropping DTR is the only way to hangup certain modems,
  384.        and is generally much faster than the command sequences.
  385.  
  386.  
  387.        Most Hayes compatible modems allow configuration of the DTR sense
  388.        through a switch-block.  If you wish to use DTR to hangup, be sure
  389.        that your modem follows the DTR signal.  Refer to the documenta-
  390.        tion provided with your modem to be sure that option switches are
  391.        set appropriately.
  392.  
  393.  
  394.     2. CD (Carrier Detect)
  395.  
  396.        COM-AND (presently) uses the CD sense line for several purposes.
  397.        The 'CONNECTED' test supported in the script language, test for
  398.        carrier detect upon exit, and the file transfer protocols all
  399.        require that the modem report carrier detect.  True carrier detect
  400.        is the only way to determine if you are 'on-line' or 'off-line'.
  401.  
  402.  
  403.        Many Hayes compatible modems are sold with a carrier detect
  404.        override (in other words the modem reports carrier detect all the
  405.        time).  When carrier detect is overridden, COM-AND cannot detect
  406.        when carrier is lost during a file transfer or whether to ask if
  407.        you want to hangup when you exit.
  408.  
  409.  
  410.        Be sure that the modem is reporting true CD (instead of it just
  411.        saying 'yes').  Most Hayes compatible modems allow configuration
  412.        of the CD sense through a switch-block.  Refer to the documenta-
  413.        tion provided with your modem to be sure that option switches are
  414.        set appropriately.
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426. Version 1.0: 880706                           Appendices
  427.