Crawly Crypt Collection 1/crawlyvol1.bin/telecomm/ansi190/ansi190.doc

Text File | 1992-03-27 | 21KB | 434 lines

ANSITerm                                                 By Timothy Miller
Version 1.9                                            Two Worlds Software
Documentation by Timothy Miller & Sean Dougherty

(c) Copyright July, 1992 Timothy Miller, Two Worlds Software

 NO PORTION OF THIS PROGRAM MAY BE MODIFIED, DISASSEMBLED, DECODED,
 OR REMOVED BY ANY MEANS WITHOUT PRIOR PERMISSION OF THE AUTHOR.
 NO PORTION OF THIS PROGRAM MAY BE USED IN ANY OTHER PROGRAM.  THE
 ABOVE ALSO APPLIES TO THE FONT FILE INCLUDED WITH ANSITERM.
 ALL OTHER RIGHTS RESERVED.

 THE USER IS AUTHORIZED TO USE THE PROGRAM ANSITERM.  HE HAS
 PERMISSION TO DISTRIBUTE THIS PROGRAM, AT NO COST.  NO PROFIT MAY BE
 DERIVED OUT OF THE SALE OF THIS PROGRAM WITHOUT THE SPECIFIC
 PERMISSION OF THE AUTHOR.

 THE USER IS PERMITTED TO USE THE ANSITERM PROGRAM FOR A TRIAL PERIOD
 OF THIRTY DAYS, AFTER WHICH TIME, THE USER MUST SEND THE $15
 REGISTRATION FEE TO THE ADDRESS LISTED BELOW.  IF, AFTER THIRTY DAYS,
 THE USER HAS NOT REGISTERED ANSITERM, ANSITERM MUST BE REMOVED FROM
 HIS COMPUTER SYSTEM.  PIRACY IS NOW A FELONY!

The author, Timothy Miller, can be contacted as:
      Timothy Miller             - Excalibur II BBS [phone]
      Timothy Miller             - Flea Infested BBS [phone]
      T.MILLER23                 - GEnie
      [e-mail]  - Internet
      [e-mail]  - Internet


The following files are part of the ANSITerm package:
   ANSI190.PRG
   ANSI190.DOC
   FONT48.DAT
These files MUST be included.  All other files are optional, except
XYZ which is necessary for file transfers.

