envio de trabalho
Envia o trabalho especificado para ser executado em um cluster HPC.
Para obter exemplos de como usar esse comando, consulte Exemplos.
Sintaxe
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}
Parâmetros
| Parâmetro | Descrição |
|---|---|
| /id:<> jobID | Especifica o identificador de trabalho do trabalho que você deseja enviar. Use esse parâmetro para enviar um trabalho que já existe e contém tarefas. Você só pode enviar trabalhos que tenham um estado de configuração. |
| /jobfile:<caminho>\<file_name> | Especifica o nome do arquivo e o caminho de um arquivo XML de trabalho que contém configurações a serem usadas para o trabalho que você deseja enviar. Use esse parâmetro para criar um novo trabalho com as configurações no arquivo XML do trabalho e enviá-lo imediatamente. |
| /askednodes:<node_list> | Preterido. Use o parâmetro /requestednodes em vez disso. |
| /corespernode:<min>[-<max>] | Especifica o número mínimo e, opcionalmente, o número máximo de núcleos que um nó pode ter para que o Serviço de Agendador de Trabalho do HPC considere o nó como um nó candidato no qual executar o trabalho. O trabalho não será executado em um nó que tenha menos núcleos do que o valor mínimo ou mais núcleos do que o valor máximo especificado por esse parâmetro. Se todos os nós no cluster tiverem vários núcleos que estão fora do intervalo especificado para esse parâmetro, ocorrerá um erro ao enviar o trabalho. |
| /customproperties:<property_list> | Especifica as propriedades personalizadas do trabalho em um formato de <name1>=<value1>[;<name2>=<value2>...]. As propriedades personalizadas não diferenciam maiúsculas de minúsculas e refletirão o caso usado quando forem definidas pela primeira vez. Esse parâmetro foi introduzido no HPC Pack 2012 e não tem suporte em versões anteriores. |
| /emailaddress:<endereço> | Envia notificações para esse trabalho para esse endereço. Esse parâmetro foi introduzido no HPC Pack 2012 e não tem suporte em versões anteriores. |
| /env:<variable_and_value_list> | Especifica uma lista de variáveis de ambiente a serem definidas no ambiente de tempo de execução da tarefa e os valores a serem atribuídos a essas variáveis de ambiente. A lista deve ter um formato de <variable_name1>=<value1> [;<variable_name2>=<value2>.]. Como alternativa, você pode definir várias variáveis de ambiente incluindo vários parâmetros de /env. Cada um deve ser um argumento diferente com um formato de <variable_name>=<valor>. Para desaconsinar uma variável de ambiente, não especifique um valor. Por exemplo, <variable_to_unset_name>=. |
| /estimatedprocessmemory:<> de memória | A quantidade máxima de memória em megabytes (MB) que cada processo neste trabalho é estimada para consumir. |
| /exclusive[:{true|false}] | Especifica se o Serviço de Agendador de Trabalho do HPC deve garantir que nenhum outro trabalho seja executado no mesmo nó do trabalho enquanto esse trabalho é executado. Um valor true indica que o Serviço de Agendador de Trabalho do HPC deve garantir que nenhum outro trabalho seja executado no mesmo nó enquanto esse trabalho for executado. Um valor de False indica que esse trabalho pode compartilhar nós de computação com outros trabalhos. Quando você especifica o parâmetro /exclusive sem um valor, o comando envio de trabalho se comporta como se você tivesse especificado um valor verdadeiro. Se você não especificar o parâmetro /exclusive, o comando envio de trabalho se comportará como se você tivesse especificado um valor de False. |
| /faildependenttasks[:{true|false}] | Especifica que, se uma tarefa falhar ou for cancelada, todas as tarefas dependentes falharão. Se /faildependenttasks for declarado, mas nenhum valor for fornecido, True será assumido. Se /faildependenttasks não for declarado, False será assumido. Esse parâmetro foi introduzido no HPC Pack 2012 e não tem suporte em versões anteriores. |
| /failontaskfailure[:{true|false}] | Especifica se o Serviço de Agendador de Trabalho do HPC deve parar o trabalho e falhar todo o trabalho imediatamente quando uma tarefa no trabalho falhar. Um valor true indica que o Serviço de Agendador de Trabalho do HPC deve parar o trabalho e falhar todo o trabalho imediatamente quando uma tarefa no trabalho falhar. Um valor de False indica que o Serviço de Agendador de Trabalho do HPC deve continuar executando o restante das tarefas no trabalho depois que qualquer tarefa no trabalho falhar. Quando você especifica o parâmetro /failontaskfailure sem um valor, o comando envio de trabalho se comporta como se você tivesse especificado um valor true. Se você não especificar o parâmetro /failontaskfailure, o comando envio de trabalho se comportará como se você tivesse especificado um valor de False. |
| /holduntil:[{<DateTime>|<minutos>}] | Especifica a data e a hora em hora local ou número de minutos até que o Serviço de Agendador de Trabalho do HPC deva aguardar antes de tentar iniciar o trabalho. Se esse parâmetro não estiver definido, o trabalho poderá ser iniciado quando os recursos estiverem disponíveis. O Serviço de Agendador de Trabalho do HPC só executa o trabalho na data e hora em que esse parâmetro especifica se os recursos necessários para o trabalho estão disponíveis. Se os recursos necessários para o trabalho não estiverem disponíveis nessa data e hora, o trabalho permanecerá na fila até que os recursos necessários fiquem disponíveis. Você pode especificar a data e a hora em qualquer formato que o .NET Framework possa analisar para a cultura atual do sistema operacional. Para obter informações sobre como o .NET Framework analisa cadeias de caracteres de data e hora, consulte Analisando cadeias de caracteres de data e hora. Você pode especificar o parâmetro /holduntil para um trabalho, desde que o trabalho não esteja em execução ou concluído. O tempo especificado usando /holduntil é convertido internamente em UTC e não refletirá o Horário de Verão local. Se o valor de minutos for usado, ele deverá ser um inteiro. Os minutos a serem suspensos são convertidos em UTC no momento em que de modificação de trabalho é aplicado. Se o valor de /holduntil estiver vazio, qualquer valor holduntil atual será apagado e o trabalho não estará mais pendente devido a esse parâmetro. Esse parâmetro foi introduzido no HPC Pack 2012 e não tem suporte em versões anteriores. |
| /jobenv:<variable_and_value_list> | Especifica as variáveis de ambiente que você deseja definir no ambiente de tempo de execução do trabalho e os valores para os quais você deseja definir essas variáveis de ambiente. A lista deve ter um formato de <variable_name1>=<value1> [;<variable_name2>=<value2>...]. Como alternativa, você pode definir várias variáveis de ambiente incluindo vários parâmetros de /jobenv, cada um com um argumento diferente com o formato <variable_name>=<valor>. Para desaconsinar uma variável de ambiente, não especifique um valor. Por exemplo, "<variable_to_unset_name>=". Se você definir ou desvincular uma variável de ambiente para um trabalho, essa variável de ambiente também será definida ou não definida para cada tarefa no trabalho, a menos que você substitua essa configuração de variável de ambiente para a tarefa especificando uma nova configuração com o parâmetro /env. Esse parâmetro foi introduzido no HPC Pack 2008 R2 e não tem suporte em versões anteriores. |
| /jobname:<job_name> | Especifica um nome a ser usado para esse trabalho na saída do comando e na interface do usuário. O comprimento máximo para o nome de um trabalho é de 80 caracteres. |
| /jobtemplate:<job_template_name> | Especifica o nome do modelo de trabalho a ser usado para o trabalho. O comprimento máximo para o nome de um modelo de trabalho é de 80 caracteres. Por padrão, o comando envio de trabalho usa o modelo de trabalho padrão para o novo trabalho. |
| /license:<license_list> | Especifica uma lista de recursos para os quais o trabalho requer licenças e o número de licenças necessárias para cada um. Use um formato de <license_name1>:<número1> [,<license_name2>:<número2>...] para esta lista.
<número..> pode ser qualquer inteiro positivo ou * que solicitará o mesmo número de licenças que núcleos, soquetes ou nós atribuídos ao trabalho. Por exemplo, /license1:10,license2:* significa 10 licenças de licença1 e N da licença2 em que N está vinculado ao número de núcleos, nós ou soquetes associados ao trabalho que está sendo enviado. A lista tem um comprimento máximo de 160 caracteres. |
| /memorypernode:<min>[-<max>] | Especifica o mínimo e, opcionalmente, a quantidade máxima de memória em megabytes (MB) que um nó pode ter para que o Serviço de Agendador de Trabalho do HPC considere o nó como um nó candidato no qual executar o trabalho. O trabalho não será executado em um nó que tenha menos memória do que o valor mínimo ou mais memória do que o valor máximo especificado por esse parâmetro. Se todos os nós no cluster tiverem uma quantidade de memória fora do intervalo especificado para esse parâmetro, ocorrerá um erro ao enviar o trabalho. |
| /name:<task_name> | Especifica um nome a ser usado para essa tarefa na saída do comando e na interface do usuário. O comprimento máximo para o nome de uma tarefa é de 80 caracteres. |
| /nodegroup:<node_group_list> | Especifica a lista de grupos de nós nos quais esse trabalho pode ser executado no formato <node_group1_name>[,<node_group2_name>...]. O Serviço de Agendador de Trabalho do HPC aloca recursos para o trabalho de nós que pertencem a todos os grupos de nós na lista por padrão ou aos nós resultantes da operação do parâmetro /nodegroupop, se especificado, na lista de grupos. Se você especificar valores para os /nodegroups O parâmetro /nodegroup garante que haja nós na lista de nós válida. No entanto, se os requisitos de recursos de um trabalho do parâmetro acima não puderem ser atendidos de dentro da lista de nós, o trabalho falhará durante o envio do trabalho. Se você especificar o parâmetro /requestednodes para uma tarefa e /nodegroups para o trabalho, o trabalho falhará durante o envio se os nós solicitados não estiverem nos nós listados em conjunto com o /nodegroup e os parâmetros /nodegroupop. |
| /nodegroupop:{Intersect|Uniforme|Union} | Especifica o operador da lista especificada pelo parâmetro /nodegroup. Os valores válidos são: Intersect – Cria a lista de nós que estão em todos os grupos de nós listados. Uniforme – faz com que o Serviço de Agendador de Trabalho do HPC experimente os grupos de nós em ordem. Se houver recursos suficientes no primeiro grupo de nós, eles serão usados. Caso contrário, o Agendador tenta cada grupo de nós a seguir até encontrar um com recursos suficientes. Se recursos suficientes não forem encontrados, o trabalho permanecerá na fila. União – Cria a lista de nós que estão em qualquer um dos grupos de nós. O valor padrão para esse parâmetro é Intersect. Esse parâmetro foi introduzido no HPC Pack 2012 e não tem suporte em versões anteriores. |
| /notifyoncompletion[:{true|false}] | Especifica se o Serviço de Agendador de Trabalho do HPC deve ou não enviar uma notificação por email quando o trabalho terminar. Um valor true indica que o Serviço de Agendador de Trabalho do HPC deve enviar uma notificação por email quando o trabalho terminar. Um valor de False indica que o Serviço de Agendador de Trabalho do HPC não deve enviar notificação por email quando o trabalho terminar. Um trabalho termina e a notificação é enviada quando o estado do trabalho é alterado para Concluído, Com Falha ou Cancelado. Um administrador de cluster deve configurar a notificação para o cluster HPC antes de receber uma notificação sobre um trabalho. Quando você especifica o parâmetro Esse parâmetro foi introduzido no HPC Pack 2008 R2 e não tem suporte em versões anteriores. |
| /notifyonstart[:{true|false}] | Especifica se o Serviço de Agendador de Trabalho do HPC deve ou não enviar uma notificação por email quando o trabalho for iniciado. Um valor true indica que o Serviço de Agendador de Trabalho do HPC deve enviar uma notificação por email quando o trabalho for iniciado. Um valor de False indica que o Serviço de Agendador de Trabalho do HPC não deve enviar notificação por email quando o trabalho for iniciado. Um administrador de cluster deve configurar a notificação para o cluster HPC antes de receber uma notificação sobre um trabalho. Quando você especifica o parâmetro novo comando do trabalho se comporta como se você tivesse especificado um valor de False. Esse parâmetro foi introduzido no HPC Pack 2008 R2 e não tem suporte em versões anteriores. |
| /numcores:<min>[-<max>] | Especifica o número geral de núcleos no cluster HPC que o trabalho requer no formato <>mínimo [-<máximo>]. O trabalho é executado em pelo menos o número mínimo de núcleos e no máximo. Se você especificar apenas um valor, esse comando definirá o número máximo e mínimo de núcleos para esse valor. Se você especificar um valor mínimo que exceda o número total de núcleos disponíveis no cluster, ocorrerá um erro ao enviar o trabalho. Os valores mínimo e máximo só podem ser inteiros positivos ou um asterisco (*). Se você especificar o valor mínimo ou máximo como um asterisco, o Serviço de Agendador de Trabalho HPC calculará automaticamente o número mínimo ou máximo de núcleos em tempo de execução com base no número mínimo e máximo de núcleos para as tarefas no trabalho. Você não poderá especificar o parâmetro /numcores se também especificar o parâmetro /numnodes, /numprocessorsou /numsockets. |
| /numnodes:<min>[-<max>] | Especifica o número geral de nós no cluster HPC que o trabalho requer no formato <>mínimo [-<máximo de>]. O trabalho é executado em pelo menos o número mínimo de nós e no máximo. Se você especificar apenas um valor, esse comando definirá o número máximo e mínimo de nós para esse valor. Se você especificar um valor mínimo que exceda o número total de nós disponíveis no cluster, ocorrerá um erro ao enviar o trabalho. Os valores mínimo e máximo só podem ser inteiros positivos ou um asterisco (*). Se você especificar o valor mínimo ou máximo como um asterisco, o Serviço de Agendador de Trabalho do HPC calculará automaticamente o número mínimo ou máximo de nós em tempo de execução com base no número mínimo e máximo de nós para as tarefas no trabalho. Não é possível especificar o parâmetro /numnodes se você também especificar o parâmetro /numcores, /numprocessorsou /numsockets. |
| /numprocessors:<min>[-<max>] | Preterido. Em vez disso, use o parâmetro |
| /numsockets:<min>[-<max>] | Especifica o número geral de soquetes no cluster HPC que o trabalho requer no formato <>mínimo [-<máximo>]. O trabalho é executado em pelo menos o número mínimo de soquetes e no máximo. Se você especificar apenas um valor, esse comando definirá o número máximo e mínimo de soquetes para esse valor. Se você especificar um valor mínimo que exceda o número total de soquetes disponíveis no cluster, ocorrerá um erro ao enviar o trabalho. Os valores mínimo e máximo só podem ser inteiros positivos ou um asterisco (*). Se você especificar o valor mínimo ou máximo como um asterisco, o Serviço de Agendador de Trabalho HPC calculará automaticamente o número mínimo ou máximo de soquetes em tempo de execução com base no número mínimo e máximo de soquetes para as tarefas no trabalho. Você não poderá especificar o parâmetro /numsockets se também especificar o parâmetro /numcores, /numprocessorsou /numnodes parâmetro. |
| /orderby:<>primário [,<>secundário] | Especifica a ordem que o Serviço de Agendador de Trabalho HPC deve usar para alocar nós ao trabalho no formato <primary_order>[,<secondary_order>]. As partes primary_order e secondary_order do valor podem ser cada um dos seguintes valores: memória – O Serviço de Agendador de Trabalho do HPC classifica os nós pela quantidade de memória que eles têm disponível e aloca o trabalho para nós com mais memória primeiro. -memory - O Serviço de Agendador de Trabalho do HPC classifica os nós pela quantidade de memória que eles têm disponível e aloca o trabalho para nós com menos memória primeiro. núcleos – o Serviço de Agendador de Trabalho HPC classifica os nós pelo número de núcleos que eles têm disponíveis e aloca o trabalho para nós com mais núcleos primeiro. -núcleos - O Serviço de Agendador de Trabalho do HPC classifica os nós pelo número de núcleos que eles têm disponíveis e aloca o trabalho para nós com menos núcleos primeiro. Quando você especifica um pedido secundário, o Serviço de Agendador de Trabalho HPC classifica os nós de acordo com a ordem primária primeiro. Para subconjuntos de nós que têm a mesma quantidade do recurso especificado pela ordem primária, o Serviço de Agendador de Trabalho do HPC classifica os nós dentro do subconjunto usando a ordem de classificação secundária. Por exemplo, se você especificar memória,-núcleos, o Serviço de Agendador de Trabalho do HPC classificará os nós da maior quantidade de memória para a menor. Em seguida, para subconjuntos de nós que têm a mesma quantidade de memória, o Serviço de Agendador de Trabalho do HPC usa o número de núcleos para quebrar a gravata e classifica os nós que têm a mesma quantidade de memória do menor número de núcleos para o máximo. A ordem primária e a ordem secundária devem se referir a diferentes tipos de recursos. Por exemplo, memória,núcleos é uma combinação válida de ordens de classificação primária e secundária. Combinações como memória, memória e -núcleos, núcleos não são válidas. A ordem padrão que o Serviço de Agendador de Trabalho HPC usa para alocar nós a um trabalho é núcleos, memória. |
| /parametric:<index_specification> | Indica que a nova tarefa é uma tarefa paramétrica. Uma tarefa paramétrica executa o comando especificado várias vezes, substituindo o valor de índice atual por quaisquer asteriscos (*) na linha de comando. O asterisco também é substituído quando especificado nos parâmetros /stdin, /stdoute /stderr. A especificação de índice para esse parâmetro define o comportamento do valor do índice. O formato da especificação de índice é [<iniciar>-]<>final [:<incremento>]. O valor do índice atual começa no índice inicial e aumenta pelo valor de incremento a cada tempo subsequente em que o comando é executado. Quando o índice atual excede o índice final, a tarefa para de executar o comando. O índice inicial deve ser menor que o índice final e o valor de incremento deve ser um inteiro positivo. |
| /parentjobids: <jobID_list> | Especifica a lista de IDs de trabalho das quais o trabalho dependerá em um formato de <jobID1>[,<jobID2>...]. As IDs do trabalho já devem existir. O Serviço de Agendador de Trabalho do HPC agendará o trabalho somente quando seus trabalhos pai forem concluídos e estiverem todos em um estado concluído. Se qualquer trabalho pai não tiver sido concluído ou concluído, mas estiver em um estado cancelado ou com falha, o trabalho permanecerá na fila. Esse parâmetro foi introduzido no HPC Pack 2012 e não tem suporte em versões anteriores. |
| /password:<> de senha | Especifica a senha da conta na qual o trabalho deve ser executado. Se você especificar o parâmetro /user mas não o parâmetro /password, o trabalho enviará comando solicitará a senha e se a senha será armazenada. |
| /priority:<> de prioridade | Especifica a prioridade para agendar o trabalho. Para o Windows HPC Server 2008, o valor de prioridade só pode ser um dos seguintes valores nomeados: Mais Alto, Acima deNormal, Normal, BelowNormal ou Menor. Para o Windows HPC Server 2008 R2, você pode usar qualquer um dos cinco valores de prioridade nomeados que você poderia usar no Windows HPC Server 2008. Você também pode usar qualquer número entre 0 e 4000, com 0 como a prioridade mais baixa e 4.000 como a mais alta. Você também pode especificar o valor de prioridade como Sumo- 4000 AboveNormal - 3000 Normal - 2000 BelowNormal - 1000 Menor - 0 O modelo de trabalho que o trabalho usa especifica permissões que afetam quem pode especificar prioridades elevadas. O Serviço de Agendador de Trabalho do HPC coloca trabalhos com a mesma prioridade na fila de trabalho na ordem em que os usuários enviam os trabalhos, a menos que um usuário requeuia um trabalho. Se um usuário requeuir um trabalho, o Serviço de Agendador de Trabalho do HPC colocará esse trabalho em primeiro lugar entre os trabalhos com a mesma prioridade. A prioridade padrão para um trabalho é Normal ou 2000. |
| /progress:<percent_progress> | Especifica o percentual do trabalho que está concluído. Esse valor deve estar entre 0 e 100. Se você não definir o valor dessa propriedade, o Serviço de Agendador de Trabalho do HPC calculará o progresso com base no percentual de tarefas concluídas para o trabalho. Quando você define essa propriedade para um trabalho, o Serviço de Agendador de Trabalho do HPC não continua a atualizar essa propriedade, portanto, você deve continuar a atualizar a propriedade usando o comando modificação de trabalho. Esse parâmetro foi introduzido no HPC Pack 2008 R2 e não tem suporte em versões anteriores. |
| /progressmsg:<mensagem> | Especifica uma mensagem de status personalizada que você deseja exibir para o trabalho. O comprimento máximo dessa cadeia de caracteres é de 80 caracteres. Para especificar uma mensagem de status que inclua espaços, coloque a mensagem de status entre aspas ("). Esse parâmetro foi introduzido no HPC Pack 2008 R2 e não tem suporte em versões anteriores. |
| /projectname:<nome> | Especifica um nome de projeto para o trabalho que você pode usar para trabalhos de acompanhamento. O comprimento máximo para o nome do projeto é de 80 caracteres. |
| /requestednodes:<node_list> | Especifica uma lista de nomes para os nós nos quais o trabalho pode ser executado, em um formato de <node1_name>[,<node2_name>...]. Esses nós são candidatos para o trabalho, mas nem todos os nós necessariamente executarão o trabalho se os recursos disponíveis nesses nós excederem os recursos exigidos pelo trabalho. O Serviço de Agendador de Trabalho do HPC aloca os principais nós de acordo com o valor do parâmetro /orderby até que os nós alocados atendam ao valor especificado com o /numcores, /numsockets, /numprocessorsou /numnodes parâmetro. Se você não especificar o parâmetro Se você especificar valores para os |
| /rerunnable[:{true|false}] | Especifica se o Serviço de Agendador de Trabalho do HPC tenta executar novamente a tarefa se a tarefa for executada e falhar. Um valor de True indica que o Serviço de Agendador de Trabalho do HPC pode tentar executar novamente a tarefa se a tarefa for preemptada ou se ela falhar devido a um problema de cluster, como um nó se tornando inacessível. O agendador de trabalho não tenta executar novamente tarefas que são executadas até a conclusão e retornam uma com um código de saída malsucedido. Um valor de False indica que o Serviço de Agendador de Trabalho do HPC não deve tentar executar novamente a tarefa se a tarefa começar, mas não for concluída devido a problemas de preempção ou cluster. Em vez disso, ele deve mover a tarefa para o estado com falha imediatamente. O administrador do cluster pode configurar o número de vezes que o Serviço de Agendador de Trabalho do HPC tenta executar novamente uma tarefa executável antes de mover a tarefa para o estado com falha. Se você não especificar o parâmetro /rerunnable, o comando se comportará como se você tivesse especificado um valor true. |
| /runtime:{<> de tempo | Infinite} | Especifica o período máximo de tempo que o trabalho deve ser executado. Depois que o trabalho for executado por esse período de tempo, o Serviço de Agendador de Trabalho do HPC cancelará o trabalho. Especifique a quantidade de tempo no formato [[<dias>:]<horas>:]<minutos>. Você também pode especificar Infinito para indicar que o trabalho pode ser executado por um período ilimitado de tempo. Se você especificar apenas uma parte do formato [[<dias>:]<horas>:]<minutos> formato, o comando interpretará o valor especificado como o número de minutos. Por exemplo, 12 indica 12 minutos. Se você especificar duas partes do formato, o comando interpretará a parte esquerda como horas e a parte direita como minutos. Por exemplo, 10:30 indica 10 horas e 30 minutos. Você pode usar um ou mais dígitos para cada parte do formato. O valor máximo para cada parte é 2.147.483.647. Se você não especificar o parâmetro /runtime, o valor padrão será Infinito. |
| /rununtilcanceled[:{true|false}] | Especifica se o trabalho continua a executar e manter recursos até que o limite de tempo de execução expire ou se alguém cancela o trabalho. Um valor true indica que o trabalho continua a executar e manter recursos até que o limite de tempo de execução expire ou alguém cancele o trabalho. Se você especificar um valor true, deverá especificar valores mínimos e máximos para o parâmetro /numcores, /numnodesou /numsockets ou ocorrerá um erro ao enviar o trabalho. Um valor de False indica que o trabalho deve parar e liberar seus recursos quando todas as tarefas no trabalho forem concluídas. Quando você especifica o parâmetro /rununtilcanceled sem um valor, o comando envio de trabalho se comporta como se você tivesse especificado um valor true. Se você não especificar o parâmetro /rununtilcanceled, o comando envio de trabalho se comportará como se você tivesse especificado um valor de False. |
| /scheduler:<nome> | Especifica o nome do host ou o endereço IP do nó principal para o cluster no qual você deseja enviar a tarefa. O valor deve ser um nome de computador ou endereço IP válido. Se você não especificar o parâmetro /scheduler, esse comando usará o agendador no nó principal especificado pela variável de ambiente CCP_SCHEDULER. |
| /singlenode[:{true|false}] | Especifica que todos os recursos serão alocados em um nó. Se /singlenode for declarado, mas nenhum valor for fornecido, True será assumido. Se /singlenode não for declarado, False será assumido. Esse parâmetro foi introduzido no HPC Pack 2012 e não tem suporte em versões anteriores. |
| /stderr:[<>de caminho \]<file_name> | Especifica o nome do arquivo para o qual a tarefa deve redirecionar o fluxo de erros padrão, incluindo o caminho completo ou o caminho relativo ao diretório de trabalho do arquivo se a tarefa não deve redirecionar o fluxo de erros padrão para um arquivo no diretório de trabalho. Se você especificar um caminho que não existe, a tarefa falhará. Se você não especificar o parâmetro /stderr, a tarefa armazenará até 4 quilobytes (KB) de dados no banco de dados para o Serviço de Agendador de Trabalho do HPC que a propriedade Output para a tarefa especifica. Qualquer saída que exceda 4 KB será perdida. O comprimento máximo do valor para esse parâmetro é de 160 caracteres. |
| /stdin:[<caminho>\]<file_name> | Especifica o nome do arquivo do qual a tarefa deve receber entrada padrão, incluindo o caminho completo ou o caminho relativo ao diretório de trabalho do arquivo se a tarefa não deve receber entrada padrão de um arquivo no diretório de trabalho. Se você especificar um arquivo ou caminho que não existe, a tarefa falhará. O comprimento máximo do valor para esse parâmetro é de 160 caracteres. |
| /stdout:[<path>\]<file_name> | Especifica o nome do arquivo para o qual a tarefa deve redirecionar a saída padrão, incluindo o caminho completo ou o caminho relativo ao diretório de trabalho do arquivo se a tarefa não deve redirecionar a saída padrão para um arquivo no diretório de trabalho. Se você especificar um caminho que não existe, a tarefa falhará. Se você não especificar o parâmetro /stdout, a tarefa armazenará até 4 quilobytes (KB) de dados no banco de dados para o Serviço de Agendador de Trabalho HPC que a propriedade Saída para a tarefa especifica. Qualquer saída que exceda 4 KB será perdida. O comprimento máximo do valor para esse parâmetro é de 160 caracteres. |
| /taskexecutionfailureretrylimit:<retry_limit> | Especifica o número máximo de vezes que uma tarefa neste trabalho que não seja uma tarefa de preparação de nó ou de versão do nó será requeuída automaticamente após ocorrer uma falha na execução do aplicativo. Esse parâmetro foi introduzido no HPC Pack 2012 R2 Atualização 1. Ele não está disponível em versões anteriores. |
| /type:<type_name> | Especifica um tipo para a tarefa, que define como executar o comando para a tarefa. Veja a seguir os tipos que você pode especificar: Básico- Executa uma única instância de um aplicativo serial ou um aplicativo MPI (Interface de Passagem de Mensagem). Um aplicativo MPI normalmente é executado simultaneamente em vários núcleos e pode abranger vários nós. NodePrep – Executa um comando ou script em cada nó de computação conforme ele é alocado para o trabalho. A tarefa Preparação do Nó é executada em um nó antes de qualquer outra tarefa no trabalho. Se a tarefa Preparação do Nó não for executada em um nó, esse nó não será adicionado ao trabalho. NodeRelease - Executa um comando ou script em cada nó de computação conforme ele é liberado do trabalho. As tarefas de Versão do Nó são executadas quando o trabalho é cancelado pelo usuário ou por preempção normal. As tarefas de versão do nó não são executadas quando o trabalho é cancelado por preempção imediata. ParametricSweep - desmarque um comando um número especificado de vezes, conforme indicado pelos valores Iniciar, Terminar e Incrementar, geralmente em arquivos de entrada e saída indexados. As etapas da varredura podem ou não ser executadas em paralelo, dependendo dos recursos disponíveis no cluster HPC quando a tarefa estiver em execução. Ao especificar o tipo ParametricSweep, você deve usar o parâmetro /parametric para especificar os valores de início, término e incremento para o índice. Se você não usar parâmetro /paramétrico, o comando será executado uma vez com um índice de 0. Serviço- Executa um comando ou serviço em todos os recursos atribuídos ao trabalho. Novas instâncias do comando começam quando os novos recursos são adicionados ao trabalho ou se uma instância em execução anteriormente é encerrada e o recurso usado pela instância em execução anteriormente ainda é alocado para o trabalho. Uma tarefa de serviço continua iniciando novas instâncias até que a tarefa seja cancelada, o tempo máximo de execução expire ou o número máximo de instâncias seja atingido. Uma tarefa de serviço pode criar até 1.000.000 subtarefas. Tarefas enviadas por meio de um cliente SOA (arquitetura orientada a serviço) são executadas como tarefas de serviço. Você não pode adicionar uma tarefa básica ou uma tarefa de varredura paramétrica a um trabalho que contenha uma tarefa de serviço. O valor padrão para esse parâmetro é Basic, a menos que você também especifique o parâmetro /parametric. Se você especificar o parâmetro /parametric, o valor padrão do parâmetro /type será ParametricSweep. Se você especificar o parâmetro /type com um valor diferente de ParametricSweep, também não será possível especificar o parâmetro /parametric. Esse parâmetro foi introduzido no HPC Pack 2008 R2 e não tem suporte em versões anteriores. |
| /workdir:<pasta> | Especifica o diretório de trabalho no qual a tarefa deve ser executada. O comprimento máximo do valor para esse parâmetro é de 160 caracteres. |
| > de comando <[ parâmetros de<>] | Especifica a linha de comando da tarefa, incluindo o nome do comando ou do aplicativo e todos os parâmetros necessários. A menos que seja definido em um arquivo /taskfile da tarefa XML, um comando deve existir para que a tarefa seja adicionada. O comando será executado em relação ao diretório de trabalho, a menos que contenha um caminho totalmente qualificado. |
| /user:[<domain>\]<user_name>] | Especifica o nome de usuário e, opcionalmente, o domínio da conta sob a qual o trabalho deve ser executado. Se você não especificar esse parâmetro, o trabalho será executado na conta usada para enviar o trabalho. |
| /validexitcodes:{int|intStart.. intEnd} [,{int|intStart.. intEnd}]* | Especifica os códigos de saída a serem usados para verificar se as tarefas em um trabalho são encerradas com êxito.
/validexitcodes devem ser especificados por inteiros discretos e intervalos inteiros separados por vírgulas. mínimo ou máximo de pode ser usado como o início ou o fim de um intervalo inteiro. Por exemplo, 0..max representa todos os inteiros nãonegativos.Esse parâmetro pode ser substituído declarando o parâmetro /validexitcodes específico para uma tarefa. Todas as tarefas que não tiverem esse parâmetro declarado explicitamente herdarão o parâmetro do trabalho. Se /validexitcodes não estiver definido, 0 será o código de saída válido padrão. |
| /? | Exibe a Ajuda no prompt de comando. |
| /Ajuda | Exibe a Ajuda no prompt de comando. |
Comentários
O comando envio do trabalho tem três formulários principais. Os parâmetros /password, /usere /scheduler são comuns aos três formulários.
A primeira forma do comando também inclui o parâmetro /id e envia o trabalho existente que tem o identificador de trabalho especificado.
A segunda forma do comando inclui o parâmetro /jobfile além dos parâmetros comuns. Esse formulário cria um novo trabalho com as configurações e tarefas especificadas pelo arquivo de trabalho e envia imediatamente esse trabalho.
A terceira forma do comando inclui os parâmetros restantes, exceto aqueles que exibem uma mensagem de Ajuda no prompt de comando. Essa forma do comando cria um novo trabalho com uma única tarefa para executar o comando especificado e, em seguida, envia esse trabalho.
Depois de enviar o trabalho, o Serviço de Agendador de Trabalho do HPC valida o trabalho e insere o trabalho na fila de trabalho. O Serviço de Agendador de Trabalho do HPC aguarda para iniciar o trabalho até que recursos suficientes fiquem disponíveis.
A partir do Windows HPC Server 2008 R2, você pode especificar que os asteriscos (*) na linha de comando de uma tarefa paramétrica não devem ser substituídos pelo valor atual do índice paramétrico antes do asterisco com três caracteres de cuidado (^). Por exemplo, se você usar o comando envio de trabalho para enviar um trabalho com uma tarefa paramétrica e especificar a linha de comando como eco *, a tarefa imprimirá os valores do índice paramétrico. Se você usar o comando trabalho adicionar para criar uma tarefa paramétrica e especificar a linha de comando como eco ^^^*, a tarefa imprimirá um asterisco para cada valor do índice paramétrico.
Exemplos
Para enviar o trabalho com um identificador de trabalho de 38, use o seguinte comando:
job submit 38
Para criar um novo trabalho usando as configurações no arquivo em C:\Jobs\MyJob.xml e, em seguida, enviar imediatamente o trabalho, use o seguinte comando:
job submit /jobfile:C:\Jobs\MyJob.xml
Para criar e enviar um novo trabalho de tarefa única com um tipo de trabalho básico, que envia uma notificação por email quando o trabalho é iniciado e tem uma mensagem de status "Enviado", e que executa o comando vol, use o seguinte comando:
job submit /notifyonstart:true /progressmsg:"Submitted" /type:Basic vol
Para criar um novo trabalho, adicione uma tarefa ao trabalho e, em seguida, envie o trabalho, execute um arquivo em lote que inclua o seguinte comando, que usa o para comando para obter o identificador do novo trabalho:
for /f "usebackq tokens=4 delims=. " %%i in (`job new`) do (
job add %%i echo Hello World
job submit /id:%%i
)
Referências adicionais
chave de sintaxe Command-Line