.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:
The contents of the file data.txt in the step's working directory are put in register Alpha.
The contents of the file newdata.txt in the parent directory of the step's working directory are appended to register B.
Register ALPHA is cleared.
.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.