* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
*                                                               *
*                       S C A N I N S T                         *
*                                                               *
*                A Z3TCAP Installation Utility                  *
*                    For Use With SCAN.COM                      *
*                                                               *
*                              by                               *
*                          Terry Hazen                          *
*                     21460 Bear Creek Road                     *
*                      Los Gatos, CA 95030                      *
*                                                               *
*                Voice.......... (408) 354-7188                 *
*                Zee-Machine.... (408) 245-1420                 *
*                Ladera Znode... (213) 670-9465                 *
*                                                               *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *


Latest Revision
---------------

07/14/90      Revised syntax and speeded up display.
  v1.2

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


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 customize the Z3TCAP 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.

The terminal definitions in the Z3TCAP.TCP file normally found on
ZNODES at this time probably do not yet include the new extended
control sequences defined in VLIB4D.  As users define extended
Z3TCAPs for more terminals, upgraded Z3TCAP.TCP files containing
the extended definitions will be distributed via ZNODES and may
be used with SCANINST.

If you have an existing standard termname.Z3T file or a Z3TCAP in
your ZCPR3 environment in memory, you may use the utility
TCSRC.COM to create a commented source code file for the Z3TCAP
to the latest VLIB4D standards, which may then be edited and
assembled.  SCANINST can then install it into SCAN.COM.

In order to use SCANINST, all the auxillary files being used,
including the specified termname.Z3t file, Z3TCAP.TCP, if it is
being used, and the destination file (usually SCAN.COM) must be
on the logged user/drive.


                    - - I M P O R T A N T - -

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


Syntax
------

SCANINST's command line syntax is:

     SCANINST [termname[.Z3T]] destfile[.COM]

For a help screen display, the syntax is:

     SCANINST       or
     SCANINST ?     or
     SCANINST //

All files must be on the currently logged user/drive.  No
wildcard filename/filetype specifications may be used.  When no
termname.Z3T file is specified, SCANINST will ask you to select a
terminal from the file Z3TCAP.TCP.  The selected terminal will be
installed into the specified destination file.  If no termname
filetype is specified, '.Z3T' is the default filetype.  If no
destfile filetype is specified, '.COM' is the default filetype.

The operation of SCANINST when selecting a terminal from Z3TCAP
is menu-driven and should require no detailed explanation.  When
you have made and confirmed your terminal selection, SCANINST
will install it into the specified destination file, usually
SCAN.COM.  You may reinstall another terminal into SCAN at any
time by simply running SCANINST again.  You may also configure
SCAN to ignore the currently loaded internal Z3TCAP by patching
the first byte of the internal Z3TCAP at 200h (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 patching information.

After you have installed your terminal into SCAN, 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 further patch SCAN to modify the terminal control
sequences and to alter other aspects of SCAN's operation.
Consult your terminal manual and see SCAN.PAT for information on
the structure of the extended Z3TCAP.

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