home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / compuserve / P-Code / TEPDOC.CMB < prev    next >
Text File  |  2006-10-19  |  9KB  |  241 lines
  1. {
  2. TE-p
  3.  
  4.           TE-p written by Andy Cooper
  5.  
  6.     TE-p is a minimally featured P-System Terminal
  7.     emulator program, incorporating the Xmodem file
  8.     transfer protocol, written to encourage the
  9.     development and exchange of 99/4A Pascal software.
  10.     TE-p recognizes most of the cursor control codes of
  11.     the DEC VT52 terminal. It is written in a combination
  12.     of Pascal and assembly language.
  13.  
  14. Miscellaneous
  15.  
  16.     When using an information service or BBS, if the host
  17.     allows terminal type to be set use ....
  18.  
  19.     VT52, width 40, length 24
  20.  
  21.     Note that some services such as DELPHI add a prompt
  22.     at the end of each page which will scroll the text
  23.     up. You may have to experiment with the the length
  24.     attribute (eg 21). In addition you may have to set
  25.     wrap at EOL (CNTL 4) false to eliminate blank lines
  26.     after a 40 character line is transmitted from the
  27.     host with a cr and lf.
  28.  
  29.     TE-p Xmodem file transfer presently supports only
  30.     "checksum" verification however future versions
  31.     will add CRC error detection. I have noticed that
  32.     on my node, TYMNET adds substantial delays between
  33.     each record (5-8 seconds) when uploading. Down loading
  34.     appears to be unaffected. For this reason I use
  35.     UNINET to upload even though it is a toll call fo me.
  36.  
  37.     If you wish to transfer a file directly from one
  38.     system to another using TE-p then one system must
  39.     assume the role of "host". The host will operate in
  40.     half duplex mode and echo received data back to the
  41.     "terminal" mode system. The only problem with this
  42.     setup surfaces if you have a smart modem. When in
  43.     command mode a smart modem will echo transmitted
  44.     data back to the system causing a continuous loop.
  45.     To avoid this situation establish the connection
  46.     with both systems in "terminal" mode. After the
  47.     modem on the system that is to be the host has
  48.     switched from command to data mode exit from TE-p
  49.     (FCTN =), restart with the "U" command and select
  50.     H to enter host mode. You may then exchange messages
  51.     with the other system (line feed is CNTL j) and at
  52.     a mutually agreed upon time one system will initiate
  53.     Xmodem receive (CNTL 6) and the other Xmodem
  54.     transmit (CNTL 5).
  55.  
  56.  
  57. To Initiate
  58.  
  59.     Before running TE-p the characteristics of the
  60.     datacom port and the printer port should be set up
  61.     using MODRS232. This is done from the main command line
  62.     by invoking the eXecute command (press x) and responding
  63.     to the prompt with MODRS232 or #n:MODRS232.
  64.  
  65.     To set up the printer respond to the prompt from
  66.     MODRS232 with "p" and then enter the port description.
  67.  
  68.     eg PIO
  69.  
  70.     Re start MODRS232 with user restart command from the
  71.     main prompt line (press u).
  72.  
  73.     To set up the datacom port press "r" at the prompt.
  74.  
  75.     In order to use the Xmodem transfer protocol the
  76.     datacom port must be set to 8 bit no parity. Note
  77.     that TE-p strips off the parity bit when operating in
  78.     emulation mode so communications with (most) hosts
  79.     should not be affected. At the prompt enter the datacom
  80.     parameters as follows.
  81.  
  82.     RS232/1.BA=1200.DA=8.PA=N
  83.               or
  84.     RS232/1.BA=300.DA=8.PA=N
  85.  
  86.     (RS232/2 may be used in place of RS232/1 in the
  87.     above examples.)
  88.  
  89.     To initiate TE-p invoke the eXecute command from the main
  90.     command line (press the "x" key) and respond to the
  91.     prompt with TEP or $n:TEP if the code file is not on
  92.     the default volume. The initial menu describes the
  93.     special key sequences used with TE-p. To begin
  94.     terminal emulation press any key other than "h" or "h".
  95.     See the previous section for a description of the host
  96.     option.
  97.  
  98.  
  99. Special Keys
  100.  
  101.     There are a number of key sequences that TE-p recognizes
  102.     as special commands. They are described below.
  103.  
  104.     CNTL 1 - Change the screen color
  105.  
  106.     CNTL 2 - Print screen image
  107.  
  108.     CNTL 4 - Toggle wrap at end of line (Default off)
  109.  
  110.              If this option is on a cr and lf are done
  111.              automatically when the cursor reaches the
  112.              end of the line (column 40). When signed
  113.              on to a host and your terminal width is set
  114.              to 40 you should turn wrap off to avoid a
  115.              blank line if the host sends a 40 character
  116.              line with cr and lf.
  117.  
  118.     CNTL 5 - Start Xmodem transmit
  119.  
  120.     CNTL 6 - start Xmodem receive
  121.  
  122.  
  123.     FCTN S - transmit DEL (7Fh)
  124.  
  125.     FCTN 9 - Abort Xmodem transfer
  126.  
  127.     FCTN = - exit TE-p
  128.  
  129.  
  130. Xmodem transmit (upload)
  131.  
  132.     To transmit a file to the host system using the Xmodem
  133.     protocol invoke the appropriate host commands and
  134.     specify binary (or not text) format. Wait for the host
  135.     prompt to begin sending the file. Press CNTL 5 and
  136.     enter the P-System file name to be uploaded.
  137.  
  138.     eg #5:program.code
  139.  
  140.     TE-p waits for the host to send a NAK (checksum) and then
  141.     begins to transmit the file. If the transfer aborts for
  142.     any reason other than a cancel (18h) from the host, TE-p
  143.     transmits a CAN then returns to the emulator.
  144.  
  145.     If you wish to abort the transfer for any reason press
  146.     FCTN 9 at any point. TE-p will send a CAN to the host
  147.     and return to the emulator.
  148.  
  149.  
  150. Xmodem receive (download)
  151.  
  152.     To retreive a file from the host (download) using the
  153.     Xmodem protocol invoke the appropriate host commands
  154.     and wait for the prompt to start receiving. At this
  155.     prompt press CNTL 6 and enter the P-System file name
  156.     for the downloaded file.
  157.  
  158.     eg #4:source.text
  159.  
  160.     TE-p sends a NAK (15h) to indicate checksum error
  161.     detection and begins receiving.
  162.  
  163.     If you wish to abort the transfer press FCTN 9 at any
  164.     point. TE-p will send a CAN to the host and the
  165.     partially received file will be purged.
  166.  
  167.  
  168. Note
  169.  
  170.     If an Xmodem file transfer aborts TE-p sends a CAN to
  171.     the host. Some hosts may require a different sequence.
  172.     eg DELPHI requires 3 ETX's (CNTL C) which should be
  173.     sent from the keyboard.
  174.  
  175.     If TE-p receives an ESC sequence that is not implemented
  176.     a "[" is displayed followed by the escape parameters.
  177.  
  178. ****************************************************************************
  179.  
  180.      NEW TEP  Andy Cooper's fast new version of TE-p emulates a VT52
  181.               terminal at speeds up to 9600 baud (4800 if continuous high
  182.      -speed scrolling is needed.  This version also supports 40 column
  183.      windowing in an 80 column screen buffer using the conventional TI
  184.      P-system function keys.  The Xmodem transfer routine has been modified
  185.      to allow transfers of large files up to the limit of your disk
  186.      capacity.  P-system users are indebted to Andy for this significant
  187.      refinement of his outstanding communication program for the P-system.
  188.      The documentation below comes from correspondence with Andy during the
  189.      development of this program and supplements Andy's original TE-p docs.
  190.  
  191.      Escape Sequences    Action
  192.  
  193.          ESC A           Cursor UP
  194.          ESC B           Cursor DOWN
  195.          ESC C           Cursor FORWARD
  196.          ESC D           Cursor BACKWARD
  197.          ESC E           Clear display
  198.          ESC H           Cursor home
  199.          ESC I           Reverse Index
  200.          ESC J           Erase to end-of-screen
  201.          ESC K           Erase to end-of-line
  202.          ESC L           Insert line
  203.          ESC M           Delete line
  204.          ESC Y ...       Direct cursor addressing
  205.  
  206.      Control Sequences
  207.  
  208.      With few exceptions the CTRL combinations are the standard ones used
  209.      in the P-system keyscan, i.e., CTRL a through CTRL z send ASCII
  210.      characters 01 through 26 (SOH through SUB).  The exceptions are:
  211.  
  212.         CTRL  <space> or <@>  -------------> NUL (ASCII 00)
  213.         CTRL    <;>    --------------------> ESC (ASCII 27)
  214.         CTRL    <<>    --------------------> FS  (ASCII 28)
  215.         CTRL    <=>    --------------------> GS  (ASCII 29)
  216.         CTRL    <>>    --------------------> RS  (ASCII 30)
  217.         CTRL           (control key alone)-> US  (ASCII 31)
  218.  
  219.      In normal ASCII communication mode (not XMODEM) TE-p responds only to
  220.      the ASCII control codes for backspace, linefeed, and carriage return.
  221.  
  222.      Special Control and Function Keys
  223.  
  224.         CTRL 1           Change screen color
  225.         CTRL 2         * Print screen
  226.         CTRL 3           Change cursor (underscore/block)
  227.         CTRL 4           40/80 column mode (Default = 40)
  228.         CTRL 5           Xmodem Transmit
  229.         CTRL 6           Xmodem Receive
  230.  
  231.         FCTN 7           Window Left (80 col mode only)
  232.         FCTN 8           Window Right (80 col mode only)
  233.         FCTN 9           Abort Xmodem transfer
  234.         FCTN =           Exit from TE-p
  235.  
  236.         FCTN <s> or <S>  Transmit DEL (ASCII 127)
  237.  
  238.      * will hang if PIO or printer off
  239.  
  240.             6-07-86 Jerry Coffey  JERRYC  [74716,3525]  TI5237
  241.