uxordre - Déclencher un job batch

Cette section décrit la commande uxordre qui permet de déclencher des traitements depuis l'environnement CL ou un script.

La commande uxordre (alias uxord sous OpenVMS) permet de déclencher une tâche existante dans le paramétrage de Dollar Universe et définie comme étant une tâche provoquée ou planifiée. La tâche pourra être déclenchée avec ses paramètres de définition, ou en y substituant explicitement certains paramètres décrits ci-après.

Rappel : Si la tâche est :

• Activée : la commande uxordre crée un lancement actif.
• Simulée : la commande uxordre crée un lancement désactivé.
• Désactivée : la commande uxordre ne crée pas de lancement.

La commande uxordre permet également le passage de paramètres applicatifs (jusqu'à trente paramètres) :

• à la procédure, si la tâche est une Uproc simple,
• à l'Uproc entête de la session, si la tâche porte sur une session.

L'Environnement par défaut peut être modifié. La commande affiche dans la sortie standard le numéro de lancement associé avec le format suivant : "numlanc nnnnnnn". Sa syntaxe est la suivante :

uxordre [NODE=node] [ESP=X|S|I|A] [TSK=task] [SES=session] [VSES=version] UPR=uproc [VUPR=version] UG=mu|MU=mu [AFTER="date-hhmm"] [ELAPS="(hhhmm)"] [EXCLU="(hhmm,hhmm)"] [QUEUE=queue] [PRINTER=printer] [DTRAIT=date|PDATE=date] [FORCE|NOFORCE] [BYPASS] [PARAM="P1,P2..."] [LAUNCHVAR="variable=value,variable=value..."]

La commande OS/400 UXORDRE permet de déclencher une tâche existante à partir de la ligne de commande. F4 permet de saisir les paramètres unitairement. F11 donne le nom de chaque paramètre.

Description des items

• TSK=

  (Obligatoire si UPR est absent, incompatible avec UPR) Code de la tâche. Les tâches issues d'une mise à jour de v5 à v6 ont pour identifiant par défaut : TSK(SES)(VSES)(UPR)(VUPR).
  Format : 64 caractères alphanumériques.

• UPR=

  (Obligatoire si TSK est absent, incompatible avec TSK) Code de l'Uproc.
  Format : 64 caractères alphanumériques.

• VUPR=

  (Optionnel) Version d'Uproc (inutile avec les espaces S et X).
  Format : 3 caractères numériques.

• SES=

  (Optionnel) Code de la session.
  Format : 64 caractères alphanumériques.

• VSES=

  (Optionnel) Version de session (inutile dans l'espace X).
  Format : 3 caractères numériques.

• MU= ou UG=

  Code de l'unité de gestion de la tâche
  Format : 64 caractères alphanumériques.

• AFTER=

  (Optionnel) Date et heure de début de la plage de lancement. Permet de déclencher un traitement en différé.
  Format : "date-HHMM", le format de la date est indiqué par la valeur du paramètre U_FMT_DATE, l'heure est sur 4 caractères.
  Sous OS/400, la date doit être saisie au format utilisé par le système. Le format de l'heure est HHMMSS.

  Défaut :

  • Tâche provoquée : les informations correspondantes dans la tâche.
  • Tâche planifiée : soumission immédiate.

• ELAPS=

  (Optionnel) Durée de la plage de lancement.
  Format : (HHHMM).

  Défaut :

  • Sous Windows / UNIX / OpenVMS: 99959 (999h 59m soit 41,6 jours).
  • Sous OS/400 : l'information correspondante dans la tâche.

• EXCLU=

  (Sous Windows / UNIX, optionnel) Plage horaire d'exclusion. Permet d'exclure un intervalle horaire de la plage de lancement.
  Format : (HHMM,HHMM).

  Défaut : vide

• EXLW=

  (Sous OS/400, optionnel) Plage horaire d'exclusion. Permet d'exclure un intervalle horaire de la plage de lancement
  Format : (HHMMSS HHMMSS).

  Défaut : l'information correspondante dans la tâche.

• QUEUE=

  (Optionnel) Queue batch d'exécution du job.
  Format : 32 caractères alphanumériques.

  Défaut : l'information correspondante dans la tâche.

• PRINTER=

  (Optionnel) Imprimante attachée à la tâche.
  Format : nom logique à quatre caractères.

  Défaut : l'information correspondante dans la tâche.

• CENTRAL

  Obsolète.

• FORCE | NOFORCE

  (Optionnel) Indicateur de "lancement forcé en fin de période".

  Défaut :

  • Sous Windows / UNIX / OpenVMS : NOFORCE.
  • Sous OS/400 : l'information correspondante dans la tâche.

• BYPASS

  (Optionnel) Permet d'effectuer un lancement sans vérifier les conditions de l'Uproc.

• DTRAIT= ou PDATE=

  (Optionnel) Date de traitement.
  Format :

  • Sous Windows / UNIX / OpenVMS : format indiqué par la valeur du paramètre U_FMT_DATE.
  • Sous OS/400 : la date doit être saisie au format utilisé par le système.

  Défaut : l'information correspondante dans la tâche.

• PARAM=

  (Optionnel) Paramètres applicatifs. Permet le passage de 1 à 30 paramètres à la première Uproc de la tâche. Ces paramètres peuvent être récupérés :

  • Dans le CL de l’Uproc, sous la forme $1 à $30, ou sous la désignation Dollar Universe S_P1 à S_P30,
  • Dans les scripts lancés par la coquille batch : U_ANTE_UPROC et U_POST_UPROC, sous la désignation Dollar Universe.

  Le nombre maximum de paramètres transmis est de 30. La longueur de chaque paramètre ne doit pas excéder 255 caractères et la longueur totale (somme des longueurs + 2 fois le nombre de paramètres) doit être inférieure à 2074 caractères.

  Format : les paramètres saisis sont séparés par des virgules, chaque paramètre peut avoir un format quelconque sauf s'il comporte un espace, il faut alors l'indiquer entre guillemets.

• LAUNCHVAR=

  (Optionnel) Liste complète des variables du lancement et de leurs valeurs.
  Format : "var=val,var=val,…", 255 caractères maximum. La liste est encadrée de guillemets, chaque couple variable = valeur est séparé du suivant par une virgule (sans espace).

  • Le nom de la variable doit être choisi dans la liste des variables de l’Uproc identifiant le lancement.
  • La valeur de la variable, si elle est indiquée, remplace la valeur de la variable de la tâche ou de l’Uproc. Si la valeur n’est pas indiquée (la virgule ne doit pas être présente) c’est la valeur par défaut de la variable de la tâche ou de l’Uproc qui est prise en compte. Si la valeur contient des caractères non alphanumériques (espaces, /…) elle doit être encadrée de guillemets. Le format de la valeur doit être compatible avec le format déclaré lors de la création de la variable dans l’Uproc.

  Sous OS/400, la saisie du nom de la variable et de sa valeur sont dissociées.

Exemple

• Cette commande déclenche la tâche provoquée "IU_DTS S01", existante sur le nœud ds5200 dans l'espace d'Exploitation avec ses paramètres de définition et passe à la procédure IU_DTS les paramètres suivants : 34, /tmp, type:2.

  uxordre NODE=ds5200 EXP UPR=IU_DTS UG=S01 PARAM=34,/tmp,type:2