.BG
.VE $Header: /usr3/s/current/s/.help/RCS/restore,v 1.2 83/12/30 19:33:33 rab Exp $
.FN restore
.TL
restore: Restore Datasets from Dump File
.CS
restore(file, pos, print)
.PP
.AG file
character string giving the name of a file onto which the
`dump' function dumped datasets.
.AG pos
the position in the data directory search list of the data directory
onto which the restore should put the datasets. Default 1
(the work directory).
.AG print
logical flag; when TRUE, dataset names are printed as they
are put in the data directory. Default FALSE.
.PP
Typically, the pair of functions `dump' and `restore' are used to move
data directories from one computer system to another.
An entire data directory may
be dumped, the resulting file transported to a file on another system,
and the data directory restored.
.SH NOTE
The functions `dump' and `restore' ignore the current prefix.
.EX
restore("dumpfile",2) #restore contents of dumpfile onto `save' db
.KW basic*
.KW data management
.KW file
.KW input
.KW read
.WR
