TurboIMAGE/XL Database Management System Reference Manual MPE/iX V6.5 (30391-90011)

410 Chapter8
Using the Database Utilities
DBUNLOAD
DBUNLOAD
Copies the data entries from each data set to specially formatted tape volumes.
Operation
1
[:FILE DBUNLOAD[=
filename
] [;DEV=
device
] ]
2 :RUN DBUNLOAD.PUB.SYS [ ,CHAINED
,SERIAL ]
.
.
.
3 WHICH DATA BASE?
database name
[/
maint word
]
.
.
.
4 DATA SET
m
:
x
ENTRIES EXPECTED,
x
ENTRIES PROCESSED
5 END OF VOLUME
n
,
y
WRITE ERRORS RECOVERED
SAVE VOLUME ON LOGICAL DEVICE
z
AS
n
6 DATABASE UNLOADED
END OF PROGRAM
(Refer to "Operation Discussion" later in this section.)
Parameters
filename
is the name (up to 8 characters) that replaces DBUNLOAD in the mount
prompt at the operator's console.
If you want information about your data set chains without actually
performing a DBUNLOAD, supply $NULL as the
filename
. This causes a
simulated unloading of the database, preventing the need to mount a tape.
device
is the device class name of the device to which the data entries are to be
copied.
database name
is the name of the TurboIMAGE/XL database to be unloaded.
maint word
is the maintenance word defined by the database creator. This word must
be supplied by anyone other than the database creator.
Message Variables
m
is the number of data sets in the database.
x
is the number of entries (expected) and the number of entries processed or
copied from the specified data set.