.rput
.rput [<relative_path>] server:[<relative_path>]The .rput command works similarly to the .put command, but copies
an entire directory tree, recursively. The relative paths you supply
must be directories, not files. For example, the command
.rput myconfig linuxserver5:feb2005Note: If the target path does not exist, bfagent creates
a new directory and copies the source directory into the new directory.
The source path is relative to the working directory of the step, so it includes or does not include the project and tag directories based on the value of the step's Absolute property. The destination path is relative only to the Path property of the destination server. For more information about how the system constructs paths, see Working directories for jobs.
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.
.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.