loadStyle

The optional loadStyle argument enables you to specify the load style, as follows.

• The default latestSchemaVersion value loads a new schema or loads the schema as the latest schema version (a new version will be created if required), and allows structural changes.

• The currentSchemaVersion value loads the schema into the existing current schema version, which may potentially affect current runtime behavior. As structural changes are not allowed, the load will not proceed if structural changes are to be introduced.

  If you are loading a schema file containing only method changes into a multiuser system, select this option, to ensure that no structural changes are attempted that would require a reorganization of the database and impact existing users. If a structural change is detected, the schema load returns an error.

  The commands that can be performed only in the current schema version are:

  • Create DbFile

  • Delete DbFile

  • Modify Schema

  • Delete Schema

  • MoveInstances

  • Remap Class

  • Delete Instances

  • Rename Class

  • Rename Interface

  For details about these commands, see "commandFile", earlier in this chapter.

• The onlyStructuralVersioning value loads only structural changes into the latest version and does not version methods or other non‑structural entities. This may potentially affect current runtime behavior.