home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / pdp11 / k11ins.rno < prev    next >
Text File  |  2020-01-01  |  35KB  |  989 lines
  1. .rm 72
  2. .index System requirements
  3. .c;Installation and release notes for Kermit-11
  4. .s 2
  5. 05-FEB-1987 09:42 Brian Nelson
  6. .s 1
  7. This is release 2.56 of Kermit-11. Major changes from previous
  8. versions include LONG PACKET support, new CONNECT code for RSX-11M/M+
  9. and P/OS, BREAK and DTR control for RT-11 V5.2, a DIAL command,
  10. and many other small
  11. changes. All changes are documented in the source file K11CMD.MAC.
  12. .s 1
  13. Kermit-11 runs on the following operating systems.
  14. .lit
  15.  
  16. Exec    Minimum     Notes
  17.     version
  18.  
  19. RSTS/E    v8.0    Multiple private delimiter SYSGEN support, RMS11 v2
  20. RSX-11M    v4.1    Full duplex terminal driver, RMS11 v2
  21. RSX-11M+    v2.1     Full duplex terminal driver, RMS11 v2
  22. RT-11    v4.0    Requires multiple terminal SYSGEN support
  23. RT-11    v5.1    Can use the XL and XC handlers or MT service
  24. TSX+    v5    Must use CL handler for outgoing connections
  25. PRO/RT    v5.1    Uses the XC handler
  26. P/OS    v2.0    Uses either XK or XT (XT for TMS support)
  27. IAS    v3.1    Built with RMS v1, will function on 3.2 patch A and B
  28.  
  29. .eli
  30. If your system version is older than that listed you are free to see if
  31. Kermit will run; if it does not, UPGRADE. Kermit is fairly generous, it
  32. runs on both the current executive versions plus
  33. generally contains support for
  34. the last major release. In other words, if you are running RSTS v7 or
  35. RSX-11M 3.2, you will not be supported for Kermit, just as your system
  36. can not be supported by Digital. For example, RSTS/E 8.0 support expired
  37. on 31-Dec-85, as version 9.0 was released in June 1985. Since version 8
  38. was the last major version, Kermit-11 will ATTEMPT to support it for a
  39. while; verification of 8.0 functionality is difficult as the author is
  40. a field test site and has not used 8.0 since SEP 1984, and is currently
  41. running RSTS/E 9.2.
  42. .s 1
  43. The creation of Kermit-11 from source is possible only on the current
  44. versions of the above mentioned systems; this is due to the use of
  45. new macro calls and directives that may not be present on older versions.
  46. For example, Kermit-11 can be built under RSTS/E for all the other executives
  47. as long as the RSTS/E version is 9.1 or later, and one has the appropriate
  48. system specific libraries (such as SYSLIB, RMSLIB and RMSDAP from RSX-11M+).
  49. Before attempting to build from source, see the section later in this
  50. document for specific notes relating to your system. You should not need
  51. to build Kermit from source; your distribution will have either the relevant
  52. executable image or 'hex' files that can be converted into something that
  53. will run.
  54. .s 1
  55. .test page 10
  56.  
  57. As of this writing (04-Feb-86), the current versions are:
  58. .s 1
  59. .lit
  60.     RSTS/E     9.1, 9.2, 9.3     RSX-11M    4.2
  61.     RSX-11M+ 3.0        RT-11    5.2
  62.     TSX+     6.02        P/OS    2.0, 3.0 
  63.     IAS     3.2, Patch B
  64. .eli
  65. .s 1
  66. .subtitle Warnings
  67. .test page 10
  68. .index Warnings
  69. .s 2
  70. .c;Restrictions to be aware of
  71. .s 2
  72. A problem was found with versions of Kermit-11 prior to 3.49 regarding
  73. the sending and processing of attribute packets. Basically, two of the
  74. attribute types were improperly implemented. The support for attribute
  75. packets was added back in April 1984, at a time when testing against other
  76. implementations was not possible. At this writing, in March 1986, some
  77. problems have been found.
  78. .s 1
  79. The corrected version of Kermit-11 is V3.49; this version will NOT be
  80. able to exchange attribute packets with previous versions. In order to
  81. make an intitial download of Kermit-11 V3.49 to a host running an older
  82. version, you must explicitly disable attribute support, as in:
  83. .lit
  84.  
  85.     Kermit-11>SET NOATT
  86.  
  87. .eli
  88. and then force both ends to binary mode, as in:
  89. .lit
  90.  
  91.     Kermit-11>SET FILE BINARY
  92. or:    Kermit-11>SET FILE TYPE FIXED
  93.  
  94. .eli
  95. The best way to accomplish the updating of remote sites is to use
  96. a pre 3.49 version of Kermit-11 at both ends, transfer the image
  97. appropiate to your system, and then replace the old executable image
  98. on the remote side and your own side.
  99. .s 3
  100. .subtitle A roadmap of files
  101. .page
  102. .lit
  103.  
  104. Kermit-11 files, 19-Feb-87  16:14:03 BDN
  105.  
  106. Notes:
  107.  
  108. 1.  All command files (filetype .COM)  run under RSTS version 9. There
  109.    are no build files for  native execs,  as I build all Kermits under
  110.    RSTS and then download to the target system.
  111.  
  112. 2.  All .HEX  files are simply  hexified versions of the corresponding
  113.    executable image.
  114.  
  115. 3.  The Columbia tapes will have only the HEX files, and then only for
  116.    the non I/D space tasks. The DECUS tapes will have the HEX and TASK
  117.    images,  except in the case of the I/D images, only the task images
  118.    will be present.
  119.  
  120.  
  121. K11   .BWR    Notes regarding possible bugs
  122. K11   .COM    Task build DCL command file for RSTS+RMSRES Kermit
  123. K11   .ODL    Overlay for K11.TSK
  124. K11   .TSK    RSTS/E Kermit, v8.0 or later, linked to RMSRES
  125. K1180S.MAC    Subroutines specific to RSTS/E
  126. K11AAA.AAA    General AAAREADME.TXT
  127. K11ART.RNO    Old newsletter article
  128. K11ASM.COM    Generates DCL command files to assemble under BATCH
  129. K11ASM.E80    Assemble Kermit for RSTS/E
  130. K11ASM.M41    Assemble Kermit for RSX11M, RSX11M+ and P/OS (under RSTS)
  131. K11ASM.RT4    Assemble Kermit for RT11 and TSX+, again, under RSTS
  132. K11ATR.MAC    Attribute packet processing
  133. K11CDF.MAC    Macro definitions for commands, a .INCLUDE file
  134. K11CM1.MAC    Overlay for some commands
  135. K11CMD.MAC    Main program
  136. K11COM.MAC    Overlay for defining commands
  137. K11CPY.MAC    The COPY command
  138. K11CVT.MAC    Filename conversion routines
  139. K11DAP.E80    ODL file for including DAP support for K11NRS.TSK (RSTS)
  140. K11DAP.M41    ODL file for including DAP support for K11RSX.TSK (RSX)
  141. K11DAT.MAC    Global read/write data
  142. K11DEB.MAC    EXAMINE command (debugging)
  143. K11DEF.MAC    Packet definition .INCLUDE file
  144. K11DER.MAC    RSX11M directive errors
  145. K11DFH.MAC    Help to be printed if the help file open fails
  146. K11DIA.MAC    The DIAL command, also SET MODEM and SHOW DIAL
  147. K11DSP.MAC    Dispatching module for RT11
  148. K11E80.MAC    RSTS specific support
  149. K11ECO.MAC    RSTS connect command
  150. K11EDI.MAC    The command line editor/recall
  151. K11ER1.MAC    RSM11 error text overlay
  152. K11ER2.MAC    RSM11 error text overlay
  153. K11ER3.MAC    RSM11 error text overlay
  154. K11ERR.MAC    Driver for RMS11 error messages
  155. K11F85.RNO    Text for Fall 85 Decus notes
  156. K11FB .MAC    Root module for RT11 SJ/FB Kermit
  157. K11FIL.DOC    This file
  158. K11FIX.MAC    Fix file attributes for encoding the hex files (RSTS)
  159. K11HEX.B2S    Basic+2 program to convert HEX to TSK (RSX,RSTS)
  160. K11HEX.BAS    Basic+  program to convert HEX to TSK (RSTS)
  161. K11HEX.COM    Creates the HEX files
  162. K11HEX.FTN    Fortran 77 program to convert HEX to TSK (RSX,RSTS)
  163. K11HEX.MAC    Macro-11 program to convert HEX to SAV (RT11)
  164. K11HLP.HLP    The HELP file
  165. K11HLP.MAC    Processes the HELP command
  166. K11HLP.RNO    The source file for K11HLP.HLP
  167. K11ID .COM    Build Kermit under RSTS for I/D space
  168. K11ID .ODL    Overlay to build Kermit for I/D space on RSTS V9.x
  169. K11ID .TSK    Executable for Kermit under RSTS and I/D space
  170. K11IDM.COM    Same as K11ID.COM, but for RSX11M+ and Micro/RSX
  171. K11IDM.ODL    Same as K11ID.ODL, but for RSX11M+ and Micro/RSX
  172. K11IDM.TSK    Same as K11ID.TSK, but for RSX11M+ and Micro/RSX
  173. K11INI.MAC    Initialization, packet logging
  174. K11INS.DOC    Installation notes
  175. K11INS.RNO    Source of K11INS.DOC
  176. K11LCL.MAC    Restrict commands
  177. K11M41.MAC    RSX11M, RSX11M+ and P/OS specific routines
  178. K11MAC.MAC    Macro defintions, for .INCLUDE
  179. K11MCO.MAC    RSX11M and RSX11M+ connect module (terminal emulation)
  180. K11NHD.MAC    Prefix file to define EIS instructions as macros, RT11
  181. K11NRS.COM    Task build RSTS for no RMSRES
  182. K11NRS.ODL    Ditto
  183. K11NRS.TSK    RSTS image NOT linked to RMSRES
  184. K11PAK.MAC    Low level packet processing
  185. K11PCO.MAC    Connect module called for P/OS
  186. K11PK .MAC    RSTS specific, spawn 'subprocess'
  187. K11POS.COM    Task build Kermit for RSX11M+, Micro/RSX and P/OS
  188. K11POS.ODL    Ditto
  189. K11POS.TSK    Executable of above
  190. K11POS.XRF    Global cross reference
  191. K11PRT.MAC    Support for XC, XL, CLn and KL under RT11 and TSX+
  192. K11RCO.MAC    Connect code for RT11 and TSX+
  193. K11REC.MAC    Incoming file protocol processing
  194. K11RMS.MAC    File access routines for RSX11M/M+, RSTS/E and P/OS
  195. K11RMZ.MAC    Misc RMS11 routines
  196. K11RSX.COM    Task build Kermit for RSX w/o RMSRES
  197. K11RSX.ODL    Ditto
  198. K11RSX.TSK    Executable of non-RMSRES RSX version
  199. K11RT4.COM    Assemble for RT11
  200. K11RT4.MAC    RT11 and TSX+ file access
  201. K11RT4.SAV    Executable for RT11 and TSX+, not for use under XM
  202. K11RTD.MAC    Directory operations for RT11
  203. K11RTE.MAC    Error messages for RT11
  204. K11RTI.MAC    Initialization for RT11
  205. K11RTT.MAC    Multiple terminal service support for RT11
  206. K11RTU.MAC    Misc utility routines for RT11
  207. K11SEN.MAC    Outgoing file protocol processing
  208. K11SER.MAC    Server support
  209. K11SHO.MAC    The SHOW command
  210. K11SML.COM    Task build file for tightly overlayed RSX11M Kermit
  211. K11SML.ODL    Overlay for above
  212. K11SML.TSK    Executable
  213. K11ST0.MAC    A SET command overlay
  214. K11ST1.MAC    A SET command overlay
  215. K11STD.MAC    SET command definitions
  216. K11SUB.MAC    Misc utility routines common to all execs
  217. K11TRA.MAC    The TRANSMIT command
  218. K11TSX.MAC    TSX remote support
  219. K11USR.DOC    Main user documentation
  220. K11USR.RNO    Source for K11USR.DOC
  221. K11XM .COM    Link Kermit-11 for RT11 XM and TSX+
  222. K11XM .MAC    Root module for XM Kermit
  223. K11XM .SAV    The executable for RT11 XM and TSX+
  224.  
  225. .eli
  226. .subtitle RSTS/E installation
  227. .page
  228. .index RSTS/E Kermit installation
  229. .s 2
  230. .c;Installation of Kermit-11 on RSTS/E
  231. .s 1
  232.  
  233. The minimum version of RSTS/E must be 8.0 or later for Kermit to
  234. function correctly. Kermit will run on version 7.2, but there will
  235. be random problems with file access. This is due to the use of RMS11
  236. version 2 in Kermit-11 for all file activity; version 7 of RSTS/E
  237. supports only RMS version 1.8.
  238. .br
  239. Kermit's use of RMS11 costs you NOTHING. You have the option of using
  240. an image that contains RMS in disk overlays (K11NRS.TSK),
  241. or you can use one that's
  242. linked to the segmented RMS resident library, RMSRES (K11.TSK).
  243. The pros and cons
  244. of using RMS will not be discussed; there aren't any valid reasons NOT to
  245. use it.
  246. .s 1
  247. Be sure that the SYSGEN question relating to multiple private delimiters
  248. was answered YES, otherwise Kermit will tell you it can't run without it
  249. as soon as you attempt a file transfer. Multiple delimiter masks cost you
  250. one word in executive data space to be used as a pointer to a small buffer
  251. containing the delimiter mask; the small buffer is not allocated until
  252. Kermit requests the monitor to do so.
  253. .s 1
  254. If you are running RSTS 9.3 or later, you can, if your CPU supports it,
  255. use a Kermit-11 build with I/D space support. The supported cpu's are:
  256. .s 1
  257. PDP 11/44, PDP 11/45, PDP 11/70, PDP 11/73 and PDP 11/84.
  258. .s 1
  259. If this is the case, the replace all references to 'K11.TSK' with 'K11ID.TSK'.
  260. Though note, that if you have obtained your distribution from COLUMBIA, that
  261. their tape will NOT include the file K11ID.HEX, due to space limitations.
  262. This implies that you would have to build that image from source, using the
  263. files K11ASM.E80, K11ID.COM and K11ID.ODL.
  264. .s 2
  265. Tape distribution:
  266. .s 1
  267. There are many different possibilities here. You may have an ANSI-D tape
  268. from Columbia, a backup tape from a friend, a DOS format tape from DECUS,
  269. or even RX50's for a Micro-11 system. All following examples are done under
  270. RSTS/E version 9.0 or later.
  271. .s 1
  272. .lit
  273. (1) DOS format Kermit-11 tape
  274.  
  275.     $ MOU MM0:/FOR=DOS
  276.     $ PIP MM0:[*,*]*.*/L:S
  277.     $ PIP SY:[1,2]=MM0:[*,*]K11.TSK
  278.     $ PIP SY:[1,2]=MM0:[*,*]K11HLP.HLP
  279.     $ PIP SY:[1,2]=MM0:[*,*]K11USR.DOC
  280.     $ SET FILE [1,2]K11.TSK/RUN=RSX/PRO=104
  281.     $ SET FILE [1,2]K11HLP.HLP/PRO=40
  282.     $ DEFINE/COMMAND/SYSTEM KER-MIT [1,2]K11.TSK/LINE=30000
  283.  
  284. The above commands did the following:
  285.  
  286.     (1) Insure the tape label format is DOS-11
  287.     (2) Get a directory to make sure the files are really there
  288.     (3) Copy the executable task image (linked to RMSRES)
  289.     (4) Copy the online help file
  290.     (5) Copy the Kermit-11 users guide
  291.     (6) Set protection and runtime system name
  292.     (7) Create a CCL definition for Kermit to be invoked with
  293.  
  294. .eli
  295. .test page 10
  296. .lit
  297. (2) Ansi D format tape from Columbia
  298.  
  299.     $ MOU MM0:/FOR=ANS KERMIT    ! RSTS/E 9.0 or 9.1
  300.     $ MOU MM0:/OV=ID        ! RSTS/E 9.2 or later
  301.     $ PIP SY:=MM0:K11.HEX
  302.     $ PIP SY:=MM0:K11HEX.BAS
  303.     $ PIP SY:[1,2]=MM0:K11HLP.HLP
  304.     $ PIP SY:[1,2]=MM0:K11USR.DOC
  305.     $ BASIC
  306.     old k11hex
  307.     run
  308.     K11HEX- Decode Kermit-11 Hex files (RSTS/E Basic+)
  309.     Input Hex file ? K11.HEX
  310.     Output Task image? K11.TSK
  311.     $
  312.     $ COP/REP K11.TSK [1,2]
  313.     $ SET FILE [1,2]K11.TSK/RUN=RSX/PRO=104
  314.     $ SET FILE [1,2]K11HLP.HLP/PRO=40
  315.     $ DEFINE/COMMAND/SYSTEM KER-MIT [1,2]K11.TSK/LINE=30000
  316.  
  317. Again, the sequence of operations is:
  318.  
  319.     (1) Insure current tape labeling is ANSI
  320.     (2) Copy a hexified version of the task image
  321.     (3) Copy a simple Basic+ program to create the task image
  322.     (4) Copy online help file and user documentation
  323.     (5) Switch to Basic+
  324.     (6) Run the K11HEX program, creating a task image
  325.     (7) Copy the task image to [1,2]
  326.     (8) Set runtime system, protection and ccl command.
  327.  
  328. .eli
  329. If the tape label for an ANSI tape is unknown, you can switch
  330. to Basic+ or RSX keyboard monitors and do an ASSIGN MM0:.ANSI
  331. as the RSTS/E DCL Mount command lacks an override switch
  332. for volume identification. If the DCL command BASIC fails, try the
  333. ccl command SY/R to find out what Basic is called, and then try
  334. a SWITCH nnnnnn ccl command, where 'nnnnnn' is the Basic+ run time
  335. system name. For example, the author always uses BAS4F for the basic
  336. run time system (to designate 4 word FP11/KEF11 support), and the DCL symbol
  337. BASIC is defined as BASIC :== CCL SWI BAS4F.
  338. .br
  339. If PIP gives you an error message regarding insufficient buffer space,
  340. redefine the CCL command definition for PIP to extend PIP to 28KW; this
  341. is done by specifying a line number in the form 8192+size(KW).
  342. .s 2
  343. (3) RX50 or RX01 floppy diskettes
  344. .s 1
  345. The DECUS Library Micro-RSTS distribution is on RT-11 formatted
  346. RX50 diskettes; the Decus Library (Decus number 11-731) alternate
  347. distribution media on RX01's is also a set of RT-11 formatted floppy
  348. diskettes. These are readable on RSTS/E with the program FIT, supplied
  349. with your system. If you have RSTS/E Kermit on floppies, the first
  350. thing to do is to get directory listings of all the diskettes so you
  351. know which floppy to use for a given file. The following example is
  352. the general method:
  353. .lit
  354.  
  355.     $ RUN AUXLIB$:FIT
  356.     FIT    V9.0-14 RSTS V9.0-14 U of Toledo 44
  357.     FIT>SY:=DX0:*.*
  358.     FIT>SY:=DX0:*.*
  359.     FIT>^Z
  360.     $ COP/REP K11HLP.HLP [1,2]
  361.     $ COP/REP K11.TSK [1,2]
  362.     $ SET FILE [1,2]K11.TSK/RUN=RSX/PRO=104
  363.     $ SET FILE [1,2]K11HLP.HLP/PRO=40
  364.     $ DEFINE/COMMAND/SYSTEM KER-MIT [1,2]K11.TSK/LINE=30000
  365.  
  366. .eli
  367. Since there are only two or three floppy diskettes involved it is
  368. convenient to copy all the diskettes to your account, and then move
  369. the needed files to their final destination. In the above example, it
  370. is assumed that a different diskette was placed into DX0 before the
  371. second file transfer
  372. command was issued. In the case of RX50 diskettes, the input device
  373. name would be DUn, where 'N' is the number of winchester drives (hard
  374. disks)
  375. on your system.
  376. For example, if you have one RD52 on your system, then floppy drive zero
  377. is called DU1:.
  378.  
  379. .s 1
  380. In summary, you want to copy K11.TSK from the media and install it
  381. somewhere with world read+execute access and preferably define a CCL
  382. command for it. Dialup access is documented at the end of this file
  383. for obtaining newer Kermit-11 versions.
  384. .subtitle RT-11 and TSX+
  385. .test page 10
  386. .index RT-11 and TSX+ Kermit installation
  387. .s 2
  388. .c;Installation of Kermit-11 on RT-11 and TSX+
  389. .s 1
  390. RT-11
  391. .s 1
  392. Kermit-11, as used under RT-11, supports the use of multiple terminal
  393. service, the XC and XL handlers found on version 5 of RT-11, and, in
  394. extreme cases, the use of the console line for connecting TO the RT-11
  395. system.
  396. .s 1
  397. The first option, the use of Multiple Terminal support, requires a
  398. SYSGEN if this feature is not configured. Serial lines in this case
  399. are designated by numbers; the console is always line zero, the next
  400. line, say a DLV11E, may be line one. These line numbers are assigned
  401. during SYSGEN based upon the order of entry during SYSGEN (under 5.2,
  402. the questions start with question number 180). You can also use a DZ11
  403. or DZV11. The actual assignments may be viewed on a running system
  404. with the DCL command SHO TER.
  405. .s 1
  406. The best solution is to use the XL driver (XC on PRO/RT-11), available
  407. on RT-11 version 5.1 and 5.2.
  408. This is a driver
  409. that makes very efficient use of a DLV11 compatible interface; it's
  410. the same handler that is used by VTCOM. To use it, you must have, just
  411. like for multiple terminal support, an extra DL11/DLV11 interface in addition
  412. to the console interface. The XL handler supports two DCL commands:
  413. .lit
  414.  
  415.     SET XL CSR=n
  416.     SET XL VECTOR=m
  417.  
  418. .eli
  419. Where 'N' is the address of the CSR (control status register) and 'M' is
  420. the interrupt vector address. The defaults are 176500 for the CSR, and 300
  421. for the interrupt vector.
  422. .br
  423. The XC handler, used ONLY on the PRO/300 series,
  424. has it's CSR and vector fixed at 173300 and 210 respectively. Kermit-11,
  425. upon finding itself running on a PRO/3xx under RT-11, does an implicit
  426. SET LIN XC:. The DCL command SET XC SPEED=N must be used outside of Kermit
  427. to change the XC line speed from the default of 1200 baud.
  428. .s 1
  429. Last, but not least, if there is no way to get an additional interface
  430. into your system (perhaps you have a four slot QBUS backplane), you
  431. can force Kermit to use the console. This implies, of course, that it
  432. will not be possible to dial out from the RT-11 system; the system could
  433. be used only for a remote Kermit to connect to it via the console port.
  434. If Kermit finds that the XL handler is not present, and that multiple
  435. terminal service is absent, it will force the use of the console. Otherwise,
  436. the command:
  437. .lit
  438.  
  439.     Kermit-11>SET LINE TT:
  440.  
  441. .eli
  442. will force the console to be used.
  443. .s 1
  444. In summary, the following commands (in order) specify serial lines for
  445. Kermit-11:
  446. .lit
  447.     
  448.     Kermit-11>SET LINE 1        use terminal line one
  449.     Kermit-11>SET LIN XL        use the XL handler
  450.     Kermit-11>SET LIN TT:        force use of the console line
  451.  
  452. .eli
  453.  
  454. Kermit-11 also requires the presence of timer support in the executive.
  455. This is required to support the .TWAIT directive; FB and XM systems always
  456. have support for this; SJ systems by default do not. If Kermit decides that
  457. it does not have a clock, which it would think if .TWAIT support is missing,
  458. it will try to fake .TWAIT's with cpu bound loops. The best thing is to
  459. insure that you have a FB or XM monitor available for use with Kermit.
  460. .s 2
  461. TSX+
  462. .s 1
  463. Kermit-11 is used on TSX+ (a product of S_&H Computing) as both a LOCAL
  464. Kermit (you connect out to another system using the CL handler) and a
  465. REMOTE Kermit (you log into a TSX+ system and run Kermit-11 to communicate
  466. with your local Kermit system). The second is identical to Kermit use
  467. on most multiuser systems (for example, TOPS-20 and RSTS/E), while the
  468. former is similar to Kermit use on RT-11 with the XL/XC handler.
  469. In order to CONNECT out from TSX Kermit to another system, you need to
  470. associate the appropriate CL line with the logical name XL, or, if you
  471. are running Kermit-11 2.44 or later and have 8 CL lines or less, you
  472. can directly specify the CL unit number:
  473. .lit
  474.  
  475.     .SET CLn LINE=4
  476.     .SET CL NOLFOUT
  477.     .ASS CLn XL
  478.     .KERMIT
  479.     Kermit-11>SET LIN XL
  480.     Kermit-11>CONNECT
  481.    or:
  482.  
  483.     Kermit-11>SET LIN CLn
  484.  
  485. .eli
  486. where 'N' is the CL unit number, or just CL for CL0:.
  487. Please consult the Kermit-11 User's Guide for further information regarding
  488. serial line support.
  489. .s 1
  490. The image K11XM.SAV will use approximately 100 blocks of PLAS swapfile
  491. space; if that is excessive, or if Kermit fails to load, then the
  492. disk overlayed image K11RT4.SAV may be used. Alternately, the TSGEN.MAC
  493. parameter SEGBLK may be too small to contain K11XM's virtual overlay; the
  494. TSX+ system manager will need to increase SEGBLK and reboot TSX+.
  495. .s 2
  496. Installing Kermit on RT-11 and TSX+
  497. .s 2
  498. As in the case of RSTS/E, there are so many media formats that may
  499. be used for Kermit that we must restrict the discussion to the more
  500. likely media. First of all, the files of interest are:
  501. .lit
  502.  
  503.     K11XM.SAV    For use on RT-11 XM, PRO/RT-11 and TSX+
  504.     K11RT4.SAV    For use on RT-11 SJ and FB, also usable on TSX+
  505.     K11HLP.HLP    The online help file
  506.     K11USR.DOC    The user's guide
  507.  
  508. .eli
  509. The most common media that RT-11 and TSX+ users may get Kermit-11 is
  510. on 8 inch RX01 diskettes and 5 1/4 inch RX50 floppies. Both examples
  511. reference RX50 devices, the use of RX01 and RX02 disks is the same
  512. except that a RX01 (RX11-BA and RXV11-BA) drive is called DX and 
  513. the RX02 drive is called DY. Additionally, the eight inch floppies
  514. have a lower capacity than an RX50, thus Kermit-11 files may be
  515. split across two or more diskettes.
  516. The RX50 drives are known as DZ0: and DZ1: on the PRO/350, and they are
  517. known as DUn: and DUn+1: on other QBUS processors, when N is the number
  518. of fixed drives (RD50,51 and 52). If your system is NOT a PRO/3xx series
  519. systems, you would need to replace the references to DZn: with the
  520. appropiate DU device names. For example, if you have one RD52 winchester
  521. drive and two RX50 units, then the first RX50 would be DU1: and the second
  522. DU2:. The RC25 is an exception; if your system had one RC25 and an RX50,
  523. then the first RX50 would be called DU4:. If your system contained no
  524. MSCP disk drives other than the RX50, then the units would be DU0: and DU1:.
  525. .lit
  526.  
  527. (1) RT-11 5.2 and PRO/350, files on RX50 media
  528.  
  529.     .COPY DZ0:K11XM.SAV DK:KERMIT.SAV
  530.     .COPY DZ0:K11HLP.HLP DK:
  531.     .COPY DZ0:K11USR.DOC DK:
  532.     .SET XC SPEED=9600
  533.     .KERMIT
  534.     Kermit-11 T3.44 Last Edit: 04-Feb-86
  535.     PRO/350 comm port set to XC0:
  536.     Kermit-11>EXIT
  537.  
  538. .eli
  539. Since this was a PRO/350, we must use the K11XM.SAV executable image,
  540. since only RT-11XM will run on the PRO. Had this been a PDP-11 running
  541. RT-11 SJ or RT-11 FB, we would have copied K11RT4.SAV to KERMIT.SAV rather
  542. than K11XM.
  543. .lit
  544.  
  545. (2) RT-11 5.2 FB and LSI-11/23
  546.  
  547.     .COPY DU1:K11RT4.SAV DK:KERMIT.SAV
  548.     .COPY DU1:K11HLP.HLP DK:
  549.     .COPY DU1:K11USR.DOC DK:
  550.     .SET XL CSR=176510
  551.     .SET XL VEC=310
  552.     .KERMIT
  553.     Kermit-11 T3.44 Last Edit: 04-Feb-86
  554.     Kermit-11>SET LIN XL:
  555.  
  556. .eli
  557. In this case, we had one winchester fixed disk drive, DU0:, thus the
  558. RX50 units are called DU1: and DU2:
  559. We also have a DLV11 at a CSR and VECTOR of 176510 and 310,
  560. respectively, which differs from the default 176500 and 300. Since the
  561. DLV11's speed is set via onboard switch packs, the DCL command SET XL SPEED
  562. command is not usable.
  563. .s 1
  564.  
  565. .lit
  566.  
  567. (3) RT-11 without the Kermit save image
  568.  
  569.     .COPY DU1:K11XM.HEX DK:
  570.     .COPY DU1:K11HEX.MAC DK:
  571.     .R MACRO
  572.     *K11HEX=K11HEX
  573.     *^C
  574.     .R LINK
  575.     *K11HEX=K11HEX
  576.     *^C
  577.     .RUN K11HEX
  578.     *K11XM=K11XM
  579.     .RUN K11XM
  580.     Kermit T3.44 Last edit: 04-Feb-86
  581.     Kermit-11>EXIT
  582.     .
  583.  
  584. .eli
  585. In this case, it is assumed that we have the files K11XM.HEX (or K11RT4.HEX)
  586. and K11HEX.MAC, perhaps obtained from a remote system with VTCOM. After
  587. copying the two files we assembled and linked the K11HEX program. The K11HEX
  588. program is then run to create the desired save image. Keep in mind that K11XM
  589. is for TSX+, RT-11 XM and the PRO/350, whereas K11RT4 is for SJ and FB systems.
  590. Again, the disk configuration was one MSCP winchester disk
  591. (a RD50, RD51 or RD52) and two RX50 units.
  592. .s 2
  593. In the event that you are using multiple terminal support, you could
  594. use a command of the form:
  595. .lit
  596.  
  597.     .SHO TER
  598.     Unit  Owner      Type       Width  Tab  CRLF  FORM  SCOPE  SPEED
  599.     0         S-Console DL   132   No   Yes    No    No    N/A
  600.     1            Remote    DL    80   Yes  Yes    No    No    N/A
  601.  
  602.     .KERMIT
  603.     Kermit-11 T3.44 Last Edit: 04-Feb-86
  604.     Kermit-11>SET LINE 1
  605.  
  606. .eli
  607. otherwise use the XL (XC for the PRO) handler. The XL handler must be
  608. previously
  609. installed; it does not have to be loaded. Kermit will fetch the handler
  610. if it is not resident.
  611. .lit
  612.  
  613.     .INS XL
  614.     .KERMIT
  615.     Kermit-11 T3.44 Last Edit: 04-Feb-86    
  616.     Kermit-11>SET LIN XL
  617.     Kermit-11>CONNECT
  618.  
  619. .eli
  620.  
  621. .subtitle P/OS and the PRO/3xx
  622. .test page 10
  623. .index P/OS Kermit installation
  624. .s 3
  625. .c;Installation of Kermit-11 on P/OS
  626. .s 1
  627. P/OS Kermit-11
  628. .s 2
  629. Kermit-11, running on the PRO/350 and 380 under P/OS, runs under control
  630. of DCL. DCL is normally installed at system generation time; it is an
  631. optional application. DCL can also be installed under the PRO/TOOLKIT.
  632. The DECUS distribution,
  633. on RX50 diskettes, has all the needed files
  634. under the directory [001002], or, in Files-11 ODS1 terms, in UIC [1,2].
  635. Thus, installing Kermit-11 under P/OS from RX50's is quite simple:
  636. .lit
  637.  
  638.     $ COPY/CONT DZ1:[1,2]K11POS.TSK [USERFILES]
  639.     $ COPY/CONT DZ1:[1,2]K11HLP.HLP [1,2]
  640.  
  641. .eli
  642. Where DZ1 is the first floppy drive unit, as opposed to RT-11, where DZ0 is
  643. the first floppy drive unit.
  644. .br
  645. Thus, assuming that the current default directory is [USERFILES], one simply
  646. types:
  647. .lit
  648.  
  649.     $ RUN K11POS
  650.     Kermit-11 T3.44 Last edit: 04-Feb-86
  651.     Line set to XK0: at 9600 baud
  652.     Kermit-11>
  653.  
  654. .eli
  655. As noted, the PRO/3xx Kermit-11 can make use of XT1: and XT2: to access the
  656. PRO/TMS Telephone Management System. If a SET LINE XT1: 
  657. (or XT2:, when applicable) is done, then the Kermit-11 DIAL command can be used
  658. to access the TMS internal modem to place an outgoing call. All needed
  659. formatting characters MUST be imbedded in the TMS dial string. If the DIAL
  660. command is used, and the line name starts with 'XT', then it is assumed that
  661. TMS is being used; otherwise you would be required to use the SET MODEM command
  662. prior to issuing the DIAL command.
  663. Further information regarding DIAL and SET MODEM is available in the Kermit-11
  664. User's Guide and in the online HELP file.
  665. .s 1
  666. The other obvious way to get Kermit-11 onto your PRO is by bootstrapping
  667. Steven's PRO Kermit or Bob Denny's PRO Kermit
  668. to download the task image, or by using PFT to transfer
  669. the task image from an RSX-11M+ or VMS host (this is left for the reader to
  670. explore).
  671. .s 1
  672. The other method to load Kermit-11 on to a PRO/3xx P/OS system is by
  673. transferring the files K11POS.HEX (a 'Hexified' task image) and K11HEX.FTN
  674. (a Fortran-77 program) or K11HEX.B2S (a Basic+2 program) using
  675. PRO/Communications (Pro/Comm).
  676. The K11HEX programs
  677. are intended to convert the 'HEX' file format into an executable task image;
  678. instructions are contained in the respective source files for compiling and
  679. task building. Please note that whenever a task image is transferred to an RSX
  680. based system, as P/OS is, the image MUST be made contiguous, as in:
  681. .lit
  682.  
  683.     $ COPY/CONT K11POS.TSK K11POS.TSK        P/OS under DCL
  684.     > PIP K11POS.TSK/CO=K11POS.TSK            RSX-11M under MCR
  685.  
  686. .eli
  687. .s 1
  688. The last note regards FUNCTION key mapping; K11POS will, while in CONNECT
  689. mode, map the following keys:
  690. .lit
  691.  
  692.     F5  (Break)    Control\ B will send a break to the remote system
  693.             as well as typing F5.
  694.     F6  (Interrupt)    Send a Control C (03  octal) to remote
  695.     F10 (Exit)    Send a Control Z (032 octal) to remote
  696.     F11 (ESC)    Send Escape      (033 octal) to remote
  697.     F12 (BS)    Send Backspace   (011 octal) to remote
  698.     F13 (LF)    Send LineFeed    (012 octal) to remote
  699.  
  700. .eli
  701. .subtitle RSX-11M/M+ Installation
  702. .test page 10
  703. .index RSX-11M and RSX-11M Plus installation
  704. .s 3
  705. .c;Installation of Kermit-11 on RSX-11M and RSX-11M Plus
  706. .s 1
  707. Kermit-11 runs under RSX-11M 4.0 or later, RSX-11M Plus 2.1 or later,
  708. and MicroRsx version 3. All file activity is done through RMS11 version
  709. 2; this is one compelling reason why Kermit can not function on earlier
  710. versions of RSX. The use of RMS11 does, however, give you transparent
  711. support for Decnet and compatability of Kermit's file system between
  712. RSX, P/OS and RSTS/E.
  713. .br
  714. There are two distributed task images for RSX. The file K11RSX.TSK is
  715. used on RSX-11M and can also be used on RSX-11M Plus, and has DECNET
  716. support linked into the image.
  717. The other image,
  718. K11POS.TSK, is usable only on RSX-11M Plus and MicroRSX, as it is
  719. linked to the segmented RMSRES resident library. It is NOT linked
  720. to DAPRES, thus if Decnet access is required, the former task image
  721. must be used.
  722. .s 1
  723. The main distribution methods for Kermit on RSX are via DOS-11 formatted
  724. magnetic tape, Ansi-D tape from Columbia University and the RSX SIG symposia
  725. tape (in BRU or VMS Backup format).
  726. The former, DOS-11, is the format that the Decus library's copy of Kermit-11
  727. (Decus number 11-731). There is an alternative distribution from DECUS on
  728. either RT-11 formatted RX01 diskettes, or on ODS1 RX50 diskettes.
  729. .lit
  730.  
  731. (1) DOS format magtape
  732.  
  733.     > MOU MM0:/FOR
  734.     > INS $FLX
  735.     > FLX SY:/RS=MM0:[*,*]K11RSX.TSK/DO
  736.     > FLX SY:/RS=MM0:[*,*]K11POS.TSK/DO
  737.     > FLX SY:/RS=MM0:[*,*]K11HLP.HLP/DO
  738.     > FLX SY:/RS=MM0:[*,*]K11USR.DOC/DO
  739.     > PIP [1,54]/CO=K11RSX.TSK
  740.     > PIP [1,2]/CO=K11HLP.HLP
  741.     > PIP [1,54]K11RSX.TSK/PR/WO:R
  742.     > PIP [1,2]K11HLP.HLP/PR/WO:R
  743.     > INS $K11RSX/TASK=...KER
  744.  
  745.     (1)  The tape is mounted foreign
  746.     (2)  FLX is installed, if it is not already
  747.     (3)  The main Kermit-11 RSX task image is copied
  748.     (4)  The alternate task image is copied
  749.     (5)  The online HELP file is copied
  750.     (6)  The users guide us copied
  751.     (7)  The task is copied to [1,54] and made contiguous
  752.     (8)  The help file is copied to [1,2] and made contiguous
  753.     (9)  The task image's protection is set to WORLD read access
  754.     (10) The HELP file's  protection is set to WORLD read access
  755.     (11) The task image is installed as KER
  756.  
  757. .eli
  758.  
  759. .s 2
  760. .lit
  761. (2) ANSI D format tape from Columbia University
  762.  
  763.     >MOU MM0:/OV=ID
  764.     >PIP SY:=MM0:K11RSX.HEX
  765.     >PIP SY:=MM0:K11HEX.FTN
  766.     >PIP SY:=MM0:K11HLP.HLP
  767.     >PIP SY:=MM0:K11USR.DOC
  768.  
  769. .eli
  770. The tape set, as it comes from Columbia University, is blocked
  771. at 8192 bytes per tape block. This could cause PIP to fail unless
  772. PIP is installed with a very large size increment. If this should occur,
  773. you will get an error message similar to:
  774. .lit
  775.  
  776.     PIP - open failure on input file
  777.     MM0:[5,20]K11RSX.HEX;1  No buffer space available for file
  778.  
  779. To correct this you can do one of two things:
  780.  
  781.     >INS $PIP/TASK=...XPP/INC=50000
  782.     >XPP SY:=MM0:K11RSX.HEX
  783.     >XPP SY:=MM0:K11HEX.FTN
  784.     >XPP SY:=MM0:K11HLP.HLP
  785.     >XPP SY:=MM0:K11USR.DOC
  786.     >REM XPP
  787.  
  788. or:
  789.  
  790.     >RUN $PIP/INC=50000
  791.     PIP>SY:=MM0:K11RSX.HEX
  792.     PIP>SY:=MM0:K11HEX.FTN
  793.     PIP>SY:=MM0:K11HLP.HLP
  794.     PIP>SY:=MM0:K11USR.DOC
  795.     PIP>^Z
  796.     >
  797.  
  798. .eli
  799. .s 1
  800. Note that we could not get K11RSX.TSK from this tape; it's not there.
  801. Instead we copied K11RSX.HEX, a file that can be run through the K11HEX
  802. program(s) to create the needed task image.
  803. .lit
  804.  
  805.     >F77 K11HEX=K11HEX
  806.     >TKB
  807.     TKB>K11HEX=K11HEX,LB:F4POTS/LB
  808.     TKB>/
  809.     Enter Options:
  810.     TKB>maxbuf=512
  811.     TKB>//
  812.     >RUN K11HEX
  813.     Input  file ? k11rsx.hex
  814.     Output file ? kermit.tsk
  815.     Encode or Decode ? decode
  816.     all done
  817.     >PIP [1,54]/CO=K11RSX.TSK
  818.     >PIP [1,2]/CO=K11HLP.HLP
  819.     >PIP [1,54]K11RSX.TSK/PR/WO:R
  820.     >PIP [1,2]K11HLP.HLP/PR/WO:R
  821.     >INS $K11RSX/TASK=...KER
  822.  
  823. .eli
  824. .s 1
  825. .lit
  826. (3) RT-11 Format RX01 diskettes
  827.  
  828.     > MOU DX0:/FOR
  829.     > MOU DX1:/FOR
  830.     > FLX SY:/RS=DX0:K11RSX.TSK/RT
  831.     > FLX SY:/RS=DX1:K11HLP.HLP/RT
  832.     > FLX SY:/RS=DX1:K11USR.DOC/RT
  833.     > PIP [1,54]/CO=K11RSX.TSK
  834.     > PIP [1,2]/CO=K11HLP.HLP
  835.     > PIP [1,54]K11RSX.TSK/PR/WO:R
  836.     > PIP [1,2]K11HLP.HLP/PR/WO:R
  837.     > INS $K11RSX/TASK=...KER
  838.  
  839. .eli
  840. RX01's diskettes can hold approximately 470 blocks of data; this implies
  841. that there will be at least two, if not three, diskettes involved. You
  842. will need to try a different diskette if the desired file(s) is not present
  843. on the currently mounted disk. Also, if you have an RX02 drive instead of
  844. an RX01 drive, the device name will be DY instead of DX.
  845.  
  846. .s 2
  847. Please note that RSX Kermit is a privileged task; it's built with the
  848. /PR:0 TKB switch. This is required so that Kermit can access terminal
  849. lines other than your own; as would be the case when you are dialing
  850. out from your system. The task does, however (under RSX-11M Plus and
  851. MicroRSX), drop and regain privilege
  852. when it needs it; for example, the SET LINE and CONNECT commands both
  853. have to issue set multiple characteristics calls to condition the
  854. serial line being used.
  855. .subtitle IAS version 3.1 and 3.2 update A and B
  856. .test page 10
  857. .index IAS version 3.1 and 3.2 update A and B
  858. .s 2
  859. .c;Note regarding Kermit-11 on IAS
  860. .s 1
  861. This information regarding IAS Kermit was provided by the EPA in
  862. there conversion of Kermit-11 to run under IAS version 3.1.
  863. The current version of IAS Kermit-11 is based on base 2.30 of
  864. Kermit-11. It will likely stay at this base level forever; the
  865. conversion was done for use with RMS11 version 1, which will be
  866. superceded by RMS11 version 2 in IAS 3.2 Update C. At that point
  867. the IAS 3.1 Kermit task image, K11I31.TSK, will no longer function since
  868. it is linked to an RMS version 1 resident library. The RMS resident
  869. libraries were redone for RMS v2 in order that (1) the library can be
  870. segmented into multiple libraries and (2) the entry point addresses are
  871. never changed, thus new versions of the reslib do not force the user
  872. to relink ones task images.
  873. .s 2
  874. Restrictions and notes:
  875. .s 1
  876. 1) Dial-out lines must not be interactive terminals.
  877. That is, if you are going to use a line as a dial-
  878. out line, you must not allocate it to PDS or SCI.
  879. .s 1
  880. 2) Spawning installed tasks is currently done via a
  881. SPWN$ directive rather than via RUN$T.  Therefore,
  882. anyone wanting to spawn installed tasks must have
  883. the PR.RTC (real-time) privilege.  A workaround is
  884. to exit from Kermit, run the program, and then
  885. run Kermit again.  Kermit will first try to run an
  886. installed task named $$$xxx, where xxx is the system
  887. command requested;  if that fails, Kermit will try
  888. to run an installed task named ...xxx.
  889. .s 1
  890. 3) Wild-card file operations are supported (for example,
  891. DIR *.DAT, DEL *.TSK, SEND *.MAC).  Under RSX, Kermit
  892. uses RMS version 2 to do wild-card operations;  this
  893. is available under IAS V3.2 but not under IAS V3.1.
  894. Therefore, on IAS V3.1 (the version that the EPA is
  895. running), there are the following restrictions on file
  896. operations::
  897. .lm 5
  898. .s 1
  899. a) Wild-cards must be specified for the entire
  900. field or not at all.  For example, TEST.*
  901. is OK but TEST*.* is not.
  902. .s 1
  903. b) If a wild-card file operation is executed,
  904. with either the file-name or the file-type
  905. specified as a wild-card, the file version
  906. number is also taken to be a wild-card.
  907. .s 1
  908. c) Wild-card operations are not allowed on
  909. directories.  Therefore, [*,*]*.DAT is not
  910. a legal wild-card operation in Kermit-IAS.
  911. It is legal to use explicit directories, such
  912. as [200,200]*.DAT.
  913. .s 1
  914. d) RMS Version 2 supports transparent DECNET
  915. remote file operations, while RMS Version 1
  916. does not.  Therefore, Kermit-IAS under IAS V3.1
  917. does not support DECNET file transfers.
  918. .s 1
  919. e) Renaming files within Kermit is not supported
  920. under V3.1 of IAS.
  921. .lm 0
  922. .s 2
  923. 4) Kermit under IAS currently reads packets one character
  924. at a time, and so can use up a fair amount of the CPU
  925. if it is receiving files.  If it is sending packets
  926. (sending files or remote command responses), or if it
  927. is reading commands rather than its file transfer packets,
  928. it will use long I/O operations and will not put an 
  929. excessive burden on the system.
  930. .s 2
  931. Installation:
  932. .s 1
  933. Kermit is built as a multi-user task, with a task name of
  934. $$$KER.  It can be run as an installed "foreign command"
  935. task:
  936. .s 1
  937. .lit
  938.     PDS> install k11ias
  939.     PDS> kermit
  940.     Kermit-11 T2.30
  941.     Kermit-11>...
  942.  
  943. You can also specify another name for the installed command:
  944.  
  945.     PDS> install/sys:k11 k11ias
  946.     PDS> k11
  947.     Kermit-11 T2.30
  948.     Kermit-11>...
  949.  
  950. Or you can just run it as a non-installed task:
  951.  
  952.     PDS> run k11ias
  953.     16:30:15
  954.     Kermit-11 T2.30
  955.     Kermit-11>...
  956.  
  957. The following files are supplied for Kermit-IAS to run:
  958.  
  959.     K11I31.TSK    - The Kermit task image
  960.     K11HLP.HLP    - The Kermit help file.  For this to be used by
  961.               Kermit, it must be in the default directory.
  962.     K11I31.DOC    - This file, describing Kermit on IAS
  963. .eli
  964. .s 4
  965. .subtitle Obtaining updates of Kermit-11
  966. .index Obtaining updates of Kermit-11
  967. .s 1
  968. .c;Obtaining Kermit-11 updates from the University of Toledo
  969. .s 1
  970. From Bitnet server on U of Toledo's 11/785
  971. .s 1
  972. .lit
  973. from VM/CMS:    CP SMSG RSCS MSG UOFT02 KERMSRV DIR
  974.         CP SMSG RSCS MSG UOFT02 KERMSRV SEND K11*.*
  975.  
  976. from VMS Jnet:    $ SEN/REM UOFT02 KERMSRV SEND K11*.*
  977.  
  978.  
  979. Dialup access to the 11/785:
  980.  
  981.     (419) 537-4411
  982.     Service class  VX785A
  983.     User: KERMIT
  984.     Password: KERMIT
  985.  
  986. Source and hex files are in KER:, binaries are in KERBIN:
  987.  
  988. .eli
  989.