*.DICT

The modeled entities that share the DICT suffix contain the source definitions for your applications. Applications that access DICT entities, primarily the Uniface IDE, locate the associated tables or files on the path $IDF.

The Uniface IDE is responsible for maintaining the information stored in the DICT entities. It uses this information to compile your definitions into runtime objects and files that can be packed into Uniface archive files (UARs).

Your applications do not usually need to access the DICT entities, because applications require access only to the compiled versions of application definitions. However, if you have installed the meta dictionary and have created components which use the meta dictionary definitions to access entities of DICT, your applications will need to access the entities of DICT. For more information, see Meta Dictionary.

The DICT entities are summarized in the table and described in the sections that follow. For more detailed information, see the documentation for each entity in the uniface\misc\umeta.xml file.

DICT Entities
Entity Used for Definitions of ...
Project definitions  
UPROJECT Projects
UREFAPS References to Application Shells
UREFCPT References to Components
UREFDTD References to DTDs
UREFENT References to Modeled Entities
UREFLIBDND References to
UREFLIBDVC References to Device Translation Table Libraries
UREFLIBEIN References to Modeled Entity Interface Libraries
UREFLIBFIN References to Modeled Field Interface Libraries
UREFLIBFLA References to Modeled Field Layout Libraries
UREFLIBFSY References to Modeled Field Syntax Libraries
UREFLIBGLY Reference to Glyph Libraries
UREFLIBINC References to IncludeScript Libraries
UREFLIBKTT References to Keyboard Translation Table Libraries
UREFLIBMSG References to Message Libraries
UREFLIBPNL References to Panel Libraries
UREFLIBSNP References to Snippet Libraries
UREFLIBVAR References to Global Variable Libraries
UREFPRJ References to Projects
UREFSIG References to Signatures
Modeled Entities  
UCDTYP Uniface DTDs
UCFIELD Modeled Fields
UCGROUP Modeled Entities (Subtypes)
UCKEY Keys for Modeled Entities
UCRELSH Relationships between Modeled Entities
UCTABLE Modeled Entity Supertypes
Modeled properties  
UGFIF Modeled Field Interfaces
UGFLAY Modeled Field Layouts
UGFSYN Modeled Field Syntaxes
UGGIF Modeled Entity Interfaces
Component definitions  
UFORM Components and Modeled Components
UXFIELD Component Fields
UXGROUP Component Entities
UXREGS Component Variables
Application shell definitions  
UAPPL Application shells
Signature definitions  
USIMPL Component Implementations.
USIOPER Operations for implementations.
USIPARM Operation parameters for implementations
USOPER Operations for interfaces
USPARM Parameters of operations for interfaces
USSPEC Component interfaces
Library definitions  
ULIBDND Drag-and-Drop Format Libraries
ULIBDVC Device Translation Table Libraries
ULIBGLY Glyph Libraries
ULIBINC IncludeScript Libraries
ULIBKTT Keyboard Translation Table Libraries
ULIBMEN Menu Libraries
ULIBMSG Message Libraries for messages, help texts, and language setups
ULIBPNL Panel Libraries
ULIBPRC Global ProcScript Libraries
ULIBVAR Global Variable Libraries
ULIBINC IncludeScript Libraries
ULIBSNP Snippet Libraries
ULIBEIN Modeled Entity Interface Library
ULIBFIN Modeled Field Interface Library
ULIBFLA Modeled Field Layout Library
ULIBFSY Modeled Field Syntax Library
Global object definitions  
UDVC Device Translation Tables
UFORMAT Drag-and-Drop Formats
UGLYPH Glyphs
UGREGS Definitions for global variables
UINC IncludeScript fragments
UKTT Keyboard and Database Translation Tables
UMSG Messages and Texts
UPNL Panels
UPRC Global ProcScript Modules
USITEM Definitions for Menu Items
USMENU Definitions for Menus.
USNP Code Snippets
Support for utilities  
UDICVER Record of current Repository version
UXCROSS Cross-reference information

UAPPL.DICT

Stores definition of: Application Shells.

Occurrence identified by:Name of the application shell.

Occurrence also includes: Properties and contents for application-level code containers.

UCDTYP.DICT

Stores definition of: Uniface DTDs.

Occurrence identified by: Name of the DTD, and the model name.

Remarks: A runtime Uniface DTD is a compiled object. Although it has a .dtd extension, it is not a normal text DTD file.

UCFIELD.DICT

Stores definition of: Modeled Fields.

Occurrence identified by: Name of the field, its parent entity, and the model name.

Occurrence also includes: Properties, and the content of its code containers. For more information, see Field.

UCGROUP.DICT

Stores definition of: Modeled Entities.

Occurrence identified by: Name of the Entity Subtype.

