.run [-c "<condition>"] "<ProjectName>"
.runwait [-c "<condition>"] "<ProjectName>"
The .run and .runwait commands allow you to launch a chained project from a step command, providing a more flexible means of launching chains, including the evaluation of environment variables to determine whether a chain is launched.
.run "BuildWindowsDriver"
The system launches the BuildWindowsDriver project. The launching project continues with the next step immediately.
.runwait "BuildWindowsDriver"
The system launches the BuildWindowsDriver project. The system pauses the launching project at the .runwait step. When the BuildWindowsDriver project completes and passes, the .runwait step's status is set to pass.
.run -c "$HOMEDRIVE=C:" "Simple Echo"
The system runs the project Simple Echo if and only if the HOMEDRIVE variable has the value C:.
.run Condition: 'C:' = 'C:' satisfied. Queueing Project "Simple Echo" on server [WinBox]. Queued Build 'BUILD_202' of project 'Simple Echo'.
.run -c "$HOMEDRIVE=C:" "Simple Echo" .run Condition: 'D:' = 'C:' unsatisfied, no project queued.
.run Condition: '12' < '42' satisfied. Queueing Project "Simple Echo" on server [WinBox]. Waiting for .run build (4411) to complete. .run build is now running. .run build has finished. Build 'BUILD_203' of project 'Simple Echo' completed.
.run Condition: '43' <> '43' unsatisfied, no project queued.
Env .run encountered an error during variable expansion, parameter [`exit1`] expanded to []. Expansion returned non-zero exit, project will not be queued.
Expansion returned zero exit, project will be queued. Queueing Project "Simple Echo" on server [WinBox]. Queued Build 'BUILD_204' of project 'Simple Echo'.
Queueing Project "Fail Build" on server [WinBox]. Waiting for .run build (4413) to complete. .run build is now running. .run build has finished. Build 'BUILD_3' of project 'Fail Build' Failed, setting step status to fail.