Dictionary/3000 Reference Manual (32244-90001)

Chapter 5 153
Dictionary/3000 Utilities
DICTDBC
DICTDBC
Database Creation Utility
The Database Creation utility (DICTDBC) creates a schema and a root file for an IMAGE
database. Once the schema and root file are created, the database files can be created by
using the IMAGE/3000 utility DBUTIL. Refer to the IMAGE/3000 Reference Manual for
detailed information on how to use DBUTIL.
DICTDBC prompts for information that identifies which database definition in the data
Dictionary is to be used. It also prompts for information that is used by the schema
processor when generating a schema and a root file. The IMAGE/3000 utility DBSCHEMA
is automatically executed by DICTDBC. (For details on DBSCHEMA, see the IMAGE/3000
Reference Manual.)
DICTDBC will terminate when DBSCHEMA terminates. Once the schema and root file
are created, the DBUTIL utility can be run to create the database files. (DICTDBC does
not execute DBUTIL.) If errors prevent a root file from being created, the corrections must
be made in the Dictionary before you can re-execute DICTDBC. The following description
tells how to execute DICTDBC and gives an explanation of each prompt.
To execute DICTDBC enter the following MPE command:
RUN DICTDBC.PUB.SYS
After DICTDBC issues an acknowledgment message, you are prompted to enter a
password as follows:
DICTIONARY PASSWORD>
The password entered must grant at least PROGRAMMER level access to the Dictionary.
(See Appendix C for an explanation of the levels of access.) If [[RETURN]] is pressed in
response to this prompt, DICTDBC will terminate.
Note that the password is not displayed on the terminal as it is entered. However, if the
password is not entered correctly, an error message is displayed and the prompt reissued.
After the password is accepted, DICTDBC issues the following prompt:
BASE>
Enter the name of the database for which a schema and root file are to be created. A
definition for this database must already exist in the Dictionary. If it does not, an error
message is displayed and the prompt is reissued. If [[RETURN]] is pressed in response to
this prompt DICTDBC will terminate.
Next, DICTDBC prompts for information to be used by the schema processor. The first
prompt allows you to specify the options to be used when the schema is processed:
CONTROL LINE>
Any of the following options may be entered in response to the above prompt. These
options are the same ones as described for the $CONTROL COMMAND in the
IMAGE/3000 Reference Manual, except for BLOCKMAX. Note that the BLOCKMAX
option is defined differently here. One or more of these options may be entered, separated