bkt_tool

Platform: Windows

Subcommands: delete, export, import, update

bkt_tool

option -dbset dbset -us "username" -password password -db "dbname" { -directory "pathname" | -storagefile "pathname"}

The bkt_tool command exports and imports all the contents of a Public Folder, available in the Rational® ClearQuest® client workspace, from one user database to another. This utility is helpful when you are developing a new schema based either on the Blank or Common predefined schema and want to work with queries, charts, and reports without having to create them all.

This utility is also useful when you are working with test databases. For example, you may want to test queries, charts, and reports in the test database before introducing schema changes in the production database. In this case, you can use bkt_tool to export and imort all the production workspace items to the test database.

The subcommands available with the bkt_tool allow you to:

• Export all Workspace contents from the Public Folder, available in the Rational ClearQuest Client, to a file.
• Import all the Workspace contents into another user database.
• Update the Workspace contents for a given user database.
• Delete Workspace contents for a user database.

option

One of -e (export), -d (delete), -i (import), -u (update)

dbset

Specifies the schema connection name. Required if there are multiple schema repositories in the system.

username

The ClearQuest login name of the user. This user must have Super User privileges.

password

The ClearQuest password for the user. If there is no password, enter an empty set of double quotes.

dbname

The logical name of the user database from which you are exporting the Workspace contents.

pathname

The path name of the exported file. Enclose the path name in double quotes. If -directory is specified, the pathname containing the various files comprising the load must exist if the option specified is -i or -u. The directory contains a text file named CONTENTS.CFG and a series of files 0001.DAT through nnnn.DAT that contain the binary data for each of the Workspace items. If -storagefile is specified then the pathname is the path name of an IStorage compound document.

• Save the test1 user database workspace in the directory d:\temp\bkt_test and then delete the workspace.

  bkt_tool -d -dbset 1.1 -us "admin" -password "" -db "test1" -directory "d:\temp\bkt_test"
  

• Export the workspace contents of the Public Folder from the CLSIC user database to the directory d:\temp\bkt_test.

  bkt_tool -e -dbset 1.1 -us "admin" -password "" -db "CLSIC" -directory "d:\temp\bkt_test"
  

• Import the contents of d:\temp\bkt_test to the test1 user database.

  bkt_tool -i -dbset 1.1 -us "admin" -password "" -db "test1" -directory "d:\temp\bkt_test"
  

• Update the test1 user database from the directory d:\temp\bkt_test.

  bkt_tool -u -dbset 1.1 -us "admin" -password "" -db "test1" -directory "d:\temp\bkt_test"
  

delete, import, export, update