home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / b / vmsmit.rnh < prev    next >
Text File  |  2020-01-01  |  59KB  |  1,909 lines
  1. .NO FLAGS ALL
  2. .VR SYSTEM
  3. .P0
  4. .ap
  5. .LM1.RM70
  6. .I-1
  7. .IF SYSTEM
  8. 1 Kermit
  9.  
  10. Kermit is a file transfer protocol. It allows the transfer of files over
  11. terminal lines from a remote Kermit program to the local Kermit program. 
  12.  
  13. Kermit-32 can be run from SYS$SYSTEM:.  It will then prompt for input from
  14. SYS$COMMAND:. 
  15.  
  16. Kermit-32 can be run in either local or remote modes.  In remote mode,
  17. transfers take place over the controlling terminal line.  Usually, Kermit-32
  18. is used in remote mode as a "server", meaning that it will accept commands
  19. from the other Kermit.  In local mode, Kermit-32 will perform transfers over a
  20. terminal line other than the controlling terminal. In local mode, Kermit-32 is
  21. capable of giving commands to a "server" Kermit. Note that in order to use
  22. Kermit-32 in local mode, the protection code for the terminal to be used must
  23. allow the user access.  This is set by the system manager. 
  24.  
  25. When Kermit-32 starts up, it will determine a default terminal line to be used
  26. for file transfers (and the CONNECT command) by the following process.  If
  27. there is a logical name "KER$COMM" which translates to a terminal name, the
  28. default transfer terminal will be that terminal. Otherwise, Kermit-32 checks
  29. "SYS$INPUT", "SYS$OUTPUT" and "SYS$COMMAND", (in that order), and the first
  30. one which translates to a terminal name is used as the default.  If none of
  31. these are terminals, Kermit-32 will use the terminal which controls the job
  32. which owns the process.  If the process does not have a controlling terminal,
  33. or if the terminal which was found cannot be allocated, Kermit-32 will not
  34. have a default terminal, and the SET LINE command must be used before any
  35. commands which require the transfer terminal (SEND, GET, etc.).  Kermit-32
  36. will type out a message indicating the default transfer terminal when it is
  37. started. 
  38. .b
  39. .ENDIF SYSTEM
  40. .I-1
  41. .IF SYSTEM
  42. 2 ASCII_Set
  43. .ELSE SYSTEM
  44. 1 ASCII_Set
  45. .ENDIF SYSTEM
  46. .NO FILL
  47. Oct Char     Oct Char     Oct Char     Oct Char
  48. --- ----     --- ----     --- ----     --- ----
  49.   0 NUL       40 SP       100  @       140  `  
  50.   1 SOH       41  !       101  A       141  a  
  51.   2 STX       42  "       102  B       142  b  
  52.   3 ETX       43  #       103  C       143  c  
  53.   4 EOT       44  $       104  D       144  d  
  54.   5 ENQ       45  %       105  E       145  e  
  55.   6 ACK       46  &       106  F       146  f  
  56.   7 BEL       47  '       107  G       147  g  
  57.  10 BS        50  (       110  H       150  h  
  58.  11 HT        51  )       111  I       151  i  
  59.  12 LF        52  *       112  J       152  j  
  60.  13 VT        53  +       113  K       153  k  
  61.  14 FF        54  ,       114  L       154  l  
  62.  15 CR        55  -       115  M       155  m  
  63.  16 SO        56  .       116  N       156  n  
  64.  17 SI        57  /       117  O       157  o  
  65.  20 DLE       60  0       120  P       160  p  
  66.  21 DC1       61  1       121  Q       161  q  
  67.  22 DC2       62  2       122  R       162  r  
  68.  23 DC3       63  3       123  S       163  s  
  69.  24 DC4       64  4       124  T       164  t  
  70.  25 NAK       65  5       125  U       165  u  
  71.  26 SYN       66  6       126  V       166  v  
  72.  27 ETB       67  7       127  W       167  w  
  73.  30 CAN       70  8       130  X       170  x  
  74.  31 EM        71  9       131  Y       171  y  
  75.  32 SUB       72  :       132  Z       172  z  
  76.  33 ESC       73  ;       133  [       173  {  
  77.  34 FS        74  <       134  \       174  |  
  78.  35 GS        75  =       135  ]       175  }  
  79.  36 RS        76  >       136  ^       176  ~  
  80.  37 US        77  ?       137  _       177 DEL 
  81. .FILL
  82. .I-1
  83. .IF SYSTEM
  84. 2 BYE
  85. .ELSE SYSTEM
  86. 1 BYE
  87. .ENDIF SYSTEM
  88.  
  89. This command will cause Kermit-32 (when in local mode) to tell the other
  90. Kermit (which should be in server mode) to exit from Kermit and, if
  91. applicable, terminate its job (or process, etc.).  When Kermit-32 receives the
  92. acknowledgement that this is being done, it will exit to VAX/VMS. 
  93. .b
  94. .i+10;Kermit-32>BYE
  95. .I-1
  96. .IF SYSTEM
  97. 2 CONNECT
  98. .ELSE SYSTEM
  99. 1 CONNECT
  100. .ENDIF SYSTEM
  101.  
  102. The CONNECT command will allow you to connect in as a virtual terminal over
  103. the line that was specified by the SET LINE command, or to the terminal line
  104. specified in the command. The terminal line must be one which is accessible to
  105. the users process.  This means that the applicable protection code for the
  106. terminal must have been set to allow your process to access it (done by the
  107. system manager). If a session log file was previously specified, a new version
  108. of the file will be created, and all type-out logged in the file.  The file
  109. will be closed when the command is completed (by use of an escape-character
  110. "C" command). The format of the CONNECT command is: 
  111. .b
  112. .I+10;Kermit-32>CONNECT
  113. .i+5;or
  114. .I+10;Kermit-32>CONNECT terminal-name
  115. .b
  116. where 'terminal-name' is the terminal line name to be used. 
  117. .I-1
  118. .IF SYSTEM
  119. 3 Escape_Character
  120. .ELSE SYSTEM
  121. 2 Escape_Character
  122. .ENDIF SYSTEM
  123.  
  124. This character is used to issue a limited set of commands to Kermit-32 after
  125. using the CONNECT command.  Its default value is CTRL-] (35 octal, ASCII GS)
  126. and can be changed via the SET ESCAPE command.  It is usually a good idea to
  127. set this character to something which is not used (or at least not used very
  128. much) on the system to which Kermit-32 is CONNECTing.  The command that is
  129. issued is determined by the character that is typed after the escape
  130. character.  The following characters are recognized by Kermit-32 after the
  131. escape character: 
  132. .b
  133. .i+10;C - Return to VAX/VMS Kermit-32
  134. .i+10;Q - Suspend logging to session log file (if any)
  135. .i+10;R - Resume logging to session log file (if any)
  136. .i+10;S - Show status
  137. .i+10;0 - Send a null
  138. .i+10;? - Type this text
  139. .i+5;CTRL-] - Send escape character
  140. .b
  141. Any other character will cause Kermit-32 to ring the bell at the local
  142. terminal. The escape-character S (show status) command displays the terminal
  143. line being used, the escape character and the settings of local echo, parity
  144. and session logging. 
  145. .I-1
  146. .IF SYSTEM
  147. 2 Control_Chars
  148. .ELSE SYSTEM
  149. 1 Control_Chars
  150. .ENDIF SYSTEM
  151.  
  152. During a file transfer (GET, RECEIVE or SEND commands) with Kermit-32 in local
  153. mode the following control characters can be used to affect the transfer in
  154. progress: 
  155. .b
  156. .i+10;CTRL-A - Print a brief status report
  157. .i+10;CTRL-C - Abort the protocol
  158. .i+10;CTRL-D - Turn logging to the debugging log file on/off
  159. .i+10;CTRL-M - (or RETURN) Force a protocol timeout
  160. .i+10;CTRL-X - Abort the file currently being transferred
  161. .i+10;CTRL-Z - Abort the file group currently being transferred
  162. .b
  163. The CTRL-A status report displays the protocol state and the number of NAKs
  164. sent and received. 
  165. .I-1
  166. .IF SYSTEM
  167. 2 EXIT
  168. .ELSE SYSTEM
  169. 1 EXIT
  170. .ENDIF SYSTEM
  171.  
  172. The EXIT command will cause Kermit-32 to return to command level.  This
  173. command is the same as the QUIT command.  An example of this command is: 
  174. .b
  175. .I+10;Kermit-32>EXIT
  176. .I-1
  177. .IF SYSTEM
  178. 2 FINISH
  179. .ELSE SYSTEM
  180. 1 FINISH
  181. .ENDIF SYSTEM
  182.  
  183. This command will cause Kermit-32 (when in local mode) to tell the other
  184. Kermit (which should be in server mode) to exit from Kermit. After receiving
  185. the acknowledgement that this is being done, Kermit-32 will prompt for another
  186. command. 
  187. .b
  188. .i+10;Kermit-32>FINISH
  189. .I-1
  190. .IF SYSTEM
  191. 2 GET
  192. .ELSE SYSTEM
  193. 1 GET
  194. .ENDIF SYSTEM
  195.  
  196. The GET command is used to have a local mode Kermit-32 request a file from a
  197. remote Kermit server. Kermit-32 must be running as a local Kermit (i.e., a SET
  198. LINE command must have been done).  Kermit-32 will then request the other
  199. Kermit (which must be running in server mode) to transfer the specified file
  200. (or set of files) to Kermit-32.  The file specification must be in the format
  201. of the system on which the server Kermit is running. The format of the command
  202. is: 
  203. .b
  204. .i+10;Kermit-32>GET file-spec
  205. .b
  206. Where 'file-spec' is any valid file specification on the system on which the
  207. server Kermit is running. 
  208. .I-1
  209. .IF SYSTEM
  210. 2 HELP
  211. .ELSE SYSTEM
  212. 1 HELP
  213. .ENDIF SYSTEM
  214.  
  215. Typing HELP alone prints a brief summary of Kermit-32 and its commands.  You
  216. can also type 
  217. .b
  218. .i+10;Kermit-32>HELP topic [subtopic]...
  219. .b
  220. for any Kermit-32 command, e.g. "help send" or "help set parity" to get more
  221. detailed information about a specific command. 
  222. .I-1
  223. .IF SYSTEM
  224. 2 LOCAL
  225. .ELSE SYSTEM
  226. 1 LOCAL
  227. .ENDIF SYSTEM
  228.  
  229. This command allows the user of Kermit-32 to perform various actions on the
  230. user's system. These commands provide for listing the contents of a directory,
  231. deleting files, typing files, displaying the amount of disk space used, etc.
  232. Many of these commands are performed by spawning a subprocess to execute the
  233. corresponding DCL command; therefore, the standard parameters and qualifiers
  234. which DCL allows may be used. 
  235. .b
  236. .i+10;Kermit-32>LOCAL keyword arguments
  237. .b
  238. Where 'keyword' is the name of the command, and 'arguments' are the optional
  239. arguments for the command. 
  240. .I-1
  241. .IF SYSTEM
  242. 3 COPY
  243. .ELSE SYSTEM
  244. 2 COPY
  245. .ENDIF SYSTEM
  246.  
  247. This causes Kermit-32 to make a copy of the specified file. This command uses
  248. the standard DCL COPY command.  Any options valid for DCL's COPY command may
  249. be used. 
  250. .b
  251. .i+10;Kermit-32>LOCAL COPY old-local-file
  252. .i+10;New file: new-local-file
  253. .b
  254. Where 'old-local-file' is the name of the file you wish to copy, and
  255. 'new-local-file' is the name for the copy. 
  256. .I-1
  257. .IF SYSTEM
  258. 3 CWD
  259. .ELSE SYSTEM
  260. 2 CWD
  261. .ENDIF SYSTEM
  262.  
  263. This command (short for "Change Working Directory") causes Kermit-32 to change
  264. the default directory that will be used for files whose specification does not
  265. include the directory information. This is similar to the DCL SET DEFAULT
  266. command.  If no device or directory is given, the default device and directory
  267. is set back to that which was being used when Kermit-32 was started. 
  268. .b
  269. .i+10;Kermit-32>LOCAL CWD local-directory-spec
  270. .i+5;or
  271. .i+10;Kermit-32>LOCAL CWD
  272. .b
  273. Where 'local-directory-spec' is the device and/or directory portion of a
  274. standard VAX/VMS file specification.  It may include logical names, but not
  275. wild-cards. 
  276. .I-1
  277. .IF SYSTEM
  278. 3 DELETE
  279. .ELSE SYSTEM
  280. 2 DELETE
  281. .ENDIF SYSTEM
  282.  
  283. This causes Kermit-32 to delete the specified file(s). This uses the standard
  284. DCL DELETE command. 
  285. .b
  286. .i+10;Kermit-32>LOCAL DELETE file-spec
  287. .B
  288. Where 'file-spec' is a valid VAX/VMS file specification. 
  289. .I-1
  290. .IF SYSTEM
  291. 3 DIRECTORY
  292. .ELSE SYSTEM
  293. 2 DIRECTORY
  294. .ENDIF SYSTEM
  295.  
  296. This causes Kermit-32 to display a directory listing. This uses the standard
  297. DCL DIRECTORY command. 
  298. .B
  299. .i+10;Kermit-32>LOCAL DIRECTORY file-spec
  300. .i+5;or
  301. .i+10;Kermit-32>LOCAL DIRECTORY
  302. .B
  303. Where 'file-spec' is a valid VAX/VMS file specification. 
  304. .I-1
  305. .IF SYSTEM
  306. 3 DISK_USAGE
  307. .ELSE SYSTEM
  308. 2 DISK_USAGE
  309. .ENDIF SYSTEM
  310.  
  311. This causes Kermit-32 to display the amount of disk space used and available
  312. for the given UIC (or the user's UIC if none is given). This uses the standard
  313. DCL SHOW QUOTA command. 
  314. .B
  315. .i+10;Kermit-32>LOCAL DISK_USAGE uic
  316. .i+5;or
  317. .i+10;Kermit-32>LOCAL DISK_USAGE
  318. .B
  319. Where 'uic' is a UIC specification (in square brackets). LOCAL SPACE is a
  320. synonym for the LOCAL DISK_USAGE command. 
  321. .I-1
  322. .IF SYSTEM
  323. 3 HELP
  324. .ELSE SYSTEM
  325. 2 HELP
  326. .ENDIF SYSTEM
  327.  
  328. This causes Kermit-32 to display the help message which it sends as the reply
  329. when it receives a "REMOTE HELP" command in server mode. This describes the
  330. REMOTE commands which Kermit-32 implements. 
  331. .b
  332. .i+10;Kermit-32>LOCAL HELP
  333. .I-1
  334. .IF SYSTEM
  335. 3 HOST
  336. .ELSE SYSTEM
  337. 2 HOST
  338. .ENDIF SYSTEM
  339.  
  340. This command requests Kermit-32 to perform the specified command as if it were
  341. typed by the user on a terminal.  Any results of the command will be printed
  342. on the user's terminal.  Note that this should only be used for commands which
  343. will not require any more user input, since there will be no way for the user
  344. to interact with the subprocess to supply more input. This works by spawning a
  345. subprocess (much like the DCL SPAWN command) to perform the command. 
  346. .B
  347. .i+10;Kermit-32>LOCAL HOST command
  348. .B
  349. Where 'command' is any valid DCL command. 
  350. .I-1
  351. .IF SYSTEM
  352. 3 RENAME
  353. .ELSE SYSTEM
  354. 2 RENAME
  355. .ENDIF SYSTEM
  356.  
  357. This command causes Kermit-32 to change the name of a file.  This uses the
  358. standard DCL RENAME command. 
  359. .B
  360. .i+10;Kermit-32>LOCAL RENAME old-local-file
  361. .i+10;New file: new-local-file
  362. .B
  363. Where 'old-local-file' is the name of the file to be renamed, and
  364. 'new-local-file' is the new name for the file. 
  365. .I-1
  366. .IF SYSTEM
  367. 3 SEND_MESSAGE
  368. .ELSE SYSTEM
  369. 2 SEND_MESSAGE
  370. .ENDIF SYSTEM
  371.  
  372. This command causes Kermit-32 to send a short (one line) message to the given
  373. terminal. Because this uses the DCL REPLY command, OPER privilege is needed.
  374. .B
  375. .i+10;Kermit-32>LOCAL SEND_MESSAGE terminal-name
  376. .i+10;Message: message-text
  377. .B
  378. Where 'terminal-name' is a valid name for a terminal, and 'message-text' is
  379. the message to be sent. 
  380. .I-1
  381. .IF SYSTEM
  382. 3 TYPE
  383. .ELSE SYSTEM
  384. 2 TYPE
  385. .ENDIF SYSTEM
  386.  
  387. This causes Kermit-32 to display the specified file(s) on the terminal. 
  388. .B
  389. .i+10;Kermit-32>LOCAL TYPE file-spec
  390. .b
  391. Where 'file-spec' is a valid VAX/VMS file specification. 
  392. .I-1
  393. .IF SYSTEM
  394. 3 WHO
  395. .ELSE SYSTEM
  396. 2 WHO
  397. .ENDIF SYSTEM
  398.  
  399. This displays the output of a DCL SHOW SYSTEM command. 
  400. .b
  401. .i+10;Kermit-32>LOCAL WHO
  402. .i-1
  403. .IF SYSTEM
  404. 2 LOG
  405. .ELSE SYSTEM
  406. 1 LOG
  407. .ENDIF SYSTEM
  408.  
  409. The LOG command allows the user to specify the file names to be used for the
  410. various log files Kermit-32 is capable of creating.  A LOG command without a
  411. file specification will cause no log file of that type to be created. 
  412. .B
  413. .i+10;Kermit-32>LOG log-type file-spec 
  414. .i+5;or
  415. .i+10;Kermit-32>LOG log-type
  416. .B
  417. Where 'log-type' is DEBUG, SESSION, or TRANSACTION, and 'file-spec' is the file
  418. specification to use for that type of log file.  If file-spec does not specify
  419. a file-type Kermit-32 will supply a default of .LOG. If 'file-spec' is not
  420. present, that type of logging is disabled. 
  421. .I-1
  422. .IF SYSTEM
  423. 3 DEBUG
  424. .ELSE SYSTEM
  425. 2 DEBUG
  426. .ENDIF SYSTEM
  427.  
  428. The LOG DEBUG command sets the file specification to be used for the debugging
  429. log file.  This file will be used for the debugging output produced when a SET
  430. DEBUG ON command is done.  A new version of the file is created each time a
  431. transfer command is performed, and closed upon the completion of the transfer
  432. command. 
  433. .b
  434. .i+10;Kermit-32>LOG DEBUG file-spec
  435. .i+5;or
  436. .i+10;Kermit-32>LOG DEBUG
  437. .B
  438. Where 'file-spec' is the file specification to use for the debugging log file.
  439. If file-spec does not specify a file-type Kermit-32 will supply a default
  440. of .LOG. If 'file-spec' is not present, the debugging log file is disabled. 
  441. .I-1
  442. .IF SYSTEM
  443. 3 SESSION
  444. .ELSE SYSTEM
  445. 2 SESSION
  446. .ENDIF SYSTEM
  447.  
  448. The LOG SESSION command sets the file name to be used for a log file of a
  449. "CONNECT" session.  A new version of this file is created each time the
  450. CONNECT command is used, and closed when the CONNECT command finishes (as a
  451. result of the escape command to close the session).  All output to the
  452. controlling terminal will be logged in the session log file. 
  453. .b
  454. .i+10;Kermit-32>LOG SESSION file-spec
  455. .i+5;or
  456. .i+10;Kermit-32>LOG SESSION
  457. .B
  458. Where 'file-spec' is the file specification to use for the session log file.
  459. If file-spec does not specify a file-type Kermit-32 will supply a default
  460. of .LOG. If 'file-spec' is not present, the session log file is disabled. 
  461. .I-1
  462. .IF SYSTEM
  463. 3 TRANSACTION
  464. .ELSE SYSTEM
  465. 2 TRANSACTION
  466. .ENDIF SYSTEM
  467.  
  468. The LOG TRANSACTION command sets the name of the file to be used as a
  469. transaction log file.  A new version of this file is created each time a
  470. transfer command is given (SEND, GET, SERVER, etc.).  Information about the
  471. transfer is logged in this file.  This includes the names of the files being
  472. transferred, any errors, etc. 
  473. .b
  474. .i+10;Kermit-32>LOG TRANSACTION file-spec
  475. .i+5;or
  476. .i+10;Kermit-32>LOG TRANSACTION
  477. .B
  478. Where 'file-spec' is the file specification to use for the transaction log
  479. file. If file-spec does not specify a file-type Kermit-32 will supply a
  480. default of .LOG. If 'file-spec' is not present, the transaction log file is
  481. disabled. 
  482. .I-1
  483. .IF SYSTEM
  484. 2 LOGOUT
  485. .ELSE SYSTEM
  486. 1 LOGOUT
  487. .ENDIF SYSTEM
  488.  
  489. This command will cause Kermit-32 (when in local mode) to tell the other
  490. Kermit (which should be in server mode) to exit from Kermit and, if
  491. applicable, terminate its job (or process, etc.).  When Kermit-32 receives the
  492. acknowledgement that this is being done, it will prompt for another command. 
  493. .b
  494. .i+10;Kermit-32>LOGOUT
  495. .I-1
  496. .IF SYSTEM
  497. 2 Notes
  498. .ELSE SYSTEM
  499. 1 Notes
  500. .ENDIF SYSTEM
  501.  
  502. Kermit-32 knows how to handle most standard file types.  However, it does
  503. not properly handle "stream" files.  You will probably find that stream
  504. files that contain binary data will confuse Kermit-32, very likely
  505. causing buffer overflows.  You may be able to get around the problem by
  506. SET FILE TYPE BLOCK, but there is no guarantee the file will get through
  507. unscathed.  Your best option would be to convert any stream files to
  508. another type before transferring them.
  509.  
  510. FILE TYPE BLOCK causes Kermit to do Block I/O operations ($READ, $WRITE),
  511. instead of the normal RMS $GET and $PUT operations.  Any file can be
  512. transferred using Block I/O, but the record information will be lost.
  513.  
  514. When reading a file (any file type that Kermit-32 understands), it is not
  515. necessary to tell Kermit what the file type is.  When writing a file, be
  516. sure to set FILE TYPE BINARY or FILE TYPE FIXED as appropriate if the
  517. file is not a text file.
  518. .i-1
  519. .IF SYSTEM
  520. 2 PUSH
  521. .ELSE SYSTEM
  522. 1 PUSH
  523. .ENDIF SYSTEM
  524.  
  525. The PUSH command spawns a DCL subprocess which allows you to interact with DCL
  526. without exiting Kermit-32. 
  527. .i-1
  528. .IF SYSTEM
  529. 2 QUIT
  530. .ELSE SYSTEM
  531. 1 QUIT
  532. .ENDIF SYSTEM
  533.  
  534. This command will cause Kermit-32 to return to command level.  This is the
  535. same as the EXIT command. 
  536. .b
  537. .i+10;Kermit-32>QUIT
  538. .I-1
  539. .IF SYSTEM
  540. 2 RECEIVE
  541. .ELSE SYSTEM
  542. 1 RECEIVE
  543. .ENDIF SYSTEM
  544.  
  545. The RECEIVE command is used to put Kermit-32 into remote mode waiting for a
  546. single file transfer transaction. This is most useful if the other Kermit does
  547. not support local server commands. If no file specification is given,
  548. Kermit-32 will use whatever file specification is supplied by the other Kermit
  549. (suitably altered to conform to VAX/VMS standards).  If a file specification
  550. is given, Kermit-32 will use that file specification instead of that supplied
  551. by the other Kermit.  This is most useful when the file name on the other
  552. system is such that it does not map well into a VAX/VMS file specification. 
  553. Note that if the other Kermit sends more than one file, the same name will be
  554. used for all of them. Only the version numbers will be different.  Therefore,
  555. it is best to use a file-specification on this command only when transferring
  556. a single file. The format of the command is: 
  557. .b
  558. .i+10;Kermit-32>RECEIVE
  559. .i+5;or
  560. .i+10;Kermit-32>RECEIVE file-spec
  561. .b
  562. Where 'file-spec' is any valid VAX/VMS file specification. 
  563. .I-1
  564. .IF SYSTEM
  565. 2 REMOTE
  566. .ELSE SYSTEM
  567. 1 REMOTE
  568. .ENDIF SYSTEM
  569.  
  570. This command allows the user of Kermit-32 (in local mode) to give various
  571. commands to the other Kermit (which must be in server mode). These commands
  572. provide for listing the contents of a directory, deleting files, typing files,
  573. displaying the amount of disk space used, etc. Note that not all server
  574. Kermits support all commands, but all server Kermits should respond with a
  575. message saying the command is not implemented if it does not support it. 
  576. .b
  577. .i+10;Kermit-32>REMOTE keyword arguments
  578. .b
  579. Where 'keyword' is the name of the command, and 'arguments' are the optional
  580. arguments for the command. 
  581. .I-1
  582. .IF SYSTEM
  583. 3 COPY
  584. .ELSE SYSTEM
  585. 2 COPY
  586. .ENDIF SYSTEM
  587.  
  588. This causes Kermit-32 to request that the server Kermit make a copy of the
  589. specified file.  Both the old and new files are files on the server's system -
  590. no file transfer between systems is done. The server Kermit should respond
  591. with some indication that either the file was successfully copied, or with an
  592. error message.  Note that some versions of Kermit will allow wild-carded
  593. copies, while others will only allow a single file to be copied per command. 
  594. .b
  595. .i+10;Kermit-32>REMOTE COPY old-remote-file
  596. .i+10;New file: new-remote-file
  597. .b
  598. Where 'old-remote-file' is the name of the file you wish to copy, and
  599. 'new-remote-file' is the name for the copy. 
  600. .I-1
  601. .IF SYSTEM
  602. 3 CWD
  603. .ELSE SYSTEM
  604. 2 CWD
  605. .ENDIF SYSTEM
  606.  
  607. This command (short for "Change Working Directory") causes Kermit-32 to
  608. request that the server Kermit change the default directory (path, device,
  609. etc.) that will be used for files whose specification does not include the
  610. directory information.  For some systems a password can be supplied which will
  611. allow access to the new directory.  Since Kermit-32 can not know whether the
  612. server Kermit requires a password, it will always ask for one.  If no
  613. directory is specified in the command, the server Kermit will set the default
  614. directory back to the users default.  This may be either the directory which
  615. is the default when a job created, or the default directory which was in
  616. effect when the server Kermit was started. The server Kermit should respond
  617. with a message which indicates where the new default directory has been set,
  618. or with an error message. 
  619. .b
  620. .i+10;Kermit-32>REMOTE CWD remote-directory-spec
  621. .i+10;Password: password for remote directory
  622. .i+5;or
  623. .i+10;Kermit-32>REMOTE CWD
  624. .b
  625. Where 'remote-directory-spec' is a string which is acceptable as a directory
  626. specification for the server system.  The 'password' is any string which is
  627. required as a password for access to the given directory.  The password will
  628. not be echoed. 
  629. .I-1
  630. .IF SYSTEM
  631. 3 DELETE
  632. .ELSE SYSTEM
  633. 2 DELETE
  634. .ENDIF SYSTEM
  635.  
  636. This causes Kermit-32 to request the server Kermit to delete the specified
  637. file (or files if the server Kermit supports wild-card deletes).  The server
  638. Kermit should respond with a message indicating whether the file (or files)
  639. has been deleted. 
  640. .b
  641. .i+10;Kermit-32>REMOTE DELETE file-spec
  642. .B
  643. Where 'file-spec' is a valid file specification for the remote Kermit's
  644. system. 
  645. .I-1
  646. .IF SYSTEM
  647. 3 DIRECTORY
  648. .ELSE SYSTEM
  649. 2 DIRECTORY
  650. .ENDIF SYSTEM
  651.  
  652. This causes Kermit-32 to request a directory listing from the server Kermit. 
  653. The directory listing will be printed on the users terminal. The format of the
  654. listing is determined by the server Kermit. 
  655. .B
  656. .i+10;Kermit-32>REMOTE DIRECTORY file-spec
  657. .i+5;or
  658. .i+10;Kermit-32>REMOTE DIRECTORY
  659. .B
  660. Where 'file-spec' is a valid file specification for the server
  661. Kermit's system. 
  662. .I-1
  663. .IF SYSTEM
  664. 3 DISK_USAGE
  665. .ELSE SYSTEM
  666. 2 DISK_USAGE
  667. .ENDIF SYSTEM
  668.  
  669. This causes Kermit-32 to request the server Kermit to reply with an indication
  670. of the amount of disk space used and available for the given directory (or the
  671. default directory if none is given). 
  672. .B
  673. .i+10;Kermit-32>REMOTE DISK_USAGE directory-spec
  674. .i+5;or
  675. .i+10;Kermit-32>REMOTE DISK_USAGE
  676. .B
  677. Where 'directory-spec' is a directory specification for the server Kermit's
  678. system. REMOTE SPACE is a synonym for the REMOTE DISK_USAGE command. 
  679. .I-1
  680. .IF SYSTEM
  681. 3 EXIT
  682. .ELSE SYSTEM
  683. 2 EXIT
  684. .ENDIF SYSTEM
  685.  
  686. This command is identical to the FINISH command.  It requests the server
  687. Kermit to exit to its system command parser, allowing the terminal to be used
  688. for normal commands. 
  689. .B
  690. .i+10;Kermit-32>REMOTE EXIT
  691. .I-1
  692. .IF SYSTEM
  693. 3 HELP
  694. .ELSE SYSTEM
  695. 2 HELP
  696. .ENDIF SYSTEM
  697.  
  698. This causes Kermit-32 to request the server Kermit to reply with a short
  699. summary of what commands it supports in server mode.  If an argument is given,
  700. help on the specific topic is requested.  The resulting help message will be
  701. typed on the users terminal. 
  702. .b
  703. .i+10;Kermit-32>REMOTE HELP
  704. .i+5;or
  705. .i+10;Kermit-32>REMOTE HELP topic
  706. .b
  707. Where 'topic' is a subject for more detailed help.  If no topic is given, a
  708. general help message is requested. 
  709. .I-1
  710. .IF SYSTEM
  711. 3 HOST
  712. .ELSE SYSTEM
  713. 2 HOST
  714. .ENDIF SYSTEM
  715.  
  716. This command requests the server Kermit to perform the specified command as if
  717. it were typed by the user on a terminal.  Any results of the command will be
  718. printed on the user's terminal.  Note that this should only be used for
  719. commands which will not require any more user input, since there will be no
  720. way for the user to interact with the remote system to supply more input. 
  721. .B
  722. .i+10;Kermit-32>REMOTE HOST command
  723. .B
  724. Where 'command' is any valid command to be processed by the remote systems
  725. standard command parser. 
  726. .I-1
  727. .IF SYSTEM
  728. 3 LOGIN
  729. .ELSE SYSTEM
  730. 2 LOGIN
  731. .ENDIF SYSTEM
  732.  
  733. This command allows the user to supply the server Kermit with accounting
  734. information.  The server Kermit may use this to validate the users access to
  735. the system as well as for billing purposes.  It may also use this information
  736. to provide the user with access to files on its system. 
  737. .B
  738. .i+10;Kermit-32>REMOTE LOGIN user-id
  739. .i+10;Account: remote-accounting-info
  740. .i+10;Password: remote-password
  741. .B
  742. Where 'user-id' is a string which represents a valid user identification on
  743. the remote system, 'remote-accounting-info' is any additional accounting
  744. information required by the remote system (such as account strings), and
  745. 'remote-password' is the password for the remote system which corresponds to
  746. the given 'user-id'.  The password will not be echoed. 
  747. .I-1
  748. .IF SYSTEM
  749. 3 LOGOUT
  750. .ELSE SYSTEM
  751. 2 LOGOUT
  752. .ENDIF SYSTEM
  753.  
  754. This command is the same as the LOGOUT command.  It will request the server
  755. Kermit to exit and logout its job. 
  756. .B
  757. .i+10;Kermit-32>REMOTE LOGOUT
  758. .I-1
  759. .IF SYSTEM
  760. 3 RENAME
  761. .ELSE SYSTEM
  762. 2 RENAME
  763. .ENDIF SYSTEM
  764.  
  765. This command causes Kermit-32 to request that the server Kermit change the
  766. name of a file.  The server Kermit should respond with an indication that the
  767. operation is completed successfully, or else with an error message. Some
  768. version of Kermit may allow wild-card file specifications to be used, and will
  769. respond with a list of files and new names. 
  770. .B
  771. .i+10;Kermit-32>REMOTE RENAME old-remote-file
  772. .i+10;New file: new-remote-file
  773. .B
  774. Where 'old-remote-file' is the name of the file to be renamed, and
  775. 'new-remote-file' is the new name for the file. 
  776. .I-1
  777. .IF SYSTEM
  778. 3 SEND_MESSAGE
  779. .ELSE SYSTEM
  780. 2 SEND_MESSAGE
  781. .ENDIF SYSTEM
  782.  
  783. This command requests the server Kermit to send a short (one line) message to
  784. the given destination.  Depending on the system, the destination may be a
  785. terminal, a user name, a mailbox name or some other destination address.  The
  786. server Kermit should respond with an indication of success or failure. 
  787. .B
  788. .i+10;Kermit-32>REMOTE SEND_MESSAGE destination-address
  789. .i+10;Message: message-text
  790. .B
  791. Where 'destination-address' is a valid destination for the server's system,
  792. and 'message-text' is the message to be sent. 
  793. .I-1
  794. .IF SYSTEM
  795. 3 STATUS
  796. .ELSE SYSTEM
  797. 2 STATUS
  798. .ENDIF SYSTEM
  799.  
  800. This requests the status of the server Kermit.  The server Kermit will reply
  801. with some indication of its status. 
  802. .B
  803. .i+10;Kermit-32>REMOTE STATUS
  804. .I-1
  805. .IF SYSTEM
  806. 3 TYPE
  807. .ELSE SYSTEM
  808. 2 TYPE
  809. .ENDIF SYSTEM
  810.  
  811. This causes Kermit-32 to request the server Kermit to transmit the specified
  812. file (or files if the server supports wild-cards) so that the file(s) can be
  813. typed on the users terminal. 
  814. .B
  815. .i+10;Kermit-32>REMOTE TYPE file-spec
  816. .b
  817. Where 'file-spec' is a valid file specification for the server Kermit's
  818. system. 
  819. .I-1
  820. .IF SYSTEM
  821. 3 WHO
  822. .ELSE SYSTEM
  823. 2 WHO
  824. .ENDIF SYSTEM
  825.  
  826. This requests the server Kermit to display a list of users of its system,
  827. along with other information about the users and/or system.  A specific
  828. user-id may be supplied, which may result in more detailed information about
  829. the particular user.  It is also possible to supply options for use by the
  830. server Kermit in determining the format, etc., of the resulting list. 
  831. .b
  832. .i+10;Kermit-32>REMOTE WHO user-id
  833. .i+10;Options: options-list
  834. .B
  835. Where 'user-id' is an optional string representing a specific user, and
  836. 'options-list' is an optional list of formatting or selection options. 
  837. .I-1
  838. .IF SYSTEM
  839. 2 SEND
  840. .ELSE SYSTEM
  841. 1 SEND
  842. .ENDIF SYSTEM
  843.  
  844. The SEND command will allow you to send a file(s) to the other Kermit.  The
  845. SEND command will allow file wild-card processing as is found in VAX/VMS. If
  846. Kermit-32 is running in remote mode, the file will be sent on the controlling
  847. terminal line after waiting the number of seconds specified by the SET DELAY
  848. command.  This gives the user time to escape back to the other Kermit and
  849. issue a receive command.  If Kermit-32 is running in local mode, the file will
  850. be sent immediately on the terminal line specified by the SET LINE command. 
  851. .b
  852. .i+10;Kermit-32>SEND file-spec
  853. .b
  854. Where 'file-spec' is any valid VAX/VMS file specification. 
  855. .I-1
  856. .IF SYSTEM
  857. 2 SERVER
  858. .ELSE SYSTEM
  859. 1 SERVER
  860. .ENDIF SYSTEM
  861.  
  862. This command will cause Kermit-32 to enter server mode.  The other Kermit can
  863. then issue server commands to send and receive files without having to give
  864. SEND or RECEIVE commands to Kermit-32. Kermit-32 may be put into SERVER mode
  865. while running as either a remote Kermit (transmitting over the controlling
  866. terminal line), or as a local Kermit (transmitting over a terminal specified
  867. by a SET LINE command). Note that in order to correctly receive binary files
  868. while in SERVER mode, a SET FILE TYPE BINARY command must be done first.  At
  869. this time there is no way for Kermit-32 to determine whether an incoming file
  870. is ASCII or binary. 
  871. .B
  872. .i+10;Kermit-32>SERVER
  873. .I-1
  874. .IF SYSTEM
  875. 2 SET
  876. .ELSE SYSTEM
  877. 1 SET
  878. .ENDIF SYSTEM
  879.  
  880. The SET command is used to set various parameters in Kermit-32. 
  881. .I-1
  882. .IF SYSTEM
  883. 3 BLOCK_CHECK_TYPE
  884. .ELSE SYSTEM
  885. 2 BLOCK_CHECK_TYPE
  886. .ENDIF SYSTEM
  887.  
  888. The SET BLOCK_CHECK_TYPE command is used to determine the type of block check
  889. sequence which will be used during transmission. The block check sequence is
  890. used to detect transmission errors.  There are three types of block checks
  891. available.  These are the single character checksum (default), the two
  892. character checksum, and the three character CRC (cyclic redundancy check). 
  893. This command does not ensure that the desired type of block check will be
  894. used, since both Kermit programs involved in the transfer must agree on the
  895. block check type. Kermit-32 will request that the type of block check set by
  896. this command be used for a transfer.  If the other Kermit has also had the same
  897. block check type requested, then the desired block check type will be used.
  898. Otherwise, the single character checksum will be used. (See Kermit protocol
  899. manual for more information.) 
  900. .b
  901. .i+10;Kermit-32>SET BLOCK_CHECK_TYPE type
  902. .b
  903. Where 'type' is one of: 
  904. .ls1 "o"
  905. .le;1_CHARACTER_CHECKSUM or ONE_CHARACTER_CHECKSUM
  906. .le;2_CHARACTER_CHECKSUM or TWO_CHARACTER_CHECKSUM
  907. .le;3_CHARACTER_CRC_CCITT or THREE_CHARACTER_CRC_CCITT
  908. .els
  909. .I-1
  910. .IF SYSTEM
  911. 3 DEBUGGING
  912. .ELSE SYSTEM
  913. 2 DEBUGGING
  914. .ENDIF SYSTEM
  915.  
  916. The SET DEBUGGING command is used to set the debug type-out on the user's
  917. terminal.  The command will accept either of the states ON or OFF. Kermit-32
  918. can only do debugging type-out when running as a local Kermit (SET LINE
  919. command done).  This is because the debugging type-out would interfere with
  920. the file transfer if it were sent to the controlling terminal line in remote
  921. mode. 
  922. .b
  923. .i+10;Kermit-32>SET DEBUGGING state
  924. .b
  925. Where 'state' is either ON or OFF. 
  926. .I-1
  927. .IF SYSTEM
  928. 3 DELAY
  929. .ELSE SYSTEM
  930. 2 DELAY
  931. .ENDIF SYSTEM
  932.  
  933. The DELAY parameter is the number of seconds to wait before sending data after
  934. a SEND command is given.  This is used when Kermit-32 is running in remote
  935. mode to allow the user time to escape back to the other Kermit and give a
  936. RECEIVE command. 
  937. .b
  938. .i+10;Kermit-32>SET DELAY n
  939. .b
  940. Where 'n' is the number of seconds to wait before sending data. 
  941. .I-1
  942. .IF SYSTEM
  943. 3 ESCAPE
  944. .ELSE SYSTEM
  945. 2 ESCAPE
  946. .ENDIF SYSTEM
  947.  
  948. This command will set the escape character for the CONNECT processing. The
  949. command will take the octal value of the character to use as the escape
  950. character. This is the character which is used to "escape" back to Kermit-32
  951. after using the CONNECT command.  It defaults to 35 octal (ASCII GS, CTRL-]).
  952.  It is usually a good idea to set this character to something which is not
  953. used (or at least not used very much) on the system to which Kermit-32 is
  954. CONNECTing. 
  955. .b
  956. .i+10;Kermit-32>SET ESCAPE octal-char-value
  957. .b
  958. Where 'octal-char-value' is the ASCII value (in octal) of the character to use
  959. as the escape character. 
  960. .I-1
  961. .IF SYSTEM
  962. 3 FILE
  963. .ELSE SYSTEM
  964. 2 FILE
  965. .ENDIF SYSTEM
  966.  
  967. The SET FILE command allows setting of parameters relating to the file format
  968. and file naming conventions used by Kermit-32. 
  969.  
  970. .I-1
  971. .IF SYSTEM
  972. 4 BLOCKSIZE
  973. .ELSE SYSTEM
  974. 3 BLOCKSIZE
  975. .ENDIF SYSTEM
  976.  
  977. This command sets the record size to be used when creating (receiving)
  978. files in either BINARY or FIXED mode. 
  979. .b
  980. .i+10;Kermit-32>SET FILE BLOCKSIZE n
  981. .b
  982. Where 'n' is the record size in bytes.  The default is 512 byte records.
  983.  
  984. .I-1
  985. .IF SYSTEM
  986. 4 NAMING
  987. .ELSE SYSTEM
  988. 3 NAMING
  989. .ENDIF SYSTEM
  990.  
  991. This command sets the type of processing Kermit-32 should do on file names
  992. that are being sent and received.  Kermit-32 can either send the complete file
  993. specification (including device, directories, file name, file type and version
  994. number) or only the file name and type.  When receiving a file specification,
  995. Kermit-32 can either attempt to use it as a VAX/VMS file specification as is,
  996. or first perform some substitutions and truncations in order to force the
  997. received specification to be just a valid file name and type. 
  998. .b
  999. .i+10;Kermit-32>SET FILE NAMING type
  1000. .b
  1001. Where 'type' is either FULL, NORMAL_FORM or UNTRANSLATED. 
  1002. .I-1
  1003. .IF SYSTEM
  1004. 5 FULL
  1005. .ELSE SYSTEM
  1006. 4 FULL
  1007. .ENDIF SYSTEM
  1008.  
  1009. This will cause Kermit-32 to send complete file specifications and perform no
  1010. translations on received file specifications. 
  1011. .I-1
  1012. .IF SYSTEM
  1013. 5 NORMAL_FORM
  1014. .ELSE SYSTEM
  1015. 4 NORMAL_FORM
  1016. .ENDIF SYSTEM
  1017.  
  1018. This will cause Kermit-32 to send only the file name and file type, and
  1019. perform translations on received file specifications to force them to be only
  1020. a valid file name and type. 
  1021. .I-1
  1022. .IF SYSTEM
  1023. 5 UNTRANSLATED
  1024. .ELSE SYSTEM
  1025. 4 UNTRANSLATED
  1026. .ENDIF SYSTEM
  1027.  
  1028. This will cause Kermit-32 to send only the file name and file type, and
  1029. perform no translations on received file specifications. 
  1030. .I-1
  1031. .IF SYSTEM
  1032. 4 TYPE
  1033. .ELSE SYSTEM
  1034. 3 TYPE
  1035. .ENDIF SYSTEM
  1036.  
  1037. This command will set the file type that Kermit-32 is receiving.  A file type
  1038. of ASCII should be used to receive text files which are to be used as text
  1039. files on the VAX/VMS system. The file type BINARY should be used for binary
  1040. files, such as CP/M .COM files, which need to be kept in a format that allows
  1041. the file to be returned without any changes. 
  1042. .b
  1043. .i+10;Kermit-32>SET FILE TYPE type
  1044. .b
  1045. Where 'type' is either ASCII, BINARY, BLOCK or FIXED. 
  1046. .I-1
  1047. .IF SYSTEM
  1048. 5 ASCII
  1049. .ELSE SYSTEM
  1050. 4 ASCII
  1051. .ENDIF SYSTEM
  1052.  
  1053. File type ASCII is for text files. 
  1054. .I-1
  1055. .IF SYSTEM
  1056. 5 BINARY
  1057. .ELSE SYSTEM
  1058. 4 BINARY
  1059. .ENDIF SYSTEM
  1060.  
  1061. File type BINARY is for non-text files.  Note that binary files which are
  1062. generated on a VAX/VMS system cannot be transferred to another VAX/VMS system
  1063. without losing file attributes.  
  1064. .I-1
  1065. .IF SYSTEM
  1066. 5 BLOCK
  1067. .ELSE SYSTEM
  1068. 4 BLOCK
  1069. .ENDIF SYSTEM
  1070.  
  1071. File type BLOCK causes Kermit to do Block I/O operations ($READ, $WRITE),
  1072. instead of the normal RMS $GET and $PUT operations.  Any file can be
  1073. transferred using Block I/O, but the record information will be lost.
  1074.  
  1075. This type is most useful when a file has a set of attributes which
  1076. would generate extra characters when kermit transmits a line.  One such
  1077. example would be a file with the record attribute of "Carriage return
  1078. carriage control" and a record format of FIXED or STREAM.
  1079.  
  1080. Type BINARY would normally add a <CR><LF> at the end of each record
  1081. transmitted; type BLOCK will transmit the file as it is stored on disk,
  1082. including record length counts or record seperators imbedded in the file,
  1083. without regard for record boundaries.
  1084. .I-1
  1085. .IF SYSTEM
  1086. 5 FIXED
  1087. .ELSE SYSTEM
  1088. 4 FIXED
  1089. .ENDIF SYSTEM
  1090.  
  1091. The FIXED file type will cause Kermit-32 to create a file with fixed
  1092. length records, containing only the data received from the other
  1093. Kermit. Unless specified with the SET FILE BLOCKSIZE command the file
  1094. will be created with 512 byte records.  This format can be used for
  1095. transferring VAX/VMS .EXE files or RSX-11/M (P/OS) .TSK files, or any
  1096. other binary file which is stored in fixed length record format. 
  1097. .I-1
  1098. .IF SYSTEM
  1099. 3 HANDSHAKE
  1100. .ELSE SYSTEM
  1101. 2 HANDSHAKE
  1102. .ENDIF SYSTEM
  1103.  
  1104. Sets the half duplex line turnaround handshake character Kermit-32 will use.
  1105. Normally required for communication with half duplex systems like IBM
  1106. mainframes. 
  1107. .b
  1108. .i+10;Kermit-32>SET HANDSHAKE octal-char-value
  1109. .i+5;or
  1110. .i+10;Kermit-32>SET HANDSHAKE NONE
  1111. .b
  1112. Where 'octal-char-value' is the ASCII value (in octal) of the character to use
  1113. for the handshake character.  The SET HANDSHAKE NONE command turns handshaking
  1114. off. 
  1115. .I-1
  1116. .IF SYSTEM
  1117. 3 IBM_MODE
  1118. .ELSE SYSTEM
  1119. 2 IBM_MODE
  1120. .ENDIF SYSTEM
  1121.  
  1122. The SET IBM_MODE command allows Kermit-32 to be put into a mode which will
  1123. allow transfers to an IBM host.  This causes Kermit-32 to wait for the IBM
  1124. turnaround character (XON, CTRL-Q) before sending any characters to the other
  1125. Kermit.  It also forces the parity type to be mark, and turns on local echo
  1126. for the CONNECT command. 
  1127. .b
  1128. .i+10;Kermit-32>SET IBM_MODE state
  1129. .b
  1130. Where 'state' is either ON or OFF. 
  1131. .I-1
  1132. .IF SYSTEM
  1133. 3 INCOMPLETE_FILE_DISPOSITION
  1134. .ELSE SYSTEM
  1135. 2 INCOMPLETE_FILE_DISPOSITION
  1136. .ENDIF SYSTEM
  1137.  
  1138. The SET INCOMPLETE_FILE_DISPOSITION command allows the user to determine what
  1139. is done with a file that is not completely received.  If the disposition is
  1140. KEEP, all files received will be kept, even if only a portion of the file is
  1141. received.  If the disposition is DISCARD (the default), files which are not
  1142. completely received are discarded. 
  1143. .b
  1144. .i+10;Kermit-32>SET INCOMPLETE_FILE_DISPOSITION action
  1145. .b
  1146. Where 'action' is either DISCARD or KEEP. 
  1147. .I-1
  1148. .IF SYSTEM
  1149. 3 LINE
  1150. .ELSE SYSTEM
  1151. 2 LINE
  1152. .ENDIF SYSTEM
  1153.  
  1154. This will set the terminal line that you are using. The terminal line must be
  1155. one which is accessible to the users process.  This means that the applicable
  1156. protection code for the terminal must have been set to allow your process to
  1157. access it (done by the system manager). 
  1158. .b
  1159. .i+10;Kermit-32>SET LINE terminal-name
  1160. .B
  1161. The 'terminal-name' device must be a terminal line (e.g. TTA0:). 
  1162. .I-1
  1163. .IF SYSTEM
  1164. 3 LOCAL_ECHO
  1165. .ELSE SYSTEM
  1166. 2 LOCAL_ECHO
  1167. .ENDIF SYSTEM
  1168.  
  1169. The SET LOCAL_ECHO command specifies whether characters should be echoed
  1170. locally when CONNECTing to another system.  If LOCAL_ECHO is set to ON, any
  1171. character typed on the terminal will be echoed immediately to the terminal, as
  1172. well as being sent to the other system. If LOCAL_ECHO is set to OFF (the
  1173. default), the characters typed on the terminal are only sent to the other
  1174. system (which would normally be echoing the characters). 
  1175. .b
  1176. .i+10;Kermit-32>SET LOCAL_ECHO state
  1177. .b
  1178. Where 'state' is either ON or OFF. 
  1179. .i-1
  1180. .IF SYSTEM
  1181. 3 MESSAGE
  1182. .ELSE SYSTEM
  1183. 2 MESSAGE
  1184. .ENDIF SYSTEM
  1185.  
  1186. This command sets the type of type-out Kermit-32 will do during transfers in
  1187. local mode.  Kermit-32 can type out the file specification being transferred,
  1188. the packet numbers being sent and received, both or neither. The default is to
  1189. type file specifications but not packet numbers. 
  1190. .b
  1191. .i+10;Kermit-32>SET MESSAGE type state
  1192. .b
  1193. Where 'type' is either FILE or PACKET, and 'state' is either ON or OFF. 
  1194. .i-1
  1195. .IF SYSTEM
  1196. 3 PARITY
  1197. .ELSE SYSTEM
  1198. 2 PARITY
  1199. .ENDIF SYSTEM
  1200.  
  1201. This command determines the type of parity to use on the transmission line.
  1202. Kermit-32 normally uses characters which consist of eight data bits with no
  1203. parity bit.  For systems or transmission media which require a specific parity
  1204. type, Kermit-32 can send characters as seven data bits plus a parity bit. 
  1205. .b
  1206. .i+10;Kermit-32>SET PARITY state
  1207. .b
  1208. Where 'state' is one of: 
  1209. .ls1 "o"
  1210. .le;NONE (default) - eight data bits and no parity bit.
  1211. .le;MARK - seven data bits with the parity bit set to one.
  1212. .le;SPACE - seven data bits with the parity bit set to zero.
  1213. .le;EVEN - seven data bits with the parity bit set to make the overall parity even. 
  1214. .le;ODD - seven data bits with the parity bit set to make the overall parity odd. 
  1215. .ELS
  1216. .i-1
  1217. .IF SYSTEM
  1218. 3 PROMPT
  1219. .ELSE SYSTEM
  1220. 2 PROMPT
  1221. .ENDIF SYSTEM
  1222.  
  1223. This command sets the string to be used for the command prompt.  If no
  1224. argument is given, the default prompt (Kermit-32>) is used. 
  1225. .B
  1226. .i+10;Kermit-32>SET PROMPT new-prompt-text
  1227. .i+5;or
  1228. .i+10;Kermit-32>SET PROMPT
  1229. .b
  1230. Where 'new-prompt-text' is the new prompt to use. 
  1231. .I-1
  1232. .IF SYSTEM
  1233. 3 RECEIVE
  1234. .ELSE SYSTEM
  1235. 2 RECEIVE
  1236. .ENDIF SYSTEM
  1237.  
  1238. It is possible to set various parameters associated with the receiving of the
  1239. data from the remote Kermit.  SET RECEIVE will enable you to set the various
  1240. receive parameters. 
  1241. .I-1
  1242. .IF SYSTEM
  1243. 4 END_OF_LINE
  1244. .ELSE SYSTEM
  1245. 3 END_OF_LINE
  1246. .ENDIF SYSTEM
  1247.  
  1248. This will set the end of line character the Kermit-32 expects to receive from
  1249. the remote Kermit.  This is the character which terminates a packet. The
  1250. parameter must be an octal number in the range 1 to 37. The default value is
  1251. 15 octal (ASCII CR, CTRL-M). 
  1252. .b 
  1253. .i+10;Kermit-32>SET RECEIVE END_OF_LINE octal-char-value
  1254. .b
  1255. Where 'octal-char-value' is the ASCII value (in octal) of the character to use
  1256. for the end of line character. 
  1257. .i-1
  1258. .IF SYSTEM
  1259. 4 EIGHT_BIT_QUOTE
  1260. .ELSE SYSTEM
  1261. 3 EIGHT_BIT_QUOTE
  1262. .ENDIF SYSTEM
  1263.  
  1264. This command sets the character to be used (when necessary) to quote
  1265. characters which have the eighth bit (parity bit) set.  This is used to
  1266. transfer eight-bit bytes on a transmission medium which only supports seven
  1267. data bits. The parameter must be an octal number in the range 41 to 76 or 140
  1268. to 176. The default value is 46 octal (ASCII "&").  Eighth-bit quoting will
  1269. only be used if both Kermit programs can handle it, and the transmission medium
  1270. does not transmit 8 data bits (as indicated by the SET PARITY command). 
  1271. .b
  1272. .i+10;Kermit-32>SET RECEIVE EIGHT_BIT_QUOTE octal-char-value
  1273. .b
  1274. Where 'octal-char-value' is the ASCII value (in octal) of the character to use
  1275. for quoting characters which have the eighth bit set. 
  1276. .I-1
  1277. .IF SYSTEM
  1278. 4 PACKET_LENGTH
  1279. .ELSE SYSTEM
  1280. 3 PACKET_LENGTH
  1281. .ENDIF SYSTEM
  1282.  
  1283. This will set the receive packet length.  The value for this parameter must be
  1284. between 10 and 1000.  Packet lengths outside of this range are illegal. The
  1285. default value is 80. 
  1286. .b
  1287. .i+10;Kermit-32>SET RECEIVE PACKET_LENGTH n
  1288. .b
  1289. Where 'n' is the receive packet length to use. 
  1290. .I-1
  1291. .IF SYSTEM
  1292. 4 PADCHAR
  1293. .ELSE SYSTEM
  1294. 3 PADCHAR
  1295. .ENDIF SYSTEM
  1296.  
  1297. This parameter is the padding character that is sent to the remote Kermit. The
  1298. parameter must be an octal number in the range of 0 to 37 or 177. The default
  1299. value is 0 (ASCII NUL, CTRL-@). 
  1300. .b
  1301. .i+10;Kermit-32>SET RECEIVE PADCHAR octal-char-value
  1302. .b
  1303. Where 'octal-char-value' is the ASCII value (in octal) of the character to be
  1304. used as a pad character. 
  1305. .I-1
  1306. .IF SYSTEM
  1307. 4 PADDING
  1308. .ELSE SYSTEM
  1309. 3 PADDING
  1310. .ENDIF SYSTEM
  1311.  
  1312. This command will set the number of padding characters that will be sent to
  1313. the other Kermit. The default value is 0. 
  1314. .b
  1315. .i+10;Kermit-32>SET RECEIVE PADDING n
  1316. .b
  1317. Where 'n' is the number of padding characters to use. 
  1318. .I-1
  1319. .IF SYSTEM
  1320. 4 QUOTE
  1321. .ELSE SYSTEM
  1322. 3 QUOTE
  1323. .ENDIF SYSTEM
  1324.  
  1325. This will set the quoting character that Kermit-32 will expect on incoming
  1326. messages.  This is the character used to quote control characters. The
  1327. parameter must be an octal number in the range 40 to 176. The default value is
  1328. 43 octal (ASCII "#"). 
  1329. .b
  1330. .i+10;Kermit-32>SET RECEIVE QUOTE octal-char-value
  1331. .b
  1332. Where 'octal-char-value' is the ASCII value (in octal) of the quoting
  1333. character. 
  1334. .i-1
  1335. .IF SYSTEM
  1336. 4 START_OF_PACKET
  1337. .ELSE SYSTEM
  1338. 3 START_OF_PACKET
  1339. .ENDIF SYSTEM
  1340.  
  1341. This command will set the start of packet character for Kermit-32.  The start
  1342. of packet character must be in the range of 1 to 37 octal. The default value
  1343. is 1 (ASCII SOH, CTRL-A).  This value should only be changed if absolutely
  1344. necessary.  It must be set the same in both Kermit programs. 
  1345. .b
  1346. .i+10;Kermit-32>SET RECEIVE START_OF_PACKET octal-char-value
  1347. .b
  1348. Where 'octal-char-value' is the ASCII value (in octal) of the receive 
  1349. start-of-packet character to use. 
  1350. .I-1
  1351. .IF SYSTEM
  1352. 4 TIMEOUT
  1353. .ELSE SYSTEM
  1354. 3 TIMEOUT
  1355. .ENDIF SYSTEM
  1356.  
  1357. This will set the number of seconds before Kermit-32 will time out the attempt
  1358. to receive a message.  This time out is used to handle transmission errors
  1359. which totally lose a message. The default value is 15 seconds. 
  1360. .b
  1361. .i+10;Kermit-32>SET RECEIVE TIMEOUT n
  1362. .b
  1363. Where 'n' is the number of seconds to wait for a message. 
  1364. .i-1
  1365. .IF SYSTEM
  1366. 3 REPEAT_QUOTE
  1367. .ELSE SYSTEM
  1368. 2 REPEAT_QUOTE
  1369. .ENDIF SYSTEM
  1370.  
  1371. This command sets the character to be used as the lead-in character for a
  1372. repeat sequence (a string of characters which represents some number of
  1373. characters which are repeated in the data).  Both Kermit programs must support
  1374. repeat compression for this to be in effect. The parameter must be an octal
  1375. number in the range 41 to 76 or 140 to 176. The default value is 176 octal
  1376. (ASCII "~"). The character will only be used on files which are being
  1377. transmitted by Kermit-32. The REPEAT_QUOTE character used for incoming files is
  1378. decided on by the other Kermit. A value of 40 octal (a space) will disable
  1379. repeat compression. 
  1380. .b
  1381. .i+10;Kermit-32>SET REPEAT_QUOTE octal-char-value
  1382. .b
  1383. Where 'octal-char-value' is the ASCII value (in octal) for the repeat quoting
  1384. character. 
  1385. .i-1
  1386. .IF SYSTEM
  1387. 3 RETRY
  1388. .ELSE SYSTEM
  1389. 2 RETRY
  1390. .ENDIF SYSTEM
  1391.  
  1392. This command sets the maximum number of times Kermit-32 should try to send
  1393. specific packets.  There are two retry maximums, one for the initial
  1394. connection packet (the "SEND-INIT"), the other for all other packets. The
  1395. default value for initial connections is 5.  The default value for all other
  1396. packets is 16. 
  1397. .b
  1398. .i+10;Kermit-32>SET RETRY type n
  1399. .b
  1400. Where 'type' is either INITIAL_CONNECTION (for initial connection packet)
  1401. or PACKET (for all other packets), and 'n' is the number of retries (in
  1402. decimal) to attempt. 
  1403. .I-1
  1404. .IF SYSTEM
  1405. 3 SEND
  1406. .ELSE SYSTEM
  1407. 2 SEND
  1408. .ENDIF SYSTEM
  1409.  
  1410. It is possible to set various parameters associated with the receiving
  1411. of the data from the remote Kermit.  SET SEND will enable you to set
  1412. the various SEND parameters.  These parameters should not normally be
  1413. set, since as part of the transfer initialization process the two
  1414. Kermit programs exchange their RECEIVE parameters.  The capability of
  1415. setting these parameters is provided so that the transfer
  1416. initialization can be completed even if the default parameters are not
  1417. correct. 
  1418. .I-1
  1419. .IF SYSTEM
  1420. 4 END_OF_LINE
  1421. .ELSE SYSTEM
  1422. 3 END_OF_LINE
  1423. .ENDIF SYSTEM
  1424.  
  1425. This will set the end of line character the Kermit-32 will send to the remote
  1426. Kermit.  This is the character which terminates a packet. The parameter must
  1427. be an octal number in the range 1 to 37. The default value is 15 octal (ASCII
  1428. CR, CTRL-M). 
  1429. .b
  1430. .i+10;Kermit-32>SET SEND END_OF_LINE octal-char-value
  1431. .b
  1432. Where 'octal-char-value' is the ASCII value (in octal) of the character to use
  1433. for the end of line character. 
  1434. .I-1
  1435. .IF SYSTEM
  1436. 4 PACKET_LENGTH
  1437. .ELSE SYSTEM
  1438. 3 PACKET_LENGTH
  1439. .ENDIF SYSTEM
  1440.  
  1441. This will set the SEND packet length.  The value for this parameter must be
  1442. between 10 and 1000.  Packet lengths outside of this range are illegal. The
  1443. default value is 80. 
  1444. .b
  1445. .i+10;Kermit-32>SET SEND PACKET_LENGTH n
  1446. .b
  1447. Where 'n' is the send packet length to use. 
  1448. .I-1
  1449. .IF SYSTEM
  1450. 4 PADCHAR
  1451. .ELSE SYSTEM
  1452. 3 PADCHAR
  1453. .ENDIF SYSTEM
  1454.  
  1455. This parameter is the padding character that is sent to the remote Kermit. The
  1456. parameter must be an octal number in the range of 0 to 37 or 177. The default
  1457. value is 0 (ASCII NUL, CTRL-@). 
  1458. .b
  1459. .i+10;Kermit-32>SET SEND PADCHAR octal-char-value
  1460. .b
  1461. Where 'octal-char-value' is the ASCII value (in octal) of the character to be
  1462. used as a pad character. 
  1463. .I-1
  1464. .IF SYSTEM
  1465. 4 PADDING
  1466. .ELSE SYSTEM
  1467. 3 PADDING
  1468. .ENDIF SYSTEM
  1469.  
  1470. This command will set the number of padding characters that will be sent to
  1471. the other Kermit. The default value is 0. 
  1472. .b
  1473. .i+10;Kermit-32>SET SEND PADDING n
  1474. .b
  1475. Where 'n' is the number of padding characters to use. 
  1476. .I-1
  1477. .IF SYSTEM
  1478. 4 QUOTE
  1479. .ELSE SYSTEM
  1480. 3 QUOTE
  1481. .ENDIF SYSTEM
  1482.  
  1483. This will set the quoting character that Kermit-32 will expect on incoming
  1484. messages.  This is the character used to quote control characters. The
  1485. parameter must be an octal number in the range 40 to 176. The default value is
  1486. 43 octal (ASCII "#"). 
  1487. .b
  1488. .i+10;Kermit-32>SET SEND QUOTE octal-char-value
  1489. .b
  1490. Where 'octal-char-value' is the ASCII value (in octal) of the quoting
  1491. character. 
  1492. .i-1
  1493. .IF SYSTEM
  1494. 4 START_OF_PACKET
  1495. .ELSE SYSTEM
  1496. 3 START_OF_PACKET
  1497. .ENDIF SYSTEM
  1498.  
  1499. This command will set the start of packet character for Kermit-32. 
  1500. The start of packet character must be in the range of 1 to 37 octal.
  1501. The default value is 1 (ASCII SOH, CTRL-A).  This value should only be
  1502. changed if absolutely necessary.  It must be set the same in both
  1503. Kermit programs. 
  1504. .b
  1505. .i+10;Kermit-32>SET SEND START_OF_PACKET octal-char-value
  1506. .b
  1507. Where 'octal-char-value' is the ASCII value (in octal) of the start-of-packet
  1508. character to use. 
  1509. .I-1
  1510. .IF SYSTEM
  1511. 4 TIMEOUT
  1512. .ELSE SYSTEM
  1513. 3 TIMEOUT
  1514. .ENDIF SYSTEM
  1515.  
  1516. This will set the number of seconds before Kermit-32 will time out a message
  1517. it has sent to the other Kermit. This time out is used to handle transmission
  1518. errors which totally lose a message. The default value is 15 seconds. 
  1519. .b
  1520. .i+10;Kermit-32>SET SEND TIMEOUT n
  1521. .b
  1522. Where 'n' is the number of seconds to wait for a message. 
  1523. .i-1
  1524. .IF SYSTEM
  1525. 3 SERVER_TIMER
  1526. .ELSE SYSTEM
  1527. 2 SERVER_TIMER
  1528. .ENDIF SYSTEM
  1529.  
  1530. This specifies the number of seconds between timeouts during server command
  1531. wait. A value of 0 specifies that no timeouts should occur during server
  1532. command wait. When a Kermit server times out, it sends a NAK packet.  Some
  1533. systems cannot clear piled-up NAKs from their input buffers; if you're using
  1534. such a system to communicate with a Kermit-32 server, and you expect to be
  1535. leaving the server idle for long periods of time, you should use this command
  1536. to turn off server command-wait timeouts. 
  1537. .b
  1538. .i+10;Kermit-32>SET SERVER_TIMEOUT n
  1539. .b
  1540. Where 'n' is the number of seconds between server timeouts. 
  1541.  
  1542. .I-1
  1543. .IF SYSTEM
  1544. 3 TRANSMIT
  1545. .ELSE SYSTEM
  1546. 2 TRANSMIT
  1547. .ENDIF SYSTEM
  1548.  
  1549. It is possible to set a few parameters associated with the raw
  1550. TRANSMIT command that vary both what the user sees on the screen as
  1551. well as the speed of the transmit. 
  1552.  
  1553. .I-1
  1554. .IF SYSTEM
  1555. 4 DELAY
  1556. .ELSE SYSTEM
  1557. 3 DELAY
  1558. .ENDIF SYSTEM
  1559.  
  1560. This parameter is the amount of time to delay after each carriage
  1561. return is transmitted.  Valid delay values range between 0 (the
  1562. default) and 9 tenths of a second.  The format of the command is: 
  1563. .b
  1564. .i+10;Kermit-32>SET TRANSMIT DELAY d
  1565. .b
  1566. Where 'd' is a single decimal digit representing tenths of a second.
  1567.  
  1568. Some remote hosts may not be able to receive the characters as fast as 
  1569. Kermit-32 can send them.  The TRANSMIT DELAY can be used to slow up the 
  1570. transfer by adding a slight delay after each line is sent.  
  1571.  
  1572. The transfer also runs slower if the transmit echo is on, and the
  1573. remote system is echoing the characters as it receives them.  If the
  1574. transmit delay is set to 9 tenths of a second, the remote system is
  1575. echoing characters, the transmit echo is on, and the remote system
  1576. still cannot keep up, then the connection should be made at a slower
  1577. baud rate. 
  1578.  
  1579. Conversely, the file transfer speed can be increased by: setting the
  1580. delay to 0 and the echo off, stopping the remote system from echoing
  1581. the characters it receives, and connecting at higher baud rates. 
  1582.  
  1583. .I-1
  1584. .IF SYSTEM
  1585. 4 ECHO
  1586. .ELSE SYSTEM
  1587. 3 ECHO
  1588. .ENDIF SYSTEM
  1589.  
  1590. This command controls what the user sees on the screen during the file
  1591. transfer.  The format of the command is:
  1592. .b
  1593. .i+10;Kermit-32>SET TRANSMIT ECHO state
  1594. .b
  1595. Where 'state' is either ON or OFF.
  1596.  
  1597. By default, the transmit echo is left off and the user sees the number
  1598. of each line after it has been transmitted.  With transmit echo on,
  1599. the user sees whatever the remote system would normally echo back to
  1600. him while he is typing in a file.  Note that turning the echo on
  1601. typically slows the file transfer down. 
  1602.  
  1603. .I-1
  1604. .IF SYSTEM
  1605. 2 SHOW
  1606. .ELSE SYSTEM
  1607. 1 SHOW
  1608. .ENDIF SYSTEM
  1609.  
  1610. The SHOW command will allow you to show the various parameters that are set
  1611. with the SET command. 
  1612. .I-1
  1613. .IF SYSTEM
  1614. 3 ALL
  1615. .ELSE SYSTEM
  1616. 2 ALL
  1617. .ENDIF SYSTEM
  1618.  
  1619. The SHOW ALL command will cause all of the parameters to be listed. 
  1620. .I-1
  1621. .IF SYSTEM
  1622. 3 BLOCK_CHECK_TYPE
  1623. .ELSE SYSTEM
  1624. 2 BLOCK_CHECK_TYPE
  1625. .ENDIF SYSTEM
  1626.  
  1627. This command will type out what type of block check is being requested. 
  1628. .i-1
  1629. .IF SYSTEM
  1630. 3 COMMUNICATIONS
  1631. .ELSE SYSTEM
  1632. 2 COMMUNICATIONS
  1633. .ENDIF SYSTEM
  1634.  
  1635. This command will type out the communications line related parameters. This
  1636. includes the terminal line being used, the parity type, etc. 
  1637. .I-1
  1638. .IF SYSTEM
  1639. 3 DEBUGGING
  1640. .ELSE SYSTEM
  1641. 2 DEBUGGING
  1642. .ENDIF SYSTEM
  1643.  
  1644. The SHOW DEBUGGING command will print the state of the debugging flag. 
  1645. .I-1
  1646. .IF SYSTEM
  1647. 3 DELAY
  1648. .ELSE SYSTEM
  1649. 2 DELAY
  1650. .ENDIF SYSTEM
  1651.  
  1652. This will display the number of seconds delay that Kermit-32 will use before
  1653. attempting to send or receive a file. 
  1654. .I-1
  1655. .IF SYSTEM
  1656. 3 ESCAPE
  1657. .ELSE SYSTEM
  1658. 2 ESCAPE
  1659. .ENDIF SYSTEM
  1660.  
  1661. This will display the current escape character for the CONNECT processing. 
  1662. .I-1
  1663. .IF SYSTEM
  1664. 3 FILE_PARAMETERS
  1665. .ELSE SYSTEM
  1666. 2 FILE_PARAMETERS
  1667. .ENDIF SYSTEM
  1668.  
  1669. This will display the parameters related to files being used.  This includes
  1670. the file type and the incomplete file disposition. 
  1671. .I-1
  1672. .IF SYSTEM
  1673. 3 INCOMPLETE_FILE_DISPOSITION
  1674. .ELSE SYSTEM
  1675. 2 INCOMPLETE_FILE_DISPOSITION
  1676. .ENDIF SYSTEM
  1677.  
  1678. This will display the disposition of incompletely received files. 
  1679. .I-1
  1680. .IF SYSTEM
  1681. 3 LINE
  1682. .ELSE SYSTEM
  1683. 2 LINE
  1684. .ENDIF SYSTEM
  1685.  
  1686. This command displays the terminal line that will be used for CONNECT and file
  1687. transfers commands. 
  1688. .I-1
  1689. .IF SYSTEM
  1690. 3 LOCAL_ECHO
  1691. .ELSE SYSTEM
  1692. 2 LOCAL_ECHO
  1693. .ENDIF SYSTEM
  1694.  
  1695. This will display the status of the local echo flag. 
  1696. .I-1
  1697. .IF SYSTEM
  1698. 3 PACKET
  1699. .ELSE SYSTEM
  1700. 2 PACKET
  1701. .ENDIF SYSTEM
  1702.  
  1703. This will display the current settings of the send and receive packet
  1704. parameters. 
  1705. .I-1
  1706. .IF SYSTEM
  1707. 3 PARITY
  1708. .ELSE SYSTEM
  1709. 2 PARITY
  1710. .ENDIF SYSTEM
  1711.  
  1712. This will display the current parity setting. 
  1713. .I-1
  1714. .IF SYSTEM
  1715. 3 RECEIVE
  1716. .ELSE SYSTEM
  1717. 2 RECEIVE
  1718. .ENDIF SYSTEM
  1719.  
  1720. The current values of the RECEIVE parameters will be displayed on the user's
  1721. terminal.  Only the parameters that can be set will be displayed. 
  1722. .I-1
  1723. .IF SYSTEM
  1724. 3 RETRY
  1725. .ELSE SYSTEM
  1726. 2 RETRY
  1727. .ENDIF SYSTEM
  1728.  
  1729. This command will show the maximum number of retries that Kermit-32 will
  1730. attempt to send a message to the remote Kermit. 
  1731. .I-1
  1732. .IF SYSTEM
  1733. 3 SEND
  1734. .ELSE SYSTEM
  1735. 2 SEND
  1736. .ENDIF SYSTEM
  1737.  
  1738. All of the send parameters will be displayed on the user's terminal. 
  1739. .I-1
  1740. .IF SYSTEM
  1741. 3 TIMING
  1742. .ELSE SYSTEM
  1743. 2 TIMING
  1744. .ENDIF SYSTEM
  1745.  
  1746. All of the timing parameters will be displayed on the user's terminal. 
  1747. .I-1
  1748. .IF SYSTEM
  1749. 3 TRANSMIT
  1750. .ELSE SYSTEM
  1751. 2 TRANSMIT
  1752. .ENDIF SYSTEM
  1753.  
  1754. This will display the parameters related to the TRANSMIT command.
  1755. .I-1
  1756. .IF SYSTEM
  1757. 3 VERSION
  1758. .ELSE SYSTEM
  1759. 2 VERSION
  1760. .ENDIF SYSTEM
  1761.  
  1762. Displays the version number of Kermit-32 in use. 
  1763. .i-1
  1764. .IF SYSTEM
  1765. 2 Startup
  1766. .ELSE SYSTEM
  1767. 1 Startup
  1768. .ENDIF SYSTEM
  1769.  
  1770. .i-1
  1771. .IF SYSTEM
  1772. 3 KER$COMM
  1773. .ELSE SYSTEM
  1774. 2 KER$COMM
  1775. .ENDIF SYSTEM
  1776.  
  1777. When Kermit-32 is first invoked it will attempt to use the translation 
  1778. of the logical name KER$COMM as the default terminal line for external 
  1779. communications.
  1780.  
  1781. .i-1
  1782. .IF SYSTEM
  1783. 3 VMSKERMIT
  1784. .ELSE SYSTEM
  1785. 2 VMSKERMIT
  1786. .ENDIF SYSTEM
  1787.  
  1788. When Kermit-32 is first invoked it looks for a file specified by the
  1789. VMSKERMIT logical name assignment to use as an initialization file. If
  1790. this file does not exist Kermit-32 looks for a file in your default
  1791. directory with the name VMSKERMIT.INI. 
  1792.  
  1793. If either of the above cases is true Kermit-32 will use this file as
  1794. a startup command file.
  1795.  
  1796. If the file does not exist Kermit-32 starts up in the default state.
  1797.  
  1798. For instance, placing the following two lines in the startup file would 
  1799. simplify using Kermit-32's large packet capability.
  1800. .sk1
  1801. SET RECEIVE PACKET_LENGTH 1000
  1802. .br
  1803. SET SEND PACKET_LENGTH 1000
  1804. .i-1
  1805. .IF SYSTEM
  1806. 2 STATUS
  1807. .ELSE SYSTEM
  1808. 1 STATUS
  1809. .ENDIF SYSTEM
  1810.  
  1811. The current status of Kermit-32 will be displayed.  This includes the number
  1812. of characters that have been sent and received from the remote Kermit. Also
  1813. included is an estimate of the effective baud rate of the transfer. This
  1814. number is not intended to be exact, but only an indication of what range of
  1815. throughput has been provided. 
  1816. .i-1
  1817. .IF SYSTEM
  1818. 2 TAKE
  1819. .ELSE SYSTEM
  1820. 1 TAKE
  1821. .ENDIF SYSTEM
  1822.  
  1823. The TAKE command tells Kermit-32 to execute commands from the  specified 
  1824. file. You may also use the VAX/VMS notation "@" instead of Take to specify a
  1825. command file. 
  1826. .b
  1827. .i+10;Kermit-32>TAKE file-spec
  1828. .i+5;or
  1829. .i+10;Kermit-32>TAKE file-spec /DISPLAY
  1830. .b
  1831. Where 'file-spec' is any normal VAX/VMS file specification.  If file-spec does
  1832. not specify a file-type Kermit-32 will supply a default of .COM. The /DISPLAY
  1833. option causes the commands read from the file to be displayed on the user's
  1834. terminal. 
  1835. .I-1
  1836. .IF SYSTEM
  1837. 2 TRANSMIT
  1838. .ELSE SYSTEM
  1839. 1 TRANSMIT
  1840. .ENDIF SYSTEM
  1841.  
  1842. The TRANSMIT command will allow you to transmit a file(s) to remote
  1843. systems that do not have Kermit available.  Note that there is no
  1844. error checking or packets involved in this method of file transfer. 
  1845. The format of the command is: 
  1846. .b
  1847. .i+10;Kermit-32>TRANSMIT file-spec
  1848. .b
  1849. Where 'file-spec' is any valid VAX/VMS file specification.
  1850.  
  1851. This command does a raw transmit of an ASCII file, one character at a
  1852. time, with carriage returns (no line-feeds) at the end of each line. 
  1853. It is used with Kermit-32 in local mode.  The user must first prepare
  1854. the remote host to receive the file by starting an edit session in
  1855. input mode.  Then the user can escape back to Kermit-32 and issue the
  1856. TRANSMIT command.  After the transmit is finished,  the user then
  1857. CONNECTs back to the remote host again and ends the edit session. 
  1858.  
  1859. .I-1
  1860. .IF SYSTEM
  1861. 3 Control_Characters
  1862. .ELSE SYSTEM
  1863. 2 Control_Characters
  1864. .ENDIF SYSTEM
  1865.  
  1866. During a file transmit, the following control characters can be used to affect
  1867. the transfer in progress:
  1868. .b
  1869. .i+10;CTRL-C - Abort the transmit
  1870. .i+10;CTRL-X - Abort the file currently being transmitted
  1871. .i+10;CTRL-Z - Abort the file group currently being transmitted
  1872. .b
  1873.  
  1874. .I-1
  1875. .IF SYSTEM
  1876. 3 Delay
  1877. .ELSE SYSTEM
  1878. 2 Delay
  1879. .ENDIF SYSTEM
  1880.  
  1881. Some remote hosts may not be able to receive the characters as fast as
  1882. Kermit-32 can send them.  The SET TRANSMIT DELAY command can be used
  1883. to slow up the transfer by adding a slight delay after each line is
  1884. sent. 
  1885.  
  1886. The transfer also runs slower if the transmit echo is on, and the
  1887. remote system is echoing the characters as it receives them.  If the
  1888. transmit delay is set to 9 tenths of a second, the remote system is
  1889. echoing characters, the transmit echo is on, and the remote system
  1890. still cannot keep up, then the connection should be made at a slower
  1891. baud rate. 
  1892.  
  1893. Conversely, the file transfer speed can be increased by: setting the
  1894. delay to 0 and the echo off, stopping the remote system from echoing
  1895. the characters it receives, and connecting at higher baud rates. 
  1896.  
  1897. .I-1
  1898. .IF SYSTEM
  1899. 3 Echo
  1900. .ELSE SYSTEM
  1901. 2 Echo
  1902. .ENDIF SYSTEM
  1903.  
  1904. The SET TRANSMIT ECHO command controls what the user sees on the
  1905. screen during the file transfer.  With transmit echo off, the user
  1906. sees the number of each line after it has been transmitted.  With
  1907. transmit echo on, the user sees whatever the remote system would
  1908. normally echo back to the user while he is typing in a file. 
  1909.