Dictionary/3000 Reference Manual (32244-90001)

40 Chapter3
Using the DICTDBM Commands
Using Commands to Define Categories
Creating Elements and Categories
To create data element and category entries, use the CREATE command. You use the
command string CREATE ELEMENT or CREATE CATEGORY to define the entry. An
element or a category must be defined in the Dictionary before it can be associated or
related to other entries. The name you use for the category or the element must be unique.
The created entries can be displayed using the LIST or DISPLAY commands. Changes can
be made to the entry by using the MODIFY command. The entry can be renamed by using
the RENAME command. To delete the entry, use the PURGE command.
Relating Categories to Categories
The hierarchical relationship between categories is established with the RELATE
command. Use the command string RELATE CATEGORY to define this relationship. This
command allows more than one category to be related to the PARENT category during the
command cycle.
To display the relationships, use the SHOW command. For a PARENT category, this
command displays each CHILD category. It also displays the data elements associated
with the CHILD category. The elements are displayed in the physical order in which they
were associated with the category, and the CHILD categories are displayed in the physical
order in which they were related to the PARENT category.
The REPORT command can be used to display an alphabetical listing of the elements
associated with a category. For a PARENT category, REPORT displays all the elements
associated with the CHILD categories.
The relationship entry can be deleted with the REMOVE command, and it can be changed
with the CHANGE command. Use the REORDER command to change the physical order
in which the CHILD categories are related to the PARENT category.
Adding Elements to Categories
The ADD command is used to associate data elements to categories. Use the command
string ADD CATEGORY to define this association. An entry is defined that associates an
element with a category. Elements cannot be associated to a PARENT category. DICTDBM
will not accept this and will issue an error message if it is tried.
To display association entries, use either the REPORT command or the SHOW command.
If you want to delete the association entry, use the DELETE command. To change the
entry, use the UPDATE command. To change the physical order of the association, use the
RESEQUENCE command.