hot-backup Command (UNIX)

For UNIX: Supported

For Windows: Not supported

The hot-backup command allows the set up and control of a hot backup configuration. Without any arguments, a menu displays. This is the normal form of operation. For more information on Hot Backup, see the Hot Backup section of the D3 System Administration Guide.

Syntax

hot-backup {{command}{server=name}} {(options}

Parameter(s)

command

Specifies the operation to perform on the specified server. Some of these operations are also available from the Hot Backup menus.

debug

Forces the specified server to enter the BASIC debugger. Debug the server using tandem. This option is for testing only.

dump

For slave servers only. Displays the location of the openfiles and openlist structures.

NOTE—If the structures are extensive, the display time may be substantial. During this time, the server does not respond to commands or transactions from the master server. 

pstatus

Displays performance statistics for the specified server, including the number of times a routine is called and the approximate runtime for a routine.

NOTE—Runtimes are rounded to the nearest second. Thus, a routine that runs for less than a half-second displays a runtime of 0. 

queue

Display various transaction log queue information.

start

Starts the specified server.

stop

Stops the specified server.

status

Display status information for the specified server.

name

Specifies the server on which the specified command is performed.

options

These options are available:

f

Starts the server in the foreground.

q

Suppresses all messages. Valid only for nonmenu operations.

v

Turns traces on when starting the server from the menu.

Example(s)

Enters the main menu.

hot-backup

To start hot-backup in the foreground, use either:

hot-backup start server=<servername> (f

or

hot-backup (f

In the second example, the menu can still be used. However, when selecting start, the server starts on that line in the foreground.

The following example starts the only server on the virtual machine.

hot-backup start

Starts the todev master server and the fromprod slave server and obtains the status on both servers.

hot-backup start server=todev

hot-backup start server=fromprod

hot-backup status server=todev

hot-backup status server=fromprod

See Also

Hot Backup