The bak command suite can be used in regular command mode or in interactive mode. To enter interactive mode, enter bak at a command shell prompt. While you are using this mode, the following information applies:
· The word bak does not need to be entered with each command; the bak> prompt replaces the command shell prompt.
· Regular expression characters do not need to be escaped; in regular command mode, all regular expression characters must be placed in " " (double quotes) or escaped with a \ (backslash).
· New connections do not have to be established to the bakserver and flserver processes, as necessary, each time a command is issued, so execution time is faster than in noninteractive mode.
· Multiple operations can be tracked with the bak jobs command; in regular command mode, pending operations cannot be tracked.
· Currently executing and pending operations can be canceled with the bak kill command; in regular command mode, the bak kill command cannot be used.
Descriptions of the bak jobs, bak kill, and bak quit interactive commands follow; interactive commands can be issued only in interactive mode (at the bak> interactive prompt).
The bak jobs Command
The bak jobs command lists the job ID number the Backup System has assigned to each dump and restore operation for a Tape Coordinator; the listed
operations can be currently executing or pending. The job ID number is not the same as the unique dump ID number assigned to each dump set by the Backup System. (It is also not the same as the task
ID number that is sometimes displayed in the output of certain commands; the task ID number can always be safely ignored.)
The complete syntax for the command is
jobs [-help]
The -help option displays the online help for the command.
If no operations are executing or pending, the bak> prompt returns immediately. Otherwise, the output includes one line for each operation, reporting
· The job ID number.
· A name describing the operation.
· 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).
· For a dump operation, the string fileset followed by the name of the fileset currently being dumped; for a restore operation, the string fileset followed by the name of the fileset currently being restored.
· A message indicating the status of the operation. No message is displayed if the operation is executing normally.
The bak kill Command
The bak kill command terminates a currently running dump, restore, or tape labeling operation. If the command interrupts a backup operation, all
filesets written to the tape before the kill signal is received are complete and usable. The fileset being written when the signal is received may not be complete and should not be used.
It is best not to use any of the filesets from an interrupted dump.
If the command interrupts a restore operation, all completely restored filesets are online and usable. Because complete restoration of a fileset usually requires data from multiple tapes (a full dump tape and one or more incremental dump tapes), most filesets are usually not completely restored. If the kill signal occurs before the system accesses all of the necessary tapes, most filesets are not restored to the desired date or version and should not be used.
If the interrupted restore is overwriting one or more existing filesets, the filesets can be lost entirely; however, the data being restored still exists on tape. In general, to avoid the inconsistencies that can result from an interrupted restore operation, reinitiate the restore operation.
The complete syntax for the command is
kill -job {jobID | dump_set} [-help]
The -job option identifies the operation to kill. It can be
· The job ID of the operation, as displayed in the output of the bak jobs command.
· The name of the operation, as displayed in the output of the bak jobs command if the operation is a dump. Dump set names associated with dump operations have the form fileset_family_name.dump_level. It is not possible to distinguish restore operations by name.
The -help option displays the online help for the command. All other valid options specified with the -help option are ignored.
The bak quit Command
The bak quit command exits interactive mode; the regular shell prompt replaces the bak> prompt.
The complete syntax for the command is
quit [-help]
The -help option displays the online help for the command.