Cette section décrit la commande uxupdque utilisée pour modifier une queue batch.
La commande uxupdque permet de modifier la définition d'une queue batch ou d'associer des queues physiques à une queue logique. Pour des raisons de cohérence, la queue batch doit être vide.
L'Environnement par défaut peut être modifié.
La syntaxe est la suivante :
uxupdque QUEUE=queue [LSTQUE="node:queue,node:queue,…"] [ADDQUE="node:queue,node:queue,…"] [DLTQUE="node:queue,node:queue,…"] [JOBLIM=nnn] [MAXSEC=seconds] [PERSEC=seconds] [BASPRI=nnn] [ADDPRI=nnn] [MAXPRI=nnn] [EXEPRI=nnn] [SECPRI|NOSECPRI] [LSTMU="mu:jobsnumber,mu:jobsnumber,…"] [ADDMU="mu:jobsnumber,mu:jobsnumber,…"] [DLTMU="mu:jobsnumber,mu:jobsnumber,…"]
Description des items
QUEUE=
Nom de la queue batch.
Format : 31 caractères alphanumériques.
LSTQUE=
(Optionnel) Liste toutes les queues physiques associées à la queue logique QUEUE. Chaque queue physique doit être précédée de son nœud de résidence.
Attention ! Cette liste écrase les valeurs précédentes de la liste.
Format : "noeud1:queue1,noeud2:queue2,…". L'ordre de cette liste est celui utilisé par le serveur DQM pour dispatcher les jobs.
ADDQUE=
(Optionnel) Ajoute une ou plusieurs queues physiques en plus de celles déjà associées à la queue logique QUEUE.
Format : "noeud1:queue1,noeud2:queue2,…".
DLTQUE=
(Optionnel) Supprime la relation d’une ou plusieurs queues physiques à la queue logique QUEUE sans supprimer toutes les relations.
Format : "noeud1:queue1,noeud2:queue2,…".
JOBLIM=
(Optionnel) Nombre maximum de jobs pouvant s'exécuter en même temps dans la queue batch ou dans le cas d'une queue logique pour toutes les queues physiques associées. Lorsque cette limite est atteinte, les jobs entrent dans la queue dans l'état "Attente exécution".
Format : nombre entier de 0 à 999.
MAXSEC=
(Optionnel) Queue physique uniquement. Temps de rétention (secondes) : Si un job est présent dans la queue batch depuis une durée supérieure ou égale à MAXSEC, il obtient la priorité maximale de la queue et peut ainsi s'exécuter au plus tôt.
Format : nombre entier
PERSEC=
(Optionnel) Queue physique uniquement. Valeur en seconde du cycle de révision des priorités des jobs au sein de la queue batch. Toutes les PERSEC secondes, la priorité des jobs est augmentée de ADDPRI, à partir de la priorité de soumission de base jusqu'à au plus MAXPRI.
Format : nombre entier
BASPRI=
(Optionnel) Queue physique uniquement. Priorité par défaut de soumission d'un job placé en queue batch.
Format : nombre entier entre 0 et 255
ADDPRI=
(Optionnel) Queue physique uniquement. Valeur d'incrément de la priorité d'un job en queue batch dans le cas de la gestion dynamique des priorités.
Format : nombre entier entre 0 et 255
MAXPRI=
(Optionnel) Queue physique uniquement. Valeur maximale de la priorité des jobs dans la queue batch. Si JOBLIM le permet, les jobs possédant cette priorité sont mis en exécution.
Format : nombre entier entre 0 et 255
EXEPRI=
(Optionnel) Queue physique uniquement. Priorité par défaut d'exécution des jobs dans la queue batch.
Format : nombre entier entre 0 et 255
SECPRI | NOSECPRI
(Optionnel) Gestion des priorités secondaires pour la queue batch :
La gestion des priorités secondaire signifie que des jobs ayant la même priorité de soumission seront examinés selon leur numéro de session et non leur numéro d'entrée dans la queue. Dans ce cas; les jobs d'une première session pourront se terminer avant que la seconde Session ne soit exécutée.
LSTMU=
(Optionnel) Liste le nombre maximum de jobs imposé par Unité de Gestion pour la queue. Les Unités de Gestion dans la liste seront garanties d'un nombre d'exécutions spécifié, même si des jobs sont en attente d'exécution dans la queue.
Attention ! Cette liste écrase les valeurs précédentes de la liste.
Format : "mu:jobsnumber,mu:jobsnumber,…" avec :
ADDMU=
(Optionnel) Ajoute une limite du nombre de jobs pour l'UG spécifiée à la liste existante de la queue batch.
Format : "mu:jobsnumber,mu:jobsnumber,…" avec :
DLTMU=
(Optionnel) Supprime une limite du nombre de jobs pour l'UG spécifiée de la liste existante de la queue batch.
Format : "mu:jobsnumber,mu:jobsnumber,…" avec :
Exemples
Modifie le nombre maximum de jobs qui peuvent être exécutés en parallèle dans la queue batch créée précédemment :
$UNI_DIR_EXEC/uxupdque queue="${S_CODUG}_${S_DATRAIT}" joblim=5
Modifie la queue batch logique LOG_QUEUE en lui ajoutant la queue batch physique PHYS3 sur le nœud uranus :
%UNI_DIR_EXEC%\uxupdque QUEUE=LOG_QUEUE ADDQUE="uranus:PHYS3"
Supprime la queue physique PHYS2 du noeud SATURN de la queue logique LOG :
uxupdque QUEUE=LOG DLTQUE="SATURN:PHYS2"