home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / b / krt.doc < prev    next >
Text File  |  2020-01-01  |  69KB  |  1,704 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.       K E R M I T - 1 1   f o r   R T - 1 1 / T S X - P L U S
  7.  
  8.  
  9.     I N S T A L L A T I O N   a n d   R E L E A S E   N O T E S
  10.  
  11.  
  12.         V  0  3 . 6  3        2 7 - S E P - 1 9 9 7
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19. KRTTSX is  a  special  version  of  Kermit-11 (PDP-11 Kermit written by Brian
  20. Nelson of the University of Toledo) enhanced for use with TSX-Plus.  This was
  21. begun primarily to support its use on a public bulletin board system and then
  22. was expanded to produce a  reliable,  general purpose communications program.
  23. Numerous bugs have been fixed and several  new  routines  added.  All changes
  24. are documented in the edit history in KRTCMD.MAC,  or may be read from within
  25. Kermit by HELP Release-Notes.  Please note not only has KRTTSX's on-line HELP
  26. text been greatly enhanced and expanded, lookups in it now execute at maximum
  27. speed, thus this document is rather short.  Use HELP for operating info.  You
  28. may use HPRINT to generate hard copy of anything needed for handy reference.
  29.  
  30. For an in-depth discussion of Kermit fundamentals there's no substitute for:
  31.  
  32.    "Kermit, A File Transfer Protocol" by Frank da Cruz, 1987
  33.    Digital Press, order number: EY-6705E-DP  (in USA phone: 800 343-8321)
  34.    DP ISBN 0-932376-88-6, PH ISBN 0-13-514753-0
  35.  
  36. This Kermit does not yet offer character set translation, labeled file types,
  37. sliding windows, a script programming language or command macros, but it does
  38. provide everything else one would expect after reading the above.
  39.  
  40. This program is for use with RT-11 V4.0 or TSX-Plus V5.0 and up, though a few
  41. new features use EMTs added in slightly later releases.   KRTTSX runs what it
  42. can with earlier releases of either RT-11 or TSX.   Debugging was done on TSX
  43. V6.5 and RT-11 V5.5, under which its operation has been thoroughly tested and
  44. is extremely reliable.  All RT-11 V5.6 and above monitors are also supported,
  45. including separate I&D space.
  46.  
  47. Thanks for some of the ideas, additions, fixes and above all, bugs eliminated
  48. in this program are due to Tim Clarke, Tom McCoy, Bill Walker, Roger Wallace,
  49. Jim Whitlock and Chester Wilson.  Additionally,  appreciation is owed all who
  50. contributed  to  VMS-Kermit  and C-Kermit, from which many other new features
  51. were derived, and to Brian Nelson, author of the original Kermit-11.  Some of
  52. the most  obscure  yet  serious  bugs  were  discovered by Bill Walker, Roger
  53. Wallace and Jim Whitlock, without  whose  help this Kermit would hardly be as
  54. bullet-proof as it now is.
  55.  
  56.  
  57.     Billy Youdelman                billy@MIX.COM
  58.     PO Box 1207
  59.     Culver City, California  90232-1207
  60.     USA
  61.  
  62.  
  63. Installation and Release Notes    KRT V03.63            Page Two
  64.  
  65.  
  66.  
  67.  
  68.  
  69.            T A B L E   O F   C O N T E N T S
  70.            ---------   ---   ---------------
  71.  
  72.  
  73.  
  74.  
  75.     I N S T A L L A T I O N                Three
  76.  
  77.  
  78.     K R T . I N I   E x a m p l e s            Five
  79.  
  80.  
  81.     R T - 1 1   S p e c i f i c   I n f o        Six
  82.  
  83.  
  84.     A   "K e r m i t   M o d e m"   H a n d l e r    Eight
  85.  
  86.  
  87.     T S X - P l u s   S p e c i f i c   I n f o    Ten
  88.  
  89.  
  90.     M O D E M S                    Thirteen
  91.  
  92.         Anchor Automation MK24            Fourteen
  93.  
  94.         Telebit T2500/T3000            Fifteen
  95.  
  96.         US Robotics "Courier" 2400/2400e    Seventeen
  97.  
  98.         USER-DEFINED MODEM            Eighteen
  99.             SET DIAL Commands        TwentyOne
  100.  
  101.  
  102.     R E S T R I C T I O N S                TwentyNine
  103.  
  104.  
  105.     O b t a i n i n g   U p g r a d e s        TwentyNine
  106.  
  107.  
  108.     F i l e s   R e q u i r e d            Thirty
  109.  
  110.  
  111.  
  112. Installation and Release Notes    KRT V03.63            Page Three
  113.  
  114.  
  115.             I N S T A L L A T I O N
  116.             -----------------------
  117.  
  118. This program will run under RT-11 or TSX-Plus.  The system clock must be
  119. running.  As  distributed  KRT  is built to run on a non-EIS CPU, KRTTSX
  120. is built for EIS processors.  These monitors and handlers are supported:
  121.  
  122.  RT-11SJ   V5.0 + up   TT  KM  XL    ; SYSGEN for TIMER support
  123.  RT-11FB   V4.0 + up   TT  KM  XL    ; SYSGEN for..
  124.  RT-11XM   V5.1 + up   TT  KM  XC  XL    ;  ..SPCPS support
  125.  RT-11 all V5.6 + up   TT  KM  XC  XL    ; including separate I&D space
  126.  TSX-Plus  V5.0 + up   TT  CL  KM  XL    ; see HELP INSTALL TSX
  127.  
  128.  NOTE:  XL first appeared in RT-11 V5.1.  Prior releases must use either
  129.  TT (the console terminal port) or KM (a "Kermit Modem" handler supplied
  130.  with this program) for communicating with the outside world.
  131.  
  132. KRTTSX.SAV uses extended memory overlays for XB,XM,ZB,ZM,TSX and KRT.SAV
  133. low memory overlays for  FB,SB,SJ,TSX  to accommodate small systems.  FB
  134. is the ONLY RT-11 V4 monitor which can run this program.  VBGEXE or VRUN
  135. may be used under mapped RT-11 monitors.  It's best to load any handlers
  136. required first, even for a background task.  KRT's maximum packet-length
  137. is 600., KRTTSX's is 1920., this is determined by the NONEIS conditional
  138. code for MAXLNG in KRTMAC.MAC.
  139.  
  140. KRTTSX requires 166kb of memory to load, KRT only needs 41kb.  Under TSX
  141. it's 172kb and 47kb for V6.5 or 171kb and 46kb with V6.4.  KRT increases
  142. disk I/O as its overlays are not kept resident.  When none of these will
  143. load KRTMIN (sometimes distributed separately) is a special version that
  144. uses less memory by only communicating through the console terminal port
  145. (see KRTMIN.DOC for details).
  146.  
  147. If you already have some form of Kermit on your system, you may try this
  148. one out by copying to a disk containing no other Kermit files, assigning
  149. that disk DK, deassigning HLP, INI and KRT, and running the new program.
  150. Assuming LD0 is a scratch disk and you have an 8" floppy:
  151.  
  152.     .COP DY0:*.(SAV,HLP,INI) LD0:
  153.     .ASS LD0 DK
  154.     .DEA HLP
  155.     .DEA INI
  156.     .DEA KRT
  157.     .SET USR SWAP    ! if running RT-11
  158.     .RU KRTTSX    ! use KRT if KRTTSX won't load
  159.  
  160. To dial out, edit the copy  of  KRT.INI  on LD0 as needed for your site.
  161. It is not necessary to use a command file for such things as attaching a
  162. CL unit to a TSX line before running this Kermit - everything may now be
  163. easily handled during its initialization.  At this point it is suggested
  164. you use the running Kermit to read through its own HELP,  especially the
  165. SET LINE and SET CL topics.  If you opt to use any sort of indirect .COM
  166. file to actually run  KRT/KRTTSX,  please  note that under TSX using the
  167. ^>R KRT.. option to force command file input to the running program will
  168. cause the test for TT input during the strike any key abort when dialing
  169. to hang and you won't be able to dial out from the command file.  Kermit
  170. does process indirect command (take) files as well as arguments from the
  171. command line used to run it, either of which may be used instead of ^>R:
  172.  
  173.  
  174. Installation and Release Notes    KRT V03.63            Page Four
  175.  
  176.  
  177.     .KRTTSX DIAL TOMMY  ! dials a phone number defined as "tommy"
  178.     .KRTTSX TAKE TOMMY  ! runs the indirect command file tommy.com
  179.  
  180. You may also have to force arguments for the program to it when run from
  181. a command file under TSX:
  182.  
  183.     R KRTTSX ^1 ^2 ^3   ! as needed, up to 6 args
  184.  
  185. There is an additional problem when forcing command line input to Kermit
  186. in that comment delimiters "!" and ";" are processed as normal chars and
  187. will cause errors.  This allows them to be passed to a remote system for
  188. RSX/VMS version numbers and the like.  They are treated as delimiters in
  189. Kermit's internal command file processing, thus the best procedure is to
  190. dump the "^>R KERMIT" line from such files and treat them as Kermit take
  191. files.  If typing in arguments when starting Kermit is a problem one may
  192. use a separate command file run from the monitor containing only:
  193.  
  194.     R KRTTSX TAKE TOMMY
  195.  
  196. This allows tommy.com to contain comments without crashing when run.
  197.  
  198. If it's decided to permanently install this program all old Kermit files
  199. (K*.HLP, K*.INI, K*.SAV, etc) should be backed up then replaced by those
  200. from this package.  Dialing from a command file (if in use) will need to
  201. be treated per the above.
  202.  
  203. After ensuring RT-11 or TSX requirements are met patch KRT.INI (examples
  204. follow) for your site, then copy these to SY:
  205.  
  206. KRTTSX.SAV  -  or KRT.SAV, the executable image, rename as desired
  207. KRTHLP.HLP  -  HELP text file, may also be on HLP, KRT or DK
  208.  
  209. and this to the logical INI, KRT or a default disk of your choice:
  210.  
  211. KRT.INI  -  initialization command file
  212.  
  213. When  started  KRT/KRTTSX  will  check  INI,  KRT, DK and SY for KRT.INI.
  214. Keeping it off SY allows others to use a different init file, and permits
  215. the program to be easily run in the remote mode by callers to the system.
  216. Or, one may SET LINE TT to accomplish the same thing.  For multiple users
  217. sharing a group of lines check HELP SET CL before editing KRT.INI.
  218.  
  219. The HELP text file search (for KRTHLP.HLP) path is HLP, KRT, SY and DK.
  220.  
  221. KRTTSX.SAV/KRT.SAV  may  be  renamed as is convenient (K11 or KERMIT) but
  222. KRT.INI  and  KRTHLP.HLP  are called (by these names) by Kermit, and thus
  223. must not be renamed.  If the HELP text (KRTHLP.HLP) is altered in any way
  224. Kermit must be rebuilt.  See KRTHLP.PRE for details.
  225.  
  226. Kermit is then run by its name, and an initial command line may be passed
  227. to it as argument(s) to the KMON command:
  228.  
  229.     .K11        ! run Kermit
  230.     .K11 DIAL DEC    ! run Kermit, dialing number set in init file
  231.  
  232. Also check the specific info for your operating system if Kermit will not
  233. be the only task running.
  234.  
  235.  
  236. Installation and Release Notes    KRT V03.63            Page Five
  237.  
  238.  
  239.         K R T . I N I   E x a m p l e s
  240.         - - - - - - -   - - - - - - - -
  241.  
  242. ! Multiple users under TSX-Plus with possibly assorted modems
  243. ! This seeks the first available line/port from those specified
  244. ! May be installed on SY to be shared by all users, see HELP SET CL
  245. SET CL PORTS 9/19200/T25/3 11/2400/H/6 8/2400/H/4
  246. SET CL UNITS 2 1 0
  247. SET CL PRIORITY 71    ! don't drop chars at high speeds
  248. SET CL LINE *    ! search for first available combination of the above
  249. ! For efficiency's sake, the above may be reduced to:
  250. !SET CL POR 9/19200/T25/3 11/2400/H/6 8/2400/H/4,UNI 2 1 0,PRI 71,LIN *
  251. SET VLSWCH REMOTE    ! emulate SET HOST/PORT if needed
  252.  ... other items as required ...
  253.  
  254. ! Single user under TSX-Plus
  255. SET CL0 LINE 9        ! includes "SET LINE CL0," unneeded by PRO-series
  256. SET SPE 2400        ! CL or KM only, others must do from monitor
  257. SET PHO XMODE 4        ! enable CONNECT/speed messages for fall back
  258. SET MOD HAYES
  259.  ...
  260.  
  261. ! Generic RT-11 ..
  262. SET LINE KM        ! to call out..
  263. SET FLOW-CONTROL RTS    ! if preferred, must be enabled in hardware too
  264. SET MOD HAYES
  265.  ...
  266.  
  267. ! System-independent items
  268. SET LONG ON        ! enable long packets
  269. SET SL ON,KED        ! turn on SL editor, enable its KED mode
  270. SET PHONE TONE
  271. SET PROMPT "Kermit-11> "
  272. SET PHO NUM DECUS 1 800 521-8950    ! Username: INFORMATION for info..
  273.  
  274. By default init file commands and informational responses to them are not
  275. echoed to the screen.  After the init completes the default terminal mode
  276. becomes NOQUIET, unless set in said file, which overrides these defaults.
  277. If you wish to display the entire init process, make SET TT NOQ the first
  278. line in KRT.INI.  A file may be tested by running it as a take file:
  279.  
  280.     Kermit-11>@dev:KRT.INI
  281.  
  282. SHOW FILE to check the name of the init file Kermit-11 used at start-up.
  283.  
  284.  
  285. Installation and Release Notes    KRT V03.63            Page Six
  286.  
  287.  
  288.                 R T - 1 1
  289.                 ---------
  290.  
  291. The RT-11 FB,XB,XM,ZB,ZM monitors must include .SPCPS support if you want
  292. ^C to abort anything in the program without actually stopping the program
  293. itself.  If KRT is not the only job running it should be FRUNed to ensure
  294. it will be able to process incoming data from the remote system.  RT-11SB
  295. and SJ must be sysgenned for .mrkt and .twait (TIMER) support.
  296.  
  297. If you are using RT-11 V4, the ONLY monitor which can run KRT is RT-11FB.
  298.  
  299. SET USR SWAP if it is not already there, this program needs the space.
  300.  
  301. RT-11 multi-terminal support has been pulled to keep the size reasonable.
  302. Only a handler, or the controlling terminal line, may be used to exchange
  303. files with the outside world.  Use XL with RT-11, XC with PRO/RT.  KM may
  304. be used with either, it adds speed fallback and support for TSX functions
  305. that make life with Kermit more enjoyable.
  306.  
  307. As distributed KRTTSX has just enough buffer to load the KM handler built
  308. for a DLV11-E in a PDP-11 system.  This may be altered by the extend size
  309. (octal number of bytes) specified in KRTLNK.COM:
  310.  
  311. krttsx,krttsx=krtxm/t/e:3010//    ! APR0, the root   extending HNBUFF
  312.  
  313. WARNING:   Because it's impossible to bomb an outstanding read completion
  314. routine once KM/XC/XL has been assigned the link the only way to deassign
  315. it is to exit Kermit.
  316.  
  317. WARNING:   Any SET from KMON on KM/XC/XL while its interrupts are enabled
  318. will OVERWRITE THE QUEUE and hose any data then in it.
  319.  
  320. Note XC/XL is NOT an eight-bit device thus Kermit's parity will be forced
  321. to SPACE under RT-11.  If you have hacked it into handling 8-bits you may
  322. SET PARITY NONE either in the init file or from the keyboard after Kermit
  323. is running and AFTER you have SET LINE XL or XC.
  324.  
  325. HANGUP (DTR control) isn't available unless XL is from RT-11 V5.2 and up,
  326. or the KM handler is used.
  327.  
  328. To use a handler, you must have an DL-11/DLV-11 interface (in addition to
  329. the console interface).  The XL handler supports two DCL commands:
  330.  
  331.         .SET XL CSR=n
  332.         .SET XL VECTOR=m
  333.  
  334. Where "n" is the address of the CSR (control status register)  and "m" is
  335. the  interrupt  vector address.  The defaults are 176500 for the CSR, and
  336. 300 for the interrupt vector.  The DLV-11 speed is set with wire wrapping
  337. and it's not settable on the XL handler.  If you have a DLV-11E XL may be
  338. built with XL$DVE=1 and the speed set from KMON as with XC.
  339.  
  340.  
  341. Installation and Release Notes    KRT V03.63            Page Seven
  342.  
  343.  
  344. The XC handler is a special version of XL for the PRO/300 series, its CSR
  345. is 173300 and vector is 210(8).  You must SET XC SPEED=nn from KMON prior
  346. to running  Kermit  to  change XC's 1200 baud default.  You may also need
  347. to UNLOAD XC before Kermit can be FRUN:
  348.  
  349.     .UNLOAD XC
  350.     .FRUN KRTTSX.SAV/PAUSE
  351.     .LOAD XC=KRTTSX
  352.     .RESUME
  353.  
  354. Also, when running in the foreground
  355.  
  356.         Kermit-11>SET TT QUIET
  357.  
  358. allows one to work in the background during file transfers.
  359.  
  360.    To operate properly at high speeds (2400 and up) and with Kermits
  361.    not supporting XOFF flow control the XL or XC device handler MUST
  362.    be modified to increase the internal buffer size and repress XOFF
  363.    transmission within a packet.  This is very easy to do.
  364.  
  365.    First copy XM.MAC, XL.MAC, XM.ANS, SYSGEN.COM and for the PRO/300
  366.    series XC.MAC from the RT-11  distribution  to DK, ASSIGN DK SRC,
  367.    and then in the copy of the file XL.MAC change the line:
  368.  
  369.     from:    BUFSIZ    = 64.
  370.     to:    BUFSIZ    = 256.
  371.  
  372.    Then IND SYSGEN and tell it to use the saved answer file XM.ANS.
  373.    When SYSGEN exits, it  will  have created, among other things, a
  374.    file called XM.CND which is needed for the driver assembly.  For
  375.    the PRO/300 series substitute XC for XL in the following command
  376.    procedure to build the handler:
  377.  
  378.     .COPY SY:XLX.SYS SY:XLX.OLD        ! save a copy
  379.     .REN/NOPRO SY:XLX.SYS SY:XLX.SYS    ! unprotect file
  380.     .UNLOAD XL                ! unload handler
  381.     .REMOVE XL                ! and remove it
  382.     .MACRO/OBJ:XLX (XM,XM.CND,XL)        ! assemble new
  383.     .LINK/EXE:SY:XLX.SYS XLX        ! RT V4, handler on SY
  384.     .LINK/NOBIT/EXE:SY:XLX.SYS XLX        ! if RT V5, do this
  385.     .INSTALL XL                ! install it and
  386.     .LOAD XL                ! load into memory
  387.  
  388. Last, but not least, if there is no way to get an  additional  interface
  389. into your system (perhaps you have a four slot Q-bus backplane), you can
  390. force Kermit to use the console.  This implies, of course, that it won't
  391. be possible to dial out from the RT-11 system - it may only be used with
  392. the remote Kermit connected via the console port.  Kermit-11 defaults to
  393. TT as its link device and sets the packet length to 60 bytes.  Otherwise
  394. the command
  395.  
  396.         Kermit-11>SET LINE TT
  397.  
  398. does the same thing.  You may increase the packet size if larger packets
  399. will work, or modify RT-11's default SPACE parity, AFTER the SET LINE is
  400. done.
  401.  
  402.  
  403. Installation and Release Notes    KRT V03.63            Page Eight
  404.  
  405.  
  406.             The KM Handler
  407.  
  408. KM is a "Kermit Modem" communications handler provided to support
  409. TSX-Plus features not otherwise available under RT-11, as well as
  410. older releases of TSX that preceded its CL handler.   KM combines
  411. the best of both worlds, including the following under RT-11:
  412.  
  413.     o  Works with DL(V), Falcon and PRO serial interfaces
  414.     o  Speed may be SET and SHOWn from within Kermit
  415.     o  Automatic fallback to the connected speed
  416.     o  An eight-bit data path
  417.     o  Selectable hardware (RTS/CTS) flow control
  418.     o  Emulation of TSX's CLCLR (flush pending I/O)
  419.     o  DTR toggling to support Kermit's HANGUP command
  420.     o  Usable with RT-11 V4.0 and up, and TSX-Plus V5.0 and up
  421.  
  422. To use KM you must first edit the appropriate conditional assembly
  423. files for the serial line interface in your system:
  424.  
  425.     KRTSJ .CND  -  for RT-11FB, RT-11SB, and RT-11SJ
  426.     KRTXM .CND  -  for RT-11XB, RT-11XM, RT-11ZB and RT-11ZM
  427.     KRTTSX.CND  -  for TSX-Plus
  428.  
  429. Then assemble and link using KRTSYS.COM if being done under RT-11
  430. V5.0 or above, or KRTSV4.COM if using any RT-11 V4 release.  This
  431. will create KM.SYS, KMX.SYS and KM.TSX, which should be copied to
  432. your system device (SY) where they may be INSTALLed and LOADed as
  433. needed.  Note that KRTKM.MAC (the handler source file) must be on
  434. the default disk for this assembly.  Under TSX you'll have to use
  435. TSXMOD to add a definition for KM as shown below, or define it in
  436. TSGEN.MAC and rebuild the system.  In either case you must reboot
  437. as it only loads handlers when started.  KM may be mapped to save
  438. low memory:
  439.  
  440.     DEVDEF    <KM>,MAPH
  441.  
  442. To build KM under RT-11 V5 (KRTSYS.COM):
  443. MAC/OBJ:KM KRTSJ.CND+KRTKM
  444. LINK/NOBIT/EXE:KM.SYS KM
  445. MAC/OBJ:KMX KRTXM.CND+KRTKM
  446. LINK/NOBIT/EXE:KMX.SYS KMX
  447. MAC/OBJ:KMTSX KRTTSX.CND+KRTKM
  448. LINK/NOBIT/EXE:KM.TSX KMTSX
  449.  
  450. To build KM under RT-11 V4 (KRTSV4.COM):
  451. MAC/OBJ:KM KRTSJ.CND+KRTKM    ! KRT will only run under RT-11FB if V4
  452. LINK/EXE:KM.SYS KM
  453. MAC/OBJ:KMTSX KMTSX.CND+KRTKM
  454. LINK/EXE:KM.TSX KMTSX
  455.  
  456. NOTE:  Comments must be stripped to run these command files under RT-11.
  457.  
  458.  
  459. Installation and Release Notes    KRT V03.63            Page Nine
  460.  
  461.  
  462. KM supports the following SET commands from the monitor (KMON):
  463.  
  464.     SET KM CSR=octal-address    ! except on the PRO for
  465.     SET KM VECTOR=octal-address    ! which these are fixed
  466.  
  467. Hardware flow control REQUIRES pins 4 and 5 be carried through in
  468. the modem cable, 4 to 4 (RTS) and 5 to 5 (CTS), DTE (the port) to
  469. DCE (the modem), in addition to those otherwise normally present.
  470.  
  471. The port should be set up for 8 data bits and NO parity as Kermit
  472. does parity in software.
  473.  
  474. WARNING:  If the interface provides selectable interrupt priority
  475. and your max speed will be greater than 4800 you will likely have
  476. to use BIRQ 5 to avoid dropping chars.
  477.  
  478. NOTE:  This handler does NOT support VTCOM, nor is it intended to
  479. be used with anything other than KRT V03.62 or future releases.
  480.  
  481. WARNING:  Because it's  impossible  to  bomb  an outstanding read
  482. completion routine once KM has been assigned the  link  the  only
  483. way to deassign KM is to exit Kermit.
  484.  
  485. See the top of KRTKM.MAC for detailed installation instructions.
  486.  
  487.  
  488. Installation and Release Notes    KRT V03.63            Page Ten
  489.  
  490.  
  491.                 T S X - P l u s
  492.                 ---------------
  493.  
  494. One may communicate via TT when calling in,  and  use CL0 to CL7, KM or XL
  495. when calling out.  The CL handler is suggested as it's more efficient with
  496. TSX-Plus.  See HELP SET CL for details.   On PRO/300 series systems Kermit
  497. will try to assign CL0 or CL1 to TSX Line #3 at startup.
  498.  
  499. If there is any chance of swapping on your system use TSX's MEMLOCK option
  500. when running the program.  This is easily done via the INSTALL facility.
  501.  
  502. WARNING:  If you build XL with XL$DVE (set speed) enabled be advised under
  503.   TSX-Plus (as of V6.5) the KMON command SET XL SPEED=nnnn will modify the
  504.   hardware port which XL is serving instead of the handler itself and thus
  505.   fail to produce the expected result.  And regardless, if you must use XL
  506.   see HELP INSTALL RT-11 regarding this handler's limitations.  Mapping it
  507.   is recommended to save low memory.
  508.  
  509. KRTTSX uses  208.  blocks  in the  TSX  PLAS  swap file.  The TSGEN/TSXMOD
  510. parameter  determining  its size is SEGBLK.  If modified, TSX must then be
  511. restarted to create the new swap file.
  512.  
  513. In the CONNECT mode 11.  activation  characters  are declared so the TSGEN
  514. parameter MXSPAC must be => 11.
  515.  
  516. Under TSX one must SET IO ABORT so errors won't cause waits for the I/O to
  517. rundown.  In  TSGEN  this may be accomplished by making IOABT = 1.  It may
  518. also be done as a keyboard command.
  519.  
  520. XOFF operation without dropping characters in the CONNECT mode at 2400 and
  521. up may require enlarging TSX's silo and input buffer on lines to which the
  522. CL units are attached.
  523.  
  524.     BUFSIZ    1024.,1024.
  525.     SILO    255.,64.,16.
  526.  
  527. in the LINDEF does the job though this is a bit big if 2400 is the fastest
  528. speed used.  Kermit also can raise its priority when actually talking to a
  529. CL unit so as not to drop chars at high speeds, see HELP SET CL.
  530.  
  531. The above also applies to file transfers via the controlling terminal line
  532. (TT).   When sending to a TSX system you may also need to set its priority
  533. below any other interactive job and use TSX's /HIGHEFF switch when running
  534. Kermit-11 to avoid excessive degradation of response time for other users.
  535. This is due to the overhead involved in processing input by TSX's terminal
  536. handler, and is not a problem when sending output from a TSX system.  Note
  537. this only concerns I/O via TT - comm handlers (CL, XL, etc) are no problem
  538. in either direction.
  539.  
  540. Binary file transfers  via  TT  might require you to SET TT 8BIT.  You may
  541. also need to SET TT BITS=8 but this is a hardware function and thus should
  542. ONLY be done from a primary line first, before any subprocess that may run
  543. Kermit is spawned.  Setting this via a subprocess may write garbage in the
  544. line-parameters word.
  545.  
  546. TERMINAL privilege is required to assign a CL unit to a time-sharing line.
  547.  
  548. Modem control is an extremely significant system security issue under TSX.
  549. The problem is if a dial-in user's phone connection fails that job must be
  550.  
  551.  
  552. Installation and Release Notes    KRT V03.63            Page Eleven
  553.  
  554.  
  555. killed before a following call can be answered and connected to it, and to
  556. the still-logged-on session of the previous caller.
  557.  
  558. Beginning with V6.4 TSX was given improved modem control, with which these
  559. "tailgating" incidents are easily prevented.  The following parameters are
  560. suggested for MNP/V.42 auto-answer operation (modem time-out = 40 secs):
  561.  
  562. .SH MODEM
  563. PHONE=1    Other modem control parameters (in 0.5 sec):
  564.  ONTIM=80 OFFTIM=1 TIMIN=80 TIMLOC=1 TIMOUT=1
  565.  
  566. When no error correction is in use, ONTIM and TIMIN may be halved, and the
  567. modem's wait time for carrier (S7 register in Hayes-style units) set to 20
  568. seconds.  If the modem's wait time is not settable such that it's restored
  569. when reset (ala ATZ), then ONTIM and TIMIN must be set to match the modem.
  570. OFFTIM, TIMLOC and TIMOUT must = 1 (the minimum, don't use zero) to ensure
  571. the job is logged off immediately.  The $PHONE flag must be defined in the
  572. LINDEF (in TSGEN.MAC) for any line connected to an auto-answer modem.
  573.  
  574. One then includes this in the start-up command files for "phone" lines:
  575.  
  576. SET ERROR FATAL
  577. !ACCESS SY:CLEAR.COM/READ        ! add if other access limited here
  578. SET LOGOFF FILE=SY:CLEAR.COM        ! add this..
  579. SET TT 8BIT,BITS=8            ! ..and this for Kermit
  580. ...                    ! other necessary items
  581. R LOGON
  582.  
  583. and CLEAR.COM contains:
  584.  
  585. SET ERROR NONE
  586. SET PRIO 70                ! be sure this runs before next call
  587. SET TT NOPAGE,NODTR,PHONE,AUTO,XON
  588. ...                    ! anything else needed should follow
  589.  
  590. This may seem a bit extreme on the SET TT end of things, but it definitely
  591. gets the job done, even after in and out buffers are overflowed, XOFF'd in
  592. both directions (deadlocked) and the caller has to hang up.  The rationale
  593. for the various options used above is:
  594.  
  595.     NOPAGE    ensures possible noise induced XOFF on DTR drop is harmless
  596.     NODTR    resets the modem
  597.     PHONE    ensures port is not in local mode, just in case..
  598.     AUTO    ensures port not stuck at any particular speed
  599.     XON    resets any XOFF which may have snuck through..
  600.  
  601. Note that TERMINAL privilege is required for the above to drop DTR.  As of
  602. TSX V6.5 installing a .COM file with TERM privilege doesn't work, the user
  603. must be given it or DTR will not be dropped and the phone line may not get
  604. hung up.
  605.  
  606. If your version of TSX-Plus is earlier than 6.4 and you must allow dial-in
  607. operation there is a program named NOTAIL which runs as a detached job and
  608. provides the same protection against tailgating.  See KRTAIL.MAC, included
  609. with this Kermit's distribution.
  610.  
  611.  
  612. Installation and Release Notes    KRT V03.63            Page Twelve
  613.  
  614.  
  615. It's also a good idea when using a Hayes-style modem to disable its escape
  616. character means of invoking the modem's command mode.  If one phones in to
  617. a TSX system and then uses another line on it to call out or talks to some
  618. one such that the other person's data are going into the modem (the one at
  619. the TSX system, to which your local system is connected) via its DCE port,
  620. there's no other way to prevent someone from using the escape sequence and
  621. taking control of that modem, after which they've got your phone line..
  622.  
  623.  
  624. Installation and Release Notes    KRT V03.63            Page Thirteen
  625.  
  626.  
  627.                 M O D E M S
  628.                 -----------
  629.  
  630. Generally, connecting a modem requires an appropriate interface such
  631. as a DL-11E, which supports DTR and software speed selection.  It is
  632. possible to get by without such things, however (and particularly on
  633. TSX) this may pose a security risk in that the system has no control
  634. signals with which to log out a disconnected job.
  635.  
  636. Keeping the above in mind, note that if your modem requires  DTR  to
  637. be present, you must use an interface that asserts it, force it high
  638. internally in the modem, or build a cable to force it high.  Without
  639. an appropriate interface HANGUP will not function and TSX is open to
  640. serious security problems if incoming calls are allowed.
  641.  
  642.  WARNING:  If the interface provides selectable interrupt priority
  643.  and your max speed will be greater than 4800 you will likely have
  644.  to use BIRQ 5 to avoid dropping chars.  The port should be set up
  645.  for 8 data bits and NO parity as Kermit does parity in software.
  646.  
  647. The modem cable must at a minimum carry through pins 2 and 3 (data),
  648. 7 (ground), 8 (DCD) and 20 (DTR).  Under TSX the modem may be set to
  649. answer the line (pin 22, the ring indicator, must also be connected)
  650. then when Kermit is started if a CL unit is attached to the line and
  651. a modem set Kermit retains control of it all until dropping the line
  652. or exiting the program,  when the modem and line will be restored to
  653. their idle (auto-answer) state.
  654.  
  655. The SET MODEM command is used to establish the type of modem you are
  656. using for the DIAL command.  Enter SET MODEM ? for a current list of
  657. of pre-defined modem types.  See HELP SET DIAL for information about
  658. entering a USER-DEFINED modem structure.
  659.  
  660. This Kermit is capable of matching the DTE (system) speed to that of
  661. the DCE (modem) in response to a message by the modem (CONNECT nnnn)
  662. only if using the CL or KM handler.  Currently the generic Hayes and
  663. Telebit T2500/T3000 modem definitions support this.  Under XL/XC the
  664. speed can't be changed after Kermit is running, it must be done from
  665. the monitor first otherwise the queue will be lost.  The DCE must be
  666. locked to the same speed, which must be at least the highest desired
  667. carrier speed.  The MNP and V.42 versions of the above support this.
  668. If this is not suitable, a USER-DEFINED modem structure may be used.
  669.  
  670. Be aware that file transfers FROM this Kermit via a modem who's DTE
  671. speed is greater than the connected speed (with the distant system)
  672. will require XOFF flow control, and servicing the interrupts caused
  673. by it may substantially increase the cpu's loading.  If the maximum
  674. connected speed possible is 2400 or less, dropping the DTE speed to
  675. 9600 (when same must be locked for MNP/V.42) is a good idea.  Using
  676. the KM handler's hardware flow control is another option.
  677.  
  678. NOTE:  This program toggles DTR to reset the modem thus this option
  679. must be enabled as part of the modem's default configuration.
  680.  
  681.  The following examples have been taken from actual daily use with
  682.  this program to both dial in and out under TSX-Plus.  Note the S7
  683.  register (wait time to connect) is set to 255 when Kermit inits a
  684.  modem to dial out so Kermit's SET DIAL TIME-OUT takes precedence.
  685.  
  686.  
  687. Installation and Release Notes    KRT V03.63            Page Fourteen
  688.  
  689.  
  690.     Anchor Automation "Signalman Lightning 24" Model MK24:
  691.  
  692.                CONFIGURATION
  693.  
  694.   S00=002    S01=000    S02=128    S03=013  NOTE: S0=2 here because this
  695.   S04=010    S05=008    S06=002    S07=020  modem occasionally glitches
  696.   S08=002    S09=006    S10=005    S11=040  DCD when answering the first
  697.   S12=050    S13=000    S14=044    S15=000  ring, which TSX will catch &
  698.   S16=000    S17=000    S18=000    S19=000  then hang up on when it's not
  699.   S20=000    S21=016    S22=118    S23=054  there 0.5 sec later..
  700.   S24=000    S25=005    S26=000    S27=000
  701.   S28=000    S29=000    S30=000    S31=255
  702.   S32=001    S33=000    S34=000    S35=001
  703.  
  704.   B=0  Y=0  &M=0   &D=2   &C=1  &J=0  &T=0
  705.   X=4  M=1   F=1    E=0    Q=1   V=1
  706.  
  707.   DIAL=TONE    SPEED=2400     PARITY=NONE
  708.  
  709.   The Anchor modem will save all of the above, including its "S" registers
  710.   in RAM (backed up with a lithium battery), via AT&W.  Then one need only
  711.   send ATZ to restore its auto-answer operation, which this Kermit will do
  712.   when exiting.  SET PHONE XMODE 4 for all result codes, and use the HAYES
  713.   modem type (SET MODEM HAYES).  Note that because this modem restores its
  714.   time-out (S7) when reset it is set to 20 secs for answering which allows
  715.   for a more timely response following a failed call.  If using MNP modems
  716.   on the same system, S7 should be set to 40 seconds.  If you have the MNP
  717.   model of this modem, stick with the HAYES definition as there is not any
  718.   provision for locking the DTE speed.
  719.  
  720.   Configuration switches:
  721.  
  722.   1 - as req'd, ON for RJ-12/13 busy support
  723.   2 - ON   DCD/DSR follow detected carrier signal
  724.   3 - ON   DTR from the computer controls modem (manual says OFF, in error..)
  725.   4 - OFF  remote digital loopback
  726.   5 - OFF  enables command recognition by modem
  727.   6 - OFF  no CTS support
  728.   7 - unused
  729.   8 - unused
  730.  
  731.  
  732. Installation and Release Notes    KRT V03.63            Page Fifteen
  733.  
  734.  
  735.             Telebit T2500/T3000 Modems
  736.  
  737. Three Telebit T2500 definitions are provided.  T2500 is intended for
  738. use without MNP or V.42 LAP-M error correction.  It uses the modem's
  739. connect messages to match the DTE speed to that of the data path and
  740. that requires using either the CL or KM handler.  Set up the T2500's
  741. default profile in the "enhanced" command mode as shown below:
  742.  
  743.  E0 F1 M0 Q3 T V1 W1 X3 Y0 &P0 &T5     Version GF7.00-T2500SA
  744.  S00:001 S01=000 S02:128 S03=013 S04=010 S05=008 S06=002 S07=040 S08=002
  745.  S09=006
  746.  S10=007 S11:050 S12=050 S18=000 S25=005 S26=000 S38=000
  747.  S41=000 S45=000 S47=004 S48:001 S49=000
  748.  S50=000 S51=255 S52:002 S54:002 S55=000 S56=017 S57=019 S58=003 S59=000
  749.  S61=150 S62=003 S63=001 S64=000 S65=000 S66=000 S67=000 S68=255 S69=000
  750.  S90=000 S91=000 S92=000 S93=008 S94=001 S95=000 S96=001 S97=000 S98=003
  751.  S100=000 S101=000 S102=000 S104=000 S105=001 S106=000 S107=020
  752.  S110=255 S111=255 S112=001
  753.  S121=000 S130=002 S131:001
  754.  S150=000 S151=004 S152=001 S153=001 S154=000 S155=000 S157=000 S158=000
  755.  S160=010 S161=020 S162=002 S163=003 S164=007 S169=000 S255=000
  756.  
  757. Then, when MNP operation is desired, set the DTE port (via SET SPEED
  758. if using TSX's CL handler) to 9600 or 19.2kb if your cpu can keep up
  759. with it, then SET MODEM T2500MNP.  This enables MNP only as attempts
  760. at a V.42 connection first with some MNP modems appear to leave them
  761. in a state where nothing following works.  When an MNP link can't be
  762. established operation falls back to the normal mode.
  763.  
  764. V.42 and LAP-M facilities are enabled by setting the modem T2500V.42
  765. which operation is just like that of the MNP only above, except V.42
  766. is tried first, then MNP, and then normal operation if an error free
  767. path can not be established.  Negotiation of these protocols can add
  768. considerably to the time needed to connect.
  769.  
  770. All of this should be done on the same  default  profile with which
  771. the modem will  automatically  answer  incoming calls to ensure the
  772. modem will be properly reset to  its auto-answer state when exiting
  773. Kermit-11 to the monitor.  The "enhanced" command mode is suggested
  774. because the "conventional" mode does not allow XOFF flow control in
  775. the command mode.  While this is not normally a problem with result
  776. messages it does make listing the modem's status impossible at high
  777. speeds.
  778.  
  779.  
  780. Installation and Release Notes    KRT V03.63            Page Sixteen
  781.  
  782.  
  783. Under RT-11 either the T2500MNP to T2500V.42 definitions may be used
  784. to work around XL/XC's inability to modify its speed as is necessary
  785. for the T2500.  Both will connect normally if error correction isn't
  786. supported by the remote system.  The KM handler may also be used.
  787.  
  788. SET PHONE XMODE 3 to enable all possible result messages, or use 14
  789. if you prefer to force display of the carrier speed and protocol in
  790. all cases, even when an error correcting path is not established.
  791.  
  792. If by accident the modem is sent something at an unwanted speed and
  793. becomes stuck there, toggle DTR (HANGUP or SET DTR) to reset it.
  794.  
  795. If you are using PEP/MNP/V.42 Telebit's Kermit protocol spoofing is
  796. the fastest of all possible options even though it only uses normal
  797. 94 byte packets between modems.  It is set in the above to run when
  798. requested by the other end.  To force it on first SHO LINE to check
  799. the DTE speed (if a fallback speed is shown then one must first SET
  800. SPEED 9600 or 19200 if using a mode where the DTE speed is locked),
  801. then CONNECT and issue the command ATS111=n, when "n" is one of:
  802.  
  803.         0    No protocol supported
  804.         10   Kermit protocol with no parity
  805.         11   Kermit and odd parity
  806.         12   Kermit and even parity
  807.         13   Kermit and mark parity
  808.         14   Kermit and space parity
  809.         20   XMODEM/YMODEM protocol
  810.         255  Use protocol specified by other end
  811.  
  812. Then, disable long packets (SET NOLONG will suffice), so the modems
  813. run most efficiently, and proceed with the transaction.
  814.  
  815.  
  816.                 Telebit T3000
  817.  
  818. Three Telebit T3000 definitions are provided.  T3000 is for disabling
  819. MNP/V.42 error correction.  It checks the modem's connect messages to
  820. match the DTE speed to that of the carrier.  T3000V.42 enables V.42 &
  821. MNP modes and locks the speed.  Set up the T3000's defaults as listed
  822. below.  This definition  (T3000V.42)  is for use with hardware  (RTS)
  823. flow control.  This is ONLY available under the KM handler, where you
  824. have an option to SET FLOW-CONTROL RTS before setting the modem-type.
  825.  
  826. WorldBlazer - SA - Version LA5.00W- Configuration A
  827.  B1  E0  L1  M0  Q1  T   V1  X12  Y0
  828. &C1 &D2 &G0 &J0 &L0 &Q0 &R3 &S0 &T5 &X0
  829. S000=0   S001=0   S002:0   S003=13  S004=10  S005=8   S006=2   S007:255
  830. S008=2   S009=6   S010=14  S011=70  S012=50  S018=0   S025=5   S026=1
  831. S038=0   S041=0   S045=0   S046=0   S047=4   S048:1   S050=0   S051=255
  832. S056=17  S057=19  S058:2   S059:15  S060=0   S061:0   S062=15  S063:1
  833. S064=0   S068=255 S069=0   S090=0   S092=0   S093=8   S094=1   S100=0
  834. S104=0   S105=1   S111=255 S112=1   S151=4   S155=0   S180=2   S181=1
  835. S183=25  S190=1   S191=7   S253=10
  836.  
  837.  
  838. Installation and Release Notes    KRT V03.63            Page Seventeen
  839.  
  840.  
  841. The T3000 does NOT do XOFF flow control in the command mode even when
  842. it's enabled and functioning for data between modems unless S48=0 and
  843. this of course kills an 8-bit data path.  A third modem definition is
  844. provided (T3000X.42) which enables XOFF rtesraint - Kermit quotes the
  845. 8-bit counterparts of XOFF and XON so this will only be a problem for
  846. binary data transfers using the Xmodem protocol.  This defintion will
  847. force S48 to 0 and enable XOFF restraint when initializing the modem.
  848.  
  849.  
  850.                    US Robotics "Courier" 2400/2400e
  851.  
  852.   C1  E0  F1  M1  Q1  V1  X6
  853.   BAUD=02400  PARITY=N  WORDLEN=8
  854.   DIAL=HUNT   ON HOOK  TIMER
  855.  
  856.   &A1  &B0  &H0  &I0  &M0
  857.   &N0  &R1  &S0  &Y1
  858.  
  859.   S00=001  S01=000  S02=043  S03=013
  860.   S04=010  S05=008  S06=002  S07=030
  861.   S08=002  S09=006  S10=007  S11=070
  862.   S12=050  S13=032  S14=252  S15=000
  863.   S16=000  S17=000  S18=000  S19=000
  864.   S20=000
  865.  
  866.   Configuration switches:
  867.  
  868.    1 - UP    DTR controls modem
  869.    2 - UP    verbal result messages
  870.    3 - UP    quiet mode, for auto-answer
  871.    4 - DOWN  don't echo local commands, for auto-answer
  872.    5 - UP    enable auto-answer, modem answers on the first ring
  873.    6 - UP    DCD on pin 8 follows action of received carrier
  874.    7 - as req'd, DOWN for RJ-12/13 busy support
  875.    8 - UP    to recognize "AT" command set
  876.    9 - UP    drop phone connection when escape code received
  877.   10 - UP    load power-on defaults from NVRAM
  878.   QUAD - as req'd for your system and modem cable..
  879.  
  880. Use the Hayes modem type (SET MODEM HAYES).  Set the "&" registers per
  881. the above and save them with AT&W.  The "S" registers aren't preserved
  882. so ONTIM and TIMIN must = 60. (TSGEN.MAC)  if incoming calls are being
  883. accepted (auto-answer enabled) under TSX-Plus.  If wish to use the MNP
  884. version, lock the DTE speed as desired to at least 4800 (AT&B5&W) then
  885. SET MODEM Hayes-MNP.
  886.  
  887. US Robotics modems such as the Courier 2400 or 2400e will occasionally
  888. glitch when answering the phone and start a TSX port at 19.2kb instead
  889. of 2400.  This is more likely to happen when the modem is not properly
  890. cooled.  Replacing its rubber feet with some that hold it higher above
  891. the surface on which it resides may help.  Setting the modem to answer
  892. after the first ring (that is, on the second) may also help.  Starting
  893. with TSX V6.5, 2400 is tried first, before 19200, which also may help.
  894.  
  895. SET PHONE XMODE 6 enables all possible result messages from the modem.
  896.  
  897.  
  898. Installation and Release Notes    KRT V03.63            Page Eighteen
  899.  
  900.  
  901.         U S E R - D E F I N E D   M O D E M
  902.         -----------------------   ---------
  903.  
  904. Kermit-11 contains operating parameters for several of the more common
  905. auto-dial modems.  To find out if your modem is directly supported use
  906. the SET MODEM ? command.  If it is not, you'll need to use SET DIAL to
  907. load the data used to control the modem and implement the various DIAL
  908. routines.  These involve formatting commands to the modem, and what to
  909. expect in the way of modem responses.  As an example the Vadic VA212PA
  910. modem is awakened from an idle state by the character sequence (octal)
  911.  
  912.     005 015
  913.  
  914. which is Ctrl-E followed by carriage return.  The modem responds with
  915.  
  916.     HELLO: I'M READY
  917.     *
  918.  
  919. Thus Kermit needs to know when it sends the wakeup sequence it should
  920. wait for the asterisk to be returned by the modem, after which it may
  921. presumed the modem is awaiting further commands, such as that to dial
  922. a phone number.
  923.  
  924. Suppose we had to tell Kermit about the Racal Vadic VA212PA (though in
  925. reality Kermit already knows this modem).  Checking the owner's manual
  926. for it, we find that:
  927.  
  928.      To wake the modem up, we type a Ctrl-E followed by a return.
  929.  
  930.      To dial a number, we type the letter D  followed by a return.  At
  931.      this point, the modem prints a NUMBER? prompt and we then type in
  932.      the desired number.  The number  is  then reprinted and the modem
  933.      waits for a return from us to confirm it's correct.
  934.  
  935.      When it completes dialing it will print "ON LINE" or "ONLINE" for
  936.      a successful call, otherwise it may return "BUSY", "FAILED CALL",
  937.      "NO DIAL",  "VOICE"  or  "TIME OUT".  While it is waiting for its
  938.      call to be answered it may print the line "RINGING" several times
  939.      to tell you it is working on the call.
  940.  
  941. The Kermit commands required would be:
  942.  
  943.     Kermit-11>SET DIAL WAKE-STRING \005\015
  944.     Kermit-11>SET DIAL ECHO
  945.     Kermit-11>SET DIAL WAKE-ACK *
  946.     Kermit-11>SET DIAL INITIATE D\015
  947.     Kermit-11>SET DIAL FORMAT %P%S\015
  948.     Kermit-11>SET DIAL DIAL-PAUSE 9K
  949.     Kermit-11>SET DIAL CONFIRM \015
  950.     Kermit-11>SET DIAL SUCCESS ONLINE
  951.     Kermit-11>SET DIAL SUCCESS ON LINE
  952.     Kermit-11>SET DIAL RINGING RINGING
  953.     Kermit-11>SET DIAL FAILURE BUSY
  954.     Kermit-11>SET DIAL FAILURE FAILED CALL
  955.     Kermit-11>SET DIAL FAILURE NO DIAL
  956.     Kermit-11>SET DIAL FAILURE TIME OUT
  957.     Kermit-11>SET DIAL FAILURE VOICE
  958.  
  959.  
  960. Installation and Release Notes    KRT V03.63            Page Nineteen
  961.  
  962.  
  963. The notation "\005\015" indicates a Ctrl-E followed by a return.  5 is
  964. octal for Ctrl-E,  15 is octal for return.   Octal numbers may also be
  965. specified by placing the value inside of  inequality  characters as in
  966. SET DIAL WAKE <005><015> though the former is preferred.  Octal values
  967. may be obtained from HELP ASCII.  If for any reason you need to pass a
  968. "\" or "<" to your modem, simply prefix the character with another "\"
  969. or "<" as in "\\" or "<<".
  970.  
  971. "%P%S\015" indicates the phone number from the  DIAL  command is to be
  972. followed by a return.  "%S" is  a format effector for the phone number
  973. string itself,  which causes it to be inserted in the dial string sent
  974. to the modem.   "%P" inserts the dial pause string, as in this case we
  975. need to dial 9 and wait for a second dial tone.  The "K" is the  Racal
  976. Vadic  code to get the modem to pause.  If you are dialing on a direct
  977. line or your modem supports pausing via something embedded in the dial
  978. string itself, the DIAL-PAUSE command is unneeded.
  979.  
  980. Many modems require only WAKEUP, WAKE-ACK, FORMAT and result strings.
  981. The Digital DF112 is a good example.  Its definition would look like:
  982.  
  983.     Kermit-11>SET DIAL WAKEUP \002
  984.     Kermit-11>SET DIAL WAKE-ACK READY
  985.     Kermit-11>SET DIAL FORMAT %S#
  986.     Kermit-11>SET DIAL SUCCESS ATTACHED
  987.     Kermit-11>SET DIAL FAILURE BUSY
  988.     Kermit-11>SET DIAL FAILURE DISCONNECTED
  989.     Kermit-11>SET DIAL FAILURE ERROR
  990.     Kermit-11>SET DIAL FAILURE NO ANSWER
  991.  
  992. Any undefined result string is considered informational only thus this
  993. class of response does not need to be expressly defined.
  994.  
  995. If you are using a "Hayes" style modem, its extended response mode may
  996. be set by using the %X format effector in the WAKE-STRING.  The number
  997. desired is then specified by SET PHONE XMODE n, where n is 0 to 14, or
  998. "OFF" to disable it.  %X may also be used in the FORMAT (dial) string,
  999. allowing modification without re-initializing the modem.
  1000.  
  1001. Here's a sample Hayes definition:
  1002.  
  1003.     Kermit-11>SET PHONE TONE,XMODE 4
  1004.     Kermit-11>SET DIAL COMMENT Generic Hayes Command Set
  1005.     Kermit-11>SET DIAL TIME-OUT 45
  1006.     Kermit-11>SET DIAL WAKE-ACK OK
  1007.     Kermit-11>SET DIAL WAKE-STRING AT E1 Q0 V1 S0=0 S7=255 %X \015
  1008.     Kermit-11>SET DIAL ECHO
  1009.     Kermit-11>SET DIAL INIT-ONCE
  1010.     Kermit-11>SET DIAL FORMAT AT %X %A D%M %S \015
  1011.     Kermit-11>SET DIAL ABORT \015
  1012.     Kermit-11>SET DIAL CON19200 CONNECT 19200
  1013.     Kermit-11>SET DIAL CON19200 CONNECT 14400
  1014.     Kermit-11>SET DIAL CON9600 CONNECT 9600    ; fallback only works with
  1015.     Kermit-11>SET DIAL CON4800 CONNECT 4800    ; the CL or KM handlers..
  1016.     Kermit-11>SET DIAL CON2400 CONNECT 2400
  1017.     Kermit-11>SET DIAL CON1200 CONNECT 1200
  1018.     Kermit-11>SET DIAL CON9600 CONNECT FAST
  1019.     Kermit-11>SET DIAL CON300 CONNECT       ; embedded, must be last!
  1020.  
  1021.  
  1022. Installation and Release Notes    KRT V03.63            Page Twenty
  1023.  
  1024.  
  1025.     Kermit-11>SET DIAL FAILURE BUSY
  1026.     Kermit-11>SET DIAL FAILURE ERROR
  1027.     Kermit-11>SET DIAL FAILURE NO ANSWER
  1028.     Kermit-11>SET DIAL FAILURE NO CARRIER
  1029.     Kermit-11>SET DIAL FAILURE NO DIALTONE
  1030.     Kermit-11>SET DIAL FAILURE NO DIAL TONE
  1031.     Kermit-11>SET DIAL FAILURE VOICE
  1032.     Kermit-11>SET DIAL RINGING RING        ; includes RINGING
  1033.     Kermit-11>SET DIAL RINGING RRING    ; Telebit style..
  1034.     Kermit-11>SET DIAL PULSE P
  1035.     Kermit-11>SET DIAL TONE T
  1036.     Kermit-11>SET DIAL ANSWER S0=1
  1037.     Kermit-11>SET DIAL NOANSWER S0=0
  1038.     Kermit-11>SET DIAL IDLE AT Z \015
  1039.  
  1040. Some modems are unable to accept data at the line speed, in which case
  1041. one must employ SET DIAL WAKE-RATE and SET DIAL DIAL-RATE.   These two
  1042. functions accept a delay time in clock ticks,  which  are 1/50 or 1/60
  1043. second units depending on where in the world this program is running.
  1044.  
  1045. If your modem has a settable timer it should be either disabled or set
  1046. to the maximum possible (example: the Hayes wakeup string contains S7=
  1047. 255) to allow Kermit-11's internal TIME-OUT to prevail.
  1048.  
  1049. If your modem hangs, see HELP SET DIAL SETTLE-TIME.  This and TIME-OUT
  1050. are two special parameters here in that they are global, and used even
  1051. with Kermit's internal modem definitions.  However, default values are
  1052. loaded by SET MODEM, thus these must be altered AFTERWARDS, except for
  1053. the USER-DEFINED modem where what is set BECOMES the default.  This is
  1054. also the case for SET PHONE XMODE.
  1055.  
  1056. NOTE:  This program toggles DTR to reset the modem thus the modem must
  1057. have this option enabled in its default configuration.
  1058.  
  1059. If the modem echoes command strings sent to it SET DIAL ECHO to enable
  1060. display of anything output by it.
  1061.  
  1062. Once all pertinent data have been entered, it is then necessary to SET
  1063. Kermit's modem-type:
  1064.  
  1065.     Kermit-11>SET MODEM USER-DEFINED
  1066.  
  1067. If a line (and speed if necessary) has been previously set this causes
  1068. Kermit to try initializing the modem, the result of which is reported.
  1069. If successful, you may then use the DIAL command to call out.
  1070.  
  1071. SET DIAL -- Additional information is available on:
  1072.  
  1073.      ABORT             ANSWER            BINARY-RESPONSE   BLIND
  1074.      COMMENT           CON300            CON1200           CON2400
  1075.      CON4800           CON9600           CON19200          CON38400
  1076.      CONFIRM           CONFIRM-ACKNOWLEDGE                 DIAL-ACKNOWLEDGE
  1077.      DIAL-PAUSE        DIAL-RATE         ECHO              FAILURE
  1078.      FORMAT            Format-effectors  IDLE              Important-Notes!
  1079.      INITIATE          INITIATE-PROMPT   INIT-ONCE         NOANSWER
  1080.      NOBINARY-RESPONSE NOECHO            NOINIT-ONCE       PULSE
  1081.      RINGING           SETTLE-TIME       SUCCESS           TIME-OUT
  1082.      TONE              WAKE-ACKNOWLEDGE  WAKE-RATE         WAKE-STRING
  1083.  
  1084.  
  1085. Installation and Release Notes    KRT V03.63            Page TwentyOne
  1086.  
  1087.  
  1088. SET DIAL ABORT
  1089.  
  1090. Defines a string to force the modem to stop dialing.  This is passed
  1091. to the modem by the strike-any-key abort function of Kermit-11 while
  1092. waiting for a dialed  call  to complete.  Non-printing chars must be
  1093. specified in octal notation.
  1094.  
  1095.     Kermit-11>SET DIAL ABORT \003    ; use ^C to stop modem
  1096.  
  1097. SET DIAL ANSWER
  1098.  
  1099. Defines a string the %A format effector will insert in the dial FORMAT
  1100. string when it contains said %A effector and you have SET PHONE ANSWER
  1101. to allow answering a call back from a security modem requiring it.
  1102.  
  1103.     Kermit-11>SET DIAL ANSWER S0=1    ; Hayes does it thusly
  1104.  
  1105. SHOW MODEM to display its current setting and status.
  1106.  
  1107. SET DIAL BINARY-RESPONSE
  1108.  
  1109. If your modem responds with single character result messages (sans any
  1110. terminator ala a return) set this so Kermit will as well.  The default
  1111. may be restored with SET DIAL NOBINARY-RESPONSE, which enables testing
  1112. of strings of more than one character.
  1113.  
  1114. SET DIAL BLIND
  1115.  
  1116. Defines a string to force the modem to dial regardless of its detecting
  1117. a dial tone or recognizing tone dialing capability on the line.  Actual
  1118. use of this string in dialing is enabled by SET PHONE BLIND.
  1119.  
  1120.     Kermit-11>SET DIAL BLIND string
  1121.  
  1122. SET DIAL COMMENT
  1123.  
  1124. Specifies a brief description of the modem definition which is included
  1125. in the SHOW MODEM display.  Embedded blanks are ok, but multiple spaces
  1126. will be reduced to a single blank.
  1127.  
  1128.     Kermit-11>SET DIAL COMMENT Hayes-MNP with DTE speed locked
  1129.  
  1130. SET DIAL CON300
  1131.  
  1132. Define a message from the modem which, as a result of a dialed call
  1133. will cause Kermit-11 to set its DCE port (ONLY when using the CL or
  1134. KM handler) to 300 baud and then CONNECT to it:
  1135.  
  1136.     Kermit-11>SET DIAL CON300 CONNECT  ; Hayes defaults to 300
  1137.  
  1138. SET DIAL CON1200
  1139.  
  1140. Define a message from the modem which, as a result of a dialed call
  1141. will cause Kermit-11 to set its DCE port (ONLY when using the CL or
  1142. KM handler) to 1200 baud and then CONNECT to it:
  1143.  
  1144.     Kermit-11>SET DIAL CON1200 CONNECT 1200
  1145.  
  1146.  
  1147. Installation and Release Notes    KRT V03.63            Page TwentyTwo
  1148.  
  1149.  
  1150. SET DIAL CON2400
  1151.  
  1152. Define a message from the modem which, as a result of a dialed call
  1153. will cause Kermit-11 to set its DCE port (ONLY when using the CL or
  1154. KM handler) to 2400 baud and then CONNECT to it:
  1155.  
  1156.     Kermit-11>SET DIAL CON2400 CONNECT 2400
  1157.  
  1158. SET DIAL CON4800
  1159.  
  1160. Define a message from the modem which, as a result of a dialed call
  1161. will cause Kermit-11 to set its DCE port (ONLY when using the CL or
  1162. KM handler) to 4800 baud and then CONNECT to it:
  1163.  
  1164.     Kermit-11>SET DIAL CON4800 CONNECT 4800
  1165.  
  1166. SET DIAL CON9600
  1167.  
  1168. Define a message from the modem which, as a result of a dialed call
  1169. will cause Kermit-11 to set its DCE port (ONLY when using the CL or
  1170. KM handler) to 9600 baud and then CONNECT to it:
  1171.  
  1172.     Kermit-11>SET DIAL CON9600 CONNECT 9600    ; Hayes
  1173.     Kermit-11>SET DIAL CON9600 CONNECT FAST    ; Telebit
  1174.  
  1175. SET DIAL CON19200
  1176.  
  1177. Define a message from the modem which, as a result of a dialed call
  1178. will cause Kermit-11 to set its DCE port (ONLY when using the CL or
  1179. KM handler) to 19,200 baud and then CONNECT to it:
  1180.  
  1181.     Kermit-11>SET DIAL CON19200 CONNECT 19200
  1182.     Kermit-11>SET DIAL CON19200 CONNECT 14400
  1183.  
  1184. SET DIAL CON38400
  1185.  
  1186. Define a message from the modem which, as a result of a dialed call
  1187. will cause Kermit-11 to set its DCE port (ONLY when using the CL or
  1188. KM handler) to 38,400 baud and then CONNECT to it:
  1189.  
  1190.     Kermit-11>SET DIAL CON38400 CONNECT 38400
  1191.  
  1192. SET DIAL CONFIRM
  1193.  
  1194. Some modems use a command syntax wherein the number to be dialed is
  1195. echoed back to the user, after which the user must confirm it is ok
  1196. by returning an appropriate string:
  1197.  
  1198.     Kermit-11>SET DIAL CONFIRM \015   ; usually just a return
  1199.  
  1200. SET DIAL CONFIRM-ACKNOWLEDGE
  1201.  
  1202. If your modem issues some sort of confirmation to the DIAL CONFIRM
  1203. sent to it, and there is  some  reason  to  test that in fact said
  1204. confirmation has actually been received by Kermit, you may specify
  1205. what to expect thusly:
  1206.  
  1207.     Kermit-11>SET DIAL CONFIRM-ACK string
  1208.  
  1209.  
  1210. Installation and Release Notes    KRT V03.63              Page TwentyThree
  1211.  
  1212.  
  1213. For example, older Vadic modems would say "DIALING" here.
  1214.  
  1215. SET DIAL DIAL-ACKNOWLEDGE
  1216.  
  1217. Specifies a string issued by the modem to acknowledge it is dialing.
  1218. Use of this may be  required  for  error  detection  with some older
  1219. modems, but it's normally not necessary.
  1220.  
  1221.     Kermit-11>SET DIAL DIAL-ACK \015   ; usually just a return
  1222.  
  1223. SET DIAL DIAL-PAUSE
  1224.  
  1225. Defines the string for dial tone pause, which string is passed to the
  1226. modem by placing the %P format effector in the actual dialing string,
  1227. which in turn is defined with the SET DIAL FORMAT command.
  1228.  
  1229.     Kermit-11>SET DIAL DIAL-PAUSE string
  1230.  
  1231. If you are dialing on a direct line or your modem supports pausing via
  1232. something embedded in the dial string itself the DIAL-PAUSE command is
  1233. unnecessary.  As long as the first char is numeric, commas and similar
  1234. tokens will be passed to the modem as part of the number from the DIAL
  1235. command.
  1236.  
  1237. SET DIAL DIAL-RATE
  1238.  
  1239. Allows pacing of chars in the dial string sent to the modem.  There is
  1240. an inherent wait of one clock tick (1/50 or 1/60 second, per your LTC)
  1241. to ensure an echo is not missed.  If this remains too fast for a modem
  1242. additional delay between each char may be specified in ticks:
  1243.  
  1244.     Kermit-11>SET DIAL DIAL-RATE 3
  1245.  
  1246. SET DIAL ECHO
  1247.  
  1248. If the modem echoes command strings, SET DIAL ECHO causes the display
  1249. during DIALing to be driven directly from the modem's output.  If the
  1250. modem doesn't support this, SET DIAL NOECHO forces display of what is
  1251. sent, regardless of what may be received from the modem.
  1252.  
  1253. SET DIAL FAILURE
  1254.  
  1255. Define a message from the modem which, as a result of a dialed call,
  1256. indicates failure to complete the connection.  More than one message
  1257. may be defined if necessary to include all possibilities.
  1258.  
  1259.     Kermit-11>SET DIAL FAILURE BUSY
  1260.     Kermit-11>SET DIAL FAILURE NO ANSWER
  1261.  
  1262. SET DIAL FORMAT
  1263.  
  1264. This defines the actual DIAL string sent to the modem.  In  addition
  1265. to specifying the entire thing verbatim several format effectors are
  1266. provided to make life easier.  Most notable of these is %S, which is
  1267. the number to dial taken from the argument to the DIAL command.  See
  1268. HELP SET DIAL Format-effectors for detailed info.
  1269.  
  1270.     Kermit-11>SET DIAL FORMAT %P%S\015
  1271.     Kermit-11>SET DIAL FORMAT AT %X D%M %S \015
  1272.  
  1273.  
  1274. Installation and Release Notes    KRT V03.63               Page TwentyFour
  1275.  
  1276.  
  1277. Most modems will require %S be the last item in the list (other than
  1278. the return as an input terminator), as otherwise a following command
  1279. will be taken as a request to abort dialing.  If blanks are embedded
  1280. they will be passed to the modem, although contiguous blanks will be
  1281. reduced to a single space.
  1282.  
  1283. SET DIAL Format-effectors
  1284.  
  1285. FORMAT (dialing) string format effectors supported:
  1286.  
  1287.     %A - SET PHONE [NO]ANSWER string
  1288.     %B - Dial blind
  1289.     %M - Mode, pulse or tone
  1290.     %P - Insert pause string
  1291.     %S - Phone number string, passed by DIAL command
  1292.     %X - Insert Hayes xmode string, unless set off
  1293.  
  1294. WAKE-STRING (initialization) string format effector supported:
  1295.  
  1296.     %X - Insert Hayes xmode string, unless set off
  1297.  
  1298. See  HELP SET DIAL ANSWER, NOANSWER PULSE, TONE  and  HELP SET PHONE *
  1299. for info concerning exactly what each of these does.
  1300.  
  1301. If you are using a "Hayes" style modem, its extended response mode may
  1302. be set into the init string via SET PHONE XMODE n, where n is a number
  1303. between 0 and 14, or the word "OFF".  The  format  effector  for XMODE
  1304. is %X.  It may also be used in the dial string, allowing modifications
  1305. without re-initializing the modem.
  1306.  
  1307. Strings to be inserted will be displayed in SHOW MODEM when the format
  1308. effectors (SET PH BLIND,PULSE,TONE,XMODE) for them are enabled, except
  1309. for the phone number string, which is not built until DIALing.
  1310.  
  1311. SET DIAL IDLE
  1312.  
  1313. Defines the string used to return the modem to idle state, which is
  1314. sent to the modem upon exiting Kermit-11 or dropping the connection
  1315. (ala SET LINE) to it.  If the modem was preset to auto-answer, this
  1316. restores it to that state.
  1317.  
  1318.     Kermit-11>SET DIAL IDLE ATZ \015
  1319.  
  1320. SET DIAL Important-Notes!
  1321.  
  1322. The SUCCESS, CONnnnn, RINGING  and  FAILURE fields are built as linked
  1323. lists thus you can have as many as necessary.  At least one SUCCESS or
  1324. CONnnnn message must be defined or any call is going to fail!
  1325.  
  1326. NOTE: Where a modem response string (SUCCESS, CONN, FAILURE) is a sub-
  1327. string of another response string the substring MUST FOLLOW the string
  1328. containing it as the comparison scheme used here ignores the return at
  1329. the end of the result string from the modem.  Thus, when you are using
  1330. CONNECT 1200 and CONNECT, "CONNECT 1200" MUST be defined first, BEFORE
  1331. "CONNECT" on its own.  All tests are done without respect to case.
  1332.  
  1333. Use of CONNECT messages to conform the speed of the DCE port (the one
  1334. on the PDP-11) to that of the modem (DTE port) is only possible using
  1335. the CL (TSX-Plus) or KM (RT-11/TSX-Plus) handlers.  These are for use
  1336.  
  1337.  
  1338. Installation and Release Notes    KRT V03.63               Page TwentyFive
  1339.  
  1340.  
  1341. with modems which alter the speed of their data port to the connected
  1342. (telephone port) speed.  The old speed will be restored when the next
  1343. call is placed, unless SET otherwise first.  See HELP SET DIAL CONnn,
  1344. where nn=300 ,1200 ,2400 ,4800 ,9600 ,19200 or 38400.
  1345.  
  1346. Once you have  established  a  working set of parameters for your user
  1347. defined modem,  you  may  include  them  in  KRT.INI, Kermit's startup
  1348. initialization command file.  If memory runs out before everything you
  1349. need can be entered, increase the value of ALSIZE in KRTMAC.MAC.  This
  1350. same buffer is used to store phone numbers.  Also note malloc as it is
  1351. here does not deallocate anything, thus while re-entering data updates
  1352. pointers to them the superseded data's memory is NOT recovered.
  1353.  
  1354. The following pseudo code was extracted from the dialer source module,
  1355. with the hope of clarifying the functions of and relationships between
  1356. the seemingly excessive number of parameters available here.  Anything
  1357. that can modified by SET DIAL is shown in UPPER CASE.  Items listed as
  1358. optional should only be used when really necessary, or performance may
  1359. not remain as fast as it could be.
  1360.  
  1361. format_dial_string        ; build the modem's dial_command_string
  1362.   using FORMAT string and
  1363.     %B BLIND dial string    ; if set phone blind has also been done
  1364.     %M PULSE or TONE string    ; set phone pulse,tone selects which
  1365.     %P DIAL-PAUSE string    ; used if defined
  1366.     %S the_phone_number        ; as passed by the dial command
  1367.     %X XMODE            ; depending on set phone xmode
  1368.  
  1369. call tty_initialize        ; open the link device
  1370. call fix_speed            ; restore set speed (b4speed) if need be
  1371.  
  1372. test INIT-ONCE            ; need to re-init modem?
  1373.   if <>, goto do_dial
  1374.     send WAKE-STRING    ; ya, send it an init string
  1375.     pace WAKE-RATE ticks    ; pause between chars if <>
  1376.     call check_abort    ; check strike any key to abort loop
  1377.     wait_for WAKE-PROMPT    ; now wait 2 secs for an ack
  1378.     on error, loop a maximum of three times then give up
  1379.  
  1380. do_dial:            ; try to dial a number
  1381.     ; these two are optional and only for modems which need them
  1382.     send INITIATE        ; dump the string to initiate dialing out
  1383.     wait_for INITIATE-PROMPT; if defined, wait up to 4 secs for a response
  1384.   send dial_command_string    ; this is from FORMAT, et.al. above
  1385.   pace DIAL-RATE ticks        ; pause between chars if not zero
  1386.   test DIAL-ECHO        ; does it echo?  if not, Kermit will do it
  1387.   call check_abort        ; strike any key to abort loop
  1388.     ; these three are optional and only for modems which need them
  1389.     wait_for DIAL-ACK    ; wait up to 4 secs for numb to echo perhaps
  1390.     send CONFIRM        ; stuff a confirm
  1391.     wait_for CONFIRM-ACK    ; if defined, wait up to 5 secs for the string
  1392.  
  1393. get_response:            ; get the modem's response
  1394.   wait_for SUCCESS ,RINGING ,FAILED ,CON300..CON19200
  1395.   test BINARY-RESPONSE        ; exit loop on a single character?
  1396.   call check_abort        ; strike any key to abort loop
  1397.   wait_until TIME-OUT secs
  1398.  
  1399.  
  1400. Installation and Release Notes    KRT V03.63            Page TwentySix
  1401.  
  1402.  
  1403. call_fails_or_was_aborted:
  1404.   send ABORT            ; get the modem to STOP
  1405.   wait SETTLE            ; let modem recover from abort!
  1406.  
  1407. call_succeeds:
  1408.     ; if under TSX-Plus with CL handler and a CONnnnn result message
  1409.     call b4speed        ; save speed before fallback..
  1410.     call set_speed        ; then set it to what modem wants it to be
  1411.   jump c$connect        ; and connect automatically..
  1412.  
  1413. SET DIAL INITIATE
  1414.  
  1415. Some modems use a command syntax wherein the number to be dialed must be
  1416. preceded by a command to first initiate the dial mode itself.   Normally
  1417. these modems will also require using a DIAL CONFIRM string after sending
  1418. the number string.
  1419.  
  1420.     Kermit-11>SET DIAL INITIATE D\015
  1421.  
  1422. SET DIAL INITIATE-PROMPT
  1423.  
  1424. If after use of the DIAL INITIATE option for some obscure reason you
  1425. find it necessary to check for proper response to it from your modem
  1426. the desired string may be specified thusly:
  1427.  
  1428.     Kermit-11>SET DIAL INITIATE-PROMPT string
  1429.  
  1430. SET DIAL INIT-ONCE
  1431.  
  1432. If once initialized your modem remains in that state (some such as the
  1433. Concord 224 will time out and return to an idle mode) you may skip any
  1434. further unnecessary and time consuming inits by calling this function.
  1435. This is tested when dialing, and will speed up the redial looping time
  1436. if your modem allows its use.
  1437.  
  1438.     Kermit-11>SET DIAL INIT-ONCE
  1439.  
  1440. To restore Kermit-11's default operation where the modem is re-initted
  1441. before trying anything and everything else SET DIAL NOINIT-ONCE.
  1442.  
  1443. SET DIAL NOANSWER
  1444.  
  1445. Defines a string the %A format effector will insert in the dial FORMAT
  1446. string when it contains said %A effector and you've SET PHONE NOANSWER
  1447. to disable the modem from answering an incomming call.
  1448.  
  1449.     Kermit-11>SET DIAL NOANSWER S0=0  ; Hayes does it thusly
  1450.  
  1451. SHOW MODEM to display its current setting and status.
  1452.  
  1453. SET DIAL NOBINARY-RESPONSE
  1454.  
  1455. Enables testing modem result messages consisting of strings greater than
  1456. one character.  If your modem responds via single character result codes
  1457. SET DIAL BINARY-RESPONSE so Kermit will as well.
  1458.  
  1459.  
  1460. Installation and Release Notes    KRT V03.63              Page TwentySeven
  1461.  
  1462.  
  1463. SET DIAL NOECHO
  1464.  
  1465. If the modem echoes command strings, SET DIAL ECHO causes the display
  1466. during DIALing to be driven directly from the modem's output.  If the
  1467. modem doesn't echo, SET DIAL NOECHO will force Kermit to display what
  1468. is sent to the modem in place of what would be echoed back.
  1469.  
  1470. SET DIAL NOINIT-ONCE
  1471.  
  1472. If your modem, once initialized for dialing out, doesn't remain in such
  1473. a state, particularly after a dial out call fails, SET DIAL NOINIT-ONCE
  1474. will force Kermit-11 to re-initialize the modem before each dial/redial
  1475. attempt.  This is the default operation.
  1476.  
  1477. SET DIAL PULSE
  1478.  
  1479. Defines a string to force the modem to use pulse dialing regardless of its
  1480. recognizing tone dialing capability on the line.  This string is passed to
  1481. the modem by the %M format effector (which must in the DIAL FORMAT string)
  1482. when one has SET PHONE PULSE to enable it.
  1483.  
  1484.     Kermit-11>SET DIAL PULSE P    ; "Hayes" uses this
  1485.  
  1486. SET DIAL RINGING
  1487.  
  1488. Defines a ring response, as returned by the modem to report the status of
  1489. a call in progress.  Kermit-11 maintains a count of received RINGS, after
  1490. seven of which the call will be considered failed due to no reply.
  1491.  
  1492.     Kermit-11>SET DIAL RINGING RING   ; "RING" includes "RINGING"
  1493.  
  1494. Multiple messages may be defined as required to cover all possibilities.
  1495.  
  1496. SET DIAL SETTLE-TIME
  1497.  
  1498. Allows modifying the delay between sending a reset string to a modem and
  1499. dumping the handler connected to it, which also drops DTR.  If the modem
  1500. doesn't recover in time to resume its auto-answer mode, increase this to
  1501. something beyond the 20 tick default by setting a new value as a decimal
  1502. number of ticks.  One tick is 1/50 or 1/60 second (hardware dependent).
  1503.  
  1504.     Kermit-11>SET DIAL SETTLE 30
  1505.  
  1506. IMPORTANT NOTE:  This is a global function effective for ANY modem type,
  1507. not just USER-DEFINED, but for KRT's built-in modem types this will only
  1508. prevail when this is done AFTER setting the MODEM-TYPE.
  1509.  
  1510. SET DIAL SUCCESS
  1511.  
  1512. Define a message from the modem which, as a result of a dialed call,
  1513. indicates successful completion and a data path has been established
  1514. between modems, and which will force Kermit to CONNECT your terminal
  1515. to it.  More than one message may be defined if necessary to include
  1516. all possible responses.
  1517.  
  1518.     Kermit-11>SET DIAL SUCCESS CONNECT
  1519.  
  1520.  NOTE:  This particular function neither checks nor changes speed.
  1521.  If this is something you need, see HELP SET DIAL Important-Notes.
  1522.  
  1523.  
  1524. Installation and Release Notes    KRT V03.63              Page TwentyEight
  1525.  
  1526.  
  1527. SET DIAL TIME-OUT
  1528.  
  1529. Defines the period in seconds after which if there is no conclusive
  1530. response (excluding informational messages) from the modem the call
  1531. will be considered to have failed.
  1532.  
  1533.     Kermit-11>SET DIAL TIME-OUT 60    ; for overseas calling..
  1534.  
  1535. IMPORTANT NOTE:  This is a global function effective for ANY modem type,
  1536. not just USER-DEFINED, but for KRT's built-in modem types this will only
  1537. prevail when done AFTER setting the MODEM-TYPE, and the modem's internal
  1538. time out is set to something greater than the desired time period here.
  1539.  
  1540. SET DIAL TONE
  1541.  
  1542. Defines a string to enable the modem to use tone dialing regardless of its
  1543. recognizing tone dialing capability on the line.  This string is passed to
  1544. the modem by the %M format effector (which must in the DIAL FORMAT string)
  1545. when one has SET PHONE TONE to enable it.
  1546.  
  1547.     Kermit-11>SET DIAL TONE T    ; "Hayes" uses this
  1548.  
  1549. SET DIAL WAKE-ACKNOWLEDGE
  1550.  
  1551. Defines the expected response to the WAKE-STRING (initialization to dial
  1552. out) sent to the modem.  This is tested three times over a period of six
  1553. seconds, after which the init will be considered to have failed.
  1554.  
  1555.     Kermit-11>SET DIAL WAKE-ACK OK
  1556.  
  1557. SET DIAL WAKE-RATE
  1558.  
  1559. Allows pacing of chars in the init string sent to the modem.  There is
  1560. an inherent wait of one clock tick (1/50 or 1/60 second, per your LTC)
  1561. to ensure an echo is not missed.  If this remains too fast for a modem
  1562. additional delay between each char may be specified in ticks:
  1563.  
  1564.     Kermit-11>SET DIAL WAKE-RATE 5
  1565.  
  1566. SET DIAL WAKE-STRING
  1567.  
  1568. Defines the wakeup (initialization) string sent to the modem to place
  1569. it in the ready-to-dial-out state:
  1570.  
  1571.     Kermit-11>SET DIAL WAKE-STRING \005\015
  1572.     Kermit-11>SET DIAL WAKE-STRING AT E1 Q0 S0=0 S7=255 V1 %X \015
  1573.  
  1574.  
  1575. Installation and Release Notes    KRT V03.63               Page TwentyNine
  1576.  
  1577.  
  1578.             R E S T R I C T I O N S
  1579.             -----------------------
  1580.  
  1581. A problem was found with versions of Kermit-11 prior to  3.49  regarding
  1582. the  sending and processing of attribute packets.  Basically, two of the
  1583. attribute types were improperly implemented.  The support for  attribute
  1584. packets  was  added  back  in April 1984, at a time when testing against
  1585. other implementations was not possible.  At this writing, in March 1986,
  1586. some problems have been found.
  1587.  
  1588. The corrected version of Kermit-11 is V3.49.  This version will  NOT  be
  1589. able  to exchange attribute packets with previous versions.  In order to
  1590. make an initial download of Kermit-11 V3.49 to a host running  an  older
  1591. version, you must explicitly disable attribute support, as in:
  1592.  
  1593.         Kermit-11>SET NOATTR
  1594.  
  1595. and then force both ends to binary mode, as in:
  1596.  
  1597.         Kermit-11>SET FILE TYPE BINARY
  1598.  
  1599. The best way to accomplish the updating of remote sites is to use a pre-
  1600. 3.49 version of Kermit-11 at both sides,  transfer the image appropriate
  1601. to your system, then replace the old executable image on the remote side
  1602. and your own side and transfer the help text and other needed files.
  1603.  
  1604.  
  1605.                U p g r a d e s
  1606.                ---------------
  1607.  
  1608. This special version of Kermit-11 (for RT-11 and TSX-Plus) may be from
  1609. time to time updated/upgraded, or various bugs may be found and fixed.
  1610. New versions may be obtained from kermit.columbia.edu by anonymous ftp
  1611. (kermit/b/krt*.*) or by calling the system on which the work is done:
  1612.  
  1613.     Host:             Billy's Place, Culver City, California, USA
  1614.     Available:        24 hours, 3 lines, immediate access
  1615.     Phone:            +1.310.837.0892
  1616.     Logon (username): 1000
  1617.     Password:         moving_target
  1618.     Modem speeds:     9600 (V.32) and down, or PEP (modems are T-2500s)
  1619.     Protocols:        Kermit, VTCOM/TRANSF, Xmodem
  1620.  
  1621. Access is free other than whatever it costs to place the call.  Any bug
  1622. found will be fixed, send mail to billy@MIX.COM detailing your problem.
  1623. Also on-line here are the complete Kermit-11 T3.60 sources along with a
  1624. massive amount of RT-11 SIG and other public domain/gratis software.  
  1625.  
  1626.  
  1627. Installation and Release Notes    KRT V03.63            Page Thrity
  1628.  
  1629.  
  1630. The following files comprise everything required for KRT/KRTTSX:
  1631.  
  1632. KRT   .BWR    "Beware" file, known bugs and possible things to come..
  1633. KRT   .COM    Links low memory overlays image, KRT.SAV
  1634. KRT   .DOC    Installation and Release Notes
  1635. KRT   .IND    Bob Schor's Kermit-11 init file manipulator, an IND process
  1636. KRT   .INI    Sample initialization file
  1637. KRT   .MAP    Link map of low memory overlays image, KRT.SAV
  1638. KRT   .SAV    Low memory overlays image, for RT-11FB,SB,SJ and TSX+
  1639. KRTAIL.MAC    Tailgating protection for TSX+ V6.31 and below
  1640. KRTASM.COM    Assembles all source modules for an EIS CPU
  1641. KRTASM.NON    Assemble all sources for a non-EIS CPU using macros in KRTNHD
  1642. KRTATR.MAC    Attribute packet processing
  1643. KRTCDF.MAC    Command macro definition .INCLUDE file
  1644. KRTCMD.MAC    Main program loop, commands calling APR4
  1645. KRTCM1.MAC    APR4 overlay for the rest of the commands
  1646. KRTCOM.MAC    Main loop commands data table
  1647. KRTCON.MAC    CONNECT terminal emulator
  1648. KRTCVT.MAC    File name conversion routines
  1649. KRTDAT.MAC    Global read/write data
  1650. KRTDEB.MAC    EXAMINE command, display memory by symbol or address
  1651. KRTDEF.MAC    Packet definition .INCLUDE file
  1652. KRTDIA.MAC    DIAL command, also SET MODEM and SHOW DIAL
  1653. KRTDIR.MAC    Directory operations
  1654. KRTDSP.MAC    I/O dispatching to handler or terminal
  1655. KRTEDI.MAC    SL command line editor
  1656. KRTERM.MAC    I/O support for the controlling terminal line (TT)
  1657. KRTERR.MAC    Error messages
  1658. KRTHIS.DOC    Narrative in-depth edit history
  1659. KRTHLP.HLP    HELP text file
  1660. KRTHLP.MAC    HELP command processor
  1661. KRTIDX.BAS    Builds KRTIDX.MAC from KRTHLP.HLP
  1662. KRTIDX.MAC    HELP text file index for high speed lookups
  1663. KRTINI.MAC    Initialization, packet logging
  1664. KRTKM .MAC    "Kermit Modem" handler
  1665. KRTLNK.COM    Links extended memory overlays image, KRTTSX.SAV
  1666. KRTMAC.MAC    Macro definitions .INCLUDE file
  1667. KRTMDM.MAC    Pre-defined modems database
  1668. KRTNHD.MAC    MUL, DIV, SOB, ASH macros for non-EIS CPU
  1669. KRTOID.COM    Link for RT-11 V5.6 separate I&D space, low memory overlays
  1670. KRTOSI.MAC    One-shot initialization at program start
  1671. KRTPAK.MAC    Low level packet processing
  1672. KRTREC.MAC    Incoming file protocol processing
  1673. KRTRMS.MAC    File access, RMS emulation
  1674. KRTSEN.MAC    Outgoing file protocol processing
  1675. KRTSER.MAC    Server support
  1676. KRTSHO.MAC    SHOW, COPY, DELETE, PRINT, RENAME commands
  1677. KRTSJ .CND    RT-11FB,SB,SJ conditional assembly file for KM handler
  1678. KRTSJ .MAC    Root module for low memory overlays image
  1679. KRTSTD.MAC    SET command data table
  1680. KRTST0.MAC    SET command overlay 0
  1681. KRTST1.MAC    SET command overlay 1
  1682.  
  1683.  
  1684. Installation and Release Notes    KRT V03.63            Page ThrityOne
  1685.  
  1686.  
  1687. KRTSUB.MAC    Misc common utility routines
  1688. KRTSV4.COM    Build KM handler under RT-11 V4
  1689. KRTSYS.COM    Build KM handler under RT-11 V5
  1690. KRTTRA.MAC    TRANSMIT command
  1691. KRTTSX.CND    TSX conditional assembly file for KM handler
  1692. KRTTSX.MAP    Link map for extended memory overlays image, KRTTSX.SAV
  1693. KRTTSX.SAV    Extended memory overlays image, for RT-11XB,XM,ZB,ZM and TSX+
  1694. KRTUTL.MAC    Misc utility routines, mount for TSX+
  1695. KRTVID.COM    Link for RT-11 V5.6 sep I&D space, extended memory overlays
  1696. KRTXL .MAC    I/O support for CL, KM, XC and XL
  1697. KRTXM .CND    XM conditional assembly file for KM handler
  1698. KRTXM .MAC    Root module for extended memory overlays image
  1699. KRTXMO.MAC    XMODEM, also SEND command processor
  1700.  
  1701. Billy Y..
  1702. 27-Sep-1997
  1703. -eof-
  1704.