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

Table 1. Commands related to QUERY NASBACKUP
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.