TurboIMAGE/XL Database Management System Reference Manual (30391-90012)

408 Chapter8
Using the Database Utilities
DBSTORE
DBSTORE
Stores the database root file and all data sets to a tape in a format compatible with backup
files created by the MPE STORE and SYSGEN commands. DBSTORE differs from these
commands in that it handles only TurboIMAGE/XL databases.
Operation
1 [:FILE DBSTORE [= filename ] [;DEV= device ] [;REC= recsize ] [; { BUF
NOBUF} ] ]
2 :RUN DBSTORE.PUB.SYS [;INFO="MPE STORE options"]
.
.
.
3 WHICH DATABASE? database name [ /maint word ]
4 DATABASE STORED
END OF PROGRAM
If you try to store a database that needs recovery, DBSTORE will do the recovery before
storing the database.
Before copying the files, DBSTORE gains semi-exclusive access to the referenced database;
that is, DBSTORE determines that the only other database activity consists of other users
executing DBSTORE or application programs that open the database in mode 6 or 8. If
DBSTORE cannot gain semiexclusive access, it terminates and prints the following message:
DATABASE IN USE
You must be the database creator or provide the maintenance word to use DBSTORE.
Parameters
filename is the name (up to 8 characters) that replaces DBSTORE in
the mount request at the operator's console.
device is the device class name of the device on which the data
entries are to be stored.
recsize is the record size of the record to be written to the device;
must be a multiple of 512 bytes and less than the
configured record size for the device.
database name is the name of a TurboIMAGE/XL database to be stored.
maint word is the maintenance word defined by the database creator.
This word must be supplied by anyone other than the
database creator.
INFO= is used for the parameters that can be passed to the MPE
STORE/RESTORE process. For example, the TRANSPORT