Use this command to define a drive mapping that allows a client system to send data directly to a device on a storage area network (SAN) through the storage agent. The storage agent uses the drive mapping to perform LAN-free data transfer. You must first define the drive to the server and then define a drive mapping for each |storage agent using LAN-free data transfer. For additional information, see Administrator's Guide and TSM Managed System for SAN Storage Agent User's Guide.
Privilege Class
To issue this command, you must have system privilege or unrestricted storage privilege.
Syntax
>>-DEFine DRIVEMapping--storage_agent_name--library_name--drive_name--> .-ONLINE--=--Yes-----. >--DEVIce--=--+-device_name-+--+--------------------+-----------> '-FILE--------' '-ONLINE--=--+-Yes-+-' '-No--' .-DIRectory--=--current_directory_name-. >--+--------------------------------------+-------------------->< '-DIRectory--=----directory_name-------'
Parameters
|The directory name identifies the location where the storage agent reads |and writes the files that represent storage volumes for the FILE device class |that is associated with the FILE library. The default value for |DIRECTORY is the directory of the server at the time the command is issued, |unless the DSMSERV_DIR environment variable has been set. In most |cases, the default value for DIRECTORY will not be useful because the |directory location can vary among systems accessing the same data on the |SAN.
|Use a naming convention that allows you to associate the directory with a |particular physical drive. This can help ensure that your configuration |is valid for sharing the FILE library between the server and storage |agent. If the storage agent is on a Windows NT or Windows 2000 system, |use a universal naming convention (UNC) name.
|For information about the DSMSERV_DIR variable, refer to Quick |Start.
Examples
Tasks
Let storage agent SA1 access TAPEDRIVE3 on the SAN. The tape drive is in the shared library, SHARELIB. The device name is mt1.0.0.1. Specify that the drive will be online.
define drivemapping sa1 sharelib tapedrive3 device=mt1.0.0.1 online=yes
A FILE device, FILE11, is defined to library FILE1 on the TSM server. Let storage agent SA1 access FILE11 whose data on the TSM server resides in e:\tsmdata\server1. On the storage agent, this data appears in directory d:\tsmdata\server1.
define drivemapping sa1 file1 file11 device=file online=yes dir="d:\tsmdata\server1"
Related Commands
Table 66. Commands Related to DEFINE DRIVEMAPPING
Command | Description |
---|---|
DEFINE DEVCLASS | Defines a device class. |
DEFINE DRIVE | Assigns a drive to a library. |
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. |
DEFINE SERVER | Defines a server for server-to-server communications. |
QUERY DRIVE | Displays information about drives. |
QUERY DRIVEMAPPING | Displays the device name mapping that was created with the DEFINE DRIVEMAPPING command. |
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. |