Totime

Use the totime option with the todate option to specify an ending date and time to which you want to search for backups or archives during a restore, retrieve, or query operation. The backup-archive client ignores this option if you do not specify the todate option.

Use the totime and todate options with the fromtime and fromdate options to request a list of files that were backed up within a period of time. For example, you might request a list of files that were backed up between 6:00 AM on July 1, 2003 and 11:59 PM on July 30, 2003.

Use the totime option with the following commands:

  • delete backup
  • query archive
  • query backup
  • restore
  • restore group
  • retrieve

Supported Clients

This option is valid for all clients. The IBM Spectrum® Protect API does not support this option.

Syntax

Read syntax diagramSkip visual syntax diagramTOTime =  time

Parameters

time
Specifies an ending time. If you do not specify a time, the time defaults to 23:59:59. Specify the time in the format you selected with the timeformat option.

When you include the timeformat option in a command, it must precede the fromtime, pittime, and totime options.

Examples

Mac OS X operating systemsCommand line:
Mac OS X operating systemsdsmc restore "/Users/van/Documents/myfiles/*" -todate=09/17/2003 -totime=23:00:00
Mac OS X operating systemsOracle Solaris operating systemsLinux operating systemsAIX operating systemsCommand line:
Mac OS X operating systemsOracle Solaris operating systemsLinux operating systemsAIX operating systemsdsmc restore "/home/user1/*" -todate=09/17/2003 -totime=23:00:00
Windows operating systemsCommand line:
Windows operating systemsdsmc query backup -totime=23:59:00 -todate=06/30/2003 c:\mybackups\