Navigation:  Actions > Embarcadero/Borland > StarTeam >

StarTeam Action Command Tab

Previous pageReturn to chapter overviewNext page

This tab of the StarTeam action configures flags that apply to the command.


Command: The StarTeam command to perform (required).


Files or masks: Specifies the files to be used in the command by name or by file name-pattern specification (optional, one per line). All options are interpreted using the semantic conventions of UNIX instead of Windows because UNIX’s conventions are more specific. This means that "*", rather than "*.*" means "all files." The pattern "*.*" means "all files with file name extensions." For example, "star*.*" finds starteam.doc and starteam.cpp but not starteam. To find all of these, you could use "star*".  When not specified, the default is "*".  If you use * rather than "*" to indicate all files, a UNIX shell expands it into a series of items and passes this series as a group of options to the stcmd command. This can cause problems, for example, when you are checking out missing files, so it is best to use "*" to avoid unwanted complications.


Several special characters can be used in file specifications:

* Matches any string including the empty string. For example, "*" matches any file name, with or without an extension. "xyz*" will match "xyz" and "xyz.cpp" and "xyzutyfj".
? Matches any single character. For example, "a?c" will match "abc" but NOT "ac"
[...] Matches any one of the characters enclosed by the left and right brackets. A pair of characters separated by a hyphen (-) specifies a range of characters to be matched. If the first character following the right bracket ( [ ) is an exclamation point ( ! ) or a caret ( ^ ), the rest of the characters are not matched. Any character not enclosed in the brackets is matched. For example, "x[a-d]y" matches "xby" but not "xey". "x[!a-d]y" matches "xey" but not "xby". A hyphen (-) or right bracket ( ] ) may be matched by including it as the first or last character in the bracketed set. To use an asterisk (*), question mark (?), or left bracket ( [ ) in a pattern you must precede it with the escape character (which is the backslash \ ).


Apply command recursively: If checked, applies the command recursively to all child folders.  If unchecked, the command applies only to the specified folder.


Working directory for local files: Overrides the specified folder’s working folder or working directory (optional). This is equivalent to setting an alternate working path for the folder.


Revision to operate on: Specifies the version to operate on (optional).  If blank, the tip version is used.  If Nnumber is entered, the specified revision number is used.  If Ddate/time is entered, it specifies the as-of date/time used to identify the revision. If Llabel is entered, it specifies the revision or view label to use.


Configure view: Configures the view (optional).  If blank, the current configuration is used. If Ddate/time is entered, the view is configured using the specified as-of date/time. If Llabel is entered, the view is configured using the specified label. If Pstate is entered, the view is configured using the specified promotion state.


Comment, description, or name: The comment, description, or name to apply to the command (optional).