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)