;
                                  VTCAP.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
              23k (181)  90C9  1.2        Terry Pinto 11/87        Z3COM10

  1- Syntax                                                                   

   VTCAP  is  a  video-oriented  database  manager  designed  specifically  to
manipulate the Terminal CAPabilities (TCAP) database.  Until VTCAP,  the  only 
way to modify or add terminals to an existing TCAP was to edit the source code 
and reassemble the code.   VTCAP provides  a much easier method to modify TCAP
files.  Type the appropriate letter for help on each of VTCAP's functions.

   A)DD Terminal to TCAP                S)EARCH for Terminal in TCAP
   P)REVIOUS Terminal in Listing        N)EXT Terminal in Listing
   U)PDATE Current Terminal             D)ELETE Current Terminal
   L)IST Terminals to CRT or Printer    M)ERGE New TCAP file with Old TCAP
   H)ELP	                        Z)3-LOAD Load Z3TCAP file
:1


   Syntax:  VTCAP /H or // or /?   <-- command line help

            VTCAP filename /o      <-- edit TCAP file


   TCAP files should be placed in the DU selected in VTCAPHDR.LIB.  
   VTCAP should be anywhere in the path (NOT IN REMOTE USER PATH).
:A
------------------------------------------------------------------------------
                     ADD Terminals To TCAP Files

Command Line Syntax:   	 VTCAP filename /A 
------------------------------------------------------------------------------

On entry, you are placed in  a blank TCAP record.   You may enter  all  of the 
desired information  about the terminal  at this time.   If you specified  the 
terminal on the command line,  the program will enter the terminal name in the 
appropriate field and processing will continue to the next field.

While in the TCAP record, you may place the cursor on anywhere within the TCAP
record with the use of the arrow keys,  if the TCAP  for your terminal support  
them.  If not, you may use the standard Wordstar conventions.

When entry  is completed,  you  may issue  a ^W (control W) to  record the new 
information to  the disk.  If you  wish to exit  without writing  to the disk, 
just issue a ^Q (control Q).
:S
------------------------------------------------------------------------------
                     SEARCH for Terminal in TCAP

Command Line Syntax:     VTCAP filename /S
------------------------------------------------------------------------------

This is used to locate a specific terminal in the TCAP file.  You  may include
the terminal name  in the command line  or provide it when prompted within the 
file.
:P
------------------------------------------------------------------------------
                      PREVIOUS Terminal in TCAP

Command Line Syntax:     Not Available From Command Line
------------------------------------------------------------------------------

This command is  only available from  within the database section.   After you
select a terminal by  a SEARCH,  you may use PREVIOUS  to  get to the terminal
prior to the one selected.
:N
------------------------------------------------------------------------------
                        NEXT Terminal in TCAP

Command Line Syntax:     Not Available From Command Line
------------------------------------------------------------------------------ 

This command is  only available from  within the database section.   After you  
select a terminal by  a SEARCH,  you may use NEXT to get to the terminal after 
the one selected.
:U
------------------------------------------------------------------------------
                       UPDATE Current Terminal

Command Line Syntax:     VTCAP filename /U
------------------------------------------------------------------------------ 

This  command  is used  to  select and update  the selected terminal.  If  the 
terminal is specified on the command line,  you will be placed in the database 
within  the terminal record selected.   After the update is complete,  you may 
use ^W (control W) to write the file to disk or you  may use ^Q (control Q) to 
abort the update and be returned to the database level.
:D
------------------------------------------------------------------------------
                       DELETE Current Terminal

Command Line Syntax:     VTCAP filename /D
------------------------------------------------------------------------------ 

You may use this command to delete a selected terminal from the TCAP files. If
you specify the terminal from the command line, the terminal requested will be
deleted from the  TCAP files and  you will be returned  to the database level. 
If you elect to specify the 'D' option from the database,  you will delete the 
current terminal from the listing.
:L
------------------------------------------------------------------------------
                            LIST Terminals 

Command Line Syntax:     VTCAP filename /L
------------------------------------------------------------------------------ 

This command will allow you to list all of the terminals in the requested TCAP
file to the CRT or printer.   If the filename is  not supplied  on the command 
line, you will  be prompted for one.   The  file requested MUST reside  on the 
Drive/User area  specified  as TCPDRV  and TCPUSR  in  the  source  file.  The 
default D/U is A14.
:M
------------------------------------------------------------------------------
                           MERGE TCAP Files

Command Line Syntax:     VTCAP filename /M
------------------------------------------------------------------------------

The MERGE command is  by far the most powerful.   It allows you to compare two 
TCAP files and create a new one (MERGE.TCP).   This feature will  allow you to 
make sure  that no terminal  definations have  been dropped  from the listing.  
Careful usage will  also allow you  to create a  file consisting of  a few new 
listings and use that file as the newfile listing.   Newfile MUST be specified 
on  the command  line  and is  the name  of  the new  TCAP file.   Oldfile  is 
optional.  You may supply the name of your old TCAP file, or a default name of
Z3TCAP.TCP will be used.   If you get  a new TCAP  file somewhere  and are not 
sure if it was created by using TCDB, just MERGE it with your current TCAP. 
:H
------------------------------------------------------------------------------
                              HELP Files

Command Line Syntax:     VTCAP /H
------------------------------------------------------------------------------

The help command differs from the help files you are currently reading in that
the internal help files only supply you with a quick synopsis of the  commands
available and their proper syntax.  No detailed information is provided.
:Z
------------------------------------------------------------------------------
                           LOAD Z3TCAP FILE

Command Line Syntax:     VTCAP filename /Z
------------------------------------------------------------------------------

The load command  allows  the  user  to  select  other  Z3TCAP  files.   After 
functions such as MERGE, ADD and DELETE, new files are created.  The  filename
will  be Z3TCAPxx  where xx is  the version number of the  file.  This  is the 
same version number you are prompted for.   You may  use the LOAD  function to 
examine the results.  You will be prompted to enter the filename.
