.put

.put [<relative_path>/]file server:[[<relative_path>/]file]

Use the .put command to transfer a file from one logical server to another. The .put operation runs from the current server path and sends the specified file to the remote server. The destination path name is relative to the target server's base path. The source path name is relative to the step's current working directory. The remote server must specify a logical server that allows the .put operation for files. For information, see Enabling file copying on a server resource. Only single files can be transferred.

The path specification can include environment variables. This capability allows you to specify files relative to the path used by a specific job. See the description of paths used by jobs in Working directories for jobs.

Note: Be sure that the path you use exists before doing the file transfer.

If the server name you are using has spaces in it, put the name in quotes.

The transfer is not fast, so you might want to choose a different method to transfer large files. Expect speeds of no more than 40 KB per second; a 70 MB file can take 45 minutes to an hour to transfer.

Note: If the destination file already exists, it is overwritten without warning.
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: 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.


Feedback