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. Tivoli® Storage Manager 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
AIX operating systemsHP-UX operating systemsLinux operating systemsMac OS X operating systemsOracle Solaris operating systemsWindows operating systems

Supported Clients

This option is valid for all clients. The Tivoli Storage Manager client API does not support this option.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-TOTime = - --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
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsCommand line:
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X 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\