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