Defines a fileset family entry in a fileset family
Synopsis
bak addftentry -family fileset_family_name -server machine -aggregate name
-fileset name [-help]
Options
-family fileset_family_name
Names the fileset family to which this fileset family entry is to be added. The fileset family must already have been created with the
bak addftfamily command.
-server machine
Indicates the File Server machines that house the filesets in the fileset family entry. Legal values for a single machine are the machine's DCE
pathname, the machine's host name, or the machine's IP address. You can also specify the regular wildcard expression (.*) to match all machine names; in noninteractive mode, surround the
wildcard with double quotes (".*").
-aggregate name
Indicates the aggregates that house the filesets in the fileset family entry. Legal values are the device name or aggregate name of an aggregate (these
names are specified in the first and second fields of the entry for the aggregate in the dcelocal/var/dfs/dfstab file) or the regular wildcard expression (.*), which
matches any aggregate name. In noninteractive mode, surround the wildcard with double quotes (".*").
-fileset name
Indicates the filesets to be included in the fileset family entry. Legal values are a specific fileset name, the regular wildcard expression
(.*), or a regular expression that includes the regular expression characters described in the Description section of this reference page. In noninteractive mode, surround the
entire argument with " " (double quotes) if it contains regular expression characters, or escape each regular expression character with a \ (backslash); otherwise, the command shell
attempts to interpret the characters.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The bak addftentry command adds a fileset family entry to the fileset family specified with the -family option. The fileset family must already
have been created with the bak addftfamily command.
A fileset family entry can include different numbers and groupings of filesets, depending on how the -server, -aggregate, and -fileset options are combined. For the -server and -aggregate options, the issuer can specify either a single, specific value or the wildcard (.*). The wildcard matches any string, so it matches every server machine name or aggregate name found in the Fileset Location Database (FLDB). The bak program initiates a search of the entire FLDB to resolve the wildcards.
For the -fileset option, a wider range of notation from the regular expression character set is acceptable and can be combined with specific character strings. Regular expression characters are case sensitive. In addition to strings of individual letters (which match any occurrence of that exact string) and the wildcard (.*, which matches any fileset name), the acceptable notation includes the following regular expression characters. Note that these characters cannot be used for server machine or aggregate names.
* (asterisk)
Matches any number of repetitions (0 or more) of the previous character and can be combined with any other regular expression character.
[ ] (brackets)
Around a list of characters matches a single instance of any of the characters, but no other characters. For example, [abc] matches a or
b or c but not d or A or ab.
^ (caret)
When used as the first character in a bracketed set, indicates a match with any single character except the characters that follow it. For example, [^a]
matches any single character except lowercase a.
? (question mark)
Matches any single character or no character. For example, ? matches a or A or 1 or *.
. (period)
Matches any single character, but a character must be present.
\ (backslash)
Can precede any of the regular expression characters in this list so that they match only their literal values. For example, the expression \* matches a
single asterisk, and the expression \\ matches a single backslash.
In the following example, the combination of letters and regular expression characters matches any string that begins with a user. prefix and ends with a .bak extension:
user\..*\.bak
The previous example is issued in interactive mode. When issuing this command in noninteractive mode, it is necessary to enclose character strings that include regular expression characters in " " (double quotes) or to escape the regular expression characters with the \ (backslash); for example, "user\..*\.bak" and user\\..\*\\.bak are equivalent to the previous example. Otherwise, the command shell attempts to resolve the regular expression characters rather than pass them to the bak command interpreter for resolution. This can result in failure of the command or creation of incorrect fileset entries.
Possible values for the arguments of the bak addftentry command follow. To create a fileset family entry that includes
· Every fileset in the cell's file system, provide the .* wildcard for all three options.
· Every fileset on a machine, provide the DCE pathname of the machine with -server and the .* wildcard for -aggregate and -fileset.
· Every fileset on every aggregate of the same name, provide the aggregate name with -aggregate and the .* wildcard for -server and -fileset.
· Every fileset in the cell's file system that includes a common string of letters in its name (such as a .bak extension), provide the .* wildcard for -server and -aggregate and a character string/regular expression combination for -fileset.
· Every fileset on one aggregate, provide the DCE pathname of the machine with -server, the aggregate name with -aggregate, and the .* wildcard for -fileset.
· Every fileset on a specific machine that includes a common string of letters in its name (such as a .bak extension), provide the DCE pathname of the machine with -server, the .* wildcard for -aggregate, and a character string/regular expression combination for -fileset.
· Every fileset on each machine's similarly named aggregate that includes a common string of letters in its name (such as a .bak extension), provide the .* wildcard for -server, the aggregate name for -aggregate, and a character string/regular expression combination for -fileset.
· Every fileset on one aggregate that includes a common string of letters in its name (such as a .bak extension), provide the DCE pathname of the machine with -server, the aggregate name with -aggregate, and a character string/regular expression combination for -fileset.
· A single fileset, provide the DCE pathname of the machine with -server, the aggregate name with -aggregate, and the fileset name with -fileset.
Privilege Required
The issuer must be listed in the admin.bak files on all Backup Database machines.
Examples
The following commands add a fileset family entry that includes all filesets in the cell that begin with a user. prefix to the fileset family called
user. The two commands, issued in noninteractive mode, are equivalent.
$ bak addftentry user ".*" ".*" "user\..*"
$ bak addftentry user ".*" ".*" user\\..\*
Both of the previous commands could be issued in interactive mode as
bak> addftentry user .* .* user\..*
Related Information
Commands: bak addftfamily(8dfs)
Files: dfstab(4dfs)