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