home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / pdp11 / k11hlp.rno < prev    next >
Text File  |  2020-01-01  |  70KB  |  2,167 lines
  1. .rm 70
  2. .ps 3000
  3. .lm 1
  4. .i-1;1 _@
  5. .s 1
  6.  This command opens an indirect file for command input. It is identical to
  7.  the TAKE command. The format of the command is:
  8. .lit
  9.  
  10.         Kermit-11>@ file-specification
  11.  
  12. .eli
  13.  where 'file-specification' is any valid file specification on the system
  14.  on which the server Kermit is running.
  15. .s 1
  16. .i-1;1 BINARY FILES
  17. .s 1
  18. #Binary files are those files which require all eight bits in each character.
  19. Text files, like program source files, compiler listing and RUNOFF files,
  20. normally use only the low seven bits in each character. Binary files
  21. include task images, save images, RMS relative and indexed files and other
  22. special types of files.
  23. .br
  24. #In order for Kermit to transfer these files Kermit-11 needs an eight bit
  25. line, which for most PDP-11 systems is the default. Additionally, most
  26. Kermits need to be set into a binary mode to transfer such files. The
  27. command to do this is usually the 'SET FILETYPE BINARY' command, or
  28. 'SET FIL BIN' for short. Since various Kermit implementations are at
  29. different stages of developement, most Kermit links can NOT handle
  30. binary files automatically, thus the above SET command must be given
  31. to BOTH Kermits prior to a binary file transfer. One important note
  32. is that the VMS Kermit-32 requires a SET FIL TYP FIX to properly send
  33. and receive binary files. For example, a Kermit-11 connected to a VMS
  34. system as a local Kermit would first log onto the VAX and invoke
  35. Kermit-32 and give the commands SET FIL TYP FIX and SER. Then one
  36. would escape back to the Kermit-11 (control \ C) and give Kermit-11
  37. the command SET FIL BIN (or the same, SET FIL TYP FIX).
  38. At this point the Kermit-11 can use the GET
  39. and SEND commands to transfer binary files like task images and save
  40. images.
  41. .br
  42. #As a side note, there may be cases where the proper SET commands have
  43. been given but the binary file does not transfer correctly. This has
  44. been noted on VMS when a task image is copied from tape via FLX to
  45. disk and then sent over to a PDP-11 using Kermit. The file was found
  46. to contain carriage control after it was sent to the PDP-11. This was
  47. because when FLX created it on the VAX, the file was created with fixed
  48. 512 records with carriage return control. VMS Kermit honored this and sent
  49. a CRLF every 512 bytes.
  50. .br
  51. #Please note that transfering text files when one or both of the Kermits
  52. are set to binary mode can result in an unusable file after transfer
  53. because of the possibility of transfering
  54. imbedded record control information.
  55. .s 1
  56. #Version 2.16 (and later versions) 
  57. of Kermit-11, however, can do the switch into binary mode
  58. automatically if the file attributes (and protection code for RSTS/E)
  59. indicate that the file is most likely a binary file. Additionally,
  60. two Kermit-11's connected to each other will both do the 'right' thing
  61. if this is the case by the sending Kermit-11 telling the receiving
  62. Kermit-11 to switch to binary mode. In this case, the sending Kermit-11
  63. will also send a copy of the file attributes over so the receiving
  64. Kermit-11 can properly set this when the file is closed.  Thus two
  65. Kermit-11's connected to each other can send task images, RMS indexed files
  66. and so on.
  67. .s 1
  68. .i-1;1 BYE
  69. .s 1
  70.  The BYE command will cause Kermit-11 (when in local mode) to tell the
  71.  other Kermit (which should be in server mode) to exit from Kermit and
  72.  if applicable terminate its job (or process, etc.). When Kermit-11
  73.  receives the acknowledgement that this is being done, it will prompt
  74.  for another command. The DISCONNECT command should always follow the BYE
  75.  command. The format for BYE is:
  76. .lit
  77.  
  78.         Kermit-11>BYE
  79.  
  80. .eli
  81. .s 1
  82. .i-1;1 COMMAND-LINE
  83. .s 1
  84.  Kermit, if the task is installed on RSX11M/M+ or has a CCL name for
  85.  it for RSTS/E, can get a command from the command-line and execute it
  86.  immediately. For
  87.  all commands other than SERVER, Kermit will exit upon completion of
  88.  the command. In the case of the SERVER command, Kermit will return
  89.  to interactive mode if the local Kermit sends it a FINISH command.
  90. .lit
  91.  
  92.         > KERMIT SERVER
  93.         $ KERMIT HELP
  94.  
  95. .eli
  96. .i-1;1 CONNECT
  97. .s 1
  98.  The CONNECT command will allow you to connect in as a virtual terminal
  99.  over the line that was specified by the SET LINE command. (Using the CONNECT
  100.  command before using the SET LINE command will result in an error message.)
  101.  The terminal line must be one which is accessable to the user. The format
  102.  of the CONNECT command is:
  103. .lit
  104.  
  105.         Kermit-11>CONNECT
  106.  
  107. .eli
  108. The distributed RSX11M/M+ task has been built with the /PR:0 switch to enable
  109. the task to change other terminal settings. Addtionally, for RSX11M/M+, the
  110. MCR command SET /SLAVE=TTnn: should be done before entering Kermit-11.
  111. .s 1
  112. If you are running K11POS.TSK on a PRO/350, Kermit will set the line to XK0:
  113. and the speed to 9600 by default.
  114. .s 1
  115. Please note that Kermit-11 CANNOT change the speed of a DL11 type interface,
  116. nor can it change the speed of a PDT-150 modem port (use SPEED.SAV).
  117. .s 1
  118. The following is an example of using a Racal-Vadic VA212 autodialing modem
  119. to log into a remote TOPS-20 system.  There are two points at which there
  120. is no echoing of the user input. The first is the typing of a control-E <cr>
  121. sequence to get the attention of the modem, which responds by sending the
  122. string 'HELLO:I'M READY'.  The second is the typing of the local 'escape
  123. sequence', which by default is control _\ followed by a 'C'. The control
  124. backslash informs the terminal emulator that the next character is a command.
  125. In this case, the command was 'C', which means to return to the local PDP-11
  126. system. Control _\ ? would print a help message.
  127.  
  128. .lit
  129.  
  130.  
  131.     $ kermit
  132.     Kermit-11 V2.13
  133.     Kermit-11>set logfile 20.log
  134.     Kermit-11>set deb console
  135.     Kermit-11>set lin tt58:
  136.     Link device set to TT58:
  137.     Kermit-11>set spe 1200
  138.     Kermit-11>con
  139.     Connecting to TT58:
  140.     
  141.     HELLO:I'M READY
  142.     *d
  143.     NUMBER? 
  144.     3
  145.     9-1-212-123-4567
  146.     9-1-212-123-4567
  147.     
  148.     DIALING...
  149.     ANSWER TONE
  150.     ON LINE 
  151.     
  152.     enter class 4
  153.     class 004 start
  154.     
  155.     CU20B
  156.     @log xx.abcdef 
  157.      CU20B, TOPS-20 Monitor 5.1(5101)-2
  158.      Job 28, TTY32, 2-Apr-84 4:15:24PM
  159.      Previous login was 2-Apr-84 4:10:16PM
  160.         .
  161.         .
  162.         .
  163.         .
  164.     @log
  165.     [Confirm]
  166.     Logged out Job 28, User XX.ABCDEF , TTY 32,
  167.       at  2-Apr-84 16:19:34,  Used 0:00:11 in 0:04:10
  168.     
  169.     Kermit-11>disc
  170.     KERMIT link TT58: disconnected
  171.     Kermit-11>exit
  172.     
  173.     $ logout
  174.  
  175. .eli
  176. .i-1;1 COPY
  177. .s 1
  178. The COPY command creates
  179. a copy of the input file. The Kermit-11 COPY command does
  180. NOT support wildcards in the filename, and while COPY does use multiblock
  181. buffering it is usually more efficient to use
  182. the system utilty PIP or the DCL command COPY for this.
  183. COPY uses RMS block i/o for both RSTS and RSX.
  184. Any executable RSTS file (*.TSK, *.BAC and *.SAV) copied will not be
  185. useable until it's run time system name and protection code is reset.
  186. .lit
  187.  
  188.         Kermit-11> COPY
  189.         From: ABCDEF.DAT
  190.         To  : FUBAR.LST
  191.  
  192.     or
  193.  
  194.         Kermit-11> COPY ABCDEF.DAT FUBAR.LST
  195.  
  196. .eli
  197. .s 1
  198. .i-1;1 CWD
  199. .s 1
  200. The CWD command alters the current device and UIC (PPN) default. Thus, the
  201. command 'CWD [200,200]' would cause all following file operations to insert
  202. the string [200,200] unless an explicit directory name was given. This is
  203. identical to the SET DEF command. Passwords are ignored.
  204. .s 1
  205. .i-1;1 DECNET
  206. .s 1
  207. Kermit-11 can access DECnet files if built with DAP support. This is
  208. included in the task images K11NRS.TSK and K11RSX.TSK as distributed.
  209. DECnet support has been tested for RSX11M. See SET DEFAULT for more
  210. information.
  211. .s 1
  212. .i-1;1 DELETE
  213. .s 1
  214. The DELETE command will delete the specified file or file group from the
  215. system. Wildcards are permitted.
  216. .lit
  217.  
  218.         Kermit-11>DELETE FUBAR.MAC
  219.         Kermit-11>DELETE FUBAR.*
  220.  
  221. .eli
  222. .s 1
  223. .i-1;1 DIAL
  224. .s 1
  225.  The DIAL command will take the number specified and attempt to get the
  226. attached modem to dial the phone number. The SET MODEM command must have
  227. be used first, except in the case of PRO/TMS. Additionally, if no line has
  228. been set, the SET LINE command must be used. Note that for the PRO/350, an
  229. implicit SET LINE command is done at startup for XK: or XC:.
  230. .br
  231. Once a connection is made, you will be returned to the Kermit-11 command
  232. line prompt, at which time you can use the CONNECT command to attach to
  233. the remote system.
  234. .br
  235. The case of PRO/TMS is special. This is an internal modem, accessed via
  236. device XT1:. In this case, the user MUST suplly, in the dial string, any
  237. TMS formatting or control characters. The modem type is selected automatically
  238. if you do a SET LINE XT0: or SET LINE XT1:
  239. .s 1
  240. .i-1;1 DIRECT
  241. .s 1
  242.  The DIRECT command will display the current default directory when
  243.  used in the format:
  244. .lit
  245.  
  246.         Kermit-11>DIRECT
  247.  
  248. .eli
  249.  If a directory other than the current default directory is desired then
  250.  DIRECT may be used in the format:
  251. .lit
  252.  
  253.         Kermit-11>DIRECT file-specification
  254.  
  255. .eli
  256.  where 'file-specification' is any legitimate combination of device name,
  257.  UIC or PPN, and a filename which can include wild-carding characters.
  258. .s 1
  259. .i-1;1 DISCONNECT
  260. .s 1
  261.  The DISCONNECT command causes Kermit-11 to 'hang-up' the line which was
  262.  specified with the SET LINE command and connected with the CONNECT
  263.  command. The format is:
  264. .lit
  265.  
  266.         Kermit-11>DISCONNECT
  267.  
  268. .eli
  269. .s 1
  270. .i-1;1 DISPLAY
  271. .s 1
  272.  The Display command will format and print global read/write data, defined
  273.  in K11MAC.MAC, to the terminal, as in:
  274. .lit
  275.  
  276.         Kermit-11>DISP PROMPT
  277.  
  278. .eli
  279. .s 1
  280. .i-1;1 ERASE
  281. .s 1
  282.  The ERASE command will ERASE the specified file or file group from the
  283.  system. Wildcards are permitted.
  284. .lit
  285.  
  286.         Kermit-11>ERASE FUBAR.MAC
  287.         Kermit-11>ERASE FUBAR.*
  288.  
  289. .eli
  290. The ERASE command is identical to the DELETE command.
  291. .s 1
  292. .i-1;1 EXIT
  293. .s 1
  294.  The EXIT command will cause Kermit to return to the command level. This
  295.  command is the same as the QUIT command. The format is:
  296. .lit
  297.  
  298.         Kermit-11>EXIT
  299.  
  300. .eli
  301. .s 1
  302. .i-1;1 FINISH
  303. .s 1
  304.  The FINISH command will tell Kermit-11, which is in local mode, to signal
  305.  the other Kermit to exit from server mode. When Kermit-11 has received
  306.  acknowledgement that this is being done, it will prompt for another command.
  307.  The command format is:
  308. .lit
  309.  
  310.         Kermit-11>FINISH
  311.  
  312. .eli
  313. .s 1
  314. .i-1;1 GET
  315. .s 1
  316.  The GET command tells the remote Kermit which is in server mode to get
  317.  a file or group of files. The format for this command is:
  318. .lit
  319.  
  320.  
  321.         Kermit-11>GET file-specification
  322.  
  323. .eli
  324.  where 'file-specification' may include any legitimate device, PPN or UIC as
  325.  well as the file specification. Wildcarding may be used in the file-spec.
  326.  to obtain a group of files.
  327. .s 1
  328. .i-1;1 HANGUP
  329. .s 1
  330.  The HANGUP command will drop the remote line specified by the SET LINE
  331.  command and connected by the CONNECT command. This command presumes that
  332.  the modem cable has the DTR line (pin 20) connected.
  333.  The same function is
  334.  performed by the DISCONNECT command. The format of the HANGUP command is:
  335. .lit
  336.  
  337.         Kermit-11>HANGUP
  338.  
  339. .eli
  340. .s 1
  341. .i-1;1 HELP-FILE
  342. .s 1
  343. The Kermit-11 help file (this file) should be located as follows:
  344. .lit
  345.  
  346.     For RSTS/E, RSX11M/M+
  347.  
  348.         LB:[1,2]K11HLP.HLP    or
  349.         SY:[1,2]K11HLP.HLP    or
  350.         KERMIT:K11HLP.HLP    or
  351.         HELP:K11HLP.HLP
  352.     
  353.     For RT11
  354.  
  355.         DK:K11HLP.HLP        or
  356.         SY:K11HLP.HLP
  357.  
  358.     For P/OS on the PRO/350
  359.  
  360.         [001002]K11HLP.HLP
  361.  
  362. .eli
  363. .s 1
  364. .i-1;1 HOST
  365. .s 1
  366. The HOST command is identical to the SYSTEM command in that it takes the
  367. command and spawns a process to execute the command.
  368. .lit
  369.  
  370.         Kermit-11>HOST SHO TER 
  371.  
  372.         Current settings for KB6:
  373.             Broadcast   CRFill=0    NoEcho      NoHostSync
  374.             Lowercase   NoParity    NoScope     Speed not settable
  375.             Tab         NoTTSync    Width=80
  376.  
  377.         Kermit-11>
  378.  
  379. .eli
  380. .s 1
  381. .i-1;1 INTRODUCTION
  382. .s 1
  383.  
  384.  The KERMIT file transfer protocol is intended for use in an  environment  where
  385.  there  may  be  a  diverse  mixture of computers -- micros, personal computers,
  386.  workstations, laboratory computers, timesharing systems -- from  a  variety  of
  387.  manufacturers.    All  these systems need have in common is the ability to
  388.  communicate in ASCII over ordinary serial telecommunication lines.
  389. .s 1
  390.  KERMIT was originally designed at Columbia University to meet the need for file
  391.  transfer between our DECSYSTEM-20 and IBM  370-series  mainframes  and  various
  392.  microcomputers.   It turned out that the diverse characteristics of these three
  393.  kinds of systems resulted in a design that was general enough to fit almost any
  394.  system.  The IBM mainframe, in  particular,  strains  most  common  assumptions
  395.  about how computers communicate.
  396. .s 1
  397.  The  KERMIT  protocol is specifically designed for character-oriented
  398.  transmission
  399.  over serial telecommunication lines.  The design allows for  the  restrictions
  400.  and peculiarities of the medium and the requirements of diverse operating
  401.  environments  --  buffering,  duplex, parity, character set, file organization,
  402.  etc.  The protocol is carried out by KERMIT programs on each end of the  serial
  403.  connection  sending "packets" back and forth; the sender sends file names, file
  404.  contents, and control information; the  receiver  acknowledges  (positively  or
  405.  negatively) each packet.
  406. .s 1
  407.  The  packets  have  a  layered  design,  in  keeping  with  the  ANSI  and  ISO
  408.  philosophies, with the outermost fields used by the data link layer  to  verify
  409.  data  integrity,  the  next  by the session layer to verify continuity, and the
  410.  data itself at the application level.
  411. .s 1
  412.  Connections between systems are established by the ordinary user.  In a typical
  413.  case, the user runs KERMIT on a microcomputer, enters terminal emulation,
  414.  connects to a remote host computer (perhaps by dialing up), logs in, runs
  415.  KERMIT
  416.  on the remote host, and then issues commands to that KERMIT  to  start  a  file
  417.  transfer,  "escapes"  back  to the micro, and issues commands to that KERMIT to
  418.  start its side of the file transfer.  Files may be  transferred  singly  or  in
  419.  groups.
  420. .s 1
  421.  Basic  KERMIT  provides only file transfer, and that is provided for sequential
  422.  files only, though the protocol attempts to allow for various types of
  423.  sequential files. Microcomputer implementations of KERMIT are also expected to
  424.  provide terminal emulation, to facilitate the initial connection.
  425. .s 1
  426.  More advanced implementations simplify the user interface somewhat by allowing
  427.  the KERMIT on the remote host to run as  a  "server",  which  can  transfer
  428.  files in either direction upon command from the local "user" Kermit. The server
  429.  can also provide  additional functionality, such as file management, messages,
  430.  mail, and so forth.  Other optional features  also  exist,  including  a
  431.  variety  of  block  check  types,  a mechanism for passing 8-bit data through a
  432.  7-bit communication link, a way to compressing a repeated sequence  of
  433.  characters, and so forth.
  434. .s 1
  435.  As  local area networks become more popular, inexpensive, and standardized, the
  436.  demand for KERMIT and similar protocols may dwindle, but will never wither away
  437.  entirely.  Unlike hardwired networks, KERMIT gives the ordinary user the  power
  438.  to  establish  reliable  error-free connections between any two computers; this
  439.  may always be necessary for one-shot or long-haul connections.
  440. .s 1
  441. .i-1;1 LOCAL
  442. .s 1
  443.  The LOCAL command can be used to prefix any Kermit command to insure 
  444.  that the command so prefixed will be carried out by the user's own
  445.  kermit. All commands are local by default with the exceptions of BYE,
  446.  FINISH,and GET. The LOCAL command format is:
  447. .lit
  448.  
  449.         Kermit-11>LOCAL Kermit-command-name
  450.  
  451. .eli
  452. .s 1
  453. .i-1;1 LOGFILE
  454. .s 1
  455. The LOGFILE command creates the debug and session logging file. It is
  456. identical to the SET LOGFILE command.
  457. .lit
  458.  
  459.         Kermit-11>LOGFILE FUBAR.LOG
  460.  
  461. .eli
  462. .s 1
  463. .i-1;1 Modems
  464. .s 1
  465. The question of how to set one's modem (if applicable) depends on a number
  466. of factors. For this discusion, we will be limited to considerations under
  467. RSTS/E (and to a limited degree, RSX and P/OS). This discussion is relavent to 
  468. dialing out from an attached line. Please note that the following comments
  469. will not be applicable to all types of modems.
  470. .br
  471. .i-1;2 RSTS/E
  472. .s 1
  473. RSTS/E does not control modems signals in the manner that RSX or VMS does.
  474. VMS always asserts DTR whereas RSTS/E will not assert DTR until the terminal
  475. driver can see RCD (also known as DCD) which is pin 8 (eight) for the RS232
  476. connection. If the interface is a DH11 with full modem control, a cable with
  477. all signals connected will work fine. However, if the interface is a DZ11 we
  478. have the problem that the DZ has only partial modem control. To connect 
  479. directly to a modem (like a VADIC 212, sorry, no DEC modems here) we must do
  480. one of two things:
  481. .s 1
  482. (1) Force the modem (via strapping options or whatever) to assert RCD (DCD) pin
  483. 8, thus RSTS/E will see carrier and raise DTR (pin 20 for RS232)
  484. .s 1
  485. (2) Set the terminal to LOCAL (RSTS/E V9 syntax  'SET TER TTxx:/NODIAL/PERM')
  486. and break pin 20 (DTR) and connect pin 20 to 8 on the modem side. This will
  487. cause the modem to be able to dial out and allow RSTS/E to connect to it.
  488. You will also need to have the modem assert RCD, pin 8. Keep in mind that the
  489. Kermit-11 command DISCONNECT (or HANGUP) will not function if a line is set to
  490. NODIAL (INIT SET syntax 'LOCAL').
  491. This has been tested
  492. on a Racal Vadic VA212.
  493. .s 1
  494. For those of you who have port switches such as the Gandalf type, there is
  495. one additional problem.
  496. .br
  497. For Gandalf, suppose you want to connect a DZ11 line to to an AMTB2. You
  498. will have a problem, in that the Gandalf AMTB2 wants to see RCD (DCD) asserted
  499. to make a connection. What you may need to do is this:
  500. .lit
  501.  
  502.     Make a cable for the DZ11 to AMTB2 port as follows:
  503.  
  504.     CPU side            AMTB2 side
  505.             20--|
  506.             8---|-----------8
  507.             7---------------7
  508.             3---------------2
  509.             2---------------3
  510.  
  511.     Note that 20 is tied to 8 on the CPU side.
  512.     Also, 2 is swapped for 3.
  513.  
  514. .eli
  515. Then, the Kermit-11 command SET DTR, which forces RSTS to raise DTR for
  516. 30 seconds,
  517. will cause the DTR signal to
  518. loop back to the RCD (DCD) signal and thus tell RSTS that there is carrier
  519. detect which  will raise DTR (the chicken or egg question)
  520. and get things rolling. The Kermit-11
  521. HANGUP (or DISCONNECT) command will drop DTR and force the modem to
  522. break the connection.
  523.  
  524. .i-1;2 P/OS (Pro 3xx)
  525. .s 1
  526. Under P/OS the author has used (1) a DLV11 line in the 11/23+ at home at
  527. 9600 baud without any modem signals, (2) a link using only 2,3 and 7 to a
  528. Racal Vadic 3212 (not an autodialer) and (3) a Gandalf LDS125 modem. In
  529. all cases there were no problems. It would seem that the PRO/350 comm port
  530. does not need the modem signals. This will, of course, mean that the HANGUP
  531. (or DISCONNECT) commands will NOT function since DTR is not being passed.
  532. Please note that you must ensure that pins 2 and 3 (RXD and TXD) are swapped if 
  533. you are not using some type of modem (one of the things a NULL modem cable does
  534. ).
  535. .s 1
  536. .i-1;2 RSX11M/M+
  537. .s 1
  538. The setting of the connected line (SET LINE TTnn:) depends on the signals
  539. that the modem can assert (see HELP MODEM RSTS). Since the author does not
  540. run RSX on a system with modem lines (the system is an 11/23+, DLV11 lines),
  541. the command SET RSX TC.DLU value has been added (though
  542. untested). This command can be used to set the TC.DLU parameter to 1 or 2.
  543. A value of one (1) (SET RSX TC 1) is normal for remote lines,
  544. indeed, it is the result of the MCR command SET/REMOTE=TTnn:. However, it may
  545. be the case that TC.DLU needs to be set to two (2) (SET RSX TC.DLU 2). If this
  546. SET command is used, Kermit-11 will alter it (if different from the current
  547. setting) and wait five (5) seconds for the change to come into effect.
  548. This is only applicable to modem controlled lines. There is no way (at this
  549. time) to change the TC.DLU setting to two via MCR or DCL commands
  550. (perhaps we need a SET /DIALOUT=TTnn:).
  551. .s 1
  552. For more information, please consult K11USR.DOC
  553. .s 1
  554. .i-1;1 MicroRSX
  555. .s 1
  556. Operation under MicroRSX is identical to that under RSX11M+ and, for the most
  557. part, P/OS. The image K11POS.TSK is used, as this image is linked to the
  558. resident library RMSRES, thus allowing access to named directories under
  559. MicroRSX.
  560. .s 1
  561. .i-1;1 QUIT
  562. .s 1
  563.  The QUIT command will cause Kermit-11 to return to the command level. This
  564.  command is the same as the EXIT command. The format is:
  565. .lit
  566.  
  567.         Kermit-11>QUIT
  568.  
  569. .eli
  570. .s 1
  571. .i-1;1 PARITY
  572. .s 1
  573. Sometimes two Kermit's may appear to be sending the correct packets
  574. but one or the other of them will constantly reject the same packet.
  575. This usually will be seen when the requesting Kermit asks a server
  576. for a file and then rejects the server's first packet, doing so until
  577. the retry threshold is reached. This can often be caused by parity being
  578. introduced somewhere, and one or both of the Kermit's do not know this.
  579. This can happen when a modem is generating parity or when a private
  580. or public network is doing so.
  581. Some Kermit's have a SET PARITY command to assist in this. If the
  582. communications link is introducing parity, a simple fix is to tell
  583. each Kermit the command SET PARITY SPACE. This will force the Kermit
  584. program to always remove bit 7 from the incoming data. Normally this
  585. will not affect file transfer since many Kermit implementations support
  586. what is called eight bit prefixing, which is a method of encoding an
  587. eight bit data item to fit over a seven bit link. See HELP SET PARITY
  588. for more information.
  589.  
  590. .s 1
  591. .i-1;1 PRINT
  592. .s 1
  593. The PRINT command will cause the specified file(s) to be printed on the
  594. system line printer. This command may not function on all systems.
  595. .s 1
  596. .i-1;1 PRO/350
  597. .s 1
  598. .i-1;2 RT11 version 5.1
  599. .s 1
  600. Kermit-11 runs under the RT11 version 5.1 XM monitor by using the DIGITAL
  601. distributed XC handler. The XC handler supports several useful functions
  602. such as start/stop break, variable size reads and driver/line reset. Due
  603. to an apparent bug in the driver, Kermit has to use flow control (XON/XOFF)
  604. to control the sending Kermit at high speeds (9600 baud). This has the
  605. undesireable effect of slowing the transfer down by about 15 percent.
  606. This is enabled by typing SET RTFLOW ON.
  607. .br
  608. As an alternative, the XC handler can be modified to avoid all problems
  609. with buffer overflows by increasing the buffer size in XL.MAC. See the
  610. file K11PRT.MAC for information regarding this.
  611. .s 1
  612. Note the the XC handler does not accept _.SPFUN calls to change the baud
  613. rate, rather, you must set it prior to entering Kermit-11 as in
  614. SET XC:SPEED=9600.  The Kermit DISCONNECT command will not function.
  615. Kermit will always fake a SET LINE XC0: at startup on the PRO/350.
  616. Unlike the standard RT11 Kermit-11, you DO NOT need to use the SET RTFLOW
  617. ON command to enforce flow control during the CONNECT command. The XC
  618. driver handles this automatically for you.
  619. .br
  620. To send a BREAK while in CONNECT mode, type your local escape character
  621. (normally a CTRL _\) followed by a B.
  622. .s 1
  623. .i-1;2 P/OS version 2.0
  624. .s 1
  625. Kermit-11 will run on under P/OS on the Pro/350, the executable file is
  626. called K11POS.TSK. It does NOT (and cannot) run from a menu, the normal
  627. way to run it is via the RUN command in DCL. It will support the Kermit-11
  628. attribute packets, thus a PRO/350 connected to a PDP-11 host can
  629. transparently handle binary and other types of files. The P/OS Kermit-11
  630. can be run either as a local Kermit or a Kermit server. This has been
  631. tested under P/OS version 2 connected to both a PDP-11/23+ and PDP-11/70 RSTS/E
  632. host.
  633. .br
  634. When Kermit-11 is started on the PRO, it will automatically do a SET LINE XK0:
  635. and a SET SPEED 9600. You can, of course, change the speed to whatever you
  636. need with the SET SPEED command. The line should be left as XK0:.
  637. .s 1
  638. .i-1;1 RECEIVE
  639. .s 1
  640.  The RECEIVE command will put Kermit-11 into remote mode to wait for a
  641.  single file transfer transaction. Kermit-11 will wait for a file transfer
  642.  initialization from the other kermit. This command is useful if the other
  643.  Kermit does not support local server commands. Command format is:
  644. .lit
  645.  
  646.         Kermit-11>RECEIVE
  647.  
  648. .eli
  649.  Please note that this version of Kermit-11 (Version 1) does NOT 
  650.  support the RECEIVE command in the format:
  651. .lit
  652.  
  653.         Kermit-11>RECEIVE filename
  654.  
  655. .eli
  656. .s 1
  657. .i-1;1 REMOTE
  658. .s 1
  659.  The REMOTE command is used as a prefix to indicate to Kermit-11 that the
  660.  command so prefixed is to be executed by the other (remote) Kermit server.
  661.  Command format:
  662. .lit
  663.  
  664.         Kermit-11>REMOTE
  665.  
  666. .eli
  667.  will return a prompt requesting a command name:
  668. .lit
  669.  
  670.         Remote Kermit cmd ?
  671.  
  672. .eli
  673.  REMOTE can also be used with a command name as an argument:
  674. .lit
  675.  
  676.         Kermit-11>REMOTE command-name
  677.  
  678. .eli
  679.  Please see HELP REMOTE command name for details and HELP SERVER for
  680.  general Kermit server operation.
  681. .s 1
  682. .i-1;2 BYE
  683. .s 1
  684.  The REMOTE BYE command will
  685.  cause Kermit-11 (when in local mode) to tell the
  686.  other Kermit (which should be in server mode) to exit from Kermit and
  687.  if applicable terminate its job (or process, etc.). When Kermit-11
  688.  receives the acknowledgement that this is being done, it will prompt
  689.  for another command. The DISCONNECT command should always follow. This
  690.  command (REMOTE BYE) is the same as the BYE command. The command format is:
  691. .lit
  692.  
  693.         Kermit-11>REMOTE BYE
  694.  
  695. or
  696.  
  697.         Kermit-11>REMOTE 
  698.         Remote Kermit cmd ?BYE
  699.  
  700. .eli
  701. .s 1
  702. .i-1;2 COPY
  703. .s 1
  704. The remote copy is just like the local copy command in that it creates
  705. a copy of the input file. Like the local Kermit-11 COPY command it does
  706. NOT support wildcards in the filename, and while COPY does use multiblock
  707. buffering it is usually more efficient to use
  708. the system utilty PIP or the DCL command COPY for this.  
  709. COPY uses RMS block i/o for both RSTS and RSX.
  710. Any executable RSTS file (*.TSK, *.BAC and *.SAV) copied will not be
  711. useable until it's run time system name and protection code is reset.
  712. .lit
  713.  
  714.         Kermit-11>REMOTE COPY
  715.         From: ABCDEF.DAT
  716.         To  : FUBAR.LST
  717.  
  718.     or
  719.  
  720.         Kermit-11>REMOTE COPY ABCDEF.DAT FUBAR.LST
  721.  
  722. .eli
  723. .s 1
  724. .i-1;2 CWD
  725. .s 1
  726. The REMOTE CWD command will cause Kermit-11 to send to the Kermit server
  727. the new default directory. If the server is a Kermit-11, passwords are
  728. ignored. See HELP CWD and HELP SET DEF for further information.
  729. .s 1
  730. .i-1;2 DIRECT
  731. .s 1
  732. The remote DIRECT command will tell the remote Kermit server to send a
  733. directory listing over the connection.  Not all Kermit servers have this
  734. implemented.
  735. .lit
  736.  
  737.         Kermit-11>REM DIR *.MAC
  738.  
  739. .eli
  740. The above example would tell the remote server to send a directory listing
  741. of all files ending with a .MAC filetype.
  742. .s 1
  743. .i-1;2 ERASE
  744. .s 1
  745. The remote ERASE command will tell the remote Kermit server to delete any
  746. files matching the file specification. For a Kermit-11 server, this can
  747. include wildcard characters.
  748. .lit
  749.  
  750.         Kermit-11>REM ERASE *.MAC
  751.  
  752.         Files deleted:
  753.         SY:[2,2]FUBAR.MAC
  754.         SY:[2,2]HLPSUB.MAC
  755.  
  756.         Kermit-11>
  757.  
  758. .eli
  759. The remote Kermit server may respond with the filenames deleted, the above
  760. example is what a Kermit-11 server would respond with.
  761. .s 1
  762. .i-1;2 FINISH
  763. .s 1
  764.  The REMOTE FINISH command will tell Kermit-11 ,
  765.  which is in local mode, to signal
  766.  the other Kermit to exit from server mode. When Kermit-11 has received
  767.  acknowledgement that this is being done it will prompt for another command.
  768.  REMOTE FINISH is the same as the FINISH command.
  769.  The command format is:
  770. .lit
  771.  
  772.         Kermit-11>REMOTE FINISH
  773.  
  774. or
  775.         Kermit-11>REMOTE
  776.         Remote Kermit cmd ?FINISH
  777.  
  778. .eli
  779. .s 1
  780. .i-1;2 GET
  781. .s 1
  782.  The REMOTE GET command tells the remote Kermit
  783.  which is in server mode to get
  784.  a file or group of files. REMOTE GET is the same as the GET command.
  785.  The format for this command is:
  786. .lit
  787.  
  788.         Kermit-11>REMOTE GET
  789.  
  790. or
  791.  
  792.         Kermit-11>REMOTE
  793.         Remote Kermit cmd ?GET
  794.  
  795. .eli
  796. .s 1
  797. .i-1;2 HELP
  798. .s 1
  799. The REMOTE HELP command instructs a remote Kermit server to send a list
  800. of remote commands that it can process.
  801. .s 1
  802. .i-1;2 HOST
  803. .s 1
  804. The REMOTE HOST command sends the comamnd over to the remote Kermit
  805. for execution on that system. This is only currently supported for
  806. version 8.0 of RSTS/E, and will be supported for RSX11M-Plus in the
  807. near future.
  808. .rm 80
  809. .lit
  810.  
  811.         Kermit-11>REM HOST SHO DEV
  812.  
  813.         Busy Devices:
  814.         Device      Job    Why
  815.         KB12        18       AS
  816.         PK0         29       Open
  817.         PK1         8       AS
  818.         PK2         5       AS+Open
  819.         SH0         2       Open
  820.         FE0         14       AS+Open
  821.         
  822.         Disk Structure:
  823.         Dsk Open   Size    Free  Clu Err Name   Level  Comments
  824.         DK1    0   4800   640 13%  4  0  BRIAN4  1.1   Pri, DLW, Lck
  825.         DB0   23 171796 33944 19%  4  0  SYSPAC  1.1   Pub, DLW
  826.         DB1    3 171796 15948  9%  4  0  WORK1   1.1   Pri
  827.         DB2   53 131648  7344  5%  4  0  SYSLIB  1.1   Pri, DLW
  828.  
  829.         Kermit-11>
  830.  
  831. .eli
  832. .rm 70
  833. .i-1;2 RENAME
  834. .s 1
  835.  The remote RENAME command is used to rename a file or set of files. RENAME
  836.  is used with two arguments in the format:
  837. .lit
  838.  
  839.         Kermit-11>REMOTE RENAME oldname newname
  840.  
  841. .eli
  842.  If the remote RENAME is used with one or no argument it will prompt for missing
  843.  arguments:
  844. .lit
  845.         Kermit-11>REMOTE RENAME
  846.         From: oldname
  847.         To:   newname
  848.  
  849. .eli
  850.  When the remote RENAME is finished the remote Kermit server will most
  851. likely return either a list of files renamed or a count of the number of
  852. files renamed. For a Kermit-11 server running remotely you would get
  853. a count of the number of files renamed.
  854. .lit
  855.  
  856.         Kermit-11>REMOTE RENAME t.* junk
  857.         Remote ack: 3 files renamed
  858.  
  859. .eli
  860. .s 1
  861. .i-1;2 SPACE
  862. .s 1
  863.  The REMOTE SPACE command sends a generic command to the remote Kermit
  864.  requesting information about the amounts of space available and space used on
  865.  the remote host. Command format is:
  866. .lit
  867.  
  868.         Kermit-11>REMOTE SPACE
  869.  
  870. or
  871.  
  872.         Kermit-11>REMOTE
  873.         Kermit Remote cmd ?SPACE
  874.  
  875. .eli
  876. .s 1
  877. .i-1;2 TYPE
  878. .s 1
  879. The REMOTE TYPE command is just like the TYPE command but it tells
  880. a remote Kermit server to get the file to be typed on your terminal and
  881. send it over.
  882. .lit
  883.  
  884.         Kermit-11>REMOTE TYPE FUBAR.MAC
  885.  
  886. .eli
  887. .s 1
  888. .i-1;2 WHO
  889. .s 1
  890. The REMOTE WHO command instructs a remote Kermit server to send a listing
  891. of who's logged into the system. This is currently only operational for
  892. Kermit server running under RSTS/E. Please note that this command may be
  893. restricted by the system manager.
  894. .lit
  895.  
  896.         Kermit-11>REMOTE WHO
  897.  
  898. .eli
  899. .s 1
  900. .i-1;1 RENAME
  901. .s 1
  902.  The RENAME command is used to rename a local (only) file. RENAME
  903.  can be used with two arguments is the format:
  904. .lit
  905.  
  906.         Kermit-11>RENAME oldname newname
  907.  
  908. .eli
  909.  If RENAME is used with one or no argument it will prompt for missing
  910.  arguments:
  911. .lit
  912.         Kermit-11>RENAME
  913.         From: oldname
  914.         To:   newname
  915.  
  916. .eli
  917.  When RENAME is finished it will return a 'report' of what it has done:
  918. .lit
  919.  
  920.         Kermit-11>RENAME t.* junk
  921.         File DB0:[1,8]T.T1 renamed to DB0:[1,8]JUNK.T1
  922.         File DB0:[1,8]T.T renamed to DB0:[1,8]JUNK.T
  923.  
  924. .eli
  925. .s 1
  926. .i-1;1 RESTRICTIONS
  927. .s 1
  928. Prior to version 2.21, Kermit-11 did not support 8-bit prefixing.
  929. .br
  930. Prior to version 2.23, Kermit-11 did not support repeat character
  931. encoding.
  932. .br
  933. The PRO/RT11 version of Kermit-11 will request 8-bit prefixing due to
  934. the fact that the XC handler does not support 8BIT data. For most Kermits
  935. this should not be a problem.  The XC handler always strips bit 7 from
  936. the character being sent, so the PRO/RT11 version of Kermit will
  937. request prefixing of such. It does so internally by setting PARITY to
  938. SPACE (always clear the high bit, bit seven).
  939. .i-1;1 RSTS
  940. .s 1
  941. Kermit-11 runs on version 7.2 or later of RSTS/E. Due to options
  942. present in version 8, binary file transfers will not be possible
  943. under version 7.2 of RSTS/E. This is due to the use of 8 bit mode
  944. for the terminal link to allow all characters to be passed.
  945. The so called '8BIT' termianl setting was new as of version
  946. 8.0-06 of RSTS/E.
  947. .s 1
  948. Any RSTS/E system running Kermit-11 will need the sysgen option for
  949. multiple private delimiters in the terminal driver. This special
  950. mode is needed since the 'normal' RSTS/E binary terminal mode
  951. has a 'feature' that disables binary mode whenever the terminal
  952. times out on a read. Since timeouts are essential to Kermit
  953. error recovery, binary mode can not be used for i/o.
  954. .s 1
  955. Certain functions of Kermit-11 require that the system manager
  956. install Kermit with temporary priviledges, these commands are
  957. the SYSTEM, WHO and REMOTE HOST commands. Kermit-11 does NOT
  958. need these to operate correctly.
  959. .s 1
  960. Kermit-11 can only be built under RSTS/E version 8.0 or later
  961. due to the use of RMS-11 V2.0 and new assembler directives.
  962. .s 1
  963. .i-1;1 RSX11M/M+
  964. .s 1
  965. Kermit-11 cannot be installed non-checkpointable due to an
  966. apparent RMS-11 bug. In other words, don't try to install the
  967. task '/CKP=NO'.
  968. .s 1
  969. To use the CONNECT command effectively, typeahead support is
  970. needed in the terminal driver. For RSX11M+, set the typeahead
  971. buffer   size  high,  as  in  SET  /TYPEAHEAD=TT22:200.  Also,  if  your
  972. CONNECT line is TT22: (as above), use the mcr command SET /SLAVE=TT22:
  973. .s 1
  974. Kermit-11 can only be built under RSX11M version 4.1 or later,
  975. or under RSX11M-Plus version 2.1 or later
  976. due to the use of RMS-11 v2.0 and new assembler directives.
  977. .s 1
  978. There is a SET RSX command, see HELP SET RSX for further information.
  979. .s 1
  980. As a side issue, please note that the file K11POS.TSK is quite
  981. usable under RSX, the difference being that K11RSX.TSK has DECnet support
  982. and RMS-11 overlayed in the task image (besides which, due to the lack
  983. author's systems running RSX may not be up to date)
  984. linked into it, whereas K11POS has NO DECnet support but IS linked to
  985. the RMS-11 library RMSRES (V2), thus K11POS saves disk space as well as
  986. supporting named directories, ala VMS style.
  987. .s 1
  988. .i-1;1 RT11
  989. .s 1
  990. #Kermit-11, as of version 2.20, has been tested under RT11
  991. version 5.0 under the FB and XM monitors using a DZ11 line for
  992. the link, and also on a PDT-150 using the modem port for the link.
  993. It has additionally been run under Micro-11's and the PRO/350 using
  994. the XL and XC handlers respectively.
  995. .br
  996. #As of Kermit-11 v2.39, RT11 users can use a SET LIN TT:, which will force
  997. Kermit-11 to use the CONSOLE port for all I/O, with the restriction that
  998. CONSOLE port I/O must request 8bit prefixing for the transfer of BINARY
  999. data. Additionally, if the RT11 system lacks both MT service and the XL/XC
  1000. handler,
  1001. Kermit-11 will use the console by default.
  1002. .s 1
  1003. #Kermit-11 requires
  1004. _.TWAIT support as well as multiple terminal support. The use
  1005. of multiple terminal support allows Kermit-11 to use any type
  1006. of interface sysgened, including the DZ11 and DZV11. The exceptions
  1007. for MT support and/or XC/XL support are noted above regarding console only
  1008. usage.
  1009. .br
  1010. #It is possible under version 5 of RT11 to use the XL: handler
  1011. instead of the multiple terminal support. The use of the XL:
  1012. driver will result in much faster file transfer at high baud
  1013. rates. Note that XL: must be set up at system startup or at
  1014. some time later to set the proper speed, CSR and vector.
  1015. For PRO/RT11 information, see HELP PRO RT11.
  1016. .br
  1017. .s 1
  1018. #Please note that the device name syntax for terminal lines follows
  1019. the MT unit numbers, thus if a SHO TER gave unit 5 for DZ11 line 0
  1020. the the device name would be:
  1021. .lit
  1022.  
  1023.     Kermit-11>SET LINE 5
  1024.  
  1025. If you must use the console port:
  1026.  
  1027.     Kermit-11>SET LIN TT:
  1028.  
  1029. If you use the XL handler, you would do this:
  1030.  
  1031.     Kermit-11>SET LINE XL:
  1032.  
  1033. .eli
  1034. Additionally, Kermit-11 for RT11 looks for its help file, K11HLP.HLP,
  1035. on DK: first and then on SY: if the first one fails.
  1036. .s 1
  1037. Full wildcarding is supported for RT11, in the form *.type, name.*,
  1038. *.* and the % character to match any single character.
  1039. .s 1
  1040. Kermit-11 can only be built on RT11 version 5.0 or later due
  1041. to the use of new assembler directives.
  1042. .br
  1043. Please note that for the CONNECT command under RT11 and the use of the
  1044. MT service,
  1045. you will most
  1046. likely need XON/XOFF flow control to be generated by Kermit-11. This
  1047. is enabled with the SET RTFLOW ON command. This is by default OFF since
  1048. the modem the author uses, a Vadic 212LS, can't handle XONs and XOFFs
  1049. while in command mode. The solution here is to escape back to Kermit
  1050. command mode after the remote system has been logged into, and then
  1051. type SET RTFLOW ON.
  1052. .s 1
  1053. Due to overlaying constraints, the RT11 Kermit-11 will not
  1054. accept wildcards for the RENAME and DELETE commands and the REMOTE
  1055. server equivalents.
  1056. .s 1
  1057. The executable files are K11XM.SAV for the XM system and PRO/350, and
  1058. K11RT4 for the FB system.
  1059. .s 1
  1060. For notes regarding hardware, see K11USR.DOC
  1061.  
  1062. .s 1
  1063. .i-1;1 SEND
  1064. .s 1
  1065.  The SEND command will allow the user to send a file(s) to the other
  1066.  Kermit. If Kermit-11 is running in remote mode the file will be sent
  1067.  on the controlling terminal line after waiting the number of seconds
  1068.  specified by the SET DELAY command. This gives the user time to escape
  1069.  to the other Kermit and issue a receive command. If Kermit-11 is running
  1070.  in local mode , the file will be sent immediately on the terminal line
  1071.  specified by the SET LINE command. Format of the SEND command is:
  1072. .lit
  1073.  
  1074.         Kermit-11>SEND file-specification
  1075.  
  1076. .eli
  1077.  Where 'file-specification' can include device, PPN, or UIC, as well as
  1078.  the file-spec. which may use wildcarding.
  1079. .s 1
  1080. .i-1;1 SERVER
  1081. .s 1
  1082.  The SERVER command will put Kermit-11 into server mode. When Kermit-11
  1083.  is in server mode while running as a remote Kermit (transmitting over
  1084.  the controlling terminal line) the other Kermit can issue server
  1085.  commands to send and receive files without having to give SEND or
  1086.  RECEIVE commands to Kermit-11. In order to correctly receive binary
  1087.  files while in server mode a SET FILETYPE BINARY must be done first.
  1088.  At this time there is no way for Kermit-11 to determine whether an
  1089.  incomming file is ASCII or binary. Command format is:
  1090. .lit
  1091.  
  1092.         Kermit-11>SERVER
  1093.  
  1094.  
  1095.  At this time, the Kermit-11 server can process the following
  1096.  commands:
  1097.  
  1098.         BYE        Logout Kermit-11.
  1099.         REMOTE COPY    Copy a file to another.
  1100.         REMOTE DIR     Prints a directory out.
  1101.         REMOTE DISK    Prints the disk  space.
  1102.         REMOTE ERASE    Delete the filename(s).
  1103.         FINISH        Exits Kermit-11 server.
  1104.         GET         Sends  the filename(s).
  1105.         REMOTE HELP    Prints this  help text.
  1106.         REMOTE HOST    Execute a host command.
  1107.         REMOTE RENAME    Rename old file to new.
  1108.         REMOTE SPACE    Prints the disk  space.
  1109.         REMOTE TYPE    Prints the filename(s).
  1110.         REMOTE WHO    Shows users logged  in.
  1111.  
  1112.  
  1113. .eli
  1114. .s 1
  1115. .i-1;1 SET
  1116. .s 1
  1117.  The SET command is used to set various parameters in Kermit.
  1118.  The format of the SET command is:
  1119. .lit
  1120.  
  1121.         Kermit-11>SET parameter keyword
  1122.  
  1123. .eli
  1124. .s 1
  1125. .i-1;2 ATTRIBUTES
  1126. .s 1
  1127. Part of the Kermit protocol is the support of file attributes. Connected
  1128. Kermits that support this can send information to each other about file
  1129. size, time/date of creation, RMS file headers and other useful things.
  1130. Due to potential problems with incompatible implementations this feature
  1131. can be disabled. In this case, the sending Kermit-11 will never try to
  1132. send file attributes, even though the receiver may have indicated that it
  1133. supports this.
  1134. .lit
  1135.  
  1136.         Kermit-11>SET ATTRIBUTES OFF
  1137.         Kermit-11>SET ATTRIBUTES ON
  1138.         Kermit-11>SET NOATTRIBUTES
  1139.  
  1140. .eli
  1141. .s 1
  1142. .i-1;2 BAUD
  1143. .s 1
  1144. This is the same as SET SPEED.  See HELP SET SPEED
  1145. .s 1
  1146. .i-1;2 BINARY-TYPE
  1147. .s 1
  1148. Kermit-11 has a default list of filetypes that are scanned to decide if a file
  1149. should be sent in binary mode in addition to checking file attributes for RSX,
  1150. P/OS and RSTS/E. The user can, however, overide this list with the this command.
  1151. The default list is fairly inclusive, with types such as .SAV and .TSK forcing
  1152. Kermit-11 into binary transmission. See HELP SET FIL for the default list.
  1153. .lit
  1154.  
  1155.     Kermit-11> SET BINARY-TYPE .SAV
  1156.     Kermit-11> SET BIN .EXE
  1157.  
  1158. .eli
  1159. .s 1
  1160. .i-1;2 BLOCK-CHECK
  1161. .s 1
  1162.  The SET BLOCK_CHECK command is used to  determine  the  
  1163.  block  check  sequence  which  will be used during transmission.  The
  1164.  block check sequence is used to detect  transmission  errors.   There
  1165.  are  three  types  of  block  check  available.  These are the single
  1166.  character checksum (default), the two  character  checksum,  and  the
  1167.  three character CRC (cyclic redundancy check).  This command does not
  1168.  ensure that the desired type of block check will be used, since  both
  1169.  Kermit's involved in the transfer must agree on the block check type.
  1170.  Kermit-11 will request that the type  of  block  check  set  by  this
  1171.  command be used for a transfer.  If the other Kermit has also had the
  1172.  same block check type requested, then the desired  block  check  type
  1173.  will be used.  Otherwise, the single character checksum will be used.
  1174.  The command should be given to BOTH Kermits since Kermit-11, when in
  1175.  server mode, has no say about what kind of checksum it wants to use.
  1176.  (See Kermit protocol manual for more information.)
  1177. .lit
  1178.  
  1179.            Kermit-11>SET BLOCK_CHECK keyword
  1180.        Kermit-11>SET BLO 1
  1181.        Kermit-11>SET BLO 2
  1182.        Kermit-11>SET BLO 3
  1183.  
  1184. .eli
  1185.  Where keyword is one of:
  1186. .lit
  1187.  
  1188.       1_CHARACTER_CHECKSUM or ONE_CHARACTER_CHECKSUM
  1189.  
  1190.       2_CHARACTER_CHECKSUM or TWO_CHARACTER_CHECKSUM
  1191.  
  1192.       3_CHARACTER_CRC_CCITT or THREE_CHARACTER_CRC_CCITT
  1193.  
  1194. .eli
  1195. .s 1
  1196. .i-1;2 CONSOLE
  1197. .s 1
  1198.  The SET CONSOLE command is used under P/OS to control the passing of
  1199.  8 bit data to th terminal during the CONNECT command. If you are
  1200.  getting multinational characters being printed, this is a very useful
  1201.  thing to set. The default is SET CON 7.
  1202. .lit
  1203.  
  1204.     Kermit-11>SET CON 8
  1205.     Kermit-11>SET CON 7
  1206.  
  1207. .eli
  1208. .s 1
  1209. .i-1;2 DEBUG
  1210. .s 1
  1211.  The SET DEBUG command is used to specify the type and level of debugging
  1212.  to a disk file . This disk file must have been created by the SET LOGFILE
  1213.  command. The format for SET DEBUG is:
  1214. .lit
  1215.  
  1216.         Kermit-11>SET DEBUG qualifier
  1217.         Kermit-11>SET NODEBUG
  1218.  
  1219. .eli
  1220. .s 1
  1221. .i-1;3 ALL
  1222. .s 1
  1223.  SET DEBUG ALL will turn on logging for CONSOLE, CONNECT, FILE, PACKET
  1224.  and STATE to the disk file specified by SET LOGFILE.
  1225.  This command is the same as SET DEBUG ON. The command format is:
  1226. .lit
  1227.  
  1228.         Kermit-11>SET DEBUG ALL
  1229.  
  1230. .eli
  1231. .s 1
  1232. .i-1;3 CONSOLE
  1233. .s 1
  1234.  SET DEBUG CONSOLE will turn on logging for all I/O during a remote
  1235.  CONNECT to the disk file specified by SET LOGFILE.
  1236.  This command is the same as SET DEBUG CONNECT.
  1237.  The command format is:
  1238. .lit
  1239.  
  1240.         Kermit-11>SET DEBUG CONSOLE
  1241.  
  1242. .eli
  1243. .s 1
  1244. .i-1;3 CONNECT
  1245. .s 1
  1246.  SET DEBUG CONNECT will turn on logging for all I/O during a remote
  1247.  CONNECT to the disk file specified by SET LOGFILE.
  1248.  This command is the same as SET DEBUG CONSOLE.
  1249.  The command format is:
  1250. .lit
  1251.  
  1252.         Kermit-11>SET DEBUG CONNECT
  1253.  
  1254. .eli
  1255. .s 1
  1256. .i-1;3 FILE
  1257. .s 1
  1258.  SET DEBUG FILE will log all file 'opens' and 'creates' to the file specified
  1259.  by SET LOGFILE. The command format is:
  1260. .lit
  1261.  
  1262.         Kermit-11>SET DEBUG FILE
  1263.  
  1264. .eli
  1265. .s 1
  1266. .i-1;3 HELP
  1267. .s 1
  1268.  SET DEBUG HELP gives the user a list of all qualifiers which can be
  1269.  used with SET DEBUG. Command format is:
  1270. .lit
  1271.  
  1272.         Kermit-11>SET DEBUG HELP
  1273.  
  1274. .eli
  1275. .s 1
  1276. .i-1;3 NONE
  1277. .s 1
  1278.  SET DEBUG NONE turns off all debugging. This is the same as the 
  1279.  SET DEBUG OFF command. Command format is:
  1280. .lit
  1281.  
  1282.         Kermit-11>SET DEBUG NONE
  1283.  
  1284. .eli
  1285. .s 1
  1286. .i-1;3 OFF
  1287. .s 1
  1288. SET DEBUG OFF turns off all debugging. This is the same as the
  1289. SET DEBUG NONE command. Command format is:
  1290. .lit
  1291.  
  1292.         Kermit-11>SET DEBUG OFF
  1293.  
  1294. .eli
  1295. .s 1
  1296. .i-1;3 ON
  1297. .s 1
  1298.  SET DEBUG ON will turn on logging for CONSOLE, CONNECT, FILE, PACKET
  1299.  and STATE to the disk file specified by SET LOGFILE.
  1300.  This command is the same as SET DEBUG ALL.
  1301.  The command format is:
  1302. .lit
  1303.  
  1304.         Kermit-11>SET DEBUG ON
  1305.  
  1306. .eli
  1307. .s 1
  1308. .i-1;3 PACKET
  1309. .s 1
  1310.  SET DEBUG PACKET will turn on logging of all receive and transmit
  1311.  packets to the disk file specified by SET LOGFILE.
  1312.  The command format is:
  1313. .lit
  1314.  
  1315.         Kermit-11>SET DEBUG PACKET
  1316.  
  1317. .eli
  1318. .s 1
  1319. .i-1;3 STATE
  1320. .s 1
  1321.  SET DEBUG STATE will turn on logging of all internal Kermit-11 state
  1322.  transitions 
  1323. .s 1
  1324. .i-1;2 DELAY
  1325. .s 1
  1326.  The DELAY parameter is the number of seconds to wait  before  sending
  1327.  data  after  a SEND command is given.  This is used when Kermit-11 is
  1328.  running in remote mode to allow the user time to escape back  to  the
  1329.  other Kermit and give a RECEIVE command.
  1330. .lit
  1331.  
  1332.            Kermit-11>SET DELAY number-of-seconds
  1333.  
  1334. .eli
  1335.  Where number of seconds is the (decimal) number  of  second  to  wait
  1336.  before sending data.
  1337. .s 1
  1338. .i-1;2 DEFAULT
  1339. .s 1
  1340. The DEFAULT parameter allows you to specify a device and UIC (or PPN) for
  1341. all subsequent file opens (for SENDING) and file creates (for RECEIVING).
  1342. It is disabled by typing SET HOME.
  1343. .lit
  1344.  
  1345.         Kermit-11>SET DEFAULT device
  1346.         Kermit-11>SET DEFAULT DB2:[200,201]
  1347.  
  1348. .eli
  1349. This is quite useful for Kermit-11 running on a DECnet link, as you can
  1350. set the default for file operations to include node names and passwords
  1351. as in:
  1352. .lit
  1353.  
  1354.         Kermit-11>set def orion::sys$system:[fubar]
  1355.  
  1356. .eli
  1357. .s 1
  1358. .i-1;2 DIAL
  1359. .s 1
  1360. The SET DIAL command is used to configure an undefined modem type to
  1361. enable the DIAL command to function. Since the discussion of SET DIAL
  1362. is quite involved, please consult the Kermit-11 User's Guide for further
  1363. information. The following commands are supported by Kermit-11 for the
  1364. SET DIAL command:
  1365. .lit
  1366.  
  1367.         Kermit-11>SET DIAL WAKEUP string
  1368.         Kermit-11>SET DIAL WAKE_STRING string
  1369.         Kermit-11>SET DIAL PROMPT string
  1370.         Kermit-11>SET DIAL INITIATE string
  1371.         Kermit-11>SET DIAL FORMAT string
  1372.         Kermit-11>SET DIAL SUCCESS string
  1373.         Kermit-11>SET DIAL INFORMATION string
  1374.         Kermit-11>SET DIAL FAILURE string
  1375.         Kermit-11>SET DIAL CONFIRM string
  1376.         Kermit-11>SET DIAL WAKE_RATE delay
  1377.         Kermit-11>SET DIAL DIAL_RATE delay
  1378.         Kermit-11>SET DIAL DIAL_PAUSE string
  1379.  
  1380. .eli
  1381. .s 1
  1382. .i-1;2 DUPLEX
  1383. .s 1
  1384. The DUPLEX parameter controls whether an outgoing link (set via the SET LINE
  1385. command) is a full duplex link (the default) or a half duplex link.  All it
  1386. does for half duplex is to cause all characters typed after the CONNECT command
  1387. to be echoed locally.
  1388. .lit
  1389.  
  1390.         Kermit-11>SET DUPLEX HALF
  1391.         Kermit-11>SET DUPLEX FULL
  1392.  
  1393. .eli
  1394. .s 1
  1395. .i-1;2 END-OF-LINE
  1396. .s 1
  1397. The END-OF-LINE parameter sets the ASCII character which will be used as
  1398. a line terminator for all packets SENT to the other KERMIT. This is normally
  1399. not needed for most versions of KERMIT.
  1400. .lit
  1401.  
  1402.         Kermit-11>SET END-OF-LINE octal-value-of-character
  1403.  
  1404. .eli
  1405. .s 1
  1406. .i-1;2 ESCAPE
  1407. .s 1
  1408.  This  command  will  set  the  escape  character  for   the   CONNECT
  1409.  processing.   The  command will take the octal value of the character
  1410.  to use as the escape character.  This is the character which is  used
  1411.  to  "escape"  back  to Kermit-11 after using the CONNECT command.  It
  1412.  defaults to control \ (octal 34).  It is usually a  good  idea  to  set  this
  1413.  character  to  something which is not used (or at least not used very
  1414.  much) on the system being to which Kermit-11 is CONNECTing.
  1415. .lit
  1416.  
  1417.            Kermit-11>SET ESCAPE octal-character-value
  1418.  
  1419. .eli
  1420.  Where octal-character-value is the ASCII value of  the  character  to
  1421.  use as the escape character (in octal).
  1422. .s 1
  1423. .i-1;2 FILE_TYPE
  1424. .s 1
  1425.  This command will set the file type that Kermit is receiving.  A file
  1426.  type  of  ASCII  should be used to receive text files which are to be
  1427.  used as text files on the PDP-11 system.  The file type BINARY should be
  1428.  used for binary files, such as CP/M .COM files, which need to be kept
  1429.  in a format that allows the file to be returned without any changes.
  1430. .lit
  1431.  
  1432.            Kermit-11>SET FILE_TYPE type
  1433.            Kermit-11>SET FIL BIN
  1434.  
  1435. .eli
  1436. .i -1;3 ASCII
  1437. .s 1
  1438.  File type ASCII is for text files.
  1439. .s 1
  1440. .i-1;3 AUTO
  1441. .s 1
  1442.  Kermit-11 will normally try to decide if a file must be sent in binary
  1443.  mode based on the file attributes and filetype. If, for instance, the
  1444.  directory entry for FUBAR.TXT showed it to be RMS (or FCS) fixed length
  1445.  records, Kermit-11 will switch to binary mode and send it verbatim. If
  1446.  the receiving Kermit is Kermit-11, then the sending Kermit will send
  1447.  attribute data over also.
  1448.  The following file types also will normally be sent as binary files unless
  1449.  you use the SET FILE NOAUTO command.
  1450. .lit
  1451.  
  1452.         *.TSK    ; rsx, ias, and rsts tasks
  1453.         *.SAV    ; rt11 and rsts save images
  1454.         *.OBJ    ; compiler and mac output
  1455.         *.STB    ; tkband link symbol tables
  1456.         *.CRF    ; tkb and link cross reference files
  1457.         *.TSD    ; 'time shared dibol' for rt11
  1458.         *.BAC    ; rsts basic+ 'compiled' files
  1459.         *.OLB    ; rsx, ias, and rsts object libraries
  1460.         *.MLB    ; rsx, ias, and rsts macro libraries
  1461.         *.RTS    ; rsts/e run time systems
  1462.         *.EXE    ; vms executable
  1463.  
  1464. .eli
  1465. .i-1;3 BINARY
  1466. .s 1
  1467.  File type BINARY is for non-text files.  Note that binary files which
  1468.  are  generated  on  a PDP-11 system cannot be transferred to another 
  1469.  (non PDP-11)
  1470.  system  without  losing  file  attributes.   This  means  that   (for
  1471.  example),  an  RMS-11 indexed file cannot be transmitted with Kermit-11 at
  1472.  this time.  You can not have parity set to anything but NONE to use binary
  1473.  file transfer (see HELP SET PARITY) unless the other Kermit can process
  1474.  eight bit quoting.
  1475.  Two Kermit-11's connected to each other will use binary transmission
  1476.  automatically via the Kermit attribute packets, preserving file attributes
  1477.  where it makes sense (ie, RSTS/E and RSX only).
  1478. .s 1
  1479. .i-1;3 FIXED
  1480. .s 1
  1481. SET FIL FIXED is the same as SET FIL BIN
  1482. .s 1
  1483. .i-1;3 NOAUTO
  1484. .s 1
  1485.  SET FILE NOAUTO disables Kermit-11 from trying to base binary transmission
  1486.  mode on file attributes or filetype.
  1487. .s 1
  1488. .i-1;3 PROTECT
  1489. .s 1
  1490. See HELP SET FILE SUPERCEDE for information.
  1491. .s 1
  1492. .i-1;3 SUPERCEDE
  1493. .s 1
  1494.  SET FILE [NO]SUPERCEDE allows Kermit-11 to accept or reject files received
  1495. (from either the RECEIVE or GET commands) on a per file basis. The default
  1496. is SUPERCEDE. By doing SET FILE NOSUPERCEDE Kermit-11 will always check to
  1497. see if the file to be created is already there (independent of version number)
  1498. and reject it to the sending server if it exists. This presumes that the
  1499. Kermit sending the file understands the protocol to reject one file of a
  1500. (possibly) wildcarded group of files.
  1501. .br
  1502. The main use of this is to resume getting a group of files,
  1503. as in GET KER:K11*.* or GET KER:MS????.*
  1504. having lost the connection after transfering some of the files. If this is
  1505. set, then any files already transfered will not be transfered again.
  1506. .lit
  1507.  
  1508.     Kermit-11>SET FILE SUPERCEDE
  1509.     Kermit-11>SET FILE NOSUPERCEDE
  1510.  
  1511. .eli
  1512. .i-1;3 TEXT
  1513. .s 1
  1514. SET FIL TEXT is the same as SET FIL ASCII
  1515. .s 1
  1516. .i-1;3 TYPE
  1517. .s 1
  1518. The SET FILE TYPE xxx command is the same as the SET FILE xxx command. The
  1519. keyword TYPE is ignored for compatibility with other implementations of
  1520. Kermit.
  1521. .s 1
  1522. .i-1;2 HANGUP
  1523. .s 1
  1524. SET HANGUP is the same as the DISCONNECT command. It forces a connected
  1525. line (specified via the SET LINE command) to be dropped.  This is currently
  1526. only supported for RSTS version 8.
  1527. .lit
  1528.  
  1529.         Kermit-11>SET HANGUP
  1530.  
  1531. .eli
  1532. .s 1
  1533. .i-1;2 HOME
  1534. .s 1
  1535. SET HOME resets the default device and UIC (or PPN) to nothing, ie, all file
  1536. opens and creates use your default disk (SY:) and your UIC (or PPN).
  1537. .lit
  1538.  
  1539.         Kermit-11>SET HOME
  1540.  
  1541. .eli
  1542. .s 1
  1543. .i-1;2 IBM-MODE
  1544. .s 1
  1545. .lit
  1546. The SET IBM ON (or OFF) will instruct Kermit-11 to wait for an XON
  1547. following each packet sent to an IBM host. Since the default for IBM
  1548. mode may not always be appropiate for your IBM compatible system, you
  1549. can always use the SET HANDSHAKE XON and SET DUPLEX HALF to avoid the
  1550. parity setting implied by using IBM mode.
  1551. .lit
  1552.  
  1553.         Kermit-11>SET IBM ON
  1554.         Kermit-11>SET IBM OFF
  1555.  
  1556. .eli
  1557. .s 1
  1558. .i-1;2 LINE
  1559. .s 1
  1560. The SET LINE command sets the terminal name up for use with the CONNECT
  1561. command. To use this you must have access to that device. On many systems
  1562. terminal lines other than your own are protected from access, and may require
  1563. special procedures to access them.
  1564. .br
  1565. The form of the device name is TTnnn:, where 'nnn' is a decimal number for
  1566. RSTS and an octal number for RSX11M/M+.
  1567. For RT11, the device name is simply the MT unit number shown by the SHO TER
  1568. command, as in '5' for DZ11 unit 0 line 4.
  1569. If you are running K11POS.TSK for P/OS on the PRO/350, Kermit-11 will set
  1570. the line to XK0: and the speed to 9600 baud when Kermit starts. To override
  1571. the line or speed, set HELP SET LINE and HELP SET SPEED.
  1572. .br
  1573. As of Kermit-11 v2.39, RT11 users can use a SET LIN TT:, which will force
  1574. Kermit-11 to use the CONSOLE port for all I/O, with the restriction that
  1575. CONSOLE port I/O must request 8bit prefixing for the transfer of BINARY
  1576. data. Additionally, if the RT11 system lacks both MT service and the XL/XC
  1577. Kermit-11 will use the console by default.
  1578. .lit
  1579.  
  1580.         Kermit-11>SET LINE TT55:    (for RSTS and RSX)
  1581.         Kermit-11>SET LINE 5        (for RT11)
  1582.         Kermit-11>SET LINE XK0:        (for P/OS)
  1583.         Kermit-11>SET LINE XL:        (for RT11)
  1584. .eli
  1585. See HELP CONNECT, HELP SET DUPLEX and HELP SET SPEED for more information.
  1586. .s 1
  1587. .i-1;2 LOGFILE
  1588. .s 1
  1589. The SET LOGFILE command creates a debug dump file for you. It must be
  1590. used BEFORE any SET DEBUG commands can be used. See HELP DEBUG for further
  1591. information about debugging modes.
  1592. .lit
  1593.  
  1594.         Kermit-11>SET LOGFILE MYLOG.TXT
  1595.         Created debug file MYLOG.TXT
  1596.         Kermit-11>
  1597.  
  1598. .eli
  1599. .s 1
  1600. .i-1;2 MODEM
  1601. .s 1
  1602. The SET MODEM command is used to establish the type of modem you are using
  1603. for the DIAL command. If the type of modem is not currently supported, the
  1604. DIAL command will not function. As of this writing, 27-Jan-85, the
  1605. Racal Vadic VA212PA, VA212PAR, generic VA3400 with autodialler option,
  1606. Digital DF112, MicroCom SX1200, Rixon R212A, PRO/TMS
  1607. and Hayes modems are supported.
  1608. The older VADIC 3212 and 34xx modems with autodialing options should also
  1609. function via SET MODEM VADIC. The following modems are defined. The DF200
  1610. and DF03 types have not been tested.
  1611. .lit
  1612.  
  1613.         Kermit-11>SET MOD VA212PA
  1614.         Kermit-11>SET MOD VA212PAR
  1615.         Kermit-11>SET MOD VADIC   
  1616.         Kermit-11>SET MOD DF03    
  1617.         Kermit-11>SET MOD DF100   
  1618.         Kermit-11>SET MOD DF200                           
  1619.         Kermit-11>SET MOD HAYES                           
  1620.         Kermit-11>SET MOD MICROCOM
  1621.         Kermit-11>SET MOD R212A   
  1622.         Kermit-11>SET MOD PROTMS                          
  1623.  
  1624.  
  1625. .eli
  1626. An implcit SET MOD PROTMS is done if the line is XTn: and the modem type
  1627. is undefined under P/OS on the PRO/350.
  1628. .s 1
  1629. .i-1;2 PACKET-LENGTH
  1630. .s 1
  1631. You can alter the default transmitted packet length with the SET PACKET-LENGTH
  1632. command. This should not normally be needed unless the line is very noisy, at
  1633. which time you should probably give up anyway.
  1634. .lit
  1635.  
  1636.         Kermit-11>SET PACKET 60
  1637.  
  1638. .eli
  1639. .s 1
  1640. .i-1;2 PARITY
  1641. .s 1
  1642. This is used with the SET LINE and CONNECT commands to specify the type
  1643. of parity for the remote link. It defaults to NONE and can be either
  1644. ODD,  EVEN, MARK or SPACE as in:
  1645. .lit
  1646.  
  1647.         Kermit-11>SET PARITY NONE
  1648.         Kermit-11>SET PARITY ODD
  1649.         Kermit-11>SET PARITY EVEN
  1650.         Kermit-11>SET PARITY MARK
  1651.         Kermit-11>SET PARITY SPACE
  1652.  
  1653. .eli
  1654. All parity generation is done via software, no special hardware is used.
  1655. The use of software parity generation is restricted to 8 bit links only. The
  1656. character format, if parity is set to anything but NONE, will be 7 bits of
  1657. data followed with high bit set or cleared to indicate the parity. If you
  1658. set parity to anything but NONE (the default) you can NOT, at this time, send
  1659. binary files.  Attempting to set parity if the FILETYPE is BINARY will result
  1660. in an error (SET FILETYPE qualifier).
  1661. .s 1
  1662. .i-1;2 PAUSE
  1663. .s 1
  1664. PAUSE tells Kermit to wait the specified number of seconds between each
  1665. packet being sent to the other Kermit. This may be useful under situations
  1666. of heavy system load. This may be automatically computer by Kermit-11 in
  1667. a future release as a function of line speed.
  1668. .lit
  1669.  
  1670.         Kermit-11>SET PAUSE 1
  1671.  
  1672. .eli
  1673. .s 1
  1674. .i-1;2 PHONE
  1675. .s 1
  1676. Currently, the SET PHONE command supports the NUMBER option, as in:
  1677. .lit
  1678.  
  1679.         Kermit-11>SET PHONE NUMBER WORK 5374411
  1680.  
  1681. .eli
  1682. This allows Kermit to associate a tag name with a phone number for the
  1683. DIAL command; in the above example:
  1684. .lit
  1685.  
  1686.         Kermit-11>SET MOD VADIC
  1687.         Kermit-11>DIAL WORK
  1688.  
  1689. .eli
  1690. This would cause Kermit-11 to translate WORK to 5374411 and dial it.
  1691. See the Kermit-11 User's Guide for further information.
  1692. .s 1
  1693. .i-1;2 PROMPT
  1694. .s 1
  1695. The SET PROMPT command is useful if you are using two Kermit-11's to
  1696. talk to each other. By using the SET PROMPT command, you can change the
  1697. prompt from 'Kermit-11>' on either (or both) Kermit to something that
  1698. would indicate which system you are currently connected to.
  1699. .lit
  1700.  
  1701.         Kermit-11>SET PROMPT KERMIT-11/1170>
  1702.         Kermit-11>SET PROMPT FUBAR>
  1703.         Kermit-11>SET PROMPT PROKERMIIT-11>
  1704.  
  1705. .eli
  1706. .s 1
  1707. .i-1;2 RANDOM
  1708. .s 1
  1709. This command allows Kermit-11 to randomly generate checksum errors for
  1710. testing error recovery of an attatched Kermit.  You would normally never
  1711. use this command. Another command that goes with it is called SET SEED value
  1712. which starts the pseudo-random number generator at a different point.
  1713. .lit
  1714.  
  1715.         Kermit-11>SET RANDOM ON
  1716.         Kermit-11>SET RANDOM OFF
  1717.  
  1718. .eli
  1719. .s 1
  1720. .i-1;2 RECEIVE
  1721. .s 1
  1722. Currently the SET RECEIVE and SET SEND basically work the same in that they
  1723. only alter the END-OF-LINE character and the START-OF-PACKET value, as in:
  1724. .lit
  1725.  
  1726.         Kermit-11>SET REC START 2
  1727.         Kermit-11>SET REC END 12
  1728.  
  1729. .eli
  1730. .i-1;3 END-OF-LINE
  1731. .s 1
  1732. This instructs Kermit-11 to expect something other than the default
  1733. carriage return (octal 15) at the end of a packet. Kermit-11 will ignore
  1734. packet terminators. The SET SEND END command is of more use in conditioning
  1735. outgoing packets.
  1736. .s 1
  1737. .i-1;3 START-OF-PACKET
  1738. .s 1
  1739. The  normal Kermit packet prefix is Control-A (1); this command changes
  1740. the prefix Kermit-11 expects on incoming packets. The only reasons this
  1741. should  ever be changed would be: Some piece of equipment somewhere between
  1742. the two Kermit programs will not pass through  a  Control-A;  or,
  1743. some  piece  of of equipment similarly placed is echoing its input.  In
  1744. the latter case, the recipient of such an echo can  change  the  packet
  1745. prefix for outbound packets to be different from that of arriving packets
  1746. so that the echoed packets will be ignored.  The  opposite  Kermit
  1747. must also be told to change the prefix for its inbound packets and the
  1748. prefix it uses on outgoing packets.
  1749. .lit
  1750.  
  1751.         Kermit-11>SET REC START-OF-PACKET 2
  1752.  
  1753. .eli
  1754. .s 1
  1755. .i-1; 3 PACKET-LENGTH
  1756. .s 1
  1757. SET RECEIVE PACKET-LENGTH
  1758. .s 1
  1759. This command has two functions. The first, and normal one, is to reduce
  1760. incoming packet lengths in the event that normal sized Kermit packets can
  1761. not be passed through the communications circuit. There could be, perhaps,
  1762. some 'black box' somewhere in the link that has a very small buffer size;
  1763. this command could be used to reduce the size that the SENDING Kermit will
  1764. use.
  1765. .s 1
  1766. The other use is to enable a new protocol extension to Kermit called
  1767. 'LONG PACKETS'. The actual protocol is documented elsewhere, let's just
  1768. say that this is a way for two Kermit's to use packet sizes far greater
  1769. than the normal ('Classic') packet size of 90 characters or so. The main
  1770. use of this feature is in file transfer over links that introduce considerable
  1771. delay, it is not uncommon for packets to incur an one to two second delay.
  1772. The net result is a VERY slow running Kermit with an effective speed of
  1773. perhaps 300 to 600 baud rather than 1200 or 2400 baud. By making the packets
  1774. longer, we raise the effective speed of such a circuit. The main restriction
  1775. on the packet size chosen is the link, a given circuit may not pass 500
  1776. character packets. Also, BOTH Kermits must support this extension to the
  1777. protocol, they will always negotiate it before any file transfer.
  1778. See the notes at the end of this document for more
  1779. information.
  1780. .lit
  1781.  
  1782.         Kermit-11>SET REC PAC 50
  1783.         Kermit-11>SET REC PAC 600
  1784.  
  1785. .eli
  1786. It is HIGHLY recommended that you use the CRC block check, as the default
  1787. type one checksum could be inadequate for such long packets, as in:
  1788. .lit
  1789.  
  1790.         Kermit-11>SET BLO 3
  1791.  
  1792. .eli
  1793. .s 1
  1794. .i-1;2 POS (P/OS on the PRO/350)
  1795. .s 1
  1796. The currently available options on the SET command for the PRO/3x0 under
  1797. P/OS version 2 are:
  1798. .lit
  1799.  
  1800.     Kermit-11>SET POS DTE
  1801.     Kermit-11>SET POS NODTE
  1802.  
  1803. .eli
  1804. The DTE option tells Kermit-11 to attempt to spawn PRO/Communications (DTE)
  1805. as the CONNECT code; this allows the use of the 'grey keys' SETUP to set
  1806. terminal emulation characteristics, and the use of the 'EXIT' key to return
  1807. to the Kermit-11 command level. The 'SET POS DTE' command enables the attempt
  1808. to call PRO/COMM, whereas the 'SET POS NODTE' enables the builtin terminal
  1809. emulation.
  1810. .s 1
  1811. .i-1;2 RECORD-FORMAT
  1812. .s 1
  1813. Kermit will, by default, create RMS-11 variable length implied carriage control
  1814. records for text files. You can override this and change it to create stream
  1815. ascii records with the SET RECORD-FORMAT STREAM command. This is useful for
  1816. RSTS/E systems if you need file compatibility with BASIC-Plus.
  1817. .lit
  1818.  
  1819.         Kermit-11>SET RECORD-FORMAT STREAM
  1820.         Kermit-11>SET RECORD-FORMAT VARIABLE
  1821.  
  1822. .eli
  1823. This command would be most useful in a KERMIT.INI file, which is executed by
  1824. KERMIT when Kermit starts.
  1825. .s 1
  1826. .i-1;2 RETRY
  1827. .s 1
  1828. SET RETRY value tells Kermit to try that many times on a NAK'ed packet
  1829. before giving up. This should only be needed if the line is extremely
  1830. noisy or the PDP-11 host is running very slowly due to the system load.
  1831. .lit
  1832.  
  1833.         Kermit-11>SET RETRY 10
  1834.  
  1835. .eli
  1836. .s 1
  1837. .i-1;2 RSX
  1838. .s 1
  1839. The SET RSX command is intended to deal with the peculiarities oft found
  1840. with RSX systems. There are currently three SET RSX commands, as in:
  1841. .lit
  1842.  
  1843.     Kermit-11>SET RSX FASTIO    Default for packet reading,
  1844.                     waits for <CR>.
  1845.     Kermit-11>SET RSX CHARIO    Read one char at a time for
  1846.                     packet reading.
  1847.     Kermit-11>SET RSX TC.DLU n    Alters  the TC.DLU setting.
  1848.     Kermit-11>SET RSX CONNECT ALT    Uses a new  (v2.33) CONNECT
  1849.                     driver which bypasses TTDRV
  1850.                     flow control.
  1851.     Kermit-11>SET RSX CONNECT DEF    Use old CONNECT code (2.32)
  1852. .eli
  1853.  
  1854. .s 1
  1855. .i-1;2 RT11
  1856. .s 1
  1857. .i-1;3 CREATE-SIZE
  1858. .s 1
  1859. The SET RT11 CREATE value command was added to assist those RT11 users
  1860. with very small disks to be able to get files with sizes greater that
  1861. half of the availble contiguous space availble. While this is NOT a
  1862. problem going from one Kermit-11 to another Kermit-11 since the PDP-11
  1863. Kermit supports a subset of the protocol known as 'ATTRIBUTES', other
  1864. Kermits may not support the exchange of file sizes (most do not). Thus
  1865. if your largest contiguous space is 300 blocks and you want to get a 250
  1866. block file, the command:
  1867. .lit
  1868.  
  1869.     Kermit-11>SET RT11 CRE 250
  1870.  
  1871. .eli
  1872. would be needed, as RT11 by default only allocates 50 percent of the
  1873. available space.
  1874. .s 1
  1875. .i-1;3 FLOW-CONTROL
  1876. .s 1
  1877. Note that for the CONNECT command under RT11 you will most
  1878. likely need XON/XOFF flow control to be generated by Kermit-11. This
  1879. is enabled with the SET RT11 FLOW command. This is by default NOFLOW since
  1880. the modem the author uses, a Vadic 212LS, can't handle XONs and XOFFs
  1881. while in command mode. The solution here is to escape back to Kermit
  1882. command mode after the remote system has been logged into, and then
  1883. type SET RT11 FLOW.
  1884. .br
  1885. The effect of SET RT11 FLOW is for Kermit-11, when in CONNECT mode,
  1886. to send an XOFF to the host every eight characters. When the loop in
  1887. the CONNECT module finds no more data in the input buffer, it sends
  1888. up to 2 XON characters (in case the first XON got lost) to tell the
  1889. remote system to start sending again. The reason for doing so is that
  1890. the RT11 multiple terminal service is very slow about handling input
  1891. interupts and does not do any of it's own flow control when it's internal
  1892. ring buffer gets full. This has been tested at line speeds up to 4800
  1893. baud without losing data. This setting should not be needed for use with
  1894. the XC/XL handlers.
  1895. .br
  1896. SET RT11 FLOW has NO effect on packet transmission, since the Kermit packet
  1897. size is never mode than 96 characters, and the RT11 input buffer is 134
  1898. chararcters in size.
  1899. .lit
  1900.  
  1901.         Kermit-11>SET RT11 FLOW
  1902.         Kermit-11>SET RT11 NOFLOW
  1903.  
  1904. .eli
  1905. .s 1
  1906. .i-1;3 VOLUME-VERIFY
  1907. .s 1
  1908. Normally RT11 Kermit-11 will check the directory header of a disk to verify
  1909. that it most likely contains a valid RT11 file structure before trying to read
  1910. the directory. If for some reason your disk does not contain the standard data
  1911. at offset 760 in the header, Kermit-11 will reject the disk. The SET RT11 NOVOL
  1912. command will instruct Kermit-11 to bypass that check.
  1913. .lit
  1914.  
  1915.         Kermit-11>SET RT11 VOL
  1916.         Kermit-11>SET RT11 NOVOL
  1917.  
  1918. .eli
  1919. .s 1
  1920. .i-1;2 SEND
  1921. .s 1
  1922. The SET SEND command controls what Kermit-11 will be doing for outgoing packets
  1923. in that you may want to alter the packet terminator and/or the start of packet
  1924. character (by default, 15 octal and 1 octal respectively. See HELP SET RECEIVE
  1925. for more information.
  1926. .s 1
  1927. .i-1;2 SPEED
  1928. .s 1
  1929. SET SPEED value sets the line speed for the device specified via the
  1930. SET LINE command, and used for the CONNECT command. Changing the speed
  1931. of a terminal line requires privilege for RSTS and RSX11M/M+.
  1932. The SET SPEED command will only function with a DH11, DHV11, DZ11 or DZV11
  1933. multiline interface.
  1934. .lit
  1935.  
  1936.         Kermit-11>SET SPEED 1200
  1937.  
  1938. .eli
  1939. 1200 Baud would be a normal speed to use with a VA212LS or a DF03.
  1940. .s 1
  1941. Please note that Kermit-11 CANNOT change the speed of a DL11 type interface,
  1942. nor can it change the speed of a PDT-150 modem port.
  1943. For a PDT-150 modem port, use a command of /M/S:nnnn. to change the speed to
  1944. nnnn for the SPEED.SAV program.
  1945. .s 1
  1946. .i-1;2 START-OF-PACKET
  1947. .s 1
  1948. The SET START octal-value tells Kermit-11 to expect and also to send as
  1949. the start of packet character the specified character instead of the
  1950. default Control-A (octal 1). Note that both Kermit's must support this
  1951. command (or SET RECEIVE/SEND START value) as it is not possible for
  1952. two Kermit's to negociate this. This set command is the same as doing
  1953. both a SET REC START n and SET SEND START n.
  1954. .lit
  1955.  
  1956.         Kermit-11>SET START 2
  1957.         Kermit-11>SET START 1
  1958.  
  1959. .eli
  1960. .s 1
  1961. .i-1;2 TIMEOUT
  1962. .s 1
  1963. The timeout value tells Kermit how long to wait to get a packet from
  1964. the other Kermit. If system loads are high, it may be desirable to increase
  1965. this beyond the default of 10 seconds.
  1966. .s 1
  1967. .i-1;2 TERMINAL
  1968. .s 1
  1969. The SET TERMINAL command simply controls the way which Kermit-11 prints
  1970. packet counts while send or receiving a file (or group of files). The
  1971. simplest way is the default, SET TER TTY. Using SET TER VT100 will cause
  1972. Kermit to display headers for the numbers printed, at a possible cost
  1973. in packet speed due to screen control overhead.
  1974. .lit
  1975.  
  1976.         Kermit-11>SET TER TTY
  1977.         Kermit-11>SET TER VT100
  1978.  
  1979. .eli
  1980. .s 1
  1981. .i-1;2 UPDATE
  1982. .s 1
  1983. The SET UPDATE command controls the frequency at which the packet count display
  1984. is updated. The default is 1, displaying each packet. A SET UPD 0 will disable
  1985. all packet count logs, whereas a SET UPD N will update the display every N
  1986. packets. The SET NOUPDATE command is the same as SET UPDATE 0.
  1987. .s 1
  1988. .i-1;1 SHOW
  1989. .s 1
  1990. The SHOW command will display the settings made by the SET command and allow
  1991. you to look at session statistics.
  1992. .lit
  1993.  
  1994.         Kermit-11>SHOW parameter
  1995.  
  1996. .eli
  1997. .i-1;2 ALL
  1998. .lit
  1999. Displays everything:    BLOCK-CHECK    DEBUG        DEFAULT        ESCAPE
  2000.             FILE-TYPE    LINE        PACKET        PARAM
  2001.             TIME        VERSION
  2002.  
  2003. .eli
  2004. .i-1;2 BLOCK-CHECK-TYPE
  2005. .s 1
  2006. Displays the current type of checksum set.
  2007. .s 1
  2008. .i-1;2 DEBUG
  2009. .s 1
  2010. Shows the status of debugging.
  2011. .s 1
  2012. .i-1;2 DEFAULT
  2013. .s 1
  2014. Shows the device and UIC (or PPN) used for file operations.
  2015. .s 1
  2016. .i-1;2 ESCAPE
  2017. .s 1
  2018. Shows the escape character used to return to a local Kermit-11
  2019. .s 1
  2020. .i-1;2 FILE-TYPE
  2021. .s 1
  2022. Shows the current filetype (BINARY or ASCII)
  2023. .s 1
  2024. .i-1;2 LINE
  2025. .s 1
  2026. Displays parameters associated with the current CONNECT line.
  2027. .s 1
  2028. .i-1;2 PACKET
  2029. .s 1
  2030. Prints out packets statistics from the last transaction and total so far.
  2031. .s 1
  2032. .i-1;2 PARAMETERS
  2033. .s 1
  2034. Prints out various send parameters
  2035. .i-1;2 RECORD-FORMAT
  2036. .s 1
  2037. Shows what kind of file will be created by Kermit.
  2038. .s 1
  2039. .i-1;2 TIME
  2040. .s 1
  2041. The time of day
  2042. .s 1
  2043. .i-1;2 VERSION
  2044. .s 1
  2045. My current version and edit.
  2046. .s 1
  2047. .i-1;1 STARTUP
  2048. .s 1
  2049. You can place a file called KERMIT.INI in your account and have Kermit-11
  2050. automatically read commands from it before getting commands from your terminal.
  2051. .s 1
  2052. .i-1;1 SYSTEM
  2053. .s 1
  2054. The SYSTEM command takes a CCL/MCR/DCL command line and spawns a task to
  2055. execute it. This is done via the SPWN$S directive for RSX and by spawning
  2056. a job on a pseudo-keyboard for RSTS. If the command fails for RSTS then Kermits
  2057. protection code was set to run without privileges.
  2058. .lit
  2059.  
  2060.         Kermit-11>SYS PIP DB1:=FUBAR.DAT
  2061.         Kermit-11>SYS
  2062.         Command: SUB MYJOB
  2063.         Kermit-11>
  2064.  
  2065. .eli
  2066. .s 1
  2067. .i-1;1 TAKE
  2068. .s 1
  2069. The Take command is just like the @ command. It opens a disk file for reading
  2070. commands from, as in TAKE filename.
  2071. .lit
  2072.  
  2073.         Kermit-11>TAKE MYKERM.CMD
  2074.  
  2075. .eli
  2076. .s 1
  2077. .i-1;1 TSX+
  2078. .s 1
  2079. Kermit-11 for TSX+ is exactly the same Kermit used under RT11/XM. Kermit-11
  2080. for RT11 always checks for the type of system it is on, be that RT11, PRO/RT11
  2081. or TSX+. At run time, it will dispatch to the correct overlay for doing
  2082. terminal I/O (or XL/XC I/O). Note that for TSX+, you can only dial out by
  2083. using the XL handler, supplied with version 5. As far as system requirements
  2084. go the author has been told that the sysgen parameter DINSPC in TSGEN.MAC
  2085. mu st at least 100 (10) in value, otherwise the terminal driver will be unable
  2086. to buffer the entire received Kermit packet. Since the author does not have
  2087. or use TSX+, any problems that arise on TSX+ will have to be fixed by the
  2088. site's systems personel and reported back to the author.
  2089. .br
  2090. To use the CL: handler under TSX+, the following commands are needed. Please
  2091. note that 'n' stands for a value, be it a unit number or a speed value. In
  2092. all cases, the commands are KMON commands unless shown with a Kermit-11>
  2093. prefix.
  2094. .lit
  2095.  
  2096.     .SET CL LINE=n
  2097.     .SET CL NOLFOUT
  2098.     .SET CL SPEED=nnnn
  2099.     .ASS CLn XL
  2100.     .run kermit
  2101.     Kermit-11>SET LIN XL
  2102.  
  2103. .eli
  2104. See HELP RT11 for more information that would also pertain to TSX+.
  2105. .s 1
  2106. .i-1;1 TYPE
  2107. .s 1
  2108. The TYPE command prints a file to your terminal, as in:
  2109. .lit
  2110.  
  2111.         Kermit-11>TYPE KERMIT.INI
  2112.  
  2113. .eli
  2114. .s 1
  2115. .i-1;1 USAGE
  2116. .s 1
  2117. Kermit-11 is normally run on the PDP-11 host system as a server. This means
  2118. that a remote Kermit can send it commands without the user having to be switching
  2119. between the local Kermit (usually a micro) and the remote Kermit (the one on
  2120. the PDP-11).  While Kermit-11 supports most of the server commands shown in
  2121. version Four revision 1 of the protocol manual (see HELP REMOTE), not all
  2122. micro based Kermits are able to send these commands to Kermit-11.  Most
  2123. Kermits do support the GET, SEND, BYE and FINISH server commands, which
  2124. are sufficient for most file transfers. The following is an example of the
  2125. dialog when a DEC VT180 Robin connects to a PDP-11/70 RSTS system to use
  2126. Kermit.
  2127. .rm 80
  2128. .lit
  2129.  
  2130.    A>b:
  2131.    B>a:cpmrob
  2132.    Kermit-80 V3.6 [VT180 "Robin"]
  2133.  
  2134.    Kermit-80  B:>connect
  2135.    [Connected to remote host, type Control-\C to return]
  2136.  
  2137.    LOG
  2138.    RSTS V8.0-07 U of Toledo 70 Job 12 KB25  17-Feb-84  03:31 PM
  2139.    User    # 2/2
  2140.    Password:
  2141.  
  2142.    Welcome to RSTS/E version 8.0
  2143.  
  2144.    $ kermit
  2145.    Kermit-11>server
  2146.    Kermit Server running on PDP-11 host. Please type your escape sequence
  2147.    to return  to your local machine.  Shut down the server by  typing the
  2148.    Kermit BYE command on your local machine.
  2149.  
  2150.    (the user now types Ctrl \C)
  2151.  
  2152.    Kermit-80  B:>get *.odl
  2153.     .
  2154.     . All files on the 11/70 with types of ODL are sent
  2155.     .
  2156.    Kermit-80  B:>bye
  2157.    B>
  2158.  
  2159. .eli
  2160. See HELP SEND, HELP GET and HELP BYE for additional information.
  2161. .rm 70
  2162. .s 1
  2163. .i-1;1 WHO
  2164. .s 1
  2165. The WHO command (currently for RSTS/E only) prints a brief SYSTAT out.
  2166. .s 1
  2167.