home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / HILFEN / MODEM / COMAND28 / HOST.DOC < prev    next >
Text File  |  1993-12-01  |  16KB  |  660 lines
  1. COM-AND Scripted HOST
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.           -----------------------------------------
  18.                 COM-AND Scripted HOST
  19.             Script based Host mode for the IBM PC
  20.           -----------------------------------------
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.     COM-AND is distributed freely and may be copied by anyone for
  33.     any number of machines, for purposes of evaluation.  The author
  34.     offers COM-AND and its accessory programs as a package, as
  35.     "shareware".  If you USE the program a registration of $50.00
  36.     is required.  The author may be reached:
  37.  
  38.  
  39.                  CABER Software
  40.                  R. (Scott) McGinnis
  41.                  P.O. Box 3607 Mdse Mart
  42.                  Chicago, IL 60654-0607
  43.  
  44.                  PLINK, GEnie id: TARTAN
  45.                  CIS is: 73147,2665
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54. Version 1.1: 910711
  55.  
  56. COM-AND Scripted HOST
  57.  
  58.  
  59.                  Table of Contents
  60.                  -----------------
  61.  
  62. I.    Introduction  .............................................. page 1
  63.  
  64.     A. What is COM-AND? ........................................ page 1
  65.     B. The HOST ................................................ page 1
  66.  
  67. II.    Installing the HOST ........................................ page 2
  68.  
  69.     A. Load HOSETUP ............................................ page 2
  70.     B. Using HOSETUP ........................................... page 2
  71.     C. Exit HOSETUP and load HOST .............................. page 3
  72.  
  73. III.    External programs .......................................... page 5
  74.  
  75.     A. TREED ................................................... page 5
  76.     B. DOORWAY ................................................. page 5
  77.  
  78. IV.    Program Requirements ....................................... page 6
  79.  
  80. V.    Program and Author Information    ............................ page 7
  81.  
  82.  
  83.                 Appendices
  84.                 ----------
  85.  
  86.  
  87. A.    Modem configuration ........................................ page 8
  88.  
  89.     1. DTR ..................................................... page 8
  90.     2. CD ...................................................... page 8
  91.     3. Modem ESCAPE ............................................ page 9
  92.     4. Hangup .................................................. page 9
  93.     5. Modem Init .............................................. page 9
  94.  
  95. B.    HOSTART.CMD ................................................ page 10
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109. Version 1.1: 910711
  110.  
  111. COM-AND Scripted HOST                             Page   1
  112.  
  113.  
  114. I.    Introduction
  115.  
  116.  
  117.     A. What is COM-AND?
  118.  
  119.  
  120.        COM-AND for the IBM PC and compatibles is a communications program
  121.        that may be used by itself, or with several integrated accessory
  122.        programs (which themselves may be used independently of COM-AND).
  123.        COM-AND provides standard comm program functions:  a dialing dir-
  124.        ectory, macros, disc logging, binary and ASCII file transfers, and
  125.        a script language.
  126.  
  127.  
  128.     B. The HOST
  129.  
  130.        This document details the HOST script provided with COM-AND.  Two
  131.        levels of hosting are provided.  First, password protected logon
  132.        and a limited set of functions are provided.  The functions are:
  133.  
  134.        o   C)hdir               Change current directory
  135.        o   F)ilelist           List files in current subdirectory
  136.        o   P)athlist           Graphically list paths
  137.        o   U)pload               Upload a file using WXMODEM,
  138.                        XMODEM, YMODEM, ZMODEM or KERMIT
  139.        o   D)ownload           Download a file using WXMODEM,
  140.                        XMODEM, YMODEM, ZMODEM or KERMIT
  141.        o   E)xit               Logoff
  142.  
  143.        Two additional functions are accessed with a second password (the
  144.        commands 'x' and 'y' are NOT listed on the HOST menu):
  145.  
  146.        o   X:  DOS commands may be executed at this level.    [NOTE:    DOS
  147.            commands supporting redirected I/O are only 'usable' here.
  148.            DOS functions that prompt for keyboard input will 'hang'
  149.            the HOST mode.]
  150.  
  151.        o   Y:  A drop-to-DOS is supported, using a doorway utility (such
  152.            as Marshall Dudley's DOORWAY).  COM-AND is terminated, and
  153.            the doorway loaded, allowing full access to the machine.
  154.            On termination of the doorway, COM-AND is reloaded, and
  155.            the HOST script re-entered.
  156.  
  157.        The supplied HOST script works best if your modem is set to report
  158.        the real state of Carrier Detect (CD).  However, it has been used
  159.        quite successfully with modems that report Carrier Detect always
  160.        true (when disconnect occurs, Hayes compatible modems report the
  161.        fact with 'NO CONNECT', and HOST is coded to look for it).
  162.  
  163.  
  164. Version 1.1: 910711
  165.  
  166. COM-AND Scripted HOST                             Page   2
  167.  
  168.  
  169. II.    Installation
  170.  
  171.  
  172.     Included with the HOST script is a utility script, HOSETUP.  HOSETUP
  173.     is used to configure the HOST if default values are not desired (and
  174.     rarely are they!).
  175.  
  176.  
  177.     A. Load HOSETUP
  178.  
  179.        Load COM-AND and invoke HOSETUP.  For example, from the DOS
  180.        prompt:
  181.  
  182.          "d>" COM-AND /fHOSETUP
  183.  
  184.        loads COM-AND and invokes the HOSETUP script.  [This document
  185.        assumes scripts are on the current subdirectory, or the subdir-
  186.        ectory pointed by the COM-AND= environment variable.]
  187.  
  188.        If HOSETUP is used to change any default values, a file, HOSTDAT
  189.        will be created for the HOST script.  HOSTDAT is created on the
  190.        subdirectory pointed by the COM-AND= environment variable.  In
  191.        the absence of that variable, HOSTDAT will be created on the
  192.        current directory (in which case HOST MUST be executed from the
  193.        same directory).
  194.  
  195.  
  196.     B. Using HOSETUP
  197.  
  198.        From HOSETUP's main menu, select the items in numeric order.
  199.  
  200.        1) Identify modem values
  201.  
  202.           a) Identify modem port; The default value is the default for
  203.          COM-AND.  You may wish to change this for the HOST.  What-
  204.          ever port you indicate here WILL be the HOST's comm port.
  205.  
  206.           b) Identify modem speed; The default value is the default for
  207.          COM-AND.  You may wish to change this for the HOST.  This is
  208.          the speed set by the HOST when waiting for a call.
  209.  
  210.           c) Identify modem control string;  The default value for this
  211.          is appropriate for most Hayes compatible modems.  It may
  212.          need modification for some modems; if so, refer to the
  213.          documentation that came with the modem.
  214.  
  215.  
  216.  
  217.  
  218.  
  219. Version 1.1: 910711
  220.  
  221. COM-AND Scripted HOST                             Page   3
  222.  
  223.  
  224. II.    Installation (continued)
  225.  
  226.  
  227.     B. Use HOSETUP (continued)
  228.  
  229.        2) Identify passwords used by HOST;
  230.  
  231.           a) Identify the LOGON password.  Callers may use ANY name, but
  232.          MUST use this password.  The default is "****".
  233.  
  234.           b) Identify the DOS password.  Once connected, as described
  235.          above, DOS functions are available.  To access the DOS
  236.          functions, the DOS password is required.  The default is
  237.          "xxxx".
  238.  
  239.  
  240.        3) Identify the doorway command;
  241.  
  242.           The doorway command carries both the file name of the doorway
  243.           utility, and any parameters required.  For example:
  244.  
  245.           c:\doorway\doorway com4 /S:* /G:ON /V:B^U /M:1000 /C:DOS /V:D
  246.  
  247.           The command, exactly as typed will be executed by DOS when a
  248.           drop-to-DOS is executed.
  249.  
  250.           If this command is left null (its default), the drop-to-DOS
  251.           function is inhibited.
  252.  
  253.  
  254.     C. Exit HOSETUP and load HOST
  255.  
  256.        ESC or successive carriage returns will exit HOSETUP.  Back in
  257.        COM-AND, invoke HOST through the F2 key.  In the script prompt
  258.        window, for example, type:
  259.  
  260.         \HOST\HOST
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274. Version 1.1: 910711
  275.  
  276. COM-AND Scripted HOST                             Page   4
  277.  
  278.  
  279. II.    Installation (continued)
  280.  
  281.  
  282.     C. Exit HOSETUP and load HOST (continued)
  283.  
  284.  
  285.        Two HOST script files are included in each release.    The script
  286.        HOST.SRC is commented source for the HOST.  The file HOST.CMD is a
  287.        stripped script; it contains no comments and is not very readable.
  288.        HOST.CMD is the script that should be executed (stripped, it exe-
  289.        cutes faster than HOST.SRC).  HOST.SRC is provided for the intre-
  290.        pid who wish to modify the HOST.
  291.  
  292.        [COM-AND will not recognize HOST.SRC as a script unless the ".SRC"
  293.        is stated explicitly when the script is invoked.]
  294.  
  295.        Having loaded HOST, it is suggested you then call in from another
  296.        PC and test the setup.
  297.  
  298.  
  299.        Should the use of HOST become a habit (ugh!), a simple batch file
  300.        may be used to invoke it from the DOS prompt:
  301.  
  302.         COM-AND /fHOST
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329. Version 1.1: 910711
  330.  
  331. COM-AND Scripted HOST                             Page   5
  332.  
  333.  
  334. III.    External programs
  335.  
  336.  
  337.     The HOST uses two external programs to fufill its function (besides
  338.     COM-AND, of course).  These are the p/d utility TREED and the share-
  339.     ware utility DOORWAY (or its equivalent).
  340.  
  341.  
  342.     A) TREED
  343.  
  344.        The p/d utility TREED lists the tree of subdirectories on the
  345.        current drive in an easily readable graphical form.    It uses the
  346.        8-bit characters in the PC ASCII character set to draw lines and
  347.        connections.
  348.  
  349.        The HOST script's use of this utility is coded into the PATHLIST
  350.        command.  It is easily changed to another utility.
  351.  
  352.  
  353.     B) DOORWAY
  354.  
  355.        The shareware utility DOORWAY, by Marshall Dudley, makes a program
  356.        or the DOS prompt available from a remote site using a previously
  357.        opened communications port.    Its only limitation is that it DOES
  358.        not support true graphics mode.
  359.  
  360.        The HOST script's use of this utility is established through the
  361.        HOSETUP script.  Whatever equivalent utility is available may be
  362.        used for the drop-to-DOS function.
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384. Version 1.1: 910711
  385.  
  386. COM-AND Scripted HOST                             Page   6
  387.  
  388.  
  389. IV.    Program requirements
  390.  
  391.  
  392.     This program can only function on an IBM PC or DOS compatible
  393.     machine.  COM-AND does direct to screen buffer fetches and stores
  394.     (unless BIOS screen updates are directed using the /C switch or the
  395.     Alt-O options menu).
  396.  
  397.  
  398.     COM-AND is TopView aware even without the /C switch or Alt-O option.
  399.  
  400.  
  401.     COM-AND supports MDA, CGA, EGA and Hercules.  COM-AND uses a Micro-
  402.     soft Mouse if one is available...
  403.  
  404.  
  405.     COM-AND disk I/O is done through the 'Handle' oriented I/O routines
  406.     added to DOS 2.0.  Therefore DOS 2.0 is a minimum requirement.
  407.  
  408.  
  409.     COM-AND (Version 2.8) requires 256K for itself.  You need 384K to
  410.     take advantage of the DOS Gateway and to load accessories.
  411.  
  412.  
  413.     This script requires a 300, 1200 or 2400 baud modem.  [Others could
  414.     be supported with modification to the script.]    This script is most
  415.     reliable if the modem is set to report true CD.
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439. Version 1.1: 910711
  440.  
  441. COM-AND Scripted HOST                             Page   7
  442.  
  443.  
  444. V.    Author information
  445.  
  446.  
  447.     COM-AND was written using Microsoft Macro-Assembler.  The author
  448.     likes assembler.  Assembly language is an entirely appropriate
  449.     vehicle for some of the program, and a not-inappropriate vehicle
  450.     for the rest of it.  Everything, in moderation...
  451.  
  452.  
  453.     The author of this program is R.  Scott McGinnis of Chicago, IL.
  454.     His PLINK and GEnie ID is: TARTAN.  Comment and suggestions (and
  455.     criticism in moderation) are welcomed:
  456.  
  457.              CABER Software
  458.              R. (Scott) McGinnis
  459.              P.O. Box 3607 Mdse Mart
  460.              Chicago, IL 60654-0607
  461.  
  462.  
  463.     I wish to say that my wife, Elizabeth, is the best reason I've ever
  464.     known for continuing to live.  Without her beside me (propping me up
  465.     alot of the time), I wouldn't be.
  466.  
  467.  
  468.     This script (Version 1.1) may be distributed freely (but it isn't a
  469.     whole lot of use without COM-AND).  Any improvements that are
  470.     returned to the author will get attention...  errors reported to the
  471.     author will be corrected.  COM-AND is shareware.  If COM-AND is USED
  472.     after a reasonable period of evaluation, a registration of $50.00 is
  473.     required.
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494. Version 1.1: 910711
  495.  
  496. COM-AND Scripted HOST                             Page   8
  497.  
  498.  
  499. A.    Modem Configuration
  500.  
  501.  
  502.     COM-AND default values do not require your modem to be configured
  503.     in any particular manner.  However, certain features cannot be used
  504.     unless you configure your modem before you use COM-AND.
  505.  
  506.  
  507.     1. DTR (Data Terminal Ready)
  508.  
  509.        COM-AND, by default, hangs up using the command sequences defined
  510.        through the Alt-S setup (hangup and modem escape).  However, you
  511.        may alternately select 'Drop DTR to hangup' through the Alt-O
  512.        options.  Dropping DTR is the only way to hangup certain modems,
  513.        and is generally much faster than the command sequences.
  514.  
  515.  
  516.        Most Hayes compatible modems allow configuration of the DTR sense
  517.        through a switch-block.  If you wish to use DTR to hangup, be sure
  518.        that your modem follows the DTR signal.  Refer to the documenta-
  519.        tion provided with your modem to be sure that option switches are
  520.        set appropriately.
  521.  
  522.  
  523.     2. CD (Carrier Detect)
  524.  
  525.        COM-AND (presently) uses the CD sense line for several purposes.
  526.        The 'CONNECTED' test supported in the script language, test for
  527.        carrier detect upon exit, and the file transfer protocols all
  528.        require that the modem report carrier detect.  True carrier detect
  529.        is the only way to determine if you are 'on-line' or 'off-line'.
  530.  
  531.  
  532.        Many Hayes compatible modems are sold with a carrier detect
  533.        override (in other words the modem reports carrier detect all the
  534.        time).  When carrier detect is overridden, COM-AND cannot detect
  535.        when carrier is lost during a file transfer or whether to ask if
  536.        you want to hangup when you exit.
  537.  
  538.  
  539.        Be sure that the modem is reporting true CD (instead of it just
  540.        saying 'yes').  Most Hayes compatible modems allow configuration
  541.        of the CD sense through a switch-block.  Refer to the documenta-
  542.        tion provided with your modem to be sure that option switches are
  543.        set appropriately.
  544.  
  545.  
  546.  
  547.  
  548.  
  549. Version 1.1: 910711                          Appendices
  550.  
  551. COM-AND Scripted HOST                             Page   9
  552.  
  553.  
  554. A.    Modem Configuration (continued)
  555.  
  556.  
  557.     3. Modem Escape
  558.  
  559.        COM-AND issues the "Modem escape" defined through the Alt-S setup,
  560.        prior to modem initialization and hangup.  Be sure this value is
  561.        set correctly in Alt-S (or see below).
  562.  
  563.  
  564.     4. Hangup
  565.  
  566.        COM-AND hangs up using the command sequences defined through the
  567.        Alt-S setup (hangup and modem escape) and the drop DTR setting as
  568.        discussed above.  be sure these values are set correctly (or see
  569.        below).
  570.  
  571.  
  572.     5. Modem Init
  573.  
  574.        COM-AND transmits the modem initialization sequence defined by
  575.        Alt-S setup to configure the modem.    HOST re-issues this initial-
  576.        ization when HOST is exited.  If HOST is used, it is suggested
  577.        that autoanswer be turned OFF in the Alt-S modem init string.
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604. Version 1.1: 910711                          Appendices
  605.  
  606. COM-AND Scripted HOST                             Page  10
  607.  
  608.  
  609. B.    HOSTART.CMD script
  610.  
  611.  
  612.     The HOSTART.CMD script, included with HOST.CMD and HOST.SRC is the
  613.     means of return from DOORWAY.  HOST version 1.1 looks at its invoca-
  614.     tion before it resets the modem.  If HOST was FCALLed, then HOST
  615.     issues the main menu and waits for command (up to the timeout).  If
  616.     HOST was NOT FCALLed, HOST resets the modem and waits for connect.
  617.  
  618.  
  619.     In order to make as much of the HOST machine as possible available
  620.     through the DOORWAY, when DOORWAY is invoked, COM-AND itself is
  621.     terminated (without dropping carrier).    DOORWAY is loaded, and when
  622.     DOORWAY is exited (by the caller), COM-AND is reloaded with an
  623.     invocation of HOSTART.    HOSTART simply FCALLs HOST, and HOST picks up
  624.     again at the main menu.
  625.  
  626.  
  627.     In case you were wondering...
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659. Version 1.1: 910711                          Appendices
  660.