.push [-p] [+]<register_name> [<relative_pathname> | -]
Put 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.