Tivoli Storage Manager for Windows Administrator's Reference

DEFINE DRIVEMAPPING (Define Drive Mapping)

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

storage_agent_name (Required)
Specifies the name of the storage agent. Before issuing this command, define the storage agent as a server using the DEFINE SERVER command.
Note:The name used for the storage agent must match the name that was defined when the storage agent was installed.

library_name (Required)
Specifies the name of the library to which the drive is defined. This parameter is required for all drives, including stand-alone drives.
Note:Currently, this command only applies to small computer system interface (SCSI) libraries that are shared.

drive_name (Required)
Specifies the drive name being mapped to the storage agent.

DEVIce (Required)
Specifies the device name used to access the drive from the storage agent. The name the storage agent uses must be specified here.
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.

ONLine
Specifies the drive availability for the storage agent. The default is YES.

Yes
Specifies that the drive is available for use. The default is YES.

No
Specifies that the drive is not available for use.

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.

Command:
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.


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