Use this command to define a drive mapping allowing 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 mapping to the drive to perform LAN-free data transfer. Define a drive mapping for each client using LAN-free data transfer. You must define the drive to the server before defining the drive mapping. 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.
Parameters
>>-DEFine DRIVEMapping--storage_agent_name--library_name--drive_name--> .-ONLINE--=--Yes-----. >----DEVIce--=--device_name----+--------------------+---------->< '-ONLINE--=--+-Yes-+-' '-No--'
Parameters
Note: | The name used for the storage agent must match the name that was defined when the storage agent was installed. |
Note: | Currently, this command only applies to small computer system interface (SCSI) libraries that are shared. |
Note: | Device names must follow Windows protocol because storage agents are only available on that platform, for now. Commands can be issued on other platforms if shared SCSI libraries are attached to the machine. An example of a device name used by Windows is mt1.0.0.1. |
Examples
Task
Allow the storage agent, SA1, to 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
Related Commands
Table 59. Commands Related to DEFINE DRIVEMAPPING
Command | Description |
---|---|
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. |