Dictionary/3000 Reference Manual (32244-90001)

38 Chapter3
Using the DICTDBM Commands
Using Commands to Define Locations
Using Commands to Define Locations
The Dictionary can also be used to document the physical locations where procedures and
files are used. DICTDBM uses LOCATIONS to capture this information. The specific
MPE group and account, and the machine on which the procedure or data file is used, can
be identified. This information is helpful when a change to a procedure or file occurs
because it tells you where the procedure or data file resides. This information can also be
used to generate file equations for the referenced files by HP INFORM/3000.
Hierarchical structures for locations cannot be defined in your Dictionary.
The following description outlines the steps involved when the DICTDBM commands are
used to define locations. A complete description including examples for all the commands
is given in Chapter 4 of this manual.
Creating Locations
Use the CREATE LOCATION command string to define an entry for a location. The name
used for the location must be unique. Use the REPEAT option before the command string
to create definitions for more than one location without having to reenter the command.
Information identifying the MPE group, account, and machine is not required for the
entry. However, when changes are made to the files and procedures, you can save time and
effort by knowing where the updates need to occur.
After the entries are created, use the LIST or DISPLAY commands to display the entry. If
you want to delete an entry, use the PURGE command. To make changes to the entry, use
either the MODIFY command or the RENAME command.
Adding Files and Procedures to Locations
Before a file or procedure can be associated with a location, it must be defined in the
Dictionary. The method for associating files and procedures with a location differs slightly
from previous methods. You use the ADD command to define the association, but the
command string is ADD FILE-LOC or ADD PROCEDURE-LOC. An entry is defined that
associates the file or procedure with the location. To display the association entries, the
command strings DISPLAY LOCATION or SHOW LOCATION are used. An association
entry is deleted by using the command strings DELETE FILE-LOC or DELETE
PROCEDURE-LOC.