Starting TC-Shell

The TC-Shell must be started from the Windows command line using parameters and parameter values.

The command TCShell.exe starts the TC-Shell. The TCShell.exe file is located in the following directory: %COMMANDER_HOME%. Executing the TCShell.exe requires that a workspace is specified. In addition, there are also optional start parameters available.

The TCShell.exe.config file contains options which can be activated, deactivated or modified. For further information please refer to chapter "TCShell.exe.config".

Start parameters

TC-Shell Command line parameters

-help

Output of the available parameters

-workspace <workspacePath>

Path to the TC workspace file

-login <username> <password>

Login Info, otherwise interactive query of login and password, if necessary. This parameter is case sensitive.

-record <recordScriptPath>

Path to a file in which all interactive input is saved as text. This file can be used directly for the script mode.

{ <tcscriptPath> }

Any number of TC-Shell script files; if no script is indicated, the TC-Shell starts in the interactive mode.

-healthCheck

Executes a healthCheck of the indicated workspace.

-codepage <number>

Sets the desired codepage to be used in the interactive mode (see chapter "Working in interactive mode").

-codepage ?

Displays the currently used codepage and all available codepages.

-executionmode

Opens Tosca Commander in read-only mode. Only operations, which are required for the test execution, are possible.

-restoredbbackup

Restores the repository in interactive mode (see chapter "Back up and restore repositories"). As in the script mode, a .tcs file can be specified, containing the information required for the process.

-revision <revision>

Creates a workspace with a specific revision.

-slimWS

A workspace is created for a multi-user repository where all objects are disabled by default (see chapter "Create multi-user workspaces").

-waitforcompacting

Tosca Commander is waiting for finishing compacting the TC workspace (see chapter "Compact Workspace:").

Without applying this command Tosca Commander terminates the background compacting.

In the example below, the system opens the existing workspace test and runs the parameter help to show all available parameters.

TC-Shell: Opening the workspace and running the help parameter

Create new workspace

The TCShell.exe file can also be used to create new workspaces.

The parameter to create a new workspace contains the following parameter values, depending on the repository type:

-newworkspace <workspaceDirPath> SQLITE [<commonRepoPath>]

or

-newworkspace <workspaceDirPath> {"DB2","Oracle","MS SQL Server"} <datasource> <user> <pwd> [<schema>]

or

-newworkspace <workspaceDirPath> {"DB2","Oracle","MS SQL Server"} <connectionstring> [<schema>]

Create new workspace - parameter values

Parameter value

Description

<workspaceDirPath>

Path to the directory where the workspace is created.

[<commonRepoPath>]

Path to the local multi-user repository SQLite. If this value is either omitted or specified with " ", a single-user workspace is created.

{"DB2","Oracle",
"MS SQL Server"}

The repository type is selected.

<datasource>

Specifies the database server (IP or DNS name)

<user>

Specifies the database user

<pwd>

Specifies the password of the database user

[<schema>]

Specifies the use of the database schema

<connectionstring>

String to connect to the database. The syntax is usually either

"Server=;Database=;UID=;PWD=;" (DB2, MS SQL Server or "Data Source=;User Id=;Password=;" (Oracle).

In the example below, a new workspace called TestWorkspace is created.

Example: Creating a new workspace

After you have created a new workspace you have to open this to be able to run further parameters.

Example: Opening a workspace

Create new branch

You can create a branch in TC-Shell to work in multiple versions of your System Under Test simultaneously. To do this, use the optional parameter -branchName.

TCShell -branchName parameter