Voir la source de Soumet : travaux par lots / batch jobs

== soumission facile de travaux par lots / an easy way to submit batch jobs<br>  ==

<br> 

'''ord_soumet'''&nbsp; my_job_file [arg1] [arg2] .... [argn]<br>'''/home/ordenv/ssm-domains/ssm-setup-1.0/multi/bin/ord_soumet''' my_job_file [arg1] [arg2] .... [argn] 

<br> 

ex:&nbsp; 

'''ord_soumet''' essai1 '''-mach''' saiph '''-t''' 500 '''-cpus''' 2x2x4 '''-jn''' experience001 '''-listing''' ~/listings/special 

{| cellspacing="2" cellpadding="10" width="100%" style="border: 0px none;"
|-
| width="50%" valign="top" style="background: none repeat scroll 0% 0% rgb(238, 255, 255); border: 0px solid rgb(170, 170, 170);" | ord_soumet est disponible directement dans l'environnement mais peut également être utilisé en mode autonome <br>N.B. une copie ne fonctionnera pas, mais on peu utiliser un "soft link" vers l'original <br>N.B. cette page a été empruntée a Environnement Canada Dorval, certains aramètres peuvent ne pas s'appliquer 
| valign="top" style="background: none repeat scroll 0% 0% rgb(255, 255, 238); border: 0px solid rgb(170, 170, 170);" | ord_soumet is automatically available to all users of the i environment but may also be used in stand-alone mode<br>N.B. a copy of ord_soumet will not work but a soft link to it will <br>N.B. This page has been borrowed from Environment Canada in Dorval, some parameters might not be applicable
|}

== arguments  ==

=== Liste des arguments / argument list  ===

