envoi d’un travail
Envoie le travail spécifié à exécuter sur un cluster HPC.
Pour obtenir des exemples d’utilisation de cette commande, consultez Exemples.
Syntaxe
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}
Paramètres
| Paramètre | Description |
|---|---|
| /id :<> jobID | Spécifie l’identificateur du travail que vous souhaitez envoyer. Utilisez ce paramètre pour envoyer un travail qui existe déjà et contient des tâches. Vous ne pouvez envoyer des travaux qui ont un état de configuration. |
| /jobfile : chemin d’accès<>\<file_name> | Spécifie le nom de fichier et le chemin d’accès d’un fichier XML de travail qui contient les paramètres à utiliser pour le travail que vous souhaitez envoyer. Utilisez ce paramètre pour créer un travail avec les paramètres du fichier XML du travail et l’envoyer immédiatement. |
| /askednodes :<node_list> | Déconseillé. Utilisez le paramètre /requestednodes à la place. |
| /corespernode :<min>[-<max>] | Spécifie le nombre minimal et, éventuellement, le nombre maximal de cœurs qu’un nœud peut avoir pour le service planificateur de travaux HPC pour considérer le nœud comme un nœud candidat sur lequel exécuter le travail. Le travail ne s’exécute pas sur un nœud qui a moins de cœurs que la valeur minimale ou plus de cœurs que la valeur maximale spécifiée par ce paramètre. Si tous les nœuds du cluster ont un certain nombre de cœurs qui se trouvent en dehors de la plage que vous spécifiez pour ce paramètre, une erreur se produit lorsque vous envoyez le travail. |
| /customproperties :<property_list> | Spécifie les propriétés personnalisées du travail dans un format de <name1>=<value1>[ ;<name2>=<value2>...]. Les propriétés personnalisées ne respectent pas la casse et reflètent le cas utilisé lors de leur première définition. Ce paramètre a été introduit dans HPC Pack 2012 et n’est pas pris en charge dans les versions précédentes. |
| /emailaddress :<adresse> | Envoie des notifications pour ce travail à cette adresse. Ce paramètre a été introduit dans HPC Pack 2012 et n’est pas pris en charge dans les versions précédentes. |
| /env :<variable_and_value_list> | Spécifie une liste de variables d’environnement à définir dans l’environnement d’exécution de la tâche et les valeurs à affecter à ces variables d’environnement. La liste doit avoir un format de <variable_name1>=<valeur1> [ ;<variable_name2>=<valeur2>.]. Vous pouvez également définir plusieurs variables d’environnement en incluant plusieurs paramètres /env. Chaque argument doit être différent avec un format de <variable_name>=<valeur>. Pour annuler la définition d’une variable d’environnement, ne spécifiez pas de valeur. Par exemple, <variable_to_unset_name>=. |
| /estimatedprocessmemory :<mémoire> | La quantité maximale de mémoire en mégaoctets (Mo) que chaque processus de ce travail est estimé à consommer. |
| /exclusive[ :{true|false}] | Spécifie si le service du planificateur de travaux HPC doit s’assurer qu’aucun autre travail ne s’exécute sur le même nœud que ce travail pendant l’exécution de ce travail. La valeur True indique que le service hpC Job Scheduler doit s’assurer qu’aucun autre travail ne s’exécute sur le même nœud pendant l’exécution de ce travail. La valeur False indique que ce travail peut partager des nœuds de calcul avec d’autres travaux. Lorsque vous spécifiez le paramètre /exclusive sans valeur, le travail envoyer commande se comporte comme si vous avez spécifié une valeur true. Si vous ne spécifiez pas le paramètre /exclusive, le travail envoyer commande se comporte comme si vous avez spécifié la valeur False. |
| /faildependenttasks[ :{true|false}] | Spécifie que si une tâche échoue ou est annulée, toutes les tâches dépendantes échouent. Si /faildependenttasks est déclaré, mais qu’aucune valeur n’est donnée, la valeur True est supposée. Si /faildependenttasks n’est pas déclaré, false est supposé. Ce paramètre a été introduit dans HPC Pack 2012 et n’est pas pris en charge dans les versions précédentes. |
| /failontaskfailure[ :{true|false}] | Spécifie si le service du planificateur de travaux HPC doit arrêter le travail et échouer immédiatement lors de l’échec d’une tâche dans le travail. La valeur True indique que le service hpC Job Scheduler doit arrêter le travail et échouer immédiatement lorsqu’une tâche dans le travail échoue. La valeur False indique que le service du planificateur de travaux HPC doit continuer à exécuter le reste des tâches du travail après l’échec d’une tâche dans le travail. Lorsque vous spécifiez le paramètre /failontaskfailure |
| /holduntil :[{<DateTime>|<minutes>}] | Spécifie la date et l’heure dans l’heure locale ou le nombre de minutes jusqu’à ce que le service du planificateur de travaux HPC attende avant d’essayer de démarrer le travail. Si ce paramètre n’est pas défini, le travail peut démarrer lorsque les ressources sont disponibles. Le service hpC Job Scheduler exécute uniquement le travail à la date et à l’heure que ce paramètre spécifie si les ressources nécessaires pour le travail sont disponibles. Si les ressources nécessaires pour le travail ne sont pas disponibles à cette date et à cette heure, le travail reste mis en file d’attente jusqu’à ce que les ressources nécessaires soient disponibles. Vous pouvez spécifier la date et l’heure dans n’importe quel format que le .NET Framework peut analyser pour la culture actuelle du système d’exploitation. Pour plus d’informations sur la façon dont .NET Framework analyse les chaînes de date et d’heure, consultez analyse des chaînes de date et d’heure. Vous pouvez spécifier le paramètre /holduntil pour un travail tant que le travail n’est pas en cours d’exécution ou terminé. L’heure spécifiée à l’aide de /holduntil est convertie en interne en UTC et ne reflète pas l’heure d’été locale. Si la valeur minutes est utilisée, elle doit être un entier. Les minutes de conservation sont converties en UTC au moment où travail modifie est appliquée. Si la valeur de /holduntil est vide, toute valeur holduntil actuelle est effacée et le travail n’est plus en attente en raison de ce paramètre. Ce paramètre a été introduit dans HPC Pack 2012 et n’est pas pris en charge dans les versions précédentes. |
| /jobenv :<variable_and_value_list> | Spécifie les variables d’environnement que vous souhaitez définir dans l’environnement d’exécution du travail et les valeurs auxquelles vous souhaitez définir ces variables d’environnement. La liste doit avoir un format de <variable_name1>=<valeur1> [ ;<variable_name2>=<valeur2>...]. Vous pouvez également définir plusieurs variables d’environnement en incluant plusieurs paramètres /jobenv, chacun avec un argument différent avec le format <variable_name>=<valeur>. Pour annuler la définition d’une variable d’environnement, ne spécifiez pas de valeur. Par exemple, «<variable_to_unset_name>= ». Si vous définissez ou annulez la définition d’une variable d’environnement pour un travail, cette variable d’environnement est également définie ou non pour chaque tâche du travail, sauf si vous remplacez ce paramètre de variable d’environnement pour la tâche en spécifiant un nouveau paramètre avec le paramètre /env. Ce paramètre a été introduit dans HPC Pack 2008 R2 et n’est pas pris en charge dans les versions précédentes. |
| /jobname :<job_name> | Spécifie un nom à utiliser pour ce travail dans la sortie de commande et dans l’interface utilisateur. La longueur maximale du nom d’un travail est de 80 caractères. |
| /jobtemplate :<job_template_name> | Spécifie le nom du modèle de travail à utiliser pour le travail. La longueur maximale pour le nom d’un modèle de travail est de 80 caractères. Par défaut, le travail envoyer commande utilise le modèle de travail par défaut pour le nouveau travail. |
| /license :<license_list> | Spécifie une liste des fonctionnalités pour lesquelles le travail nécessite des licences et le nombre de licences requises pour chacun d’eux. Utilisez un format de <license_name1>:<nombre1> [,<license_name2>:<nombre2>...] pour cette liste.
<number..> peut être n’importe quel entier positif, ou * qui demande le même nombre de licences que les cœurs, les sockets ou les nœuds affectés au travail. Par exemple, /license1:10,license2 :* signifie 10 licences de licence1 et N de licences à partir de licence2 où N est lié au nombre de cœurs, de nœuds ou de sockets associés au travail en cours d’envoi. La liste a une longueur maximale de 160 caractères. |
| /memorypernode :<min>[-<max>] | Spécifie le minimum et, éventuellement, la quantité maximale de mémoire en mégaoctets (Mo) qu’un nœud peut avoir pour le service planificateur de travaux HPC pour considérer le nœud comme un nœud candidat sur lequel exécuter le travail. Le travail ne s’exécute pas sur un nœud qui a moins de mémoire que la valeur minimale ou plus de mémoire que la valeur maximale spécifiée par ce paramètre. Si tous les nœuds du cluster ont une quantité de mémoire qui se trouve en dehors de la plage que vous spécifiez pour ce paramètre, une erreur se produit lorsque vous envoyez le travail. |
| /name :<task_name> | Spécifie un nom à utiliser pour cette tâche dans la sortie de commande et dans l’interface utilisateur. La longueur maximale du nom d’une tâche est de 80 caractères. |
| /nodegroup :<node_group_list> | Spécifie la liste des groupes de nœuds sur lesquels ce travail peut s’exécuter au format <node_group1_name>[,<node_group2_name>...]. Le service HPC Job Scheduler alloue des ressources au travail à partir de nœuds appartenant à tous les groupes de nœuds de la liste par défaut, ou aux nœuds résultant de l’opération du paramètre /nodegroupop, le cas échéant, dans la liste des groupes. Si vous spécifiez des valeurs pour les Le paramètre /nodegroup garantit qu’il existe des nœuds dans la liste de nœuds valide. Toutefois, si les besoins en ressources d’un travail à partir du paramètre ci-dessus ne peuvent pas être remplis à partir de la liste des nœuds, le travail échoue lors de l’envoi du travail. Si vous spécifiez le paramètre |
| /nodegroupop :{Intersect|Uniforme|Union} | Spécifie l’opérateur de la liste spécifiée par le paramètre /nodegroup Intersect : crée la liste des nœuds qui se trouvent dans tous les groupes de nœuds répertoriés. Uniforme : provoque le service hpC Job Scheduler pour essayer les groupes de nœuds dans l’ordre. S’il existe suffisamment de ressources dans le premier groupe de nœuds, elles sont utilisées. Si ce n’est pas le cas, le Planificateur tente chaque groupe de nœuds suivant jusqu’à ce qu’il en trouve un avec suffisamment de ressources. Si suffisamment de ressources sont introuvables, le travail reste en file d’attente. Union : crée la liste des nœuds qui se trouvent dans l’un des groupes de nœuds. La valeur par défaut de ce paramètre est Intersect. Ce paramètre a été introduit dans HPC Pack 2012 et n’est pas pris en charge dans les versions précédentes. |
| /notifyoncompletion[ :{true|false}] | Spécifie si le service hpC Job Scheduler doit envoyer une notification par e-mail lorsque le travail se termine. La valeur True indique que le service hpC Job Scheduler doit envoyer une notification par e-mail lorsque le travail se termine. La valeur False indique que le service hpC Job Scheduler ne doit pas envoyer de notification par e-mail lorsque le travail se termine. Une tâche se termine et une notification est envoyée lorsque l’état du travail passe à Finished, Failed ou Canceled. Un administrateur de cluster doit configurer la notification pour le cluster HPC avant de pouvoir recevoir une notification sur un travail. Lorsque vous spécifiez le paramètre /notifyoncompletion Ce paramètre a été introduit dans HPC Pack 2008 R2 et n’est pas pris en charge dans les versions précédentes. |
| /notifyonstart[ :{true|false}] | Spécifie si le service hpC Job Scheduler doit envoyer une notification par e-mail au démarrage du travail. La valeur True indique que le service hpC Job Scheduler doit envoyer une notification par e-mail au démarrage du travail. La valeur False indique que le service du planificateur de travaux HPC ne doit pas envoyer de notification par e-mail au démarrage du travail. Un administrateur de cluster doit configurer la notification pour le cluster HPC avant de pouvoir recevoir une notification sur un travail. Lorsque vous spécifiez le paramètre /notifyon start sans valeur, la commande nouveau travail se comporte comme si vous avez spécifié la valeur True. Si vous ne spécifiez pas le paramètre /notifyonstart, ce paramètre a été introduit dans HPC Pack 2008 R2 et n’est pas pris en charge dans les versions précédentes. tâche nouvelle commande se comporte comme si vous avez spécifié la valeur False. Ce paramètre a été introduit dans HPC Pack 2008 R2 et n’est pas pris en charge dans les versions précédentes. |
| /numcores :<min>[-<max>] | Spécifie le nombre global de cœurs dans le cluster HPC requis par le travail au format <minimum>[-<>maximale ]. Le travail s’exécute sur au moins le nombre minimal de cœurs et sur pas plus que le nombre maximal. Si vous spécifiez une seule valeur, cette commande définit le nombre maximal et minimal de cœurs sur cette valeur. Si vous spécifiez une valeur minimale qui dépasse le nombre total de cœurs disponibles sur le cluster, une erreur se produit lorsque vous envoyez le travail. Les valeurs minimales et maximales ne peuvent être que des entiers positifs ou un astérisque (*). Si vous spécifiez la valeur minimale ou maximale en tant qu’astérisque, le service hpC Job Scheduler calcule automatiquement le nombre minimal ou maximal de cœurs au moment de l’exécution en fonction du nombre minimal et maximal de cœurs pour les tâches du travail. Vous ne pouvez pas spécifier le paramètre /numcores |
| /numnodes :<min>[-<max>] | Spécifie le nombre global de nœuds sur le cluster HPC requis par le travail au format <>minimale [-<>maximale]. Le travail s’exécute sur au moins le nombre minimal de nœuds et pas plus que le nombre maximal. Si vous spécifiez une seule valeur, cette commande définit à la fois le nombre maximal et minimal de nœuds sur cette valeur. Si vous spécifiez une valeur minimale qui dépasse le nombre total de nœuds disponibles sur le cluster, une erreur se produit lorsque vous envoyez le travail. Les valeurs minimales et maximales ne peuvent être que des entiers positifs ou un astérisque (*). Si vous spécifiez la valeur minimale ou maximale en tant qu’astérisque, le service hpC Job Scheduler calcule automatiquement le nombre minimal ou maximal de nœuds au moment de l’exécution en fonction du nombre minimal et maximal de nœuds pour les tâches du travail. Vous ne pouvez pas spécifier le paramètre /numnodes |
| /numprocessors :<min>[-<max>] | Déconseillé. Utilisez plutôt le paramètre /numcores. |
| /numsockets :<min>[-<max>] | Spécifie le nombre global de sockets sur le cluster HPC requis par le travail au format <>minimale [-<>maximale ]. Le travail s’exécute sur au moins le nombre minimal de sockets et pas plus que le nombre maximal. Si vous spécifiez une seule valeur, cette commande définit à la fois le nombre maximal et minimal de sockets sur cette valeur. Si vous spécifiez une valeur minimale qui dépasse le nombre total de sockets disponibles sur le cluster, une erreur se produit lorsque vous envoyez le travail. Les valeurs minimales et maximales ne peuvent être que des entiers positifs ou un astérisque (*). Si vous spécifiez la valeur minimale ou maximale en tant qu’astérisque, le service hpC Job Scheduler calcule automatiquement le nombre minimal ou maximal de sockets au moment de l’exécution en fonction du nombre minimal et maximal de sockets pour les tâches du travail. Vous ne pouvez pas spécifier le paramètre /numsockets |
| /orderby :<>principal [,<>secondaire ] | Spécifie l’ordre que le service du planificateur de travaux HPC doit utiliser pour allouer des nœuds au travail au format <primary_order>[,<secondary_order>]. Les parties primary_order et secondary_order de la valeur peuvent chacune être l’une des valeurs suivantes : mémoire : le service hpC Job Scheduler trie les nœuds en fonction de la quantité de mémoire qu’ils ont disponible et alloue le travail aux nœuds avec plus de mémoire en premier. -memory : le service hpC Job Scheduler trie les nœuds en fonction de la quantité de mémoire qu’ils ont disponible et alloue le travail aux nœuds avec moins de mémoire. cœurs : le service HPC Job Scheduler trie les nœuds en fonction du nombre de cœurs qu’ils ont disponibles et alloue le travail aux nœuds avec d’autres cœurs en premier. -cores - Le service HPC Job Scheduler trie les nœuds en fonction du nombre de cœurs qu’ils ont disponibles et alloue le travail aux nœuds avec moins de cœurs en premier. Lorsque vous spécifiez un ordre secondaire, le service hpC Job Scheduler trie les nœuds en fonction de l’ordre principal en premier. Pour les sous-ensembles de nœuds qui ont la même quantité de ressource que l’ordre principal spécifié, le service hpC Job Scheduler trie ensuite les nœuds au sein du sous-ensemble à l’aide de l’ordre de tri secondaire. Par exemple, si vous spécifiez de la mémoire, des cœurs, le service hpC Job Scheduler trie les nœuds de la quantité de mémoire la plus élevée à la plus faible. Ensuite, pour les sous-ensembles de nœuds qui ont la même quantité de mémoire, le service HPC Job Scheduler utilise le nombre de cœurs pour rompre le lien et trie les nœuds qui ont la même quantité de mémoire du nombre le plus petit de cœurs au plus grand nombre. L’ordre principal et l’ordre secondaire doivent faire référence à différents types de ressources. Par exemple, la mémoire, les cœurs sont une combinaison valide de commandes de tri primaire et secondaire. Les combinaisons telles que la mémoire, la mémoire et les cœurs ne sont pas valides. L’ordre par défaut que le service hpC Job Scheduler utilise pour allouer des nœuds à un travail est des cœurs, de la mémoire. |
| /parametric :<index_specification> | Indique que la nouvelle tâche est une tâche paramétrique. Une tâche paramétrique exécute la commande spécifiée plusieurs fois, en remplaçant la valeur d’index actuelle pour les astérisques (*) dans la ligne de commande. L’astérisque est également substitué lorsqu’il est spécifié dans le /stdin, /stdoutet /stderr paramètres. La spécification d’index de ce paramètre définit le comportement de la valeur d’index. Le format de la spécification d’index est [<start>-]<end>[ :<incrément>]. La valeur d’index actuelle commence à l’index de départ et augmente par la valeur d’incrément chaque fois que la commande s’exécute. Lorsque l’index actuel dépasse l’index de fin, la tâche cesse d’exécuter la commande. L’index de départ doit être inférieur à l’index de fin, et la valeur d’incrément doit être un entier positif. |
| /parentjobids : <jobID_list> | Spécifie la liste des ID de travail dont le travail dépend dans un format de <jobID1>[,<jobID2>...]. Les ID de travail doivent déjà exister. Le service planificateur de travaux HPC planifie le travail uniquement lorsque ses travaux parents sont terminés et sont tous dans un état terminé. Si un travail parent n’a pas terminé ou s’est terminé, mais qu’il est dans un état Annulé ou Ayant échoué, le travail reste mis en file d’attente. Ce paramètre a été introduit dans HPC Pack 2012 et n’est pas pris en charge dans les versions précédentes. |
| /password :<mot de passe> | Spécifie le mot de passe du compte sous lequel le travail doit s’exécuter. Si vous spécifiez le paramètre /user, mais pas le paramètre /password, le travail envoyer commande vous invite à entrer le mot de passe et à stocker le mot de passe. |
| /priority :<> de priorité | Spécifie la priorité pour la planification du travail. Pour Windows HPC Server 2008, la valeur de priorité ne peut être que l’une des valeurs nommées suivantes : Plus haut, AboveNormal, Normal, BelowNormal ou Lowest. Pour Windows HPC Server 2008 R2, vous pouvez utiliser l’une des cinq valeurs de priorité nommées que vous pouvez utiliser dans Windows HPC Server 2008. Vous pouvez également utiliser n’importe quel nombre compris entre 0 et 4000, avec 0 comme priorité la plus basse et 4 000 comme le plus élevé. Vous pouvez également spécifier la valeur de priorité comme named_value+décalage ou named_value-offset. Dans le cadre de ces formats finaux, les priorités nommées ont les valeurs du tableau suivant, et la combinaison de la valeur nommée et des décalages ne peut pas être inférieure à 0 ou supérieure à 4000. Maximum- 4000 AboveNormal - 3000 Normal - 2000 BelowNormal - 1000 Le plus bas - 0 Le modèle de travail que le travail utilise spécifie les autorisations qui affectent qui peuvent spécifier des priorités élevées. Le service HpC Job Scheduler place les travaux avec la même priorité dans la file d’attente de travaux dans l’ordre dans lequel les utilisateurs envoient les travaux, sauf si un utilisateur requeue un travail. Si un utilisateur requeue un travail, le service du planificateur de travaux HPC place ce travail d’abord parmi les travaux ayant la même priorité. La priorité par défaut d’un travail est Normale ou 2000. |
| /progress :<percent_progress> | Spécifie le pourcentage du travail terminé. Cette valeur doit être comprise entre 0 et 100. Si vous ne définissez pas la valeur de cette propriété, le service HPC Job Scheduler calcule la progression en fonction du pourcentage de tâches terminées pour le travail. Lorsque vous définissez cette propriété pour un travail, le service HpC Job Scheduler ne continue pas à mettre à jour cette propriété. Vous devez donc continuer à mettre à jour la propriété à l’aide de la commande tâche de modification. Ce paramètre a été introduit dans HPC Pack 2008 R2 et n’est pas pris en charge dans les versions précédentes. |
| /progressmsg :<message> | Spécifie un message d’état personnalisé que vous souhaitez afficher pour le travail. La longueur maximale de cette chaîne est de 80 caractères. Pour spécifier un message d’état qui inclut des espaces, placez le message d’état entre guillemets ("). Ce paramètre a été introduit dans HPC Pack 2008 R2 et n’est pas pris en charge dans les versions précédentes. |
| /projectname :<nom> | Spécifie un nom de projet pour le travail que vous pouvez utiliser pour le suivi des travaux. La longueur maximale du nom du projet est de 80 caractères. |
| /requestednodes :<node_list> | Spécifie une liste de noms pour les nœuds sur lesquels le travail peut s’exécuter, dans un format de <node1_name>[,<node2_name>...]. Ces nœuds sont des candidats au travail, mais tous les nœuds n’exécutent pas nécessairement le travail si les ressources disponibles sur ces nœuds dépassent les ressources requises par le travail. Le service hpC Job Scheduler alloue les nœuds principaux en fonction de la valeur du paramètre /orderby jusqu’à ce que les nœuds alloués répondent à la valeur spécifiée avec les /numcores, /numsockets, /numprocessorsou paramètre /numnodes. Si vous ne spécifiez pas le paramètre /requestednodes, le service HPC Job Scheduler considère tous les nœuds comme candidats que le service hpC Job Scheduler peut allouer au travail. Si vous spécifiez des valeurs pour les |
| /rerunnable[ :{true|false}] | Spécifie si le service du planificateur de travaux HPC tente de réexécuter la tâche si la tâche s’exécute et échoue. La valeur True indique que le service hpC Job Scheduler peut tenter de réexécuter la tâche si la tâche est préemptée ou si elle échoue en raison d’un problème de cluster, tel qu’un nœud devient inaccessible. Le planificateur de travaux n’essaie pas de réexécuter les tâches qui s’exécutent à la fin et retournent un code de sortie non réussi. La valeur False indique que le service hpC Job Scheduler ne doit pas tenter de réexécuter la tâche si la tâche commence, mais n’est pas terminée en raison de problèmes de préemption ou de cluster. Au lieu de cela, il doit déplacer la tâche vers l’état d’échec immédiatement. L’administrateur de cluster peut configurer le nombre de fois où le service hpC Job Scheduler tente de réexécuter une tâche réexécuter avant de déplacer la tâche vers l’état d’échec. Si vous ne spécifiez pas le paramètre /rerunnable, la commande se comporte comme si vous avez spécifié la valeur True. |
| /runtime :{<heure> | Infini} | Spécifie la durée maximale pendant laquelle le travail doit s’exécuter. Une fois le travail exécuté pendant ce délai, le service du planificateur de travaux HPC annule le travail. Vous spécifiez la durée au format [[<jours>:]<heures>:]<minutes>. Vous pouvez également spécifier Infinite pour indiquer que le travail peut s’exécuter pendant une durée illimitée. Si vous spécifiez une seule partie du format [[<jours>:]<heures>:]<format> minutes, la commande interprète la valeur spécifiée comme le nombre de minutes. Par exemple, 12 indique 12 minutes. Si vous spécifiez deux parties du format, la commande interprète la partie gauche en tant qu’heures et la partie droite sous forme de minutes. Par exemple, 10:30 indique 10 heures et 30 minutes. Vous pouvez utiliser un ou plusieurs chiffres pour chaque partie du format. La valeur maximale de chaque partie est de 2 147 483 647. Si vous ne spécifiez pas le paramètre /runtime, la valeur par défaut est Infinite. |
| /rununtilcanceled[ :{true|false}] | Spécifie si le travail continue d’exécuter et de contenir des ressources jusqu’à ce que la limite d’exécution expire ou qu’une personne annule le travail. La valeur True indique que le travail continue d’exécuter et de contenir des ressources jusqu’à l’expiration de la limite d’exécution ou qu’une personne annule le travail. Si vous spécifiez la valeur True, vous devez spécifier des valeurs minimales et maximales pour les/numcores La valeur False indique que le travail doit arrêter et libérer ses ressources lorsque toutes les tâches du travail sont terminées. Lorsque vous spécifiez le paramètre |
| /scheduler :<nom> | Spécifie le nom d’hôte ou l’adresse IP du nœud principal du cluster sur lequel vous souhaitez envoyer la tâche. La valeur doit être un nom d’ordinateur ou une adresse IP valide. Si vous ne spécifiez pas le paramètre /scheduler, cette commande utilise le planificateur sur le nœud principal spécifié par la variable d’environnement CCP_SCHEDULER. |
| /singlenode[ :{true|false}] | Spécifie que toutes les ressources seront allouées sur un nœud. Si /singlenode est déclaré, mais qu’aucune valeur n’est donnée, la valeur True est supposée. Si /singlenode n’est pas déclaré, false est supposé. Ce paramètre a été introduit dans HPC Pack 2012 et n’est pas pris en charge dans les versions précédentes. |
| /stderr :[ chemin d’accès<>\]<file_name> | Spécifie le nom du fichier vers lequel la tâche doit rediriger le flux d’erreur standard, y compris le chemin complet ou le chemin d’accès relatif au répertoire de travail du fichier si la tâche ne doit pas rediriger le flux d’erreur standard vers un fichier du répertoire de travail. Si vous spécifiez un chemin qui n’existe pas, la tâche échoue. Si vous ne spécifiez pas le paramètre /stderr La longueur maximale de cette valeur pour ce paramètre est de 160 caractères. |
| /stdin :[ chemin d’accès<>\]<file_name> | Spécifie le nom du fichier à partir duquel la tâche doit recevoir une entrée standard, y compris le chemin d’accès complet ou le chemin d’accès relatif au répertoire de travail du fichier si la tâche ne doit pas recevoir d’entrée standard d’un fichier dans le répertoire de travail. Si vous spécifiez un fichier ou un chemin qui n’existe pas, la tâche échoue. La longueur maximale de cette valeur pour ce paramètre est de 160 caractères. |
| /stdout :[ chemin d’accès<>\]<file_name> | Spécifie le nom du fichier vers lequel la tâche doit rediriger la sortie standard, y compris le chemin complet ou le chemin d’accès relatif au répertoire de travail du fichier si la tâche ne doit pas rediriger la sortie standard vers un fichier dans le répertoire de travail. Si vous spécifiez un chemin qui n’existe pas, la tâche échoue. Si vous ne spécifiez pas le paramètre La longueur maximale de cette valeur pour ce paramètre est de 160 caractères. |
| /taskexecutionfailureretrylimit :<retry_limit> | Spécifie le nombre maximal de fois qu’une tâche dans ce travail autre qu’une tâche de préparation de nœud ou de mise en production de nœud est automatiquement mise en file d’attente après un échec d’exécution de l’application. Ce paramètre a été introduit dans HPC Pack 2012 R2 Update 1. Il n’est pas disponible dans les versions précédentes. |
| /type :<type_name> | Spécifie un type pour la tâche, qui définit comment exécuter la commande pour la tâche. Voici les types que vous pouvez spécifier : Basique- Exécute une instance unique d’une application série ou d’une application MPI (Message Passing Interface). Une application MPI s’exécute généralement simultanément sur plusieurs cœurs et peut s’étendre sur plusieurs nœuds. NodePrep - Exécute une commande ou un script sur chaque nœud de calcul tel qu’il est alloué au travail. La tâche de préparation du nœud s’exécute sur un nœud avant toute autre tâche du travail. Si la tâche de préparation du nœud ne parvient pas à s’exécuter sur un nœud, ce nœud n’est pas ajouté au travail. NodeRelease - Exécute une commande ou un script sur chaque nœud de calcul tel qu’il est libéré du travail. Les tâches de mise en production de nœud s’exécutent lorsque le travail est annulé par l’utilisateur ou par une préemption appropriée. Les tâches de mise en production de nœud ne s’exécutent pas lorsque le travail est annulé par une préemption immédiate. ParametricSweep - annule une commande un nombre spécifié de fois, comme indiqué par les valeurs Start, End et Increment, généralement entre les fichiers d’entrée et de sortie indexés. Les étapes du balayage peuvent ou non s’exécuter en parallèle, en fonction des ressources disponibles sur le cluster HPC lorsque la tâche est en cours d’exécution. Lorsque vous spécifiez le type ParametricSweep, vous devez utiliser le paramètre /parametric pour spécifier les valeurs de début, de fin et d’incrémentation pour l’index. Si vous n’utilisez pas paramètre /parametric, la commande s’exécute une fois avec un index de 0. Service- Exécute une commande ou un service sur toutes les ressources affectées au travail. De nouvelles instances de la commande démarrent lorsque les nouvelles ressources sont ajoutées au travail, ou si une instance en cours d’exécution se ferme et si la ressource utilisée précédemment est toujours allouée au travail. Une tâche de service continue de démarrer de nouvelles instances jusqu’à ce que la tâche soit annulée, que la durée d’exécution maximale expire ou que le nombre maximal d’instances soit atteint. Une tâche de service peut créer jusqu’à 1 000 000 tâches subordonnées. Les tâches que vous envoyez via un client d’architecture orientée service (SOA) s’exécutent en tant que tâches de service. Vous ne pouvez pas ajouter une tâche de base ou une tâche de balayage paramétrique à un travail qui contient une tâche de service. La valeur par défaut de ce paramètre est De base, sauf si vous spécifiez également le paramètre /parametric. Si vous spécifiez le paramètre /parametric, la valeur par défaut du paramètre /type est ParametricSweep. Si vous spécifiez le paramètre /type avec une valeur autre que ParametricSweep, vous ne pouvez pas également spécifier le paramètre /parametric. Ce paramètre a été introduit dans HPC Pack 2008 R2 et n’est pas pris en charge dans les versions précédentes. |
| /workdir :<dossier> | Spécifie le répertoire de travail sous lequel la tâche doit s’exécuter. La longueur maximale de cette valeur pour ce paramètre est de 160 caractères. |
| <commande> [ paramètres<>] | Spécifie la ligne de commande de la tâche, y compris la commande ou le nom de l’application et tous les paramètres nécessaires. Sauf si elle est définie dans un fichier /taskfile fichier XML de tâche, une commande doit exister pour que la tâche soit ajoutée. La commande est exécutée par rapport au répertoire de travail, sauf s’il contient un chemin complet. |
| /user :[<domaine>\]<user_name>] | Spécifie le nom d’utilisateur et, éventuellement, le domaine du compte sous lequel le travail doit s’exécuter. Si vous ne spécifiez pas ce paramètre, le travail s’exécute sous le compte utilisé pour envoyer le travail. |
| /validexitcodes :{int|intStart.. intEnd} [,{int|intStart.. intEnd}]* | Spécifie les codes de sortie à utiliser pour vérifier si les tâches d’un travail se terminent correctement.
/validexitcodes doivent être spécifiés par des entiers discrets et des plages entières séparées par des virgules. min ou max peut être utilisé comme début ou fin d’une plage entière. Par exemple, 0..max représente tous les entiers non nénégatifs.Ce paramètre peut être substitué en déclarant les /validexitcodes paramètre spécifique à une tâche. Toutes les tâches qui n’ont pas ce paramètre explicitement déclaré hériteront du paramètre du travail. Si /validexitcodes n’est pas défini, 0 est le code de sortie valide par défaut. |
| /? | Affiche l’aide à l’invite de commandes. |
| /Aide | Affiche l’aide à l’invite de commandes. |
Remarques
Le travail envoyer commande comporte trois formulaires principaux. Les paramètres /password, /useret /scheduler sont communs aux trois formulaires.
La première forme de la commande inclut également le paramètre /id et envoie le travail existant qui a l’identificateur de travail spécifié.
La deuxième forme de la commande inclut le paramètre /jobfile en plus des paramètres communs. Ce formulaire crée un travail avec les paramètres et les tâches spécifiés par le fichier de travail, puis envoie immédiatement ce travail.
La troisième forme de la commande inclut les paramètres restants, à l’exception de ceux qui affichent un message d’aide à l’invite de commandes. Cette forme de commande crée un travail avec une tâche unique pour exécuter la commande spécifiée, puis envoie ce travail.
Une fois que vous avez envoyé le travail, le service HPC Job Scheduler valide le travail et entre le travail dans la file d’attente de travaux. Le service du planificateur de travaux HPC attend de démarrer le travail jusqu’à ce que les ressources suffisantes soient disponibles.
À compter de Windows HPC Server 2008 R2, vous pouvez spécifier que les astérisques (*) dans la ligne de commande d’une tâche paramétrique ne doivent pas être remplacées par la valeur actuelle de l’index paramétrique en précédant l’astérisque avec trois caractères (^). Par exemple, si vous utilisez le travail envoyer commande pour envoyer un travail avec une tâche paramétrique et spécifier la ligne de commande comme écho *, la tâche imprime les valeurs de l’index paramétrique. Si vous utilisez plutôt le travail ajouter commande pour créer une tâche paramétrique et spécifier la ligne de commande comme écho ^^^*, la tâche imprime un astérisque pour chaque valeur de l’index paramétrique.
Exemples
Pour envoyer le travail avec un identificateur de travail de 38, utilisez la commande suivante :
job submit 38
Pour créer un travail à l’aide des paramètres du fichier à C:\Jobs\MyJob.xml, puis envoyez immédiatement le travail, utilisez la commande suivante :
job submit /jobfile:C:\Jobs\MyJob.xml
Pour créer et envoyer un nouveau travail à tâche unique avec un type de travail de base, qui envoie une notification par e-mail au démarrage du travail et a un message d’état « Envoyé », et qui exécute la commande vol, utilisez la commande suivante :
job submit /notifyonstart:true /progressmsg:"Submitted" /type:Basic vol
Pour créer un travail, ajoutez une tâche au travail, puis envoyez le travail, exécutez un fichier de commandes qui inclut la commande suivante, qui utilise l'pour commande pour obtenir l’identificateur du nouveau travail :
for /f "usebackq tokens=4 delims=. " %%i in (`job new`) do (
job add %%i echo Hello World
job submit /id:%%i
)