Отправка задания
Отправляет указанное задание для запуска в кластере 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>=<value1>[;<name2>=<value2>...]. Пользовательские свойства являются нечувствительными к регистру и отражают регистр, используемый при первом определении. Этот параметр может использоваться только с одним заданием задачи, в противном случае свойства не будут видимыми. Если требуются несколько задач, используйте этот параметр в операции "задание нового". Этот параметр появился в пакете HPC 2012 и не поддерживается в предыдущих версиях. |
| /emailaddress:<адрес> | Отправляет уведомления для этого задания в этот адрес. Этот параметр появился в пакете HPC 2012 и не поддерживается в предыдущих версиях. |
| /env:<variable_and_value_list> | Указывает список переменных среды, которые необходимо задать в среде выполнения задачи, а также значения, назначенные этим переменным среды. Список должен иметь формат <variable_name1>= значение<значение1> [;<variable_name2>= значение<значение2>.]. Кроме того, можно задать несколько переменных среды, включив несколько /env параметров. Каждый аргумент должен быть разным с форматом <variable_name>=<значение>. Чтобы отменить настройку переменной среды, не указывайте значение. Например, <variable_to_unset_name>=. |
| /estimatedprocessmemory:<память> | Максимальный объем памяти в мегабайтах (МБ), который каждый процесс в этом задании, по оценкам, будет использоваться. |
| /exclusive[:{true|false}] | Указывает, должна ли служба планировщика заданий HPC гарантировать, что ни одно другое задание не выполняется на том же узле, что и при выполнении этого задания. Значение True указывает, что служба планировщика заданий HPC должна гарантировать, что ни одно другое задание не выполняется на том же узле во время выполнения этого задания. Значение False указывает, что это задание может совместно использовать вычислительные узлы с другими заданиями. При указании параметра /exclusive без значения задание отправки ведет себя так, как если бы вы указали значение true. Если параметр /exclusive не указан, задание отправки ведет себя так, как если бы вы указали значение False. |
| /faildependenttasks[:{true|false}] | Указывает, что если задача завершается ошибкой или отменена, все зависимые задачи завершаются ошибкой. Если /faildependenttasks объявлен, но значение не задано, предполагается значение True. Если /faildependenttasks не объявлены, предполагается значение False. Этот параметр появился в пакете HPC 2012 и не поддерживается в предыдущих версиях. |
| /failontaskfailure[:{true|false}] | Указывает, должна ли служба планировщика заданий HPC остановить задание и завершиться сбоем всего задания сразу после сбоя задачи в задании. Значение True указывает, что служба планировщика заданий HPC должна остановить задание и завершить работу сразу после сбоя задачи в задании. Значение False указывает, что служба планировщика заданий HPC должна продолжать выполнять остальные задачи в задании после сбоя любой задачи в задании. При указании параметра /failontaskfailure без значения задание отправки ведет себя так, как если бы вы указали значение True. Если параметр /failontaskfailure не указан, задание отправки ведет себя так, как если бы вы указали значение False. |
| /holduntil:[{<DateTime>|<минут>}] | Указывает дату и время в локальном времени или количество минут, до которого служба планировщика заданий HPC должна ждать, прежде чем пытаться запустить задание. Если этот параметр не задан, задание может запускаться при наличии ресурсов. Служба планировщика заданий HPC выполняет задание только по дате и времени, когда этот параметр указывает, доступны ли ресурсы, необходимые для задания. Если ресурсы, необходимые для задания, недоступны на этой дате и времени, задание остается в очереди до тех пор, пока необходимые ресурсы не станут доступными. Можно указать дату и время в любом формате, который платформа .NET Framework может анализировать для текущего языка и региональных параметров операционной системы. Сведения о том, как платформа .NET Framework анализирует строки даты и времени, см. в Можно указать параметр /holduntil для задания до тех пор, пока задание не выполняется или не завершено. Время, указанное с помощью /holduntil, преобразуется внутри в формате UTC и не будет отражать локальное время летней экономии. Если используется значение минут, оно должно быть целым числом. Минуты хранения преобразуются в формате UTC во время применения изменения задания. Если значение для /holduntil пусто, то любое текущее значение удержания удаляется и задание больше не ожидается из-за этого параметра. Этот параметр появился в пакете HPC 2012 и не поддерживается в предыдущих версиях. |
| /jobenv:<variable_and_value_list> | Указывает переменные среды, которые необходимо задать в среде выполнения задания, и значения, для которых необходимо задать эти переменные среды. Список должен иметь формат <variable_name1>=<значение1> [;<variable_name2>= значение<значение2>...]. Кроме того, можно задать несколько переменных среды, включив несколько параметров /jobenv, каждый из которых имеет другой аргумент с форматом <variable_name>=<значение>. Чтобы отменить настройку переменной среды, не указывайте значение. Например, "<variable_to_unset_name>=". Если для задания задана или не настроена переменная среды, эта переменная среды также устанавливается или не настроена для каждой задачи в задании, если не переопределить этот параметр переменной среды для задачи, указав новый параметр с параметром /env. Этот параметр появился в пакете HPC 2008 R2 и не поддерживается в предыдущих версиях. |
| /jobname:<job_name> | Задает имя, используемое для этого задания в выходных данных команд и в пользовательском интерфейсе. Максимальная длина имени задания составляет 80 символов. |
| /jobtemplate:<job_template_name> | Указывает имя шаблона задания, используемого для задания. Максимальная длина имени шаблона задания составляет 80 символов. По умолчанию задание отправки использует шаблон задания по умолчанию для нового задания. |
| /license:<license_list> | Указывает список функций, для которых для задания требуются лицензии, и количество лицензий, необходимых для каждого. Используйте формат <license_name1>:<число1> [,<license_name2>:<число2>...] для этого списка.
<число..> может быть любым положительным целым числом или * , который запрашивает то же количество лицензий, что и ядра, сокеты или узлы, назначенные заданию. Например, /license1:10,license2:* означает 10 лицензий из лицензии1 и N из лицензии2, где N привязано к числу ядер, узлов или сокетов, связанных с отправленным заданием. Список имеет максимальную длину 160 символов. |
| /memorypernode:<min>[-<max>] | Указывает минимальный и, при необходимости, максимальный объем памяти в мегабайтах (МБ), который узел может иметь для службы планировщика заданий HPC, чтобы рассматривать узел в качестве кандидата узла, на котором выполняется задание. Задание не будет выполняться на узле, который имеет меньше памяти, чем минимальное или больше памяти, чем максимальное значение, указанное этим параметром. Если все узлы в кластере имеют объем памяти, который выходит за пределы диапазона, указанного для этого параметра, при отправке задания возникает ошибка. |
| /name:<task_name> | Задает имя, используемое для этой задачи в выходных данных команд и в пользовательском интерфейсе. Максимальная длина имени задачи составляет 80 символов. |
| /nodegroup:<node_group_list> | Указывает список групп узлов, в которых это задание может выполняться в формате <node_group1_name>[,<node_group2_name>...]. Служба планировщика заданий HPC выделяет ресурсы заданию из узлов, принадлежащих ко всем группам узлов в списке по умолчанию, или узлам, вызванным операцией параметра /nodegroupop, если указано, в списке групп. Если указать значения /nodegroups и параметры /requestednodes, задание выполняется только на узлах в списке узлов для параметра /requestednodes, который также принадлежит списку узлов, определенных /nodegroup и /nodegroupop. Параметр /nodegroup гарантирует наличие узлов в допустимом списке узлов. Однако если требования к ресурсам задания из приведенного выше параметра не могут выполняться из списка узлов, задание завершится ошибкой во время отправки задания. Если указать параметр /запрошенные для задачи и /nodegroups для задания, задание завершится ошибкой во время отправки, если запрошенные узлы не находятся в узлах, перечисленных в сочетании с /nodegroup и параметрами /nodegroupop. |
| /nodegroupop:{Intersect|Униформа|Union} | Указывает оператор списка, указанного параметром /nodegroup. Допустимые значения: Intersect — создает список узлов, которые находятся во всех перечисленных группах узлов. Единообразие — приводит к тому, что служба планировщика заданий HPC пытается попробовать группы узлов по порядку. Если в первой группе узлов достаточно ресурсов, они используются. Если нет, планировщик пытается выполнить каждую следующую группу узлов, пока не будет найдена одна с достаточным количеством ресурсов. Если недостаточно ресурсов, задание остается в очереди. Объединение — создает список узлов, которые находятся в любой из групп узлов. Значение по умолчанию для этого параметра — Intersect. Этот параметр появился в пакете HPC 2012 и не поддерживается в предыдущих версиях. |
| /notifyoncompletion[:{true|false}] | Указывает, должна ли служба планировщика заданий HPC отправлять уведомление по электронной почте при завершении задания. Значение True указывает, что служба планировщика заданий HPC должна отправлять уведомление по электронной почте после завершения задания. Значение False указывает, что служба планировщика заданий HPC не должна отправлять уведомления по электронной почте после завершения задания. Задание заканчивается и отправляется уведомление, когда состояние задания изменяется на Finished, Failed или Canceled. Администратор кластера должен настроить уведомление для кластера HPC, прежде чем получать уведомления о задании. При указании параметра Этот параметр появился в пакете HPC 2008 R2 и не поддерживается в предыдущих версиях. |
| /notifyonstart[:{true|false}] | Указывает, должна ли служба планировщика заданий HPC отправлять уведомление по электронной почте при запуске задания. Значение True указывает, что служба планировщика заданий HPC должна отправлять уведомление по электронной почте при запуске задания. Значение False указывает, что служба планировщика заданий HPC не должна отправлять уведомления по электронной почте при запуске задания. Администратор кластера должен настроить уведомление для кластера HPC, прежде чем получать уведомления о задании. При указании параметра /notifyonstart без значения задание новой команды ведет себя так, как если бы вы указали значение True. Если параметр /notifyonstart не указан, этот параметр появился в пакете HPC 2008 R2 и не поддерживается в предыдущих версиях. задание новой команды ведет себя так, как если бы вы указали значение False. Этот параметр появился в пакете HPC 2008 R2 и не поддерживается в предыдущих версиях. |
| /numcores:<мин>[-<max>] | Указывает общее количество ядер в кластере HPC, которое требуется заданию в формате <минимальное>[-<максимальное>]. Задание выполняется по крайней мере минимальное число ядер и не превышает максимальное. Если указать только одно значение, эта команда задает максимальное и минимальное количество ядер для этого значения. Если указать минимальное значение, превышающее общее количество ядер, доступных в кластере, при отправке задания возникает ошибка. Минимальное и максимальное значения могут быть только положительными целыми числами или звездочкой (*). Если указать минимальное или максимальное значение в виде звездочки, служба планировщика заданий HPC автоматически вычисляет минимальное или максимальное число ядер во время выполнения на основе минимального и максимального числа ядер для задач в задании. Невозможно указать параметр /numcores, если также указать параметр /numnodes, /numprocessorsили /numsockets. |
| /numnodes:<мин>[-<max>] | Указывает общее количество узлов в кластере HPC, которое требуется заданием в формате <минимальное>[-<максимальное>]. Задание выполняется по крайней мере минимальное количество узлов и не превышает максимальное. Если указать только одно значение, эта команда задает максимальное и минимальное количество узлов для этого значения. Если указать минимальное значение, превышающее общее количество узлов, доступных в кластере, при отправке задания возникает ошибка. Минимальное и максимальное значения могут быть только положительными целыми числами или звездочкой (*). Если указать минимальное или максимальное значение в виде звездочки, служба планировщика заданий HPC автоматически вычисляет минимальное или максимальное количество узлов во время выполнения на основе минимального и максимального количества узлов для задач в задании. Невозможно указать параметр /numnodes, если также указать параметр /numcores, /numprocessorsили /numsockets. |
| /numprocessors:<мин>[-<max>] | Устарело. Вместо этого используйте параметр /numcores. |
| /numsockets:<мин>[-<max>] | Указывает общее количество сокетов в кластере HPC, которое требуется заданием в формате <минимальное>[-<максимальное>]. Задание выполняется по крайней мере минимальное количество сокетов и не более максимального значения. Если указать только одно значение, эта команда задает максимальное и минимальное количество сокетов для этого значения. Если указать минимальное значение, превышающее общее количество сокетов, доступных в кластере, при отправке задания возникает ошибка. Минимальное и максимальное значения могут быть только положительными целыми числами или звездочкой (*). Если указать минимальное или максимальное значение в виде звездочки, служба планировщика заданий HPC автоматически вычисляет минимальное или максимальное количество сокетов во время выполнения на основе минимального и максимального числа сокетов для задач в задании. Невозможно указать параметр /numsockets, если также указать параметр /numcores, /numprocessorsили /numnodes параметр. |
| /orderby:<первичный>[,<вторичный>] | Указывает порядок, который служба планировщика заданий HPC должна использовать для выделения узлов заданий заданий и задач в задании. Primary_order и secondary_order части значения могут быть одним из следующих значений: память . Служба планировщика заданий HPC сортирует узлы по объему доступной памяти и выделяет задание узлам с большим объемом памяти. -memory — служба планировщика заданий HPC сортирует узлы по объему доступной памяти и выделяет задание узлам с меньшей памятью. ядра — служба планировщика заданий HPC сортирует узлы по количеству доступных ядер и выделяет задание узлам с большим количеством ядер. -cores — служба планировщика заданий HPC сортирует узлы по количеству доступных ядер и выделяет задание узлам с меньшим количеством ядер. #0~#63 — служба планировщика заданий HPC сортирует узлы с помощью пользовательского сортировщика узлов. Эта функция появилась в пакете HPC 2016 с обновлением 3 и не поддерживается в предыдущих версиях. Сведения о реализации пользовательского сортировщика узлов см. в статье Новые возможности пакета HPC 2016 с обновлением 3. При указании дополнительного заказа служба планировщика заданий HPC сначала сортирует узлы в соответствии с основным порядком. Для подмножества узлов, имеющих тот же объем ресурса, что и основной порядок, служба планировщика заданий HPC затем сортирует узлы в подмножестве с помощью дополнительного порядка сортировки. Например, если указать память,-cores, служба планировщика заданий HPC сортирует узлы от максимального объема памяти до наименьшего. Затем для подмножества узлов, имеющих одинаковый объем памяти, служба планировщика заданий HPC использует количество ядер для разрыва связи и сортирует узлы с одинаковым объемом памяти с наименьшим количеством ядер до самого большого количества. Основной порядок и вторичный порядок должны ссылаться на различные типы ресурсов. Например, память, ядра — это допустимое сочетание первичных и вторичных заказов сортировки. Такие сочетания, как память, память и -cores, недопустимы. Порядок по умолчанию, используемый службой планировщика заданий HPC для выделения узлов задания Set-HpcClusterProperty -SchedulerEnvFeatureFlags 'JOB_PACKING_ON_NODE'. Затем перезапустите службу HpcScheduler на всех головных узлах.В пакете HPC 2019 с обновлением 1 и более ранних выпусках порядок выделения узлов служба планировщика заданий HPC для задач всегда определяется порядком именования, определенным методом String.CompareTo. В пакете HPC 2019 с обновлением 2 порядок, который служба планировщика заданий HPC использует для выделения узлов задач, наследуется от задания для повышения эффективности задач с одним узлом. Если для задания нет /orderby свойств, порядок по умолчанию, выделенный узлам для задач, готов к ядрам, памяти, а затем порядок именования, определенный методом String.CompareTo.В пакете HPC 2019 с обновлением 3 порядок, который служба планировщика заданий HPC использует для выделения узлов для задач Set-HpcClusterProperty -SchedulerEnvFeatureFlags TASK_SPREADING_ON_NODE' или Set-HpcClusterProperty -SchedulerEnvFeatureFlags 'TASK_ON_SINGLE_NODE'. Затем перезапустите службу HpcScheduler на всех головных узлах. |
| /parametric:<index_specification> | Указывает, что новая задача является параметрической задачей. Задача параметрики выполняет указанную команду несколько раз, заменив текущее значение индекса для всех звездочек (*) в командной строке. Звездочка также заменяется при указании в параметрах /stdin, /stdoutи /stderr. Спецификация индекса для этого параметра определяет поведение значения индекса. Формат спецификации индекса — [<запуска>-]<конца>[:<добавочного>]. Текущее значение индекса начинается с начального индекса и увеличивается на добавочное значение при каждом последующем выполнении команды. Когда текущий индекс превышает конечный индекс, задача перестает выполнять команду. Начальный индекс должен быть меньше конечного индекса, а добавочное значение должно быть положительным целым числом. |
| /parentjobids: <jobID_list> | Указывает список идентификаторов заданий, от которые задание будет зависеть в формате <jobID1>[,<jobID2>...]. Идентификаторы заданий уже должны существовать. Служба планировщика заданий HPC запланирует задание только в том случае, если его родительские задания завершены и находятся в состоянии завершения. Если родительское задание не завершено или завершено, но находится в состоянии "Отмена" или "Сбой", задание остается в очереди. Этот параметр появился в пакете HPC 2012 и не поддерживается в предыдущих версиях. |
| /password:<пароль> | Указывает пароль для учетной записи, в которой должно выполняться задание. Если указать параметр /user, но не параметр /password, задание отправляет командную строку для пароля и сохраняет ли пароль. |
| /priority:<приоритет> | Задает приоритет для планирования задания. Для Windows HPC Server 2008 значение приоритета может быть только одним из следующих именованных значений: "Выше", "Выше", "Обычный", "НижеНормал" или "Низкий". Для Windows HPC Server 2008 R2 можно использовать любое из пяти именованных значений приоритета, которые можно использовать в Windows HPC Server 2008. Можно также использовать любое число от 0 до 4000, с 0 как самый низкий приоритет и 4000 как самый высокий. Можно также указать значение приоритета как named_value+смещения или named_value-смещения. Для этих окончательных форматов именованные приоритеты имеют значения в следующей таблице, а сочетание именованного значения и смещения не может быть меньше 0 или больше 4000. Высший- 4000 НадНормальным - 3000 Обычная - 2000 НижеНормаль — 1000 Наиболее низкий - 0 Шаблон задания, используемый заданием, указывает разрешения, влияющие на то, кто может указать повышенные приоритеты. Служба планировщика заданий HPC помещает задания с тем же приоритетом в очередь заданий в порядке отправки заданий, если пользователь не повторно отправляет задание. Если пользователь повторно отправляет задание, служба планировщика заданий HPC помещает это задание в первую очередь среди заданий с тем же приоритетом. Приоритет по умолчанию для задания — обычный или 2000. |
| /progress:<percent_progress> | Указывает процент завершенного задания. Это значение должно быть от 0 до 100. Если значение этого свойства не задано, служба планировщика заданий HPC вычисляет ход выполнения на основе процента задач, выполненных для задания. При установке этого свойства для задания служба планировщика заданий HPC не продолжает обновлять это свойство, поэтому необходимо продолжить обновление свойства с помощью команды изменить. Этот параметр появился в пакете HPC 2008 R2 и не поддерживается в предыдущих версиях. |
| /progressmsg:<сообщение> | Указывает настраиваемое сообщение о состоянии, которое требуется отобразить для задания. Максимальная длина этой строки составляет 80 символов. Чтобы указать сообщение о состоянии, включающее пробелы, заключите сообщение о состоянии в кавычки (). Этот параметр появился в пакете HPC 2008 R2 и не поддерживается в предыдущих версиях. |
| /projectname:<имя> | Указывает имя проекта для задания, которое можно использовать для отслеживания заданий. Максимальная длина имени проекта составляет 80 символов. |
| /requestednodes:<node_list> | Задает список имен узлов, на которых задание может выполняться, в формате <node1_name>[,<node2_name>...]. Эти узлы являются кандидатами для задания, но не все узлы обязательно будут запускать задание, если доступные ресурсы на этих узлах превышают необходимые ресурсы. Служба планировщика заданий HPC выделяет верхние узлы в соответствии со значением параметра /orderby, пока выделенные узлы не соответствуют значению, указанному с /numcores, /numsockets, /numprocessorsили /numnodes параметр. Если не указать параметр /requestednodes, служба планировщика заданий HPC рассматривает все узлы в качестве кандидатов, которые служба планировщика заданий HPC может выделить для задания. Если указать значения для |
| /rerunnable[:{true|false}] | Указывает, пытается ли служба планировщика заданий HPC повторно запустить задачу, если задача выполняется и завершается сбоем. Значение True указывает, что служба планировщика заданий HPC может попытаться повторно запустить задачу, если задача преумножена или если это не удалось из-за проблемы с кластером, например узла, который становится недоступным. Планировщик заданий не пытается повторно запустить задачи, которые выполняются до завершения и возвращают код неудачного выхода. Значение False указывает, что служба планировщика заданий HPC не должна пытаться повторно запустить задачу, если задача начинается, но не завершается из-за проблем с прерыванием или кластером. Вместо этого она должна немедленно переместить задачу в состояние сбоя. Администратор кластера может настроить количество попыток повторного запуска задачи, которую служба планировщика заданий HPC пытается повторно запустить перед перемещением задачи в состояние сбоя. Если параметр /rerunnable не указан, команда ведет себя так, как если бы вы указали значение True. |
| /runtime:{<времени> | 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 2012 и не поддерживается в предыдущих версиях. |
| /stderr:[ путь<>\]<file_name> | Указывает имя файла, в который задача должна перенаправить стандартный поток ошибок, включая полный путь или путь относительно рабочего каталога для файла, если задача не должна перенаправлять стандартный поток ошибок в файл в рабочем каталоге. Если указать путь, который не существует, задача завершается ошибкой. Если параметр Максимальная длина значения для этого параметра составляет 160 символов. |
| /stdin:[<пути>\]<file_name> | Указывает имя файла, из которого задача должна получать стандартные входные данные, включая полный путь или путь относительно рабочего каталога файла, если задача не должна получать стандартные входные данные из файла в рабочем каталоге. Если указать файл или путь, который не существует, задача завершается ошибкой. Максимальная длина значения для этого параметра составляет 160 символов. |
| /stdout:[<пути>\]<file_name> | Указывает имя файла, в который задача должна перенаправить стандартные выходные данные, включая полный путь или путь относительно рабочего каталога для файла, если задача не должна перенаправлять стандартные выходные данные в файл в рабочем каталоге. Если указать путь, который не существует, задача завершается ошибкой. Если параметр /stdout Максимальная длина значения для этого параметра составляет 160 символов. |
| /taskexecutionfailureretrylimit:<retry_limit> | Указывает максимальное количество случаев, когда задача в этом задании, отличном от задачи подготовки узла или выпуска узла, будет автоматически перезаписываться после сбоя выполнения приложения. Этот параметр появился в пакете HPC 2012 R2 с обновлением 1. Она недоступна в предыдущих версиях. |
| /type:<type_name> | Указывает тип задачи, который определяет, как выполнить команду для задачи. Ниже перечислены типы, которые можно указать: Основной- Запускает один экземпляр последовательного приложения или приложения интерфейса передачи сообщений (MPI). Приложение MPI обычно выполняется одновременно на нескольких ядрах и может охватывать несколько узлов. NodePrep — Выполняет команду или скрипт на каждом вычислительном узле, так как он выделяется для задания. Задача подготовки узлов выполняется на узле перед любой другой задачей в задании. Если задача подготовки узла не выполняется на узле, этот узел не добавляется в задание. NodeRelease — Выполняет команду или скрипт на каждом вычислительном узле, так как он освобождается из задания. Задачи выпуска узла выполняются при отмене задания пользователем или путем корректной предварительной отмены. Задачи выпуска узла не выполняются при отмене задания немедленной предварительной отменой. ParametricSweep — отменяет команду заданное количество раз, как указано значениями start, end и Increment, как правило, для индексированных входных и выходных файлов. Шаги очистки могут выполняться параллельно или не могут выполняться в зависимости от ресурсов, доступных в кластере HPC при выполнении задачи. При указании типа ParametricSweep следует использовать параметр /parametric, чтобы указать начальные, конечные и добавочные значения для индекса. Если параметр /parametric не используется Служба- Выполняет команду или службу во всех ресурсах, назначенных заданию. Новые экземпляры команды запускаются при добавлении новых ресурсов в задание или при выходе ранее запущенного экземпляра и ресурсе, который использовался ранее запущенный экземпляр, по-прежнему выделяется заданию. Задача службы продолжает запускать новые экземпляры до тех пор, пока задача не будет отменена, максимальное время выполнения или максимальное количество экземпляров. Задача службы может создавать до 1 000 000 подзадач. Задачи, которые вы отправляете с помощью клиента SOA, выполняющегося как задачи службы. Вы не можете добавить базовую задачу или задачу очистки метрики в задание, содержащее задачу службы. Значение по умолчанию для этого параметра — "Базовый", если параметр /parametric. Если указать параметр /parametric, значение по умолчанию параметра /type — ParametricSweep. Если указать параметр /type со значением, отличном от ParametricSweep, нельзя также указать параметр /parametric. Этот параметр появился в пакете HPC 2008 R2 и не поддерживается в предыдущих версиях. |
| /workdir:<папка> | Указывает рабочий каталог, в котором должна выполняться задача. Максимальная длина значения для этого параметра составляет 160 символов. |
| команда <> [ параметры<>] | Указывает командную строку для задачи, включая имя команды или приложения и все необходимые параметры. Если в /taskfile XML-файл задачи не определена, для добавления задачи должна существовать команда. Команда будет выполнена относительно рабочего каталога, если он не содержит полный путь. |
| /user:<[ домен>\]<user_name>] | Указывает имя пользователя и, при необходимости, домен учетной записи, в которой должно выполняться задание. Если этот параметр не указан, задание выполняется под учетной записью, используемой для отправки задания. |
| /validexitcodes:{int|intStart.. intEnd} [,{int|intStart.. intEnd}]* | Указывает коды выхода, используемые для проверки успешности выхода задач в задании.
/validexitcodes должны быть указаны дискретными целыми числами и диапазонами целых чисел, разделенными запятыми. мин или максимальное можно использовать в качестве начального или конца целочисленного диапазона. Например, 0..max представляет все ненегивные целые числа.Этот параметр можно переопределить, объявив параметр /validexitcodes, характерный для задачи. Все задачи, не имеющие этого параметра, явно объявленные, наследуют параметр от задания. Если /validexitcodes не определен, значение 0 является допустимым кодом выхода по умолчанию. |
| /? | Отображает справку в командной строке. |
| /help | Отображает справку в командной строке. |
Замечания
Команда отправки задания
имеет три основных формы. Параметры /password, /userи /scheduler являются общими для всех трех форм. Первая форма команды также включает параметр /id и отправляет существующее задание с указанным идентификатором задания.
Вторая форма команды включает параметр /jobfile в дополнение к общим параметрам. Эта форма создает новое задание с параметрами и задачами, указанными в файле задания, и немедленно отправляет это задание.
Третья форма команды включает оставшиеся параметры, за исключением тех, которые отображают сообщение справки в командной строке. Эта форма команды создает новое задание с одной задачей для выполнения указанной команды, а затем отправляет это задание.
После отправки задания служба планировщика заданий HPC проверяет задание и вводит задание в очередь заданий. Служба планировщика заданий HPC ожидает запуска задания до тех пор, пока не станет доступно достаточно ресурсов.
Начиная с Windows HPC Server 2008 R2, можно указать, что звездочки (*) в командной строке для задачи параметрики не должны быть заменены текущим значением параметрического индекса, предшествующим звездочкам (^). Например, если вы используете команду отправки задания
для отправки задания с одной параметрической задачей и указания командной строки как echo *, задача выводит значения параметрического индекса. Если вместо этого с помощью задания добавить команду для создания параметрической задачи и указать командную строку как эхо ^^^*, задача выводит звездочку для каждого значения параметрического индекса.
Примеры
Чтобы отправить задание с идентификатором задания 38, используйте следующую команду:
job submit 38
Чтобы создать новое задание с помощью параметров в файле в C:\Jobs\MyJob.xml, а затем немедленно отправить задание, используйте следующую команду:
job submit /jobfile:C:\Jobs\MyJob.xml
Чтобы создать и отправить новое однозадачные задания с типом задания Basic, который отправляет уведомление по электронной почте при запуске задания и имеет сообщение о состоянии "Отправлено", и который запускает команду vol, используйте следующую команду:
job submit /notifyonstart:true /progressmsg:"Submitted" /type:Basic vol
Чтобы создать новое задание, добавьте задачу в задание, а затем отправьте задание, запустите пакетный файл, содержащий следующую команду, которая использует для команды, чтобы получить идентификатор нового задания:
for /f "usebackq tokens=4 delims=. " %%i in (`job new`) do (
job add %%i echo Hello World
job submit /id:%%i
)
Дополнительные ссылки
ключа синтаксиса
Command-Line