Administrator's Reference
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:
- This value is valid only for volumes assigned to copy storage
pools.
- 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:
- For VSAM linear data sets, specify a standard VSAM cluster name, as
defined in the installation JCL. The VSAM cluster must exist and be
formatted for the DEFINE to succeed. An example is
ADSM.BFS.POOL2.VOLA.
- For file data sets, specify a data set name. The data set name can
consist of one or more qualifiers, which are delimited by a period. The
qualifiers can contain up to 8 characters. The maximum length of the
data set name is 44 characters. The first letter of each qualifier must
be alphabetic or national (@#$), followed by alphabetic, national, hyphen, or
numeric characters. If the dataset does not exist, the server will
create it. An example is
ADSM.BFS.POOL3.VOLA.
- For tape cartridges, specify a 1 to 6 alphanumeric tape volume
name. An example is DSMT01 (TSM always converts tape volume names to
uppercase).
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 ]