Tivoli Header

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 by extending raw logical volumes through SMIT or otherwise altering the file sizes, 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. The name cannot contain any embedded blanks or equal signs.

Enter this name as either a fully qualified path name or a name relative to the server's current working directory. For example, if the file name is mainvol, enter the path name as:

/user/lpp/adsmserv/bin/mainvol

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 /var/adsmserv/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 ]