home *** CD-ROM | disk | FTP | other *** search
/ ftp.update.uu.se / ftp.update.uu.se.2014.03.zip / ftp.update.uu.se / pub / rainbow / msdos / decus / RB114 / tc.doc < prev    next >
Text File  |  1995-05-28  |  10KB  |  227 lines
  1.  
  2.  
  3.  
  4.                                   TURBOCOMM
  5.  
  6.                          A Terminal Emulation Program
  7.                   
  8.                     by Stew Stryker, RONNIE Support Group
  9.  
  10. ------------------------------------------------------------------------------
  11.                                DISCLAIMER
  12.  
  13.       The author and Digital Equipment Corp absolve  themselves  of  any
  14.       possible  warranties  as  to the capabilities of this program, the
  15.       contents of this document, and specifically disclaim  any  implied
  16.       warranties  of  effectiveness.    They shall not be liable for any
  17.       lost profits, or for any claim or demand against them.
  18.  
  19.       The program is donated to the public domain, and  as  such  should
  20.       not  be  distributed  for profit.  The program is provided "as is"
  21.       and no technical support  by  Digital  or  the  author  should  be
  22.       assumed. 
  23. ------------------------------------------------------------------------------
  24.  
  25.  
  26.  
  27.       INTRODUCTION
  28.  
  29.       This terminal emulation program was  written  entirely  in  MS-DOS
  30.       Turbo Pascal (tm Borland International) for the DEC Rainbow.  It's
  31.       main purpose is to act as an example program showing  how  to  use
  32.       the  MS-DOS  communication  library.    Its secndary purpose is to
  33.       provide support for ReGIS emulation in the Digital A-to-Z environ-
  34.       ment.  It requires MS-DOS 2.05 or greater to run.
  35.  
  36.  
  37.  
  38.       FEATURES
  39.  
  40.       Along with providing basic terminal emulation  capabilities,  this
  41.       package supports:
  42.  
  43.         * User selection of baud rate on program startup
  44.         * Directing characters received from the host to the local printer
  45.         * Sending text files to the host computer
  46.         * Receiving text files from the host computer
  47.         * User selection of either VT2xx or VT102 emulation
  48.         * Digital's A-to-Z video graphics requirements
  49.         * ReGIS terminal emulation software
  50.         * Terminal Identification inquiries
  51.         * Full function key support
  52.         * Commands to change Numeric Keypad mode
  53.         * Terminal resets escape sequence trapping
  54.         * Printer controller commands
  55.         * Responding correctly to Printer Status Inquiries
  56.         * The Break key
  57.                                      
  58.  
  59.  
  60.       EXPLANATION
  61.       
  62.       As someone has already pointed out to me, this is not a true VT200
  63.       emulator.  That is, I didn't bother to implement the DRCS, UDKs,
  64.       selective erase, and DA2 recognition.  All I did really was: 1)
  65.       have the default terminal identify itself as a VT220, instead of a
  66.       VT102 (which I think is a closer match); 2) have the function keys
  67.       F11 - F14 send out their respective escape sequences instead of
  68.       Escape, Backspace, and Linefeed.  If anyone knows the VT200 class
  69.       terminals well enough (and really NEEDS the added capabilities)
  70.       I'm willing to work with them to add the missing functionality, or
  71.       they can add it themselves and send me a copy.
  72.  
  73.  
  74.  
  75.       DIRECTIONS
  76.  
  77.       STARTING THE PROGRAM:
  78.       
  79.           type:    TC {T} {VT100} {baud rate} {@keyfilename}<CR>
  80.  
  81.       
  82.       Command Line Options (all of which are optional)
  83.  
  84.       The 'T' indicates that you wish to go immediately into Terminal
  85.       emulation mode, by-passing the initial help display.
  86.  
  87.       The default terminal emulation mode is a VT2xx.   You  may  select
  88.       VT102 emulation by typing 'VT100' in the command line.  If your
  89.       are running Poly-ReGIS when you begin your TurboComm session, your
  90.       terminal type will automatically be set to VT125.  Use this if you
  91.       are logging onto a VAX running a version of VMS lower than 4.0, so
  92.       that your terminal identifier will be understood.
  93.  
  94.       The 'baud rate' selects the baud rate you want the program to  run
  95.       at  (which,  of course, must be compatible with your modem or data
  96.       line).  The baud rate may be one of the following:
  97.  
  98.                   110 150 300 600 1200 2400 4800 9600
  99.  
  100.       If no baud  rate  is  selected,  the  program  uses  your  default
  101.       communications settings (established in the Rainbow Setup mode).
  102.  
  103.       When TurboComm starts, it will attempt to load a function key
  104.       definition file called: TC.KEY.  If no such file is found
  105.       on the default disk, TurboComm will use the default function key
  106.       definitions.  You may instruct TurboComm to load a file with a
  107.       different name by entering an @ sign, followed by the file's name
  108.       (including pathname, not including the file type).  The function
  109.       key definition file's type must be ".KEY".
  110.  
  111.       For example, to start the program running at 1200 baud instead  of
  112.       your  default  baud  rate,  skipping over the initial display, and
  113.       loading a special function key definition file from E:\COMMAND,
  114.       type:
  115.  
  116.                     TC T 1200 @E:\COMMAND\FKEY<CR>
  117.  
  118.  
  119.       Running TurboComm
  120.  
  121.       The program first displays it's initial help information on how to
  122.       use the function keys.  At this point, you either press <DO> to
  123.       enter terminal emulation mode, <HELP> for more information, or
  124.       <EXIT> to return to the operating system.
  125.  
  126.  
  127.  
  128.       TO USE THE FUNCTION KEYS
  129.       ONCE YOU ARE IN TERMINAL EMULATION:
  130.  
  131.       All the function keys, except <PRINT SCREEN>,  <BREAK>  and  <F4>,
  132.       will  transmit  their  standard  escape  sequences  to  your  host
  133.       computer.
  134.  
  135.         <BREAK> will send a break signal for .25 seconds.
  136.         
  137.         <F4> puts you in command mode for a single command.
  138.         
  139.         <PRINT> dumps the screen image to the printer.
  140.         <CTRL><PRINT> toggles the printer on and off (like <F4>P).
  141.                                                           
  142.  
  143.  
  144.       COMMAND MODE:
  145.       
  146.       From terminal emulation mode, press the <F4> key, followed
  147.       by the letter highlighted for the function you want:
  148.  
  149.         Close      - If you are receiving a text file from the
  150.                      host computer, this will stop receiving the
  151.                      text, and close the file.  When you've success-
  152.                      fully closed the file, your screen will flash.
  153.                            
  154.         Disconnect - Drops the DTR signal to your modem, which
  155.                      will hang up your phone.
  156.  
  157.         Printer    - Toggles sending the displayed text to your
  158.                      printer on and off.
  159.  
  160.         Quit       - Disconnect and exit.
  161.  
  162.         Receive    - Allows you to capture all characters from
  163.                      your host onto a file on your Rainbow.
  164.  
  165.         Send       - Lets you send a text file from your Rainbow
  166.                      to your host computer.
  167.  
  168.         eXit       - Ends running TurboComm.  This does not drop 
  169.                      your DTR signal, so that your modem may still be con-
  170.                      nected to your host computer.
  171.  
  172.         function key - Allows you to redefine most of the "grey"
  173.                      function keys.  Type in your definition, and "save"
  174.                      it by pressing <F4>.  Function definitions are
  175.                      automatically saved when you exit the program.
  176.  
  177.  
  178.         
  179.       If you type any other character, besides  those  listed  above,  a
  180.       line of help text will be displayed.
  181.  
  182.       
  183.       If you have redefined function keys, you will be asked if you wish
  184.       to save their definitions when you exit TurboComm.  You will also
  185.       be prompted for the filename you wish to save them to.  Again, you
  186.       may specify a pathname, but not a file type.  The file type
  187.       must be ".KEY".
  188.  
  189.  
  190.  
  191.       TO COMPILE TURBOCOMM SOURCE CODE
  192.       
  193.       (You can run TC.COM directly, without recompiling the source code.
  194.       If  you  want  to  modify  the program yourself, you'll need these
  195.       instructions.)
  196.  
  197.       First, you must break the library file, TC.LBR, into its  separate
  198.       files  with  the  LU.EXE utility (not included).  To break out all
  199.       the components, type:  
  200.                             LU A TC.LBR<cr>
  201.  
  202.  
  203.       If you want to get at the source code, use USQ (not included) to
  204.       get at the files.  Otherwise, you can just begin the use TC.COM
  205.       and TC.DOC as they are.
  206.  
  207.       Next, you will probably want to edit the  main  file  (TC.PAS)  to
  208.       match  the  version of MS-DOS Turbo Pascal you're using.  This was
  209.       originally developed under Turbo Pascal version 2.0.  At the  last
  210.       minute,  my  update  to  3.0  arrived  and  I modified some of the
  211.       procedures to take advantage of some new capabilities.   Therefore
  212.       some of the code requires Turbo Pascal 3.0 or greater.
  213.  
  214.       I did the only decent thing, and left the version 2.0 code in  the
  215.       program,  but  commented  it  out.  If you're compiling with Turbo
  216.       3.0, you can compile this "as is" (Though you may want  to  remove
  217.       the  version  2.0  code  altogether.) If you are still using Turbo
  218.       2.0, search through the source code in TC.PAS for  all  occurances
  219.       of 'Turbo Pascal 3.0', and remove those routines.  Then search for
  220.       the sections marked with '< 3.0' and remove the comment marks ( {}
  221.       ), to activate those functions.
  222.  
  223.       After you've created the version of TC.PAS you  need,  you  simply
  224.       compile it as you would any other Turbo Pascal program.
  225.  
  226. 
  227.