home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / lan / partnr50.arc / PARTNERS.DOC < prev    next >
Text File  |  1989-07-03  |  88KB  |  2,746 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                EQUAL PARTNERS
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                             Virtual disk system
  27.  
  28.                                 Version 5.00
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                    K.eeping I.nformation S.haring S.imple
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.        "If you know DOS then you already know how to use Equal Partners."
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.            COPYRIGHT (c)  1986, 1987, 1988, 1989 by Downlink Systems
  54.               ALL RIGHTS RESERVED
  55.  
  56.  
  57.  
  58.        This document describes the EQUAL PARTNERS virtual disk  system,
  59.       which was created by Downlink Systems, in December of 1986.
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                              THE PRIME RULE
  67.                             ----------------
  68.  
  69.            ALWAYS BACK UP ANY DISK, WITH DATA ON IT, THAT  YOU CANNOT
  70.            --------------
  71.  
  72.            RECREATE IN A TIMELY AND COSTLY MANNER OR WHOSE LOSS, EVEN
  73.  
  74.            FOR A  SHORT PERIOD OF TIME,  WOULD HAVE A  SERIOUS IMPACT
  75.  
  76.            ON YOUR NORMAL FLOW OF BUSINESS.
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.    DISCLAIMER OF ALL WARRANTIES AND LIABILITY
  104.    ------------------------------------------
  105.  
  106.    Downlink Systems  ("supplier") makes no warranties, either expressed
  107.    or implied, with respect to this documentation or with respect to the
  108.    software  described in  this  publication,  its quality,  performance,
  109.    merchantability or  fitness for any particular purpose. The software is
  110.    sold or licensed "as is". The entire risk as to its quality and performance
  111.    is  with the buyer. Should the programs prove defective following their
  112.    purchase, the buyer  (and not the suppliers, not  their distributor  or
  113.    retailer) assumes the  entire cost of  all necessary servicing, repair,
  114.    or correction and any incidental or  consequential damages. In no  event
  115.    will suppliers be liable for direct, indirect, incidental or consequential
  116.    damages resulting from any defect in the software, even if suppliers have
  117.    been advised of the possibility of such damages. Some states do not allow
  118.    the exclusion  or  limitation of  implied warranties  or  liability  for
  119.    incidental or consequential damages, so the above limitation or exclusion
  120.    may not apply to you.
  121.  
  122.  
  123.  
  124.                                     i
  125.  
  126.                                   INDEX
  127.                                  -------
  128.  
  129.            Disclaimer  ......................................    i
  130.  
  131.            Index       ......................................    ii
  132.  
  133.            Introduction .....................................    iii
  134.  
  135.        I.  WHAT IS EQUAL PARTNERS ...........................     1
  136.  
  137.       II.  WHY USE EQUAL PARTNERS ...........................     1
  138.  
  139.      III.  HOW DO YOU ACQUIRE USAGE RIGHTS ..................     2
  140.  
  141.       IV.  HOW DO YOU USE EQUAL PARTNERS ....................     3
  142.  
  143.        V.  DAILY USAGE ......................................     4
  144.  
  145.       VI.  REQUIREMENTS .....................................     5
  146.  
  147.      VII.  INSTALLATION  ....................................     6
  148.  
  149.                Server   .....................................     7
  150.                Remote   .....................................     8
  151.  
  152.      VIII  REMOTE SHUTDOWN - EXPLAINED ......................    11
  153.  
  154.      IX.   VIRTUAL WRITE PROTECTION - EXPLAINED .............    12
  155.  
  156.      X.    VIRTUAL PRINTER  - EXPLAINED .....................    13
  157.  
  158.      XI.   STATISTICS  - EXPLAINED ..........................    14
  159.  
  160.      XII.  RAMDISK SUPPORT  .................................    15
  161.  
  162.      XIII  PROGRAM  EXECUTION RESTRICTIONS ..................    16
  163.  
  164.      XIV.  DISK DRIVE MAPPING  ..............................    17
  165.  
  166.      XV.   HOW SOME CUSTOMERS ARE USING EQUAL PARTNERS ......    21
  167.  
  168.      XVI   PROGRAM UPDATE SERVICE  ..........................    22
  169.  
  170.      XVII  VERSION NUMBERS  .................................    23
  171.  
  172.      XVIII TECHNICAL REQUIREMENTS AND NOTES .................    24
  173.  
  174.            Appendix A - Program Messages ....................    A1
  175.  
  176.            Appendix B - Site License ........................    B1
  177.                       - Commercial License agreement.........    B2
  178.  
  179.            Appendix C - Ordering ............................    C1
  180.                       - Credit card ORDERS ONLY:1-800 .......    C2
  181.  
  182.            Appendix D - Comments ............................    D1
  183.  
  184.            Appendix E - Mailing  ............................    E1
  185.  
  186.                                    ii
  187.  
  188.  
  189.  
  190.                                   INTRODUCTION
  191.  
  192.  
  193.  
  194.       EQUAL PARTNERS is the copyrighted property of Downlink Systems.
  195.       You are granted a limited license to use , and to copy it and
  196.       distribute it, provided that the following conditions are met:
  197.  
  198.       1) No fee may be charged for such copying and distribution.
  199.  
  200.       2) EQUAL PARTNERS may ONLY be distributed in its original, unmodified
  201.          state.
  202.  
  203.       Contributions for the use of this program will be appreciated, and
  204.       should be sent -
  205.                               Downlink Systems
  206.                               c/o D. Conner
  207.                               1377 K. STREET N.W.
  208.                               SUITE 189
  209.                               WASHINGTON D.C.
  210.                                               20005
  211.  
  212.       You MAY NOT use this product in a commercial environment or a
  213.       governmental organization without paying a license fee of $40.
  214.  
  215.       A program disk ,printed documentation and 'special' parallel
  216.       adapter are available for $40.00 U.S. only.
  217.  
  218.       See the order form in the back of this manual for more details.
  219.  
  220.  
  221.       EQUAL PARTNERS is user supported software.  This means that you may
  222.       copy the shareware version freely and give the copies away to anyone
  223.       you wish, at no cost. They in turn are requested to send in a contri-
  224.       bution if they decide to use it.
  225.  
  226.       The user supported software concept (often referred to as shareware)
  227.       is an attempt to provide software at low cost.  The cost of offering a
  228.       new product by conventional means is staggering, and hence dissuades
  229.       many independent authors and small companies from developing and
  230.       promoting their ideas.  User supported software is an attempt to
  231.       develop a new marketing channel, where products can be introduced at
  232.       low cost.
  233.  
  234.       If user supported software works, then everyone will benefit.  The
  235.       user will benefit by receiving quality products at low cost, and by
  236.       being able to "test drive" software before purchasing it.
  237.        The author benefits by being able to enter the commercial software
  238.       arena without first needing large sources of venture capital.
  239.  
  240.       But it can only work with your support.  We're not just talking about
  241.       EP here, but about all user supported software.  If you obtain a user
  242.       supported program from a friend or colleague, and are still using it
  243.       after a couple of weeks, then it is obviously worth something to you,
  244.       and a contribution should be sent. Upon receipt of a contribution,
  245.       you become a registered user and will receive a "full" feature, serial-
  246.       ized version of EQUAL PARTNERS.
  247.  
  248.                                    iii
  249.  
  250.  
  251.  
  252.  
  253.  
  254.    I. WHAT IS EQUAL PARTNERS.
  255.       -----------------------
  256.  
  257.         Equal Partners is a software solution to the problem of sharing data
  258.       between 5 1/4 floppy based PCs and the new IBM PS/2s, convertibles,
  259.       lap-tops that use the 3 1/2 floppy drives  (720K and 1.4 meg) ,
  260.       between different PCs with dissimilar disk(ette) storage media,
  261.       or between different PCs with identical recording media!.
  262.  
  263.         Equal Partners addresses this problem by using inexpensive RS-232
  264.       serial or parallel adapters.  Software device drivers and communication
  265.       programs attach the physical devices of one PC to the DOS operating
  266.       system of another PC. These physical devices become an extension of and
  267.       to the operating system of the other PC so that all DOS functions that
  268.       use a device letter, to access data, function without concern that
  269.       these 'virtual' devices are not truly physically attached to the
  270.       floppy/hard disk controller cards and printers.
  271.  
  272.  
  273.   II. WHY USE EQUAL PARTNERS
  274.       ----------------------
  275.  
  276.        Equal Partners provides a cost effective solution, as opposed to
  277.       other similar commercially available products, or to the hardware
  278.       solution that IBM provides. IBM's solution is an external 5.25 drive
  279.       and requires an additional out-of-pocket expense in the neighborhood
  280.       of $400.00. Equal Partners allows you to try its low cost solution
  281.       for a reasonable time.
  282.  
  283.  
  284.        We are sure you would rather use the $400.00 you saved, to invest,
  285.       expand and/or enrich your life in other ways.
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.                                     - 1 -
  311.  
  312.  
  313.  
  314.  III. HOW DO YOU ACQUIRE USAGE RIGHTS TO EQUAL PARTNERS.
  315.       ---------------------------------------------------
  316.  
  317.        Equal Partners is not totally free, a small contribution is asked
  318.       to allow the authors to feel that their efforts did not fall on
  319.       unfertile ground.
  320.  
  321.        The contribution can consist of several forms:
  322.  
  323.        FOR INDIVIDUALS
  324.        ----------------
  325.  
  326.           1). Monetary
  327.               --------
  328.  
  329.              A registration and usage fee of $40.00 is asked, of individuals.
  330.             This will provide you with notices of  upgrades and fixes, as well
  331.             as allow you access to a version supporting additional com and
  332.             prallel ports and faster transfer speeds plus other additional
  333.             features.
  334.  
  335.              You may now call a 1-800 number to place a credit card order.
  336.  
  337.  
  338.           2). Personal - applies to usage of "restricted usage" version
  339.               --------
  340.  
  341.              Another alternative, if money is a major negative factor, is that
  342.             we deeply request that you give a part of yourself. Instead of a
  343.             pound of flesh, a donation to  your local Red Cross of 1 pint of
  344.             blood so that another may 'profit' from your 'gain'/'loss'. This is
  345.             the least  contribution asked and expected. Again, this request
  346.             applies to  you if you  continue to  use the 'restricted usage'
  347.             Shareware version, without registering.
  348.  
  349.  
  350.         FOR COMPANY
  351.         ------------
  352.  
  353.           1). Monetary
  354.               --------
  355.  
  356.                For businesses, that benefit from additional utility and time/
  357.               cost savings, a PER COPY or site-license is available and REQUIRED
  358.               ,otherwise, NO usage license is granted, and any use is strictly
  359.               prohibited.
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.                                     - 2 -
  374.  
  375.  
  376.  
  377.  
  378.  
  379.   IV. HOW DO YOU USE EQUAL PARTNERS
  380.       -----------------------------
  381.  
  382.        First read the section on REQUIREMENTS, to see if your machine
  383.       and its hardware configuration can meet the necessary requirements.
  384.  
  385.        Secondly, install Equal Partners (see INSTALLATION section). Now the
  386.       easy part begins.
  387.  
  388.        You say, "nothing is ever easy". We say , "if you know DOS then you
  389.       know how to use Equal Partners".
  390.  
  391.        Granted you may not, yet, be a "POWER USER", but we bet you know how
  392.       to see what's on your disks, does the "DIR" command ring a bell. Now that
  393.       you know what's there, we also bet you got it there with the DOS "COPY"
  394.       command or someone did. Starting to catch on yet, we haven't tried to
  395.       teach you any new convoluted commands with unfamiliar structure and
  396.       syntax , have we. Guess what!!. You have just graduated from the ACME
  397.       self study and enlightenment course that certifies you as a "POWER USER"
  398.       of Equal Partners. Take a break, you deserve it. Oh, come back later
  399.       to get your EPPU 'certificate of achievement'.
  400.  
  401.        Back so soon?.
  402.  
  403.       Now to the serious business side of matters. You have all this data
  404.       , in some form or another, and you need to :
  405.  
  406.              consolidate/manipulate/share/archive/transport
  407.  
  408.       it between/among/with/to another/same media on another PC.
  409.  
  410.        Being a Equal Partners "POWER USER" (EPPU), you know that all you
  411.       have to do is use the DOS "COPY" command. So, do it, and give yourself
  412.       a pat on the back for a job well done.
  413.  
  414.        We could go on with how to use the other DOS commands, but we are
  415.       sure you are ahead of us already. What more can we say, in 25 words
  416.       or less, that would not confuse you. Again let us stress, if you
  417.       need to access data on the 'server' PC, just use the DOS commands
  418.       and the disk drive letters of the 'virtual drives' that are now
  419.       logically attached to your PC.
  420.  
  421.        Also, we are sure that you have guessed by now, that if you can
  422.       tell DOS where to get the data you need, for a program it should
  423.       be just as easy. Sure is, just 'tell' the program that the data it
  424.       needs is on one of the 'virtual drives' and business should
  425.       continue as always (unless that 'break-even' analysis formula
  426.       in the spreadsheet is in error).
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.                                     - 3 -
  436.  
  437.  
  438.    V. DAILY USAGE
  439.       ------------
  440.  
  441.        The daily use of EQUAL PARTNERS  begins with typing in the following
  442.       command on the "remote" or including it in a batch file:
  443.  
  444.                 EQUAL /device /port
  445.  
  446.        The daily use of EQUAL PARTNERS  begins with typing in the following
  447.       command on the "server" or including it in a batch file:
  448.  
  449.                 PARTNERS  /device /port
  450.  
  451.  
  452.         (where: '/device'  is  '/C' or '/L',  and  '/port'  is  '1' or '2'.)
  453.  
  454.  
  455.        (Consult the INSTALLATION section for additional command options.)
  456.  
  457.  
  458.        Then, ANY DOS command or software package (menu, shell..etc) that
  459.       uses DOS to perform file related functions will be able to perform
  460.       these same functions on the "virtual" devices,  such as disks or
  461.       printers.
  462.  
  463.        (for example: 1DIR, NORTON, PCTOOLS, AUTOMENU, DBASE, WP..ETC)
  464.  
  465.  
  466.        To return to DOS on the "server", once PARTNERS is running, press
  467.       the "ESC" key.
  468.  
  469.  
  470.        A WARNING: NEVER return to DOS, on the "server" if you still have
  471.                  files in use from the "remote". Always exit the applica-
  472.                  tion(s) on the "remote" before shutting down PARTNERS on
  473.                  the server.
  474.  
  475.  
  476.  
  477.        You may then re-activate the link to the "remote" from the server,
  478.       (at any time) by again typing in the command: PARTNERS.
  479.  
  480.  
  481.        Once EQUAL is running , in resident mode, on the "remote", you may
  482.       inquire as to the original install environment and option settings
  483.       by typing in the command :
  484.  
  485.                  EQUAL
  486.  
  487.        The EQUAL operating mode on the "remote" may be changed at any time,
  488.        by typing in the command:
  489.  
  490.                  EQUAL  option-setting
  491.  
  492.        with the correct option setting. Some options act as on/off switches,
  493.        in that if specified will turn the option on (if off) or off (if on).
  494.        The current status of options displayed , reflects the processing
  495.        state AFTER all command line options are processed.
  496.  
  497.                                     - 4 -
  498.  
  499.  
  500.  
  501.   VI. REQUIREMENTS
  502.       ------------
  503.  
  504.       The hardware requirements are:
  505.  
  506.           1). Your machine must be an IBM PS/2,PC/XT/AT or highly compatible,
  507.              including laptops and convertibles.
  508.  
  509.           2). The machine uses an 8250 uart,or compatible, to handle
  510.              the RS232C communications. This requirement is now verified
  511.              by the Equal Partners software.
  512.  
  513.           3). The machine uses a parallel adapter card that can support
  514.              bi-directional transfer. Not all parallel cards were manufactured
  515.              to function as required by Equal Partners. Most clone parallel
  516.              cards you can buy today will allow Equal Partners to be run
  517.              to utilize the parallel port feature. You may have to upgrade
  518.              your parallel cards (most are available for $20-$30).
  519.  
  520.           4). The RS232C cable must have pins 2 and 3 crossed or
  521.              a straight thru cable with a null modem (see diagram),
  522.              for serial ONLY.
  523.  
  524.              NOTE: a 'null modem' is NOT a real modem but only a cable with
  525.                   a special wiring arrangement.
  526.  
  527.                                -or-
  528.  
  529.               A 'special' parallel adapter is supplied by DownLink Systems
  530.              when you register. The adapter attaches to any 25-pin serial
  531.              cable. A well insulated cable is recommended for maximum distance
  532.              between PC. Ten (10) feet is the normal maximum distance with a
  533.              good shielded cable.
  534.  
  535.           5). The machine uses the port addresses at memory location
  536.              0:400. The port addresses are normally 03F8 for COM1,
  537.              and 02F8 for COM2 (depending on hardware setup).
  538.  
  539.                                   -or-
  540.  
  541.               The machine uses the port addresses at memory locations
  542.              0:408, for the parallel option. The port address are normally
  543.              03BC for LPT1 and 0378 for LPT2.
  544.  
  545.           6). The disk media must be DOS formatted, in other words
  546.              the boot sector must contain the BPB info that describes
  547.                              -------------------------
  548.              the media (the media type in the FAT is not used). Some
  549.              vendors that format their own disks do not bother to put
  550.              the BPB info in logical sector 0, even thought the DOS 3.2
  551.              Technical Ref. manual says that DOS will no longer rely
  552.              on the Media code in the FAT to determine the device
  553.              characteristics. This requirement has been relaxed by EP
  554.              version 5.00.
  555.  
  556.            6). As always, sufficient memory must be available.
  557.  
  558.  
  559.  
  560.                                     - 5 -
  561.  
  562.  
  563.       The software requirements are:
  564.  
  565.           1). The operating system must be PC DOS 2.0 or above.
  566.  
  567.               This product has been tested on PC DOS 2.0 , 2.10,
  568.              3.00, 3.10, 3.20, 3.21 , 3.30 and DOS 4.0x and some versions
  569.              of MS DOS.
  570.  
  571.           2). The PC DOS versions running on both the "server" and
  572.              the "remote(s)" MUST/SHOULD be identical!!.
  573.  
  574.               If the server and remote(s) are running different versions
  575.              of DOS, the PC with the LATEST version of DOS MUST be
  576.                                                            ----
  577.              configured as the "REMOTE". This will INSURE that your
  578.              disk(ette)s will not be destroyed.
  579.  
  580.              (NOTE: The ABOVE ESPECIALLY applies to ROM based DOS PCs)
  581.               --------------------------------------------------------
  582.              ALWAYS do the DOS command, DIR, on each of the disks on
  583.              ------
  584.              the server. If the reply to the DIR is garbled or you do not
  585.              think/know it is correct then DO NOT attempt any DOS commands
  586.              that transfers data to/from the remote and the server.
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.                                    - 5a -
  623.  
  624.  
  625.  
  626.  VII. INSTALLATION
  627.       ------------
  628.  
  629.       Equal Partners consists of the following files:
  630.  
  631.             50-50.SYS       -  device driver
  632.  
  633.             EQUAL.COM       -  communication program
  634.  
  635.             PARTNERS.COM    -  communication program
  636.  
  637.             PARTNERS.DOC    -  this documentation
  638.  
  639.             SERVER.BAT      -  example batch file, with ERRORLEVEL checking
  640.  
  641.             REMOTE.BAT      -  example batch file, with ERRORLEVEL checking
  642.  
  643.             README.DOC      -  revision history and additional comments
  644.  
  645.             ????????.???    -  any additional files as the product matures
  646.  
  647.  
  648.        Installation assumes two PCs, and the need to exchange data
  649.       between the PCs. One PC will be designated the 'server' PC
  650.       and the other PC(s) the 'remote' PC(s).
  651.  
  652.  
  653.        The PARTNERS.COM program may be loaded on and is normally run
  654.       from the 'server' PC. The 'server' PC could be considered the 'base'
  655.       PC in that it would normally contain all the master database and
  656.       spreadsheet programs and files. The 'remote' PC(s) could be lap-tops
  657.       that individuals had taken 'on-the-road' with them to gather data,
  658.       for updating to the 'server' databases..etc.
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.                                     - 6 -
  685.  
  686.  
  687.  
  688.       So, installation on the 'server' of PARTNERS.COM consists of
  689.                        --------------
  690.  
  691.          1). Copying PARTNERS.COM to a directory in the DOS path,
  692.              and typing the command , 'PARTNERS' or including it in
  693.              a DOS batch file (SEE the batch file "SERVER.BAT" included).
  694.  
  695.  
  696.              Command format:
  697.              ---------------
  698.  
  699.  
  700.                PARTNERS /option/option...
  701.  
  702.                at a mininum the type of adapter (serial/parallel) and
  703.               port, options , MUST be specified at installation.
  704.  
  705.  
  706.              OPTION
  707.              ------
  708.               /C   - uses serial card to be used as "bridge" to communicate
  709.                     with the remote (EQUAL).
  710.  
  711.               /L   - uses parallel card to be used as "bridge" to communicate
  712.                     with the remote (EQUAL).
  713.  
  714.               /1   - causes COM1 or LPT1 to be used as "bridge" to communicate
  715.                     with the remote (EQUAL).
  716.  
  717.               /2   - causes COM2 or LPT2 to be used as "bridge" to communicate
  718.                     with the remote (EQUAL).
  719.  
  720.               /D   - allow server (PARTNERS) to be shutdown from a remote.
  721.                     (this option may be turned on/off while PARTNERS running)
  722.  
  723.               /Q   - QUITE mode, don't display "logo" or other messages, except
  724.                     errors.
  725.  
  726.               /P   - allow server (PARTNERS) to process print from a remote
  727.                     (this option may be turned on/off while PARTNERS running)
  728.  
  729.               /W   - allows or inhibits writing to disk drives by a remote.
  730.                     Effectively same as placing a write-protect tab on a disk.
  731.                     (this option may be turned on/off while PARTNERS running)
  732.  
  733.               /H   - display a HELP screen (all other options are ignored)
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.             Note: The DEFAULT option settings are "off" unless noted otherwise.
  741.  
  742.             Note: the install results may be tested in a batch file with
  743.                   the ERRORLEVEL statement (SEE file "SERVER.BAT).
  744.  
  745.  
  746.                                     - 7 -
  747.  
  748.  
  749.       Now, installation on the 'remote' consists of
  750.                         --------------
  751.  
  752.           1). Including the following command in 'CONFIG.SYS'
  753.  
  754.  
  755.               DEVICE=50-50.SYS  'z' additional disk drives requested
  756.  
  757.               (where 'z' can be any number from 1 to 8, default=1)
  758.  
  759.           2). Re-boot, press CTRL-ALT-DEL or power off the remote PC, and
  760.              power PC back on . This causes the "50-50.sys" statement to
  761.              add the additional 'virtual' disk drives to the 'remote' PC.
  762.  
  763.               Now continue with the next step, below.
  764.  
  765.            Note: steps 1 and 2 (above) are only necessary when EP is
  766.                 initially installed.
  767.  
  768.           3). Copying EQUAL.COM to a directory in the DOS path
  769.               and typing the command, 'EQUAL' or including it in
  770.               a DOS batch file (SEE batch file "REMOTE.BAT" included).
  771.  
  772.             Command format:
  773.             ---------------
  774.  
  775.                EQUAL  /option/option..
  776.  
  777.                at a mininum the type of adapter (serial/parallel) and
  778.               port, options , MUST be specified at installation.
  779.  
  780.             OPTION
  781.             ------
  782.              /C   - uses serial card to be used as "bridge" to communicate
  783.                     with the server (PARTNERS)
  784.  
  785.              /L   - uses parallel card to be used as "bridge" to communicate
  786.                     with the server (PARTNERS)
  787.  
  788.              /1   - causes COM1 or  LPT1 to be used as "bridge" to communicate
  789.                     with the server (PARTNERS).
  790.  
  791.              /2   - causes COM2 or LPT2 to be used as "bridge" to communicate
  792.                     with the server (PARTNERS).
  793.  
  794.              /N   - Normal processing mode. This is the DEFAULT. ONLY mode
  795.                    supported when parallel is selected.
  796.  
  797.              /T   - Turbo  processing mode. It is 4-5 times faster than
  798.                     Normal mode (for serial ONLY)
  799.  
  800.              /D   - send request to server (PARTNERS) to shutdown and return
  801.                     to DOS. May only be requested once EQUAL installed.
  802.  
  803.              /P   - directs the remotes LPT1 print to the server or remote.
  804.  
  805.              /Q   - QUITE mode, don't display "logo" or other messages, except
  806.                    errors.
  807.  
  808.              /H   - display a HELP screen (all other options are ignored)
  809.  
  810.                                     - 8 -
  811.  
  812.  
  813.  
  814.           NOTE: The processing modes "N","T" may be changed at any time
  815.                after EQUAL has been installed, just by specifying the new
  816.                option on the command line (for serial ONLY).
  817.  
  818.  
  819.                 The TURBO mode applies ONLY to usage of the serial port.
  820.                     ---------------------------------------------------
  821.  
  822.                 The NORMAL mode is the SAFEST mode in a mixed PC hardware
  823.                configurations. The TURBO mode is the FASTEST, but you may
  824.                experience some errors in a mixed PC hardware configuration
  825.                linking totally dissimilar PCs.
  826.  
  827.                 For example, linking a 10+ mhz AT class PC to a 4.77 mhz
  828.                class PC  may cause problems in TURBO mode, if so switch
  829.                to NORMAL mode and everything WILL be OK. If the hardware
  830.                speed of the PCs are within a few mhz of each other, then
  831.                TURBO mode would be your best operating mode.
  832.  
  833.  
  834.           NOTE: The re-direction of local remote print to the server may
  835.                be turned on/off at any time after EQUAL is installed, just
  836.                by specifying the "/P" option on the command line. You don't
  837.                need a physical printer LPT1 on the remote to use printer
  838.                re-direction to server option. If you do though, the remotes
  839.                local LPT1 is temporarily overridden (disabled) until the
  840.                "/P" is again entered. Printer output cannot be directed
  841.                to the same parallel port EQUAL PARTNERS is using as a 'bridge'
  842.                to the other PC.
  843.  
  844.                 Specifying the "/D" option no longer automatically turns off
  845.                printer re-direction (if on) and returns LPT1  printer support
  846.                to DOS on the remote. Printer re-direction MUST be turned off
  847.                before a remote shutdown request will function.
  848.  
  849.           NOTE: The options, "/D" and "/P" require that the corresponding
  850.                options be turned "on" at the server, otherwise the
  851.                operation of these options are ignored (or return error
  852.                condition) by the server.
  853.  
  854.           NOTE: The options default settings are "off" unless noted
  855.                otherwise.
  856.  
  857.           NOTE: the install results may be tested in a batch file with
  858.                the ERRORLEVEL statement (SEE file "REMOTE.BAT).
  859.  
  860.  
  861.           NOTE:  including a "{" or "(" or "[" on the command line, will
  862.                 make the rest of the command line serve as "remarks",so that
  863.                 you can add comments at the end of the valid parameters.
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.                                     - 9 -
  873.  
  874.  
  875.  
  876.         Once installed , any DOS command that would normally access data
  877.        using a drive designation, will be able to read/write data from
  878.        one PC to the other PC(s). What this means is that you can 'COPY',
  879.        'ERASE', 'RENAME', 'PATH', and execute programs to/on/from the
  880.        'virtual' drives without any new commands or procedures.
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.         If you know DOS then you already know how to use Equal Partners.
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.                                    - 10 -
  935.  
  936.  
  937.  
  938.  
  939.  VIII REMOTE SHUTDOWN - EXPLAINED.
  940.       ---------------------------
  941.  
  942.  
  943.        The term 'remote shutdown' refers to the act of the server (PARTNERS)
  944.       shutting down (returning to DOS) at the request of a remote (EQUAL)
  945.       PC. This option has been added to EQUAL PARTNERS as the result of
  946.       several inquiries into this capability.
  947.  
  948.        First, this option must be 'turned on' at the server. This may be
  949.       done when the PARTNERS program is started, with the '/D' option or
  950.       pressing the appropriate function key after PARTNERS is running.
  951.  
  952.        This option may be toggled (turned off/on) at any time while
  953.       PARTNERS is running. You may only want to allow the server to be
  954.       shutdown when certain remotes are attached. The remote PC requests
  955.       the server to shutdown  by invoking the EQUAL command with the
  956.       '/D' option. The results of the remotes shutdown request to the
  957.       server may be tested in a batch file, using the DOS ERRORLEVEL
  958.       statement (see the REMOTE.BAT file included as an example)
  959.  
  960.        The ideal use of this option would be , for example, if the remote
  961.       PC(s) had transferred data to the server and the normal next step
  962.       would be for the server to process the data. The process could be
  963.       calling up a speadsheet or a database or a communications program
  964.       to further manipulate the data.
  965.  
  966.        So, to facilitate this repetitive process a batch file could be
  967.       set up to invoke PARTNERS and THEN when PARTNERS was shutdown
  968.       , the batch file could test the ERRORLEVEL code OR test for
  969.       the existence of the data files that should have been transferred.
  970.  
  971.        The batch file would then invoke any application necessary to
  972.       immediately process the data. After the application had processed
  973.       the data, PARTNERS could be automatically restarted to pass back the
  974.       results of the applications manipulation of the data.
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.                                    - 11 -
  997.  
  998.  
  999.  
  1000.  
  1001.   IX. VIRTUAL WRITE PROTECTION - EXPLAINED.
  1002.       -------------------------------------
  1003.  
  1004.  
  1005.        The term 'virtual write protection' refers to the refusal of the
  1006.       server (PARTNERS) PC to allow ANY disks (real or ram or otherwise)
  1007.       that it is aware of to be written to. The reason for this option
  1008.       is because, from a remotes viewpoint all server disks that it has
  1009.       access to are removable (much like a real floppy disk).
  1010.  
  1011.        You may want to restrict write/update access to the servers disks
  1012.       at any point in time. This may be the case where you only want the
  1013.       users whose remotes are attached to be able to only read data from
  1014.       the server.
  1015.  
  1016.        Virtual write protection is functionally the same as your putting
  1017.       that little silver/black write protect tab on a floppy disk or by
  1018.       moving the tab on a 3.5 micro floppy to the correct position.
  1019.  
  1020.        This option may be turned on when PARTNERS first started by adding
  1021.       the '/W' options to the PARTNERS command. Likewise this option may
  1022.       be toggled (turned off/on) after PARTNERS is running by pressing the
  1023.       appropriate function key.
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.                                    - 12 -
  1059.  
  1060.  
  1061.  
  1062.  
  1063.   X.  VIRTUAL PRINTER  - EXPLAINED.
  1064.       ------------------------------
  1065.  
  1066.  
  1067.        The term 'virtual printing' refers to the act of transferring output
  1068.       from an application (DOS or otherwise) to a physical printer that
  1069.       may or may not be attached to the remote PC.
  1070.  
  1071.        The printer is a 'virtual printer' if the printer is attached to
  1072.       the server and the remote PC re-directs its local printer LPT1
  1073.       to the server. This re-direction is accomplished by appending the
  1074.       '/P' option to the command : EQUAL. On the remote the '/P' option
  1075.       acts as a toggle (directs print to remote or server alternately).
  1076.  
  1077.  
  1078.  
  1079.  
  1080.        The server will only process the remotes re-directed print request
  1081.       if that service is 'on' at the server. Virtual printer support may
  1082.       be activated when PARTNERS is started by adding the '/P' option to
  1083.       the PARTNERS command or by pressing the appropriate function key
  1084.       after PARTNERS is started.
  1085.  
  1086.  
  1087.        The server wil NOT support remote printing if the parallel port
  1088.       is being used to 'bridge' the PCs and the SAME parallel port is
  1089.       trying to be used to write application output to a printer.
  1090.  
  1091.  
  1092.        The remote PRINT will stop printing to the server while the virtual
  1093.       disks are being accessed, but will automatically start back when the
  1094.       virtual disk accessing is through.
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.                                    - 13 -
  1121.  
  1122.  
  1123.  
  1124.  
  1125.   XI.   STATISTICS  - EXPLAINED
  1126.         -----------------------
  1127.  
  1128.  
  1129.        The 'server' (PARTNERS) machine maintains a count of the number of
  1130.       read/write requests made by the 'remote'. This count is for the number
  1131.       of sectors of data requested. A sector is normally 512 bytes. This is
  1132.       the smallest amount of data that is stored on a disk, even if you only
  1133.       create a 1 byte file. When you format a disk with the DOS FORMAT
  1134.       command , the disk is logically divided in groups of 512 bytes
  1135.       (called clusters).
  1136.  
  1137.        However , ram disks and other non-standard disks can have sector
  1138.       sizes of 128 or 256 bytes also (see the DOS VDISK command in your DOS
  1139.       manual).
  1140.  
  1141.        Equal Partners works at the DOS level to provide you with 'virtual'
  1142.       disks. If you transfer a file from the server to the remote, there
  1143.       is ADDITIONAL information required and transfered. DOS requires
  1144.       information from the servers directory as well as from the FAT table
  1145.       (File Allocation Table). So you can see, if you transfer a 32,000 byte
  1146.       file from the server to the remote, there is at least  2000-3000 bytes
  1147.       of additional information ALSO being transfered to allow DOS to find
  1148.       and catalogue the file you need (depending on disk size and DOS version).
  1149.  
  1150.        To correctly figure how many characters of information you are tranfer-
  1151.       ing per second to/from the server you MUST not only take into account
  1152.       the file size but ALSO the DOS overhead requirements.
  1153.  
  1154.        The basic formula for calculating the effective file transfer rate is:
  1155.  
  1156.  
  1157.         Characters per seconds= (((# sectors read + # sectors written)
  1158.                                   * units sector size)
  1159.                                + ((# control packets read + # packets written)
  1160.                                   * 20 bytes))
  1161.                                 / number of seconds to read/write data
  1162.  
  1163.  
  1164.        The accumulated usage counts may be displayed by pressing the 'F5' key
  1165.       , on the server PC. Pressing the 'F6' key will clear/reset the counts.
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.                                    - 14 -
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  XII. RAMDISK SUPPORT
  1188.       ---------------
  1189.  
  1190.  
  1191.        If you have a RAM disk, or other high-speed storage, then you can speed
  1192.       up EP  somewhat by telling DOS to read from/write to the RAM disk.
  1193.       You do this by substituting the drive letter of the RAM disk in all
  1194.       the DOS commands.  For example, if drive H: is your virtual RAM disk,
  1195.       then you would type:
  1196.  
  1197.            COPY H:*.*  D:
  1198.  
  1199.            (where D: could be a RAM disk on your 'remote' PC)
  1200.  
  1201.  
  1202.        RAM disks in real memory (memory below 640k) and RAM disks in extended
  1203.       memory  (memory above 1 meg on 80286 and 386 PCs) are supported on both
  1204.       the server and the remote(s).
  1205.  
  1206.       Refer to the DOS manual for more details about the DOS commands.
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.                                    - 15 -
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  XIII PROGRAM  EXECUTION RESTRICTIONS
  1250.       -------------------------------
  1251.  
  1252.  
  1253.        If you are using a Shareware version of EQUAL PARTNERS, and have not
  1254.       registered, then the following program execution restrictions
  1255.       apply:
  1256.  
  1257.              1). Only the serial port is supported.
  1258.  
  1259.              2). Only 19.2 baud transfer rate is available.
  1260.  
  1261.              3). Only "NORMAL" mode supported (approx 1kbyte transfer rate)
  1262.  
  1263.              4). Only sector mode transfer used (not block mode)
  1264.  
  1265.              5). Only one virtual drive may be specified in
  1266.                  config.sys.
  1267.  
  1268.              6). Only reading from the server is allowed.
  1269.  
  1270.                  You may only copy data "from" the server. You
  1271.                  may not perform any DOS function  that would
  1272.                  "write" to the server, including virtual printer.
  1273.  
  1274.              7). The starting drive, on the server, is always the
  1275.                  "A:" drive. This means that the first virtual
  1276.                  drive assigned on the "remote" is the first
  1277.                  physical drive accessed on the "server".
  1278.  
  1279.  
  1280.  
  1281.  
  1282.         The SHAREWARE version of EQUAL PARTNERS is NOT A DEMO version.
  1283.  
  1284.  
  1285.         The shareware version has ALL the functionality of the registered
  1286.        user version, but the Shareware version is not implemented to the
  1287.        same degree. The Shareware version is basically version 1.0 as it
  1288.        was initially distributed, to allow file transfers from a desktop
  1289.        PC to machines with 3.5 micro floppy drives, in a safe and reliable
  1290.        manner, with little or no relearning on the users part. The Share-
  1291.        ware version does this VERY well. If your requirements then grow
  1292.        such that you need FULL bi-directional PC-to-PC  data transfer
  1293.        capabilities at HIGH speeds (4-18 thousand bytes per second) with
  1294.        FULL error checking and recovery , and virtual printer support,
  1295.        then YOU have the option to register your Shareware version, so
  1296.        that you can address your new requirements.
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.                                    - 16 -
  1307.  
  1308.  
  1309.  
  1310.  XIV.  DISK DRIVE MAPPING
  1311.        -------------------
  1312.  
  1313.  
  1314.        This simple illustration shows how the drives and the letters
  1315.       assigned are mapped to the physical vs. virtual drives.
  1316.  
  1317.  
  1318.  
  1319.  
  1320.             'REMOTE'                                         'SERVER'
  1321.  
  1322.         +---------------+                                +---------------+
  1323.         |  +---------+ o|                                |  +---------+ o|
  1324.         |  |A:>dir C:| o|                                |  | Partners| o|
  1325.         |  |         |  |                                |  |   v5.00 |  |
  1326.         |  |Volume in|  |                                |  |Copyright|  |
  1327.         |  +---------+  |                                |  +---------+  |
  1328.         +---------------+                                +---------------+
  1329.    +------------------------+                       +------------------------+
  1330.    | IBM    o        o      |   Rs232  ----  cable  | IBM    +        o      |
  1331.    |  PC    --=--    --=--  | ---------|  |---------|  PC    --=--    --=--  |
  1332.    |                        |<--       ----         |                        |
  1333.    +------------------------+  |                    +------------------------+
  1334.               ^         ^      |        ^                      ^         ^
  1335.               |         |      |        |                      |         |
  1336.               |         |      |        |                      |         |
  1337.           Physical  Physical   |      Null                 Physical  Physical
  1338.           Drive A:  Drive B:   |     Modem                 Drive A:   Drive B:
  1339.                                |        |
  1340.                                |       or                      ^         ^
  1341.                                |    'special'                  |         |
  1342.                                |     parallel                  |         |
  1343.                                |     adapter                   |         |
  1344.                                |
  1345.                                ------------------------->  Virtual   Virtual
  1346.                                                            Drive C:  Drive D:
  1347.  
  1348.  
  1349.       There may be Ram disks on either or both the 'server' and  'remote'
  1350.      PCs. Ram disks are highly recommended, memory permitting, because this
  1351.      eliminates all the mechanical delays that real hardware drives exhibit,
  1352.      such as rotational delay, seek times and drive startup..etc.
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.                                    - 17 -
  1369.  
  1370.  
  1371.  
  1372.                              Usage Example NO. 1
  1373.  
  1374.  
  1375.  
  1376.        This simple illustration shows how EQUAL PARTNERS was used to
  1377.       dial a remote BBS, with PCTALK III  and transfer data to/from
  1378.       the "server" while BBS communications was maintained on the
  1379.       "remote". This example was actual used by the authors.
  1380.         We could also invision a BBS being run on the "remote" and the
  1381.       "server" being used as non-dedicated aux. storage for the BBS.
  1382.  
  1383.  
  1384.                 |
  1385.                 | ^
  1386.                 | |
  1387.                 | --------- to phone line
  1388.            +--------+
  1389.            |  o o o | <----- external modem
  1390.            +--------+
  1391.                 |
  1392.                 | Com2
  1393.                 |
  1394.                 |
  1395.             'REMOTE'                                         'SERVER'
  1396.  
  1397.         +---------------+                                +---------------+
  1398.         |  +---------+ o|                                |  +---------+ o|
  1399.         |  |A:>PC-TAL| o|                                |  | Partners| o|
  1400.         |  |         |  |                                |  |   v5.00 |  |
  1401.         |  |         |  |                                |  |Copyright|  |
  1402.         |  +---------+  |                                |  +---------+  |
  1403.         +---------------+                                +---------------+
  1404.    +------------------------+          Com1         +------------------------+
  1405.    | IBM    o        o      |   Rs232  ----  cable  | IBM    +        o      |
  1406.    |  PC    --=--    --=--  | ---------|  |---------|  PC    --=--    --=--  |
  1407.    |                        |          ----         |                        |
  1408.    +------------------------+                       +------------------------+
  1409.                                         or
  1410.  
  1411.                                        LPT1
  1412.  
  1413.                                      'special'
  1414.                                       parallel
  1415.                                       adapter
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.                                    - 18 -
  1431.  
  1432.  
  1433.  
  1434.                              Usage Example NO. 2
  1435.  
  1436.  
  1437.         This simple illustration shows how EQUAL PARTNERS could be used
  1438.        to collect data from various other PCs. As an example, lets say
  1439.        that you are in the insurance business. Your company has an AT
  1440.        in the home office and you have your agents out in the field
  1441.        taking orders and collecting premiums. The agents were given
  1442.        lap-tops , with 3.5 drives. Now you need to get the information
  1443.        stored on the lap-tops to the AT to update the databases.
  1444.  
  1445.         The PARTNERS half of EQUAL PARTNERS could be activated on the
  1446.        AT and as each agent comes in they just "plug" into the RS232
  1447.        cable attached to the AT. PARTNERS, on the AT, does not care what
  1448.        the other devices are on the end of the RS232 cable at any given
  1449.        time. PARTNERS will automatically adjust to the drive character-
  1450.        istics of what ever "remote" drive unit it reads. So, you can
  1451.        "plug" into the cable attached to the AT, then when through,
  1452.        "unplug" and "plug" in another "remote", whether it be a laptop
  1453.        with 3.5 drives, a laptop with an internal harddisk, or IBM PS/2,
  1454.        PC/XT/AT with a DOS formatted disk drive of some type.
  1455.  
  1456.                                 'SERVER'
  1457.                             +---------------+
  1458.                             |  +---------+ o|
  1459.                             |  | Partners| o|
  1460.                             |  |   v5.00 |  |
  1461.                             |  |Copyright|  |
  1462.                             |  +---------+  |
  1463.                             +---------------+
  1464.                        +------------------------+
  1465.                        | IBM   +----+   --=--   |
  1466.                        |  AT   |o   |   --=--   |
  1467.                        |       +----+           |
  1468.                        +------------------------+
  1469.                                      |
  1470.                                      |
  1471.                                   +-----+
  1472.                                   |     | <----- null modem
  1473.                                   +-----+           or
  1474.                                      |           'special' parallel adapter
  1475.                                      |
  1476.                                    mmmmm
  1477.  
  1478.  Agent "A"                                                             Agent "C"
  1479.            wwwww                      wwwww                       wwwww
  1480.              |                          |                           |
  1481.      +-------------+             +-------------+             +-------------+
  1482.      | +---------+ |             | +---------+ |             | +---------+ |
  1483.      | |A:>COPY  | |             | |A:>COPY  | |             | |A:>COPY  | |
  1484.      | |         | |             | |         | |             | |         | |
  1485.      | |         | |             | |         | |             | |         | |
  1486.      | +---------+ |             | +---------+ |             | +---------+ |
  1487.      +-------------+             +-------------+             +-------------+
  1488. +-----------------------+  +------------------------+  +-----------------------+
  1489. | IBM PS/2              |  | Zenith Laptop          |  | Toshiba Laptop        |
  1490. +-----------------------+  +------------------------+  +-----------------------+
  1491.  
  1492.                                    - 19 -
  1493.  
  1494.  
  1495.                              Usage Example NO. 3
  1496.  
  1497.         This simple illustration shows how EQUAL PARTNERS could be used
  1498.        to share data among various PCs. This example shows a "server"
  1499.        attached to a "switch box" by telephone wire. A switch box allows the
  1500.        manual switching of internal connections between one "common" and
  1501.        several other devices attached as "A","B","D" and "E" and such. The
  1502.        devices are connected through "C" and what ever setting the physical
  1503.        switch is pointing to. This arrangement could allow several PCs to
  1504.        be attached to a "server" and data updated on the "server" or the
  1505.        "server" used just to store the data prior to "switching" it to
  1506.        another PC. The "server' does not have to be dedicated, only activat-
  1507.        ed when actual data transfer is needed. This example was actually
  1508.        used by Downlink Systems and also by some of our customers.
  1509.  
  1510.                                 'SERVER'
  1511.                             +---------------+
  1512.                             |  +---------+ o|
  1513.                             |  | Partners| o|
  1514.                             |  |   v5.00 |  |
  1515.                             |  |Copyright|  |
  1516.                             |  +---------+  |
  1517.                             +---------------+
  1518.                        +------------------------+
  1519.                        | IBM   +----+   --=--   |
  1520.                        |  AT   |o   |   --=--   |
  1521.                        |       +----+           |
  1522.                        +------------------------+
  1523.                                      |
  1524.                                      |
  1525.     Twisted-pair wires               |            Twisted-pair wiring
  1526.    +with RS232/EIA adapters          |     <----- with RS232/EIA adapter
  1527.    |and all pins straight thru       |            and pins 2/3 crossed.
  1528.    |                                 |
  1529.    |                                 |
  1530.    |                        +----------------+
  1531.    |                        |        C       |
  1532.    |                        |       /        |
  1533.    |                        |      /         | <---------- Switch box
  1534.    |                        |  a  b     d  e |
  1535.    |                        +----------------+
  1536.    |                           ^  ^     ^
  1537.    |               (a)         |  |     |        (d)
  1538.    |         +------------------  |     ----------------------------+
  1539.    |         |                    |                                 |
  1540.    +------>  |                     +----+                           |
  1541.              |                          | (b)                       |
  1542.              |                          |                           |
  1543.      +-------------+             +-------------+             +-------------+
  1544.      | +---------+ |             | +---------+ |             | +---------+ |
  1545.      | |A:>DBASE | |             | |A:>COPY  | |             | |A:>WORD  | |
  1546.      | |         | |             | |         | |             | |         | |
  1547.      | |         | |             | |         | |             | |         | |
  1548.      | +---------+ |             | +---------+ |             | +---------+ |
  1549.      +-------------+             +-------------+             +-------------+
  1550. +-----------------------+  +------------------------+  +-----------------------+
  1551. | IBM PS/2        --=-- |  | Zenith Laptop          |  | Toshiba Laptop        |
  1552. +-----------------------+  +------------------------+  +-----------------------+
  1553.  
  1554.                                    - 20 -
  1555.  
  1556.  
  1557.   XV.  HOW SOME CUSTOMERS ARE USING EQUAL PARTNERS
  1558.        -------------------------------------------
  1559.  
  1560.        CASE 1.
  1561.        -------
  1562.  
  1563.           This customer has a PC that they use as a server and several
  1564.        PCs that are remotes. The customer wants the remote PCs to run
  1565.        a spreadsheet (Lotus 123) and when through to send the spreadsheet
  1566.        to the server. However, the PARTNERS part of Equal Partners is
  1567.        run on the server as a dedicated task. In otherwords, the server PC
  1568.        is tied up only running PARTNERS.
  1569.  
  1570.          The customer wanted to use the server PC also for his/hers own
  1571.        work and have the office staff send the data to the server at any
  1572.        time without reloading PARTNERS or dedicating the server to the task
  1573.        of just servicing the remotes.
  1574.  
  1575.         This customers solution was to run a commercial product that allows
  1576.        task switching. This task switching software was Software Carousel.
  1577.        Software Carousel allows multiple applications to be loaded into memory
  1578.        BUT only one to actually run at any one time, in the 640k of memory.
  1579.  
  1580.         This is exactly what the customer did, they loaded EQUAL PARTNERS
  1581.        along with several other tasks on the server and with just the press
  1582.        of a key could swap EP into and out of the active 640k, as the needs
  1583.        arose to transfer data from the remotes to the server.
  1584.  
  1585.        CASE 2.
  1586.        -------
  1587.  
  1588.          This customer also needed the server to be used as a non-dedicated
  1589.        machine, even though EQUAL PARTNERS normally requires the server to
  1590.        run as such.
  1591.  
  1592.          The customer went one step further and actually had multiple tasks
  1593.        running on the server while PARTNERS was also running. This was
  1594.        accomplished with a software package called, DESQVIEW,  performing
  1595.        and managing the multitasking environment on the server PC.
  1596.  
  1597.  
  1598.         NOW, a few notes on CASE 1 and CASE 2. Equal Partners was designed
  1599.        to be as well behaved as possible while running under DOS on a PC.
  1600.        In NORMAL processing mode this is true, however in TURBO mode EP
  1601.        takes exclusive use of the computer for short bursts of time.
  1602.  
  1603.         This exclusive use does not allow the computer to service any other
  1604.        tasks, if any, so in a multitasking environment Equal Partners or
  1605.        the other tasks may not co-exist as well or if all (in TURBO mode).
  1606.  
  1607.         Again, we note EQUAL PARTNERS is NOT a LAN of any kind, so YOU
  1608.        bear the responsibility of protecting your disks and their data if
  1609.        you choose to run EP in a shared machine/CPU environment. Basically
  1610.        you have the server and its applications looking at the disks on the
  1611.        server as if they had exclusive use. This is not the case with EP
  1612.        also accessing the server disks and also expecting that it has
  1613.        exclusive use of the data on the server, from the remote.
  1614.  
  1615.         However, if your computer hardware/software configuration works
  1616.        for you, safely, so much the better!
  1617.  
  1618.                                    - 21 -
  1619.  
  1620.  
  1621.  
  1622.  
  1623.   XVI. PROGRAM UPDATE SERVICE
  1624.        -----------------------
  1625.  
  1626.  
  1627.        A license to EP  entitles you to use all future Shareware versions. New
  1628.       "restricted usage"  versions  are generally available  through normal
  1629.       freeware distribution channels, and we prefer that you obtain them that
  1630.       way.
  1631.  
  1632.        A Program disk  containing the  latest version is  returned on every
  1633.       order of $40 or more.  If you wish to purchase a single-user license
  1634.       and want an update disk, please enclose a check or money order for $40.
  1635.  
  1636.        For an additional fee of $50 per year, you can subscribe to our program
  1637.       update service.  Subscribers get up to five program updates  per year
  1638.       mailed to them as new versions come out.  This does not include trivial
  1639.       releases.
  1640.  
  1641.  
  1642.        At present, the normal upgrade fee is $15. For this upgrade fee you get
  1643.       a copy of the new documentation and the upgrade media of your choice,
  1644.       either 5.25 DS/DD diskette or 3.5 720k micro diskette. For orders
  1645.       outside the U.S. add $5.00 to the upgrade fee.
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.                                    - 22 -
  1681.  
  1682.  
  1683.  
  1684.  
  1685.   XVII VERSION NUMBERS
  1686.        ---------------
  1687.  
  1688.  
  1689.        All of our version numbers are given as a number with two decimal
  1690.       places.
  1691.  
  1692.        The units indicate a major revision, such as adding a new feature, maybe
  1693.       such as virtual printer support.
  1694.  
  1695.        The first decimal place (tenths) indicates a minor revision that is
  1696.       not essential, but which may be desired.
  1697.  
  1698.        The second decimal place (hundredths) indicates a trivial revision
  1699.       that will probably only be desired by specific individuals or by die-
  1700.       hard "latest version" fanatics.
  1701.  
  1702.  
  1703.        To sum up: If the units change, then you should get the newer version
  1704.       as soon as you can.  If the tenths change, then you may want to get
  1705.       the newer version, but there's no hurry.  If anything else changes,
  1706.       then you probably shouldn't bother.
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.                                    - 23 -
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.   XVIII TECHNICAL REQUIREMENTS AND NOTES
  1749.         --------------------------------
  1750.  
  1751.        Equal Partners uses the RS-232C hardware or  parallel adapter to
  1752.       interface the PCs and provide the 'bridge' to allow the exchange of data.
  1753.  
  1754.        The hardware consists of the standard 8250 uarts and the DB-25
  1755.       or DB-9 connectors and cables (RS232 or telephone wire).
  1756.       However , only pins 2,3, and 7 are used. Also pins 2 and 3
  1757.       (transmit and receive) are required to be crossed-over or
  1758.       you can build or purchase a modem eliminator/null modem.
  1759.  
  1760.        A 'special' parallel adapter is required. The special adapter
  1761.       attaches to one end of a shielded serial cable and the other
  1762.       end of the special adapter to one on the parallel cards. The
  1763.       parallel adapter cannot use telephone wire as more than 8 wires
  1764.       are required.
  1765.  
  1766.       (See your local electronics parts dealer: such as RADIO SHACK:
  1767.       the part number for null modem : : P/N 261496 - at $14.95)
  1768.  
  1769.  
  1770.       This is the basic diagram of the CROSS-OVER pin configuration
  1771.      for the serial null modem ONLY:
  1772.  
  1773.                          DB-25   to   DB-25
  1774.                         --------------------
  1775.  
  1776.  
  1777.  
  1778.                     ------                 ------
  1779.                     |    |                 |    |
  1780.                     |  2 |-----------------|3   |  Pins
  1781.                     |    |                 |    |
  1782.                     |  3 |-----------------|2   |
  1783.                     |    |   ground        |    |
  1784.                     |  7 |-----------------|7   |
  1785.                     ------                 ------
  1786.                      DB-25                 DB-25
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.                           DB-9  to   DB-25
  1795.                         --------------------
  1796.  
  1797.  
  1798.  
  1799.                     ------                 ------
  1800.                     |    |                 |    |
  1801.                     |  2 |-----------------|2   |  Pins
  1802.                     |    |                 |    |
  1803.                     |  3 |-----------------|3   |
  1804.                     |    |   ground        |    |
  1805.                     |  5 |-----------------|7   |
  1806.                     ------                 ------
  1807.                      DB-9                  DB-25
  1808.  
  1809.  
  1810.                                    - 24 -
  1811.  
  1812.  
  1813.  
  1814.         The number of wires required (3) indicate that regular telephone
  1815.         4-6-8 wire could be used to connect PCs , over a distance. This
  1816.         applies to serial port usage ONLY.
  1817.  
  1818.          This HAS been tested by Downlink and works very well even at
  1819.         115+ kb. Again, you can check with Radio Shack for a DB-25 to
  1820.         RJ11/RJ45 adapter. The Radio Shack part number is : 276-1405
  1821.         (Modular/EIA adapter kit) and the cost is about $3.00 (male).
  1822.  
  1823.          Also INMAC sells the same type kit. Look in their catalogue under
  1824.         "Modular wiring system" and then look under "Modular EIA adapters".
  1825.         The kit part numbers are 351-3 (male) or 352-3 (female) for the
  1826.         25-pin EIA to 6-pin RJ-11. The cost is $13.00 each. The 9-pin
  1827.         assembled part numbers are: 357-1 (m) and 357-2 (f) for $12.00
  1828.         each.
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.                                    - 25 -
  1873.  
  1874.  
  1875.  
  1876.       The following are notes and considerations both technical
  1877.      and otherwise, these must be noted and HEEDED:
  1878.  
  1879.         1).  Both EQUAL.COM and PARTNERS.COM use COM1 or COM2 as the
  1880.             'bridge'. The port addresses are disabled so that Basic will
  1881.             not interfere, as Basic tries to take over the com ports when
  1882.             loaded, even if does not need them.
  1883.  
  1884.              The parallel ports , LPT1 or LPT2 are used if the parallel
  1885.             port option is selected.
  1886.  
  1887.              The program , 'PARTNERS.COM' will revector  and restore the
  1888.             com ports addresses when it is de-activated however.
  1889.  
  1890.         2).  The program ,'EQUAL.COM', installs resident and attaches itself
  1891.             to DOS, so that once installed its there to stay.
  1892.  
  1893.         3).  The data transfer rate is 19.2  baud for the Shareware  version.
  1894.             The registered user version is fixed at  115+ baud, for serial ,
  1895.             but may be patched to a lower speed if there are hardware problems
  1896.             at 115+. The registered parallel version functions at a variable
  1897.             rate, the transfer rate being dependant on the speed of the slower
  1898.             of the 2 PCs that are connected.
  1899.  
  1900.         4).  Error checking is performed on each block of data. Crc-16 is
  1901.             used to insure the integrity of your financial data and programs.
  1902.  
  1903.         5).  Ram disks with sector sizes between 128 and 512 bytes are
  1904.             supported. This applies to other disk media as well. The sector
  1905.             sizes must be a power of 2.
  1906.  
  1907.         6).  The operating systems on ALL remote(s) and the server SHOULD/MUST
  1908.             be identical. Mixing DOS versions accessing the same data and media
  1909.             MAY/WILL cause problems. Some versions of DOS do not support media
  1910.             types made available in later versions of DOS, so some DOS utilities
  1911.             may not function correctly when accessing disk media or using
  1912.             function calls that were added/modified in later releases of DOS
  1913.             (ex: CHKDSK).
  1914.  
  1915.         7).  Communication baud rates up to 115k+ are possible, for serial ONLY.
  1916.             However, going from 9.6 to 115+ will not give you 10 times the data
  1917.             transfer rate.
  1918.  
  1919.              The internal design of EQUAL PARTNERS allows for a matching of PCs
  1920.             with different CPUs , say a 4.77 mhz processor talking to a 16mhz
  1921.             processor. Obviously the 16 mhz beast could easily overrun the much
  1922.             slower 4.77 cpu. To allow for the possibility of mismatched
  1923.             processor speeds,  EQUAL PARTNERS turns the communications line
  1924.             around no faster than the slowest cpu can handle data. This means
  1925.             that going from 19.2 to 115k will send the data between PCs at that
  1926.             speed, but only as fast as the slower of the two PCs can process
  1927.             and request more data from the faster processor.
  1928.  
  1929.             NOTE:  the above applies to "NORMAL" mode. "TURBO" mode utilizes
  1930.                   ALL the hardware speed to achieve the 4-8kb per second
  1931.                   data transfer rate (independent of the other attached PCs).
  1932.  
  1933.                                  (continued)
  1934.                                    - 26 -
  1935.  
  1936.  
  1937.  
  1938.         8).  Though we have not brought it to your attention before, we give
  1939.             examples of using a "ABC" switch box to link PCs to a server and
  1940.             other examples of the possibility of multiple remotes attached
  1941.             to a "server".
  1942.  
  1943.              Let us CLARIFY AND EMPHASIZE , that to the remote, all virtual
  1944.                     ----------------------
  1945.             disks (even "server" harddisks) are removable.
  1946.  
  1947.              What this means is that each virtual disk can be virtually removed
  1948.             and other virtual disk(s) placed in the virtual (RS232) drive.
  1949.  
  1950.              If this is abused, then disk directories and data files have the
  1951.             potential of being corrupted or destroyed. This all goes back to
  1952.             the original days of DOS 1.0.
  1953.  
  1954.             For example:
  1955.  
  1956.              You could  put a disk in the  "A"  drive and run a program that
  1957.             reads and updates the disk in the "A:" drive. However if you were
  1958.             careless enough to remove the original disk from the "A:" drive and
  1959.             replace with another disk (with different data..etc) then DOS would
  1960.             not know what you had done, and would just write over the new disk.
  1961.             Well , you can see that you could do the same type of thing with the
  1962.             virtual disks on the remote (and server).
  1963.  
  1964.  
  1965.             SO, if you are going to be switching remote PCs on the RS232 link,
  1966.  
  1967.  
  1968.             ALWAYS DISCONNECT OR SWITCH THE REMOTE WHILE THE REMOTE IS AT THE
  1969.             -----------------------------------------------------------------
  1970.            "DOS PROMPT", AND  NEVER WHILE YOU ARE RUNNING AN APPLICATION
  1971.             -----------------------------------------------------------------
  1972.             PROGRAM ON THE REMOTE (AS FILES MAYBE IN USE ON THE SERVER)!!
  1973.             ------------------------------------------------------------------
  1974.  
  1975.  
  1976.         9). If you are going to run the PC as a EQUAL PARTNERS "server" then:
  1977.            NEVER use the DOS commands , "ASSIGN", "JOIN", "SUBST", or other
  1978.            -----
  1979.            DOS commands on the "server" that would "hide" the true type and
  1980.            nature of disk devices.
  1981.  
  1982.             Please heed these rules, unless you know absolutely what you are
  1983.            doing and its effects on DOS and applications. In such situations,
  1984.            if you choose to do so, YOU bear the responsibility for the integrity
  1985.            of your data and the effects on the DOS operating system, on both
  1986.            the server and the remote(s)!!.
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.                                    - 27 -
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  Appendix A - Program Messages.
  2002.  
  2003.  
  2004.  
  2005.       All message text is preceded by a formatted message code.
  2006.  
  2007.      The format of the message code is:
  2008.  
  2009.                    EPxNNNy
  2010.  
  2011.       where :
  2012.  
  2013.            x= 'D' - for 50-50.SYS  program output messages
  2014.  
  2015.               'E' - for EQUALS.COM program output messages
  2016.  
  2017.               'P' - for PARTNERS.COM program output messages
  2018.  
  2019.          and
  2020.  
  2021.  
  2022.            NNN= 000 thru 999, which is the message number for this
  2023.                              message type.
  2024.  
  2025.          and
  2026.  
  2027.            y= 'D' - for Diagnostic type messages. These messages are
  2028.                     normally printed only if a critical error occurs
  2029.                     or the program is in a 'test' or debugging mode.
  2030.  
  2031.               'E' - for Error messages. These type messages indicate
  2032.                     that an unrecoverable error occurred and the program
  2033.                     could not take any corrective action, except to
  2034.                     attempt to return to the DOS prompt.
  2035.  
  2036.               'I' - for Informative messages. These messages are just
  2037.                     to inform you  as to the processing state of the
  2038.                     program at any given time.
  2039.  
  2040.               'W' - for Warning messages. These messages indicate
  2041.                     that an error occurred, but that the program
  2042.                     was able to take corrective action and continue
  2043.                     processing. However, the function the program was
  2044.                     attempting may or may not have been successfully
  2045.                     completed.
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.                                    - A1 -
  2059.  
  2060.  
  2061.  
  2062.       Message Code         Message text and its explanation
  2063.       ------------    ----------------------------------------------------
  2064.  
  2065.         EPD001I - EQUAL PARTNERS Virtual disk driver V5.00
  2066.                  (C)Copyright DOWNLINK SYSTEMS , 1987,1989
  2067.  
  2068.                   This is the copyright message displayed from the
  2069.                   virtual disk device driver during PC power-up.
  2070.  
  2071.         EPD002I - 1 virtual disk drive(s) available to DOS
  2072.  
  2073.                   This message indicates the number of additional
  2074.                   disk drives ('virtual') that DOS can access. These
  2075.                   drives may be accessed by the  DOS commands or any
  2076.                   program by using the drive letters assigned, by DOS,
  2077.                   to the virtual disks. Registered users may access up
  2078.                   to 8 virtual disks, the shareware version allows
  2079.                   access to only 1 virtual disk.
  2080.  
  2081.         EPE001E - installation cancelled - COM channel undefined
  2082.  
  2083.                    With version 5.0, the device (serial/parallel) and
  2084.                   the port (COM1/COM2 or LPT1/LPT2) MUST be specified
  2085.                   on the command line. These are the mandatory minimum
  2086.                   parameters required to start Equal Partners.
  2087.  
  2088.                   The program was trying to install, but was unable
  2089.                   to find a communications port address at the desired
  2090.                   memory location or find a 8250 async controller chip
  2091.                   (8250 for serial only).
  2092.  
  2093.  
  2094.         EPE002E - installation cancelled - 50-50 driver not installed
  2095.  
  2096.                   The device driver, 50-50.sys, was not included in the
  2097.                   DOS file 'config.sys'. If your intent is to run this
  2098.                   PC as a 'remote', then see the INSTALLATION section
  2099.                   for the correct program configurations.
  2100.  
  2101.         EPE003E - installation cancelled - ALREADY installed
  2102.  
  2103.                   The program EQUAL.COM has already been installed once.
  2104.                   Multiple installations are not allowed.
  2105.  
  2106.         EPE000I - EQUAL activated - Communications link is (COMx or LPTx)
  2107.  
  2108.                   This message reflects that the installation of EQUAL is
  2109.                   in progress and that the Communications port, COMx or LPTx
  2110.                   was the port selected to link the "remote" to the "server"
  2111.  
  2112.         EPE001I - EQUAL running at - ???kb (baud) in XXXXXX mode
  2113.  
  2114.                   This informative message indicate the "mode" and the
  2115.                   internal speed at which communications and data transfers
  2116.                   are taking place. The "mode" (indicate by XXXXXX) will be
  2117.                   either "NORMAL" or "TURBO". The baud (indicated by ???) will
  2118.                   range from 9.6kb to 115kb or 250 for parallel. Typing in the
  2119.                   command , EQUAL,  (with or without new mode) will display
  2120.                   this message also.
  2121.  
  2122.                                    - A2 -
  2123.  
  2124.  
  2125.  
  2126.       Message Code         Message text and its explanation
  2127.       ------------    ----------------------------------------------------
  2128.  
  2129.         EPE002I - EQUAL installed - Virtual drives C: thru C: available for use
  2130.  
  2131.                   This is the most important type 'I' message that is
  2132.                   displayed.  This message reflects the  additional 'drive'
  2133.                   letters you use on all DOS commands and in programs, to
  2134.                   access data on the 'server' PC.
  2135.                      The drive letters displayed depends on the number of
  2136.                   virtual drives requested (up to 8 allowed) on the
  2137.                   'device=50-50.sys' statement in the DOS 'config.sys' file.
  2138.  
  2139.         EPE003I - EQUAL printing  - output to LPT1 will print on .......
  2140.  
  2141.                   This messages indicates where the 'remote' is sending its
  2142.                   printer output that goes to LPT1. The message will show
  2143.                   destination as either 'this PC' or 'SERVER'. A physical
  2144.                   printer, on the remote' is not required to use the "/P"
  2145.                   option on the EQUAL command line.
  2146.  
  2147.         EPE999I - EQUAL shutdown - returning to DOS
  2148.  
  2149.                   This message indicates that EQUAL.COM is returning to
  2150.                   DOS. See any additional messages for the exact reason.
  2151.  
  2152.         EPP001E - installation cancelled - COM channel undefined
  2153.  
  2154.                    With version 5.0, the device (serial/parallel) and
  2155.                   the port (COM1/COM2 or LPT1/LPT2) MUST be specified
  2156.                   on the command line. These are the mandatory minimum
  2157.                   parameters required to start Equal Partners.
  2158.  
  2159.                   The program was trying to install, but was unable
  2160.                   to find a communications port address at the desired
  2161.                   memory location or find a 8250 async controller chip.
  2162.  
  2163.         EPP002E - installation cancelled - EQUAL is already installed
  2164.  
  2165.                   The program is trying to be installed on a machine
  2166.                   that already has the EQUAL.COM program installed.
  2167.                   You can't make one machine both a 'remote' and a
  2168.                   'server'.
  2169.  
  2170.         EPP997E - PARTNERS shutdown     - memory allocation error during install
  2171.  
  2172.                   The program was requesting a 64k block of contiguous
  2173.                   memory from DOS, and DOS could not satisfy the request.
  2174.                   Insure you have sufficient memory by adding memory to
  2175.                   your system or removing unneeded ram-resident programs.
  2176.  
  2177.         EPP998E - PARTNERS shutdown     - memory modify error during install
  2178.  
  2179.                   The program was being "well-behaved' and returning all the
  2180.                   memory to DOS that it did not need. This indicates that the
  2181.                   program has been modified incorrectly or that DOS has been
  2182.                   corrupted. At this point it would be best to re-boot the
  2183.                   PC, and reload a fresh copy of DOS and "PARTNERS".
  2184.  
  2185.                                    - A3 -
  2186.  
  2187.  
  2188.  
  2189.       Message Code         Message text and its explanation
  2190.       ------------    ----------------------------------------------------
  2191.  
  2192.         EPP000I - PARTNERS activated - Communications link is (COMx or LPTx)
  2193.  
  2194.                   This message reflects that the installation of PARTNERS
  2195.                   is in progress and that the Communications port, COMx or LPTx
  2196.                   was the port selected to link the "server" to the "remote".
  2197.  
  2198.         EPP001I - PARTNERS shutdown      - by a REMOTE is ........
  2199.  
  2200.                   This message indicates whether the server (PARTNERS) can be
  2201.                   automatically shutdown (return to DOS) by a remote (/D).
  2202.                    Remote shutdown support must be enabled on the server or
  2203.                   the remotes request is ignored. This option may be toggled
  2204.                   (changed) with the appropriate function key after PARTNERS
  2205.                   is running.
  2206.  
  2207.         EPP002I - PARTNERS printing      - by a REMOTE is ........
  2208.  
  2209.                   This message indicates whether the server (PARTNERS) will
  2210.                   process printer output to LPT1 that has been sent from the
  2211.                   remote.
  2212.                    Remote printer support must be enabled on the server or
  2213.                   the remotes request returns a printer timeout. This option
  2214.                   may be toggled (changed) with the appropriate function key
  2215.                   after PARTNERS is running.
  2216.  
  2217.         EPP003I - PARTNERS write protect - on all disks is ......
  2218.  
  2219.                   This message indicates whether the server (PARTNERS) will
  2220.                   perform automatic write protect on all disk drives read by
  2221.                   a remote. This would be the same as placing a 'write protect'
  2222.                   (silver/black) tab on a floppy. In otherwords, you can read
  2223.                   a disk but NOT write to it. Since virtual disks are removable
  2224.                   , from a remotes point of view, a virtual 'write protect tab'
  2225.                   option provides you with similar functionality.
  2226.  
  2227.         EPP998I - PARTNERS installed -waiting for remote response
  2228.  
  2229.                   You have entered PARTNERS from the DOS prompt or in
  2230.                   a batch file. PARTNERS is now installed (not resident)
  2231.                   and is waiting for input on the communications port.
  2232.                   The programs EQUAL.COM and 50-50.SYS have to be installed
  2233.                   on the "remote" computer to complete the "bridge",so
  2234.                   that data may be freely transferred between computers.
  2235.  
  2236.         EPP999I - PARTNERS shutdown - returning to DOS
  2237.  
  2238.                   You have either pressed the 'ESC' key or installation
  2239.                   failed.
  2240.  
  2241.         EPP001W - Invalid I/O request - flushing input buffer
  2242.  
  2243.                   Extraneous or corrupted information was received. The
  2244.                   programs only recourse is to ignore the data, flush
  2245.                   all buffers and try to get in sync with the other PC.
  2246.  
  2247.                                    - A4 -
  2248.  
  2249.  
  2250.  
  2251.       Message Code         Message text and its explanation
  2252.       ------------    ----------------------------------------------------
  2253.  
  2254.  
  2255.         EPP001D - AX=      BX=     CX=    DX=
  2256.  
  2257.                   This message displays the internal register states.
  2258.                   The message is normally display only when a critical
  2259.                   error occurs or the programs debugging mode is active.
  2260.  
  2261.         EPP002D -     -
  2262.  
  2263.                   This message is preceded by message code EPP001D.
  2264.                   Several additional message lines will be displayed
  2265.                   indicating the reason for this diagnostic message.
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.                                    - A5 -
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  Appendix B - Site License
  2315.  
  2316.  
  2317.  
  2318.                                   SITE LICENSE
  2319.  
  2320.  
  2321.  
  2322.      Corporate users may wish to obtain a site license for the use of EP.
  2323.      The site license applies only to one geographical area, not to exceed
  2324.      a 50 mile radius. Additional site licenses are required for each
  2325.      unique geographical location.
  2326.  
  2327.        Please use the order form in this manual to request a site license.
  2328.  
  2329.      Site licenses are now negotiated on an individual basis.  License fees
  2330.      vary depending on the number of computers on which EP  will be used.
  2331.  
  2332.      Equal Partners is now ONLY licensed per single unit quantities of,
  2333.  
  2334.  
  2335.          1 single unit license -  $40 each    ($15 upgrade fee each)
  2336.  
  2337.  
  2338.          A site license may be requested and will be negotiated on an
  2339.        individual basis.
  2340.  
  2341.  
  2342.      The following page is a license agreement, which should be signed
  2343.      and sent with your payment when ordering a commercial license.
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.                                    - B1 -
  2372.  
  2373.  
  2374.                           Commercial License Agreement
  2375.  
  2376.      The use of EP  in a commercial environment or government organization
  2377.      is granted under the following terms:
  2378.  
  2379.      1.  Payment of the license fee must be made payable to DOWNLINK SYSTEMS
  2380.         representative: D. Conner
  2381.  
  2382.          The fee is based on the number of computers which will be used
  2383.          to run EP , as follows:
  2384.  
  2385.          Equal Partners is now ONLY licensed per single unit quantities of,
  2386.  
  2387.  
  2388.             1 single unit license -  $40 each    ($15 upgrade fee each)
  2389.  
  2390.  
  2391.      2.  You may use EP  on the number of computers included in the license
  2392.          fee.  If you have negotiated a site license, then you may use EP
  2393.          on any number of computers within your organization, within a given
  2394.          geographical area.
  2395.  
  2396.      3.  You may make copies of the program and documentation, in their
  2397.          original,  unmodified form. You may distribute these copies, within
  2398.          the limits of the number of copies licensed.
  2399.  
  2400.      4.  You may use all future "restricted-usage" Shareware versions of EP
  2401.          under this license.
  2402.  
  2403.          The latest version is available from Downlink  for a small service
  2404.          charge of $5.00 for shareware version, on either 5.25 or 3.5 DS/DD)
  2405.  
  2406.      5.  You may NOT modify the program or charge a fee for copying or
  2407.          distributing the program or its documentation.
  2408.  
  2409.      6.  It is your responsibility to make the necessary copies and to
  2410.          deliver them to the computers which they will be used on.
  2411.  
  2412.      7.  We are not responsible for anything that may happen or not happen
  2413.          if you use EP.  You're on your own.
  2414.  
  2415.  
  2416.      8.  You are required to complete and sign this form and the ORDER form
  2417.          , and return them to Downlink Systems. This especially applies
  2418.          to any purchases that were made via 1-800 credit card order.
  2419.  
  2420.          I agree to abide by the terms and conditions of this license.
  2421.  
  2422.          _____________________________         __________________________
  2423.          Signature                             Date
  2424.  
  2425.          _____________________________
  2426.          Name (please print or type)
  2427.  
  2428.          _____________________________
  2429.          Title
  2430.  
  2431.          _____________________________
  2432.          Company
  2433.  
  2434.                                    - B2 -
  2435.  
  2436.  
  2437.  
  2438.  Appendix C - Ordering
  2439.  
  2440.                                    ORDER FORM
  2441.  
  2442.  
  2443.      Check which items you wish to purchase:
  2444.  
  2445.          (_) Noncommercial license for the use of EP.
  2446.  
  2447.          (_) Commercial license for the use of EP on ___ computers
  2448.  
  2449.          (_) Program update fee of $_____  for each of __ computers that EP
  2450.              is currently licensed on.
  2451.  
  2452.          (_) Additional, program update subscription service, $50/year.
  2453.              (not more than five updates, does not include trivial changes,
  2454.               and ONLY applies to licenses up to 10 machines.)
  2455.  
  2456.          (_) Update media is :  (_) 5-1/4 floppy  |  (_) 3-1/2 micro floppy
  2457.  
  2458.          (_) Payment already made via credit card throught PSL. My software
  2459.              serial number is : _____________________
  2460.  
  2461.          (_) Payment of $_____ is enclosed (check or money order),
  2462.                 |
  2463.                 +------> payable to : D. CONNER.
  2464.                          ----------
  2465.  
  2466.              Signature: ________________________________
  2467.  
  2468.          _______________________________________________
  2469.          Name
  2470.  
  2471.          _______________________________________________
  2472.  
  2473.  
  2474.          _______________________________________________
  2475.          Address
  2476.  
  2477.          ______________________   ________  ____________
  2478.          City                     State     Zip
  2479.  
  2480.  
  2481.          _______________________________________________
  2482.          Country
  2483.  
  2484.  
  2485.      ***       Send check or money orders payable to : D. CONNER      ***
  2486.                -------------------------------------------------
  2487.        (all other endorsements will be returned and order not processed)
  2488.  
  2489.      Send this completed form to:
  2490.  
  2491.                                   Downlink Systems
  2492.                                   c/o D. Conner
  2493.                                   1377 K STREET N.W.
  2494.                                   SUITE 189
  2495.                                   WASHINGTON D.C. 20005
  2496.  
  2497.                                    - C1 -
  2498.  
  2499.  
  2500.  
  2501.  Appendix C - Ordering: Credit card
  2502.  
  2503.  
  2504.            Register Shareware Through Public (Software) Library (PSL)
  2505.            ----------------------------------------------------------
  2506.  
  2507.  
  2508.             To place Orders ONLY for Equal Partners : 1-800-2424-PSL
  2509.                      ------------                      --------------
  2510.  
  2511.              for Questions ONLY, (NOT Tech Support): 1-713-665-7017.
  2512.  
  2513.  
  2514.  
  2515.          By special arrangement with many shareware authors, you can now
  2516.         conveniently register selected shareware programs through PSL. The
  2517.         authors will ship the latest version and other material directly to
  2518.         you within 48 hours. Some programs are shipped directly by PSL.
  2519.         At this time Equal Partners is shipped only by Downlink Systems.
  2520.  
  2521.          You also get a $5.00 PSL credit without having to send the
  2522.         FREEDISK.DOC form to author to sign and without having to mail it to
  2523.         PSL.
  2524.  
  2525.          Calif. residents add 6.5%. Utah residents add 6.25%. Texas residents
  2526.         add 8% sales tax on all.
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.                                    - C2 -
  2560.  
  2561.  
  2562.  
  2563.  
  2564.       For program disk orders outside the U.S., please add an additional $5,
  2565.      and enclose a check or money order payable in U.S. currency and
  2566.      drawn on a U.S. bank. Any checks/money orders that cannot be deposited
  2567.      --------------------
  2568.      in a U.S. bank WILL be returned without processing of the order.
  2569.  
  2570.       For commercial license orders, please enclose a signed copy of the
  2571.      the license agreement.
  2572.  
  2573.       Inquires for Corporate wide unlimited usage licenses are welcome.
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.                                    - C3 -
  2622.  
  2623.  
  2624.  Appendix D - Comments
  2625.  
  2626.                               USER COMMENT FORM
  2627.  
  2628.  
  2629.       If you have found any errors in this documentation that you would like
  2630.      to bring to our attention, please indicate them below. Please indicate
  2631.      them by page number if possible. If there are other improvements to the
  2632.      documentation, product features that you would like us to consider,
  2633.      or any ways you are using EQUAL PARTNERS that you would like to share,
  2634.      please indicate them here:
  2635.  
  2636.    ____________________________________________________________________________
  2637.  
  2638.    ____________________________________________________________________________
  2639.  
  2640.    ____________________________________________________________________________
  2641.  
  2642.    ____________________________________________________________________________
  2643.  
  2644.    ____________________________________________________________________________
  2645.  
  2646.    ____________________________________________________________________________
  2647.  
  2648.    ____________________________________________________________________________
  2649.  
  2650.    ____________________________________________________________________________
  2651.  
  2652.    ____________________________________________________________________________
  2653.  
  2654.    ____________________________________________________________________________
  2655.  
  2656.    ____________________________________________________________________________
  2657.  
  2658.    ____________________________________________________________________________
  2659.  
  2660.    ____________________________________________________________________________
  2661.  
  2662.    ____________________________________________________________________________
  2663.  
  2664.    ____________________________________________________________________________
  2665.  
  2666.    ____________________________________________________________________________
  2667.  
  2668.    ____________________________________________________________________________
  2669.  
  2670.    ____________________________________________________________________________
  2671.  
  2672.    ____________________________________________________________________________
  2673.  
  2674.    ____________________________________________________________________________
  2675.  
  2676.    ____________________________________________________________________________
  2677.  
  2678.    ____________________________________________________________________________
  2679.  
  2680.    ____________________________________________________________________________
  2681.  
  2682.  
  2683.                                    - D1 -
  2684.  
  2685.  
  2686.  
  2687.  Appendix E - Mailing
  2688.  
  2689.  
  2690.                             CHANGE OF ADDRESS FORM
  2691.  
  2692.  
  2693.       Please let us know when you change your address, so that we can keep
  2694.      you informed of product improvements, etc.
  2695.  
  2696.  
  2697.    NAME: ______________________________________________________________________
  2698.  
  2699.    COMPANY:____________________________________________________________________
  2700.  
  2701.    SERIAL NUMBER:______________________________________________________________
  2702.  
  2703.    Old Address:
  2704.  
  2705.    ____________________________________________________________________________
  2706.  
  2707.    ____________________________________________________________________________
  2708.  
  2709.    CITY:______________________________________STATE:______ZIP:_________________
  2710.  
  2711.    ____________________________________________________________________________
  2712.  
  2713.    New Address:
  2714.    ____________________________________________________________________________
  2715.  
  2716.    ____________________________________________________________________________
  2717.  
  2718.    ____________________________________________________________________________
  2719.  
  2720.    CITY:______________________________________STATE:______ZIP:_________________
  2721.  
  2722.    Telephone:__________________________________________________________________
  2723.  
  2724.    ____________________________________________________________________________
  2725.  
  2726.    Effective Date of New Address:______________________________________________
  2727.  
  2728.  
  2729.                                 MAIL TO :
  2730.                                -----------
  2731.  
  2732.  
  2733.                           Downlink Systems
  2734.                           c/o D. Conner
  2735.                           1377 K Street N W
  2736.                           Suite 189
  2737.                           Washington D. C.  20005
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.                                    - E1 -
  2745.  
  2746.