Entering content frame

Procedure documentation auto_extend Locate the document in the library structure

Use

You can configure your database system in such a way that it automatically adds a new data volume as soon as the fill level of the data area reaches a certain percentage. To do this, activate the automatic extension of the data area. The number of data volumes that can be added whilst the database is in operation is limited by the value of the MAXDATAVOLUMES database parameter.

When you activate this function you can specify a percentage value and thus when the system should add the data volume. If you do not specify a percentage value, the system will add a data volume when the fill level reaches 90%. You can overwrite the defined value by executing the DBM command again.

The system uses existing volume definitions to determine a default name for the new data volume. This name is then used.

You can use the AutoExtDir Database Manager parameter to define the directory in which the new data volume is to be created (see: dbm_configset). If this parameter is not defined, the Database Manager creates the new data volume in the run directory of the database instance.

Note

Like other DBM commands, this one requires its own event task. For this reason, make sure when you execute this DBM command that the _MAXEVENTTASKS database parameter is large enough.

Prerequisites

·        You have the server authorization ParamFull or AccessUtility.

·        The database instance is in the ONLINE operational state.

Syntax

auto_extend <mode> [<number>]

Options

Option

Description

<mode>

Function for automatically extending the data area; possible values are:
ON: activate function
OFF: deactivate function
SHOW: display function

<number>

Percentage value as threshold for when a new data volume is created

Valid values are: 1 <= <number> <= 100

The default value is 90

Reply

OK

[ON [<number>] | OFF [, <reason> | UNKNOWN]

Values for the Reply Fields

Value

Description

ON

The function for automatically extending the data area is active

<number>

Defined percentage as of which the system adds a data volume

OFF

The function for automatically extending the data area is not active

<reason>

Reason why the function was deactivated

UNKNOWN

The status of the function for automatically extending the data area cannot be determined

Examples

Logging on to the Database Manager CLI as operator OLEG with the password MONDAY, connecting to the database instance DEMODB (logon in session mode),

·        Activating the function for automatically extending the data area; the system is to add a data volume as soon as the data area is 66 % full:

>dbmcli -d DEMODB -u OLEG,MONDAY

dbmcli on DEMODB>auto_extend ON 66

OK

·        Displaying the status of the function for automatically extending the data area:

dbmcli on DEMODB>auto_extend SHOW

OK

ON 66

 

Leaving content frame