ANSITerm's Features (* = New to version 1.5B, % = Updates for v. 1.8)
                    (& = Updates for v. 1.9)

   - ANSITerm is a 100% ANSI VT-102 compatible terminal program that
     supports full 16 colors, blinking text, with 80 columns.
   - Supports X-modem, Y-modem, and Z-modem transfers (using XYZ.TTP)
   - Full mouse support and menu bars
   - AutoDialer with separate options (line-feeds, local echo, etc.)
     for every entry.
   * Capture buffer with the ability to send and print selected blocks
   * Selectable color palettes
   * New intelligent memory saving techniques
   * View Buffer and block functions
   * Auto Z-modem Download and Upload
   * Ten 79-character global macros
   * Upload/Download paths can be set along with the path of XYZ.TTP
   % Better compatibility with Warp 9
   % "Can't find XYZ.TTP" bug fixed.
   % Properly supports VT-100 tabs
   % Supports Y-modem G with Alan Hamilton's XYZ 2.02
   % Buffer viewer now has PRIMITIVE editing capabilities
     and displays text 4 times faster
   % 57600 bps MIGHT work on an Atari TT
   % Terminal displays text at least 2 times faster
   & ANSITerm now supports underlined text
   & Type-ahead buffer now takes up the entire width of the top line
   & Buffer editor Delete Block bug fixed.
   & An escape character can now be typed into the editor (HELP key)
   & Character for <CR> (#13) in font has been changed to something
     meaningful.  Character for <LF> (#10) has been shifted right
     by one pixel so it doesn't jam up against the new <CR>.
   & The dialer will now properly dial all 14 telephone number
     digits.

   NOTE:  The filename of the dialer and options file that is loaded
 when you run the ANSI190.PRG program is STILL "ANSIDIAL.15B".

   NOTE ALSO:  When going to a file selector, ANSITerm will sometimes
 appear to lock up.  Just try hitting a few mouse buttons and the
 file selector should appear.  A similar situation occurs sometimes
 when exiting ANSITerm.

ShareWare Info

      This program is shareware and I have put much time into making this
 into the best terminal program possible. If you use and like this program,
 please support the author and allow him to make future upgrades by sending
 a $15 donation or more to:

       Timothy Miller
       7519 Winging Way Drive
       Tampa, FL  33615-1519
       U.S.A.

       Please make checks payable to Timothy Miller.  All users in the
       U.S.A. who register CAN REQUEST free updates by mail.


File Transfers

     File transfers can be accomplished through the use of Alan Hamilton's
   XYZ file transfer program. I have found no way to keep the program
   in memory and call it when needed, so ANSITerm must load it each time
   you transfer a file.  For hard-drive users, this is not a problem
   since ANSITerm remembers where XYZ is, but for floppy disk users, it
   requires extra effort.  ANSITerm will not allow you to swap floppys
   (load XYZ from one and transfer to/from another) so the use of a RAM
   disk is recommended for this purpose.  You can set ANSITerm to load
   XYZ from the ramdisk.  (With a one floppy system, telling ANSITerm to
   load XYZ from drive B: may have unpredictable results if ANSITerm is
   loaded from Medium Res.  The alert box may not display right.  Try it
   at your own risk.)

Menu Bars

      To select a menu, click on the title.  To make it go away, click
   on the title again, outside of the window or on another title.

Auto DIALer Menu

       To select a slot that has not been selected, click anywhere on the
    line except for the field which says DIAL.

    To insert a one-second pause in any editing fields sent to the modem,
    press [F10].  This works for all macros.  To insert a pause into
    the phone number, most modems require a comma.

    |DIAL|
      If you click on DIAL on any line which has not been tagged for
      group dial, that slot will immediately be selected, the dialer
      will go away, and the telephone number listed in that
      slot will be dialed.  If that slot has been tagged for group
      dial, the dial cycle will begin.
    |J|   (group dial)
      If you click in the small field between DIAL and the name field
      of a selected slot, that field will be tagged for group dial.  If
      you click in that field again, the slot will be untagged.
    |BBS Name       |
      The next field to the right is the name field.  Click here to
      edit.  Left and right arrow keys move the edit cursor left and
      right.  Delete removes the character that the cursor is on and
      moves all characters to the right left to fill in the space.
      Backspace deletes the character to the left of the cursor and
      moves all characters at the right of the cursor to fill in the
      space.
    |I|
      Initialize string.  This allows a string containing optional
      modem commands to be sent to the modem before the command to
      dial is sent.
    |Phone number|
      To the right is the phone number field.  Click here to edit the
      phone number as you would for the name field.
    | Baud|
      Click here repeatedly until the baud rate you want is displayed.
      The baud rate numbers have been shortened to provide greater space,
      and the numbers are the baud rate divided by one hundred.
    |Options      |
      Each column of this field corresponds directly to an option in the
      options menu, essentially the same order.  They are also listed
      in the help menu.  The meanings of the symbols are listed with
      the OPTN menu information in this manual and below:
         W:  End of line wrap             B:  Destructive back space
         E:  Local Echo                   A:  Application mode
         R:  Cursor Application mode      N:  New line and line feed mode
         G:  IBM Extended Character Graphics Set
         L:  Enable blink
      ZYKXCG:  Transfer protocol
             Z:   Z-modem
             Y:   Y-modem (batch)
             K:   X-modem 1k
             X:   X-modem (standard)
             C:   X-modem checksum
             G:   Y-modem G  (for use with error correcting modems)
         C:  Capture enable               F:  Filter ANSI codes
         Y:  Type-ahead buffer
    | F1: | F2: | F3: |  Macros
      There are 3 44-character macros for each slot in the dial menu.
      To edit one, select a slot, and click on the macro you want to
      edit.  Edit as you would for the BBS name.  A return character is
      NOT automatically transmitted at the end of the macro, so you must
      put one in manually, by pressing the Enter key on the numeric
      keypad.  In fact, any non-printing character (<ESC>, LF, FF, etc.)
      can be entered into the macro editing field and transmitted as part
      of the macro.  To transmit the macro while on-line, press the
      function key corresponding to the macro you wish to send. To insert
      a one-second pause, press F10 in the editing field where the pause
      is needed.

Options (OPTN) Menu

    End of line wrap
       With this option off, any character printed at the right most
       column will overwrite any character at that position without
       wrapping to the next line.
    Destructive backspace
       When this mode is on, if a backspace character is received,
       the cursor will back up one column and erase any character at
       that position.  If this is not selected, the cursor will back
       up on column, but not erase any character there.
    Local Echo
        When this option is selected, any keys that you press will be
        automatically displayed on the screen as well as transmitted.
        (half duplex mode)
    Application mode
        If this mode is on, the keys on the numeric keypad will send
        ANSI escape sequences instead of the characters which appear
        on the keytops.
    Cursor key application mode
        The cursor keys normally send ANSI escape sequences to the
        modem when pressed.  If this option has been selected, a
        different set of escape sequences will be transmitted by
          the same keys.
    New-line and line feed mode
        If this option is selected, linefeed implies both return and
        linefeed, and the return key sends both return and linefeed.
    IBM Extended Character Graphics Set
        If this mode is on, any characters with a value greater than
        127 will cause graphics characters to be displayed.  If this
        mode is off, any such characters will have their most significant
        bit stripped.  This is for boards and on-line services that
        insist on using set or even parity.
    Enable blink
        When this is selected, all characters that have been printed
        with the blink attribute set will flash on and off at regular
        intervals.
    Dial Command
        When you click on this, you can edit the command that ANSITerm
        sends to the modem to make it dial.  For example, "ATDT" for
        tone dial, "ATDP" for pulse dial, or "ATDT70#," for tone
        dial, call waiting off, and the comma for a pause.
    RTS/CTS
        Enables RTS/CTS hardware flow control. Most ST users require
        a fix program for this to operate properly.
    Dial timeout
        This allows you to set the number of seconds the cycle dialer
        waits before skipping to the next board selected for group
        dial. Click on this line to edit. If a 0 (zero) is entered,
        NONE is displayed and the cycle dialer will wait until either
        the modem or the user tells it to skip to the next selected
        slot.
    Edit Macros
        Allows you to edit the 10 global macros.  Shift and a function
        key selects the macro to be edited (RETURN lets you finish
        editing), and <ESC> lets you exit back to the terminal.  To
        insert a one-second pause into a macro, press the F10 key.  To
        transmit a macro, hold the shift key and press a function key.
        The Alternate-M key combination also starts the macro editor.
    Set Loadup Macro
        When ANSITerm is first booted this macro is sent to the modem,
        unless the DCD (Carrier Detect) line is high.
    Quit
        Selecting this causes ANSITerm to exit to the program which
        called it (or the GEM Desktop).  This can also be selected by
        pressing the UNDO key.
    o The OPTN menu will not go away if you select one of the options
      so you have the chance to select or deselect more than one option
      before clicking outside of it to remove it from the screen.

Select BAUD Menu

       You can click in this menu to select your baud rate.  38400 bps
   and 57600 bps are supported, but reliable operation cannot be assumed.

FILE Menu

   Download
       Loads XYZ from disk (or RAMDISK) to transfer a file.  If
       Z-modem or Y-modem is selected, transfer will start immediately
       to the folder you select with the Set D/L Path option.  If
       any other protocol is selected, you will immediately get a
       file selector.  This can also be selected with the Alternate-D
       key combination.
   Upload
       Loads XYZ just as Download, but it always gives you a file
       selector so that you can select the file to be uploaded (or
       wildcard for Z-modem or Y-modem).  This can also be selected
       with the Alternate-U key combination.
   Z-modem, etc.
       Click on one of these to select which protocol you want to use
       at the moment.  As with the OPTN menu, this menu will not go
       away if you select one of the protocols, so you can immediately
       select upload or download without having to reselect the menu.
   Save Dialer/OPTN
       Saves the contents of the DIAL menu, the default download path,
       and the Dial timeout to disk.  If you are using floppy disks
       and running XYZ from a RAMDISK, be sure to save to the floppy disk.
       This also saves the options download/upload path, dial
       timeout, buffer size, delay timing, dial command, buffer
       installed/uninstalled status, color palette number, Loadup Macro,
       baud rate setting, RTS/CTS status, CR/LF filter status, Auto
       Z-modem selected/deselected, and the ten global macros.
   Load Dialer/OPTN
       Loads a dialer from disk and the options with it.  ANSITerm can
       indirectly support more than one dialer menu and set of options
       this way.
   Set D/L Path
      This allows you to pre-set the path to which Z-modem and Y-modem
      downloads will be saved.  Clicking here will give you a
      file selector.
   Set U/L Path
      This allows you to pre-set the path to which uploads will be
      directed.  Clicking here will give you a file selector.
   Set XYZ Path
      This is the path of the program, XYZ.TTP, to enable ANSITerm's
      download and upload options.
   Auto Z-modem
      This selection gives ANSITerm the ability to detect Zmodem uploads
      and downloads independant of XYZ. If either an upload string or
      download string is detected, ANSITerm immediately runs XYZ if this
      function is on.


Capture Buffer (BUFR) menu

      If the buffer becomes 75% full, the 'Bufr' menu will change to
   '75%+'.  If, while transmitting the buffer, you suspend sending
   by pressing Alternate-S, the menu will change to 'Suspnd'.
   If the buffer fills completely, the menu will change to 'Filled'.

   Install Buffer
      Allocates the amount of memory specified by the Bufsize editing
      field and makes it available for capturing modem input, screen
      snap-shots, and loading files from disk for transmit or editing.
   Capture
      When selected, all characters that come from the modem will be
      added to the buffer.
   Filter ANSI
      In this mode, all ANSI escape sequences are filtered out and
      only ASCII text may be added to the buffer.
   Load buffer
      Clears the buffer and loads the specified file into it.
   Save buffer
      Saves the current contents of the buffer to disk.
   Clear buffer
      Empties the buffer.
   Print buffer
      Sends the current contents of the buffer to the printer.
   Send buf
      Sends the current contents of the buffer to the modem and filters
      linefeeds and/or carriage returns according to the setting in
      Edit Buffer.
   Bufsize
      You can edit this field if the buffer is NOT installed to
      change the size of the buffer.  To change the buffer size,
      you must not have a buffer installed.
   Delay
      This specifies the time (in 1/200 second units) that Send Buf
      (and send block from the buffer editor) waits between characters
      while sending data.
   FreeMem
      This is not an option but rather a window that tells you how much
      free memory you have.
   Used
      This also not selectable, but tells you how many bytes have been
      added to the buffer.
   Type Ahead
      This activates the type ahead buffer. The buffer can contain up to
      512 ASCII characters and control characters. The Keypad Enter will
      insert <CR> (and <LF> if NewLine/Line Feed is on), the [HELP] key
      transmits the buffer contents without a <CR> and the optional <LF>,
      [F10] will insert a one second pause (this also works for the
      various other editing fields that output to the modem), Up arrow
      moves to the beginning, and the down arrow moves to the end.
   Edit Buffer
      This option switches to the edit buffer screen.  ALT-V also
      activates this.
        Keys: [ESC] - Quits Edit Buffer mode,
              [HELP] - types an escape character.
              [UP/DOWN/LEFT/RIGHT ARROW] - Moves cursor,
              Shift-Up - Pages Up, and  Shift-Down - Pages Down
           ^A=Redraw screen   ^T=Top of buffer  ^F=Bottom of buffer
           Blocks:   ^B=Begin  ^E=End  ^U=Hide  ^S=Transmit  ^P=Print
                     ^D=Delete
           Filters:  ^R=Return  ^L=Line Feed
       IMPORTANT: These functions filter Returns and Linefeeds out
               the selection to transmit in the editor and ALSO from the
               complete buffer contents send from the terminal screen.
  At the request of one of my betatesters who wanted to manually enter
  ANSI escape sequences into the buffer editor, I have made the HELP
  key type an escape character into the buffer.

HELP menu

      This menu has no selections.  It gives an abridged list of
   the dialer options and short-cut key combinations.
   Special key combinations available:
   F1 to F3     Send macros corresponding to the current dialer slot
                selections.
   F5           Resets printing colors to white text, black
                background, no blink, not bold, etc. for all
                characters received after this is selected, until
                an ANSI escape sequence is received that changes
                the colors.
   F6           Prints the contents of the screen to the printer.  If
                the printer is off-line, you will hear a bell ring.
                This does not print a bit-map of the screen, but
                rather the actual letters.  Bold is emphasized (bold),
                and blinking is italicized.  Drop-down menus will not
                be printed even if they are down when F6 is pressed.
   F7           Capture screen contents to the buffer
   F8 or Alt-H  Causes the modem to drop carrier.
   F10          Inserts a one second pause into an editing field.
   Alt-D        Download               Alt-U        Upload
   Alt-C        Capture                Alt-T        Send Buffer
   Alt-S        Suspend Send           Alt-Y        Type-ahead
   Alt-V        Edit Buffer            UNDO         Quit ANSITERM
   Alt-M        Edit Global Macros     HELP         (see Type Ahead buffer)
   Clr/Home     Clears the Type-Ahead Buffer

COLR menu
   There are 4 selectable color palettes.  Palette #1 is the default,
   unless you save the dialer file while another palette is enabled.

Other

   A yellow "C" on a red background will appear in the upper right corner
   if CAPS LOCK is on.

Acknowledgments

     I would like to thank the following people for testing ANSITerm
   for me:
       Sean Dougherty (another member of Two Worlds Software)
       B.J. McKinney (SysOp of The Flea Infested BBS -- [phone])
       Clifton Mothershed
       Conan Ford (In Canada!)

     And we can't forget plaudits to Alan Hamilton for his XYZ file
   transfer utility.  Be sure to register this too!

The official TWS support BBS
      Excalibur II BBS -- [phone]
      SysOp: Aaron Oneal