Dictionary/3000 Reference Manual (32244-90001)

Chapter 5 163
Dictionary/3000 Utilities
DICTDBU
DICTDBU
Database Unload Utility
The Database Unload utility (DICTDBU) unloads the contents of an existing IMAGE
database. The database can be unloaded and stored either to a disc file or to a tape file.
Additionally, the database can be edited during the unload process. Editing the unload
process allows you to selectively unload, that is, choose whether or not to unload a
particular data set. When the unloading process is complete, an audit report is produced.
The following description tells how to execute the DICTDBU utility program and gives an
explanation of each prompt.
To execute this utility enter the following MPE command:
RUN DICTDBU.PUB.SYS
After an acknowledgment message, the unload utility issues the following prompt to
establish a file for the storage of the database content:
STORE FILE>
If the database is to be stored on disc, enter a file name in response to the prompt. The
utility builds the file for you if it is a new file. For an existing file, the utility issues a
warning message and waits for you to indicate that it can be overwritten before it
continues.
If the database is to be stored on tape, enter [[RETURN]] in response to the STORE FILE
prompt. The utility issues the following message:
TAPE FILE REQUESTED(Y/N)?>
If you enter a “Y” or [[RETURN]], a request to mount a tape is issued on the system
console; otherwise, the prompt for STORE FILE is reissued. If necessary, the utility can
handle multiple tape reel stores.
When the utility completes the unloading process, it generates an audit report about the
unloading process. You specify where the report is to be sent by responding to the following
prompt:
LIST FILE>
Enter one of the following options in response to this prompt:
LP sends the report to the line printer. If there is no device LP configured on
your system, use a file equation to redirect DICTLIST to another device.
NULL suppresses the audit listing.
filename sends the report to the existing or to a new disc file. Before over-writing an
existing file, you are prompted to approve purging the existing file's
contents.
*filename sends the report to the file identified in the back-referenced file equation.
Pressing [[RETURN]] in response to this prompt sends the report to your
terminal.