.pop

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

The .pop command writes the contents of a register to a file, to the step log, or to another 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.

The following examples show the variety of uses for a .pop command:

Note: Popping a register does not empty it. To change the contents of the register, push a new value into it using the .push command.
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