Powered by QM on a Linux server
Help and Support

KnowledgeBase 00011: Transfering Data to QM

Last updated: 27 Dec 2018
Applies to: QM 2.9-6 onwards
Top level index       Full Index Search Tips
Previous article     Next article


QM has supported a version of the Pick style account/file transfer tools since mid-2005 but these are limited in their capabilities largely due to the lack of comprehensive documentation of the media format but also because the format has restrictions on what can be saved. Although these tools can be used for system backup, the media format limitations and poor documentation lead to doubts about the reliability of the data.

There is a need for a set of tools that provide a reliable way to transfer data to QM from other multivalue environments. By publishing both the media format and the program source code, the tools can be adapted to run in other environments.

The QMSave Tool

The source code of the QMSave tool is supplied in the BP file of the QMSYS account. This source code contains conditional compilation constructs for elements that are not portable across all multivalue systems. If the system on which it is to be used does not support conditional compilation, the source should be edited to remove unwanted code.

Users who modify the program to add support for alternative environments are encouraged to return their changes to Zumasys for incorporation in the published source so that other users may benefit.

Assuming that the program has been compiled and catalogued, the command line to run it is
     QMSAVE path:file
where path is the pathname to be used for the output file and file is the name of the file to be saved.

Multiple file names may be given or the word ALL can be used to save all files.

The QMRestore Tool

The QMRESTORE tool is a standard part of QM but needs a VOC entry to be added manually:

   1:  V 
   2:  CA 
   3:  $QMRESTORE 
The command line is of the form
     QMRESTORE path {options}
where path is the pathname of the save to be restored. Options are:
     CLEAR to clear each file before restore
     NO.QUERY to suppress prompts

The command will prompt for the name of the saved account and the name of the file(s) to be restored. Entering an asterisk as the file name restores all files. Data is restored into the account from which this command is executed.

If the restore includes a file named VOC or MD, these are restored to VOC-RESTORE and MD-RESTORE respectively.

Media Format

For full details of the media format, click here.

Related Articles

00012: Transfering Data to QM from UniVerse or Unidata

Please tell us if this article was helpful
Very     Slightly     Not at all
Email (optional)