home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / pdp11 / k11usr.rno < prev    next >
Text File  |  2020-01-01  |  81KB  |  2,191 lines

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