home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / pplink.zip / 192BETA.ZIP / README.Eng < prev    next >
Text File  |  1995-01-09  |  10KB  |  263 lines
  1. User's Guide 1/06/95 Eiju Akahane
  2.  
  3. PPLINK (Parallel Port LINK data transfer tool)
  4. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  
  6. 0. Words
  7.  
  8.    Server       specifies the PPLINK server program or the machine in which
  9.                 PPLINK server is running. It enables requester to access
  10.                 the disks attached to the server machine.
  11.  
  12.    Requester    means the PPLINK requester program or the machine in which
  13.                 PPLINK requester is installed. The drives in the server can
  14.                 be accessed from requester.
  15.  
  16. 1. Installation
  17.  
  18.    The following describes the installation by using the case of DOS requester
  19.    and OS/2 server. Refer to "Syntax" section for the detail of parameters.
  20.  
  21.    Step 1) Prepare cable to connect parallel ports. PPLINK supports the
  22.            following three cables. Please refer to the wiring chart in
  23.            the Appendix.
  24.  
  25.            - PPLINK fullduplex cable.
  26.            - LAPLINK/INTERLNK cable.
  27.            - JFACOMM halfduplex cable.
  28.  
  29.            The following steps assume you use LAPLINK/INTERLNK cable.
  30.  
  31.    Step 2) Setup PPLINK server in the DOS machine.
  32.  
  33.      Step 2-1) Copy the following files into your DOS machine. The next
  34.                steps assumes the target directory is c:\pplink.
  35.  
  36.                pplnkdos.sys, ppsvrdos.sys, ppserver.exe
  37.  
  38.      Step 2-2) Add the following lines into the CONFIG.SYS file.
  39.  
  40.                device=c:\pplink\pplnkdos.sys /l
  41.                device=c:\pplink\ppsvrdos.sys pplink$$
  42.  
  43.    Step 3) Install PPLINK requester in the OS/2 machine.
  44.  
  45.      Step 3-1) Copy the following files into the OS/2 machine. (e:\pplink
  46.                is assumed for the next stepes)
  47.  
  48.                pplink.sys, ppreqdrv.sys
  49.  
  50.      Step 3-2) Add the following lines into CONFIG.SYS.
  51.  
  52.                device=e:\pplink\pplink.sys /l
  53.                device=e:\pplink\ppreqdrv.sys pplink$$ 1
  54.  
  55.                The last number specifies the number redirected drives.
  56.  
  57.    Step 4) Start the machines.
  58.  
  59.      Step 4-1) Connect the parallel port of two machines with the proper
  60.                cable.
  61.  
  62.      Step 4-2) Power on DOS machine.
  63.  
  64.      Step 4-3) Run the PPLINK server process in the DOS machine.
  65.  
  66.                Run "c:\pplink\ppserver".
  67.  
  68.      Step 4-4) Boot OS/2 machine.
  69.  
  70.                The redirected drive letters appears when ppreqdrv.sys is
  71.                loaded.
  72.  
  73.    Use "DIR" command to check if the redirected drive works.
  74.  
  75. 2. Syntax
  76.  
  77.    2.1 pplink.sys (use pplnkdos.sys in DOS)
  78.  
  79.        device=[drive][path]pplink.sys [n|mmm] [{/l|/j}] [{/s|/m|/f}]
  80.  
  81.        n    1 digit number. Specifies port number.
  82.        mmm  3 or 4 digit hexadecimal number. Specifies port address.
  83.        /l   LAPLINK/INTERLNK cable is connected.
  84.        /j   JFACOMM halfdulpex cable is connected.
  85.       (none) PPLINK fullduplex cable (same as JFACOMM fullduplex cable)
  86.             is connected. (It works only with the machines which has
  87.             PS/2 type bi-directional parallel port.)
  88.        /s   Slow mode.
  89.        /m   Medium slow mode.
  90.        /f   Fast mode. (can be used only with PPLINK fullduplex cable)
  91.  
  92.        Defaults:
  93.  
  94.           pplink.sys     = pplink.sys    /f
  95.           pplink.sys /l  = pplink.sys /l /m
  96.           pplink.sys /j  = pplink.sys /j /m
  97.  
  98.    2.2 ppreqdrv.sys (use ppreqdos.sys in DOS)
  99.  
  100.        device=[drive][path]ppreqdrv.sys pplink$$ n
  101.  
  102.        n    number. Number of drives for redirection.
  103.  
  104.        Example) If you want to access C: and D: in the server, specify;
  105.  
  106.             device=ppreqdrv.sys pplink$$ 2
  107.  
  108.    2.3 ppsvrdrv.sys (ppsvrdos.sys for DOS)
  109.  
  110.        device=[drive][path]ppsvrdrv.sys pplink$$
  111.  
  112.    2.4 ppserver.exe (bi-modal and works both in OS/2 and DOS)
  113.  
  114.        [drive][path]ppserver [d1[d2..]] [/n]
  115.  
  116.        d1,d2  Drive letters. If specified, ppserver only allows access
  117.               from requester to these drives. If no letters specified,
  118.               ppserver allows access to any drives.
  119.        /n     do not display fullscreen panel.
  120.  
  121.        Example) If you only want to share D:, F:, and G:, type;
  122.  
  123.             ppserver d f g
  124.  
  125. 3. Using ppserver.exe panel interface
  126.  
  127.    You see the following panel when you run ppserver.exe.
  128.  
  129.   ╔═════════════ PPSERVER : PPLINK Disk Server Version 1.92 ═════════════════╗
  130.   ║                  Copyright (C) IBM Corp. 1990, 1995                      ║
  131.   ║                                                                          ║
  132.   ║                                                                          ║
  133.   ║      ██                          ██████████          ██████████          ║
  134.   ║    PPLINK                        Data Transferred    Error Retry         ║
  135.   ║                                                                          ║
  136.   ║    Data Transfer Rate (bytes/second)                                     ║
  137.   ║    ┌────────────────────────────────────────────────────────────────┐    ║
  138.   ║    │                                                                │    ║
  139.   ║    └────────────────────────────────────────────────────────────────┘    ║
  140.   ║     0K                           100K                           200K     ║
  141.   ║                                                                          ║
  142.   ║ Break=Exit F5=Reset Drive(s)=(any)                                       ║
  143.   ╚══════════════════════════════════════════════════════════════════════════╝
  144.  
  145.    3.1 Data in the Screen
  146.  
  147.        PPLINK               : Blink shows the PPLINK activity.
  148.        Data Transferred     : Number of bytes transferred.
  149.        Error Retry          : Number of retry on errors.
  150.        Data Transfer Rate   : Bar graph indicates the speed (bytes/secnd).
  151.        Drive(s)=            : Shows the shared drives.
  152.                               "(any)" indicates any server drives can be shared.
  153.  
  154.    3.2 Key Operations
  155.  
  156.        Break (ctrl+C)      : Stop ppserver in urgent cases. (Use shift+'q'
  157.                              capital 'Q' in DOS)
  158.        F3                  : ppserver normal termination.
  159.        F5                  : Reset display of the panel and disk system.
  160.  
  161. 4. Limitations
  162.  
  163.    1) Because current version of PPLINK redirects low level I/O to provide
  164.       server function, only the physically attached FAT or HPFS drives
  165.       can be shared. You cannot access CD-ROM nor LAN drives in the server.
  166.  
  167.    2) When you run ppserver in your OS/2 machine, do not access the shared
  168.       drive in the server.
  169.  
  170.    3) I implemented minimum functions in the DOS requester. Several file
  171.       API may not work proprely.
  172.  
  173.    4) Current PPLINK cannot share the same parallel port with printers.
  174.  
  175. 5. Sample Applications
  176.  
  177.    5.1  Connect notebook computer and OS/2 desktop machine. Obtain data in
  178.         the notebook from OS/2 application.
  179.  
  180.    5.2  Duplicate installed OS/2 images.
  181.  
  182.    5.3  Install OS/2 into the machine which do no have any remote or CD-ROM
  183.         drives.
  184.  
  185.    5.4  Use old i8086 or i80286 machines as disk server.
  186.  
  187.  
  188. Appendix
  189.  
  190.     Please keep it open if the pin has "N.C." mark.
  191.  
  192.     PPLINK fullduplex cable
  193.  
  194.     -STROBE        1  ─────>  13   SLCT
  195.     DATA 0         2  <────>   2   DATA 0
  196.     DATA 1         3  <────>   3   DATA 1
  197.     DATA 2         4  <────>   4   DATA 2
  198.     DATA 3         5  <────>   5   DATA 3
  199.     DATA 4         6  <────>   6   DATA 4
  200.     DATA 5         7  <────>   7   DATA 5
  201.     DATA 6         8  <────>   8   DATA 6
  202.     DATA 7         9  <────>   9   DATA 7
  203.     -ACK          10  <─────  16   -INIT
  204.     BUSY          11  N.C.    11   BUSY
  205.     PE            12  <─────  14   -AUTO FD XT
  206.     SLCT          13  <─────   1   -STROBE
  207.     -AUTO FD XT   14  ─────>  12   PE
  208.     -ERROR        15  <─────  17   -SLCT IN
  209.     -INIT         16  ─────>  10   -ACK
  210.     -SLCT IN      17  ─────>  15   -ERROR
  211.     GROUND        18  ──────  18   GROUND
  212.       :           :           :      :
  213.     GROUND        25  ──────  25   GROUND
  214.  
  215.  
  216.  
  217.     LAPLINK/INTERLNK Cable cable
  218.  
  219.     -STROBE        1  N.C.     1
  220.     DATA 0         2  ─────>  15   -ERROR
  221.     DATA 1         3  ─────>  13   SLCT
  222.     DATA 2         4  ─────>  12   PE
  223.     DATA 3         5  ─────>  10   -ACK
  224.     DATA 4         6  ─────>  11   BUSY
  225.     DATA 5         7  N.C.     7
  226.     DATA 6         8  N.C.     8
  227.     DATA 7         9  N.C.     9
  228.     -ACK          10  <─────   5   DATA 3
  229.     BUSY          11  <─────   6   DATA 4
  230.     PE            12  <─────   4   DATA 2
  231.     SLCT          13  <─────   3   DATA 1
  232.     -AUTO FD XT   14  N.C.    14
  233.     -ERROR        15  <─────   2   DATA 0
  234.     -INIT         16  N.C.    16
  235.     -SLCT IN      17  N.C.    17
  236.     GROUND        18  ──────  18   GROUND
  237.       :           :           :      :
  238.     GROUND        25  ──────  25   GROUND
  239.  
  240.  
  241.     JFACOMM halfduplex cable
  242.  
  243.     -STROBE        1  N.C      1   -STROBE
  244.     DATA 0         2  N.C      2   DATA 0
  245.     DATA 1         3  N.C      3   DATA 1
  246.     DATA 2         4  N.C      4   DATA 2
  247.     DATA 3         5  ─────>  15   -ERROR
  248.     DATA 4         6  ─────>  13   SLCT
  249.     DATA 5         7  ─────>  12   PE
  250.     DATA 6         8  ─────>  10   -ACK
  251.     DATA 7         9  ─────>  11   BUSY
  252.     -ACK          10  <─────   8   DATA 6
  253.     BUSY          11  <─────   9   DATA 7
  254.     PE            12  <─────   7   DATA 5
  255.     SLCT          13  <─────   6   DATA 4
  256.     -AUTO FD XT   14  N.C     14   -AUTO FD XT
  257.     -ERROR        15  <─────   5   DATA 3
  258.     -INIT         16  N.C     16   -INIT
  259.     -SLCT IN      17  N.C     17   -SLCT IN
  260.     GROUND        18  ──────  18   GROUND
  261.       :           :           :      :
  262.     GROUND        25  ──────  25   GROUND
  263.