Dictionary/3000 Reference Manual (32244-90001)

Chapter 4 63
DICTDBM Commands
ADD
ADD
Adds an association between unlike entities.
Syntax
[option] ADD subcommand
Use the ADD command to associate an element, a file, or a procedure with an unlike entity.
The association is one of ownership. The subcommand identifies the type of entity for
which an association is made. For example, ADD CATEGORY associates a data element
with a category. In other words, the data element now “belongs” to that category. Similarly,
ADD FILE-LOC associates a file with a physical location. The file now “belongs” to that
location.
Like entities (such as file to file) can not be associated through the ADD command. (See the
RELATE command to relate like entities.)
Data elements can be added to a file's primary format or as secondary format. The primary
list of elements associated with a file defines the primary format for that file. This is the
default format and is used by the Dictionary utilities and HP Inform. Any number of
elements can be associated with the primary format of a file.
A secondary format is an alternate format for a file's storage area (which contains the
elements associated with the file). It is used by the DICTCDE utility to generate the
REDEFINE clause in a COBOL II data division. (For more information on the DICTCDE
utility, see Section 5 of this manual.) A file may have multiple secondary formats, each one
represented by a single data element. Each element associated with a secondary format
should reflect the alternate format for the file. (For instance, that element could be a
parent element with several child elements related to it.)
Elements cannot be associated with a parent entity (an entity that has subordinate
entities related to it) unless the parent entity is a procedure. Elements may be associated
with parent procedures which have child procedures related to them.
When data elements are associated with an entity, they are added to that entity's list of
associations in the order in which they were associated. (See the RESEQUENCE
command to change this order.)
Subcommands
Any of the following subcommands can be used with the ADD command:
CATEGORY adds a data element to a category
CLASS adds a data element to a user security class
CLASS-FILE adds a file to a user security class
CLASS-GROUP adds a group to a user security class
FILE adds a data element to a file
FILE-LOC adds a file to a physical location