Restores the Data Manager from a file.

filename—A string containing the name of the data file to restore. This file must have been created with DMSave.

Overwrite—Erases everything in the Data Manager before restoring the contents of the file. By default, data from the file is added to the current Data Manager.

Verbose—Prints information to the screen about the data that is being restored.

This example can be used in an initialization routine—a JWAVE wrapper called initially by the client, or by the procedure indicated with the JWAVE_STARTUP configuration parameter. This configuration parameter is specified with the Configuration Tool, described in "Setting Up the JWAVE Server" on page 107. (By default, the initialization routine is called JWAVE_START.)

This example restores DM data from a file (saved previously by DMSave) and adds data named STUFF to the default domain ($GLOBAL). This data is then available for use by other wrapper functions (using DM routines), or the data can be accessed by the JWAVE client (using a JWaveDataProxy or ServerDataID object).

; Restore data from previous session

DMRestore, my_dm_data_file

; Add new 'STUFF' data if it does not already exist

IF (NOT DMDataExists( ['$GLOBAL', 'STUFF'] ) THEN BEGIN
status = DC_READ_FREE(my_ascii_data, stuff)
DMStoreData, ['$GLOBAL', 'STUFF'], stuff

ENDIF

DMCopyData, DMRemoveData, DMSave, DMStoreData