bak status(8dfs)

Reports on the operation that a Tape Coordinator is executing

Synopsis

bak status [-tcid tc_number] [-help]

Options

-tcid tc_number
Specifies the Tape Coordinator ID (TCID) of the Tape Coordinator for which status information is to be displayed.

-help
Prints the online help for this command. All other valid options specified with this option are ignored.

Description
The bak status command displays information about the operation currently being performed by the indicated Tape Coordinator. The command displays information about only the Tape Coordinator's current job. It does not display information about any pending jobs waiting for the Tape Coordinator. Use the jobs command in interactive mode to display information about the currently executing job and any pending jobs for a Tape Coordinator.

Privilege Required
The issuer must be listed in the admin.bak files on all Backup Database machines.

Output
If the indicated Tape Coordinator is not currently performing an operation, the output reports Tape coordinator is idle. Otherwise, it reports the following:

· An operation name describing the operation. One of the following operation names is displayed:

Dump (dump_set)
For a dump operation, where dump_set is the name of the dump set in the form fileset_family_name.dump_level. Dump operations are initiated with the bak dump command.

Restore
For a restore operation. Restore operations are initiated with the bak restoreft, bak restoredisk, or bak restoreftfamily command.

Labeltape (tape_label)
For a tape labeling operation, where tape_label is the label being placed on the tape. Tape labeling operations are started with the bak labeltape command.

Scantape
For a tape scanning operation. Tape scanning operations are initiated with the bak scantape command.

SaveDb
For a database saving operation. Operations that save the Backup Database to tape are started with the bak savedb command.

RestoreDb
For a database restoring operation. Operations that restore the Backup Database from tape are initiated with the bak restoredb command.

· The number of kilobytes transferred so far (from file system to tape for a dump operation, from tape to file system for a restore operation).

· The string fileset followed by the name of the fileset currently being restored if the operation is a restore; the string fileset followed by the name of the fileset currently being dumped if the operation is a dump.

· Status information about the operation. If the operation is executing normally, no message is displayed; otherwise, one of the following messages is displayed:

[abort requested]
The kill command was issued, but the operation is not yet canceled.

[abort sent]
The operation is canceled, but its execution is not yet stopped.

[operator wait]
The Tape Coordinator is waiting for the operator monitoring the operation to insert a tape in the drive.

Examples
The following command displays status information about the operation being performed by the Tape Coordinator with TCID 4. The operation is a dump of the dump set whose name is usersys.monday. So far, 23,597 bytes have been dumped to tape. The fileset named user.terry is currently being dumped. No status message is displayed, indicating the operation is proceeding normally.

$ bak status 4

Dump (usersys.monday): 23597 Kbytes transferred, fileset user.terry.

Related Information
Commands: bak dump(8dfs)

bak labeltape(8dfs)

bak restoredb(8dfs)

bak restoredisk(8dfs)

bak restoreft(8dfs)

bak restoreftfamily(8dfs)

bak savedb(8dfs)

bak scantape(8dfs)

bak jobs, bak kill (see the bak(8dfs) reference page for information about the bak jobs and bak kill commands)