If you do not include the -noaction option, the bak restoreftfamily command returns the unique dump ID number associated with the restore operation. The dump ID is displayed in the command window directly following the command line and in the Tape Coordinator's monitoring windows if the butc command is issued with debug level 1. The dump ID number is not the same as the job ID number visible with the (bak) jobs command if the bak restoreftfamily command is issued in interactive mode. Note that the dump ID and job ID numbers are not assigned to the operation until the command actually begins to restore filesets.
If you include the -noaction option, the command displays on standard output the number of filesets that would be restored, followed by a separate line of information about each fileset. For each fileset, the command provides the following output:
machine aggregate fileset_dumped # as fileset_restored; tape tape_name; pos position_number; date
the output provides the following information:
machine
The host name of the File Server machine to which the fileset would be restored (for example, fs1.abc.com).
aggregate
The aggregate name of the aggregate to which the fileset would be restored (for example, lfs1).
fileset_dumped
The name of the fileset that was dumped (for example, user.frost). The command can display the name of the backup version of the fileset (for example,
user.frost.backup) if that version was dumped.
fileset_restored
The name with which the fileset would be restored (for example, user.frost). The command always displays the name of the read/write version of the
fileset.
tape_name
The name of the tape that contains the sump set with which the fileset was dumped (for example, user.full.1)
position_number
The position of the fileset with respect to other filesets on the tape that contains the dump set (for example, 31).
date
The date and time at which the fileset was dumped (for example. Wed Jul 13 05:59:01 1994).
The command displays information only for filesets that have been dumped to tape; for each fileset that has not been dumped, the command displays an error message on standard error output. The command reads the Backup Database to determine everything but the machine, aggregate, and fileset_dumped information. If you use the -noaction option with the -file option, the machine, aggregate and fileset_dumped information must be provided in the specified file; if you use the -noaction option with the -family option, the command examines the FLDB to determine this information, so it provides information only for filesets that have entries in the FLDB.
The command displays multiple lines of information for a fileset if one or more incremental dumps were performed since the last full dump of the fileset. The command displays one line of output for the last full dump and one line of output for each incremental dump. It displays the lines in the order in which the dumps would need to be restored, beginning with the full dump. It does not necessarily present all of the lines for a fileset consecutively.
If you intend to write the output of the -family and -noaction options to a file for use with the -file option, include only a single line for each fileset; the command ignores any additional lines for a fileset. You can include any line for the fileset; all lines name the fileset's current site. You do not need to remove the # (number sign) and the information that follows it; the command ignores any characters that follow the third argument on a line.
When the -noaction option is included, no dump ID and job ID numbers are reported because none are assigned.