.push

.push [-p] [+]<register_name> [<relative_pathname> | -]

The .push command puts the contents of <relative_pathname> into register <register_name>. The current contents of <register_name> are replaced.

To append rather than replace, put a plus sign (+) in front of <register_name>.

To clear the register, use a hyphen in place of <relative_pathname>.

The optional -p parameter makes the command refer to a project register. Project registers are separate from ordinary registers, and project registers persist after a job ends.

The <relative_pathname> is relative to the project or tag path unless the Absolute property for the step is enabled.

The following examples assume that the Absolute property is not enabled for the step:

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