Previous Topic: SUSPEND commandNext Topic: XRESTORE Command

System Programmer Reference › Commands › UPDATE command

UPDATE command

Authorization: SYSADMIN

To modify the date a catalog is scheduled to be condensed or discarded, use the UPDATE command.

When you extend a catalog's retention period, you should also extend the retention period for the tapes used in the backup to prevent these tapes from being reused.

You cannot enter UPDATE while another catalog job or command (for example, CHECK, CONDENSE, or DISCARD) is executing.

Note: You can also revise the date on which a catalog is scheduled to be automatically condensed or discarded on the Manage Existing Catalog system administrator screen. For more information, see "Updating Tape Expiration Dates" in the chapter "Managing Existing Catalogs" in the Administration Guide.

The UPDATE command has the following format:

UPDATE dumpjob ("Options"...[)]

Options:

AUTOCond date
AUTODisc date

Note: If CA VM:Backup is interfaced with CA VM:Tape, use the VMTAPE CATALOG command to change the expiration date of the tapes that are associated with the catalog. Use the same expiration date that is specified by the AUTODISC option. This change prevents other users from writing over the tapes. If CA VM:Backup is not interfaced with CA VM:Tape, CA VM:Backup uses a tape only when the expiration date of the tape has passed and the tape is not a member of the only tape set that is associated with the unexpired catalog.

Definitions

dumpjob

Specifies the filename of a single catalog DUMPJOB file. (The filename is the number that this product assigns when the catalog is created.) Enter one to eight digits for dumpjob. Updating the automatic condense or discard date of a catalog has no effect on any other DUMPJOB files that are based on the specified catalog DUMPJOB file. The DUMPJOB filename is a number that CA VM:Backup assigns when the catalog is created. To see a DUMPJOB filename, use the CHECK command.

AUTOCond date

Specifies the new automatic condense date. Use either the yyddd or mm/dd/yy format for date. Specify the AUTOCOND option only once on a command line. You can enter both the AUTOCOND and AUTODISC options on the same command line.

AUTODisc date

Specifies the new automatic discard date. Use either the yyddd or mm/dd/yy format for date. Specify the AUTODISC option only once on a command line. You can enter both the AUTOCOND and AUTODISC options on the same command line.

Examples