Use this command to update the device name mapping or the availability of a device shared between the server and a specified storage agent. 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
>>-UPDate DRIVEMapping--storage_agent_name--library_name--drive_name--> >--+----------------------------+--+--------------------+-------> '-DEVIce--=--+-device_name-+-' '-ONLINE--=--+-Yes-+-' '-FILE--------' '-No--' >--+----------------------------------+------------------------>< '-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 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.
Examples
Task
Inform the server that TAPEDRIVE3 will be updated for the storage agent, SA1. The tape drive is in the shared library, SHARELIB, and the device name is mt1.0.0.1. Specify that the drive will be offline.
update drivemapping sa1 sharelib tapedrive3 device=mt1.0.0.1 online=no
Task
Change the directory by which storage agent SA1 accesses data in file library FILE1 because SA1 uses d:\tsm to access the same directory that the server accesses by directory e:\tsm. This directory has a mount limit of 4.
update drivemapping sa1 file1 file11 directory=d:\tsm update drivemapping sa1 file2 file12 directory=d:\tsm update drivemapping sa1 file3 file13 directory=d:\tsm update drivemapping sa1 file4 file14 directory=d:\tsm
Related Commands
Table 320. Commands Related to UPDATE 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 DRIVEMAPPING | Displays the device name mapping that was created with the DEFINE DRIVEMAPPING command. |
QUERY LIBRARY | Displays information about one or more libraries. |
UPDATE DEVCLASS | Changes the attributes of a device class. |
UPDATE DRIVE | Changes the attributes of a drive. |