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 / latrobe / t / tc311.arc / TCII.DOC < prev   
Text File  |  1987-06-25  |  14KB  |  361 lines

  1.  
  2.  
  3.  
  4.  
  5.                            RELEASE NOTES  --  TCII V3.11
  6.  
  7.         
  8.         
  9.         
  10.  
  11.          Program Overview
  12.          ================
  13.  
  14.          TCII is a terminal emulation program for the  DEC Rainbow Personal
  15.          Computer  (models A and B).  The program offers  VT102  emulation,
  16.          using the Rainbows internal emulator firmware, and VT220 emulation
  17.          as part  of  the  program.  With version 2.11 of MS-DOS, TCII also
  18.          permits VT125 and  VT240  emulation  when used in conjunction with
  19.          the Rainbow ReGIS program from Polygon Associates.  (Rainbow ReGIS
  20.          is not fully compatible with MS-DOS 3.10 and higher.)
  21.  
  22.          In addition to terminal emulation,  TCII  offers  file transfer of
  23.          text and binary files, using the  popular XMODEM protocol, and its
  24.          multi-file derivative Telink.  To facilitate file  transfer,  some
  25.          file and path handling features are present, including a directory
  26.          display.
  27.  
  28.          Session logging to disk is included  as  part  of  the  ASCII file
  29.          transfer  capability.    The  Print  Screen  features  of  Rainbow
  30.          terminal  emulation  is functional (see '[G]' under 'Invoking  the
  31.          Program').
  32.  
  33.  
  34.  
  35.  
  36.         
  37.         
  38.         
  39.  
  40.                  
  41.         
  42.          [Digital,  DEC, VT102, VT125, VT220, VT240, Rainbow and ReGIS  are
  43.          trademarks of Digital Equipment Corporation, Maynard MA.
  44.  
  45.          Fido and FidoNet are trademarks of Tom Jennings, San Francisco CA.
  46.  
  47.          IBM and  Quietwriter  are  trademarks  of  International  Business
  48.          Machines, Armonk NY.]
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                        1
  61.  
  62.  
  63.  
  64.  
  65.          Release Notes - TCII V3.11 (1987 06 10)
  66.  
  67.  
  68.  
  69.  
  70.          Features
  71.          ========
  72.            
  73.          - Emulation:  VT102, VT220, VT125* and VT240* (* ReGIS interpreter
  74.            required) 
  75.          - Switchable Baud Rates:  300, 1200, 2400, 4800, 9600 
  76.          - Switchable Parity/Stop bit settings  
  77.          - Xmodem & Telink file transfer protocols  
  78.          - Transmission  of  all    keyable  sequences,  including  control
  79.            characters and <Break> 
  80.          - Redefinable function keys 
  81.          - Help key menu control 
  82.          - Print Screen - Screen Dump, and Printer Logging (see 'Known Bugs
  83.            and Anomalies') 
  84.          - Disk logging 
  85.          - Directory display from within the  program  (Hidden files' names
  86.            are bold - red when ReGIS is installed) 
  87.       
  88.  
  89.          Invoking the Program
  90.          ====================
  91.  
  92.          TCII is invoked from the DOS  command  prompt  (or  from  within a
  93.          shelling program) as:
  94.  
  95.           [drive:] [path] TC [T] [A] [ 300] [VT102] [G] [F] [P] [@filename]
  96.                                  [X] [1200] [VT200]
  97.                                      [2400]
  98.                                      [4800]
  99.                                      [9600]
  100.  
  101.          where:  [drive:]  and  [path] are the DOS drive and directory
  102.                  path to the program;
  103.  
  104.                  [T] starts  TC  in terminal mode immediately, without
  105.                  an introductory screen;
  106.  
  107.                  [A] or [X]  selects  the  initial  file transfer mode
  108.                  (Telink is the default);
  109.  
  110.                  [300] ...  [9600]  is the initial baud rate to select
  111.                  (the default is the current COM port setting);
  112.  
  113.                  [VT102] or [VT200] selects  VT102/125  or VT200/VT240
  114.                  emulation  (VT200/240  is  the  default)    with  the
  115.                  graphics decision based upon whether or  not  Rainbow
  116.                  ReGIS is installed;
  117.  
  118.                  
  119.                  
  120.                                        2
  121.  
  122.  
  123.  
  124.  
  125.          Release Notes - TCII V3.11 (1987 06 10)
  126.  
  127.  
  128.  
  129.  
  130.                  [G] ignores Digital  printer  escape  sequences.  Use
  131.                  generic for non DEC  printers, so <print screen> will
  132.                  function properly.  When using  a  DEC  printer, TCII
  133.                  will  print  according to screen width,  (80  or  132
  134.                  characters per inch).
  135.                
  136.                  [F]  designates  <F4>  as the command initiator,  for
  137.                  those who need the <Do> key in running other software
  138.  
  139.                  [P] initiates  logging to a printer immediately;  and
  140.  
  141.                  [@filename] selects an alternate key definition file.
  142.                  Unless an alternate  is  specified, TCII requires the
  143.                  default key definition file  TC.KEY.   This file must
  144.                  be in the same directory  as TC.COM as TCII will only
  145.                  search there.
  146.  
  147.          Operation
  148.          =========
  149.  
  150.          Press <Do> to begin emulation.   (See the command line entry T to
  151.          skip the introductory screen and hence this step.)
  152.  
  153.          Once  in  terminal  emulation, pressing <Do> and a feature letter
  154.          will activate  the various features and options.  Pressing <Help>
  155.          (or  any incorrect  key)  after  <Do>  will  provide  a  menu  of
  156.          features.  Select by letter from the high-lighted options.
  157.  
  158.          Some commands call up a sub-menu.  These are not  optional  menus
  159.          and will appear immediately you select the command.  All TC menus
  160.          will be  replaced by the previous screen display (unfeatured text
  161.          only) when command processing is finished.
  162.  
  163.          Commands (<Do> followed by...)        
  164.  
  165.              A - assign/reassign   function    key   definitions.  The
  166.                  following keys may be redefined:    
  167.  
  168.                         F6  <Interrupt>                 <Find> 
  169.                         F7  <Resume>                    <Insert Here> 
  170.                         F8  <Cancel>                    <Remove>
  171.                         F9  <Main Screen>               <Select> 
  172.                         F10 <Exit>                      <Prev Screen>
  173.                         F14 <Additional Options>        <Next Screen> 
  174.                         F17                             PF1  
  175.                         F18                             PF2 
  176.                         F19                             PF3 
  177.                         F20                             PF4
  178.  
  179.  
  180.                                        3
  181.  
  182.  
  183.  
  184.  
  185.          Release Notes - TCII V3.11 (1987 06 10)
  186.  
  187.  
  188.  
  189.          B - change baud rate.  TCII starts at whatever speed the COM port
  190.              is set, unless specified in command line.
  191.  
  192.          C - close file, end ASCII download and/or session text capture.
  193.  
  194.          D - Directory.  A path is requested.
  195.  
  196.          E - Exit to DOS, leaving DTR enabled (see Q).
  197.  
  198.          F - Select a  file  transfer  protocol  (the default is Telink or
  199.              whichever has been  selected  by command  line  option).  The
  200.              choices are:  A - ASCII T - Telink X - Xmodem
  201.  
  202.          N - new screen (clear the screen).
  203.  
  204.          P  - change parity settings.  TCII starts at whatever setting the
  205.               COM port is found to contain.
  206.  
  207.          Q - Quit to DOS, lowering DTR (see E).
  208.  
  209.          R  - receive  a   file  (download)  and/or  commence  ASCII  text
  210.               capture.  You will be asked  for  a  path  and  filename  to
  211.               receive in ASCII or XMODEM modes.  In Telink  mode  you will
  212.               simply  be  asked for a path.  Telink transmits filenames in
  213.               headers prior to sending the files.
  214.  
  215.          S or T - send a file (upload).  You will be asked for a file name
  216.               (or,  in  the  case  of Telink,  file  names).    Paths  are
  217.               acceptable as are wildcards when using the Telink protocol.
  218.  
  219.          <Print Screen> dumps the current screen to  the  printer (without
  220.               text features such as bold).
  221.  
  222.          <Ctrl-Print Screen> will commence text logging to the printer.
  223.  
  224.          Neither <Print Screen> function requires the use of the <Do> key.
  225.  
  226.          The provision of the T and P command line switches enable the use
  227.          of a Rainbow 100B as a monitoring console.  By running TC from an
  228.          AUTOEXEC.BAT  file with these options specified, the Rainbow will
  229.          restart and resume monitoring after a power failure.
  230.  
  231.         
  232.  
  233.  
  234.  
  235.  
  236.        
  237.         
  238.          
  239.         
  240.                                        4
  241.  
  242.  
  243.  
  244.  
  245.          Release Notes - TCII V3.11 (1987 06 10)
  246.  
  247.  
  248.  
  249.          File Transfer Notes
  250.          ===================
  251.  
  252.          Both Telink  and Xmodem offer checksum and CRC (cyclic redundancy
  253.          check) error checking  modes  of operation.  Where possible, TCII
  254.          will attempt to use  CRC,  the  more reliable of the two.  If the
  255.          'other end' does not respond  appropriately,  TCII will revert to
  256.          checksum operation.
  257.  
  258.          The Xmodem protocol provides the sender  with  control  over  the
  259.          error  checking  choice.    When  using Fido,  for  example,  and
  260.          downloading to TCII, use the command:  D  XC  <filename>.    When
  261.          sending  from  TCII,  if the receiving unit does not  respond  to
  262.          TCII's  attempt  to  use CRC error checking, TCII will revert  to
  263.          checksum.
  264.  
  265.          The Telink  protocol, which, in the original definition, intended
  266.          all versions to  provide  for  both  CRC and checksum, allows the
  267.          receiver to make the  selection.  TCII will respond positively to
  268.          an attempt to send it  files  using  CRC  with Telink.  TCII will
  269.          attempt to use CRC in all  transmissions  using  Telink, but will
  270.          revert to checksum at the receiver's request.
  271.  
  272.          Known Bugs and Anomalies
  273.          ========================
  274.  
  275.          With  DOS  3.10  or  higher,  <Print Screen>  functions  used  in
  276.          conjunction with Rainbow ReGIS will crash the computer.
  277.  
  278.          When used with IBM compatable printers, the <Print Screen> screen
  279.          dump  will not function, unless 'G' is specified in  the  command
  280.          line.
  281.  
  282.          File  transfer  estimates  are  monitored  and  adjusted after 15
  283.          blocks, and  every  100  blocks  there after.  TCII estimates the
  284.          remaining time according to the time taken to send or receive the
  285.          blocks already transfered.   The initial times are calculated via
  286.          modem connections, therefore it is  not unusual for times to drop
  287.          perceptivly during direct Vax to Rainbow connections.
  288.  
  289.  
  290.  
  291.  
  292.  
  293.      
  294.  
  295.  
  296.  
  297.          
  298.          
  299.          
  300.                                        5
  301.  
  302.  
  303.  
  304.          Release Notes - TCII V3.11 (1987 06 10)
  305.      
  306.  
  307.          About the Program
  308.          =================
  309.  
  310.          TurboComm was originally written in Turbo-Pascal  by Stew Stryker
  311.          of the DEC Ronnie support group (sorry,  guys,  Ronnie  is a nice
  312.          name for the dealer network, not a nifty  new  machine)  to  test
  313.          communications and Turbo-Pascal on the Rainbow.  Mr Stryker  made
  314.          the source code public.
  315.  
  316.          TCII was initially an upgrade of TurboComm, correcting one or two
  317.          minor errors and adding the Xmodem and Telink facility.  Of late,
  318.          a   large  number  of  the  original  TCII  functions  have  been
  319.          re-written in  MicroSoft  Assembler  (V4.0)  for  speed  and  DOS
  320.          function handling improvements.    In addition, the 'Keypad' keys
  321.          were  made  available  for   use  in  redefining  function  keys.
  322.          Finally,  an oversight in MS-DOS  was  corrected.    If  you  are
  323.          logging your session to a drive,  TCII verifies that the original
  324.          diskette is still in the drive before  writing.    You  are given
  325.          three  opportunities  to insert the correct diskette before  TCII
  326.          aborts logging.  ('DOS makes no checks, and actually  writes  the
  327.          original  directory,  (and  volume!),  onto  the  newly  inserted
  328.          diskette;  destroying any information stored on it).
  329.  
  330.          TCII was created  and  maintained  by Ian Fraser, of the Computer
  331.          Services Department of Keyano  College,  Fort  McMurray, Alberta.
  332.          Keyano  has released TCII executables  as  a  somewhat  supported
  333.          public domain program through the FidoNet bulletin board network.
  334.      
  335.          The source code will NOT be  made  public.  (Not that I'm mean or
  336.          selfish...  BUT now that I have  a Rainbow in my living room, and
  337.          a much better grasp of RB graphics, I  plan  to rewrite TCII in a
  338.          more flexible, and efficient language, 'C';  using my own library
  339.          of assembler routines for ReGIS conversion et al.  (I, for one am
  340.          tired  of  going  for coffee while my screen refreshs in graphics
  341.          mode...  only to find I still have time for a doughnut!). 
  342.      
  343.  
  344.      
  345.          For further information, write:  
  346.                     Ian Fraser
  347.                     % Keyano College Computer Services
  348.                     8115 Franklin Avenue
  349.                     Fort McMurray, AB, CANADA
  350.                     T9K 1K9
  351.  
  352.          Will  TCII  work on IBM PC's and compatibles?  The answer is  the
  353.          same as the answer Andy Williams gave the 'Cookie-Mad-Bear':
  354.  
  355.                     No. Not now, not ever, NEVER!!!!
  356.  
  357.      
  358.         
  359.      
  360.                                        6
  361.