home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR35 / PCUCP101.ZIP / USE.DOC < prev   
Text File  |  1993-03-31  |  6KB  |  148 lines
  1. Starting the program
  2. ---------------------------------------------------------------------
  3.  
  4. To start pcucp use the command line
  5.  
  6.     pcucp [config file]
  7.     
  8. where [config file] is an optional argument specifying the
  9. configuration file to be used. The configuration file name
  10. should not include the ".cfg"-suffix, which is automaticly
  11. added. If no configuration file is specfied, the settings
  12. in the default configuration file apply. (For configuration
  13. file details, see CONFIG.DOC.)
  14.  
  15. In Windows you'll probably want to add pcucp as a program
  16. item in the Program Manager window using the Program 
  17. Manager's File/New -command. If you have multiple setups,
  18. it is easiest to create an entry for each, specifying a
  19. different configuration file as a command line argument.
  20.  
  21.  
  22. Exiting the program
  23. ---------------------------------------------------------------------
  24.  
  25. Use Options/Exit to exit Pcucp. 
  26.  
  27.  
  28. Pcucp main window
  29. ---------------------------------------------------------------------
  30.  
  31. The Pcucp main window contains the menus to control Pcucp
  32. run-time operation. Also, the window displays various 
  33. messages, such as error messages or messages related to
  34. the progress of file transfer. In the unix-end, these 
  35. messages are written to the file pcucp.log in PCUCPDIR.
  36.  
  37.  
  38. Connecting
  39. ---------------------------------------------------------------------
  40.  
  41. In addition to the Pcucp main window, an initial terminal 
  42. window (Terminal(0)) is created at startup. Use this window 
  43. to log in your unix host. After login run the unix 
  44. executable of pcucp (possibly with a configuration file name 
  45. as command line argument). Provided that no error occurs, 
  46. you should quite instantly see a message like :
  47.  
  48.     [pcucp : you have 10 seconds to connect]
  49.     
  50. Now select Options/Connect from the Pcucp main window. After
  51. a few seconds you should see the message :
  52.  
  53.     connect : connected to <host>
  54.     
  55. If so, the connection is established. If connection times out,
  56. the configuration files in the unix- and the pc-end are probably
  57. inconsistent.
  58.  
  59. After the connection, a shell is automaticly executed in the
  60. initial terminal window. If not, the configuration files in
  61. both ends don't probably match.
  62.  
  63.  
  64. Disconnecting
  65. ---------------------------------------------------------------------    
  66.  
  67. To disconnect, select Options/Disconnect from the Pcucp main
  68. window. After a few seconds you should see the message :
  69.  
  70.     disconnect : ok
  71.     
  72. The initial terminal window now resumes the login shell.    
  73.  
  74. If disconnecting fails, processes may be left running on
  75. your unix host. If this happens, go check this with the ps
  76. command and kill any uneccessary processes.
  77.  
  78.  
  79. New Tty sessions (shells)
  80. ---------------------------------------------------------------------
  81.  
  82. Select Windows/Tty session. A new terminal window with a shell
  83. should appear before long.
  84.  
  85.  
  86. Existing tty sessions (shells)
  87. ---------------------------------------------------------------------
  88.  
  89. Active sessions can be brought to the foreground by selecting 
  90. the window name in the Window-menu.
  91.  
  92.  
  93. Removing Tty sessions (shells)
  94. ---------------------------------------------------------------------
  95.  
  96. The prefered method is to exit from the shell. You can also 
  97. close a shell window from the system menu. If you try to 
  98. close the initial terminal window, the unix process is killed, 
  99. but the window remains. Next time a new tty session is created, 
  100. the initial terminal window is used for the session.
  101.  
  102.  
  103. File transfer
  104. ---------------------------------------------------------------------
  105.  
  106. The pcucp uses two directories in both the unix and dos end 
  107. for file transfer. One of the directories (OUTDIR) contains 
  108. the files to be sent to the remote system, while the other
  109. (INDIR) is used to store the files received from the remote
  110. system.
  111.  
  112. Pcucp sends the files in OUTDIR one by one to the remote
  113. system and then DELETES the file sent. Hence, if you
  114. want to keep a copy of a file after the file has been sent,
  115. copy the file to OUTDIR. If not, move the file to OUTDIR.
  116.  
  117. In the unix end, the copying is best done by creating a 
  118. (symbolic) link in OUTDIR (ln (-s)). In dos you'll just 
  119. have to keep two copies during the transfer.
  120.  
  121. The file transfer has an automatic restart feature, which
  122. works as follows : If there is a file with the same name as
  123. the incoming file in INDIR and the file times match, the
  124. file in INDIR is assumed to be the starting part of the
  125. incoming file and only the missing part  (incoming file size
  126. - INDIR file size) is transfered.
  127.  
  128. If the file times do not match, the existing file is renamed
  129. by replacing the last character of the filename with a tilde
  130. (~). If a file with this name already exists in INDIR, it is
  131. first deleted.
  132.  
  133. The file transfer must be explicitly started with Options/
  134. File transfer/start. File transfer can be explicitly stopped 
  135. using Options/File transfer/stop. File transfer is automaticly
  136. stopped when disconnecting.
  137.  
  138. If you want to remove/add/modify files in INDIR or OUTDIR, be sure
  139. to leave alone the file being currently transfered. It is safest 
  140. to stop file transfer first to avoid errors.
  141.  
  142. Note that Pcucp has no BINARY/TEXT file types. All files are
  143. transfered 'as is' without any conversions.
  144.  
  145. ---------------------------------------------------------------------
  146. This file is a part of Pcucp, Copyright (C) 1992 Jouni Leppäjärvi
  147. ---------------------------------------------------------------------
  148.