Tivoli Storage Manager for Windows: 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 a 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.

Note:
The maximum size of the recovery log is 13GB. Increasing the size of your recovery log significantly could also significantly increase the time required to restart the server, back up the database, and restore the database.

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.

Enter this name as either a fully qualified path name or a name relative to the server's current working directory. Enclose the name in quotation marks if it contains embedded blanks, equal signs, or other special characters. For example, if the file name is log1.dsm, enter the path name as:

"c:\program files\tivoli\tsm\server\log1.dsm"

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 named 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 "c:\program files\tivoli\tsm\server\log3.dsm" formatsize=20 wait=yes

Related Commands

Table 71. Commands Related to DEFINE LOGVOLUME

Command Description
DEFINE LOGCOPY Creates a volume copy of a recovery log volume.
DEFINE SPACETRIGGER Defines the database or recovery log space trigger.
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.
UPDATE SPACETRIGGER Changes attributes of the database or recovery log space trigger.


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