VCMUtility Connection Options
This topic defines VCMUtility functionality in terms of its connection options.
In this topic:
Encryption
Encrypt
En
Encryption {NONE | RC4 | RC2_ECB | RC2_CBC | RC2_CFB}
Specifies the encryption level of the server connection. The default is NONE. However, due to SDK behavior, if necessary, the VCMUtility will automatically upgrade the encryption level to the minimum value required by the StarTeam server.
EPwdFile
EPF
EPwdFile <file name>
Specifies a file that contains the encrypted logon password. -EPwdFile overrides the <password> if provided in the Server parameter.
PwdFile
PF
PwdFile <file name>
Specifies a file that contains the logon password. -PwdFile overrides the <password> if provided in the Server parameter.
Server
S
Server [<user>[:<password>]@]<host>[:<port>]
Specifies the StarTeam server to which the VCM Utility will connect.
- If <user> and AutoLogon are not specified, the logon <user> defaults to "Administrator."
- If <password> and PwdFile are not specified, the VCMUtility prompts for the password.
- If a <user> or <password> contains the characters ":" or "@", or a blank, it must be enclosed in single or double quotes.
- If a <user> or <password> is quoted, it can contain an embedded quote of the same type by escaping (preceding) it with a backslash (\).
- If a quoted <user> or <password> contains an embedded backslash, it must be escaped with another backslash. For example, a double backslash within a quoted token is interpreted as a single backslash.
- The server <host> can be a host name or IP address. The <host> is required if the Server option is specified.
- If the Server option is not specified, the <host> defaults to localhost. If not specified, the <port> defaults to 49201.
UseCA
UCA
UseCA {<host>:<port> | AutoLocate}
Specifies that file check-outs should attempt to use an MPX Cache Agent. The Cache Agent can be explicitly provided with a host name or address (<host> and port number (<port>), or the network-nearest Cache Agent can be automatically located (AutoLocate).
UseServerProfile
USP
UseServerProfile [True | False]
If true, specifies that the <host> name specified in the Server option should be interpreted as a server profile name. Server profiles are stored in the user's starteam-servers.xml file. A server profile specifies a StarTeam server host name, port number, encryption level, and compression setting. Consequently, when UseServerProfile is specified, the Server option must be specified but should not contain a port number, and the Encryption option should not be specified.