home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / pc2pc.zip / LANXCOPY.DOC < prev    next >
Text File  |  1995-04-19  |  11KB  |  325 lines
  1. LANXCOPY
  2. Version 1.00
  3. Chris Ahl
  4. RTP, N.C.
  5. 03/17/94
  6.  
  7. LANXCOPY is similar to the DOS and OS/2 XCOPY command.  However, LANXCOPY
  8. allows the transfer of files between two machines on the same LAN
  9. without the need to have PCLP or LAN Requester/LAN Server
  10. running in either machine.  Instead, LANXCOPY uses the NETBIOS interface
  11. to transfer the files.
  12.  
  13. The main reason for developing LANXCOPY was to eliminate the Sneaker
  14. Network that many of us use daily to get files from one machine to another.
  15. How many times have you searched for a diskette so that you could copy
  16. files from one machine to another machine even though the machines were on
  17. the same LAN?  It's even worse if you have to convert between 5 1/4" and
  18. 3 1/2" diskettes.  Not to mention what you go through if the files fill up
  19. more than one diskette.
  20.  
  21. So the next time you need to copy files from one machine to another and
  22. they are on the same LAN, give LANXCOPY a try.  The time and effort saved
  23. may be worth the couple of minutes it takes to learn to use LANXCOPY.
  24.  
  25.  
  26. --------
  27. Features
  28. --------
  29.  
  30.   - Bound executable - runs under DOS or OS/2.
  31.   - Uses Netbios - PCLP and/or LAN Requester/LAN Server are not needed.
  32.   - Ability to copy subdirectories.
  33.   - Ability to copy Hidden files.
  34.   - Ability to copy System files.
  35.   - Maintains a log file containing details of each transfer.
  36.   - Saves time and effort compared to using diskettes.
  37.   - Saves wear and tear on your shoes!
  38.  
  39. -----
  40. SetUp
  41. -----
  42.  
  43. Before you use LANXCOPY you need to:
  44.  
  45.   - Add the environment variable LANXCOPY_ID=<name>.  Where <name> is the
  46. name you want to be known by on the LAN when using LANXCOPY.  Do this in one
  47. of two ways:
  48.  
  49.   - Do a SET LANXCOPY_ID=<name> on the command line.
  50.   - Add SET LANXCOPY_ID=<name> to your CONFIG.SYS for OS/2 or AUTOEXEC.BAT for
  51.     DOS.
  52.  
  53. This is the preferred way.  Every time you reboot your machine, this
  54. environment variable will be set.  If you just edited CONFIG.SYS and added
  55. this variable, it will not take effect until you reboot your machine.
  56.  
  57.   - Copy LANXCOPY.EXE to your utilities directory or any other directory that
  58. is in your PATH= statement.
  59.   - Make sure that you have NETBIOS installed on your LAN attached machine.
  60.  
  61. --------------
  62. Using LANXCOPY
  63. --------------
  64.  
  65. LANXCOPY has been run through the IBM C/2 BIND utility.  This will allow
  66. LANXCOPY to run on both DOS and OS/2.  So whether you use DOS or OS/2 you
  67. only need to remember and use one program, LANXCOPY.
  68.  
  69. Since LANXCOPY operates over a LAN, it requires that both machines run
  70. LANXCOPY.  The machine which will be the RECEIVER should be the one
  71. started first.  After the RECEIVER machine is running and waiting
  72. to receive files, the SENDER machine is started.  The SENDER machine will
  73. attempt to locate the RECEIVER machine.  If successful, file transfer
  74. will be attempted.
  75.  
  76. LANXCOPY will display the current file being copied and the result of the
  77. copy operation.  This allows both the SENDER and RECEIVER to know exactly
  78. what files have been processed.  After all the files specified by the SENDER
  79. have been processed, the SENDER application will terminate.  The RECEIVER has
  80. the option of terminating or remaining active and waiting for more files from
  81. another SENDER.
  82.  
  83. To aid the user in keeping track of file transfers, LANXCOPY maintains
  84. a log.  The log file is LANXCOPY.LOG and it resides in the same directory as
  85. the LANXCOPY executable.  For more information on this, look under
  86.  
  87. Log File
  88.  
  89. For details on invoking LANXCOPY to receive and send files, please refer
  90. to the next two sections.
  91.  
  92. ---------------
  93. Receiving Files
  94. ---------------
  95.  
  96. -The RECEIVER side of LANXCOPY must be started first.
  97. -LANXCOPY <from> <to> (optional)
  98.  
  99. -Required Parameters:
  100.  
  101. <from>
  102.    Receive files from this LANXCOPY_ID. Prefix with FROM:.
  103.    You may use an asterisk (*) to specify that you wish to receive files
  104.    from whoever sends them to you.
  105.  
  106. <to>
  107.    An existing directory where all received files will be copied to or under.
  108.  
  109. Optional Parameters:
  110. /A
  111.    Use the alternate LAN adapter
  112. /B
  113.    Emit a beep when the program ends
  114. /C
  115.    Allow creation of subdirectories if required.  The subdirectories will be
  116.    created under the directory specified in the <to> parameter.
  117. /H
  118.    Accept files even if they have the Hidden attribute bit turned on.
  119. /L
  120.    Don't create a LOG file on the disk
  121. /R
  122.    Replace files if they already exist under the directory specified in the
  123.    <to> parameter.  NOTE: Use this parameter with caution since even files with
  124.    the read only bit turned on will be replaced.
  125. /X
  126.    Exit after transfer of files.  After the SENDER side has transferred all
  127.    files specified, it will terminate.  If you wish for the RECEIVER to terminate
  128.    after the transfer of files, specify this parameter.
  129. /Y
  130.    Accept files even if they have the System attribute bit turned on.
  131.  
  132.  
  133. Receive Example
  134.  
  135. Receive files from JACK into directory C:\TEMP.
  136.  
  137.    LANXCOPY FROM:JACK C:\TEMP
  138.  
  139.  
  140. -------------
  141. Sending Files
  142. -------------
  143.  
  144. -The SENDER is started after the RECEIVER is up and running.
  145.  LANXCOPY <from> <to> (optional)
  146.  
  147. Required Parameters:
  148. <from>
  149.    Send these files.  Wildcards are supported.
  150.  
  151. <to>
  152.    Send files to this LANXCOPY_ID. Prefix with TO:
  153.  
  154. Optional Parameters:
  155. /A
  156.    Use the alternate LAN adapter
  157. /B
  158.    Emit a beep when the program ends
  159. /F
  160.    The file specified contains a list of files to send.  The file names need
  161.    to be separated by blanks or place each file name on a separate line.
  162.    Wildcards are allowed.
  163. /H
  164.    Copy Hidden files. (NOTE: The RECEIVER must use the /H switch also in order
  165.    for the files to be copied)
  166. /L
  167.    Don't create a LOG file on the disk
  168. /S
  169.    Search all subdirectories under the directory specified in the <from>
  170.    parameter for matching files.
  171. /T=n
  172.    Timed retries, 1 minute apart, will be performed in an attempt to locate
  173.    the receiver.  Useful if you have many senders trying to get to one receiver.
  174.    n is the number of retries from 1 to 65000.  The default is 0.
  175. /Y
  176.    Copy System files. (NOTE: The RECEIVER must use the /Y switch also in order
  177.    for the files to be copied)
  178.  
  179. Send Example
  180.    Copy all files in the current directory to JOE.
  181.  
  182.    LANXCOPY *.* TO:JOE
  183.  
  184.  
  185. --------
  186. Examples
  187. --------
  188. NOTE: All of the following examples assume that the SETUP has been performed.
  189.  
  190.  
  191. - Send C:\CONFIG.SYS from A to B.  B will receive files from anyone and
  192.   place them in C:\LANXCOPY.  After B has received the files, it will terminate
  193.   LANXCOPY.
  194.  
  195.  
  196. B types:
  197.    LANXCOPY FROM:* C:\LANXCOPY /X
  198. After LANXCOPY displays a message that it is waiting to receive files
  199. A types:
  200.    LANXCOPY C:\CONFIG.SYS TO:B
  201.  
  202.  
  203. - Send all the files in C:\UTILITY from A to B.  B wants to receive
  204.   the files in D:\TEMP and only receive files from A.
  205.  
  206. B types:
  207.    LANXCOPY FROM:A D:\TEMP
  208. After LANXCOPY displays a message that it is waiting to receive files
  209. A types:
  210.    LANXCOPY C:\UTILITY TO:B
  211.  
  212.  
  213. - Send every file on C: including subdirectories, system, and hidden files
  214.   from A to B.  B will receive the files in C:\BAK and will allow the creation
  215.   of subdirectories and copying of system and hidden files.
  216.  
  217. B types:
  218.    LANXCOPY FROM:A C:\BAK /C /H /Y
  219. After LANXCOPY displays a message that it is waiting to receive files
  220. A types:
  221.    LANXCOPY C:\*.* TO:B /S /H /Y
  222.  
  223.  
  224. ------------
  225. Restrictions
  226. ------------
  227.  
  228. -Only 8.3 filenames are supported.
  229. -Only file attributes supported by DOS are supported.
  230. -Attributes of directories such as hidden and system are not copied.
  231.  
  232.  
  233. --------
  234. Log File
  235. --------
  236.  
  237. A log file, LANXCOPY.LOG, is used to keep track of all file transfers that
  238. occur.  The file resides in the same directory as the LANXCOPY executable and is
  239. appended each time LANXCOPY is started.  This file may be deleted or edited if
  240. you wish so that it does not get too large.
  241.  
  242. With each invocation of LANXCOPY, a header will be printed displaying the
  243. LANXCOPY version along with the date and time the program was started.  All
  244. the information which appears on the screen during the execution of the
  245. program will also be put in the log file.  It is up to the user of the
  246. program to occasionally prune or delete the LANXCOPY.LOG if it becomes too
  247. large.
  248.  
  249. --------
  250. Security
  251. --------
  252.  
  253. Since LANXCOPY operates over a LAN, it is necessary to provide some basic
  254. security measures to protect both the SENDER and the RECEIVER of the files.
  255.  
  256. SENDER security is provided in two ways:
  257.  
  258. - The SENDER explicitly specifies where the files are going to be sent.
  259.   This keeps files from inadvertently going to a machine other than the one
  260.   expected.
  261. - The SENDER specifies what files are to be sent to the RECEIVER.  This
  262.   keeps the RECEIVER from gaining access to any files which the SENDER does
  263.   not want the RECEIVER to see.
  264.  
  265. RECEIVER security is provided in six ways:
  266.  
  267. - The RECEIVER specifies the directory where LANXCOPY will base all copied
  268.   files.  All files will be copied in or under this directory.
  269. - The RECEIVER can explicitly specify who files are to be received from.  Only
  270.   a specific SENDER can send files to this RECEIVER.
  271. - The RECEIVER controls the replacement of files which already exist.  The
  272.   RECEIVER may or may not allow the SENDER to replace a file.
  273. - The RECEIVER controls the creation of subdirectories under the base
  274.   directory described in the first RECEIVER security measure.
  275. - The RECEIVER can deny the copying of Hidden files.
  276. - The RECEIVER can deny the copying of System files.
  277.  
  278. ---------------
  279. Common Problems
  280. ---------------
  281.  
  282. -NETBIOS AddName or NETBIOS Reset failed.
  283.  
  284.  This usually occurs when there are not enough NAMES, SESSIONS,
  285.  or NCBS defined for the NETBIOS interface.  For OS/2, use Comm Mgr
  286.  to increase NAMES by 1, SESSIONS by 2, and NCBs by 4.
  287.  
  288. -NETBIOS Reset failed. Make sure adapter is operational.
  289.  
  290.  This means that the adapter you are trying to run LANXCOPY on
  291.  
  292.   - Is not present in your machine.
  293.   - Is not operational.
  294.  
  295.  You may not have the proper device drivers loaded for the adapter to
  296.  work properly.  If you are using DOS, make sure the LAN Support Program
  297.  is installed properly.  For OS/2, make sure that Communication Manager is
  298.  installed properly.
  299.  
  300. -You have not installed NETBIOS support for this adapter.
  301.  
  302.  You can check to see if you have NETBIOS installed on DOS by looking for
  303.  the statement DEVICE=<path>DXMT0MOD.SYS in CONFIG.SYS.  For OS/2 1.2 and 1.3,
  304.  look at the \CMLIB\ACSLAN.LOG.  For OS/2 2.0, look at \IBMCOM\LANTRAN.LOG.
  305.  If the OS/2 logs have a message that says NETBIOS is installed, then you do
  306.  have NETBIOS.
  307.  
  308.  Note to OS/2 2.0 Users: NETBIOS is not automatically installed during
  309.  installation of Extended Services.  Be sure to use Communication Manager to
  310.  add NETBIOS support to the adapter you want to run LANXCOPY on.
  311.  
  312.  
  313. -Environment variable LANXCOPY_ID not found
  314.  
  315.  Before you use LANXCOPY, you must specify this environment variable which
  316.  lets LANXCOPY know what you userid will be for the LANXCOPY program.  See the
  317.  SETUP section for more information.
  318.  
  319. -Unable To Open The File On RECEIVER
  320.  
  321.  The file may already exist on the RECEIVER and have the READ ONLY bit
  322.  turned on.  You need to change the READ ONLY bit of this file before
  323.  LANXCOPY will replace it.
  324.  
  325.