Administrator's Reference

DEFINE VOLUME (Define a Volume in a Storage Pool)

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. For a random access volume, before issuing this command you must allocate and format the volume by using the ANRFMT job or the ANRFMT2 job found in ASAMPLIB dataset. For information on using these jobs, see Administrator's Guide.

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, 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)                |
      '-LOcation-------=--location--'
 

Notes:

  1. This value is valid only for volumes assigned to copy storage pools.

  2. This parameter is valid only for sequential access volumes.

Parameters

pool_name (Required)
Specifies the name of the storage pool to which the volume is assigned.

volume_name (Required)
Specifies the name of the storage pool volume to be defined. The volume name that you can specify depends on the device class of the associated storage pool:

The volume name cannot contain any embedded blanks or equal signs.

ACCess
Specifies how client nodes and server processes (such as migration) can access files in the storage pool volume. This parameter is optional. The default value is READWRITE. Possible values are:

READWrite
Specifies that client nodes and server processes can read from and write to files stored on the volume.

READOnly
Specifies that client nodes and server processes can only read files stored on the volume.

UNAVailable
Specifies that neither client nodes nor server processes can access files stored on the volume.

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.

OFfsite
Specifies that the volume is at an offsite location from which it cannot be mounted. You can specify this value only for volumes in copy storage pools.

Use this value to help you track volumes at offsite locations. The server treats volumes designated as offsite differently:

  • The server does not generate mount requests for volumes designated offsite

  • The server reclaims or moves data from offsite volumes by retrieving files from other storage pools

  • The server does not automatically delete empty, offsite scratch volumes from a copy storage pool

LOcation
Specifies the location of the volume. This parameter is optional. It can be specified only for volumes in sequential access storage pools. The location information can be a maximum length of 255 characters. Enclose the location in quotation marks if it contains any blank characters.

Examples

Task 1

A storage pool named STGPOOL1 is assigned to a disk device class. Define a volume to this storage pool named 901, with READONLY access.

Command:
define volume stgpool1 901 access=readonly

Task 2

Define a volume named HARVEY.STG1 to the POOLA storage pool.

Command:
define volume poola harvey.stg1

Related Commands

Table 67. 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.


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