{| width="100%" cellspacing="2" cellpadding="10" style="border: 0px none;"
|-
| width="50%" valign="top" style="background: none repeat scroll 0% 0% rgb(238, 255, 255); border: 0px solid rgb(170, 170, 170);" | le nom des arguments les plus courants est en caractères gras, '''<u>les cellules colorées</u>''' représentent des arguments '''non reconnus par ord_soumet''',<br>mais potentiellement reconnus par '''ord_soumet_alpha''' et/ou '''ord_soumet_beta''' (certaines options ne fonctionnent q'avec [[Login-Profile|le '''nouvel''' environnement]] ) 
'''NOTE&nbsp;:''' si la première ligne du fichier soumis commence par '''#ord_soumet=''' , le reste de la ligne sera ajouté aux arguments de soumet, ce qui permet au fichier soumis de contenir à l'avance certains paramètres de soumission 

| valign="top" style="background: none repeat scroll 0% 0% rgb(255, 255, 238); border: 0px solid rgb(170, 170, 170);" | the names of the most frequent arguments are highlighted, '''<u>the colored cells</u>''' reflect '''pre-release''' features '''not recognized yet by ord_soumet''' <br>but that may be recognized by '''ord_soumet_beta''' and/or '''ord_soumet_alpha''' (some features will only work with [[Login-Profile|the '''new''' environment]] ) 
'''NOTE&nbsp;:''' if the first line of the submitted job file starts with '''#ord_soumet=''' , the remainder of the line is added to the ord_soumet arguments, allowing the job to contain some of its submission parameters beforehand. 

|}

'''EX:''' #ord_soumet= -t 500 -mpi -cpus 3x4 -cm 2G 

<br> 

{| width="1119" cellspacing="1" cellpadding="1" border="1" align="left" class="wikitable" style=""
|-
! width="10%" align="center" | argument<br>/<br>VARIABLE<br> 
! width="10%" | def1<br> 
! width="10%" | def2<br> 
! width="10%" | notes 
! width="30%" | description<br> 
! width="30%" | exemples / examples<br>
|-
| width="10%" bgcolor="#ffffff" align="center" | FORCE_BATCH 
| width="10%" bgcolor="#ffffff" align="center" | <br> 
| width="10%" bgcolor="#ffffff" align="center" | <br> 
| width="10%" bgcolor="#ffffff" align="center" | <br> 
| width="10%" bgcolor="#ffffff" align="center" | ignorer l'argument -sys et utiliser la valeur de cette variable d'environnement<br><br>ignore -sys argument and use this value instead 
| width="10%" bgcolor="#ffffff" align="center" | export FORCE_BATCH=batch_devel
|-
| width="10%" bgcolor="#ffffff" align="center" | SOUMET_EXTRAS<br> 
| width="10%" bgcolor="#ffffff" align="center" | <br> 
| width="10%" bgcolor="#ffffff" align="center" | <br> 
| width="10%" bgcolor="#ffffff" align="center" | <br> 
| width="10%" bgcolor="#ffffff" align="center" | 
ajouter a la ligne d'appel comme si l'usager l'avait tapé 

add to command line as if typed by user<br> 

| width="10%" bgcolor="#ffffff" align="center" | export SOUMET_EXTRAS="-account xx-ab-01"<br>
|-
| width="10%" align="center" | -account 
| width="10%" align="center" | 
| width="10%" align="center" | 
| width="10%" | colosse only 
| width="30%" | compte de l'usager sur colosse<br>user account on colosse 
| width="30%" | -account xxx-abc-01
|-
| width="10%" align="center" | -addstep'''<br>''' 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | addstep<br> 
| width="10%" | LL only 
| width="30%" | <br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -args / -o<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" | <br> 
| width="30%" | arguments positionnels disponibles dans le travail<br><br>positional arguments made available in the job<br> 
| width="30%" | -args a1 b2 c2<br>$1 donnera a1, $2 donnera b2, $3 donnera c2<br><br>$1 will be a1, $2 will be b2, $3 will be c2
|-
| width="10%" align="center" | -as<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" | <br> 
| width="30%" | soumettre un travail en utilisant un autre nom d'usager (demande les bonnes clés dans authorized_keys)<br><br>submit a job using another user name ( proper keys must be found in authorized_keys) 
| width="30%" | -as <u>otheruser</u><br>le travail sera soumis comme l'usager <u>otheruser</u><br><br>the job will be submitted as if submitted by <u>otheruser</u>
|-
! width="10%" align="center" | -c / -cpus<br> 
| width="10%" align="center" | 1<br> 
| width="10%" align="center" | 1<br> 
| width="10%" | MxNxP 
| width="30%" | nombre de CPUs nécessaires pour le travail<br><br>number of CPUs necessary for the job 
| width="30%" | -cpus 4x15x4&nbsp;&nbsp; (60 MPI tiles, 4 way OpenMP)<br>
|-
| width="10%" align="center" | -clone<br> 
| width="10%" align="center" | 0<br> 
| width="10%" align="center" | 100<br> 
| width="10%" | <br> 
| width="30%" | activer la soumission clonée (pas plus de NN fois)<br><br>activate cloned submission (up to NN times) 
| width="30%" | -clone 23<br>
|-
! width="10%" align="center" | -cm / -m<br> 
| width="10%" align="center" | 100M<br> 
| width="10%" align="center" | 100M<br> 
| width="10%" | souvent ignoré<br>often ignored 
| width="30%" | quantité de mémoire vive nécessaire pour le travail<br>(la valeur est imposée à 3.5GB/cpu pour IBM)<br><br>amount of main memory needed for the job<br>(value forced at 3.5GB/cpu on IBM) 
| width="30%" | ssh zeta&nbsp;&nbsp; -cm 350M<br>
|-
| width="10%" align="center" | -coschedule 
| width="10%" align="center" | <br> 
| width="10%" align="center" | <br> 
| width="10%" | LL only 
| width="30%" | job with coscheduled job steps 
| width="30%" | travail avec étapes en mode "coschedule"
|-
| width="10%" align="center" | -custom<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" | <br> 
| width="30%" | answer to the .profile_switch question for batch jobs<br><br>réponse à la question posée par .profile_switch por les travaux batch<br> 
| width="30%" | -custom alternate<br>-custom y<br>-custom n<br>
|-
! width="10%" align="center" | -d / -mach<br> 
| width="10%" align="center" | $TRUE_HOST<br> 
| width="10%" align="center" | $TRUE_HOST<br> 
| width="10%" | (localhost) 
| width="30%" | machine ou grappe sur laquelle on désire exécuter le travail<br><br>machine or cluster the job is to execute on<br> 
| width="30%" | -mach alef<br>-mach zeta<br>
|-
| width="10%" align="center" | -display<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | $DISPLAY<br> 
| width="10%" | <br> 
| width="30%" | utilisé si le travail doit afficher quelque chose sur un écran XWindows (habituellement utilisé avec -xterm)<br><br>used if job must use XWindows to display on a workstation (often used with -xterm) 
| width="30%" | -display monposte:0<br>
|-
| width="10%" align="center" | -e<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | e<br> 
| width="10%" | <br> 
| width="30%" | causer un avortement du travail à la première erreur si -e spécifié<br><br>job will be aborted at the first error if -e specified 
| width="30%" | <br>
|-
| width="10%" align="center" | -epilog 
| width="10%" align="center" | NULL 
| width="10%" align="center" | NULL 
| width="10%" | <br> 
| width="30%" | job epilog to be inserted in job 
| width="30%" | -epilog iomonitor (activate io monitor, experimental)<br>
|-
| width="10%" align="center" | -firststep<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | lajob_steps<br> 
| width="10%" | LL only 
| width="30%" | this is the first step of a coschduled job<br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -geom 
| width="10%" align="center" | NULL 
| width="10%" align="center" | NULL 
| width="10%" | LL&nbsp;only 
| width="10%" | fichier contenant la géométrie MPI&nbsp;du travail tel que le paramètre task_geometry de LoadLeveler le demande<br><br>file containing the MPI&nbsp;geometry in the format needed for the task_geometry LoadLeveler parameter 
| width="10%" | <br>
|-
| width="10%" align="center" | -h 
| width="10%" align="center" | <br> 
| width="10%" align="center" | <br> 
| width="10%" | <br> 
| width="30%" | texte d'aide<br><br>help text 
| width="30%" | <br>
|-
| width="10%" align="center" | -immediate<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | immediate<br> 
| width="10%" | <br> 
| width="30%" | exécution immédiate via ssh sans passer par le sous-système batch (travaux TRÈS PETITS seulement)<br><br>immediate execution with ssh without going through the batch subsystem (VERY&nbsp;SMALL jobs only) 
| width="30%" | <br>
|-
| width="10%" align="center" | -iojob 
| width="10%" align="center" | 1 
| width="10%" align="center" | 5 
| width="10%" | <br> 
| width="30%" | quantité d'entrées/sorties dans le travail (1-10)<br><br>amount of I/O in job (1-10) 
| width="30%" | -iojob 0&nbsp;&nbsp; (almost no I/O)<br>-iojob 10&nbsp;&nbsp; (a real I/O&nbsp;hog)
|-
! width="10%" align="center" | -jn<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" | <br> 
| width="30%" | nom que l'on désire donner au travail (utilisé pour créer le nom du fichier contenant le listing) si -jn est absent, le nom du fichier contenant le travail sera utilisé<br><br>job name (used for listing file name). if -jn is not specified, the name of the submitted file will be used<br> 
| width="30%" | -jn essai_no_2<br>
|-
| width="10%" align="center" | -jobcfg<br> 
| width="10%" align="center" | /dev/null<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" | <br> 
| width="30%" | <br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -jobfile<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | NUL 
| width="10%" | <br> 
| width="30%" | autre manière de donner le fichier à soumettre<br><br>alternate method to submit a file<br> 
| width="30%" | -jobfile my_file<br>
|-
| width="10%" align="center" | -jobtar 
| width="10%" align="center" | lajob 
| width="10%" align="center" | lajob 
| width="10%" | <br> 
| width="30%" | name to give to the tarfile produced with the nosubmit option<br><br>nom à donner au fichier tar produit par l'option nosubmit 
| width="30%" | <br>
|-
| width="10%" align="center" | -keep<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | keep<br> 
| width="10%" | <br> 
| width="30%" | conserver les fichiers intermédiaires (enveloppes)<br><br>keep intermediate files (wrappers)<br> 
| width="30%" | -keep<br>
|-
| width="10%" align="center" | -l<br> 
| width="10%" align="center" | no<br> 
| width="10%" align="center" | yes<br> 
| width="10%" | maestro only 
| width="30%" | <br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -laststep<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | <br> 
| width="10%" | LL only 
| width="30%" | <br> 
| width="30%" | <br>
|-
! width="10%" align="center" | -listing<br> 
| width="10%" align="center" | ~/listings<br> 
| width="10%" align="center" | ~/tmp<br> 
| width="10%" | autolisting 
| width="30%" | répertoire où on désire retrouver le listing du travail<br><br>directory the job listing will be written into 
| width="30%" | -listing ~/dir1/exp2<br>
|-
| width="10%" align="center" | '''-mach''' 
| width="10%" align="center" | localhost 
| width="10%" align="center" | <br> 
| width="10%" | <br> 
| width="30%" | machine sur laquelle on veut executer<br><br>machine to execute the job on 
| width="30%" | <br>
|-
| width="10%" align="center" | -mail<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | $USER@ec.gc.ca<br> 
| width="10%" | <br> 
| width="30%" | si on doit envoyer du courrier , le faire à cette adresse<br>(voir / see&nbsp; '''-notify''' )<br><br>send mail (if necessary) to this address<br> 
| width="30%" | -mail<br>-mail user@some.where<br>
|-
! width="10%" align="center" | -mpi / -p<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | mpi<br> 
| width="10%" | <br> 
| width="30%" | travail utilisant MPI<br><br>used to flag an MPI&nbsp;job 
| width="30%" | -mpi<br>
|-
| width="10%" align="center" | -node<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" | maestro only 
| width="30%" | <br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -noendwrap<br> 
| width="10%" align="center" | y<br> 
| width="10%" align="center" | n<br> 
| width="10%" | maestro only 
| width="30%" | <br> 
| width="30%" | <br>
|-
! width="10%" align="center" | -nosubmit<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | nosubmit<br> 
| width="10%" | <br> 
| width="30%" | ne pas soumettre le travail mais l'emballer dans un fichier appelé '''lajob.tar''' pour soumission ultérieure<br><br>job shall not be submitted but packed into file'''lajob.tar''' to be submitted at a later time 
| width="30%" | -nosubmit<br>
|-
| width="10%" align="center" | -notify<br> 
| width="10%" align="center" | error<br> 
| width="10%" align="center" | complete<br> 
| width="10%" | <br> 
| width="30%" | -notify error <br>envoyer du coutrrier en cas d'erreur dans le travail<br>send mail in case of error in the job<br><br>-notify complete<br>envoyer du courrier a la fin du travail<br> send mail at end of job 
| width="30%" | NOTE: la demande est passée au système d'ordonnancement de travaux (SGE ou LL) qui en fera ce qu'il veut/peut.<br><br>NOTE: the request is passed on to the batch subsystem (SGE or LL)&nbsp; that will act on it as it can/wants.<br>
|-
| width="10%" align="center" | -op 
| width="10%" align="center" | NULL 
| width="10%" align="center" | oper 
| width="10%" align="center" | <br> 
| width="10%" align="left" | ceci est un travaial opérationnel<br>this is an operational job 
| width="10%" align="center" | <br>
|-
| width="10%" align="center" | -postfix 
| width="10%" align="center" | .out 
| width="10%" align="center" | NoNe 
| width="10%" align="center" | <br> 
| width="10%" align="left" | chaine de caractères à ajouter à la fin du nom du&nbsp;fichier contenant le listing du travail<br><br>character string that will be appended to the listing file name 
| width="10%" align="center" | <br>
|-
| width="10%" align="center" | -ppid<br> 
| width="10%" align="center" | $$<br> 
| width="10%" align="center" | $$<br> 
| width="10%" | ne pas utiliser<br>do not use<br> 
| width="30%" | <br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -preempt 
| width="10%" align="center" | <br> 
| width="10%" align="center" | 1 
| width="10%" | LL seulement<br>LL only 
| width="10%" | permettre ou non la préemption (1 = oui)<br><br>allow preemption (1 = yes) 
| width="10%" | <br>
|-
| width="10%" align="center" | -prefix 
| width="10%" align="center" | NoNe 
| width="10%" align="center" | NULL 
| width="10%" | <br> 
| width="30%" | chaine de caractères à ajouter au début du nom du fichier contenant le listing du travail<br><br>character string that will be addded to the beginning of the listing file name 
| width="30%" | -prefix exper12_<br>le listing du travail aura un nom commençant par exper12_<br><br>the listing file name will begin with exper12_<br>
|-
| width="10%" align="center" | -prolog 
| width="10%" align="center" | NULL 
| width="10%" align="center" | NULL 
| width="10%" | <br> 
| width="30%" | prolog to be inserted in job 
| width="30%" | -prolog iomonitor (activate iomonitor, experimental)<br>
|-
| width="10%" align="center" | -q / -queue<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" | <br> 
| width="30%" | queue spécifique pour une machine donnée<br><br>specific queue on a given machine<br> 
| width="30%" | 
-q fexfer&nbsp; ,&nbsp; -q xfer <br>file transfer queue <br>

-q my_queue@<br>job will be sent to work stream '''my_queue''' 

|-
| width="10%" bgcolor="#ffffff" align="center" | -rsrc 
| width="10%" bgcolor="#ffffff" align="center" | NULL 
| width="10%" bgcolor="#ffffff" align="center" | NULL 
| width="10%" bgcolor="#ffffff" align="center" | <br> 
| width="10%" bgcolor="#ffffff" align="center" | indiquer les ressources spéciales dont le travail a besoin<br><br>specify special resources needed by job 
| width="10%" bgcolor="#ffffff" align="center" | -rsrc to-hsm from-hsm<br>-rsrc none
|-
| width="10%" align="center" | -seqno<br> 
| width="10%" align="center" | 1<br> 
| width="10%" align="center" | 1<br> 
| width="10%" | <br> 
| width="30%" | numéro de séquence initial pour les clones<br><br>initial sequence number for clones<br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -share<br> 
| width="10%" align="center" | e<br> 
| width="10%" align="center" | s<br> 
| width="10%" | SGE only 
| width="30%" | exclusive (e) or shared (s) use of nodes<br> 
| width="30%" | usage partagé (s)&nbsp;ou exclusif (e) des noeuds de calcul<br>
|-
| width="10%" align="center" | -shell<br> 
| width="10%" align="center" | ksh<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" | <br> 
| width="30%" | 
interprète de commandes à utiliser pour le travail<br>-shell nologin =&gt; aucun login (SGE seulement)<br><br>shell to use for job<br>-shell nologin =&gt; no login will be performed (SGE&nbsp;only) 

| width="30%" | -shell bash<br>-shell sh<br>-shhell ksh93<br>
|-
| width="10%" align="center" | -smt<br> 
| width="10%" align="center" | 1<br> 
| width="10%" align="center" | 2<br> 
| width="10%" | <br> 
| width="30%" | doubler la valeur de OMP_NUM_THREADS dans le travail (facteur OpenMP)<br><br>double the value of OMP_NUM_THREADS in job (OpenMP factor)<br> 
| width="30%" | -smt<br>
|-
| width="10%" align="center" | -splitstd<br> 
| width="10%" align="center" | n<br> 
| width="10%" align="center" | y<br> 
| width="10%" | <br> 
| width="30%" | <br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -ssmuse<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" | <br> 
| width="30%" | liste d'items "r.ssmuse.dot¨ nécessaires pour l'exécution du travail (nouvel environnement seulement)<br><br>list of "r.ssmuse.dot" items necessary for successful job execution (new environment only) 
| width="30%" | <br>
|-
| width="10%" align="center" | -step<br> 
| width="10%" align="center" | default_step<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" | LL only 
| width="30%" | <br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -sys<br> 
| width="10%" align="center" | batch<br> 
| width="10%" align="center" | batch<br> 
| width="10%" | <br> 
| width="30%" | système de soumission / séquençage de travaux<br><br>type of sequencer to use<br> 
| width="30%" | -sys batch<br>-sys maestro<br>
|-
! width="10%" align="center" | -t<br> 
| width="10%" align="center" | 60<br> 
| width="10%" align="center" | 60<br> 
| width="10%" | <br> 
| width="30%" | temps d'horloge nécessaire pour exécuter le travail (secondes)<br><br>wall clock time needed to execute the job (seconds) 
| width="30%" | -t 7200&nbsp; ( 2 heures / 2 hours )<br>
|-
| width="10%" bgcolor="#ffffff" align="center" | -tag 
| width="10%" bgcolor="#ffffff" align="center" | NULL 
| width="10%" bgcolor="#ffffff" align="center" | NULL 
| width="10%" bgcolor="#ffffff" align="center" | <br> 
| width="10%" bgcolor="#ffffff" align="center" | job tracking tag for statistics<br><br>identificateur pour les séries statistiques 
| width="10%" bgcolor="#ffffff" align="center" | -tag newmodelv3
|-
| width="10%" align="center" | -threads<br> 
| width="10%" align="center" | 1<br> 
| width="10%" align="center" | 1<br> 
| width="10%" | <br> 
| width="30%" | <br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -tmpfs 
| width="10%" align="center" | <br> 
| width="10%" align="center" | 255 
| width="10%" | Linux/SGE only 
| width="10%" | quantité d'espace tmpfs nécessaire (MB)<br><br>necessary amount of tmpfs space required (MB) 
| width="10%" | <br>
|-
| width="10%" align="center" | -v<br> 
| width="10%" align="center" | NULL<br> 
| width="10%" align="center" | 1<br> 
| width="10%" | <br> 
| width="30%" | rendre ord_soumet plus bavard en ce qui a trait aux messages de diagnostic<br><br>make ord_soumet more verbose when it comes to diagnostic messages<br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -w<br> 
| width="10%" align="center" | 1<br> 
| width="10%" align="center" | 1<br> 
| width="10%" | <br> 
| width="30%" | même chose que '''-t '''mais en minutes (ne pas utiliser les deux à la fois)<br><br>same as'''-t '''but in minutes (use only one)<br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -waste 
| width="10%" align="center" | NULL 
| width="10%" align="center" | 100 
| width="10%" | <br> 
| width="30%" | pourcentage tolérable de CPUs non utilisés sur un noeud de calcul<br><br>tolerable percentage of unused CPUs on a compute node 
| width="30%" | <br>
|-
| width="10%" align="center" | -with 
| width="10%" align="center" | NULL 
| width="10%" align="center" | NULL 
| width="10%" | <br> 
| width="30%" | <br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -wrapdir 
| width="10%" align="center" | ~/.ord_soumet.d/wrap 
| width="10%" align="center" | NULL 
| width="10%" | maestro only 
| width="30%" | <br> 
| width="30%" | <br>
|-
| width="10%" align="center" | -xterm 
| width="10%" align="center" | NULL 
| width="10%" align="center" | xterm 
| width="10%" | <br> 
| width="30%" | faire démarrer un xterm dans le travail et viser l'unité X spécifiée par '''-display<br>'''<br>start an xterm in the job and target display specified by '''-display'''<br> 
| width="30%" | <br>
|}

<br>

=== Variables d'environnement utilisées/disponibles dans le travail / environment variables used/available in job  ===

{| cellspacing="1" cellpadding="1" border="1" class="wikitable" style="width: 1035px; height: 193px;"
|-
! width="20%" | PREEMPT_OK<br> 
! width="5%" | IN 
| width="40%" | IBM seulement, = 0 travail soumis en mode non préemptable, =1 soums en mode préemptable<br> 
| width="40%" | IBM only, =0 preemption not accepted by job, =1 preemption not accepted by job
|-
! width="20%" | BATCH_MPI_CPUS 
! width="5%" | IN 
| width="40%" | nombre de tuiles/taches MPI<br> 
| number of MPI tiles/tasks
|-
! width="20%" | OMP_NUM_THREADS 
! width="5%" | IN 
| width="40%" | nombre de fils d'exécution OpenMP tel que demandé via les paramètres -cpus et -smt<br> 
| width="30%" | number of OpenMP threads as specified via -cpus and -smt
|-
! width="20%" | JobTimeLimit 
! width="5%" | IN 
| width="40%" | durée maximale permise pour le travail (secondes)<br> 
| maximum allowed job wall cloak (seconds)
|-
! width="20%" | JobStartTime 
! width="5%" | IN 
| width="40%" | heure de démarrage du travail en secondes depuis <br>1970-01-01 00:00:00 UTC (epoch)<br> 
| job start time in&nbsp; seconds since <br>1970-01-01 00:00:00 UTC(epoch)
|-
! width="20%" | SelfJobKill 
! width="5%" | IN 
| width="40%" | recette pour tuer/annuller le travail<br> 
| receipe to kill/cancel the job
|-
! width="20%" | SelfJobResubmit 
! width="5%" | IN 
| width="40%" | recette pour resoumettre le travail<br> 
| receipe to resummit the job
|-
! width="20%" | SelfJobRemove 
! width="5%" | IN 
| width="40%" | recette pour effacer les fichiers "enveloppe" du travail<br> 
| receipe to remove the job wrappers
|-
! width="20%" | C LONE_ORDINAL<br> 
! width="5%" | IN 
| width="40%" | numéro du clone courant (1.. max)<br> 
| ordinal of current clone (1 .. max)
|-
! width="20%" | S OUMET<br> 
! width="5%" | OUT 
| width="40%" | SOUMET=qsub<br>causera une resoumission automatique d'un clone si le nombre maximal n'est pas atteint 
| SOUMET=qsub<br>wil trigger an automatic job resubmit if the maximum clone count has&nbsp; not been reached
|}

<br> 

=== Notes<br>  ===

{| cellspacing="1" cellpadding="1" border="1" class="wikitable" style="width: 1079px; height: 294px;"
|-
! align="center" width="15%" | LL 
| width="40%" | Load Leveler (ordonnanceur de travaux IBM) 
| width="40%" | Load Leveler (IBM batch scheduler)
|-
! align="center" width="15%" | SGE 
| Sun Grid Engine (ordonnanceur de travaux pour colosse) 
| Sun Grid Engine (Linux cluster colosse batch scheduler)
|-
! align="center" width="15%" | PBS 
| Portable Batch System (ordonnanceur de travaux de guillimin) 
| Portable Batch Syatem (Linux cluster guillimin batch scheduler)
|-
! align="center" width="15%" | maestro 
| nouveau séquenceur des passes opérationnelles 
| new Operational RUN sequencer
|-
! align="center" width="15%" | (localhost) 
| la machine sur laquelle on se trouve 
| the current machine
|-
! align="center" width="15%" | MxNxP 
| configuration des CPUs M fois N tuiles MPI, P fils d'exécution OpemMP pour chaque tuile<br> 
| CPU&nbsp;configuration, M times N MPI&nbsp;tiles,&nbsp; P OpenMP threads for each tile
|-
! align="center" width="15%" | autolisting 
| 
si un répertoire ~/listings/machine existe (-mach machine) le listing y sera automatiquement dépose si -listing n'est pas spécifié<br> 

| should a directory path ~/listings/machine exists (-mach machine) and -listings is absent, the listing will be writtne into that directory
|-
! align="center" width="15%" | 
nom du listing<br> 

listing file name 

| width="15%" | 
le nom du fichier contenant le listing est obtenu de la manière décrite ci dessous (la partie seqno est absente si on ne se sert pas du clonage)<br> 

t'''${prefix}${jn}.${ppid}.${postfix}[.${seqno}]''' 

| width="15%" | the listing file name is derived in the following way (the seqno part is optional and is only used with cloning) <br><br>'''t${prefix}${jn}.${ppid}.${postfix}[.${seqno}]'''<br>
|}

== Submitted job structure / La structure du travail soumis<br>  ==

ord_soumet creates 2 files from the user "job" 

*a batch system and OS&nbsp;dependent file 
**batch subsystem (PBS/ GridEngine/LoadLeveler/UnixBatch) header 
**OS dependent header (linux / AIX / ...) 
**source command for the wrapped user job(next file)<br>
**OS dependent footer (linux / AIX / ...) 
*user job surrounded by batch system and OS independent wrappers 
**header 
**optional prolog 
**user job itself 
**optional epilog 
**footer

== ord_soumet: architecture / internal structure  ==

ord_soumet uses 4 logical layers 

*ord_soumet itself (almost totally agnostic) 
*a control system layer (normal batch/OCM/Maestro) 
*a machine/cluster specific layer (machine description: batch subsystem, processors, some dispatching logic) 
*a batch subsystem layer (PBS/GridEngine/LoadLeveler/UnixBatch)

[[Category:HPCS]]