Occurrence also includes: Information that is inherited when the subtype is inserted in a Component's data structure, including:

  • Name of the related supertype entity.
  • Default path associated with the subtype. Only the default path on the actual entity is used. (The default path is defined in the Database Path property. This is the first step in the path from the entity to a table or file in the target DBMS.)
  • Entity interface definitions for the subtype.
  • Contents of entity-level code containers.

Remarks: Every Modeled Entity, even if it has no subtype, occurs in UCGROUP as a subtype of itself. Each occurrence is identified by the name of the subtype to which it is related.

When you create a Modeled Entity, an occurrence is created in both UCTABLE and UCGROUP. Each new subtype that you define for an entity results in a new occurrence in UCGROUP.

UCKEY.DICT

Stores definition of: Keys of Modeled Entities (primary, candidate, and index).

Occurrence identified by: Name of the parent entity, its model name, and the key sequence number.

Occurrence also includes: List of key fields and an indication of the key type (that is, whether this is a primary key or an index).

UCRELSH.DICT

Stores definition of: Relationships between Modeled Entity Subtypes.

Occurrence identified by: Name and model name of the subtype for the one entity, and the subtype of the many entity. (In other words, UCRELSH is used to implement the many-to-many relationship of UCGROUP, which contains the entity subtypes, with itself.)

Occurrence also includes:

  • List of fields in the many entity that make up the foreign key.
  • Indication of whether a DBMS index should be created for the foreign key in the table or file associated with the many entity.
  • Delete constraint to be implemented for the relationship.

UCTABLE.DICT

Stores definition of: Modeled Entities.

Occurrence identified by: Name and model name of the subtype for the entity.

Remarks: Assignments for DBMS entities operate on the entity name from UCTABLE, rather than the subtype name from UCGROUP.

UDICVER.DICT

Stores definition of:Version of the Repository in use by this Uniface installation.

Remarks: Contains a single occurrence. Overflow table or file not supported.

UDVC.DICT

Stores definition of: Device Translation Tables.

Occurrence identified by: Name of the Translation table and the library in which it occurs.

UFORM.DICT

Stores definition of: Components and Modeled Components.

Occurrence identified by: Name of the Component or Modeled Component.

Occurrence also includes: Properties and code containers. For more information, see Component.

UFORMAT.DICT

Stores definition of: Drag and Drop Formats.

Occurrence identified by: Name of the Format the library in which it occurs.

UGFIF.DICT

Stores definition of: Modeled Field Interfaces.

Occurrence identified by: Name of the Modeled Field Interface.

UGFLAY.DICT

Stores definition of: Modeled Field Layouts.

Occurrence identified by: Name of the Modeled Field Layout.

UGFSYN.DICT

Stores definition of: Modeled Field Syntaxes.

Occurrence identified by: Name of the Modeled Field Syntax.

UGGIF.DICT

Stores definition of: Modeled Entity Interfaces.

Occurrence identified by: Name of the Modeled Entity Interface.

UGLYPH.DICT

Stores definition of: Uniface Glyphs, including their bitmaps and other definitions for glyphs.

Occurrence identified by: Name of the glyph, library, and language, as well as the glyph class.

Remarks: The glyph class includes the size and GUI platform; this means that a single image with different sizes is created as separate occurrences in UGLYPH.

UINC.DICT

Stores definition of: IncludeScript fragments.

Occurrence identified by: Name of the IncludeScript and the library in which it occurs.

UKTT.DICT

Stores definition of: Keyboard and Database Translation Tables.

Occurrence identified by: Name of the Translation table and the library in which it occurs.

UGREGS.DICT

Stores definition of: Global variables.

Occurrence identified by: Name of the variable and the library in which it occurs.

ULIBXXX.DICT

All Library definitions are stored in tables with the same basic structure. Each table stores only the libraries defined for a specific object type. For example the ULIBMSG table only holds Message Library definitions.

Stores definition of: Libraries containing a specify type of Development Object.

Occurrence identified by: Library name.

Remarks: Overflow table or file not supported.

UMSG.DICT

Stores definition of: Messages, Help Texts, and Language Setups.

Occurrence identified by: Name of the object and the library in which it occurs.

UPNL.DICT

Stores definition of: Panels.

Occurrence identified by: Name of the Panel and the library in which it occurs.

UPRC.DICT

Stores definition of: Global ProcScript modules.

Occurrence identified by: Name of the ProcScript module and the library in which it occurs.

UPROJECT.DICT

Stores definition of: Projects.

Occurrence identified by: Name of the Project.

UREFAPS.DICT

Stores definition of: References to Application Shells.

Occurrence identified by: Name of the Project and referenced Application Shell.

UREFCPT.DICT

Stores definition of: References to Components.

Occurrence identified by:Name of the Project and referenced Component.

