home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / perkinelmeros32 / perkin.ann next >
Text File  |  2020-01-01  |  4KB  |  85 lines
  1. PE-Kermit   Version 1.0        21 January, 1987
  2.  
  3. -- Configured for Concurrent/Perkin-Elmer/Interdata 3200 series
  4.    Super-Minicomputers running OS/32, by:
  5.  
  6.     Creighton J. Miller
  7.        Department of Speech, Theatre, and Communication Disorders
  8.        Louisiana State University
  9.        Baton Rouge, LA     (504) 388-2545
  10.  
  11. -- This program has been developed and installed on a Perkin-Elmer 3210
  12. system with 1 Mbyte of memory, under OS32MT72, Revision 0.  All program code
  13. except for the I/O modules, has been written in "primitive" FORTRAN which
  14. should prove to be highly portable (even to other machines) compact and
  15. fast.  All I/O utilizes system-level versatility through run-time access to
  16. PE's SVC1 I/O handler, whose operations could be easily duplicated on most
  17. other mini's in a single added subroutine (image mode
  18. read-/write-and-proceed calls and echoless reads).
  19.  
  20. -- In developing this program, much reference has been made to code from
  21. Kermit-PE 2.0, developed by Paul Mamelka and currently available from either
  22. Columbia University or PE-Interchange: The primary reasons for developing
  23. PE-Kermit being a desire to enhance program size/speed/portability issues
  24. and to incorporate binary file transfers (eventually raw transfers as
  25. well...), plus a few added "bells and whistles" I'd had in mind.
  26.  
  27. -- Although no warranty of the routine is either expressed or implied, feel
  28. free to use/distribute/alter the code at will --- so long as it is put to no
  29. explicitly commercial applications: I think you'll be impressed by this
  30. Kermit's relatively gentle and forgiving nature.  I would be happy to
  31. exchange information, comments or just pleasantries with those of you who
  32. find some use for the logic.
  33.  
  34. -- A complete set of installation/development/message files is included with
  35. the code, as an aid to fellow-travelers on the road to inter- system
  36. communications.  They'll work as-is on a properly prepared 3200 series PE
  37. system; properly prepared meaning in this case, OS32MT72.0 or higher OS and
  38. BIOC with an enabled, 80 byte (minimum) typeahead cue, plus the sysgened
  39. MASK=X'FF' option.  Please note that the interactive message file,
  40. KERMIT.HLP, is an IN-dexed file with an 80 character record length, and
  41. holds binary information.  Each line is structured as follows;
  42.  
  43.                1.  BYTES 00-03 => length in bytes (binary) of the
  44.                                   message line which follows
  45.  
  46.                2.  BYTES 04-[length+4] => message line, in image
  47.                                           form.
  48.  
  49. - Program size ranges from 22k bytes, using FORT7-O, through 25k bytes,
  50. using FORT6 (you'll need assembly access to OS/32 7.2.0's SVC1, like that
  51. included in SYS7IO.FTN), to about 38k bytes, using FORT7-D.  You will
  52. discover SIGNIFICANTLY enhanced response times for the program with the
  53. optimizing compilers.
  54.  
  55. -- Transfers have been accomplished between both a PE-3210 and a PE-8/32 (as
  56. Hosts) and Zenith Z-148 (4.7 and 8 meg clocking), IBM XT, IBM AT and Kaypro
  57. 2000 Pc's, at baud rates ranging from 300 through 9600, over dedicated and
  58. modem links.  These have been used for both ASCII and BINARY data, with
  59. full-sized packets (94 bytes).  MS-Kermit 2.26 was the usual Caller routine,
  60. but MS-Kermit 2.28, and Procomm 2.1 and 2.3 have also been used (Procomm 2.1
  61. has quirks which effectively prevent binary transfers).
  62.  
  63. PROGRAM FILES:
  64.  
  65.    PERKIN.DOC -- THIS LISTING
  66.  
  67.    PERKIN.FTN -- FORTRAN SOURCE CODE, MAIN AND ALL SUBROUTINES
  68.    PERSY7.FTN   -- ASSEMBLY PATCH FOR SVC1 ACCESS VIA FORT6
  69.  
  70.    PERKIN.LNK -- LINKAGE CONTROL, FORT7
  71.  
  72.    PERKIN.CSS
  73.  
  74.    PERKIN.INI   -- KERMIT INITIALIZATION DEFAULT FILE
  75.             (RENAME TO KERMIT.INI)
  76.    PERKIN.HLP   -- INTERACTIVE COMMAND MESSAGE FILE FOR RUN-TIME
  77.                    (NOTE: MAY BE TAILORED FOR SITE-SPECIFIC NEEDS.
  78.                     BYTES 0-3 IN ANY LINE ARE (BINARY) LINE LENGTH
  79.                     COUNT.  THESE ARE FOLLOWED BY THE RELEVANT
  80.                      ASCII STRING.)
  81.             (RENAME TO KERMIT.HLP)
  82.                    *** WARNING: contains <lf>-<cr> sequences and
  83.                                 control sequences; copy in image
  84.                                 mode.
  85.