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".
-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. |
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>]
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.