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.

Back to top

EPwdFile

EPF

EPwdFile <file name>

Specifies a file that contains the encrypted logon password. -EPwdFile overrides the <password> if provided in the Server parameter.

Back to top

PwdFile

PF

PwdFile <file name>

Specifies a file that contains the logon password. -PwdFile overrides the <password> if provided in the Server parameter.

Back to top

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.

Back to top

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).

Back to top

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.

Back to top