QUERY NASBACKUP (Query NAS backup images)
Use this command to display information about the file system image objects that have been backed up for a specific NAS node and file space. You can only use this command to display objects that were backed up for a NAS node using NDMP.
The server displays all matching objects, the dates that these objects were backed up, and information about a table of contents (TOC) for the object.
Privilege class
Any administrator can issue this command.
Syntax
>>-Query NASBAckup--node_name--filespace_name-------------------> .-BEGINDate--=--TODAY - 7-. .-BEGINTime--=--00:00:00-. >--+-------------------------+--+------------------------+------> '-BEGINDate--=--date------' '-BEGINTime--=--time-----' .-ENDDate--=--TODAY-. .-ENDTime--=--23:59:59-. >--+-------------------+--+----------------------+--------------> '-ENDDate--=--date--' '-ENDTime--=--time-----' .-TYPE--=--BACKUPImage-----. >--+--------------------------+-------------------------------->< '-TYPE--=--+-BACKUPImage-+-' '-SNAPMirror--'
Parameters
- node_name (Required)
- Specifies the name of the NAS node for which backup objects are displayed. You cannot use wildcards to specify this name.
- filespace_name (Required)
- Specifies the name of the file space for which backup objects are displayed. You can use wildcards to specify this name.
- BEGINDate
- Specifies
the beginning date to select the backup objects to display.
All backup objects that were created on or after the specified date
are displayed. The default is seven days prior to the current date.
You can use this parameter with the BEGINTIME parameter to specify
a range for the date and time. This parameter is optional.You can specify the date using one of the following values:
Value Description Example MM/DD/YYYY A specific date 09/15/2002 TODAY The current date TODAY TODAY-days or -days The current date minus days specified. The maximum number of days you can specify is 9999. TODAY –7 or –7. To display information about the image objects that have been created a week ago, you can specify BEGINDATE=TODAY-7 or BEGINDATE= -7.
EOLM (End Of Last Month) The last day of the previous month. EOLM EOLM-days The last day of the previous month minus days specified. EOLM-1 To include files that were active a day before the last day of the previous month.
BOTM (Beginning Of This Month) The first day of the current month. BOTM BOTM+days The first day of the current month, plus days specified. BOTM+9 To include files that were active on the 10th day of the current month.
- BEGINTime
- Specifies the beginning time to select the backup objects to display.
All backup objects created on or after the specified time display.
This parameter is optional. The default is midnight (00:00:00) on
the date specified for the BEGINDATE. You can specify the time using one of the following values:
Value Description Example HH:MM:SS A specific time on the specified begin date 10:30:08 NOW The current time on the specified begin date NOW NOW+HH:MM or +HH:MM The current time plus hours and minutes on the specified begin date NOW+03:00 or +03:00. If you issue this command at 9:00 with BEGINTIME=NOW+3 or BEGINTIME=+3, Tivoli® Storage Manager displays image objects with a time of 12:00 or later on the begin date.
NOW-HH:MM or -HH:MM The current time minus hours and minutes on the specified begin date NOW-04:00 or -04:00. If you issue this command at 9:00 with BEGINTime=NOW-3:30 or BEGINTime= -3:30, Tivoli Storage Manager displays image objects with a time of 5:30 or later on the begin date.
- ENDDate
- Specifies the ending date used to select the backup objects to
be displayed. All backup objects created on or before the specified
date are displayed. This parameter is optional. The default is the
current date. You can use this parameter with the ENDTIME parameter
to specify an ending date and time. You can specify the date using one of the following values:
Value Description Example MM/DD/YYYY A specific date 09/15/2002 TODAY The current date TODAY TODAY-days or -days The current date minus days specified. The maximum number of days you can specify is 9999. TODAY–1 or –1. To display information created up to yesterday, you can specify ENDDATE=TODAY-1 or simply ENDDATE= -1.
EOLM (End Of Last Month) The last day of the previous month. EOLM EOLM-days The last day of the previous month minus days specified. EOLM-1 To include files that were active a day before the last day of the previous month.
BOTM (Beginning Of This Month) The first day of the current month. BOTM BOTM+days The first day of the current month, plus days specified. BOTM+9 To include files that were active on the 10th day of the current month.
- ENDTime
- Specifies the ending time used to select the backup objects to
be displayed. All backup objects created on or before the specified
time are displayed. This parameter is optional. The default is 23:59:59.
You can use this parameter with the ENDDATE parameter to specify a
range for the date and time. You can specify the time using one of the following values:
Value Description Example HH:MM:SS A specific time on the specified end date 10:30:08 NOW The current time on the specified end date NOW NOW+HH:MM or +HH:MM The current time plus hours and minutes on the specified end date NOW+03:00 or +03:00. If you issue this command at 9:00 with ENDTIME=NOW+3:00 or ENDTIME= +3:00, Tivoli Storage Manager displays image objects with a time of 12:00 or later on the end date you specify.
NOW-HH:MM or -HH:MM The current time minus hours and minutes on the specified end date NOW-03:30 or -03:30. If you issue this command at 9:00 with ENDTIME=NOW-3:30 or ENDTIME= -3:30, IBM® Tivoli Storage Manager displays image objects with a time of 5:30 or later on the end date you specify.
- TYPE
Specifies the type of NDMP backup images for which you want to display information. The default value for this parameter is BACKUPIMAGE. Other image types represent backup methods that might be specific to a particular file server. Possible values are:
- BACKUPImage
- Specifies that the output should show only the standard NAS base and differential images. This is the default value for this parameter.
- SNAPMirror
- Specifies whether to display information about NetApp SnapMirror images. SnapMirror images are block-level full-backup images of a file system. A SnapMirror image can only be restored to a file system that has been prepared as a SnapMirror target volume. Refer to the documentation that came with your NetApp file server for more information. This parameter is valid for NetApp and IBM N-Series file servers only.
Example:
Issue the QUERY NASBACKUP command to display information about a node, nas1, and a filespace, /vol/vol1.query nasbackup nas1 /vol/vol1
Node Filespace Object Object Creation Has Table Mgmt Class Image
Name Name Type Size Date of Contents Name Storage
(MB) (MB) Contents (TOC) Pool Name
----- -------- --------- ----- ---------- ---------- ---------- --------
NAS1 vol/vol1 Full image 1050.5 10/22/2002 YES DEFAULT NASBACKUPS
10:50:57
NAS1 vol/vol1 Differential 9.1 10/22/2002 YES DEFAULT NASBACKUPS
image 11:03:21
NAS1 vol/vol1 Full image 1050.5 10/22/2006 YES STANDARD FILEPOOL
10:43:00
NAS1 vol/vol1 Differential 9.1 10/25/2006 YES STANDARD FILEPOOL
image 11:53:21
Example:
Issue the QUERY NASBACKUP command to display information about all NetApp SnapMirror to Tape images for a node, nas2, and a filespace, /vol/vol2.query nasbackup nas2 /vol/vol2 type=snapmirror
Node Filespace Object Object Creation Mgmt Class Image
Name Name Type Size Date Name Storage
(MB) Pool Name
----- -------- --------–- ----—- ---------- ---------- -------–-
NAS2 vol/vol2 SnapMirror 1050.5 04/02/2008 STANDARD MYPOOL
10:50:57
NAS2 vol/vol2 SnapMirror 1450.5 04/02/2008 STANDARD MYPOOL
11:03:21
Related commands
Command | Description |
---|---|
BACKUP NODE | Backs up a network-attached storage (NAS) node. |
BACKUP NAS (Tivoli Storage Manager client command) | Creates a backup of NAS node data. |
QUERY TOC | Displays details about the table of contents for a specified backup image. |
RESTORE NODE | Restores a network-attached storage (NAS) node. |