DBRESTOR


DBRESTOR

     Copies a database to disk from the backup volume(s) created by the
 DBSTORE program or by the MPE/iX STORE command.

SYNTAX

     [:FILE DBRESTOR [=filename] [;DEV=device] [;REC=recsize] [; {BUF | NOBUF}] ]
:RUN DBRESTOR.PUB.SYS
WHICH DATABASE? database_name [/maint_word]
DATABASE RESTORED


PARAMETERS

filename        filenameis the name (up to 8 characters) that replaces
 DBRESTOR in the mount request at the operator's console.

device is the device class name of the device from which the database
 is to be restored.

recsize is the record size of the record to be restored.
 recsize must be at least as large as the record written to
the device to avoid losing data.

database_name is the name of the TurboIMAGE/XL database to be restored.

maint_word is the maintenance word defined by the database creator.
 This word must be supplied by anyone other than the database creator.

The file equation is optional and specifies the device class name for the device
from which the database is to be restored. The default is device class TAPE.

OPERATION

In session mode, DBRESTOR prompts for the database name and maintenance word.
In job mode, the database name and maintenance word, if any, must be in the
record immediately following the RUN command.

After DBRESTOR has created the root file and data sets and restored the data
to these files, it prints a confirmation message.

Console Messages

After you supply the database name and DBRESTOR opens the file specified
by filename, a message is displayed on the system console. A tape must be
mounted on the appropriate unit and identified through an operator reply.
Refer to Volume Management Reference Manual for instructions about console interaction.

If the database is on more than one volume, another message is displayed
on the system console. The operator must mount the next volume in the sequence.
If the volume that is mounted is not the correct format, the operator is notified
through a console message. If the correct volume is available, the incorrect one
should be removed and the correct one mounted. The operator must enter a reply
on the console.

Example

   :JOB MRG.ACCOUNTA        Initiate job.
:RUN DBRESTOR.PUB.SYS Initiate DBRESTOR.
ORDERS/SELL Specify database name and maintenance word.
:EOJ Terminate job.

After creating the files and restoring the file contents, DBRESTOR prints the
following message on $STDLIST:

DATABASE RESTORED

NOTE

If there is already a copy of the database on disc, it must be purged using
DBUTIL before running DBRESTOR.

ADDITIONAL INFORMATION

Commands:  DBSTORE, DBUTIL