.rget

Edit online

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