Sets the expiration date on an existing dump level
Synopsis
bak setexp -level dump_level... [-expires date...] [-help]
Options
-level dump_level
Names each dump level whose expiration date is to be set. Provide the full pathname for each dump level, including all necessary / (slashes).
-expires date
Defines the expiration date to be associated with each dump level. Expiration dates can be specified as absolute or relative values. Absolute expiration
dates have the format
at mm/dd/yy [hh:mm]
The word at is followed by a date (month/day/year) and, optionally, a time (hours:minutes). Values that can be interpreted for yy run from 00 to 37, which are interpreted as the years 2000-2037, and from 70 to 99, which are interpreted as 1970-1999. Values between 38 and 69 cannot be interpreted because the years to which they correspond (2038-2069) exceed the capacity of the standard UNIX representation of dates (the number of seconds since 12:00 a.m. on 1 January 1970). Values between 38 and 69 are reduced to 2038.
If provided, the time must be in 24-hour format (for example, 20:30 for 8:30 p.m.). If omitted, the time defaults to 00:00 (12:00 a.m.).
Relative expiration dates have the format
in [integery] [integerm] [integerd]
The word in is followed by a number of years (maximum 9999), months (maximum 11), and days (maximum 30), or a combination of these arguments. At least one of the three must be provided, and the appropriate unit abbreviation (y, m, or d) must always accompany a value. If more than one of the three is provided, they must appear in the order shown. As with absolute dates, a number of years that causes the relative time to exceed the year 2038 is effectively truncated to the number of years remaining until 2038.
If you omit this option, tapes created at the specified dump levels have no expiration dates, meaning they can be overwritten by appropriately named dump sets at any time. Although the -expires option is followed by an ellipsis, you can specify only one expiration date. (The ellipsis is included to accommodate the DFS command parser.)
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The bak setexp command sets the expiration date on each dump level specified with -level. Each dump level must already exist in the dump hierarchy
stored in the Backup Database.
The expiration date is applied to tapes containing dump sets made at the dump level; after the specified date, the Backup System overwrites a tape's contents with acceptably named dump sets without question. The Backup System's attempts to overwrite an unexpired tape fail until the issuer relabels the tape with the bak labeltape command. (Because the label records the unexpired expiration date or unacceptable name, erasing the label removes the obstacle to overwriting.) If no expiration date is defined for a tape, the Backup System overwrites the dump set on the tape with a dump set of the same name without question.
Expiration dates can be either absolute or relative:
· Absolute expiration dates are defined as a specific month/day/year and, optionally, hours and minutes. A tape with an absolute expiration date expires at that time, regardless of when the dump set on it was created. (If the expiration predates the dump set's creation, the tape is immediately treated as expired.)
· Relative dates are defined as a number of years, months, days, or any combination of the three. When the Backup System creates a dump set at the dump level, it calculates the tape's actual expiration date by adding the relative date to the start time of the dump operation.
Privilege Required
The issuer must be listed in the admin.bak files on all Backup Database machines.
Examples
The following command associates an absolute expiration date of 10:00 p.m. on 31 December 1990 with the dump level /90/december:
$ bak setexp /90/december -e at 12/31/90 22:00
The following command associates a relative expiration date of 7 days with the two dump levels /monthly/week1 and /monthly/week2:
$ bak set /monthly/week1 /monthly/week2 -exp 7d
Related Information
Command: bak adddump(8dfs)