UREFENT.DICT

Stores definition of: References to Modeled Entities.

Occurrence identified by: Name of the Project and referenced Modeled Entity.

UREFINC.DICT

Stores definition of: References to IncludeScripts.

Occurrence identified by: Name of the Library and referenced IncludeScript.

UREFPRJ.DICT

Stores definition of: References to Projects.

Occurrence identified by: Name of Parent Project and referenced Project.

UREFSNP.DICT

Stores definition of: References to Snippet.

Occurrence identified by: Name of the Library and referenced Snippet.

USNP.DICT

Stores definition of: Code Snippets.

Occurrence identified by: Name of the code Snippet and the library in which it occurs.

USIMPL.DICT

Stores definition of: Implementations for a given component interface.

Occurrence identified by: Name and type of the implementation, and contains the name of its parent component interface and an identifier.

This identifier is used at deployment time to check that the source implementation (the activating component) is synchronized with the target component interface (the activated component), that is, that their corresponding operations and parameters match.

Remarks: For each component interface (the abstract model of the component), there can be:

  • At the least, no implementations, meaning the component exists only as an interface model.
  • At the most, one implementation for each supported type (that is, a Uniface component, 3GL routine, or operating system service).

USIOPER.DICT

Stores definition of: Operations belonging to component implementations.

Occurrence identified by: Operation name, and the implementation name and type (see USIMPL.DICT).

Occurrence also includes:

  • The literal, case- and context-sensitive physical function name to be used for 3GL and O/S implementations.
  • The return method to be used (for example, in $status, in the nth parameter, or ‘as void’).
  • The body of the operation (for example, actual Uniface ProcScript, or implementation of a C++ class method).

USIPARM.DICT

Stores definition of: Parameters belonging to a given operation of a component implementation.

Occurrence identified by: Parameter name, operation name, and the name and type of the implementation (see USIMPL).

Occurrence also includes:

  • Interface template or shorthand describing a packing code, which provides a mapping of the Uniface logical data type to the physical, implemented data type.
  • The fixed array size.
  • A list of parameter attributes, such as the data type (for example, long, short, or double), the display format, the length, and so on.

USITEM.DICT

Stores definition of: Menu Items.

Occurrence identified by: Name of the menu, library, and language, as well as a sequence number.

Occurrence also includes:

  • Contents of menu item level triggers.
  • Hint text for the menu item.
  • Whether the menu item is enabled, checked, and hidden.
  • Name of another menu, if this item is a cascading menu.

USMENU.DICT

Stores definition of: Menus.

Occurrence identified by: Name of the menu, library, and language.

USOPER.DICT

Stores definition of: Modeled set of operations belonging to each component interface.

Occurrence identified by: Operation name and the component interface name.

Occurrence also includes: Free-form explanations of preconditions, post-conditions, and possible return values.

USPARM.DICT

Stores definition of: Modeled set of parameters for each modeled operation belonging to a component interface.

Occurrence identified by: Parameter name, the operation name, and the component interface name.

Occurrence also includes: Parameter type (that is, basic or constructed), direction (IN, OUT, or INOUT), and position within the formal parameter list of the operation.

USSPEC.DICT

Stores definition of: Component interfaces (the modeled, abstract specifications for components).

Occurrence identified by: Component interface name.

Occurrence also includes:

  • An identifier which is used at run time to check that the source component implementation is synchronized with the target component interface, that is, that their corresponding operations and parameters match.
  • The default implementation type, specified by the signature editor or component compiler.
  • The communication default (that is, synchronous or asynchronous).

UXFIELD.DICT

Stores definition of: Component Fields.

In addition, it contains occurrences for the fields of the header, trailer, break, and area frames that you paint on a component, as well as the fields for areas of the application shell screen that you paint for character mode applications.

Occurrence identified by: Name of the field, entity (and model name), and component.

Occurrence also includes:

  • Names of modeled objects for the interface, syntax, and layout definitions, as well as the shorthand definitions.
  • Contents of field-level code containers.
  • Widget information for the field.

Remarks: Occurrences are added when you make a component variation to a field definition.

UXGROUP.DICT

Stores definition of: Component Entities.

In addition, it contains occurrences for the header, trailer, break, and area frames that you paint on a component, as well as the areas of the application shell screen that you paint for character mode applications.

Occurrence identified by: Name of the entity (or frame), model name, and component.

Occurrence also includes:

  • Default path associated with the entity subtype.
  • Name of the entity interface template used and an indication of whether its definitions are copied or linked to the subtype, as well as the shorthand definitions.
  • Name of the entity interface template used and an indication of whether its definitions are copied or linked to the subtype, as well as the shorthand definitions.

Remarks:Occurrences are added when you make a component variation to an entity definition.