Cloudscape Properties
Page 31 of 47

cloudscape.service

Function

The cloudscape.service property specifies that a database stored in a directory other than the system directory, or stored in a subdirectory of the system directory, is part of the current Cloudscape system when it starts. (Databases that are directly in the system directory are always part of the current Cloudscape system when it starts.)

(A database that is part of the current system directory, including those specified by this property, does not automatically boot at startup unless you use the cloudscape.system.bootAll property.)

For this property, specify the relative or absolute path to the database's directory, known as a serviceDirectory. Use the same conventions as for connecting to a database outside the system; see Conventions for Specifying the Database Path in the Cloudscape Developer's Guide. For example, for a database called newDB in the directory trial_directory on the C drive, its serviceDirectory, specified as an absolute path, would be c:/trial_directory/newDB. You can also specify a relative path.

If you do not set this property, such a database is considered part of the system only when a connection is first made to it.

The database must exist when Cloudscape starts.

NOTE: When you set this property in the cloudscape.properties file, avoid using absolute paths, because Java interprets colons as being equivalent to an equal sign (the separator between the property name and its value) when properties are set in properties files. This means that colons are interpreted incorrectly. The problem does not occur when you are setting properties on the command line or in a JDK 1.2 environment.

Syntax

cloudscape.service.databaseDirectory=serviceDirectory

Examples

cloudscape.service.london/sales=serviceDirectory
cloudscape.service.demo/databases/toursDB=serviceDirectory

Scope

system-wide

Dynamic or Static

This property is dynamic; if you change it while Cloudscape is running, the change takes effect immediately. For information about dynamic changes to properties, see Dynamic or Static Changes to Properties.