.push [-p] <register_name> <relative_pathname>
Push the contents of <relative_pathname> into register <register>. The register name may be prefixed with a "+" indicating that the contents of the file are to be appended to the register, and you can replace the <relative_pathname> with a hyphen to clear the register.
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.
Use uppercase to create register names and to reference all register types. Even though you can create registers using lowercase letters, registers are stored and must be referenced using uppercase letters.
The <relative_pathname> uses the project/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:
.push ALPHA data.txt - places the contents of the file data.txt (in the step's working directory) in register ALPHA.
.push +B ..\newdata.txt - appends the contents of the file newdata.txt (in the parent directory of the step's working directory) to register B.
.push ALPHA - clears register ALPHA.