The executable form of the Backup Server program, located in $SYBASE/$SYBASE_ASE/bin.

Windows The utility is bcksrvr.exe, located in %SYBASE%\%SYBASE_ASE%\bin.


	[-C server_connections]
	[-S b_servername]
	[-I interfaces_file]
	[-e error_log_file]
	[-M sybmultbuf_binary]
	[-N network_connections]
	[-T trace_value]
	[-L Sybase_language_name]
	[-J Sybase_character_set_name]
	[-c tape_config_file]
	[-D n]
	[-A pathname]
	[-P active_service_threads]
	[-V level_number]
	[-p n]
	[-m max_shared_memory]


backupserver -v


-C server_connections

specifies the number of server connections for the Backup Server. The Backup Server requires:

  • Two connections for each dump session

  • One connection for each load session

  • One connection for volume change messages

Allow a maximum of three times the number of expected concurrent dump and load sessions. The default value is 30 server connections.

-S b_servername

specifies the name of the Backup Server to start. The default is SYB_BACKUP. This entry must specify the name of a Backup Server in the interfaces file.

-I interfaces_file

specifies the name and location of the interfaces file to search when connecting to Backup Server. If -I is omitted, backupserver looks for a file named interfaces in the directory pointed to by your SYBASE environment variable.


prints the version number and copyright message of the backupserver software and then exits.

-e error_log_file

specifies the name and location of the Backup Server error log file used to report Open Server internal errors, sybmultbuf errors, errors that halt the Backup Server, and errors for disconnected sessions. All other errors are sent to the notify destination specified in the dump database, dump transaction, load database, and load transaction commands.

-M sybmultbuf_binary

specifies the full path name of the sybmultbuf executable. Use this parameter only when starting Backup Server from a directory other than the bin directory of the Sybase installation directory, or when using a diagnostic version of sybmultbuf.

-N network_connections

specifies the number of total network connections (DBPROCESSes) that the master Backup Server can originate. The default value is 25.

-T trace_value

interprets trace_value as a bitmask (base-2 number). The 1 bits in trace_value correspond to Open Server Trace flags to turn on. If you specify more than one -T parameter on the command line, the final -T value overrides the values from earlier -T parameters. The trace_value must be a positive integer.

-L Sybase_language_name

specifies the default language for Backup Server. If not specified, Backup Server uses the locale specified by the LC_ALL or LANG environment variables. If these variables are not set, Backup Server searches for the “default” entry in locales.dat.

NoteThe -L parameter does not override the value set in the LANG environment variable.

-J Sybase_character_set_name

specifies the default character set for Backup Server.

-c tape_config_file

specifies the name and location of the tape configuration file to search for tape device configuration information before doing a dump database or a dump transaction. If you do not specify -c, the default path name for the tape configuration file is $SYBASE/backup_tape.cfg.

-D n

specifies the bitmap (base 10 number) of the diagnostic flags used within Backup Server.

-A pathname

specifies the pathname to the directory of the Archive API dynamically loadable library.

-P active_service_threads

allows you to increase the number of stripes during multiple dump/load operations (with a maximum of 12286 stripes per single operation).

-V level_number

limits the messages that are printed to the Backup Server error log. The level_number variable determines the degree of error verbosity (-V) for Backup Server:

  • -V4 – displays all -V0 messages except “Connection from Server” messages printed for each connection event.

  • -V3 – displays only completion messages from a normal dump or load command and the following types of messages:

    • Error messages from Backup Server and sybmultbuf

    • Other sybmultbuf messages

    • Volume change messages

    • Open Server™ messages

    • Trace print messages

    • Informational messages from the System & Tape Auto Config modules

  • -V2 – displays:

    • All -V3 messages plus

    • File creation and file mount messages

  • -V1 – displays:

    • All -V2 messages plus

    • Phase messages

  • -V0 (default) – displays all messages, including backup progress

This limitation does not involve the messages that are sent to the client or console as determined by the NOTIFY= parameter in a dump or load command.

This option also does not affect logging for the following message types:

  • Open Server messages

  • Trace printing messages from bs_traceprint

  • sybmultbuf messages

-p n

specifies the TDS packet size in bytes that the local Backup Server requests from the remote Backup Server during network dumps. The actual packet size used is limited to the -p parameter value of the remote Backup Server. If you do not specify -p, the default is 2048 bytes. The packet size should be an integer greater than, or equal to 256.

-m max_shared_memory

specifies the maximum amount of shared memory in megabytes that Backup Server can use for all of its dump or load sessions.



Anyone with execute permission on the binary, and who has read/write access to all the files.

See also

Utilities startserver