![]() |
![]() |
Use this command to assign a random or sequential access volume to a storage pool. Defining a volume does not set its status to private. If you want to do so, you can issue the UPDATE LIBVOLUME command.
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 Tivoli Storage Manager server. If you change the size of Tivoli Storage Manager volumes by extending raw logical volumes through SMIT or otherwise altering the file sizes of the 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
|
/usr/storage/sbkup01.dsm If you are using an AIX logical volume, enter the path name as: /dev/rxxx where xxx is the logical volume name. |
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 |
/data/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 /var/storage/bf.dsm. Let the volume be created as a background process.
define volume backuppool /var/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 filepool_vol01 to this storage pool.
define volume filepool /usr/storage/filepool_vol01
Task 4
A storage pool named OPOOL is assigned to a device class with a device type of OPTICAL. Define a volume named LONGTERMVOL to this storage pool.
Related Commands
Table 88. 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. |