# emp4tdb

    EMP4TDB(1)                                                          EMP4TDB(1)

    NAME
           emp4tdb - terminal database utility

    SYNOPSIS
           emp4tdb  -copy [-verbose] [-nocompile] [-clobber | -rename]
                    source_termdb source_name target_termdb [target_name]

           emp4tdb  -diff source_termdb source_name target_termdb [target_name]

           emp4tdb  {-delete | -print} [-verbose] termdb name_pattern

           emp4tdb  -list termdb [name_pattern]

    DESCRIPTION
           This   utility  allows  terminal  definitions  to  be  copied  from one
           database to another, lists differences  between  two  terminal  defini-
           tions,  deletes  a terminal dafinition from a database, prints the com-
           plete definition of a terminal, and lists all  or  specified  terminals
           defined  in  a  database.   The  databases must be Empress 4GL terminal
           databases similar to 4gl/termdb.

           Options:

           -copy     Copy a specified terminal definition from a  source  database
                     to  a  target  database.   If the name of the target terminal
                     definition is not specified, the target name will be the same
                     as the source terminal name.  The entry in the 'terminal' ta-
                     ble is copied, as well as records for the 'sets' tables.  The
                     operation  is  performed  only if the target 'terminal' table
                     does not already contain a terminal  entry  with  that  name.
                     After copying, the terminal definition is compiled.

               -clobber   If  target database contains a definition with same name
                          as target name, delete that definition  before  copying.
                          When compiling the terminal definition, any other termi-
                          nal using one of the copied key  sets,  output  sets  or
                          video sets will also be recompiled.

               -rename    If  target database contains a definition with same name
                          as target name, rename that definition to name.o  before
                          copying.

               -nocompile The terminal definition is not compiled after copying.

               -verbose   Give  more information on the operation being performed.

           -diff     Compare two terminal definitions and display the similarities
                     and  differences.  If the name of the target terminal defini-
                     tion is not specified, the source terminal name will be  used
                     for both source and target databases.

           -delete   Delete  a terminal definition in a database.  If a pattern is
                     used instead of a terminal name,  all  terminals  with  names
                     matching  the  pattern  wil  be  deleted.  The entries in the
                     'terminal' table are deleted,  as  well  as  records  in  the
                     'sets' tables, if the sets are not being used by other termi-
                     nal definitions.

               -verbose   Give more information on the operation being  performed.

           -print    Display  the  definition of a terminal.  If a pattern is used
                     instead of a terminal name, all terminals with names matching
                     the pattern will have their definition displayed.  The system
                     variable MSPAGELENGTH can be used to specify  the  number  of
                     lines on a page.  By default, the output is formatted with 66
                     lines per page.

               -verbose   Display also the contents of each set used by the termi-
                          nal definition.

           -list     Display a list of terminal names and descriptions.  If a pat-
                     tern is specified, only terminal names matching that  pattern
                     will  be listed.  Otherwise, all the terminals defined in the
                     database will be listed.

    SEE ALSO
           emp4ctdb(1), emp4term(1), emp4ptrm(1)

           Empress 4GL: Tools Reference

    DIAGNOSTICS
           Error messages are given if the arguments to the command are incorrect,
           or if the operation specified could not be performed.

    HISTORY
           Written  by  Empress  Software  Inc..   All material is copyrighted and
           licensed.  Use on non-licensed CPUs is prohibited.

    Empress 8.62                 Empress Software Inc.                  EMP4TDB(1)