home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / pdp11 / k11usr.txt < prev    next >
Text File  |  2020-01-01  |  89KB  |  2,222 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                               CHAPTER 1
  14.  
  15.                             PDP-11 KERMIT
  16.  
  17.  
  18.  
  19.      
  20. Program:           Brian Nelson
  21. Language:          Macro-11
  22. Documentation:     Brian Nelson
  23. Version:           3.60
  24. Date:              May 25, 1989
  25.  
  26. Systems Supported: RSTS/E, RSX-11M/M+, P/OS, Micro-RSX, RT-11 and TSX+    
  27.      
  28.  Kermit-11 Capabilities At A Glance:
  29.      
  30.   Local operation:                   Yes
  31.   Remote operation:                  Yes
  32.   Transfer text files:               Yes
  33.   Transfer binary files:             Yes
  34.   Wildcard send:                     Yes
  35.   File transfer interruption:        Yes
  36.   Filename collision avoidance:      Yes
  37.   Can time out:                      Yes
  38.   8th-bit prefixing:                 Yes
  39.   Repeat count prefixing:            Yes
  40.   Alternate block checks:            Yes
  41.   LONG Packet protocol support       Yes
  42.   Sliding Windows protocol support   No
  43.   Terminal emulation:                Yes
  44.   Communication settings:            Yes
  45.   Transmit BREAK:                    Yes (depends on system)
  46.   IBM mainframe communication:       Yes
  47.   Transaction logging:               Yes
  48.   Session logging:                   Yes
  49.   Debug logging:                     Yes
  50.   Packet logging:                    Yes
  51.   Act as server:                     Yes
  52.   Talk to server:                    Yes
  53.   Advanced server functions:         Yes
  54.   Local file management:             Yes
  55.   Command/Init files:                Yes
  56.   File attributes packets:           Yes
  57.   Command macros:                    No
  58.   Raw file transmit:                 Yes
  59.  
  60. PDP-11 KERMIT                                                 Page 1-2
  61.  
  62.  
  63.  
  64.  
  65. PDP-11 KERMIT                                                 Page 1-3
  66. File systems on the PDP-11
  67.  
  68.  
  69. File specifications.
  70.  
  71. The general format of a file name is:
  72.  
  73.   NODE::DEVICE:[DIRECTORY]NAME.TYPE;VERSION
  74.  
  75. 'Node' refers to the  DECNET  node  name,  for  example,  FUBAR::,  if
  76. applicable.   'Device',  if  present, refers to the physical device or
  77. logical name where the file resides.
  78.  
  79. For RSTS/E, 'device' can be a physical device, such as DB0:  or  DU1:,
  80. or  it  can  be a user or system logical name which may include both a
  81. physical device name and a directory name.  If the device  name  is  a
  82. logical  name,  is  it  composed  of  1  to 9 alphanumeric characters,
  83. including '$', as in DISK$ONE:, LB:  and so on.  For instance, the DCL
  84. system command
  85.  
  86.   $ ASS/SYS DB1:[200,210] SRC$DIR
  87.  
  88. would associate both the device DB1:   and  directory  [200,210]  with
  89. SRC$DIR:.   Explicitly  given  directories  override  directory  names
  90. imbedded in a logical name.  Names longer  than  nine  characters  are
  91. truncated by the executive.
  92.  
  93. In the case of RSX-11M/M+ and RT-11, the device name can be  either  a
  94. physical name, such as DU0:, or a logical name which will translate to
  95. a physical device name, such as LB:.
  96.  
  97. On  RSTS/E  and  RSX-11M/M+,  the   [directory]   is   a   UIC   (user
  98. identification  code) or PPN (project,programmer) number of the format
  99. [NNN,MMM].  All users are assigned a UIC (or PPN)  when  accounts  are
  100. created,  this is the number you give to LOGIN to log into the system.
  101. It is also your default UIC (or PPN).  Micro-Rsx  and  P/OS  may  have
  102. directories  in  either  UIC format or named directory format, such as
  103. [1,2] or [KERMIT].  For P/OS, the default  directory  is  [USERFILES].
  104. Directories are not used for RT-11.
  105.  
  106. The NAME field is the primary identifier for the file.  The  name  can
  107. be  one  to  nine  characters  for RSX-11M/M+ and P/OS, and one to six
  108. characters for RSTS/E, RT-11 and TSX+.  The TYPE field is usually used
  109. to  group  files  according  to some convention.  For example, XXX.FTN
  110. refers to a Fortran-77 source file, FOO.C to a 'C'  source  file,  and
  111. K11POS.TSK refers to a task image.
  112.  
  113. The version field is applicable ONLY to RSX type systems.  The default
  114. version is always the highest version number.
  115.  
  116. All systems mentioned support some sort of filename  wildcarding,  the
  117. flexibility  of which varies by executive.  All support the use of '*'
  118. to represent either a fully wildcarded NAME or TYPE.  RSTS/E  supports
  119. the use of '?' to match any single character, whereas the others use a
  120. '%' to match any single character.   The  RSTS/E  Kermit  server  will
  121. translate  '%'  to  '?' internally for the GET and REMOTE DIR commands
  122. (see chapter on the SERVER).
  123.  
  124. PDP-11 KERMIT                                                 Page 1-4
  125. File systems on the PDP-11
  126.  
  127.  
  128. Examples of wildcarded filenames:
  129.  
  130.         *.B2S           match any file with a TYPE of B2S
  131.         K11%%%.MAC      match any file starting with K11, followed by
  132.                         one to three characters, with a TYPE of MAC
  133.         K11???.MAC      Same as above, but for RSTS/E only.
  134.         XYZ.*;*         All versions of files with a NAME of XYZ with
  135.                         any TYPE (RSX-11M/M+ and P/OS only).
  136.  
  137. File formats (binary and text)
  138.  
  139. RT-11 and TSX+
  140.  
  141. RT-11 treats all files as a contiguous stream of characters.  There is
  142. no information stored in the directory to tell the system (or program)
  143. that a file is readable text (source program, runoff document,...)  or
  144. consists  of  binary  data  (executable  program,  object  file,  .SYS
  145. file,...).  An application program like Kermit-11 needs to  know  what
  146. type of file to expect, thus the presence of the SET FILE TYPE command
  147. (discussed later).  The only real convention is that  text  files  are
  148. streams  of  seven  bit data with each record terminated by a carriage
  149. return/line feed character sequence and  that  binary  files  normally
  150. follow a filename TYPE convention.  The TYPE (.SAV, .SYS, ...) is what
  151. Kermit-11 will look at to decide if a file should be sent as a text or
  152. binary file.
  153.  
  154. RSTS/E, P/OS and RSX-11M/M+
  155.  
  156. These systems can provide for a large number of  file  attributes  for
  157. each  file  by  using  either FCS11 (RSX-11M/M+) or RMS11 (all).  Text
  158. files are normally considered to be either STREAM format  (FB$STM)  or
  159. VARIABLE with implied carriage control (FB$VAR and FB$CR).  RSTS/E has
  160. historically defaulted to STREAM, whereas the RSX  based  systems  use
  161. VARIABLE.  Kermit-11 follows those defaults when creating files unless
  162. told to do so otherwise  by  the  presence  of  attribute  data.   The
  163. conversion  of  the  internal  data  representation to one that can be
  164. transmitted to another Kermit is transparent for these types of files.
  165. Both  the  file  attributes  and  the  filename  TYPE  are examined by
  166. Kermit-11 to determine if a file needs to  be  sent  as  a  text  file
  167. (default) or a binary file.  Additionally, on RSTS/E Kermit checks the
  168. file protection code, as one of the bits in it  is  used  to  flag  an
  169. executable file (bit 6).
  170.  
  171. In all cases, unless (at this time) Kermit-11 is  talking  to  another
  172. Kermit-11,  or if Kermit-11 can't tell if a file is consists of binary
  173. data, the command SET FILE TYPE FIXED must be used to force Kermit  to
  174. either  send  or  get  a  non-text  file correctly.  When Kermit-11 is
  175. running in binary mode, all data is read from (or written to) the file
  176. without  any  translation or internal record control information.  Any
  177. attribute information in the file's directory entry is ignored and the
  178. data  read  (or  written)  in 512 byte unformatted blocks.  Thus it is
  179. indeed  possible  to  transfer  files  like  task  images  and  object
  180. libraries.   Since  Kermit-11  supports a subset of a protocol feature
  181. called 'attributes',  two  Kermit-11's  connected  together  can  also
  182.  
  183. PDP-11 KERMIT                                                 Page 1-5
  184. File systems on the PDP-11
  185.  
  186.  
  187. correctly transfer files other than simple text and unformatted binary
  188. files, such as RMS indexed or relative files.
  189.  
  190. Saving files on the PDP-11 from your microcomputer
  191.  
  192. You  can  send  textual  files  to  Kermit-11  without   any   special
  193. considerations  as  Kermit-11  defaults to creating normal text files.
  194. However, if you are sending a binary file (perhaps an EXE)  from  say,
  195. your  Rainbow  under MSDOS, you would need to tell Kermit-11 to expect
  196. binary data.  This is done with the Kermit-11 command  SET  FILE  TYPE
  197. FIXED.   This will force Kermit-11 to write the data out exactly as it
  198. comes, in 512 byte unformatted records.  Sending the same file back to
  199. the Rainbow would not require any special action since the file, as it
  200. sits on the PDP-11, has the proper information in the directory  entry
  201. to  tell  Kermit-11 that the file is binary.  As a note, for RT-11 you
  202. would need to use a filetype that is normally considered 'binary' like
  203. SAV or OBJ (see above notes for RT-11).
  204.  
  205. Never try to do a wildcarded send with mixed  binary  and  text  files
  206. with  the file type set to FIXED.  The result could be unusable as not
  207. all systems store text data in the same internal format.  For example,
  208. if  Kermit-11  is forced into binary mode (via SET FIL TYP FIX) and is
  209. requested to send a file with implied carriage control (normal for RSX
  210. text  files),  it  will  actually  send,  for  each  line,  two  bytes
  211. representing the record length, followed by the data and then followed
  212. by  a  ascii  NUL  to  pad  the record to an even length.  That is not
  213. incorrect, rather, it is EXACTLY how the data was stored on disk.
  214.  
  215. In general, avoid sending anything other than unformatted binary files
  216. and  text  file  to  unlike  systems.   For  example, requesting a RMS
  217. indexed file from the PDP-11 to be sent to a PC would  case  Kermit-11
  218. to  send  it  as a binary file, but the file attributes would be lost.
  219. Sending such a file back to the PDP-11 would  result  in  an  unusable
  220. file unless you could reconstruct the attribute information.
  221.  
  222. PDP-11 KERMIT                                                 Page 1-6
  223. Program Operation
  224.  
  225.  
  226. Kermit-11's prompt is normally "Kermit-11>".  This can be  changed  if
  227. need  be  via the SET PROMPT command.  Invoking Kermit-11 is very site
  228. dependent.
  229.  
  230. RSTS/E
  231.  
  232. If Kermit-11 has a ccl definition, it would likely be invoked as "KER"
  233. or  "KERMIT".   If  not,  try "RUN $KERMIT", as this is a likely place
  234. where Kermit-11 may have  been  put.   Otherwise  consult  your  local
  235. support staff.
  236.  
  237. RSX-11M/M+
  238.  
  239. If Kermit-11 has been installed, it most likely will have a task  name
  240. of  ...KER  which means that type "KER" should get things running.  If
  241. not, consult your local support staff.
  242.  
  243. RT-11/TSX+
  244.  
  245. On version 5 of RT-11, programs  can  be  run  simply  by  typing  the
  246. filename.   Thus,  if  there  is  a  file  SY:KERMIT.SAV,  simply type
  247. "KERMIT".  If  this  fails,  contact  your  local  support  staff  for
  248. assistance.
  249.  
  250. P/OS
  251.  
  252. Kermit-11 is generally run from DCL on P/OS.  The program  is  invoked
  253. via  the DCL RUN command, as in RUN K11POS or RUN KERMIT, depending on
  254. what the task image name is.
  255.  
  256.  
  257. Note that for the case where  Kermit  is  installed  (for  RSTS/E  and
  258. RSX-11M/M+) that Kermit-11 can get command line arguments, as in:
  259.  
  260.         $ KER SERV                      Kermit starts as a server.
  261.         > KER send fubar.txt            Kermit sends the file.
  262.  
  263. Otherwise, the  program  is  run  interactively  from  the  Kermit-11>
  264. prompt.
  265.  
  266.         $ KERMIT
  267.         Kermit-11 V2.33
  268.         Kermit-11>SET BLO 3             Changes checksum type.
  269.         Kermit-11>SER                   Enter Kermit server.
  270.  
  271. Note that whenever Kermit-11 starts up, it will always try to  find  a
  272. file  called  KERMIT.INI  in  your  current  directory.  This file can
  273. contain any valid Kermit command, though the usual use of this  is  to
  274. place  various  Kermit-11  SET  commands in it.  If this file does NOT
  275. exist, it will try to find it in LB:[1,2]KERMIT.INI (excluding RT-11).
  276. In  addition  to  the  .INI file, commands may be placed in a file and
  277. then executed via the Kermit-11 TAKE (or @) command.    
  278.  
  279. PDP-11 KERMIT                                                 Page 1-7
  280. Local and Remote operation
  281.  
  282.  
  283. Kermit-11 by default assumes that all file transfers will  occur  over
  284. the terminal line that you are currently logged in on (TI:, TT:, KB:).
  285. This is known as REMOTE mode (the PDP-11 is the remote system).   This
  286. would be the desired case if you are running Kermit on a microcomputer
  287. such as a Rainbow and are currently logged into the PDP-11 through the
  288. micro.   However, if you wanted to dial out, say by an autodial modem,
  289. from the PDP-11 to another system, you need to tell Kermit-11  to  use
  290. some other terminal line.  This would be called LOCAL mode (the PDP-11
  291. is the local system).  The line can  be  altered  with  the  SET  LINE
  292. command  (see section on SET and CONNECT).  A SET LINE command is done
  293. implicitly if Kermit-11 finds  itself  running  on  a  PRO/350,  under
  294. either P/OS, RT-11 or TSX+.
  295.  
  296. Since support of parity varies by both interface type (DL11  vs  DZ11)
  297. and  by  operating system, Kermit-11 makes NO attempt to find out what
  298. the current parity of it's line  is.   Kermit-11  generates  it's  own
  299. parity which is set with the SET PARITY command.
  300.  
  301. There are a couple of things to  point  out  regarding  Kermit-11  and
  302. LOCAL mode (you did a SET LINE command).
  303.  
  304.      The system manager may have lines other than your  own  protected
  305.      (or  owned  by  the  system).   On  RSTS/E  lines  are often made
  306.      unaccessible   unless   your   account   possesses   the   needed
  307.      privilege(s).   On  RSX-11M/M+,  privilege  is  required to alter
  308.      settings on any other terminal line.  You may  have  to  talk  to
  309.      your system manager to get access to an outgoing terminal line.
  310.  
  311.      Once connected to a modem through  another  line,  a  means  must
  312.      exist  for  the  connection  to  be  broken  (if the host you are
  313.      calling won't do it).  Given that your line has full  or  partial
  314.      modem  control  (DZV11,  DZ11, DH11, DHU/V11) the RSX, RT-11/TSX+
  315.      and RSTS/E Kermits have a HANGUP (or DISCONNECT)  command,  which
  316.      instructs  the  system  to  disconnect the modem.  Unless this is
  317.      done, you never get disconnected and could run up  a  tidy  phone
  318.      bill.
  319.  
  320.  
  321. Kermit-11 has, as of v3.53, a rudimentary command  line  editor.   You
  322. can  recall  previous  commands  with  the  UP-Arrow key, and exit the
  323. command with the LEFT and  RIGHT  arrow  keys.   The  RUBOUT  key,  of
  324. course,  deletes characters, while the control R key retypes the line.
  325. Control E moves to the end of the line and  control  H  moves  to  the
  326. start of the line.
  327.  
  328.  
  329. PDP-11 KERMIT                                                 Page 1-8
  330. Kermit-11 commands
  331.  
  332.  
  333. Kermit-11 has the following commands available:
  334.  
  335.  
  336.  @              Synonym for TAKE
  337.  BYE            Logout a remote server
  338.  CONNECT        Connect to a remote system
  339.  COPY           Local copy of a file(s)
  340.  CWD            Set new working directory
  341.  DELETE         Local delete of a file(s)
  342.  DIAL           Have a connected modem dial a number
  343.  DIRECT         Local directory display
  344.  DISCONNECT     Hangup a remote line
  345.  DISPLAY        Internal debugging
  346.  ERASE          Local delete of a file(s)
  347.  EXIT           Exit to system
  348.  FINISH         Stop a remote server without logging out
  349.  GET            Get a file(s) from a remote server
  350.  HANGUP         Hangup a remote line
  351.  HOST           Execute system command locally (where applicable)
  352.  LOCAL          Force interpretation of command to the local system
  353.  LOGFILE        Create a log file
  354.  QUIT           Same as EXIT
  355.  PRINT          Print a file locally (where applicable)
  356.  RECEIVE        Receive a file(s) from a remote kermit
  357.  REMOTE         Prefix for file management commands to a server
  358.  RENAME         Local rename of filename(s)
  359.  SEND           Send a file(s) to a remote Kermit
  360.  SERVER         start a Kermit server
  361.  SET            Change Kermit parameters
  362.  SHOW           Display Kermit parameters
  363.  TAKE           Execute indirect command file
  364.  TYPE           Local display of file on terminal
  365.  WHO            Local display of logged in users (RSTS/E only)
  366.  
  367.  
  368. PDP-11 KERMIT                                                 Page 1-9
  369. Commands for file transfer
  370.  
  371.  
  372.                            The SEND Command
  373.  
  374. Sending a file or files:
  375.  
  376.     SEND filespec
  377.  
  378. The SEND command causes a file or file  group  to  be  sent  from  the
  379. PDP-11  to the other system.  If filespec contains wildcard characters
  380. then all matching files will be sent, in alphabetical order (according
  381. to  the  ASCII  collating  sequence)  by  name.   If filespec does not
  382. contain any wildcard characters, then the  single  file  specified  by
  383. filespec will be sent.
  384.  
  385.  
  386. SEND Command General Operation:
  387.  
  388. Files will be sent with their PDP-11 file name and type (for  instance
  389. FOO.BAR).   Each  file  will  be sent according to the record type and
  390. attributes recorded in its file  descriptor.   Kermit-11  attempts  to
  391. translate  all  formats of text file to a format usable on any system.
  392. Note that there is no need to set the FILE TYPE parameter for  sending
  393. files,  since  Kermit-11  always  uses  the  information from the file
  394. directory entry and the filetype (extension) to determine how to  send
  395. the file.
  396.  
  397. If communication line parity is being used (see SET PARITY), Kermit-11
  398. will  request  that  the  other  Kermit  use  a special kind of prefix
  399. notation for binary files.  This is an advanced feature, and  not  all
  400. Kermits  have  it;  if  the  other  Kermit  does not agree to use this
  401. feature,  binary  files  cannot  be  sent  correctly.   This  includes
  402. executable  programs  (like  .EXE files, CP/M .COM files), relocatable
  403. object modules (.OBJ files), as  well  as  any  text  file  containing
  404. characters with the eighth bit on.
  405.  
  406. Kermit-11 will also ask the other  Kermit  whether  it  can  handle  a
  407. special  prefix  encoding  for  repeated  characters.  If it can, then
  408. files with long strings of repeated  characters  will  be  transmitted
  409. very  efficiently.   Columnar  data,  highly indented text, and binary
  410. files are the major beneficiaries of this technique.
  411.  
  412. If you're running Kermit-11 locally, for instance dialing out  from  a
  413. PDP-11  to another system using an autodialer, you should have already
  414. run Kermit on the remote system and  issued  either  a  RECEIVE  or  a
  415. SERVER command.  Once you give Kermit-11 the SEND command, the name of
  416. each file will be displayed on your screen as the transfer begins.  As
  417. the  transfer  continues,  you  will get a small display of the packet
  418. count along with the number of packets rejected.  See the SET TERMINAL
  419. and  SET  UPDATE  commands  for  more  information.  You may also type
  420. Control-X or Control-Z to interrupt the current file  or  file  group.
  421. Control-E will also abort the transfer by sending an 'error' packet to
  422. the other Kermit.
  423.  
  424.  
  425. PDP-11 KERMIT                                                Page 1-10
  426. Commands for file transfer
  427.  
  428.  
  429.                          The RECEIVE command
  430.  
  431. Syntax:  RECEIVE [filespec]
  432.  
  433. The RECEIVE command tells Kermit-11 to receive a file  or  file  group
  434. from  the  other  system.   The  name  is taken from the incoming file
  435. header.
  436.  
  437. If an incoming file has the same name as an existing  file,  Kermit-11
  438. will  by default create a new file.  On RT-11 and RSTS/E, the old file
  439. will be deleted by the executive.  On RSX-11M/M+ and P/OS, a new  file
  440. with  a  higher  version number will be created.  To avoid files being
  441. superceded, see the SET FILE [NO]SUPERCEDE command.
  442.  
  443. Incoming files will all be stored with the prevailing file type, ASCII
  444. by  default,  which  is appropriate for text files.  If you are asking
  445. Kermit-11 to receive binary files from a microcomputer or other  8-bit
  446. system,  you must first type SET FILE TYPE FIXED.  Otherwise, an error
  447. may occur when receiving the file.  Please note  that  this  does  NOT
  448. apply to two Kermit-11 programs connected to each other.  In that case
  449. the sending Kermit-11 will tell the receiving Kermit-11 to  switch  to
  450. binary mode if need be.
  451.  
  452. If parity is being used  on  the  communications  line,  then  8th-bit
  453. prefixing will be requested.  If the other side cannot do this, binary
  454. files cannot be transferred correctly.
  455.  
  456. If you are running Kermit-11 locally, you should already have issued a
  457. SEND command to the remote Kermit, and then escaped back to Kermit-11.
  458. As files arrive, their names will be displayed on your screen.
  459.  
  460. If a file arrives that you don't  really  want,  you  can  attempt  to
  461. cancel  it  by  typing Control-X; this sends a cancellation request to
  462. the remote Kermit.  If the remote Kermit understands this request (not
  463. all  implementations  of Kermit support this feature), it will comply;
  464. otherwise it will continue to send.  If a file group  is  being  sent,
  465. you can request the entire group be cancelled by typing Control-Z.
  466.  
  467. Normally, one runs the remote Kermit as a  SERVER,  thus  the  RECEIVE
  468. command  is  never  used,  rather, the GET command, described next, is
  469. used.
  470.  
  471.                            The GET command
  472.  
  473. Syntax:  GET [remote-filespec]
  474.  
  475. The GET command requests a remote Kermit server to send  the  file  or
  476. file  group  specified  by  remote-filespec.  This command can be used
  477. only when Kermit-11 is local, with a Kermit server on the other end of
  478. the  line  specified  by  SET  LINE.   This  means  that you must have
  479. CONNECTed to the other system, logged in, run Kermit there, issued the
  480. SERVER command, and escaped back to the PDP-11.
  481.  
  482. The  remote  filespec  is  any  string  that  can  be  a  legal   file
  483.  
  484. PDP-11 KERMIT                                                Page 1-11
  485. Commands for file transfer
  486.  
  487.  
  488. specification  for  the  remote  system; it is not parsed or validated
  489. locally.  Any leading spaces before the remote filespec are  stripped,
  490. and lower case characters are raised to upper case.
  491.  
  492. As files arrive, their names will be displayed on your screen.  As  in
  493. the  RECEIVE  command, ^X to request that the current incoming file be
  494. cancelled, ^Z to request that the entire incoming batch be cancelled.
  495.  
  496. If the remote Kermit is not capable of server functions, then you will
  497. probably get an error message back from it like "Illegal packet type".
  498. In this case, you must connect  to  the  other  Kermit,  give  a  SEND
  499. command, escape back, and give a RECEIVE command.
  500.  
  501.                            Server operation
  502.  
  503. The SERVER command puts a remote Kermit-11 in "server mode",  so  that
  504. it  receives  all  further  commands in packets from the local Kermit.
  505. The Kermit-11 server is capable (as of this writing) of executing  the
  506. following  remote  server  commands:   SEND,  GET, FINISH, BYE, REMOTE
  507. DIRECTORY, REMOTE CWD,  REMOTE  SPACE,  REMOTE  DELETE,  REMOTE  TYPE,
  508. REMOTE  HELP, REMOTE COPY, REMOTE RENAME, REMOTE WHO, REMOTE LOGIN and
  509. REMOTE HOST.
  510.  
  511. Any nonstandard parameters should be selected with SET commands before
  512. putting  Kermit-11 into server mode, in particular the file type.  The
  513. Kermit-11  server  can  send  all  files   in   the   correct   manner
  514. automatically.   As noted before, if a Kermit-11 is talking to another
  515. Kermit-11, they will negotiate any 'binary' parameters  automatically.
  516. However,  if  this  is  NOT  the case and you need to ask Kermit-11 to
  517. receive binary files you must issue the  SET  FILE  TYPE  FIX  command
  518. before putting it into server mode, and then you must only send binary
  519. files.  You cannot send a mixture of text files and 8-bit binary files
  520. to a Kermit-11 server unless the files are not for use on the PDP-11.
  521.  
  522.                          Command for Servers
  523.  
  524. When running in local mode, Kermit-11 allows you to give a wide  range
  525. of  commands to a remote Kermit server, with no guarantee the that the
  526. remote server can process them, since they are all  optional  features
  527. of the protocol.  Commands for servers include the standard SEND, GET,
  528. BYE, FINISH commands, as well as the REMOTE command.
  529.  
  530.  
  531. The BYE command
  532.  
  533. The BYE command tells a remote server to log out of the remote system.
  534. In  addition,  some  remote  systems will also disconnect the line for
  535. you.  If this is not the case, the DISCONNECT command will  (depending
  536. on your interface) cause the line to be dropped.  See DISCONNECT.
  537.  
  538. The FINISH command
  539.  
  540. The FINISH command tells the remote  Kermit  server  to  exit  without
  541. logging  out  of  the remote system.  You can then CONNECT back to the
  542.  
  543. PDP-11 KERMIT                                                Page 1-12
  544. Server operation
  545.  
  546.  
  547. system.
  548.  
  549. REMOTE command
  550.  
  551. Send the specified command to the remote server.  If the  server  does
  552. not  understand  the  command  (all  of  these  commands  are optional
  553. features of the Kermit protocol), it will reply with  a  message  like
  554. "Unknown Kermit server command".  If does understand, it will send the
  555. results back, and they will be displayed on the  screen.   The  REMOTE
  556. commands are:
  557.  
  558. REMOTE COPY filespec newfilespec
  559.  
  560.      Copy file.  The server is asked to make a copy of  the  specified
  561.      file.   Both  filespecs  must  be  in  the correct format for the
  562.      remote system.  Kermit-11 does not parse  or  validate  the  file
  563.      specifications.   Any  leading  spaces will be stripped and lower
  564.      case characters converted to upper case.  Note that this  command
  565.      simply  provides  for copying a file within the server's system -
  566.      it does not cause a file to be transferred.
  567.  
  568. REMOTE CWD directory
  569.  
  570.      Change Working Directory.  If no directory name is provided,  the
  571.      server  will  change to the default or home directory.  Kermit-11
  572.      currently does not ask for a password.
  573.  
  574. REMOTE DELETE filespec
  575.  
  576.      Delete the specified file or files.  The names of the files  that
  577.      are deleted will appear on your screen.
  578.  
  579. REMOTE DIRECTORY [filespec]
  580.  
  581.      The names of the files that match the  given  file  specification
  582.      will  be  displayed  on  your screen, perhaps along with size and
  583.      date information for each file.   If  no  file  specification  is
  584.      given, all files from the current directory will be listed.
  585.  
  586. REMOTE HELP
  587.  
  588.      The remote server will send back a list of server  commands  that
  589.      it can execute.
  590.  
  591. REMOTE HOST command
  592.  
  593.      Pass the given command to the server's  host  command  processor,
  594.      and  display the resulting output on your screen.  Not all Kermit
  595.      servers can do this function.  In the case of Kermit-11, only the
  596.      RSTS/E Kermit-11 server can execute the REMOTE HOST command.
  597.  
  598. REMOTE LOGIN user password
  599.  
  600.      Ask a remote server to log into a different account or  username.
  601.  
  602. PDP-11 KERMIT                                                Page 1-13
  603. Server operation
  604.  
  605.  
  606.      The  support  for  this  command  is  rarely  implemented as many
  607.      systems  layer  login/logout  support  over  the  executive.    A
  608.      Kermit-11  server  can  only  support this on RSTS/E, and at that
  609.      only for version  9.0  or  later.   Of  the  various  DEC  PDP-11
  610.      operating systems, only RSTS/E has the support for logging in and
  611.      out built into the executive and accessible with directives.
  612.  
  613. REMOTE RENAME oldfile newfile
  614.  
  615.      Change the name on the specified  file  (or  files).   Both  file
  616.      specifications must be valid for the server's system.
  617.  
  618. REMOTE SPACE
  619.  
  620.      Display information about disk usage in the current directory.
  621.  
  622. REMOTE TYPE filespec
  623.  
  624.      Display the contents of the specified file on your screen.
  625.  
  626. REMOTE WHO
  627.  
  628.      Display current status of user's logged in.
  629.  
  630.  
  631.  
  632. Commands for Local File Management
  633.  
  634. These commands provide some local file management  capability  without
  635. having  to  leave  the  Kermit-11  program.   These  commands are very
  636. similar to the REMOTE commands in function and syntax.  They  are  all
  637. executed  locally, and are available when Kermit-11 is either local or
  638. remote.  The arguments to these commands are the same as the arguments
  639. expected  from  the user Kermit when Kermit-11 is processing a command
  640. in server mode.  Additionally, these commands can be prefixed  by  the
  641. LOCAL keyword.
  642.  
  643.         COPY filespec newfilespec
  644.         CWD directory
  645.         DELETE filespec
  646.         DIRECTORY [filespec]
  647.         HELP
  648.         HOST command
  649.         RENAME oldfile newfile
  650.         SPACE
  651.         TYPE filespec
  652.         WHO
  653.  
  654.  
  655.  
  656. Connect
  657.  
  658. The CONNECT command will allow you to connect in as a virtual terminal
  659. over  the line that was specified by the set line command.  (Using the
  660.  
  661. PDP-11 KERMIT                                                Page 1-14
  662. The Connect command
  663.  
  664.  
  665. CONNECT command before using the SET LINE command will  result  in  an
  666. error  message)  The  terminal line must be one which is accessible to
  667. the user.  The format of the CONNECT command is:
  668.  
  669.                 Kermit-11>CONNECT
  670.  
  671. The distributed RSX-11M/M+ task has been built with the  /PR:0  switch
  672. to  enable  the task to change other terminal settings.  Additionally,
  673. for RSX-11M/M+, the MCR  command  SET  /SLAVE=TTnn:   should  be  done
  674. before entering Kermit-11.
  675.  
  676. If you are running K11POS.TSK on a PRO/350, Kermit will set  the  line
  677. to XK0:  and the speed to 9600 by default.
  678.  
  679. Please note that Kermit-11 CAN NOT change the speed  of  a  DL11  type
  680. interface,  nor  can  it change the speed of a PDT-150 modem port (use
  681. SPEED.SAV).
  682.  
  683. The following is an example of using a Racal-Vadic  VA212  autodialing
  684. modem  to  log  into  a  remote TOPS-20 system.  There is one point at
  685. which there is no echoing of the user input,  this  is  following  the
  686. typing  of  the local 'escape sequence', which by default is control \
  687. followed by  a  'c'.   The  control  backslash  informs  the  terminal
  688. emulator  that  the  next  character  is a command.  In this case, the
  689. command was 'C', which means to return to  the  local  PDP-11  system.
  690. Control  \  ?   would print a help message.  All the commands prior to
  691. the DIAL command were contained in the INI file, KERMIT.INI.
  692.  
  693.  
  694.         $ kermit
  695.         Kermit-11 V3.46 Last edit: 21-Feb-1986
  696.         Kermit-11>SET MODEM VADIC
  697.         Kermit-11>SET PHO NUM CU 9K12121234567
  698.         Kermit-11>SET LOGFILE 20.LOG
  699.         Kermit-11>SET DEB CONSOLE
  700.         Kermit-11>SET LIN TT58:
  701.         Link: TT58: Speed: 9600, DTR not present
  702.         Kermit-11>SET DTR
  703.         Kermit-11>SET SPE 1200
  704.         Kermit-11>DIAL CU
  705.         Using: 9K12121234567
  706.         Connection established, type CONNECT to access remote
  707.         Kermit-11>CON
  708.         
  709.         enter class 4
  710.         class 004 start
  711.         
  712.         CU20B
  713.         @log xx.abcdef 
  714.          CU20B, TOPS-20 Monitor 5.1(5101)-2
  715.          Job 28, TTY32, 2-Apr-84 4:15:24PM
  716.          Previous login was 2-Apr-84 4:10:16PM
  717.                 .
  718.                 .
  719.  
  720. PDP-11 KERMIT                                                Page 1-15
  721. The Connect command
  722.  
  723.  
  724.                 .
  725.                 .
  726.         @log
  727.         [Confirm]
  728.         Logged out Job 28, User XX.ABCDEF , TTY 32,
  729.           at  2-Apr-84 16:19:34,  Used 0:00:11 in 0:04:10
  730.         
  731.         Kermit-11>disc
  732.         KERMIT link TT58: disconnected
  733.         Kermit-11>exit
  734.         
  735.         $ logout
  736.  
  737.  
  738.  
  739.  
  740.  
  741. SET
  742.  
  743. The SET command is used to set  various  parameters  in  kermit.   The
  744. format of the SET command is:
  745.  
  746.                 Kermit-11>SET parameter keyword
  747.  
  748.  
  749. SET ATTRIBUTES
  750.  
  751. Part of the  Kermit  protocol  is  the  support  of  file  attributes.
  752. Connected Kermits that support this can send information to each other
  753. about file size, time/date of creation, RMS  file  headers  and  other
  754. useful   things.    Due   to   potential  problems  with  incompatible
  755. implementations this feature can  be  disabled.   In  this  case,  the
  756. sending  Kermit-11 will never try to send file attributes, even though
  757. the receiver may have indicated that it supports this.
  758.  
  759.                 Kermit-11>SET ATTRIBUTES OFF
  760.                 Kermit-11>SET ATTRIBUTES ON
  761.  
  762.  
  763. SET BAUD
  764.  
  765. This is the same as SET SPEED.  See HELP SET SPEED
  766.  
  767. SET BINARY-TYPE
  768.  
  769. Kermit-11 has a default list of filetypes that are scanned  to  decide
  770. if  a  file should be sent in binary mode in addition to checking file
  771. attributes for RSX, P/OS and RSTS/E.  The user can, however,  override
  772. this  list  with  the  this  command.   The  default  list  is  fairly
  773. inclusive, with types such as .SAV and  .TSK  forcing  Kermit-11  into
  774. binary transmission.  See HELP SET FIL for the default list.
  775.  
  776.         Kermit-11> SET BINARY-TYPE .SAV
  777.         Kermit-11> SET BIN .EXE
  778.  
  779. PDP-11 KERMIT                                                Page 1-16
  780. The SET COMMAND
  781.  
  782.  
  783.  
  784.  
  785. SET BLOCK-CHECK
  786.  
  787. The SET BLOCKCHECK command  is  used  to  determine  the  block  check
  788. sequence  which  will  be  used  during transmission.  The block check
  789. sequence is used to detect transmission errors.  There are three types
  790. of  block  check  available.   These are the single character checksum
  791. (default), the two character checksum, and  the  three  character  CRC
  792. (cyclic  redundancy  check).   This  command  does not ensure that the
  793. desired type of block check will be used, since both Kermit's involved
  794. in  the  transfer  must agree on the block check type.  Kermit-11 will
  795. request that the type of block check set by this command be used for a
  796. transfer.   If the other Kermit has also had the same block check type
  797. requested, then the desired block check type will be used.  Otherwise,
  798. the  single  character  checksum  will be used.  The command should be
  799. given to BOTH Kermits since Kermit-11, when in server mode, has no say
  800. about  what  kind  of  checksum it wants to use.  (See Kermit protocol
  801. manual for more information.)
  802.  
  803.            Kermit-11>SET BLOCK_CHECK keyword
  804.            Kermit-11>SET BLO 1
  805.            Kermit-11>SET BLO 2
  806.            Kermit-11>SET BLO 3
  807.  
  808. Where keyword is one of:
  809.  
  810.           1_CHARACTER_CHECKSUM or ONE_CHARACTER_CHECKSUM
  811.  
  812.           2_CHARACTER_CHECKSUM or TWO_CHARACTER_CHECKSUM
  813.  
  814.           3_CHARACTER_CRC_CCITT or THREE_CHARACTER_CRC_CCITT
  815.  
  816.  
  817. SET CONSOLE
  818.  
  819. The SET CONSOLE command is used under P/OS to control the passing of 8
  820. bit  data  to  th  terminal  during  the  connect command.  If you are
  821. getting multinational characters being printed, this is a very  useful
  822. thing to set.  The default is SET CON 7.
  823.  
  824.         Kermit-11>SET CON 8
  825.         Kermit-11>SET CON 7
  826.  
  827.  
  828. SET DEBUG
  829.  
  830. The SET DEBUG command is  used  to  specify  the  type  and  level  of
  831. debugging  to  a disk file .  This disk file must have been created by
  832. the SET LOGFILE command.  The format for SET DEBUG is:
  833.  
  834.                 Kermit-11>SET DEBUG qualifier
  835.  
  836.  
  837. PDP-11 KERMIT                                                Page 1-17
  838. The SET COMMAND
  839.  
  840.  
  841. SET DEBUG ALL
  842.  
  843. SET DEBUG ALL will turn on logging for CONSOLE,CONNECT,FILE,PACKET and
  844. STATE  to the disk file specified by SET LOGFILE.  This command is the
  845. same as SET DEBUG ON.  The command format is:
  846.  
  847.                 Kermit-11>SET DEBUG ALL
  848.  
  849.  
  850. SET DEBUG CONSOLE
  851.  
  852. SET DEBUG CONSOLE will turn on logging for all  i/o  during  a  remote
  853. connect  to  the  disk file specified by SET LOGFILE.  This command is
  854. the same as SET DEBUG CONNECT.  The command format is:
  855.  
  856.                 Kermit-11>SET DEBUG CONSOLE
  857.  
  858.  
  859. SET DEBUG CONNECT
  860.  
  861. SET DEBUG CONNECT will turn on logging for all  i/o  during  a  remote
  862. connect  to  the  disk file specified by SET LOGFILE.  This command is
  863. the same as SET DEBUG CONSOLE.  The command format is:
  864.  
  865.                 Kermit-11>SET DEBUG CONNECT
  866.  
  867.  
  868. SET DEBUG FILE
  869.  
  870. SET DEBUG FILE will log all file 'opens' and  'creates'  to  the  file
  871. specified by SET LOGFILE.  The command format is:
  872.  
  873.                 Kermit-11>SET DEBUG FILE
  874.  
  875.  
  876. SET DEBUG HELP
  877.  
  878. SET DEBUG HELP gives the user a list of all qualifiers  which  can  be
  879. used with SET DEBUG.  Command format is:
  880.  
  881.                 Kermit-11>SET DEBUG HELP
  882.  
  883.  
  884. SET DEBUG NONE
  885.  
  886. SET DEBUG NONE 'turns off' all debugging.  This is the same as the SET
  887. DEBUG OFF command.  Command format is:
  888.  
  889.                 Kermit-11>SET DEBUG NONE
  890.  
  891.  
  892. SET DEBUG OFF
  893.  
  894. SET DEBUG OFF 'turns off' all debugging.  This is the same as the  SET
  895.  
  896. PDP-11 KERMIT                                                Page 1-18
  897. The SET COMMAND
  898.  
  899.  
  900. DEBUG NONE command.  Command format is:
  901.  
  902.                 Kermit-11>SET DEBUG OFF
  903.  
  904.  
  905. SET DEBUG ON
  906.  
  907. SET DEBUG ON will'turn on' logging for CONSOLE,CONNECT,FILE,PACKET and
  908. STATE  to the disk file specified by SET LOGFILE.  This command is the
  909. same as SET DEBUG ALL.  The command format is:
  910.  
  911.                 Kermit-11>SET DEBUG ON
  912.  
  913.  
  914. SET DEBUG PACKET
  915.  
  916. SET DEBUG PACKET will 'turn on' logging of all  receive  and  transmit
  917. packets to the disk file specified by SET LOGFILE.  The command format
  918. is:
  919.  
  920.                 Kermit-11>SET DEBUG PACKET
  921.  
  922.  
  923. SET DEBUG STATE
  924.  
  925. SET DEBUG STATE will turn on logging of all internal  Kermit-11  state
  926. transitions
  927.  
  928. SET DELAY
  929.  
  930. The DELAY parameter is the number of seconds to  wait  before  sending
  931. data  after  a  SEND command is given.  This is used when Kermit-11 is
  932. running in remote mode to allow the user time to escape  back  to  the
  933. other Kermit and give a RECEIVE command.
  934.  
  935.            Kermit-11>SET DELAY number-of-seconds
  936.  
  937. Where number of seconds is the (decimal)  number  of  second  to  wait
  938. before sending data.
  939.  
  940. SET DEFAULT
  941.  
  942. The DEFAULT parameter allows you to specify a device and UIC (or  PPN)
  943. for  all  subsequent  file  opens  (for SENDING) and file creates (for
  944. RECEIVING).  It is disabled by typing SET HOME.
  945.  
  946.                 Kermit-11>SET DEFAULT device
  947.                 Kermit-11>SET DEFAULT DB2:[200,201]
  948.  
  949. This is quite useful for Kermit-11 running on a DECNET  link,  as  you
  950. can  set  the  default  for  file operations to include node names and
  951. passwords as in:
  952.  
  953.                 Kermit-11>set def orion::sys$system:[fubar]
  954.  
  955. PDP-11 KERMIT                                                Page 1-19
  956. The SET COMMAND
  957.  
  958.  
  959.  
  960.  
  961. SET DIAL
  962.  
  963. Kermit-11 has knowledge built in to it of a number of the more  common
  964. 'smart'  autodial  modems.   To  find  out  if  your modem is directly
  965. supported try the command SET MODEM ?.  If your modem is not  in  this
  966. list then you need the SET DIAL command to generate the data base used
  967. by Kermit to control the  modem.   Kermit  uses  this  information  to
  968. implement  the  DIAL command.  A command such as DIAL can only be done
  969. when Kermit knows both how to format commands to the modem,  and  what
  970. kind  of  text  the  modem  will  send  back to it in response.  As an
  971. example, the VADIC VA212PA modem is awakened from an idle state by the
  972. character sequence (in octal)
  973.  
  974.         05 015
  975.  
  976. which is a Control E followed by a carriage return.   In  response  to
  977. this two character string, the modem responds with:
  978.  
  979.         HELLO: I'M READY
  980.         *
  981.  
  982. Thus Kermit has to know that when it  sends  the  wakeup  sequence  it
  983. needs  to wait for the asterisk to be sent back by the modem.  At this
  984. point Kermit will know that the modem is in a state  awaiting  further
  985. commands, such as that to dial a phone number.
  986.  
  987. It is not possible for Kermit  to  have  knowledge  of  all  makes  of
  988. modems.  Instead Kermit supports a command called:
  989.  
  990.         Kermit-11>SET MODEM USER_DEFINED
  991.  
  992. which then allows you to use the SET DIAL command to inform Kermit how
  993. the  modem works.  Once Kermit knows how to control the modem, you can
  994. use the DIAL command to initiate a call from Kermit.
  995.  
  996. The SET DIAL commands are:
  997.  
  998.         SET DIAL WAKEUP         define the wakeup string
  999.         SET DIAL PROMPT         define the prompt the modem uses
  1000.         SET DIAL INITIATE       define a string to start dialing
  1001.         SET DIAL CONFIRM        define the string to confirm number
  1002.         SET DIAL FORMAT         define the number formatting string
  1003.         SET DIAL SUCCESS        define string(s) for call complete
  1004.         SET DIAL INFO           define string(s) for informative text
  1005.         SET DIAL FAILURE        define string(s) for call failure
  1006.         SET DIAL CONFIRM        define string for number confirmation
  1007.         SET DIAL WAKE_RATE      set pause time between wakeup characters
  1008.         SET DIAL DIAL_RATE      set pause time between number digits
  1009.         SET DIAL DIAL_PAUSE     define string for dial tone pause
  1010.  
  1011.  
  1012. Suppose we had to tell Kermit about  the  Racal  Vadic  VA212PA  modem
  1013.  
  1014. PDP-11 KERMIT                                                Page 1-20
  1015. The SET COMMAND
  1016.  
  1017.  
  1018. (though in reality Kermit already knows about that kind).  In checking
  1019. the owners manual for it, we find that:
  1020.  
  1021.      To wake the modem up, we type a control E followed by a  carriage
  1022.      return.
  1023.  
  1024.      To dial a number, we type the letter D  followed  by  a  carriage
  1025.      return.   At  this  point, the modem prints a NUMBER?  prompt, we
  1026.      then type the desired number in.  It reprints the number and then
  1027.      waits  for  a  carriage return from us to confirm that its really
  1028.      the correct phone number.
  1029.  
  1030.      When it completes dialing, it will print 'ON  LINE'  or  'ONLINE'
  1031.      for  a  successful call, otherwise it may display on the terminal
  1032.      'BUSY', 'FAILED CALL', 'NO DIAL', 'VOICE' or 'TIME  OUT'.   While
  1033.      it  is waiting for its call to be answered, it may print the line
  1034.      'RINGING' several times in order to tell you that it  is  working
  1035.      on it.
  1036.  
  1037.  
  1038. The Kermit commands required would be:
  1039.  
  1040.         Kermit-11>SET MODEM USER_DEFINED
  1041.         Kermit-11>SET DIAL WAKEUP \05\015
  1042.         Kermit-11>SET DIAL PROMPT *
  1043.         Kermit-11>SET DIAL INITIATE D\015
  1044.         Kermit-11>SET DIAL FORMAT %P%S\015
  1045.         Kermit-11>SET DIAL CONFIRM \015
  1046.         Kermit-11>SET DIAL SUCCESS ONLINE
  1047.         Kermit-11>SET DIAL SUCCESS ON LINE
  1048.         Kermit-11>SET DIAL INFO RINGING
  1049.         Kermit-11>SET DIAL FAILURE BUSY
  1050.         Kermit-11>SET DIAL FAILURE FAILED CALL
  1051.         Kermit-11>SET DIAL FAILURE NO DIAL
  1052.         Kermit-11>SET DIAL FAILURE VOICE
  1053.         Kermit-11>SET DIAL FAILURE TIME OUT
  1054.         Kermit-11>SET DIAL DIAL_PAUSE 9K
  1055.         Kermit-11>DIAL 14195551212
  1056.  
  1057. The notation "\05\015" indicates the Control E followed by a  carriage
  1058. return;  05  is octal for control E, 015 is octal for carriage return.
  1059. An alternate notation for octal numbers can be  used  by  placing  the
  1060. value  inside  of inequality characters, as in SET DIAL WAKE <05><015>
  1061. though the former is preferred.
  1062. The notation "%P%S\015" indicates to Kermit that the phone number from
  1063. the  dial  command  is  to be followed by a carriage return; the %S is
  1064. simply a placeholder for the phone number.  The presence of the %P  is
  1065. to  indicate  where  to  insert the dial pause string, in this case we
  1066. need to dial 9 and wait for a second dial tone.  The "K" is the  Racal
  1067. Vadic  code to get the modem to pause.  If you are dialing on a direct
  1068. line, the DIAL_PAUSE command is unneeded.  If for any reason you  need
  1069. to  pass  a "\" or "<" to your modem, simply prefix the character with
  1070. another "\", as in "\\".
  1071.  
  1072. PDP-11 KERMIT                                                Page 1-21
  1073. The SET COMMAND
  1074.  
  1075.  
  1076. Many modems  require  only  the  WAKEUP,  PROMPT,  FORMAT  and  result
  1077. strings.   The  Digital  DF112  is an example of this; it's definition
  1078. would look like:
  1079.  
  1080.         Kermit-11>SET MODEM USER_DEFINED
  1081.         Kermit-11>SET DIAL WAKEUP \02
  1082.         Kermit-11>SET DIAL PROMPT READY
  1083.         Kermit-11>SET DIAL FORMAT %S#
  1084.         Kermit-11>SET DIAL SUCCESS ATTACHED
  1085.         Kermit-11>SET DIAL FAILURE BUSY
  1086.         Kermit-11>SET DIAL FAILURE DISCONNECTED
  1087.         Kermit-11>SET DIAL FAILURE ERROR
  1088.         Kermit-11>SET DIAL FAILURE NO ANSWER
  1089.  
  1090. Some modems may be unable to accept data at the line  speed;  in  this
  1091. case  we  would  need  to  use  the  SET  DIAL  WAKE_RATE and SET DIAL
  1092. DIAL_RATE.  These two commands accept a delay  time  in  milliseconds;
  1093. the  actual  delay  will  not  be  precise  as  the  PDP-11 line clock
  1094. interrupts sixty times per second.  Furthermore, on RSTS/E the  finest
  1095. granularity for timing is one second; thus setting delays would result
  1096. in delays of one second increments.
  1097.  
  1098. In general, not all of the result fields need be specified except  for
  1099. the  call  completed strings; Kermit will time out after a while if it
  1100. can't match a response with any definitions.
  1101.  
  1102. Further information can be found in the sections on SET  MODEM,  DIAL,
  1103. REDIAL and SET PHONE.
  1104.  
  1105.  
  1106. SET DTR
  1107.  
  1108. The SET DTR command is very similar  to  the  DISCONNECT  (or  HANGUP)
  1109. command.   SET  DTR,  where  supported, raises DTR for a predetermined
  1110. amount of time, whereas the DISCONNECT (or HANGUP) command drops  DTR.
  1111. The  SET  DTR is only functional on RSTS/E, which by default keeps DTR
  1112. low until either RING INDICATOR or CARRIER DETECT goes high.  This  is
  1113. opposite of the behavior on RT11 and RSX11M/M+, both of which normally
  1114. assert DTR.  The SET DTR command raises DTR for at  least  30  seconds
  1115. (depending  on  the  version  of  RSTS/E)  and  is  useful  for making
  1116. connections to front end switches (such as  MICOM  and  GANDALF).   On
  1117. RT11,  SET DTR is identical to the HANGUP command; it simply drops DTR
  1118. for two seconds.  In this case (RT11 and TSX+) this  command  is  only
  1119. supported  on  RT11  5.2  and  TSX+ 6.0 with the XL/XC and CL drivers,
  1120. respectively.  This command is a no-op on  RSX11M/M+  and  P/OS.   For
  1121. further  information on modem support, see the later section regarding
  1122. such.
  1123.  
  1124.  
  1125. SET DUPLEX
  1126.  
  1127. The DUPLEX parameter controls whether an outgoing link  (set  via  the
  1128. SET LINE command) is a full duplex link (the default) or a half duplex
  1129. link.  All it does for half duplex is to cause  all  characters  typed
  1130.  
  1131. PDP-11 KERMIT                                                Page 1-22
  1132. The SET COMMAND
  1133.  
  1134.  
  1135. after the CONNECT command to be echoed locally.
  1136.  
  1137.                 Kermit-11>SET DUPLEX HALF
  1138.                 Kermit-11>SET DUPLEX FULL
  1139.  
  1140.  
  1141.  
  1142. SET END-OF-LINE
  1143.  
  1144. The END-OF-LINE parameter sets the ascii character which will be  used
  1145. as  a  line terminator for all packets SENT to the other KERMIT.  This
  1146. is normally not needed for most versions of KERMIT.
  1147.  
  1148.                 Kermit-11>SET END-OF-LINE octal value of character
  1149.  
  1150.  
  1151. SET ESCAPE
  1152.  
  1153. This command will set the escape character for the CONNECT processing.
  1154. The  command  will take the octal value of the character to use as the
  1155. escape character.  This is the character which  is  used  to  "escape"
  1156. back  to  Kermit-11  after  using the CONNECT command.  It defaults to
  1157. control (octal 34).  It is usually a good idea to set  this  character
  1158. to something which is not used (or at least not used very much) on the
  1159. system being to which Kermit-11 is CONNECTing.
  1160.  
  1161.            Kermit-11>SET ESCAPE octal-character-value
  1162.  
  1163. Where octal-character-value is the ASCII value of the character to use
  1164. as the escape character (in octal).
  1165.  
  1166. SET FILE
  1167.  
  1168. The SET FILE allows you to set various file related parameters.
  1169.  
  1170.         Kermit-11>SET FIL option
  1171.  
  1172.  
  1173. SET FILE TYPE ASCII
  1174.  
  1175. File type ASCII is for text files.  SET FILE TYPE TEXT is the same.
  1176.  
  1177. SET FILE TYPE AUTO
  1178.  
  1179. Kermit-11 will normally try to decide if a file must be sent in binary
  1180. mode based on the file attributes and filetype.  If, for instance, the
  1181. directory entry for FUBAR.TXT showed it  to  be  RMS  (or  FCS)  fixed
  1182. length  records,  Kermit-11  will  switch  to  binary mode and send it
  1183. verbatim.  If the receiving Kermit  is  Kermit-11,  then  the  sending
  1184. Kermit  will  send attribute data over also.  The following file types
  1185. also will normally be sent as binary files unless you use the SET FILE
  1186. TYPE NOAUTO command.
  1187.  
  1188.                 *.TSK   ; rsx, ias, and rsts tasks
  1189.  
  1190. PDP-11 KERMIT                                                Page 1-23
  1191. The SET COMMAND
  1192.  
  1193.  
  1194.                 *.SAV   ; rt11 and rsts save images
  1195.                 *.OBJ   ; compiler and mac output
  1196.                 *.STB   ; tkband link symbol tables
  1197.                 *.CRF   ; tkb and link cross reference files
  1198.                 *.TSD   ; 'time shared dibol' for rt11
  1199.                 *.BAC   ; rsts basic+ 'compiled' files
  1200.                 *.OLB   ; rsx, ias, and rsts object libraries
  1201.                 *.MLB   ; rsx, ias, and rsts macro libraries
  1202.                 *.RTS   ; rsts/e run time systems
  1203.                 *.EXE   ; vms executable
  1204.  
  1205. SET FILE TYPE BINARY
  1206.  
  1207. File type BINARY is for non-text files.  Note that binary files  which
  1208. are generated on a PDP-11 system cannot be transferred to another (non
  1209. PDP-11) system without losing file attributes.  This means  that  (for
  1210. example),  an  RSM11 indexed file cannot be transmitted with Kermit-11
  1211. at this time.  You can not have parity set to anything but NONE to use
  1212. binary file transfer (see HELP SET PARITY) unless the other Kermit can
  1213. process eight bit quoting.  Two Kermit-11's connected  to  each  other
  1214. will  use  binary  transmission automatically via the Kermit attribute
  1215. packets, preserving file attributes where it makes sense  (ie,  RSTS/E
  1216. and RSX only).
  1217.  
  1218. SET FILE TYPE DECMULTINATIONAL
  1219.  
  1220. PDP-11 Kermit normally strips the high bit of every character on  both
  1221. transmission  and  reception  of files (unless the SET FILE TYPE FIXED
  1222. command was given).  The SET FIL DEC command will cause  Kermit-11  to
  1223. leave all data intact but still obey the host file system when reading
  1224. or writing files.   In  other  words,  Kermit  will  write  sequential
  1225. implied  carriage control files with eight bit data if this command is
  1226. used.
  1227.  
  1228. SET FILE TYPE FIXED
  1229.  
  1230. This is the same as SET FIL TYP BIN
  1231.  
  1232. SET FILE TYPE NOAUTO
  1233.  
  1234. SET  FILE  NOAUTO  disables  Kermit-11  from  trying  to  base  binary
  1235. transmission mode on file attributes or filetype.
  1236.  
  1237. SET FILE SUPERCEDE
  1238.  
  1239. SET FILE [NO]SUPERCEDE allows Kermit-11  to  accept  or  reject  files
  1240. received  (from  either  the  RECEIVE  or  GET commands) on a per file
  1241. basis.  The default is  SUPERCEDE.   By  doing  SET  FILE  NOSUPERCEDE
  1242. Kermit-11  will  always  check  to  see  if  the file to be created is
  1243. already there (independent of version number) and  reject  it  to  the
  1244. sending  server  if  it exists.  This presumes that the Kermit sending
  1245. the file understands the protocol to reject one file of  a  (possibly)
  1246. wildcarded group of files.
  1247. The main use of this is to resume getting a group of files, as in  GET
  1248.  
  1249. PDP-11 KERMIT                                                Page 1-24
  1250. The SET COMMAND
  1251.  
  1252.  
  1253. KER:K11*.*  or  GET  KER:MS????.*  having  lost  the  connection after
  1254. transferring some of the files.   If  this  is  set,  then  any  files
  1255. already transferred will not be transferred again.
  1256.  
  1257.         Kermit-11>SET FILE SUPERCEDE
  1258.         Kermit-11>SET FILE NOSUPERCEDE
  1259.  
  1260.  
  1261. SET HOME
  1262.  
  1263. SET HOME resets the default device and UIC (or PPN)  to  nothing,  ie,
  1264. all  file  opens  and creates use your default disk (SY:) and your UIC
  1265. (or PPN).
  1266.  
  1267.                 Kermit-11>SET HOME
  1268.  
  1269.  
  1270. SET IBM-MODE
  1271.  
  1272. The SET IBM ON (or OFF) will instruct Kermit-11 to  wait  for  an  XON
  1273. following  each packet sent to an IBM host.  Since the default for IBM
  1274. mode may not always be appropriate for your IBM compatible system, you
  1275. can  always use the SET HANDSHAKE XON and SET DUPLEX HALF to avoid the
  1276. parity setting implied by using IBM mode.
  1277.  
  1278.                 Kermit-11>SET IBM ON
  1279.                 Kermit-11>SET IBM OFF
  1280.  
  1281.  
  1282. SET LINE
  1283.  
  1284. The SET LINE command sets the  terminal  name  up  for  use  with  the
  1285. connect command.  To use this you must have access to that device.  On
  1286. many systems terminal lines other than your  own  are  protected  from
  1287. access, and may require special procedures to access them.
  1288. The form of the device name is TTnnn:, where 'nnn' is a decimal number
  1289. for  RSTS  and  an octal number for RSX-11M/M+.  For RT-11, the device
  1290. name is simply the MT unit number shown by the SHO TER command, as  in
  1291. '5'  for DZ11 unit 0 line 4.  If the system is running RT-11 version 5
  1292. you can do a SET LIN XL:.   At  worst  case,  Kermit-11  can  use  the
  1293. console  port  on  RT-11.  For more information see the notes later on
  1294. for RT-11 If you are running  K11POS.TSK  for  P/OS  on  the  PRO/350,
  1295. Kermit-11  will  set the line to XK0:  and the speed to 9600 baud when
  1296. Kermit starts.  To override the line or speed, set HELP SET  LINE  and
  1297. HELP SET SPEED.
  1298.  
  1299.         Kermit-11>SET LINE TT55:        (for RSTS and RSX-11M/M+)
  1300.         Kermit-11>SET LINE 5            (for RT-11 and MT service)
  1301.         Kermit-11>SET LINE XK0:         (for P/OS, done implicitly)
  1302.         Kermit-11>SET LINE XL:          (for RT-11 and XL handler)
  1303.  
  1304. See HELP CONNECT,  HELP  SET  DUPLEX  and  HELP  SET  SPEED  for  more
  1305. information.   Also,  for TSX+, see notes regarding TSX later in these
  1306. notes.  The RT-11 XL handler has notes later on also.
  1307.  
  1308. PDP-11 KERMIT                                                Page 1-25
  1309. The SET COMMAND
  1310.  
  1311.  
  1312. SET LOGFILE
  1313.  
  1314. The SET LOGFILE command creates a debug dump file for you.  It must be
  1315. used  BEFORE  any  SET DEBUG commands can be used.  See HELP DEBUG for
  1316. further information about debugging modes.
  1317.  
  1318.                 Kermit-11>SET LOGFILE MYLOG.TXT
  1319.                 Created debug file MYLOG.TXT
  1320.                 Kermit-11>
  1321.  
  1322.  
  1323. SET MODEM
  1324.  
  1325. The SET MODEM command defines the type of MODEM use for dialing out on
  1326. the  line  set  with  the  SET  LINE  command,  or, in the case of the
  1327. PRO/350, the XC or XK port.  There are only a few  modems  defined  at
  1328. this time, they are:
  1329.  
  1330.                 VADIC           Generic RACAL-VADIC autodial
  1331.                 VA212PA         Stand alone VADIC VA212
  1332.                 VA212PAR        Rack mounted VADIC VA212
  1333.                 VA4224          Rack mounted VADIC VA4224 .v22bis
  1334.                 HAYES           Hayes smartmodem
  1335.                 DF100           DEC DF112
  1336.                 DF200           DEC DF224
  1337.                 DF03            DEC DF03
  1338.                 MICROCOM
  1339.  
  1340. The DIAL command is then  used  after  the  SET  MODEM  command.   For
  1341. example, on a PRO/350 running P/OS:
  1342.  
  1343.                 Kermit-11>set pro PRO>
  1344.                 PRO>set modem va212pa
  1345.                 PRO>dial 5374411
  1346.                 Modem in command modem
  1347.                 Modem dialing
  1348.                 Connection made, type CONNECT to access remote
  1349.                 PRO>con
  1350.                 Enter class ? VX785A
  1351.                 Class start
  1352.                 Username: BRIAN
  1353.                 Password: ......................
  1354.  
  1355.                 and so on
  1356.  
  1357.  
  1358. SET PACKET-LENGTH
  1359.  
  1360. You can alter the default  transmitted  packet  length  with  the  SET
  1361. PACKET-LENGTH  command.  This should not normally be needed unless the
  1362. line is very noisy, at which time you should probably give up anyway.
  1363.  
  1364.                 Kermit-11>SET PACKET 60
  1365.  
  1366.  
  1367. PDP-11 KERMIT                                                Page 1-26
  1368. The SET COMMAND
  1369.  
  1370.  
  1371. SET PARITY
  1372.  
  1373. This is used with the SET LINE and CONNECT  commands  to  specify  the
  1374. type  of  parity  for the remote link.  It defaults to NONE and can be
  1375. either ODD, EVEN, MARK or SPACE as in:
  1376.  
  1377.                 Kermit-11>SET PARITY NONE
  1378.                 Kermit-11>SET PARITY ODD
  1379.                 Kermit-11>SET PARITY EVEN
  1380.                 Kermit-11>SET PARITY MARK
  1381.                 Kermit-11>SET PARITY SPACE
  1382.  
  1383. All parity generation is done via software,  no  special  hardware  is
  1384. used.   The  use  of software parity generation is restricted to 8 bit
  1385. links only.  The character format, if parity is set  to  anything  but
  1386. NONE,  will be 7 bits of data followed with high bit set or cleared to
  1387. indicate the parity.  If you set parity  to  anything  but  NONE  (the
  1388. default),  Kermit-11 will be forced to request 8bit prefixing from the
  1389. other Kermit-11, which is a method by which Kermit can 'prefix'  eight
  1390. bit  characters  with a shift code.  You MUST use parity (even if MARK
  1391. or SPACE) when using Kermit-11 with the IBM CMS Series/1 or 7171  3270
  1392. emulator.
  1393.  
  1394. SET PAUSE
  1395.  
  1396. PAUSE tells Kermit to wait the specified  number  of  seconds  between
  1397. each  packet being sent to the other Kermit.  This may be useful under
  1398. situations of heavy system load.  This may be  automatically  computer
  1399. by Kermit-11 in a future release as a function of line speed.
  1400.  
  1401.                 Kermit-11>SET PAUSE 1
  1402.  
  1403.  
  1404. SET PHONE
  1405.  
  1406. The SET PHONE NUMBER command allows you to associate  a  phone  number
  1407. with  a  symbolic  name  for  later  use with the DIAL command.  These
  1408. definitions  could  be  placed  in  your  KERMIT.INI  file,  and  then
  1409. referenced later.
  1410.  
  1411.                 Kermit-11>SET PHO NUM WORK 5374411
  1412.                 Kermit-11>SET PHO NUM MARKET 16174671234
  1413.                 Kermit-11>DIAL WORK
  1414.  
  1415. The other two SET PHONE options, SET PHONE [TONE][PULSE] and SET PHONE
  1416. BLIND  are not useful unless the appropiate dial formatting string and
  1417. character sequences for selecting PULSE or TONE, and BLIND dialing are
  1418. present  in  the  modem  definition  macros in K11DIA.MAC.  The format
  1419. effector for TONE/PULSE is %M  and  the  effector  for  BLIND  is  %B.
  1420. Currently (in 3.54) only the VA4224 has entries for these options.
  1421.  
  1422. SET POS
  1423.  
  1424. The SET POS command allows options SPECIFIC to  P/OS  to  be  altered.
  1425.  
  1426. PDP-11 KERMIT                                                Page 1-27
  1427. The SET COMMAND
  1428.  
  1429.  
  1430. The  most  useful  option is the SET POS [NO]DTE command.  This allows
  1431. Kermit-11 to use PRO/Communications version 2 for terminal  emulation,
  1432. if this product has been installed on the PRO/350.  Of course, if this
  1433. option is chosen, control is returned to the PRO  with  the  EXIT  key
  1434. (F10) rather than with Control \C.
  1435.  
  1436.                 Kermit-11>SET POS DTE
  1437.                 Kermit-11>SET POS NODTE
  1438.  
  1439. SET PROMPT
  1440.  
  1441. The SET PROMPT command is useful if you are using two  Kermit-11's  to
  1442. talk  to  each other.  By using the SET PROMPT command, you can change
  1443. the prompt from 'Kermit-11>' on either (or both) Kermit  to  something
  1444. that would indicate which system you are currently connected to.
  1445.  
  1446.                 Kermit-11>SET PROMPT KERMIT-11/1170>
  1447.                 Kermit-11>SET PROMPT FUBAR>
  1448.                 Kermit-11>SET PROMPT PROKERMIIT-11>
  1449.  
  1450.  
  1451. SET RECEIVE
  1452.  
  1453. Currently the SET RECEIVE and SET SEND basically work the same in that
  1454. they  only  alter  the  END-OF-LINE  character and the START-OF-PACKET
  1455. value, as in:
  1456.  
  1457.                 Kermit-11>SET REC START 2
  1458.                 Kermit-11>SET REC END 12
  1459.  
  1460. The command SET RECEIVE PACKET-LENGTH command is discussed below.
  1461.  
  1462. SET RECEIVE END-OF-LINE
  1463.  
  1464. This instructs Kermit-11 to expect something other  than  the  default
  1465. carriage  return  (octal  15)  at the end of a packet.  Kermit-11 will
  1466. ignore packet terminators.  The SET SEND END command is of more use in
  1467. conditioning outgoing packets.
  1468.  
  1469. SET RECEIVE START-OF-PACKET
  1470.  
  1471. The normal Kermit packet prefix is Control-A (1); this command changes
  1472. the  prefix  Kermit-11  expects on incoming packets.  The only reasons
  1473. this should ever  be  changed  would  be:   Some  piece  of  equipment
  1474. somewhere  between  the  two  Kermit  programs will not pass through a
  1475. Control-A; or, some piece of of equipment similarly placed is  echoing
  1476. its  input.   In  the  latter  case, the recipient of such an echo can
  1477. change the packet prefix for outbound packets  to  be  different  from
  1478. that  of  arriving packets so that the echoed packets will be ignored.
  1479. The opposite Kermit must also be told to change  the  prefix  for  its
  1480. inbound packets and the prefix it uses on outgoing packets.
  1481.  
  1482.                 Kermit-11>SET REC START-OF-PACKET 2
  1483.  
  1484.  
  1485. PDP-11 KERMIT                                                Page 1-28
  1486. The SET COMMAND
  1487.  
  1488.  
  1489. SET RECEIVE PACKET-LENGTH
  1490.  
  1491. This command has two functions.  The first,  and  normal  one,  is  to
  1492. reduce  incoming  packet lengths in the event that normal sized Kermit
  1493. packets can not be passed through the communications  circuit.   There
  1494. could  be,  perhaps, some 'black box' somewhere in the link that has a
  1495. very small buffer size; this command could be used to reduce the  size
  1496. that the SENDING Kermit will use.
  1497.  
  1498. The other use is to enable a new protocol extension to  Kermit  called
  1499. 'LONG  PACKETS'.   The  actual protocol is documented elsewhere, let's
  1500. just say that this is a way for two Kermit's to use packet  sizes  far
  1501. greater  than  the  normal ('Classic') packet size if 90 characters or
  1502. so.  The main use of this feature is in file transfer over links  that
  1503. introduce  considerable delay, it is not uncommon for packets to incur
  1504. an one to two second delay.  The net result is  a  VERY  slow  running
  1505. Kermit  with an effective speed of perhaps 300 to 600 baud rather than
  1506. 1200 or 2400 baud.   By  making  the  packets  longer,  we  raise  the
  1507. effective speed of such a circuit.  The main restriction on the packet
  1508. size chosen is the link, a given circuit may not  pass  500  character
  1509. packets.   Also,  BOTH  Kermits  must  support  this  extension to the
  1510. protocol, they will always negotiate it before any file transfer.  See
  1511. the notes at the end of this document for more information.
  1512.  
  1513.                 Kermit-11>SET REC PAC 50
  1514.                 Kermit-11>SET REC PAC 600
  1515.  
  1516. It is HIGHLY recommended that you use the  CRC  block  check,  as  the
  1517. default  type  one checksum could be inadequate for such long packets,
  1518. as in:
  1519.  
  1520.                 Kermit-11>SET BLO 3
  1521.  
  1522.  
  1523. SET RECORD-FORMAT
  1524.  
  1525. Kermit will, by default, create RMS11 variable length implied carriage
  1526. control  records  for text files.  You can override this and change it
  1527. to create stream ascii  records  with  the  SET  RECORD-FORMAT  STREAM
  1528. command.   This  is  useful  for  RSTS/E  systems  if  you  need  file
  1529. compatability with BASIC Plus.
  1530.  
  1531.                 Kermit-11>SET RECORD-FORMAT STREAM
  1532.                 Kermit-11>SET RECORD-FORMAT VARIABLE
  1533.  
  1534. This command would be most useful  in  a  KERMIT.INI  file,  which  is
  1535. executed by KERMIT when Kermit starts.
  1536.  
  1537. SET RETRY
  1538.  
  1539. SET RETRY value tells Kermit to try that many times on a NAK'ed packet
  1540. before giving up.  This should only be needed if the line is extremely
  1541. noisy or the PDP-11 host is running very  slowly  due  to  the  system
  1542. load.
  1543.  
  1544. PDP-11 KERMIT                                                Page 1-29
  1545. The SET COMMAND
  1546.  
  1547.  
  1548.  
  1549.                 Kermit-11>SET RETRY 10
  1550.  
  1551.  
  1552. SET RSX
  1553.  
  1554. The SET RSX command is intended to deal with the  peculiarities  often
  1555. found  with  RSX systems.  There are currently three SET RSX commands,
  1556. as in:
  1557.  
  1558.         Kermit-11>SET RSX FASTIO        Default for packet reading,
  1559.                                         waits for <CR>.
  1560.         Kermit-11>SET RSX CHARIO        Read one char at a time for
  1561.                                         packet reading.
  1562.         Kermit-11>SET RSX TC.DLU n      Alters  the TC.DLU setting.
  1563.         Kermit-11>SET RSX CONNECT ALT   Uses a new  (v2.33) connect
  1564.                                         driver which bypasses TTDRV
  1565.                                         flow control.
  1566.         Kermit-11>SET RSX CONNECT DEF   Use old connect code (2.32)
  1567.  
  1568. The SET RSX command is subject to change and the above options may  be
  1569. removed in the future.  Note the the SET RSX CHARIO may be needed when
  1570. transfering files with parity enabled.  This command alters the method
  1571. by  which  a packet is read; instead of waiting for a carriage return,
  1572. Kermit reads the typeahead byte count and then issues a read for  that
  1573. many  characters.  This is the same method Kermit-11 ALWAYS uses under
  1574. P/OS.
  1575.  
  1576. SET RT-11
  1577.  
  1578. SET RT-11 CREATE-SIZE
  1579.  
  1580. The SET RT-11 CREATE value command was added  to  assist  those  RT-11
  1581. users with very small disks to be able to get files with sizes greater
  1582. that half of the available contiguous space available.  While this  is
  1583. NOT  a problem going from one Kermit-11 to another Kermit-11 since the
  1584. PDP-11 Kermit supports a subset of the protocol known as 'ATTRIBUTES',
  1585. other  Kermits  may  not  support  the exchange of file sizes (most do
  1586. not).  Thus if your largest contiguous space is  300  blocks  and  you
  1587. want to get a 250 block file, the command:
  1588.  
  1589.         Kermit-11>SET RT-11 CRE 250
  1590.  
  1591. would be needed, as RT-11 by default only allocates 50 percent of  the
  1592. available space.
  1593.  
  1594. SET RT-11 FLOW-CONTROL
  1595.  
  1596. Note that for the connect command under RT-11  you  will  most  likely
  1597. need  xon/off  flow  control  to  be  generated by Kermit-11.  This is
  1598. enabled with the SET RT-11 FLOW command.  This is  by  default  NOFLOW
  1599. since  the modem the author uses, a Vadic 212PA, can't handle XONs and
  1600. XOFFs while in command mode.  The solution here is to escape  back  to
  1601. Kermit  command mode after the remote system has been logged into, and
  1602.  
  1603. PDP-11 KERMIT                                                Page 1-30
  1604. The SET COMMAND
  1605.  
  1606.  
  1607. then type SET RT-11 FLOW.
  1608. The effect of SET RT-11 FLOW is for Kermit-11, when in  connect  mode,
  1609. to  send an XOFF to the host every eight characters.  When the loop in
  1610. the connect module finds no more data in the input buffer, it sends up
  1611. to  2  XON  characters  (in  case  the first XON got lost) to tell the
  1612. remote system to start sending again.  The reason for doing so is that
  1613. the  RT-11 multiple terminal service is very slow about handling input
  1614. interrupts and does not do any of it's  own  flow  control  when  it's
  1615. internal  ring  buffer gets full.  This has been tested at line speeds
  1616. up to 4800 baud without losing  data.   This  setting  should  not  be
  1617. needed for use with the XC/XL handlers.
  1618. SET RT-11 FLOW has NO effect on packet transmission, since the  Kermit
  1619. packet  size  is  never  mode  than 96 characters, and the RT-11 input
  1620. buffer is 134 characters in size.
  1621.  
  1622.                 Kermit-11>SET RT-11 FLOW
  1623.                 Kermit-11>SET RT-11 NOFLOW
  1624.  
  1625. The  SET  RT-11  [NO]FLOW  command  replaces  the  older  SET   RTFLOW
  1626. [ON][OFF].
  1627.  
  1628. SET RT-11 VOLUME-VERIFY
  1629.  
  1630. Normally RT-11 Kermit-11 will check the directory header of a disk  to
  1631. verify  that  it  most  likely  contains  a valid RT-11 file structure
  1632. before trying to read the directory.  If for  some  reason  your  disk
  1633. does  not  contain  the  standard  data  at  offset 760 in the header,
  1634. Kermit-11 will reject the disk.  The  SET  RT-11  NOVOL  command  will
  1635. instruct Kermit-11 to bypass that check.
  1636.  
  1637.                 Kermit-11>SET RT-11 VOL
  1638.                 Kermit-11>SET RT-11 NOVOL
  1639.  
  1640.  
  1641. SET SEND
  1642.  
  1643. The SET SEND  command  controls  what  Kermit-11  will  be  doing  for
  1644. outgoing  packets  in that you may want to alter the packet terminator
  1645. and/or the start of packet character (by default, 15 octal and 1 octal
  1646. respectively.  See HELP SET RECEIVE for more information.
  1647.  
  1648. The only extra option for SET  SEND  is  SET  SEND  [NO]XON.   If  the
  1649. command  SET SEND XON is give, then every packet sent will be prefixed
  1650. with an XON character.  This could be useful in situations where  flow
  1651. control  is  erratic.   The actual intent of this option was to try to
  1652. circumvent a firmware bug in the DHV11 when used under RSTS/E.
  1653.  
  1654. SET SPEED
  1655.  
  1656. SET SPEED value sets the line speed for the device specified  via  the
  1657. SET  LINE  command,  and  used  for the CONNECT command.  Changing the
  1658. speed of a terminal line requires privilege for RSTS  and  RSX-11M/M+.
  1659. The  SET  SPEED command will only function with a DH11, DHV11, DZ11 or
  1660. DZV11 multiline interface.
  1661.  
  1662. PDP-11 KERMIT                                                Page 1-31
  1663. The SET COMMAND
  1664.  
  1665.  
  1666.  
  1667.                 Kermit-11>SET SPEED 1200
  1668.  
  1669. 1200 Baud would be a normal speed to use with a VA212PA or a DF03.
  1670.  
  1671. Please note that Kermit-11 CAN NOT change the speed  of  a  DL11  type
  1672. interface, nor can it change the speed of a PDT-150 modem port.  For a
  1673. PDT-150 modem port, use a command of /M/S:nnnn.  to change  the  speed
  1674. to nnnn for the SPEED.SAV program.
  1675.  
  1676. SET TIMEOUT
  1677.  
  1678. The timeout value tells Kermit how long to wait to get a  packet  from
  1679. the  other  Kermit.   If system loads are high, it may be desirable to
  1680. increase this beyond the default of 10 seconds.
  1681.  
  1682. SET TERMINAL
  1683.  
  1684. The SET TERMINAL command  simply  controls  the  way  which  Kermit-11
  1685. prints  packet  counts  while  send  or  receiving a file (or group of
  1686. files).  The simplest way is the default, SET TER TTY.  Using SET  TER
  1687. VT100 will cause Kermit to display headers for the numbers printed, at
  1688. a possible cost in packet speed due to screen  control  overhead.   On
  1689. the  PRO/350,  VT100  is  assumed.   On  RSTS/E  v9.0  and  later, the
  1690. executive is queried for the terminal type.
  1691.  
  1692.                 Kermit-11>SET TER TTY
  1693.                 Kermit-11>SET TER VT100
  1694.  
  1695.  
  1696. SET UPDATE
  1697.  
  1698. The SET UPDATE command controls the  frequency  at  which  the  packet
  1699. count  display  is updated.  The default is 1, displaying each packet.
  1700. A SET UPD 0 will disable all packet count logs, whereas a  SET  UPD  N
  1701. will  update the display every N packets.  The SET NOUPDATE command is
  1702. the same as SET UPDATE 0.
  1703.  
  1704.  
  1705. The DIAL command
  1706.  
  1707.  
  1708. The DIAL command is new for  version  3.29  of  Kermit-11.   The  DIAL
  1709. command  is  used  to dial a number on an attached modem of known type
  1710. (see SET MODEM).  To find out the current known modems,  use  the  SET
  1711. MODEM  ?   command.   The  following example shows a RACAL-VADIC VA212
  1712. modem connect to the XK:  port on a PRO/350 running P/OS version 2.
  1713.  
  1714.                 Kermit-11>set pro PRO>
  1715.                 PRO>set modem va212pa
  1716.                 PRO>dial 5374401
  1717.                 Modem in command modem
  1718.                 Modem dialing
  1719.                 Connection failed, !BUSY
  1720.  
  1721. PDP-11 KERMIT                                                Page 1-32
  1722. The DIAL command
  1723.  
  1724.  
  1725.                 PRO>dial 5374411
  1726.                 Modem in command modem
  1727.                 Modem dialing
  1728.                 Connection made, type CONNECT to access remote
  1729.                 PRO>con
  1730.                 Enter class ? VX785A
  1731.                 Class start
  1732.                 Username: BRIAN
  1733.                 Password: ......................
  1734.  
  1735. See SET MODEM for more information.
  1736.  
  1737. PDP-11 KERMIT                                                Page 1-33
  1738. Notes regarding options for the System Manager
  1739.  
  1740.  
  1741.                             Odds and ends
  1742.  
  1743. There are a few odds and ends that should be made aware to the  system
  1744. manager  of  any  PDP-11  system  regarding  Kermit-11.   They  are as
  1745. follows, grouped by operating system.  Please note  that  installation
  1746. instructions  are in K11INS.DOC and that additional information may be
  1747. in Kermit-11's online help command.
  1748.  
  1749.  
  1750. RESTRICTIONS
  1751.  
  1752. Prior to version 2.21, Kermit-11 did not support 8-bit prefixing.
  1753. Prior to version 2.23, Kermit-11  did  not  support  repeat  character
  1754. encoding.
  1755.  The PRO/RT-11 version of Kermit-11 will request 8-bit  prefixing  due
  1756. to  the fact that the XC handler does not support 8BIT data.  For most
  1757. Kermits this should not be a problem.  The XC  handler  always  strips
  1758. bit  7  from  the  character  being  sent, so the PRO/RT-11 version of
  1759. Kermit will request prefixing of  such.   It  does  so  internally  by
  1760. setting PARITY to SPACE (always clear the high bit, bit seven).
  1761.  Note that this implies that a SET PARITY  SPACE  command  will  force
  1762. Kermit-11  to  request  '8bit'  prefixing  in order to transfer binary
  1763. files across a seven bit link.
  1764.  
  1765. P/OS
  1766.  
  1767. Kermit-11 will run on under P/OS on the Pro/350, the  executable  file
  1768. is  called K11POS.TSK.  It does NOT run from a menu, the normal way to
  1769. run it is via the RUN command in DCL.  It will support  the  Kermit-11
  1770. attribute  packets,  thus  a  PRO/350  connected  to a PDP-11 host can
  1771. transparently handle binary  and  other  types  of  files.   The  P/OS
  1772. Kermit-11  can  be  run  either  as a local Kermit or a Kermit server.
  1773. This has been  tested  under  P/OS  version  2  connected  to  both  a
  1774. PDP-11/23+ and PDP-11/70 RSTS/E host.
  1775.  
  1776. When Kermit-11 is started on the PRO, it will automatically do  a  SET
  1777. LINE XK0:  and a SET SPEED 9600.  You can, of course, change the speed
  1778. to whatever you need with the SET SPEED command.  The line  should  be
  1779. left as XK0:.
  1780.  
  1781. The top row function keys are mapped internally.   Kermit-11  maps  F5
  1782. (break)  into  a  true  break  (a  space of 275 ms), F6 (interrupt) to
  1783. control C, F10 to control Z, F11 to  escape  (octal  33)  and  F12  to
  1784. backspace   (octal   10).   The  incoming  escape  sequence  DECID  is
  1785. intercepted to allow Kermit-11 to  send  back  a  device  response  of
  1786. VT100.
  1787.  
  1788. RSTS
  1789.  
  1790.  Kermit-11 runs on version 7.2 or later of  RSTS/E.   Due  to  options
  1791. present in version 8, binary file transfers will not be possible under
  1792. version 7.2 of RSTS/E.  This is due to the use of 8 bit mode  for  the
  1793. terminal  link  to  allow  all characters to be passed.  The so called
  1794. '8BIT' terminal setting was new as of version 8.0-06 of RSTS/E.
  1795.  
  1796. PDP-11 KERMIT                                                Page 1-34
  1797. Notes regarding options for the System Manager
  1798.  
  1799.  
  1800.  Any RSTS/E system running Kermit-11 will need the sysgen  option  for
  1801. multiple private delimiters in the terminal driver.  This special mode
  1802. is needed since  the  'normal'  RSTS/E  binary  terminal  mode  has  a
  1803. 'feature' that disables binary mode whenever the terminal times out on
  1804. a read.  Since timeouts are essential to Kermit error recovery, binary
  1805. mode can not be used for i/o.
  1806.  
  1807.  Certain functions  of  Kermit-11  require  that  the  system  manager
  1808. install  Kermit  with  temporary  privileges,  these  commands are the
  1809. SYSTEM, WHO and REMOTE HOST commands.  Kermit-11 does NOT  need  these
  1810. to operate correctly.
  1811.  
  1812.  Kermit-11 can only be built (from source, not from HEX  files)  under
  1813. RSTS/E  version  8.0  or  later  due  to the use of RMS11 v2.0 and new
  1814. assembler directives.
  1815.  
  1816.  Support for the server remote login is only  available  under  RSTS/E
  1817. 9.0  or  later.   Also, a REMOTE LOGIN command to a RSTS/E server will
  1818. fail unless the user has the WACNT privilege.  While the LOGIN program
  1819. will skip the password lookup if WACNT is present, Kermit will require
  1820. a password.
  1821.  
  1822. RSX-11M/M+
  1823.  
  1824.  Kermit-11 can not be installed non-checkpointable due to an  apparent
  1825. RMS11 bug.  In other words, don't try to install the task '/CKP=NO'.
  1826.  
  1827.  To use the connect command effectively, typeahead support  is  needed
  1828. in  the  terminal driver.  For RSX-11M+, set the typeahead buffer size
  1829. high, as in SET /TYPEAHEAD=TT22:200.  Also, if your  connect  line  is
  1830. TT22:  (as above), use the mcr command SET/SLAVE=TT22:
  1831.  
  1832.  Kermit-11 can only be built under RSX-11M version 4.1  or  later,  or
  1833. under  RSX-11M  Plus version 2.1 or later due to the use of RMS11 v2.0
  1834. and new assembler directives.
  1835.  
  1836.  There is a SET RSX command, see HELP SET RSX for further information.
  1837.  
  1838.  As a side issue, please note that the file K11POS.TSK is quite usable
  1839. under RSX, the difference being that K11RSX.TSK has DECNET support and
  1840. RMS-11 overlayed in the task image (besides which,  due  to  the  lack
  1841. author's  systems  running  RSX may not be up to date) linked into it,
  1842. whereas K11POS has NO Decnet  support  but  IS  linked  to  the  RMS11
  1843. library  RMSRES  (v2),  thus  K11POS  saves  disk  space  as  well  as
  1844. supporting named directories, ala VMS style.
  1845.  
  1846. RT-11
  1847.  
  1848.  Kermit-11, as of version 2.20, has been tested  under  RT-11  version
  1849. 5.0  under  the FB and XM monitors using a DZ11 line for the link, and
  1850. also on a  PDT-150  using  the  modem  port  for  the  link.   It  has
  1851. additionally  been  run  under Micro-11's and the PRO/350 using the XL
  1852. and XC handlers respectively.
  1853.  
  1854. PDP-11 KERMIT                                                Page 1-35
  1855. Notes regarding options for the System Manager
  1856.  
  1857.  
  1858.  Kermit-11 requires  .TWAIT  support  as  well  as  multiple  terminal
  1859. support  (unless  the  XL/XC  handler  is  used).  The use of multiple
  1860. terminal support  allows  Kermit-11  to  use  any  type  of  interface
  1861. sysgened,  including the DZ11 and DZV11.  It is possible under version
  1862. 5 of RT-11 to use the XL:  handler instead of  the  multiple  terminal
  1863. support.   The  use of the XL:  driver will result in much faster file
  1864. transfer at high baud rates.  Note that XL:  must be set up at  system
  1865. startup or at some time later to set the proper speed, CSR and vector.
  1866.  
  1867. For those users who do not have multiple terminal support and  do  not
  1868. have  the  XL handler, Kermit-11 will force the use of the console for
  1869. data transfers.  This will require that Kermit-11  request  eight  bit
  1870. prefixing  from  any  other  Kermit wishing to send binary data files.
  1871. Additionally, you can force console mode by doing a SET LINE TT:
  1872.  
  1873. Please note that the device name syntax for terminal lines follows the
  1874. MT unit numbers, thus if a SHO TER gave unit 5 for DZ11 line 0 the the
  1875. device name would be:
  1876.  
  1877.         Kermit-11>SET LINE 5
  1878.  
  1879. If you use the XL handler, you would do this:
  1880.  
  1881.         Kermit-11>SET LINE XL:
  1882.  
  1883. To force the console to be used, you would:
  1884.  
  1885.         Kermit-11>SET LINE TT:
  1886.  
  1887. Additionally, Kermit-11 for RT-11 looks for its help file, K11HLP.HLP,
  1888. on DK:  first and then on SY:  if the first one fails.
  1889.  
  1890.  Full wildcarding is supported for RT-11, in the form *.type,  name.*,
  1891. *.* and the % character to match any single character.
  1892.  
  1893.  Kermit-11 can only be built on RT-11 version 5.0 or later due to  the
  1894. use of new assembler directives.
  1895.  
  1896.  Please note that for the connect command under RT-11 and the  use  of
  1897. the  MT  service, you will most likely need xon/off flow control to be
  1898. generated by Kermit-11.  This  is  enabled  with  the  SET  RTFLOW  ON
  1899. command.   This  is  by default OFF since the modem the author uses, a
  1900. Vadic 212P, can't handle XONs and XOFFs while in  command  mode.   The
  1901. solution  here  is  to  escape  back  to Kermit command mode after the
  1902. remote system has been logged into, and then type SET RTFLOW ON.
  1903.  
  1904.  Due to overlaying constraints, the RT-11 Kermit-11  will  not  accept
  1905. wildcards  for  the  RENAME  and DELETE commands and the REMOTE server
  1906. equivalents.
  1907.  
  1908.  The executable files are K11XM.SAV for the XM system and PRO/350, and
  1909. K11RT4 for the FB system.
  1910.  
  1911.  As a final (I hope) RT-11 note, see the RT-11 v5.1 Release Notes page
  1912.  
  1913. PDP-11 KERMIT                                                Page 1-36
  1914. Notes regarding options for the System Manager
  1915.  
  1916.  
  1917. 9-2  and  chapter 12.  The discussion relevant here regards the use of
  1918. the XL/XC handlers.
  1919.  Note that the default XL:  handler vector (DL-11, DLV-11) is 300  and
  1920. the  CSR  is  176500.   For  the Micro-11, PDP-11 and LSI-11, when the
  1921. DL11/DLV11 interface is installed  the  field  service  representative
  1922. will  inform  you what the CSR and VECTOR are.  If they are NOT 176500
  1923. and 300, then to use the XL:  handler you will need, prior to  running
  1924. Kermit-11,  to  set them.  Suppose the DL vector is 400 and the CSR is
  1925. 176510.  Then the following DCL commands would set the  addresses  for
  1926. RT-11.
  1927.  
  1928.         .SET XL CSR=176510
  1929.         .SET XL VECTOR=400
  1930.  
  1931.  You SHOULD NOT ever alter these settings for  XC:   on  the  PRO/3xx.
  1932. The  ONLY  settings  you can alter for the PRO/3xx is the speed, as in
  1933. DCL command SET XC SPEED=nnnn.  Kermit-11 CAN NOT alter the XC:  speed
  1934. itself.   As noted previously in this document, Kermit-11 executes the
  1935. Kermit-11 command SET LIN XC:  implicitly if it finds  itself  running
  1936. on a PRO/3xx system.
  1937.  
  1938.  Note that if your modem requires DTR to  be  present,  you  must  use
  1939. either  an  interface  that  asserts  it  (as  does  the  PDT  and PRO
  1940. communications port), force it high internally to the modem, or  build
  1941. a cable to force it high.  See HELP MODEM for more information.
  1942.  
  1943. TSX+
  1944.  
  1945. While most of the above notes for RT-11 apply for TSX+,  there  are  a
  1946. few  differences  of  note.   The first, in that TSX+ is a timesharing
  1947. system, allows the Kermit user to log in normally from another  system
  1948. running  Kermit  (as in a Rainbow) and give the TSX+ Kermit the SERVER
  1949. command and commence file transfer operations from  the  other  system
  1950. (ie, the Rainbow).  If you are dialing INTO a TSX+ system, you need to
  1951. give the TSX command:
  1952.  
  1953.         .SET TT 8BIT
  1954.  
  1955. to be able to transfer data  to  your  local  (PC,  other  PDP-11,...)
  1956. system  without incurring the overhead of the Kermit protocol known as
  1957. eight bit prefixing.  If this is  not  possible,  due  to  your  local
  1958. system requiring parity, or some other intervening device adds parity,
  1959. then you should give Kermit the command:
  1960.  
  1961.         Kermit-11>SET PARITY SPACE
  1962.  
  1963. to let Kermit know that it can't send binary data as-is.
  1964.  
  1965. To use Kermit-11 to dial out  from  the  TSX+  system,  the  following
  1966. commands are needed.  Note that TSX+ commands will be preceeded by the
  1967. normal RT-11 prompt, the ever present  DOT  ('.'),  whereas  Kermit-11
  1968. commands   will   be   prefixed   by  the  default  Kermit-11  prompt,
  1969. 'Kermit-11>'.
  1970.  
  1971.  
  1972. PDP-11 KERMIT                                                Page 1-37
  1973. Notes regarding options for the System Manager
  1974.  
  1975.  
  1976.         .SET CL LINE=n          Where 'n' is the unit number
  1977.         .SET CL NOLFOUT
  1978.         .SET CL SPEED=n         Where 'n' is the speed for that unit
  1979.         .ASS CL XL              
  1980.         Kermit-11>SET LIN XL:
  1981.         Kermit-11>CONNECT
  1982.  
  1983. As of Kermit-11 version 3.44, you may use CL directly in the SET  LINE
  1984. command, as in:
  1985.  
  1986.         .SET CL3 LINE=3
  1987.         .R K11XM
  1988.         Kermit-11>SET LIN CL3
  1989.         Kermit-11>SET SPEED 1200
  1990.         Kermit-11>CONNECT
  1991.  
  1992. A sample command file in actual use is:
  1993.  
  1994.         SET CL3 LINE=3
  1995.         SET CL3 NOLFOUT
  1996.         SET CL3 TAB
  1997.         SET CL3 FORM
  1998.         SET CL3 SPEED=2400
  1999.         ALLOCATE CL3:
  2000.         R K11XM
  2001.         DEALLOC CL3
  2002.         SET CL3 LFOUT
  2003.         SET CL3 LINE=0
  2004.         SH CL
  2005.  
  2006. If you are running PRO/TSX+, then Kermit will make the  assignment  of
  2007. LINE  3  to  either  CL0  or  CL1  if  you are running Kermit from the
  2008. console, ie, LINE 1.  The speed will default to the last SET SPEED  or
  2009. the speed set at system boot.
  2010.  
  2011. Lastly, TSX+ needs PLAS support to use K11XM.SAV, see the installation
  2012. notes for further data.
  2013.  
  2014.  
  2015. Notes regarding modems
  2016.  
  2017.  
  2018. RSTS/E version 9.x
  2019.  
  2020. RSTS/E does not control modems signals in the manner that RSX  or  VMS
  2021. does.  VMS always asserts DTR whereas RSTS/E will not assert DTR until
  2022. the terminal driver can see RCD (also known as DCD)  which  is  pin  8
  2023. (eight)  for  the  RS232  connection.   To connect directly to a modem
  2024. (like a VADIC 212, sorry, no DEC modems here) we must do  one  of  two
  2025. things:
  2026.  
  2027. (1) Force the modem (via strapping options or whatever) to assert  RCD
  2028. (DCD)  pin  8,  thus RSTS/E will see carrier and raise DTR (pin 20 for
  2029. RS232)
  2030.  
  2031. PDP-11 KERMIT                                                Page 1-38
  2032. MODEMS
  2033.  
  2034.  
  2035. (2)  Set  the  terminal  to  LOCAL  (RSTS/E   V9   syntax   'SET   TER
  2036. TTxx:/NODIAL/PERM')  and break pin 20 (DTR) and connect pin 20 to 8 on
  2037. the modem side.  This will cause the modem to be able to dial out  and
  2038. allow  RSTS/E  to connect to it.  You will also need to have the modem
  2039. assert RCD, pin 8.  Keep in mind that the Kermit-11 command DISCONNECT
  2040. (or  HANGUP)  will  not  function if a line is set to NODIAL (INIT SET
  2041. syntax 'LOCAL').  This has been tested on a Racal Vadic VA212.
  2042.  
  2043. (3) Break pin 8 (RCD) and loop DTR (pin 20) on the  CPU  side  to  RCD
  2044. (pin 8) on the CPU side.  Then use the command SET DTR in Kermit-11 to
  2045. get RSTS to raise DTR and thus loop it's DTR signal back to RCD.   See
  2046. the next note regarding this.
  2047.  
  2048.  
  2049. For those of you who have port switches  such  as  the  Gandalf  type,
  2050. there is one additional problem.
  2051. For Gandalf, suppose you want to connect a DZ11 line to to  an  AMTB2.
  2052. You  will  have  a problem, in that the Gandalf AMTB2 wants to see RCD
  2053. (DCD) asserted to make a connection.  What you may need to do is this:
  2054.  
  2055.         Make a cable for the DZ11 to AMTB2 port as follows:
  2056.  
  2057.         CPU side                        AMTB2 side
  2058.                         20--|
  2059.                         8---|-----------8
  2060.                         7---------------7
  2061.                         3---------------2
  2062.                         2---------------3
  2063.  
  2064.         Note that 20 is tied to 8 on the CPU side.
  2065.         Also, 2 is swapped for 3.
  2066.  
  2067. Then, the Kermit-11 command SET DTR, which forces RSTS  to  raise  DTR
  2068. for  30  seconds,  will  cause  the DTR signal to loop back to the RCD
  2069. (DCD) signal and thus tell RSTS that there  is  carrier  detect  which
  2070. will  raise  DTR (the chicken or egg question) and get things rolling.
  2071. The Kermit-11 HANGUP (or DISCONNECT) command will drop DTR  and  force
  2072. the modem to break the connection.
  2073.  
  2074.  
  2075. RSX and Modems
  2076.  
  2077. While the authors experience on RSX is limited,  the  following  notes
  2078. may be of use.
  2079. Dialing out on a LOCAL line will often require that the  modem  assert
  2080. internally DTR.
  2081. If a line is set REMOTE on RSX, the driver will assert  DTR  and  RTS.
  2082. For  a  modem,  like a VA212PAR strapped at the factory defaults, this
  2083. will cause the  modem  to  assert  DSR  and  RCD.   On  the  VADIC  in
  2084. particular,  the  modem will drop RCD during a DIAL command unless the
  2085. modem is configured to assert  RCD  continuously.   For  dialing  out,
  2086. ideally  the  modem  should  be  able  to  assert RCD via an option or
  2087. internally settable strap or switch.  If  this  is  not  possible,  an
  2088. alternative is to break line 8 (RCD) and jumper DTR (20) to RCD (8) on
  2089.  
  2090. PDP-11 KERMIT                                                Page 1-39
  2091. MODEMS
  2092.  
  2093.  
  2094. the CPU side.  This will force RSX to always see  carrier  detect  and
  2095. allow  a  dial sequence to complete.  The Kermit-11 command DISCONNECT
  2096. (or HANGUP) will still disconnect the modem as  the  modem  will  drop
  2097. from  the  line  when  it  sees  DTR go low (assuming the modem is not
  2098. strapped to assert DTR internally).
  2099.  
  2100.  
  2101. PDP-11 KERMIT                                                Page 1-40
  2102. Typical Kermit-11 transfer rates
  2103.  
  2104.  
  2105. Some sample timings for Kermit-11 and long packet support.  The packet
  2106. size  in  the  RSTS/E  to  P/OS was 500 bytes, the size from RSTS/E to
  2107. RSTS/E was 700 bytes.  These sizes are somewhat arbitrary, they depend
  2108. more on the system's buffering capabilities than anything else.
  2109.  
  2110. Host buffering capabilities:
  2111.  
  2112. P/OS                    500 (estimated)
  2113. RSTS/E 9.0 or later     up to 7000, given sufficient system pool
  2114. RSX-11M+                        255 (I/D space CPU only)
  2115. RSX-11M                 34
  2116. RT-11                   134 (could be larger with mod to XC/XL)
  2117.  
  2118. As it can be seen, large packets make sense only for RSTS/E, P/OS  and
  2119. RSX-11M+  if one wishes to avoid XON/XOFF overhead at high speeds.  It
  2120. should be possible to run larger packets on  M+  and  RT-11  at  lower
  2121. speeds.
  2122.  
  2123. File transferred:  K11POS.TSK, size 102,400 bytes  (200  disk  blocks)
  2124. Actual data packet characters AFTER prefixing was 120,857
  2125.  
  2126. Time    Speed   Data rate       Comments
  2127. seconds baud
  2128.  
  2129.  
  2130. 1436    1200    84/sec          11/44 to PRO/350, 'Classic' Kermit
  2131.                                 local phone call
  2132. 1237    1200    97/sec          11/44 to PRO/350, 500 Char packets
  2133.                                 local phone call
  2134.  
  2135. 2915    1200    41/sen          11/44 to PRO/350, 'Classic' Kermit
  2136.                                 local call, 1 second ACK delay.
  2137. 1492    1200    81/sec          11/44 to PRO/350, 500 Char packets
  2138.                                 local call, 1 second ACK delay.
  2139.  
  2140. 304     9600    397/sec         11/44 to 11/44, 'Classic' Kermit,
  2141.                                 connected locally via Gandalf switch.
  2142. 245     9600    493/sec         11/44 to 11/44, 700 char packets,
  2143.                                 connected locally via Gandalf switch.
  2144.  
  2145. The last two timings are much lower than the line  speed  due  to  the
  2146. fact  the  the  PDP  11/44 is running 100% busy trying to keep up with
  2147. character interrupts  using  a  normal  terminal  driver.   A  special
  2148. purpose  driver, such as the XK driver found on P/OS, would have lower
  2149. overhead and allow somewhat faster data rates.
  2150.  
  2151. Long packets were chosen for Kermit-11 due to  the  lack  of  suitable
  2152. interrupt  driven  i/o  (at  this  time)  under  one  of the operating
  2153. systems, RSTS/E.  The Sliding Windows would likely function better  in
  2154. those  situations  where the circuit delay is much higher, or when the
  2155. circuit can not accommodate large packet sizes.
  2156.  
  2157. PDP-11 KERMIT                                                Page 1-41
  2158. Common problems
  2159.  
  2160.  
  2161.                    Common problems in file transfer
  2162.  
  2163.  
  2164. Connection fails.
  2165.  
  2166. Check modem control signals.  RSX needs TC.DLU set to two to talk to a
  2167. dial  out modem, otherwise you will need to strap or jumper signals in
  2168. the modem to have carrier detect set high.  RSTS/E  also  should  have
  2169. the modem assert carrier detect.  If not, see the previous notes about
  2170. modems.  If all else fails, put a breakout box in the line and observe
  2171. what signals are present.
  2172.  
  2173. File transfer fails.
  2174.  
  2175. If the file transfer aborts on retries immediately,  there  may  be  a
  2176. parity  problem.   If  the problem shows up on binary files, try a SET
  2177. PAR SPACE command to Kermit; that will force  eight  bit  data  to  be
  2178. prefixed into seven bits.  If you instead get a retry about once every
  2179. 10 seconds, the other Kermit is not  responding  and  your  Kermit  is
  2180. timing out.  Check to see if your connection is still present, and try
  2181. the SET PARITY command.
  2182. If you are sending binary data between unlike Kermits, you  will  most
  2183. likely have to give the proper command to each to prepare them for the
  2184. binary data; this is the SET FILE command; for Kermit-11 it's SET  FIL
  2185. BIN (or SET FIL TYP FIX); for VMS Kermit it's SET FIL TYP FIX.
  2186. If your Kermit's packets are being echoed back, try a SET  SEND  START
  2187. value  command  for your Kermit, and a SET REC START samevalue for the
  2188. other Kermit.  This will force Kermit to ignore any echoed packets  as
  2189. they  won't  have  the default start of packet character (a CONTROL A,
  2190. octal 1).
  2191.  
  2192.  
  2193. PDP-11 KERMIT                                             Page Index-1
  2194. Index
  2195.  
  2196.  
  2197.                                 INDEX
  2198.  
  2199.  
  2200.  
  2201. Bye, 1-11                           Modems and rsx, 1-38
  2202.  
  2203. Commands for file transfer, 1-9     Notes regarding options for the
  2204. Commands for local file                 system manager, 1-33
  2205.     management, 1-13
  2206. Commands for servers, 1-11          Program operation, 1-6
  2207. Common problems, 1-40
  2208. Connect command, 1-13               Remote, 1-12
  2209.  
  2210. File formats (binary and text),     Saving files on the pdp-11 from
  2211.     1-4                                 your microcomputer, 1-5
  2212. File specifications., 1-3           Server operation, 1-11
  2213. File systems on the pdp-11, 1-3     Set command, 1-15
  2214. Finish, 1-11
  2215.  
  2216. Kermit-11 commands, 1-8             The dial command, 1-31
  2217.                                     The get command, 1-10
  2218. Local and remote operation, 1-7     The receive command, 1-10
  2219.                                     The send command, 1-9
  2220. Modems, 1-37                        Typical kermit-11 transfer rates,
  2221. Modems and rsts/e, 1-37                 1-40
  2222.