# hot-backup command (UNIX)

The hot-backup command allows the set up and control of a hot backup
 configuration. A menu displays without any arguments. This is the normal form of
 operation.

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. |

## Additional information

For more information on Hot Backup, see the D3 Linux System
 Administration Guide or D3 AIX System Administration
 Guide.

## Example(s)

**Example 1**

This example shows how to enter the main menu:

```
 hot-backup
```

 **Example 2**

This example shows two ways to start hot-backup in the foreground. Use
 either:

```
 hot-backup start server=<servername> (f
```
or

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

```
 hot-backup (f
```

 **Example 3**

This example starts the only server on the virtual machine:

```
 hot-backup start
```

 **Example 4**

This example 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](https://d3codex.com/definitions/hot-backup/)
- [Hot backup system](https://d3codex.com/unix/hot-backup-system/)

---
Source: https://d3codex.com/tcl/hot-backup-command-unix/ - part of the D3Codex reference.