The Generate Repository Schema and Load Repository Schema utilities generate and interpret the Synergy Data Language. The Generate Repository Schema utility converts specified repository definitions into the Synergy Data Language; this is referred to as a schema file. Conversely, the Load Repository Schema utility converts the contents of one or more Synergy Data Language files into a new repository or merges (or replaces) the contents into an existing repository. (Optionally, you can generate and load schema from the command line using the Exporting and importing Synergy Data Language Files (rpsutl).)
|
You can automate schema generation by setting the RPS_SCHEMA_EXPORT_ON_EXIT environment variable. When RPS_SCHEMA_EXPORT_ON_EXIT is set to a value of 1 or 2, schema will be generated automatically when Repository exits. You can specify filenames and locations using the RPS_SCHEMA_EXPORT_FIL and RPS_SCHEMA_EXPORT_DIR environment variables. See RPS_SCHEMA_EXPORT_ON_EXIT, RPS_SCHEMA_EXPORT_FIL, and RPS_SCHEMA_EXPORT_DIR for details. |
The Synergy Data Language is also used as the basis for the Print Repository Definitions utility, which prints the structure, file, template, format, enumeration, and detail definitions in your repository to a file.
Because the schema file is simply a text file, it can be used in a number of ways:
- Aid in converting foreign repositories to Repository format. By writing a program to convert a foreign repository to the Synergy Data Language, you can easily convert your existing non-Repository definitions into Repository format.
- Make mass repository modifications. To do this, use the Generate Repository Schema utility to generate a schema file for your repository. Then modify the file and reload it with the Load Repository Schema utility.
- Move repository files to a different operating system. To do this, use the Generate Repository Schema utility to generate a schema file for your repository. Copy this file to another system, and then run the Load Repository Schema utility to convert the contents of the schema into a new repository. This method of moving repository files works between any two systems, regardless of operating system.
|
Unloading a repository to schema and then reloading it into a new repository oftentimes resolves unusual repository errors of unknown origin. |
