;
                                Z3INSTP.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               5k (33)   F885  2.0        Steven Cohen 85          Z3COM12

  1- Usage  2- Options  3- Notes                                              



   Z3INSTP  is  an  auto-installer for  Turbo-Pascal programs running on ZCPR3 
systems.  It installs video control sequences  directly  from ZCPR3 TCAPs into 
other programs compiled by Turbo-Pascal.
Š
:1

   Usage:  Z3INSTP [du:]filename[.com]

   ...where filename is the name of a .COM file optionally prefixed with a DU:
specification.  Note that  the .COM extension is optional on the command line.
If a file of .COM type is not found, an error message will result.

   Z3INSTP checks to see if the specified file was compiled under Turbo-Pascal
(version 2.0 or higher), aborting if it was not.

   As  an  added measure of  safety,  Z3INSTP  first  renames  the file  to be 
installed with  the name filename.OLD, then  creates  a  new file from scratch 
upon which the new  installed values are placed.  If  for  some reason Z3INSTP 
fails, simply  rename  filename.OLD  back  to  filename.COM.  If  filename.OLD 
already exists, you are queried before the old copy is deleted.
:2

   Options:  H  -  turns off highlighting in the program being installed

             R  -  reverses what is highlighted and what is not

             A  -  installs the arrow keys

   For option 'A' to work, the program documentation must specify that arrow
keys can be installed this way (as of now, the only program that can be
installed in this way is FATCAT.COM).  If the program you are installing does
not support this convention, it does no harm.
:3


Z3INSTP Notes:

   a. Z3INSTP  is  a  ZCPR3 utility  and  accesses  the environment descriptor
      automatically, instead of  needing  it  to  be  specified on the command
      line.  Like  most  Z3 utilities,  it  comes with  its  own built-in help 
      screen.  Z3INSTP  also  gives  full control  of user areas with Z3's DU:
      specification, but not the DIR: form.

   b. Version 2.0 adds command line options to:

      - turn off highlighting

      - REVERSE high and low video 

      - install the  arrow keys directly  into  the  program  for  any program 
        written to take advantage of this capability.



Z3INSTP Notes (continued):

   c. Z3INSTP cannot  make Turbo programs use the TCAP the same effortless way
      ZCPR3 utilities do.  That is,  it  can only install programs to specific
      TCAPs.  Programs  must  be  reinstalled  for each  TCAP used.  You can't
      simply LDR a new TCAP and expect your program to work right.

   d. Z3INSTP will  not work on terminals with "non-fixed-length ASCII" cursor
      addressing sequences.  These are  terminals which  use the "%d" in their
      cursor addressing.  For example, the H19 terminal ANSI mode, whose ZCPR3
      cursor addressing sequence is:  1BH,'[%d;%dH',0.  s.

Enter Search String:   "ZPATCH"               
Enter Search String:   5A,50,"AT",4