home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR35 / PCUCP101.ZIP / D-USE.DOC < prev    next >
Text File  |  1993-03-08  |  7KB  |  188 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.  
  16. General
  17. ---------------------------------------------------------------------
  18.  
  19. The user-interface consists of full-screen text-windows and
  20. the menu, through which commands are entered.
  21.  
  22. The menu can be summoned from any window by holding down the 
  23. Ctrl- and Alt-keys. The menu commands are selected by typing 
  24. the letter highlighted in the menu item while still holding 
  25. the Ctrl- and Alt-keys down. A menu command can be aborted by 
  26. releasing the Ctrl- and Alt-keys before the command is complete.
  27.  
  28. The commands available through the menu are :
  29.  
  30. Next-window - Switch to the next window.
  31.  
  32. Previous-window - Switch to the previous window.
  33.  
  34. Options/Exit - Exit to dos.
  35.  
  36. Options/Shell - Execute dos shell.
  37.  
  38. Options/Connect - Attempt connection.
  39.  
  40. Options/Disconnect - Close existing connection.
  41.  
  42. Options/File-transfer/Start - Begin file transfer.
  43.  
  44. Options/File-transfer/Stop - Stop file transfer.
  45.  
  46. Options/Transmit-break - Transmit break (250 ms).
  47.  
  48. Window/Kill - Close the current window.
  49.  
  50. Window/Tty-session - Create a new tty-session (unix-shell).
  51.  
  52. Note that usually only a subset of all commands depending of the
  53. state of the program is available. E.g. the windows-menu appears
  54. only after a connection to a host is established.
  55.  
  56.  
  57. Moving between windows
  58. ---------------------------------------------------------------------
  59.  
  60. You can use either the menu commands Next-Window and Previous-
  61. Window, or Ctrl-Alt-N (N = 0 - 9) to move directly to a window.
  62.  
  63.  
  64. Pcucp main window
  65. ---------------------------------------------------------------------
  66.  
  67. The main window displays various messages, such as error
  68. messages and messages related to the progress of file
  69. transfer. In the unix-end, these messages are written in
  70. the file pcucp.log in PCUCPDIR.
  71.  
  72.  
  73. Connecting
  74. ---------------------------------------------------------------------
  75.  
  76. In addition to the Pcucp main window, an initial terminal
  77. window (Terminal(0)) is created at startup. Use this window
  78. to log in your unix host. After login run the unix executable
  79. of pcucp (possibly with a configuration file name as command
  80. line argument). Provided that no error occurs, you should
  81. quite instantly see a message like :
  82.  
  83.     [pcucp : you have 10 seconds to connect]
  84.  
  85. Now select Options/Connect. After  few seconds you should see
  86. a message in the main window :
  87.  
  88.     connect : connected to <host>
  89.  
  90. If so, a connection is established. If connection times out,
  91. the configuration files in the unix- and the pc-end are 
  92. probably inconsistent.
  93.  
  94. After the connection, a shell is automaticly executed in the
  95. initial terminal window. If not, the configuration files in
  96. both ends don't probably match.
  97.  
  98.  
  99. Disconnecting
  100. ---------------------------------------------------------------------
  101.  
  102. To disconnect, select Options/Disconnect. After a few seconds
  103. you should see a message in the main window :
  104.  
  105.     disconnect : ok
  106.  
  107. The initial terminal window now resumes the login shell.
  108.  
  109. If disconnecting fails, processes may be left running on
  110. your unix host. If this happens, go check this with the ps
  111. command and kill any uneccessary processes.
  112.  
  113.  
  114. New Tty sessions (unix-shells)
  115. ---------------------------------------------------------------------
  116.  
  117. Select Windows/Tty session. A new terminal window with a shell
  118. should appear before long.
  119.  
  120.  
  121. Removing Tty sessions (unix-shells)
  122. ---------------------------------------------------------------------
  123.  
  124. Exiting from the unix-shell is the preferred method for
  125. closing a tty-window. A window can also be closed by
  126. selecting Window/Kill. If you try to close the initial 
  127. terminal window, the unix process is terminated, but the 
  128. window remains. Next time a new tty session is created, 
  129. the initial terminal window is used for the session.
  130.  
  131.  
  132. Dos shell
  133. ---------------------------------------------------------------------
  134.  
  135. A dos shell is executed with Options/Shell. This is useful e.g.
  136. if you want to copy new files to be sent while in pcucp. Note,
  137. that pcucp is completely stopped while you are using the shell
  138. and hence file transfer does not proceed and the terminal windows
  139. are not updated. No data is lost, however, since the unix-end
  140. keeps on resending the packets until pcucp is back on-line.
  141.  
  142.  
  143. File transfer
  144. ---------------------------------------------------------------------
  145.  
  146. The pcucp uses two directories in both the unix and dos end 
  147. for file transfer. One of the directories (OUTDIR) contains 
  148. the files to be sent to the remote system, while the other
  149. (INDIR) is used to store the files received from the remote
  150. system.
  151.  
  152. Pcucp sends the files in OUTDIR one by one to the remote
  153. system and then DELETES the file sent. Hence, if you
  154. want to keep a copy of a file after the file has been sent,
  155. copy the file to OUTDIR. If not, move the file to OUTDIR.
  156.  
  157. In the unix end, the copying a file is best done by
  158. creating a (symbolic) link in OUTDIR (ln (-s)). In dos
  159. you'll just have to keep two copies during the transfer.
  160.  
  161. The file transfer has an automatic restart feature, which
  162. works as follows : If there is a file with the same name as
  163. the incoming file in INDIR and the file times match, the
  164. file in INDIR is assumed to be the starting part of the
  165. incoming file and only the missing part  (incoming file size
  166. - INDIR file size) is transfered.
  167.  
  168. If the file times do not match, the existing file is renamed
  169. by replacing the last character of the filename with a tilde
  170. (~). If a file with this name already exists in INDIR, it is
  171. first deleted.
  172.  
  173. The file transfer must be explicitly started with Options/
  174. File transfer/start. File transfer can be explicitly stopped
  175. using Options/File transfer/stop. File transfer is automaticly
  176. stopped when disconnecting.
  177.  
  178. If you want to remove/add/modify files in INDIR or OUTDIR, be
  179. sure to leave alone the file being currently transfered. It
  180. is safest to stop file transfer first to avoid errors.
  181.  
  182. Note that Pcucp has no BINARY/TEXT file types. All files are
  183. transfered 'as is' without any conversions.
  184.  
  185. ---------------------------------------------------------------------
  186. This file is a part of Pcucp, Copyright (C) 1992 Jouni Leppäjärvi
  187. ---------------------------------------------------------------------
  188.