Use this command to assign a random or sequential access volume to a storage pool.
For a random access storage pool, you must use this command to define volumes that create space in the pool. When defining a random access volume, you can have the server create the volume before it is assigned.
For a sequential access storage pool, you create space by defining volumes, by allowing the server to request scratch volumes as needed (the MAXSCRATCH parameter for the storage pool), or by doing both.
Attention: The size of a storage pool volume cannot be changed once it has been defined to the TSM server. If you change the size of TSM volumes by altering the file sizes of TSM volumes, the server may not initialize correctly and data could be lost.
Privilege Class
To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the storage pool to which the volume is assigned.
Syntax
>>-DEFine Volume--pool_name--volume_name------------------------> .-ACCess--=--READWrite--------. >--+-----------------------------+------------------------------> '-ACCess--=--+-READWrite----+-' +-READOnly-----+ +-UNAVailable--+ | (1) | '-OFfsite------' >--+-----------------------------------------------------+------> | (2) .-Wait--=--No------. | '-Formatsize-------=--megabytes--+------------------+-' '-Wait--=--+-No--+-' '-Yes-' >--+----------------------------+------------------------------>< | (3) | '-LOcation-------=--location-'
Notes:
Parameters
Device Type | Volume Name Requirements | Example |
---|---|---|
DISK |
The name of the file to contain the volume data, with either the fully
qualified path name or the path name relative to the current working directory
|
"c:\program files\tivoli\tsm\server\data3.dsm" |
FILE | The name of the file to contain the volume data, with either the fully qualified path name or the path name relative to the directory identified in the DIRECTORY parameter for the device class |
"f:\data storage\fpool01.dsm" |
Tape | 1-6 alphanumeric characters
The server converts volume names to uppercase. |
DSMT01 |
Optical or WORM | 1-32 alphanumeric characters
The server converts volume names to uppercase. |
DSM_SP001 |
REMOVABLEFILE | 1-6 alphanumeric characters
The server converts volume names to uppercase. |
DSM01 |
|
If you define a random access volume as UNAVAILABLE, you cannot vary the volume online.
If you define a sequential access volume as UNAVAILABLE, the server does not attempt to access the volume.
Use this value to help you track volumes at offsite locations. The server treats volumes designated as offsite differently:
If you do not use this parameter, you must use the DSMFMT utility to create a file for a volume before defining the volume.
Examples
Task 1
Create a new volume of 100MB in the disk storage pool named BACKUPPOOL. The volume name is j:\storage\bf.dsm. Let the volume be created as a background process.
define volume backuppool j:\storage\bf.dsm formatsize=100
Task 2
A storage pool named POOL1 is assigned to a tape device class. Define a volume named TAPE01 to this storage pool, with READWRITE access.
define volume pool1 tape01 access=readwrite
Task 3
A storage pool named FILEPOOL is assigned to a device class with a device type of FILE. Define a volume named fp_vol01.dsm to this storage pool.
define volume filepool j:\storage\fp_vol01.dsm
Related Commands
Table 89. Commands Related to DEFINE VOLUME
Command | Description |
---|---|
DEFINE STGPOOL | Defines a storage pool as a named collection of server storage media. |
DELETE VOLUME | Deletes a volume from a storage pool. |
QUERY VOLUME | Displays information about storage pool volumes. |
UPDATE VOLUME | Updates the attributes of storage pool volumes. |