.rget server:[<path>] [<path>]
The .rget command works similarly to the .get command, but copies
an entire directory tree, recursively. You must supply directory names
as the parameters. For example, the command
.rget winbuildserver1:config myconfig
copies the contents of the directory config on the server winbuildserver
into the myconfig directory on the current server.
Note: - If the target path does not exist, bfagent creates
a new directory and copies the source directory into the new directory.
- If the target path is not specified, bfagent copies
the source directory into the default location on the current server.
Note: - Do not use environment variables in this command.
- Do not use symbolic links in this command.
Because the Windows file path separator, the
backslash (\), is the same as the escape character used in
Rational® Build
Forge®, when parsing dotcommands,
it is difficult to determine when the command means "escape." Use
the following characters to distinguish between a Windows file path
separator and escape:
- To enable escape, enter /E.
- To disable escape, enter /e.
This example shows the .put command:
.put[/E|/e] [<relative_path>/]file
server:[[<relative_path>/]file]
If neither /E nor /e is specified, the system
uses the heuristics method to see if the dotcommand contains something
that looks like a Windows file path. If it detects a file path, escape
is disabled; otherwise, escape is enabled.