The following options and arguments are used with many of the commands described in this topic. If an option or argument is not described with a command in the text, a description of it appears here. (See Part 2 of this guide and reference for complete details about each command.)
· The -tapehost machine option is the machine for which a Tape Coordinator is to be added. You can specify the machine's DCE pathname (for example, /.../abc.com/hosts/bak1), its host name (for example, bak1.abc.com), or its IP address (for example, 11.22.33.44).
· The -family fileset_family_name option is the name of the fileset family to be used in the command. The name must be unique within the Backup Database of the local cell. It can be no longer than 31 characters. It can include any characters, but to avoid confusion when dump set names are created, it should not include a . (period). Any regular expression characters entered on the shell command line must be escaped with a \ (backslash); for example, usr\e* for a fileset family named usr*. To make it easier to track the contents of a fileset family, its name should give some indication of the contents of the fileset entries it contains; for example, use the name user for the fileset family that includes all user filesets in the file system.
· The -level dump_level option is the name of the dump level to be used in the command. The complete pathname of a dump level must always be specified. There are two types of dump levels:
- Full dumps, which consist of a name preceded by a single / (slash) (for example, /full).
- Incremental dumps, which consist of multiple elements that resemble a UNIX pathname listing the dump levels that serve as the parents of the dump level, starting with a full dump level and proceeding in order down the hierarchy; for example, /full/weekly/monday. An incremental dump level can consist of any number of elements; when defining a new dump level, all of the elements except the last one must already exist. Each level in a dump level name must be preceded by a / (slash).
Dump levels should have meaningful names that give some indication of their purpose. A single element in a dump level name can be no longer than 28 characters, and the complete name can be no longer than 256 characters. Dump level names can include any characters, but to avoid confusion when dump set names are created, they should not include a . (period). Regular expression characters included in a dump level name must be escaped with a \ (backslash) or " " (double quotes). The complete pathname of each dump level must be unique within the Backup Database of the local cell.
· The -expires date option is the expiration date for a dump level. Expiration dates can be specified in one of two ways:
- Relative expiration dates, which use the keyword in to indicate a number of years, months, or days to be added to the current date to calculate the expiration date. When the system dumps a fileset at this level, it calculates the time at which the dump set expires by adding the values to the start time of the dump operation. Relative expiration dates are expressed as follows:
in [integery] [integerm] [integerd]
At least one value must be provided; multiple values must be listed in the order shown, with the appropriate unit abbreviation (y, m, or d) used with each value. For example, in 1y 6m 2d causes the system to add 1 year, 6 months, and 2 days to the current date to calculate the expiration date.
- Absolute expiration dates, which use the keyword at to represent a specific date and, optionally, time to use as the expiration date. Absolute expiration dates are expressed as follows:
at mm/dd/yy [hh:mm]
If you specify a time, you must use 24-hour time. For example, at 11/22/92 11:36 specifies an expiration date and time of 22 November 1992 at 11:36 a.m. If no time is provided, a default time of 00:00 (12:00 a.m.) on the indicated date is used.
If you omit the -expires option from a command, tapes created at dump levels specified with the command have no expiration dates; they can be overwritten at any time. Also, although the -expires options are followed by ellipses, you can specify only one expiration date. The ellipses are included only to accommodate the DFS command parser.
· The -tcid tc_number option is the TCID of the Tape Coordinator to be used for the command. Legal values are integers from 0 (zero) to 1023. If this option is omitted, the Tape Coordinator with a TCID of 0 is used to execute the command by default.