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 will be mapped to the storage agent.

Format
Specifies the format of the query output.

Standard
Specifies the standard query containing the minimal necessary information. Standard is the default.

Detailed
Specifies a detailed query containing all information about the selected parameters.

Examples

Task 1

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                            |
+--------------------------------------------------------------------------------+

Task 2

Query the device name mapping of a 3570 library, 3570LIB, for the storage agent, LF4CL1. Specify a detailed report for the format of the query.

Command:
query drivemapping lf4cl1 3570lib format=detailed

+--------------------------------------------------------------------------------+
|             Storage Agent Name: LF4CL1                                         |
|                   Library Name: 3570LIB                                        |
|                     Drive Name: TAPEDRIVE1                                     |
|                    Device Type: 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 Type: 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                            |
|                                                                                |
+--------------------------------------------------------------------------------+

Related Commands

Table 167. 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 ]