Tivoli Storage Manager for Sun Solaris Administrator's Reference

DEFINE LOGVOLUME (Define a Recovery Log Volume)

Use this command to define a new recovery log volume. All recovery log volumes must reside on random access media. You can have TSM create the volume before it is assigned.

Attention: You cannot change the size of an allocated recovery log volume after you have defined it to TSM. If you change the size of TSM volumes TSM may not initialize correctly and you could lose data.

A recovery log volume must be at least 9MB. Storage space is used in 4MB blocks and 1MB is used for overhead purposes. For example, if you define a recovery log volume with a capacity of 9MB, 8MB are available for storage on the volume.

Privilege Class

To issue this command, you must have system privilege or unrestricted storage privilege.

Syntax

>>-DEFine LOGVolume--volume_name-------------------------------->
 
                                      .-Wait--=--No------.
>-----+---------------------------+---+------------------+-----><
      '-Formatsize--=--megabytes--'   '-Wait--=--+-No--+-'
                                                 '-Yes-'
 

Parameters

volume_name (Required)
Specifies the file name of the recovery log volume. The name cannot contain any embedded blanks or equal signs.

Enter this name as either a regular file name or, if you are using a raw partition, a symbolic link to the character special file. A regular file name can be either a fully qualified path name or a path name relative to the current working directory. For example, if the file name is mainvol and the current working directory is /opt/IBMadsm-s/bin, the volume name would be:

     /opt/IBMadsm-s/bin/mainvol

A symbolic link to a character special file would be entered in the format:

  /dev/.../rdsk/.../fn

Where /... is zero or more directories and fn is the file name. For example,

  /dev/rdsk/c1t3d0s6
Attention:TSM cannot always detect if data already exists on a raw partition. Existing data can be destroyed if you define a volume to that partition.

Formatsize
Specifies the size of the volume that is defined and formatted in one operation. This parameter is optional. The value is specified in megabytes.

Wait
Specifies whether a volume creation and formatting operation is performed in the foreground or background. This parameter is optional. The default is NO. It is ignored unless the FORMATSIZE parameter is also specified.

No
Specifies that a volume creation and formatting operation is performed in the background.

Yes
Specifies that a volume creation and formatting operation is performed in the foreground.
Note:You cannot specify WAIT=YES from the server console.

Examples

Task 1

Define a recovery log volume LOG.2.

Command:
define logvolume log.2

Task 2

Create a new log volume of 20MB with a name of log3.dsm and wait for the server to define the volume.

Command:
define logvolume /var/adsmserv/log3.dsm formatsize=20 wait=yes

Related Commands

Table 66. Commands Related to DEFINE LOGVOLUME

Command Description
DEFINE LOGCOPY Creates a volume copy of a recovery log volume.
DELETE LOGVOLUME Deletes a volume from the recovery log.
EXTEND LOG Extends usable log storage within the volumes previously allocated for its use.
QUERY LOG Displays allocation information about the recovery log.
QUERY LOGVOLUME Displays information about log volumes.


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