home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / turbopas / comdemo.ark / COMDEMO.DOC < prev    next >
Encoding:
Text File  |  1986-08-24  |  6.0 KB  |  122 lines
  1.  
  2.           COMDEMO.PAS - A TURBO PASCAL COMMUNICATIONS DEMONSTRATION
  3.  
  4. Introduction
  5.  
  6.   COMDEMO.PAS  is a demonstration of communications using Turbo Pascal.  It
  7. uses a proposed standard library of communications library of routines that
  8. can be implemented for a variety of microcomputers.  COMDEMO.PAS will allow
  9. a connection to a remote computer via a communcations port.  It  will  also
  10. allow file transfer of ASCII files between the two computers.
  11.  
  12.   COMDEMO.PAS  was  written  as  a 'test- case' for CLIB180.INC - it's also
  13. useful as the 'first piece' to customize a 'text-capture' utility for a new
  14. micro system, which doesn't yet have  a  way  to  'talk  protocol'.   Turbo
  15. Pascal's  inherent  compilation  speed and relatively high portability will
  16. help in getting the first and  crucial  step  accomplished  :  enable  text
  17. capture  to and from another system.  The typical next step is to establish
  18. an error correcting protocol like Kermit.
  19.  
  20.   Further  information  is available from 'CLIB180.INC', 'CLIB180.DOC', and
  21. the source of this program 'COMDEMO.PAS'.
  22.  
  23.   COMDEMO.PAS  makes heavy use of the standard communications library.  All
  24. character I/O is done through the library functions, and disk I/O  is  done
  25. through  standard  Turbo functions.  This program should run on most micro-
  26. computers that are supported by Turbo Pascal  without  modification,  if  a
  27. similar set of library functions are implemented for it.
  28.  
  29.   This  program  was  written  by  Jeff  Duncan, with considerable help and
  30. advise from Bernie Eiben.  Comments, suggestions, etc, are welcome.  I  can
  31. be   reached   at   (617)   839-5673   (evenings)   or   send  comments  to
  32. LSM>DUNCAN@DEC-MARLBORO (preferable).
  33.  
  34. Installation
  35.  
  36.   Unless the user obtains a compiled copy of COMDEMO.PAS for his system, it
  37. must  be  installed  and  compiled.   The  following  is  the  installation
  38. procedure for the program.
  39.  
  40.   1.  Obtain a copy of COMDEMO.PAS and the communications library include
  41.       file for your system.
  42.  
  43.   2.  Rename the include file 'COMMLIB.INC'.
  44.  
  45.   3.  Compile COMDEMO.PAS to disk.
  46.  
  47.   4.  Installation complete.
  48.  
  49. Operation
  50.  
  51.   When  COMDEMO.PAS  is run, the message : *** Connected to remote port ***
  52. is printed on the console.  At this point, all characters displayed on  the
  53. screen   are   characters  received  from  the  communications  port.   Any
  54. characters typed at the console are sent out the communications port.  This
  55. creates a virtual terminal connection to a remote system.
  56.  
  57.   Also  printed  is  a  menu  of  commands  possible  for COMDEMO.  All are
  58. prefixed with Control-backslash.  All commands may be in upper case,  lower
  59. case,  or  the  control representation of the character.  The following are
  60. the possible commands:
  61.  
  62.     B- Set  the baud rate.  A list of possible baud rates is displayed and
  63.        the user is prompted to type the number of the  desired  baud  rate.
  64.        The  program  reports  the  success or failure of the operation, and
  65.        reconnects to the communications port.
  66.  
  67.     D- Set  carriage  return  delay.   This will allow the user to set the
  68.        delay after each carriage return is sent during  a  send  operation.
  69.        The  default  delay  is  0,  and the actual value of delay is system
  70.        dependent.  Maximum value for the delay  variable  is  32767.   This
  71.        will  help  when sending to a system that requires a delay, and will
  72.        also help by allowing a slow echoing system time to catch up and not
  73.        overflow the computer's input buffer.  On a VT180,  numbers  in  the
  74.        100's  will  give  a  reasonable delay as the delay is approximately
  75.        5ms/unit.
  76.  
  77.     E- Exit program.  Any open log files will be closed.
  78.  
  79.     H- Redisplay menu.
  80.  
  81.     P- Set the communications port.  A list of possible ports is displayed
  82.        and  the  user  is  prompted to type the number of the desired port.
  83.        The program reports the success or failure  of  the  operation,  and
  84.        reconnects to the communications port.
  85.  
  86.     Q- Exit program.  Any open log files will be closed.
  87.  
  88.     R- Receive  a  file.   A prompt will be given for a filename, and that
  89.        file will be opened.  Warning, this is a destructive open, no  check
  90.        is  done for an existing filename.  All characters received from the
  91.        communications port will be saved in a log buffer.  When logging  is
  92.        complete,  either  ^\-W,  or an exit command will close the log file
  93.        and save it to disk.  The size of the log buffer is 32k, so on small
  94.        systems this program must be compiled to disk.  The size of the  log
  95.        buffer is set by the constant 'maxbuffer'.  Fortunately, the size of
  96.        the  log buffer does not affect the size of the compiled program, at
  97.        least under CP/M, so any size  may  be  used  provided  it  fits  in
  98.        memory.
  99.  
  100.     S- Send  a file.  A prompt will be given for a filename, and that file
  101.        will be sent via the communications port to the remote system.   All
  102.        lines  will  be  terminated  with  a  carriage  return  only  to  be
  103.        compatible with typical  editors  and  text  capture  mechanisms  of
  104.        computers.   At  the  end  of  the  file  transfer, the file will be
  105.        closed.  All characters received during the file  transfer  will  be
  106.        displayed  on  the  screen.   Typing  any  character  will abort the
  107.        operation.
  108.  
  109.     W- Write  currently  logged  data,  and  close the log file.  All data
  110.        accumulated will be saved in the open file, if one  were  opened  at
  111.        the  time.  No warning is given if a file was not opened, or no data
  112.        was accumulated.
  113.  
  114. System Dependent Code
  115.  
  116.   There  should  be  no  system  dependent  code in the program, except, of
  117. course,  the  communications  library.   The  program  sets   the   default
  118. communications port, baud rate, and parity as defined in the communications
  119. library.   Other  ports  and  baud  rates  may  be set after the program is
  120. started by using the ^\-B and ^\-P commands.
  121.  
  122.