hot-backup command (UNIX)

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.

For Windows: Not supported

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