home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 05B / THP100.ZIP / TH-PLUS.DOC < prev    next >
Encoding:
Text File  |  1992-04-21  |  21.6 KB  |  659 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                  TINYHOST PLUS
  13.  
  14.                                      V 1.00
  15.                                  April 21, 1992
  16.  
  17.  
  18.                     Copyright (C) 1991 by Bruce A. Krobusek
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                   An Enhanced Version of TinyHost - the small,
  30.  
  31.                          personal, Host/BBS program for
  32.  
  33.                             IBM PC's and compatibles
  34.  
  35.  
  36.  
  37.  
  38.  
  39.                          Created by : Bruce A. Krobusek
  40.  
  41.                                       5950 King Hill Drive
  42.                                       Farmington, NY  14425
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                          CompuServe : 74106,1335
  51.                               GEnie : B.KROBUSEK
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.        
  60.        
  61.        
  62.        
  63.        
  64.        
  65.        
  66.        
  67.        
  68.        
  69.        
  70.        1.0   INTRODUCTION                                             1
  71.         1.1   What is TinyHost?                                       1
  72.         1.2   Why TinyHost Plus?                                      1
  73.         1.3   Where's the Manual?                                     2
  74.         1.4   Manual Conventions                                      2
  75.        
  76.        2.0   INSTALLATION and SETUP                                   2
  77.         2.1   General Comments                                        2
  78.         2.2   Modem Init Changes                                      2
  79.         2.3   Added Descriptors                                       2
  80.                  CALL                                                 3
  81.                  CALLDBUG                                             3
  82.                  RECEIVE                                              4
  83.                  SEND                                                 4
  84.                  TIMEOUT                                              5
  85.        
  86.        3.0   OPERATION                                                5
  87.         3.1   Considerations                                          5
  88.        
  89.        4.0   MISCELLANEOUS                                            6
  90.         4.1   What is Shareware?                                      6
  91.         4.2   Distributing TinyHost Plus                              6
  92.         4.3   License Agreement                                       7
  93.         4.4   Warranty Information                                    7
  94.         4.5   Program Support                                         7
  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.        
  122.        
  123.        
  124.        
  125.  
  126.        Brand and product names used throughout this document are
  127.        trademarks or registered trademarks of their respective holders.
  128.        
  129.        
  130.        
  131.        
  132.        
  133.        
  134.        
  135.        
  136.        1.0   INTRODUCTION
  137.  
  138.        1.1   What is TinyHost Plus?
  139.  
  140.            TinyHost Plus is an expanded version of TinyHost, the small,
  141.        personal, Host / BBS program. TinyHost Plus has all of the
  142.        features of TinyHost V3.00, plus:
  143.  
  144.            *  Timeout provisions to set the length of time TinyHost
  145.               Plus is to run.
  146.  
  147.            *  Callout capability to connect with another TinyHost or
  148.               TinyHost Plus system to transfer up to 5 files
  149.               automatically.
  150.  
  151.            *  TinyHost Plus is still tiny! The executable file is less
  152.               than 95K, and the program only requires approximately
  153.               150K of system RAM to run in.
  154.  
  155.            Your version of TinyHost Plus includes the following files:
  156.  
  157.                 THPxxx.EXE   - The TinyHost Plus executable. The
  158.                                xxx refer to the version number of
  159.                                the program
  160.                 TINYHOST.DOC - The TinyHost manual in printer
  161.                                ready form (PRINT TINYHOST.DOC)
  162.                 TH-PLUS.DOC  - The TinyHost Plus manual addendum in
  163.                                printer ready form (PRINT TH-PLUS.DOC)
  164.                 TINYHOST.WEL - A sample welcome file
  165.                 TINYHOST.CFG - A sample configuration file
  166.                 THREMOTE.BAT - Sample batch file for Shell-to-DOS
  167.                 ZMXMIT.BAT   - Batch file for DSZ ZModem downloads
  168.                 ZMRCV.BAT    - Batch file for DSZ ZModem uploads
  169.                 THP-REG.FRM  - Ready-to-print registration form
  170.                                (PRINT REGISTER.FRM)
  171.                 THP-HIST.TXT - A file describing the release
  172.                                history of TinyHost Plus
  173.                 THP-READ.ME  - A short text file describing
  174.                                TinyHost Plus
  175.                 IN-NODE.LST  - A text file with a list of all
  176.                                current Intelec nodes (BBSes)
  177.  
  178.  
  179.        1.2   Why TinyHost Plus?
  180.  
  181.            TinyHost Plus was created initially to fulfill a specific
  182.        client's application. It was necessary to be able to transfer
  183.        files automatically between remote sites at specific times, yet
  184.        still have the capability of receiving other calls from other
  185.        users.
  186.  
  187.            Since then, I've decided to put many advanced features into
  188.        the Plus version, and keep TinyHost the way it is - small and
  189.        simple. This isn't to say that TinyHost won't be enhanced. It
  190.        just will not be burdened with specialty functions (such as this
  191.        automatic Call Out capability).
  192.  
  193.  
  194.  
  195.                                      Page 1
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.        1.3   Where's the Manual?
  203.  
  204.            This document addresses all of the added functions in
  205.        TinyHost Plus only. Please refer to the TinyHost manual
  206.        (TINYHOST.DOC) for further information on general setup and use.
  207.  
  208.  
  209.        1.4   Manual Conventions
  210.  
  211.            To save wear-and-tear on the author's typing fingers,
  212.        TinyHost will hereafter be referred to as TH; TinyHost Plus will
  213.        be abbreviated as THP.
  214.  
  215.  
  216.  
  217.        2.0   INSTALLATION and SETUP
  218.  
  219.        2.1   General Comments
  220.  
  221.            Unlike all other TH/THP descriptors, the placement within the
  222.        TINYHOST.CFG file of CALL, SEND, and RECEIVE is critical. The
  223.        CALL descriptor must come first, followed by up to 5 SEND/RECEIVE
  224.        descriptors.
  225.  
  226.  
  227.        2.2   Modem Init Changes
  228.  
  229.            Only one minor change must be made to the modem init string
  230.        to move from TH to THP. The 'X' setting, which selects which
  231.        modem result codes are active, must be set to 5 or greater. The
  232.        additional result codes necessary are:
  233.  
  234.            RINGING - Informs THP that the modem has dialed and the
  235.            remote line is ringing.
  236.  
  237.            BUSY - Denotes that the remote line is busy.
  238.  
  239.            NO CARRIER - Informs THP that Carrier Detect has failed
  240.            (modem linkup was not made).
  241.  
  242.  
  243.        2.3   Added Descriptors
  244.  
  245.            Several descriptors have been added to THP to implement the
  246.        new features:
  247.  
  248.                 CALL     - Defines the Call Out function
  249.                 CALLDBUG - Enables Call Out debugging
  250.                 RECEIVE  - Defines a file to download
  251.                 SEND     - Defines a file to upload
  252.                 TIMEOUT  - Sets a period of time for THP activity
  253.  
  254.        All descriptors (except CALLDBUG) are re-loaded when the Warm
  255.        Boot command is issued from the TinyHost Plus select prompt.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                      Page 2
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.            CALL - Specifies the parameters for Call Out event where THP
  269.        dials out to another TH/THP system. Do NOT put any embedded
  270.        spaces in any of the descriptor fields. The descriptor format is:
  271.  
  272.        CALL:<hhmm>,<dial>,<first>,<last>,<password>,<retries>
  273.  
  274.            <hhmm> - The time that the Call Out event is to be run. The
  275.        time is to be specified in 24-hour military format (0000-2359,
  276.        0000 equals midnight). All four digits, including leading zeroes,
  277.        must be present. An hour value of 99 will cause the event to be
  278.        executed as soon as THP is run.
  279.  
  280.            <dial> - The dial-out string which includes the phone number
  281.        to be dialed. This string will be sent directly to the modem. The
  282.        string must include the modem's attention command and type of
  283.        dialing (pulse or tone) to be used. Up to 24 characters may be
  284.        used in this string.
  285.  
  286.            <first> - First name of account to use when logging into
  287.        destination system (15 characters max).
  288.  
  289.            <last> - Last name of login account. Up to 30 characters in
  290.        length.
  291.  
  292.            <password> - Password of login account. Limited to 8
  293.        characters.
  294.  
  295.            <retries> - Number of times to retry if a connection is not
  296.        made (due to a busy signal, etc.). THP will wait one minute
  297.        between dialing attempts. Retries is optional, and defaults to
  298.        zero.
  299.  
  300.        The following line:
  301.  
  302.        CALL:0130,ATDT5551212,Fred,Mbogo,FOOBAR,5
  303.  
  304.        would execute a Call Out event at 1:30 AM, tone dial 555-1212,
  305.        use the account of Fred Mbogo with the password FOOBAR, and try 5
  306.        times to connect. Changing the line to:
  307.  
  308.        CALL:9900,ATDT5551212,Fref,Mbogo,FOOBAR,5
  309.  
  310.        would cause the Call Out event to be executed as soon as TinyHost
  311.        Plus is started.
  312.  
  313.            CALLDBUG - Placing this descriptor in the config file will
  314.        display the progress of the Call Out event on the local screen.
  315.        This is useful for debugging an event. CALLDBUG is not affected
  316.        by a Warm Boot.
  317.  
  318.        CALLDBUG                 # No other info is needed for Debug
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                      Page 3
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.            RECEIVE - Specifies the parameters for receiving
  335.        (downloading) a file from the remote system. The format of this
  336.        descriptor is:
  337.  
  338.            RECEIVE:<path>,<filename>,<protocol>
  339.  
  340.            <path> - This is the remote system's directory path to
  341.        the desired file. Unless the file is in the root directory of the
  342.        remote system, the terminating slash ('\') must be omitted. If
  343.        the file is in the Start-Up directory of the remote system then
  344.        <path> may be left blank (but the trailing comma MUST be
  345.        included!). <path> is limited to 63 characters.
  346.  
  347.            <filename> - Filename of the file to be downloaded. The file
  348.        will be stored in the execution directory of the calling system.
  349.        The same name will be used as the destination file, and any
  350.        existing file will be overwritten (no backups made). <filename>
  351.        is limited to 12 characters.
  352.  
  353.            <protocol> - Number of the protocol to be used: 1 for
  354.        XModem/CRC; 2 for 1K-XModem. External protocols are not
  355.        supported.
  356.  
  357.            A sample descriptor line:
  358.  
  359.        RECEIVE:C:\TINYHOST,ZORKMID.TXT,1
  360.  
  361.        would move to the C:\TINYHOST directory of the remote system and
  362.        try to download ZORKMID.TXT using XModem/CRC. Do NOT use spaces
  363.        in any of the descriptor fields.
  364.  
  365.            SEND - This descriptor specifies the sending (Upload) of a
  366.        file from the calling system to the remote. The format is:
  367.  
  368.        SEND:<path>,<filename>,<protocol>,<overwrite>
  369.  
  370.            <path> - This is the remote system's directory path where the
  371.        file being sent should be stored. Unless the file will be placed
  372.        in the root directory of the remote system, the terminating slash
  373.        ('\') must be omitted. If the file is in the Start-Up directory
  374.        of the remote system then <path> may be left blank (but the
  375.        trailing comma MUST be included!). <path> is limited to 63
  376.        characters.
  377.  
  378.            <filename> - Filename of the file to be uploaded. The file
  379.        will be stored in the directory specified by <path>. <filename>
  380.        can include a path to access a file outside of the TinyHost Plus
  381.        execution directory. The name of the file being transferred will
  382.        be retained at the destination system. <filename> is limited to
  383.        75 characters.
  384.  
  385.            <protocol> - Number of the protocol to be used: 1 for
  386.        XModem/CRC; 2 for 1K-XModem. External protocols are not
  387.        supported.
  388.  
  389.            <overwrite> - Specifies whether or not existing files on the
  390.        destination system with the same name should be overwritten or
  391.        not. <overwrite> expects a 'Y' or 'N', and defaults to No. When
  392.  
  393.                                      Page 4
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.        overwriting a file, backups are automatically made on the
  401.        destination system. A successful overwrite also depends on the
  402.        login account having sufficient security to permit overwriting a
  403.        file.
  404.  
  405.            A sample descriptor line:
  406.  
  407.        SEND:C:\TINYHOST,ZORKMID.TXT,2,Y
  408.  
  409.        would move to the C:\TINYHOST directory of the remote system and
  410.        try to upload ZORKMID.TXT using 1K-XModem. If ZORKMID.TXT already
  411.        exists then it is overwritten (security permitting). Again, no
  412.        spaces should be used in any of the descriptor fields.
  413.  
  414.            TIMEOUT - Sets the length of time that THP is to remain
  415.        active. After this time has elapsed, THP will return to DOS. The
  416.        length of time is set in hhmm format, from 0000-2359 (leading
  417.        zeroes are necessary). Note that, because of the software
  418.        routines used, the actual timeout delay may be up to one minute
  419.        less than that specified. Also note that both an EVENT and
  420.        TIMEOUT time cannot be specified.
  421.  
  422.            The following line:
  423.  
  424.        TIMEOUT:0130
  425.  
  426.        would allow THP to run for approximately one hour and thirty
  427.        minutes before exiting to DOS.
  428.  
  429.  
  430.  
  431.        3.0   OPERATION
  432.  
  433.            When in Call Out mode, TinyHost Plus should require no
  434.        operator intervention. If, during the dialing process, the call
  435.        must be redialed, pressing <ESC> at the local keyboard will abort
  436.        the Call Event.
  437.  
  438.            When the connection is made, all of the commands that need to
  439.        be executed to transfer the specified files, such as Change
  440.        Directory, etc., will be handled automatically. In case of line
  441.        noise, each command will be attempted three times before
  442.        TinyHost Plus gives up and moves on.
  443.  
  444.            If Log file support is enabled, THP will keep track of file
  445.        transfers and whether they were successful or not.
  446.  
  447.  
  448.        3.1   Considerations
  449.  
  450.            In order to decide what to do and when to do it, TinyHost
  451.        Plus looks over each line of data it receives from the remote
  452.        TinyHost system. Because of this, however, TinyHost Plus is very
  453.        sensitive to the text information included in the TINYHOST.WEL
  454.        screen that the remote system displays on connect (assuming one
  455.        has been created). The following strings (minus the double
  456.  
  457.  
  458.  
  459.                                      Page 5
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.        quotes), if they appear in the remote system's TINYHOST.WEL file,
  467.        can cause TinyHost Plus to fail to logon:
  468.  
  469.                         "Enter First Name"
  470.                         "Enter Password"
  471.                         "<ENTER>"
  472.                         "Select"
  473.  
  474.  
  475.  
  476.        4.0   MISCELLANEOUS
  477.  
  478.        4.1   What is Shareware?
  479.  
  480.            TinyHost Plus is being released as Shareware, which means
  481.        that you can try the program out *before* you buy it and make
  482.        sure that it will do what you want. If you find it of use, you
  483.        are requested to mail a contribution ($35 suggested) to the
  484.        author to support the continued development of this and other
  485.        products. Please send a check or money order (U.S. funds only)
  486.        to:
  487.  
  488.                                 Bruce A. Krobusek
  489.                                 5950 King Hill Drive
  490.                                 Farmington, NY  14425
  491.  
  492.            For your $35 you will receive the latest registered version
  493.        of TinyHost Plus on either 5 1/4 (360K) or 3 1/2 (720K) media
  494.        (please specify). The registered version of TinyHost Plus has the
  495.        same functionality as the Shareware version, but the text
  496.        requesting contributions will be removed. The start-up and exit
  497.        delays will also be removed. You will also receive a registered
  498.        version of the next major release of TinyHost Plus, and
  499.        notifications of future upgrades. Registered users of TinyHost
  500.        can upgrade to TinyHost Plus for $10.
  501.  
  502.            A ready-to-print registration form has been included with
  503.        TinyHost Plus. Simply print out THP-REG.FRM using the DOS PRINT
  504.        command, fill it out, and return it with your check or money
  505.        order.
  506.  
  507.            For those interested, quantity discounts are available.
  508.        Custom versions of TinyHost Plus can also be created. Contact the
  509.        author for more information.
  510.  
  511.  
  512.        4.2   Distributing TinyHost Plus
  513.  
  514.            Even though TinyHost Plus is Shareware it remains a
  515.        copyrighted program. As such, it may be freely copied and
  516.        distributed under the following guidelines:
  517.  
  518.            * The author retains the sole right to sell the program
  519.              for a profit.
  520.            * The author grants users the right to copy and distribute
  521.              TinyHost Plus so long as all program and documentation
  522.              files remain unaltered and are distributed as a group.
  523.            * The program may not be bundled with any other hardware
  524.  
  525.                                      Page 6
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.              or software without the permission of the author.
  533.            * Recognized users groups may charge a maximum of $5 for
  534.              duplication and/or distribution of TinyHost Plus.
  535.  
  536.            Registered users are requested to distribute only the
  537.        Shareware (Unregistered) version of TinyHost Plus. There is no
  538.        difference in functionality, but the Shareware version reminds
  539.        the user to register.
  540.  
  541.  
  542.        4.3   License Agreement
  543.  
  544.            Unregistered users are granted a 60-day evaluation period.
  545.        After that time, they are expected to either register TinyHost
  546.        Plus or cease using it.
  547.  
  548.            Registered users may use TinyHost Plus on more than one
  549.        machine, as long as there is no possibility of more than one copy
  550.        being in use at a time. Site licenses are available.
  551.  
  552.  
  553.        4.4   Warranty Information
  554.  
  555.            The author (Bruce A. Krobusek) disclaims all warranties
  556.        expressed or implied as to the quality and performance of this
  557.        program (TinyHost Plus). The author will not be held liable for
  558.        any lost profits, lost savings, or any other direct, indirect,
  559.        incidental, or consequential damages resulting from the use of
  560.        this program. Your use of this program constitutes your agreement
  561.        to this disclaimer and your release of the author from any form
  562.        of liability or litigation.
  563.  
  564.  
  565.        4.5   Program Support
  566.  
  567.            Now that the legal technicalities are out of the way, let me
  568.        state that I have done my best to ensure that TinyHost Plus is
  569.        error free. However, that is not to imply that one might not find
  570.        errors that have been missed. If a problem should be found,
  571.        contact me through one of the avenues mentioned below and I will
  572.        do my best to correct it. Naturally, the more information that
  573.        can be supplied as to the nature of the bug the better chance I
  574.        will have of finding and squashing it!
  575.  
  576.            I am also interested in receiving any comments or suggestions
  577.        regarding TinyHost Plus. Although I have a few ideas for upcoming
  578.        enhancements, I am always interested in hearing what other people
  579.        think of this program.
  580.  
  581.            Here are some methods that can be used in contacting me,
  582.        starting with the most preferable:
  583.  
  584.            Micro Science BBS - (716) 594-1804  USR Dual Standard /
  585.                 V.32bis. This Bulletin Board is located in
  586.                 Rochester, NY, and is run by Larry Helber. The
  587.                 latest version of TinyHost Plus will always be
  588.                 available as a free download. Do a file search (Z)
  589.                 and scan for TINYHOST, or download THP*.ZIP. There
  590.  
  591.                                      Page 7
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                 is also a TinyHost support conference where messages
  599.                 can be left and received. No BBS registration is
  600.                 required for TinyHost Plus download or support.
  601.  
  602.            Intelec Network - This is a national BBS network
  603.                 (Micro Science is a member). There are nodes all
  604.                 over the U.S. and Canada, with a few starting to
  605.                 appear in other nations. I will monitor the
  606.                 Communications, Shareware, and Central conferences
  607.                 for any mail addressed to me. Please try to spell
  608.                 my name correctly or I may not be notified of a
  609.                 message. The latest Intelec node (BBS) list has
  610.                 been included as IN-NODE.LST. There is probably
  611.                 a BBS that carries Intelec near you.
  612.  
  613.            CompuServe Informational Services - My account number
  614.                 is 74106,1335. I usually logon daily.
  615.  
  616.            GEnie - General Electric Network for Information Exchange
  617.                 My account name is B.KROBUSEK. I usually logon
  618.                 once a week or so.
  619.  
  620.            Internet - via CompuServe:
  621.                         74106.1335@compuserve.com
  622.  
  623.            Home Address - 5950 King Hill Drive
  624.                           Farmington, NY  14425
  625.  
  626.  
  627.  
  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.                                      Page 8
  658.  
  659.