Tivoli Storage Manager for Windows: Administrator's Reference

QUERY DRIVEMAPPING (Query Drive Mapping)

Use this command to display the device name mapping that was created using the DEFINE DRIVEMAPPING command. For additional information, see Administrator's Guide and TSM Managed System for SAN Storage Agent User's Guide.

Privilege Class

To issue this command, the administrator must have system privilege or unrestricted storage privilege.

Parameters

>>-Query DRIVEMapping------------------------------------------->
 
   .-*--*--*----------------------------------------------.
>--+------------------------------------------------------+----->
   |                     .-*--*-------------------------. |
   '-storage_agent_name--+------------------------------+-'
                         |               .-*----------. |
                         '-library_name--+------------+-'
                                         '-drive_name-'
 
   .-Format--=--Standard-----.
>--+-------------------------+---------------------------------><
   '-Format--=--+-Standard-+-'
                '-Detailed-'
 
 

Parameters

storage_agent_name
Specifies the name of the storage agent as specified in the DEFINE SERVER command. This parameter is required, if the library name or drive name is specified.

library_name
Specifies the name of the library to which the drive is defined. This parameter is required if a drive name is specified.

drive_name
Specifies the drive name that was mapped to the storage agent.

Format
Specifies how the information is displayed. This parameter is optional. The default is STANDARD. Possible values are:

Standard
Partial information is displayed.

Detailed
Detailed information is displayed.

Examples

Task

Display information about all drives that are mapped in a SAN.

Command:
query drivemapping

Output:
+--------------------------------------------------------------------------------+
|Storage Agent  Library   Drive       Device       On Line                       |
|Name           Name      Name                                                   |
|-------------  --------  ----------  -----------  -------                       |
|LF4CL1         3570LIB   TAPEDRIVE1  MT3.2.0.2    YES                           |
|LF4CL1         3570LIB   TAPEDRIVE3  MT3.2.0.1    YES                           |
|LF4CL1         SHARELIB  TAPEDRIVE4  MT1.0.0.1    YES                           |
|LF4CL1         SHARELIB  TAPEDRIVE5  MT1.0.0.3    NO                            |
|LF4CL1         FILE1     FILE11      FILE         YES                           |
+--------------------------------------------------------------------------------+

See the last task for field descriptions.

Task

Query the drive mapping for the storage agent, LF4CL1, and the library, 3570LIB. Get a detailed report.

Command:
query drivemapping lf4cl1 3570lib format=detailed

Output:
+--------------------------------------------------------------------------------+
|             Storage Agent Name: LF4CL1                                         |
|                   Library Name: 3570LIB                                        |
|                     Drive Name: TAPEDRIVE1                                     |
|                         Device: mt3.2.0.2                                      |
|                        On Line: YES                                            |
| Last Update by (administrator): ADMIN                                          |
|          Last Update Date/Time: 04/20/2000 10:25:03                            |
|                                                                                |
|             Storage Agent Name: LF4CL1                                         |
|                   Library Name: 3570LIB                                        |
|                     Drive Name: TAPEDRIVE3                                     |
|                         Device: MT3.2.0.1                                      |
|                        On Line: Polling since 04-20-00 10:42:02                |
| Last Update by (administrator): ADMIN                                          |
|          Last Update Date/Time: 04/20/2000 10:25:03                            |
|                                                                                |
+--------------------------------------------------------------------------------+
See the last task for field descriptions.

Task

|Query the drive mapping for the storage agent, OOGL. Get a |detailed report. |

|Command:
|query drivemapping oogl format=detailed

|Output:
|
|+--------------------------------------------------------------------------------+
||            Storage Agent Name: OOGL                                            |
||                  Library Name: FILE                                            |
||                    Drive Name: FILE1                                           |
||                        Device: file                                            |
||                       ON LINE: Yes                                             |
||                     Directory: f:                                              |
||Last Update by (administrator): SERVER_CONSOLE                                  |
||         Last Update Date/Time: 06/08/2001 10:37:44                             |
||                                                                                |
||            Storage Agent Name: OOGL                                            |
||                  Library Name: FILE                                            |
||                    Drive Name: FILE2                                           |
||                        Device: file                                            |
||                       ON LINE: Yes                                             |
||                     Directory: f:                                              |
||Last Update by (administrator): SERVER_CONSOLE                                  |
||         Last Update Date/Time: 06/08/2001 10:37:48                             |
|+--------------------------------------------------------------------------------+

where:

Storage Agent Name
The name of the storage agent for which the drive mapping was defined.

Library Name
The name of the library to which the drive is assigned.

Drive Name
The name of the drive in the library.

Device
The name of the device that corresponds to the drive.

On Line
Whether the device is online.

Last Update by (administrator)
The name of the administrator who performed the last update to the drive mapping.

Last Update Date/Time
The date and time when the last update occurred.

Directory
The directory location of the files used by the storage agent. It is valid only for drives in file libraries.

Related Commands

Table 179. Commands Related to QUERY DRIVEMAPPING

Command Description
DEFINE DRIVE Assigns a drive to a library.
DEFINE DRIVEMAPPING Defines the drive name that will be mapped to the storage agent allowing for direct storage and retrieval of data.
DEFINE LIBRARY Defines an automated or manual library.
DELETE DRIVEMAPPING Deletes the drive name that was mapped to the storage agent for direct storage and retrieval of data.
QUERY DRIVE Displays information about drives.
QUERY LIBRARY Displays information about one or more libraries.
UPDATE DRIVE Changes the attributes of a drive.
UPDATE DRIVEMAPPING Updates the drive name that was mapped to the storage agent allowing for direct storage and retrieval of data.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]