MIGRATION commands


PROGRAM NAME

dbcnvrt - Convert from a pre-Khoros 2.0 kdbm file to a 2.0 kdbm file

DESCRIPTION

This program is used to update kdbm files that were created before the public release of Khoros 2.0. dbcnvrt has two modes of operation.

In the first mode, it takes an input and output filename and does a direct conversion of a kdbm file. This mode of operation is used to convert kdbm files one at a time, and is the only way to convert the Khoros 2.0 pre-release VIFF data files.

In the second mode, it takes a toolbox name as an argument. With this toolbox argument, it searches all the files in the toolbox for kcms database files. This search includes the cantata object cache, the manpage database file, the library function database files and all the cms functions. It doesn't search for VIFF files, because these are not located in standard places.

REQUIRED ARGUMENTS

Mutually Exclusive Group; you must specify ONE of:

ALL OF the Mutually Inclusive Group:

-i
type: infile
desc: Input database file
default: {none}
AND
-o
type: outfile
desc: Output Database Filename
default: {none}

-tb
type: string
desc: Change the cms databases for a whole toolbox
default: {none}

OPTIONAL ARGUMENTS

-rm
type: flag
desc: Remove the original unconverted DB files

EXAMPLES


\f(CW
% kdbmcat -dbm old.dbm

Toolbox: SUPPORT Program: kdbmcat Library: kutils Routine: read_header This dbm file \'old.dbm\' is in a pre-Khoros 2.0 form, please run the \'dbcnvrt\' program on it.

kdbmcat: Failed to open database \'old.dbm\'

% dbcnvrt -i old.dbm -o new.dbm

% kdbmcat -dbm new.dbm \'MY_KEY1\': My data 1

\'MY_KEY2\': My data 2

%

\fP

SEE ALSO

kdbmcat(1), kcms(3), klibdb(3)

RESTRICTIONS

The kdbm code was updated to fix bugs on the CRAY Architecture, hence this program cannot update old kdbm files on a CRAY.

REFERENCES

Migration Toolbox Manual

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.