Starts a database server in the background.
Syntaxdbspawn [ options ] server-command| Option | Description | ||
|---|---|---|---|
| @data |
Reads in options from the specified environment variable or configuration file. If both exist with the same name, the environment variable is used. The Start Server in Background utility (dbspawn) allows you to specify a configuration file reference in the command to be spawned, but you cannot specify a configuration file with options for the dbspawn utility. For example, the first command below is supported, but the second command is not supported:
For more information, see Configuration files. If you want to protect passwords or other information in the configuration file, you can use the File Hiding utility to obfuscate the contents of the configuration file. See File Hiding utility (dbfhide). |
||
| -f |
Forces dbspawn to start a database server, even if a default database server already exists. |
||
| -p |
Specifies that the operating system process ID of the database server process be returned after the database server starts. For example:
|
||
| -q | Runs in quiet mode—messages are not displayed. | ||
| server-command |
Specifies the command line for starting the database server. See SQL Anywhere database server syntax. |
RemarksThe dbspawn utility is provided to start a server in the background. dbspawn starts the server in the background and returns with an exit code of 0 (success) or non-zero (failure). If a new server is successfully started, dbspawn does not return until the database server has completed initialization and is ready to accept requests.
By default, dbspawn cannot start a new server on a computer where a default database server is currently running. To start a server on a computer where a default database server is running, specify the -f option.
For more information about exit codes, see Software component exit codes.
The dbspawn utility is useful for starting a server from a batch file, especially when subsequent commands in the batch file require a server that is accepting requests.
If the specified path includes at least one space, you must enclose the path in one set of double quotes. For example:
dbspawn dbeng12 "c:\my databases\mysalesdata.db" |
If the specified path does not contain spaces, then quotes are not required.
 |
Discuss this page in DocCommentXchange.
|
Copyright © 2012, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.1 |