<run> 元素在 <interface> 元素內用來
指定要執行的具名指令。稍後在相同的 XML 檔中定義此指令。<run> 元素是一
個空元素。
屬性:
- condition
- 選用,形式如下所示:condition="function"。function 的值是一個會求值為 true 或 false 的表示式。如果求值為 true,指令就會執行。如果求值為 false,就不會執行。請參閱條件函數。
- command
- (必要)。指定定義要執行之指令的名稱。指令是在 <command> 元素中命名和定義。
- dir
- (必要)。指定要在其中執行指令的目錄。dir 會解譯成指令執行所在之伺服器資源中所設定的路徑副檔名。
- mode
- 選用。指定 run 指令的執行模式。會使用 mode 屬性 exec,以觸發伺服器啟動並立即處理指令。
註: 在 Rational® Build
Forge® 8.0 中,僅支援預設 exec mode。
- params
- (必要)。指定要傳遞給指令的參數。請使用空格來區隔各參數。
- 伺服器 (server)
- (必要)。指定指令執行所在的伺服器資源。如果設為空值,則指令會在執行配接器之步驟所用的伺服器上執行。使用 server="",表示將伺服器設為空值。
- timeout
- (必要)。它指定在經過多少秒之後,指令即會逾時。
顯示所需屬性的範例:
<run command="UpdateEnv" params="" server="" dir="/" timeout="360"/>
範例:
<run command="p4_changes" params="$LAST_RUN $FILESPEC $LAST_VER"
server="$P4CLIENT" dir="/" timeout="360"/>