Use connect to connect to the StarTeam Server. The connection persists until you use the disconnect command. Because the connection persists, you can specify all subsequent commands without using the -p option to connect with each command. However, to switch between projects, views, and working folders, use set project...[viewHierarchy ] [folderHierarchy ] while in the same session.
Before attempting to connect to the same session, you must disconnect. Use the disconnect command to disconnect from the session.
The syntax for this command is as follows:
stcmd connect [username[:password]@]address:port [passwordFromFile passwordFile] [storePasswordToFile passwordFile] [caseSensitiveFolders | -csf] [encryption = RC4|RC2_ECB|RC2_CBC_RC2_FCB] [compression | -cmp] [mpx=on|off (default ON) [profile=eventHandlerProfilename] [cacheAgent@address:port (default autoLocate] | =off] [[cacheAgentThreads=noOfThreads][-mode [lock | exlock | unlock]] [separator=fieldSeparator] [headers = on|off]
When the command maps the folder specified in the -p option to the underlying StarTeam folder, using -csf causes the command to differentiate StarTeam folders based on the case-sensitive spelling of their names This option does not apply to the case-sensitivity of filenames in the folders. For example, with -csf, StarTeam folders named doc and Doc are recognized as different folders. Without this option, either folder could be recognized as the doc folder.
The default is that StarTeam folders are not differentiated based on the case of letters in their names.
With or without -csf, if folder names are ambiguous, an error occurs. For example, when you use -csf, the names of two folders are ambiguous if both a Doc and doc folder exist. When you do not use -csf, folder names are ambiguous if they are spelled identically.
Encrypts all data sent between the workstation and the server and decrypts it when it arrives. Without this option, no encryption takes place. Encryption protects files, data and other project information from being read by unauthorized parties over unsecured networks.
This is an optional parameter. If not specified, then the server and the command line negotiate the encryption required by the server.
The full syntax is: -encrypt encryptionType.
The types of encryption are:
These encryption types are ordered from fastest to slowest. Each of the slower encryption types is safer than the one preceding it.
Compresses all the data sent between the workstation and the server and decompresses it when it arrives. Without this option, no compression takes place.
Compression speeds transmission across the network, but it takes time on the front end to compress the data and at the back end to decompress the data.
This is an optional parameter. If not specified, then the platform default is not to compress.
Indicates whether the server is to be locked, exclusively locked, or unlocked.