作業提交
提交指定的作業以在 HPC 叢集上執行。
如需如何使用此指令的範例,請參閱 範例。
語法
job submit /id:<jobID> [/password:<password>]
[/user:[<domain>\]<user_name>] [/scheduler:<name>]
[/holduntil:[{<DateTime>|<minutes>}]]
job submit /jobfile:<path>\<file_name> [/password:<password>]
[/user:[<domain>\]<user_name>] [/scheduler:<name>] [/holduntil:[{<DateTime>|<minutes>}]]
job submit [/askednodes:<node_list>] [/corespernode:<min>[-<max>]]
[/customproperties:<property_list>] [/emailaddress:<address>]
[/estimatedprocessmemory:<memory>)] [/env:<variable_and_value_list>]
[/exclusive[:{true|false}]]
[/faildependenttasks[:{true|false}]] [/failontaskfailure[:{true|false}]]
[/holduntil:[{<DateTime>|<minutes>]] [/jobenv:<variable_and_value_list>]
[/jobname:<job_name>] [/jobtemplate:<job_template_name>]
[/license:<license_list>] [/memorypernode:<min>[-<max>]]
[/name:<task_name>] [/nodegroup:<node_group_list>] [/nodegroupop:{Intersect|Uniform|Union}]
[/notifyoncompletion[:{true|false}]] [/notifyonstart[:{true|false}]]
{[/numcores:<min>[-<max>]] | [/numnodes:<min>[-<max>]] |
[/numprocessors:<min>[-<max>]] | [/numsockets:<min>[-<max>]]}
[/orderby:<primary>[,<secondary>]] [/parametric:<index_specification>]
[/parentjobids:<jobID_list>] [/password:<password>]
[/priority:<priority>] [/progress:<percent_progress>]
[/progressmsg:<message>] [/projectname:<name>] [/requestednodes:<node_list>]
[/rerunnable:[{true|false}]] [/runtime:{<time> | Infinite}]
[/rununtilcanceled[:{true|false}]] [/singlenode[:{true|false}]] [/stderr:[<path>\]<file_name>]
[/stdin:[<path>\]<file_name>] [/stdout:[<path>\]<file_name>]
[taskexecutionretrylimit:<retry_limit>
[/type:<type_name>] [/workdir:<folder>] [/password:<password>]
[/user:[<domain>\]<user_name>] [/scheduler:<name>] <command> [<arguments>]
[/validexitcodes:int|intStart..intEnd[,int|intStart..intEnd]*]
job submit {/? | /help}
參數
參數 | 描述 |
---|---|
/id:<jobID> | 指定您要提交之作業的作業標識碼。 使用此參數來提交已經存在且包含工作的作業。 您只能提交處於設定狀態的作業。 |
/jobfile:<路徑>\<file_name> | 指定作業 XML 檔案的檔案名和路徑,其中包含要用於您要提交之作業的設定。 使用此參數來建立具有作業 XML 檔案中設定的新作業,並立即提交。 |
/askednodes:<node_list> | 已取代。 請改用 /requestednodes 參數。 |
/corespernode:<分鐘>[-<max>] | 指定節點可讓 HPC 作業排程器服務將節點視為執行作業的候選節點,可選擇性地指定節點數目上限和數目上限。 作業不會在節點上執行,其核心數目會比此參數指定的最大值少,或核心數還多。 如果叢集中的所有節點都有數個核心超出您為此參數指定的範圍,當您提交作業時就會發生錯誤。 |
/customproperties:<property_list> | 以 <name1 =<value>1>[;<name2>=<value2>...] 的格式指定作業的自定義屬性。自定義屬性不區分大小寫,而且會反映第一次定義時所使用的案例。 此參數是在 HPC Pack 2012 中引進,舊版不支援。 |
/emailaddress:<位址> | 傳送此作業的通知至此位址。 此參數是在 HPC Pack 2012 中引進,舊版不支援。 |
/env:<variable_and_value_list> | 指定要在工作運行時間環境中設定的環境變數清單,以及要指派給這些環境變數的值。 清單的格式應該是 <variable_name1>=<value1> [;<variable_name2>=<value2>.]。 或者,您可以藉由包含多個 /env 參數來設定多個環境變數。 每個都必須是具有 <variable_name>=<值>格式的不同自變數。 若要取消設定環境變數,請勿指定值。 例如,<variable_to_unset_name>=。 |
/estimatedprocessmemory:<記憶體> | 此作業中每個進程估計耗用的記憶體數量上限,以 MB 為單位。 |
/exclusive[:{true|false}] | 指定 HPC 作業排程器服務是否應該確保此作業執行時,不會在與這個作業相同的節點上執行其他作業。 True 值表示 HPC 作業排程器服務應該確保此作業執行時,不會在相同的節點上執行其他作業。 False 值表示此作業可以與其他作業共用計算節點。 當您指定不含值的 /exclusive 參數時,作業送出 命令的行為就如同您指定 true 的值一樣。 如果您未指定 /exclusive 參數,作業送出 命令的行為就如同您指定了 False 值一樣。 |
/faildependenttasks[:{true|false}] | 指定如果工作失敗或取消,則所有相依工作都會失敗。 如果宣告 /faildependenttasks 但未指定任何值,則會假設為 True。 如果未宣告 /faildependenttasks,則會假設為 False。 此參數是在 HPC Pack 2012 中引進,舊版不支援。 |
/failontahpailure[:{true|false}] | 指定 HPC 作業排程器服務是否應該在作業失敗時立即停止作業,並立即失敗整個作業。 True 值表示 HPC 作業排程器服務應該停止作業,並在作業中的工作失敗時立即失敗整個作業。 False 值表示 HPC 作業排程器服務應該在作業中的任何工作失敗之後繼續執行作業中的其餘工作。 當您指定不含值的 /failontaailure 參數時,作業送出 命令的行為就像您指定了 True 的值一樣。 如果您未指定 /failonta 參數,則 作業送出 命令的行為就如同您指定了 False 值一樣。 |
/holduntil:[{<DateTime>|<分鐘>}] | 指定本機時間的日期和時間,或 HPC 作業排程器服務在嘗試啟動作業之前應該等候的分鐘數。 如果未設定此參數,作業可以在資源可用時啟動。 HPC 作業排程器服務只會在此參數指定的日期和時間執行作業,以指定作業所需的資源是否可用。 如果該日期和時間無法使用作業所需的資源,作業會維持佇列,直到必要的資源可供使用為止。 您可以使用 .NET Framework 可剖析目前作業系統文化特性的任何格式來指定日期和時間。 如需 .NET Framework 如何剖析日期和時間字串串的資訊,請參閱 剖析日期和時間字串。 只要作業未執行或完成,您就可以為作業指定 /holduntil 參數。 使用 /holduntil 指定的時間會在內部轉換為 UTC,而且不會反映當地日光節約時間。 如果使用分鐘值,它必須是整數。 套用作業修改 時,保留的分鐘數會轉換成 UTC。 如果 /holduntil 的值是空的,則會清除任何目前的 holduntil 值,而且作業不會再因為該參數而擱置中。 此參數是在 HPC Pack 2012 中引進,舊版不支援。 |
/jobenv:<variable_and_value_list> | 指定要在作業運行時間環境中設定的環境變數,以及您要設定這些環境變數的值。 清單的格式應該是 <variable_name1>=<value1> [;<variable_name2>=<value2>...]。 或者,您可以藉由包含多個 /jobenv 參數來設定多個環境變數,每個參數都有不同的自變數,格式 <variable_name>=<值>。 若要取消設定環境變數,請勿指定值。 例如,“<variable_to_unset_name>=”。 如果您為作業設定或取消設定環境變數,除非您使用 /env 參數來覆寫該工作的環境變數設定,否則該環境變數也會設定或取消設定作業中的每個工作。 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。 |
/jobname:<job_name> | 指定要在命令輸出和使用者介面中用於此作業的名稱。 作業名稱的最大長度為80個字元。 |
/jobtemplate:<job_template_name> | 指定要用於作業的作業範本名稱。 作業範本名稱的最大長度為80個字元。 根據預設,作業送出 命令會使用新作業的預設作業範本。 |
/license:<license_list> | 指定作業需要授權的功能清單,以及每個作業所需的授權數目。 使用 <license_name1>格式:<number1> [,<license_name2>:<number2>...] 此清單的 。
<number..> 可以是任何正整數,或 * 會要求與指派給作業的核心、套接字或節點相同的授權數目。 例如,/license1:10,license2:* 表示來自 license1 的 10 個授權,而來自 license2 的 N 授權則系結至與提交作業相關聯的核心、節點或套接字數目。 清單的長度上限為 160 個字元。 |
/memorypernode:<min>[-<max>] | 指定 HPC 作業排程器服務可以擁有的最小記憶體數量,以及選擇性地將節點視為執行作業的候選節點。 作業不會在記憶體小於最小值或記憶體大於此參數所指定最大值的節點上執行。 如果叢集中的所有節點都有超出您為此參數指定範圍的記憶體數量,當您提交作業時就會發生錯誤。 |
/name:<task_name> | 指定要在命令輸出和使用者介面中用於這項工作的名稱。 任務名稱的最大長度為80個字元。 |
/nodegroup:<node_group_list> | 指定此作業可以執行格式 <node_group1_name>為 [,<node_group2_name>...] 格式的節點群組清單。 HPC 作業排程器服務會根據預設,將資源從屬於清單中所有節點群組的節點配置給作業,或從群組清單中 /nodegroupop 參數作業所產生的節點配置資源。 如果您指定 /nodegroup 參數可確保有效節點清單中有節點。 不過,如果無法從節點清單中符合上述參數的作業資源需求,作業在作業提交期間將會失敗。 如果您為工作指定參數 /requestednodes,且作業 /nodegroups,如果要求的節點未與 /nodegroup 和 /nodegroupop 參數一起列出的節點,則作業會在提交期間失敗。 |
/nodegroupop:{Intersect|Uniform|Union} | 指定 /nodegroup 參數所指定清單的運算符。 有效值為: 交集 - 建立所有列出的節點群組中的節點清單。 統一 - 讓 HPC 作業排程器服務依序嘗試節點群組。 如果第一個節點群組內有足夠的資源,則會使用它們。 如果沒有,排程器會嘗試下列每個節點群組,直到找到具有足夠資源的節點群組為止。 如果找不到足夠的資源,作業會維持佇列。 聯集 - 建立任何節點群組中的節點清單。 此參數的預設值為 Intersect。 此參數是在 HPC Pack 2012 中引進,舊版不支援。 |
/notifyoncompletion[:{true|false}] | 指定 HPC 作業排程器服務何時應該在作業結束時傳送電子郵件通知。 True 值表示 HPC 作業排程器服務應該在作業結束時傳送電子郵件通知。 False 值表示 HPC 作業排程器服務不應該在作業結束時傳送電子郵件通知。 當作業的狀態變更為 [已完成]、[失敗] 或 [已取消] 時,就會傳送作業結束和通知。 叢集管理員必須先設定 HPC 叢集的通知,才能收到有關作業的通知。 當您指定不含值的 /notifyoncompletion 參數時,作業 new 命令的行為就如同您指定了 True 值一樣。 如果您未指定 /notifyoncompletion 參數,作業 new 命令的行為就如同您指定了 False 值一樣。 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。 |
/notifyonstart[:{true|false}] | 指定 HPC 作業排程器服務何時應該在作業啟動時傳送電子郵件通知。 True 值表示 HPC 作業排程器服務應該在作業啟動時傳送電子郵件通知。 False 值表示 HPC 作業排程器服務不應該在作業啟動時傳送電子郵件通知。 叢集管理員必須先設定 HPC 叢集的通知,才能收到有關作業的通知。 當您指定不含值的 /notifyonstart 參數時,作業 new 命令的行為就如同您指定了 True 值一樣。 如果您未指定 /notifyonstart 參數,此參數是在 HPC Pack 2008 R2 中引進,而且舊版不支援。 作業新 命令的行為就像您指定了 False 的值一樣。 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。 |
/numcores:<min>[-<max>] | 指定作業在 HPC 叢集上所需的核心總數,<最低>[-<最大>]。 作業至少會在核心數目下限上執行,且不超過最大值。 如果您只指定一個值,此命令會將核心數目上限和最小值設定為該值。 如果您指定的最小值超過整個叢集可用的核心總數,當您提交作業時就會發生錯誤。 最小值和最大值只能是正整數或星號 。。 如果您將最小值或最大值指定為星號,HPC 作業排程器服務會根據作業中工作的最小和最大核心數目,自動計算運行時間的核心數目下限或上限。 如果您也指定 /numnodes、/numprocessors或 /numsockets 參數,則您無法指定 /numcores 參數。 |
/numnodes:<min>[-<max>] | 指定作業在 HPC 叢集上所需的節點總數,<最低>[-<最大>]。 作業至少會在節點數目下限上執行,且不超過最大值。 如果您只指定一個值,此命令會將節點數目上限和最小值設定為該值。 如果您指定超過叢集可用節點總數的最小值,當您提交作業時就會發生錯誤。 最小值和最大值只能是正整數或星號 。。 如果您將最小值或最大值指定為星號,HPC 作業排程器服務會根據作業中工作的節點數目下限和上限,自動計算運行時間的最小或最大節點數目。 如果您也指定 /numcores、/numprocessors或 /numsockets 參數,則您無法指定 /numnodes 參數。 |
/numprocessors:<min>[-<max>] | 已取代。 請改用 /numcores 參數。 |
/numsockets:<min>[-<max>] | 指定作業在 HPC 叢集上所需的套接字總數,<最低>[-<最大>]。 作業至少會在套接字數目下限上執行,且不超過最大值。 如果您只指定一個值,此命令會將套接字的最大值和最小值設定為該值。 如果您指定的最小值超過整個叢集可用的套接字總數,當您提交作業時就會發生錯誤。 最小值和最大值只能是正整數或星號 。。 如果您將最小值或最大值指定為星號,HPC 作業排程器服務會根據作業中工作的套接字數目下限和上限,自動計算運行時間的套接字數目下限或上限。 如果您同時 指定 /numcores、/numprocessors或 /numnodes 參數,則您無法指定 /numsockets 參數。 |
/orderby:<主要>[,<次要>] | 指定 HPC 作業排程器服務應該使用 的順序,以 <primary_order>[,<secondary_order>] 格式將節點設定給作業。 值的primary_order和secondary_order部分可以是下列其中一個值: memory - HPC 作業排程器服務會依可用的記憶體數量來排序節點,並先將作業配置給具有更多記憶體的節點。 -memory - HPC 作業排程器服務會依可用的記憶體數量來排序節點,並先將作業配置給記憶體較少的節點。 核心 - HPC 作業排程器服務會依可用的核心數目來排序節點,並先將作業配置給具有更多核心的節點。 -cores - HPC 作業排程器服務會依可用的核心數目來排序節點,並先將作業配置給具有較少核心的節點。 當您指定次要順序時,HPC 作業排程器服務會先根據主要順序排序節點。 對於具有相同主要順序所指定資源數量的節點子集,HPC 作業排程器服務接著會使用次要排序順序來排序子集內的節點。 例如,如果您指定記憶體、核心,HPC 作業排程器服務會將節點從最高記憶體數量排序為最低。 然後,針對具有相同記憶體數量的節點子集,HPC 作業排程器服務會使用核心數目來中斷系結,並將具有相同記憶體數量的節點從最少的核心數目排序為最多。 主要順序和次要順序必須參考不同類型的資源。 例如,記憶體、核心是主要和次要排序順序的有效組合。 記憶體、記憶體和 -cores、-cores 等組合無效。 HPC 作業排程器服務用來將節點配置給作業的預設順序是核心、記憶體。 |
/parametric:<index_specification> | 指出新工作是參數式工作。 參數工作會多次執行指定的命令,並取代命令列中任何星號的目前索引值 。 在 /stdin、/stdout和 /stderr 參數中指定時,也會取代星號。 此參數的索引規格會定義索引值的行為。 索引規格的格式為 [<start>-]<end>[:<increment>]。 目前的索引值會從起始索引開始,並在命令執行的每個後續時間增加遞增值。 當目前的索引超過結束索引時,工作會停止執行 命令。 起始索引必須小於結束索引,而遞增值必須是正整數。 |
/parentjobids:<jobID_list> | 指定作業將以 <jobID1>[,<jobID2>...] 的格式指定作業識別子清單。 作業標識碼必須已經存在。 HPC 作業排程器服務只有在其父工作已完成且全都處於已完成狀態時,才會排程作業。 如果任何父作業尚未完成或已完成,但處於已取消或失敗狀態,作業會維持佇列。 此參數是在 HPC Pack 2012 中引進,舊版不支援。 |
/password:<密碼> | 指定作業應該在其中執行之帳戶的密碼。 如果您指定 /user 參數,但未指定 /password 參數,則 作業提交 命令會提示您輸入密碼,以及是否儲存密碼。 |
/priority:<優先順序> | 指定排程作業的優先順序。 針對 Windows HPC Server 2008,優先順序值只能是下列其中一個具名值:Highest、AboveNormal、Normal、BelowNormal 或 Lowest。 針對 Windows HPC Server 2008 R2,您可以使用您可以在 Windows HPC Server 2008 中使用的五個具名優先順序值中的任何一個。 您也可以使用介於 0 到 4000 之間的任何數位, 最高- 4000 AboveNormal - 3000 一般 - 2000 BelowNormal - 1000 最低 - 0 作業所使用的作業範本會指定影響誰可以指定提高優先順序的許可權。 HPC 作業排程器服務會依照使用者提交作業的順序,將具有相同優先權的工作放入作業佇列中,除非使用者重新排入作業佇列。 如果使用者重新排入工作佇列,HPC 作業排程器服務會將該作業放在具有相同優先權的作業中。 作業的預設優先順序為 Normal 或 2000。 |
/progress:<percent_progress> | 指定完成之作業的百分比。 此值必須介於 0 和 100之間。 如果您未設定這個屬性的值,HPC 作業排程器服務會根據作業完成的工作百分比計算進度。 當您為作業設定這個屬性時,HPC 作業排程器服務不會繼續更新此屬性,因此您必須使用 作業修改 命令繼續更新屬性。 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。 |
/progressmsg:<訊息> | 指定您要針對作業顯示的自訂狀態訊息。 此字串的最大長度為80個字元。 若要指定包含空格的狀態消息,請以引弧括住狀態消息()。 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。 |
/projectname:<名稱> | 指定可用於追蹤作業之作業的項目名稱。 項目名稱的最大長度為80個字元。 |
/requestednodes:<node_list> | 指定作業可執行之節點的名稱清單,格式為 <node1_name>[,<node2_name>...]。 這些節點是作業的候選專案,但如果這些節點上的可用資源超過作業所需的資源,則並非所有節點都會執行作業。 HPC 作業排程器服務會根據 /orderby 參數的值來配置頂端節點,直到配置節點符合您使用 /numcores、/numsockets、/numprocessors或 /numnodes 參數所指定的值為止。 如果您未指定 /requestednodes 參數,HPC 作業排程器服務會將所有節點視為 HPC 作業排程器服務可配置給作業的候選專案。 如果您為 /requestednodes 和 /nodegroups 參數指定值,則作業只會在 /requestednodes 參數的節點清單中執行,而該節點也屬於以 /nodegroupgroup 和 /nodegroupop 参數定義的節點列表。 |
/rerunnable[:{true|false}] | 指定如果工作執行且失敗,HPC 作業排程器服務是否嘗試重新執行工作。 True 值表示如果工作已先佔,或因為叢集問題而失敗,HPC 作業排程器服務可能會嘗試重新執行工作,例如無法連線到節點。 作業排程器不會嘗試重新執行執行以完成的工作,並傳回失敗結束代碼的 。 False 值表示如果工作開始,但因先占或叢集問題而未完成,HPC 作業排程器服務不應該嘗試重新執行工作。 相反地,它應該會立即將工作移至失敗的狀態。 叢集管理員可以設定 HPC 作業排程器服務在將工作移至失敗狀態之前,嘗試重新執行可重新執行的工作的次數。 如果您未指定 /rerunnable 參數,命令的行為就如同您指定了 True 的值一樣。 |
/runtime:{<time> |Infinite} | 指定作業應該執行的時間上限。 在作業執行此時間之後,HPC 作業排程器服務會取消作業。 您可以使用 [[<天>:]<小時>:]<分鐘>格式指定時間量。 您也可以指定 Infinite,指出作業可以無限時間執行。 如果您只指定 [[<天>:]<小時>:]<分鐘> 格式,命令會將指定的值解譯為分鐘數。 例如,12 表示 12 分鐘。 如果您指定格式的兩個部分,命令會將左邊部分解譯為小時,並將右邊部分解譯為分鐘數。 例如,10:30 表示 10 小時 30 分鐘。 您可以針對格式的每個部分使用一或多個數位。 每個元件的最大值為 2,147,483,647。 如果您未指定 /runtime 參數,預設值為 Infinite。 |
/rununtilcanceled[:{true|false}] | 指定作業是否繼續執行並保留資源,直到運行時間限制到期或有人取消作業為止。 True 值表示作業會繼續執行並保留資源,直到運行時間限制到期或有人取消作業為止。 如果您指定 True 的值,則必須指定 /numcores、/numnodes或 /numsockets 參數,或提交作業時發生錯誤。 False 值表示當作業中的所有工作都完成時,作業應該停止並釋放其資源。 當您指定不含值的 /rununtilcanceled 參數時,作業送出 命令的行為就如同您指定了 True 的值一樣。 如果您未指定 /rununtilcanceled 參數,則 作業送出 命令的行為就像您指定了 False 值一樣。 |
/scheduler:<名稱> | 針對您要提交工作的叢集,指定前端節點的主機名或IP位址。 此值必須是有效的計算機名稱或IP位址。 如果您未指定 /scheduler 參數,此命令會使用CCP_SCHEDULER環境變數所指定前端節點上的排程器。 |
/singlenode[:{true|false}] | 指定所有資源都會配置在一個節點上。 如果宣告 /singlenode 但未指定任何值,則會假設為 True。 如果未宣告 /singlenode,則會假設 False。 此參數是在 HPC Pack 2012 中引進,舊版不支援。 |
/stderr:[<路徑>\]<file_name> | 指定工作應該重新導向標準錯誤數據流的檔名,包括完整路徑或相對於檔案工作目錄的路徑,如果工作不應該將標準錯誤數據流重新導向至工作目錄中的檔案。 如果您指定不存在的路徑,工作就會失敗。 如果您未指定 /stderr 參數 此參數的最大長度為160個字元。 |
/stdin:[<路徑>\]<file_name> | 指定工作應該接收標準輸入的檔名,包括工作不應該從工作目錄中的檔案接收標準輸入時,相對於檔案工作目錄的完整路徑或路徑。 如果您指定不存在的檔案或路徑,工作就會失敗。 此參數的最大長度為160個字元。 |
/stdout:[<路徑>\]<file_name> | 指定工作應該重新導向標準輸出的檔名,包括當工作不應該將標準輸出重新導向至工作目錄中的工作目錄時,相對於檔案的完整路徑或路徑。 如果您指定不存在的路徑,工作就會失敗。 如果您未指定 /stdout 參數 此參數的最大長度為160個字元。 |
/taskexecutionfailureretrylimit:<retry_limit> | 指定此作業中工作在發生應用程式執行失敗之後,將會自動重新排入佇列的節點準備或節點發行工作以外的工作次數上限。 此參數是在 HPC Pack 2012 R2 Update 1 中引進的。 在舊版中無法使用。 |
/type:<type_name> | 指定工作的型別,這個類型會定義如何執行工作的命令。 以下是您可以指定的類型: 基本- 執行序列應用程式或訊息傳遞介面 (MPI) 應用程式的單一實例。 MPI 應用程式通常會在多個核心上同時執行,而且可以跨越多個節點。 NodePrep - 在配置給作業的每個計算節點上執行命令或腳本。 節點準備工作會在作業的任何其他工作之前,於節點上執行。 如果節點準備工作無法在節點上執行,該節點就不會新增至作業。 NodeRelease - 在從作業釋出時,在每個計算節點上執行命令或腳本。 節點發行工作會在使用者取消作業或正常先占時執行。 當作業立即先佔取消時,節點發行工作不會執行。 ParametricSweep - 取消命令的指定次數,如 Start、End 和 Increment 值所指示,通常跨索引的輸入和輸出檔案。 掃掠的步驟可能會或可能不會平行執行,視工作執行時 HPC 叢集上可用的資源而定。 當您指定 ParametricSweep 類型時,應該使用 /parametric 參數來指定索引的開始、結束和遞增值。 如果您未使用 /parametric 參數,命令會執行一次,索引為 0。 服務- 在指派給作業的所有資源上執行命令或服務。 當新的資源新增至作業時,命令的新實例就會啟動,或者如果先前執行中的實例結束時結束,且先前執行中實例所使用的資源仍會配置給作業。 服務工作會繼續啟動新的實例,直到取消工作、運行時間上限過期,或達到實例數目上限為止。 服務工作最多可以建立1,000,000個子工作。 您透過服務導向架構 (SOA) 用戶端提交的工作會以服務工作的形式執行。 您無法將基本工作或參數掃掠工作新增至包含服務工作的作業。 除非您也指定 /參數 參數,否則此參數的預設值為 Basic。 如果您指定 /parametric 參數,/type 參數的預設值為 ParametricSweep。 如果您使用 ParametricSweep 以外的值來指定 /type 參數,則也無法指定 /parametric 參數。 此參數是在 HPC Pack 2008 R2 中引進,舊版不支援。 |
/workdir:<資料夾> | 指定工作應該執行的工作目錄。 此參數的最大長度為160個字元。 |
<命令> [<参數>] | 指定工作的命令行,包括命令或應用程式名稱和任何必要的參數。 除非在 /taskfile 工作 XML 檔案中定義,否則必須有命令才能新增工作。 除非命令包含完整路徑,否則此命令將會相對於工作目錄執行。 |
/user:[<網域>\]<user_name>] | 指定使用者名稱,並選擇性地指定作業應該執行所在的帳戶網域。 如果您未指定此參數,作業會在用來提交作業的帳戶下執行。 |
/validexitcodes:{int|intStart..intEnd} [,{int|intStart..intEnd}]* | 指定要用來檢查作業中工作是否順利結束的結束代碼。
/validexitcodes 必須由以逗號分隔的離散整數和整數範圍指定。 min 或 max 可用來作為整數範圍的開頭或結尾。 例如, 0..max 代表所有非負整數。宣告工作特定的 /validexitcodes 如果未定義 /validexitcodes,則 0 是預設有效的結束代碼。 |
/? | 在命令提示字元中顯示說明。 |
/help | 在命令提示字元中顯示說明。 |
備註
作業提交 命令有三個主要形式。 /password、/user和 /scheduler 參數都適用於所有三種形式。
命令的第一種形式也包含 /id 參數,並提交具有指定工作標識碼的現有作業。
命令的第二種形式除了一般參數之外,還包含 /jobfile 參數。 此窗體會建立具有作業檔案所指定之設定和工作的新作業,並立即提交該作業。
命令的第三種形式包含其餘參數,但命令提示字元中顯示說明訊息的參數除外。 這個形式的命令會建立具有單一工作來執行指定命令的新作業,然後提交該作業。
提交作業之後,HPC 作業排程器服務會驗證作業,並在作業佇列中輸入作業。 HPC 作業排程器服務會等候啟動作業,直到有足夠的資源可用為止。
從 Windows HPC Server 2008 R2 開始,您可以指定參數工作的命令行中的星號 • 不應取代為參數索引的目前值,方法是在星號前面加上三個插入號 (^) 字元。 例如,如果您使用 作業送出 命令來提交具有一個參數工作的工作,並將命令行指定為 echo *,工作會列印參數索引的值。 如果您改為使用 作業 add 命令來建立參數工作,並將命令行指定為 echo ^^^*,工作會針對參數索引的每個值列印星號。
範例
若要提交作業識別碼為 38,請使用下列命令:
job submit 38
若要使用檔案中的設定在 C:\Jobs\MyJob.xml 建立新的作業,然後立即提交作業,請使用下列命令:
job submit /jobfile:C:\Jobs\MyJob.xml
若要建立並提交具有基本作業類型的新單一工作作業,它會在作業啟動時傳送電子郵件通知,且狀態消息為「已送出」,並執行 vol 命令,請使用下列命令:
job submit /notifyonstart:true /progressmsg:"Submitted" /type:Basic vol
若要建立新的作業,請將工作新增至作業,然後提交作業,請執行包含下列命令的批處理檔,它會使用 for 命令來取得新作業的標識碼:
for /f "usebackq tokens=4 delims=. " %%i in (`job new`) do (
job add %%i echo Hello World
job submit /id:%%i
)