* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
*                                                               *
*                       S C A N I N S T                         *
*                                                               *
*               A Terminal Installation Utility                 *
*                    For Use With SCAN.COM                      *
*                                                               *
*                              by                               *
*                          Terry Hazen                          *
*                     21460 Bear Creek Road                     *
*                      Los Gatos, CA 95030                      *
*                                                               *
*                Voice.......... (408) 354-7188                 *
*                Saratoga RBBS.. (408) 354-5934                 *
*                Zee-Machine.... (408) 245-1420                 *
*                                                               *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *


Revision History
----------------

01/10/89      Based SCANINST on TCSELECT to install Z3TCAP files
  v1.0        into SCAN.COM for use under non-ZCPR3 systems.
                       - Terry Hazen

=================================================================


Overview
--------

SCANINST.COM is used to install a Z3TCAP (Zcpr3 Terminal
Capabilities) terminal definition into SCAN's internal Z3TCAP
area when SCAN is to be run in a non-ZCPR3 environment, such as
CP/M.   It allows the user to easily select a standard terminal
Z3TCAP terminal definition to match his terminal from the
selection of terminals contained in the standard file of ZCPR3
terminal capabilities, Z3TCAP.TCP, and to install it into SCAN.

An internal Z3TCAP is not required when SCAN runs in a ZCPR3
environment unless you wish to load an internal Z3TCAP to allow
you to customize it for SCAN operation without needing to modify
your normal system Z3TCAP, or if you wish to run the same copy of
SCAN in ZCPR3 and non-ZCPR3 environments.

It should be noted that specific terminal definitions in the
Z3TCAP.TCP file furnished with this library may not include the
new extended control sequences.  As users define extended
Z3TCAPs for more terminals, upgraded Z3TCAP.TCP files containing
the extended definitions will probably be distributed and may be
used with SCANINST.  You may, however, use the information on the
structure of the extended Z3TCAP contained in Z3TCAP.DOC to patch
the Z3TCAP terminal definiton you have loaded into SCAN to
include delete line, insert line, if you desire, or you may patch
the lelete and insert line sequences directly into SCAN's
internal locations for use with a standard Z3TCAP, as covered in
SCAN.PAT.

In order to use SCANINST, the files SCANINST.COM, Z3TCAP.TCP and
SCAN.COM must all be on the logged drive/user.  If you have
renamed SCAN.COM, you must specify the new name on the command
line.

Since SCANINST installs the Z3TCAP into the second record of the
specified file, it should not be used to attempt to install a
Z3TCAP into any file other than SCAN.COM, as it will overwrite
the second record in that file with terminal information.


Syntax
------

SCANINST's command line syntax is:

     SCANINST [filename[.typ]]     (The default is SCAN.COM)

For a help screen display, the syntax is:

     SCANINST ? or //

When no filename is specified, the selected terminal will be
installed into SCAN.COM.  If you wish to install a terminal
selection into a renamed SCAN, specify the filename on the
command line.  If no filetype is specified, '.COM' is the default
filetype.  No wildcard filename/filetype specifications may be
used.

The operation of SCANINST is menu-driven and should require no
detailed explanation.  When you have made and confirmed your
terminal selection, SCANINST will write the installed file back
to disk.  You may reinstall another terminal into SCAN at any
time by running SCANINST again.  You may also patch SCAN to
ignore the currently loaded internal Z3TCAP by patching the first
byte of the Z3TCAP (the terminal name) to a space (20h)
character.

If you run SCAN in a non-ZCPR3 environment, you must also patch
the number of lines and columns used by your terminal into
SCAN.  Since these values are not contained in the Z3TCAP
file that was installed, you must patch them directly.  See
SCAN.PAT for further patching information.

After you have installed your terminal, you may find that you
would like to tune up your terminal installation in some way or
add the delete and insert line terminal control sequences.  You
may also further patch SCAN to modify the terminal control
sequences and to alter other aspects of SCAN's operation.
Consult your terminal manual and see Z3TCAP.DOC for information
on the structure of the extended Z3TCAP.

=================================================================