Db_rundown

The db_rundown utility executes the rundown procedure for the specified database. If no database is specified, the default database, RT_DATABASE, is run down.

To start db_rundown

Enter the following at the system prompt:

db_rundown [qualifiers] <database name>

You must have DELETE access to a database in order to run down that database. The rundown procedure forces the removal of all images currently connected to the database. Events and wakes scheduled on channels in the database are also removed. You can start a new program to connect to the database, or you can create a new version of the database using the vgen and db_map commands.

Parameter

You must specify the name of the database to be run down on the command line.

Qualifiers

You can use the following qualifiers, preceded by a "/" or "-" character, with the db_rundown command:

help

Use the help qualifier to display a summary of usage, parameters, and qualifiers for db_rundown.

output

output=<filename>

Use the output qualifier to specify a file in which db_rundown will save its text output.

stop

Use the stop qualifier to cause any programs connected to the database to exit. The database is then removed from memory and the database files are deleted.

task

task=<task number>

Use the task qualifier, in conjunction with the stop qualifier, to accept a task number, as given by vinfo -task <database>, and stop the given task.

For example:

> vinfo -task alarmdb

Database:ALARMDB

TASK TABLE

NUM_SLOTS:256

TASK Process ID Group/Link Status

1 19721 1 0 Running db_view alarmdb::volume_left

EVENT_QUE:size= 100, head= 0, tail= 0

2 19713 2 0 Running valarm_viewer alarmdb::volume_left

EVENT_QUE:size= 1000, head= 2, tail= 2

> db_rundown -task=1 -stop alarmdb

version

Use the version qualifier to report the version number for db_rundown.

Example

c:\program files\vista\vsys\bin>db_rundown /stop testdb

	Note You can use db_rundown to ensure that no processes are connected to a database before you map a new version of the database. In addition, you can use db_map with the rundown and stop qualifiers to cause db_map to perform the rundown processing.