Home > Veritas Storage Foundation™ for DB2 Manual Pages


User Commands

Table of contents


dbdst_convert - Convert volume based filesystem to DBDST ready MVS filesystem


dbdst_convert -D DB2DATABASE \[ -I DB2INSTANCE -M mount_device

     -v newvol,newvol, 


This command is part of Veritas Storage Foundation for DB2. To determine whether this product is installed on an \1 system, type:

lslpp -L VRTSdb2ed


The dbdst_convert command is used to convert an existing volume based regular filesystem to DBDST ready MVS filesystem. The volume represented by the <mount_device> will be renamed to <mount_device>-b4vset. A new volume-set by name <mount_device> will be created. The old filesystem will be converted to MVS filesystem. The new volumes specified via argument newvol,newvol will be added to the MVS. All but the last volume will be classified as PRIMARY storage class. The last volume of the MVS will be classified as SECONDARY storage class. At the completion of this command, the filesystem is ready for DBDST use. The database can be online when executing this command, but the database objects residing on this filesystem should be offlined using apprpriate SQL and the filesystem should be unmounted. After executing this command, DBA should online the concerned database objects which were offlined earlier after mounting the filesyste after mounting the filesystem. The first volume of the MVS filesystem meant for both metadata and datablocks. The second and subsequent volumes of the MVS are meant for datablocks only. DBA should make sure that the first volume has enough free space for all the filesstem metadata. The space usage can be seen by using dbdst_show_fs command.


The following options are supported:
.\" $Id: dbdst_options.inc,v 1.1 2006/02/16 01:33:08 susanl Exp $
-D DB2DATABASE Specifies the name of the DB2 database for which information will be retrieved.
Specifies the name of the DB2 instance. If the instance is not specified, the current user will be used as the instance name.
-M mount_device
Specifies the block device where the file system resides. This should be of the form '/dev/vx/dsk/<dgname>/<vsetname>'
-v newvol,newvol,...
Specifies the list of new volumes that will be added to the MVS

Real Application Clusters (RAC) Considerations

This command is supported in a RAC environment. This command can be run on any node of the RAC.


This example shows how to convert old volume based archivelog filesystem to a DBDST ready MVS filesystem on device /dev/vx/dsk/oradata/arch.

$ /opt/VRTS/bin/dbdst_convert -D PROD -M  /dev/vx/dsk/db2dg/arch   -v vol3,vol4


This command must be run as DB2 instance owner. This command can be executed when the database is online. Make sure the database objects residing on this filesystem are offline. db2ed_update must be run at least once before this command to ensure an up-to-date repository.

If the datbabase is configured for flashsnap, make sure the snapshots are resynced before running this command.


Please set LIBPATH to include /opt/VRTSdbms3/lib32


Command executed successfully.
An Error Occured.
Licence check failed.
No license to execute this command.
Invalid Storage Class
The device or mount point is not owned by user


dbdst_classify(1M), dbdst_admin(1M), dbdst_convert(1M), dbdst_file_move(1M), dbdst_fstat(1M), dbdst_makelbfs(1M), dbdst_partition_move(1M), dbdst_preset_policy(1M), dbdst_report(1M), dbdst_rmvol(1M), dbdst_show_fs(1M), dbdst_tbs_move(1M), db2_edition(7)

Veritas Storage Foundation for DB2 Administrator's Guide

Last updated: 15 Jan 2006
Copyright ©2009 Symantec Corporation
All rights reserved.