home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / aosfortran / aoskerdoc.txt < prev   
Text File  |  2020-01-01  |  6KB  |  120 lines
  1. This AOS  version of  KERMIT was written  on a  DATA GENERAL
  2. S/250 running  AOS Rev.  5.0 and Fortran  5 Rev.  6.14.  The
  3. source  code is  written in  RATFOR,  which translates  into
  4. FORTRAN 5  code before  compilation.  For  those of  you who
  5. need to make modification to  the program, it is recommended
  6. that one examine  the RATFOR source code where  there are at
  7. least  some decoumentation  on various  sections of  program
  8. code.  The  RATFOR version source  code should  be available
  9. from Columbia University.  In evaluating  the merits of this
  10. KERMIT-AOS program  one should  keep in  mind that  the main
  11. purpose  of implemented  KERMIT-AOS  on  our system  is  for
  12. understanding and  evulation of the KERMIT  protocol itself.
  13. Therefore  more  effort  was  spend  on  the  file  transfer
  14. function  rather than  on the  terminal emulation  function.
  15. Our computing facility  also includes the availability  of a
  16. local area network hence the  issue of controlling baud rate
  17. or  parity bit  were  not addressed.   I  was  a little  bit
  18. reluctant in releasing this program because I felt it is not
  19. in a desirable state; however I was persuaded by others that
  20. something is better  than nothing at all.  I  can only added
  21. that this AOS  version of KERMIT works on  our system.  This
  22. KERMIT-AOS transferred  file sucessfully  between an  IBM/PC
  23. and IBM 370/CMS; both programs were originated from Columbia
  24. University via DECUS  tape.  Credit should also  be given to
  25. Fred Brehm  who installed  the RATFOR  translator onto  D.G.
  26. machines  for  RCA   and  it  makes  my   implementation  of
  27. AOS-KERMIT from the  C listing found in  the PROTOCOL manual
  28. much simpiler.  Permission  is granted to any  individual or
  29. institution  to  copy  or  use   this  program,  except  for
  30. explicitly commercial purpose.
  31.    
  32.    
  33.                                         JOHN LEE
  34.                                         RCA LABS (PRINCETON)
  35.                                         609-734-3157
  36.                                         7/5/84
  37.    
  38.  Terminology and features
  39.  ------------------------
  40.    
  41.  LOCAL      - An user will be using KERMIT-AOS in logon to other KERMIT,
  42.             - file transfer will occur on a TTY line other than the TTY
  43.             - line this user used in activating KERMIT-AOS.
  44.    
  45.  REMOTE     - An user will be using other KERMIT in logon to the AOS
  46.             - system and activiating KERMIT-AOS.  File transfer will
  47.             - occur on this same TTY line.  IN REMOTE sending mode, there
  48.             - is a 15 second delay before the first SINIT packet is send.
  49.             - This would permit the user time to jump back to his/her
  50.             - KERMIT and enter the RECEIVEING state.
  51.    
  52.  9600/1200  - It is only valid in LOCAL mode.  It gives users a choice of
  53.             - baud rate.  If user choose 9600 baud, KERMIT will used @CON4
  54.             - which is already sysgened as 9600 baud.  If user choose 1200
  55.             - baud, KERMIT will used @CON11 which is already sysgened as
  56.             - 1200 baud.  The AOS system is rather slow in handling terminal
  57.             - I/O hence 'CHAT' mode works better at 1200 baud while higher
  58.             - baud rate does not show much improvement in file transfer mode
  59.             - because our system is always heavily loaded with other more
  60.             - priviledged programs.
  61.    
  62.  UNHUNG     - AOS KERMIT does not support time-out READ which mean if a
  63.             - packet is lost, it will goes into an indefinite wait state
  64.             - unless the other KERMIT is smart enough to detect a dead-
  65.             - lock situation.  As each data packet is exchange, the packet
  66.             - frame sequence number is display on the screen ( in LOCAL
  67.             - mode only).  Hitting the NEWLINE key while in file transfer
  68.             - mode will resulted in KERMIT-AOS sending out a NAK packet
  69.             - which may or may not resolved dead-lock problem.
  70.    
  71.  CONNECT    - Enters into the 'CHAT' mode, whatever you typed on the
  72.             - local keyboard is transmitted to the remote host, and
  73.             - information from the remote host are transmitted to the
  74.             - local terminal.  'CHAT' mode is used in establishing
  75.             - login sessions and invoking remote KERMIT program.
  76.             - CNTR-] will cause exit from 'CHAT' mode.
  77.    
  78.  EXIT       - EXIT from this KERMIT program and returns to the CLI.
  79.    
  80.  HELP       - Displays the content of a help file.
  81.    
  82.  QUIT       - QUIT from this KERMIT program and returns to the CLI.
  83.    
  84.  RECEIVE    - Enters the 'RECEIVE' state of file transfer mode,
  85.             - program waits for in-coming packet with no time-out
  86.             - detection capability provided. Unhung feature in LOCAL
  87.             - mode may or maynot resolved the problem.
  88.    
  89.  SEND       - Enters the 'SEND' state of file transfer mode, program
  90.             - will then prompts for either a filename or a directory
  91.             - of filenames (i.e. @directory) to be transmitted.  E.G.
  92.             - a filename of 'TEST' means send the file with the filename
  93.             - of 'TEST', whereas a filename of '@TEST' means each line of
  94.             - file 'TEST' is to be interpreted as a filename to be send.
  95.             - This acts as a work around with the wildcard feature found
  96.             - on other system.
  97.    
  98.  SET IBM OFF- In 'CHAT' mode, expects remote system to echo back
  99.             - transmitted characters.  In file transfer mode, does
  100.             - not wait for the detection of DC1 before sending out
  101.             - the next packet.
  102.    
  103.  SET IBM ON - In 'CHAT' mode, performs local echoing of transmitted
  104.             - characters.  In file transfer mode, wait for the
  105.             - detection of DC1 from CMS before sending out the next
  106.             - packet.
  107.    
  108.  STATUS    - Displays the current values of various setting.
  109.    
  110.  Procedure On Installing KERMIT-AOS Onto Your Data General AOS system.
  111.    
  112.  1) Edit the large source file and breaks them into small one based
  113.     on the filename given.
  114.    
  115.  2) Compile all the source program by running the "COMPILEALL.CLI"
  116.     command file.
  117.    
  118.  3) Load and link all the relocatable file by running the "LINKALL.CLI"
  119.     command file.
  120.