setLocation

setLocation(location: String) updating;

The setLocation method of the JadeDbFilePartition class changes the default or designated physical location of a database partition in its control record.

The location parameter specifies the file system directory in which the offline partition will be located when it is marked online. The value of the location attribute is stored in the partition control file and is similar in function to the path attribute for map files, which is stored in the global database control file.

This method causes the database to open the file in that location and requires that someone or something has put the file in that location before it is marked online. A typical usage for this would be to allow offline partitions that have been burned to optical media to be mounted in a different file system directory (for example, a different drive). In order to bring such a partition online, a tool or application would call the setLocation method to specify the location and then call the markOnline method, to enable access to the partition.

An exception is raised if there was an error accessing a database partition control file, the database file was not located, you are attempting the operation on an online partition or when the database is in backup state.