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

386 Chapter8
Using the Database Utilities
DBLOAD
DBLOAD calls the DBPUT procedure to put the entries read from the backup volume into the
appropriate data sets. In every case, the DBPUT dset parameter is a data set number and
the list parameter is an at-sign followed by a semicolon (@;). Prior to calling DBPUT, DBLOAD
moves each entry from the backup volume into a buffer. The length of the entry is
determined by the definition of entries in the target data set. When DBLOAD is calling
DBPUT, this length is less than, equal to, or greater than the length of an entry on the
backup volume. If the data set entry is larger than the backup entry, the data is
left-justified and is padded out to the maximum entry length with binary zeros. If the data
entry is smaller than the backup entry, the backup volume record is truncated on the right
and the truncated data is lost.
The location of master set entries is based on their key item value which is hashed to an
internal location. The detail data set entries are put into consecutive data set records with
the appropriate new chain pointer information.
DBLOAD requires exclusive access to the database. If the database is already open to any
other process, DBLOAD terminates and prints the message:
DATABASE IN USE
Parameters
filename is the name (up to 8 characters) that replaces DBLOAD in the mount
request at the operator's console.
device is the device class name of the device from which the data entries are to be
loaded. Tape is the only supported device class.
database name is the name of a TurboIMAGE/XL database root file created in the
current session or job's account and logon group.
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 the last data set loaded from the backup volume.
x is the number of entries loaded into the specified data set. x is zero if the
data set is an automatic master. Note: This number may not represent the
total number of records in the data set if entries existed prior to DBLOAD
execution.
n is the volume number.
y is the number of read errors from which DBLOAD recovered.
Operation Discussion
1 Is an optional file equation that specifies the device class name for the
device from which the data entries are to be loaded. The default is device
class TAPE.