home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / ddjmag / ddj8910.arc / SMITH2.ARC / CTERM1.DOC < prev    next >
Text File  |  1989-04-27  |  6KB  |  148 lines
  1. Doc file for CTERM1 (as distributed by Donald W. Smith)
  2.   Current version 1.11, dated 4/26/89
  3.   Nothin' fancy terminal emulator.
  4.  
  5. BASIC FEATURES:
  6.   Emulates conversational (only) mode Tandem 6520/30 terminal.
  7.   Allows for capture to PC disk file of Terminal sessions
  8.     (Removes junk control characters)
  9.   Implements a speed independent (11 character times) break signal.
  10.   Does not require any external drivers or libraries.
  11.   Xmodem file transfer (send and receive) supported.
  12.     CRC and checksum are available, CRC is preferred.
  13.     Single file, 128 bytes blocks are used.
  14.   DOS Services are available without leaving the program.
  15.   All control characters (except selected ESCAPE char) can be sent.
  16.   High speed interrupt driven receiving.
  17.   Configurable for either COM1 or COM2.
  18.   Small model object file (25K of code)
  19.  
  20. NON-FEATURES:
  21.   Single screen only - It's gone if it scrolls off the screen.
  22.   NO fancy status lines, or exploding windows.
  23.   NO Storage of phone numbers
  24.   NO BLOCK MODE.
  25.     Some Tandem Pathway environments will not accept NO BLOCK MODE for
  26.     an answer.  M6530 is one example.  It will try to force the terminal
  27.     into block mode forever, no matter what control key combination,
  28.     break key, or whatever you send back.
  29.   NO Odd parity.  Sorry DEC.
  30.   NO ANSI graphic screen support.
  31.   NO Y or Z modem, or Kermit or CIS B. (yet)
  32.  
  33. COMMAND LINE OPTIONS:
  34.   cterm1 [ -b -c<n> -s<baud> -e<char> ]
  35.     -b  BBS mode (8,1,N).  Defaults is T16 mode (7,1,E).
  36.     -c  Com port 1 or 2.   Defaults to 1.
  37.     -s  Initial baud rate. Defaults to 1200.
  38.     -e  Escape character   Defaults to Esc key.
  39.  
  40.   Example:
  41.    CTERM1 -b -c2 -e0x1a -s2400
  42.    -b      Turns bbs mode on (8, 1, NO Parity)
  43.    -c2     Com2 will be used
  44.    -e0x1a  Escape character is now 1A hex (26 decimal), ^Z
  45.             Note:  0xnn for hex, 0nn for octal, nn for decimal
  46.    -s2400  Initial baud rate to 2400 bps.
  47.  
  48. MODES OF OPERATION:
  49.   Command Mode:  Top of the "mode" tree.  Only first character is required.
  50.     C(onfig) = Enter Config mode
  51.     D(os)    = Spawn a DOS shell and send selected command
  52.     H(elp)   = Shows a short list of commands (these)
  53.     Q(uit)   = Exit to DOS
  54.     R(cvx)   = Receive a file using Xmodem
  55.     S(endx)  = Send a file using Xmodem
  56.     T(erm)   = Enter Terminal mode.
  57.  
  58.   Config Mode:
  59.     Displays current configuration (read directly from UART)
  60.     Prompts for changes:
  61.     0 = T16 mode (7 bits, 1 stop bit, Even parity)
  62.     1 = BBS mode (8 bits, 1 stop bit, None parity)
  63.     <other number> may be any of the available baud rates including:
  64.         50,   75,  110,  135,  150,  300,  600,  1200,
  65.       1800, 2000, 2400, 3600, 4800, 7200, 9600, 19200,
  66.       28800, 38000, 57600.
  67.     Returns back to Command mode after each entry.
  68.  
  69.   Term Mode:
  70.    Term Mode Keys:
  71.      BREAK:  Ctrl-Scroll Lock (usually marked Break as well)
  72.      PgUp:   Upload a file using xmodem (from PC)
  73.      PgDn:   Download a file using xmodem (to PC)
  74.      Ins:    Toggle ON/OFF capturing to disc
  75.      Esc:    (default) Return to command mode
  76.                This may be changed by a command line param.
  77.  
  78.    Capture Operation:
  79.      From terminal mode, logging to disk is toggled with one key (Ins)
  80.      When initially started, it asks for a file name (defaults to capture.fil)
  81.      The next time the Ins key is used, capturing is stopped and the file
  82.        is closed.
  83.      Capturing works best to hard disc.  No large memory buffer is allocated.
  84.      Capture mode always remembers the last file name used.
  85.      If you choose the same file, the new data will be appended to it.
  86.      Capturing can survive leaving term mode and returning.
  87.        (You might use DOS LIST to "scroll back" a long ways!)
  88.      The capture file is closed upon normal exit of the program.
  89.  
  90.   Xmodem Send Mode:
  91.     Prompts for filename to send.
  92.     Shows an estimate of transfer time.
  93.     Waits for initial sync character and sends file.
  94.     Block number being sent is displayed on screen to show progess.
  95.     Esc will abort transfer and return to Term mode.
  96.     Displays a message noting success, or reason for abort.
  97.  
  98.   Xmodem Receive Mode:
  99.     Prompts for filename to receive.
  100.     Sends initial sync character (favors CRC, does either).
  101.     Progess signal (dots) displayed on screen to show progess.
  102.       R stands for retry
  103.     Esc will abort transfer and return to Term mode.
  104.     Displays a message noting success, or reason for abort.
  105.  
  106. Xmodem File transfer supports:
  107.   Files of up to 10,000 records (1.280 Mb)
  108.   Speeds from 50 - 57600 are supported.
  109.   Works from either configuration (8,1,N) and (7,1,E).
  110.   Only 128 size records supported at present.
  111.   Both CRC and Checksum transfers are supported.
  112.     CRC is preferred.  It will take longer to start checksum transfers
  113.     since I am hoping for a "hunting" (alternating) NAK/CRC.
  114.   Single file only transfer is supported.
  115.  
  116.  
  117. Operation:
  118.   Initially, the program installs the receiver interrupt handler
  119. and posts a status message.  Command mode is entered no matter what
  120. params are passed to the program.  A prompt of the program name is
  121. shown, awaiting the following commands:
  122.  
  123.   Config  : Set up comm parameters.
  124.   Dos,    : Calls DOS with commands.
  125.   Help,   : See this help info.
  126.   Quit    : Exit program.
  127.   Rcvx,   : Receive file using Xmodem.
  128.   Sendx,  : Send file using Xmodem.
  129.   Term,   : Dumb terminal mode.
  130.  
  131.    The default configuration of 1200, 8, 1, None.  A menu is always
  132. available by entering either a blank line or Help. All commands can be
  133. abbreviated as the first letter of the command, or the entire word may
  134. be keyed in.  Upper and Lower case are equal.
  135.    To return to command mode, use the ESC key.
  136.  
  137. Caveat Usor:
  138.    This program dabbles with comm (and ^C) interrupt vectors, and should
  139. NEVER exit back to DOS abnormally.  If it does, please forward me the
  140. sequence of events that led up to it, as specifically as you can
  141. remember.
  142.    IF THIS OCCURS, YOUR MACHINE SHOULD BE RE-BOOTED.  Incoming charcters
  143. may force the system off into the weeds.
  144.    Also, I have tried the xmodem protocol against what I believe to be
  145. a wide variety of BBS's and systems from Osbornes to Tandems to Macs.  If
  146. you have a failure, please note the type of system, if it is repeatable,
  147. and if/how I can get onto it to use the trusty old datascope.
  148.