Uprocs

Cette section décrit les commandes sur les Uprocs. L'Environnement par défaut peut être modifié.

La commande uxadd UPR crée une Uproc dans la liste des Uprocs. Seules les informations générales sont définies. Les informations complémentaires sont saisies par l'intermédiaire d'une commande de mise à jour de l'Uproc (uxupd). Sa syntaxe est la suivante :

uxadd UPR UPR=uproc [VUPR=version] [LABEL=label][FPERIOD=N|D|W|T|F|M|2|3|Q|S|Y] [UPT=CL_INT|CL_EXT|CMD|FTP_GET|FTP_PUT|…] [CLFIL=filename] [CL_INT=filename] [COMMAND=command] [EXECDIR=directory] [SHELL=filename] [SHELLARG=arguments] [SHELLTYPE=POWERSHELL|PERL|CSCRIPT|DEFAULT] APPL=application [CLASS=class] [MEMO=N|O|A] [NBPER=number] [RETRY=(NNN,MM)] [DEFINFO=information] [DEFSEV=severity] [INTERACTIVE|NONINTERACTIVE]

Voir aussi Items GENINF.

La commande uxupd UPR : modifie les informations générales d’une Uproc, ajoute des caractéristiques complémentaires telles que des conditions, des consignes, des incompatibilités. Sa syntaxe est la suivante :

uxupd UPR UPR=uproc [VUPR=version] family...

• family

  Une seule des familles décrites ci-dessous peut être utilisée dans une commande uxupd :

  • GENINF: mise à jour des informations générales de l'Uproc.
  • UPR_STATUS: définition du statut de terminaison de l'Uproc.
  • CTLDUR: mise à jour des informations de contrôle de la durée d'exécution de l'Uproc.
  • NOTIFY: définition d'une notification par email lors de la terminaison de l'Uproc.
  • LAUNCHVAR add: création, valorisation et suppression des variables de l'Uproc.
  • INCCLASS add: définition des classes d'incompatibilité de l'Uproc. La classe d'appartenance de l'Uproc est définie dans les informations générales.
  • TERMINS add: définition des événements à purger lors de la terminaison de l'Uproc.
  • DEPCON add: définition d'une condition d'enchaînement sur d'autres Uprocs.
  • RESCON add: définition d'une condition de ressource de l'Uproc.
  • INCCON add: définition d'une condition de non simultanéité sur d'autres Uproc.
  • FORMULA: définition et mise à jour de la formule de lancement. Cette famille doit être utilisée dès lors qu'une condition a été ajoutée ou supprimée à l'Uproc pour que les conditions soient effectivement examinées lors du pilotage.
  • SUCCESSOR add: définition de l'ordre d'examen des successeurs de l'Uproc.
  • FTP_GET: définition d'une Uproc de type FTP_GET.
  • FTP_PUT: définition d'une Uproc de type FTP_PUT.

• GENINF

  Informations générales

  uxupd UPR UPR=uproc [VUPR=version] GENINF [LABEL=label][FPERIOD=N|D|W|T|F|M|2|3|Q|S|Y] [UPT=CL_INT|CL_EXT|CMD|FTP_GET|FTP_PUT|…] [CLFIL=filename] [CL_INT=filename] [COMMAND=command] [EXECDIR=directory] [SHELL=filename] [SHELLARG=arguments] [SHELLTYPE=POWERSHELL|PERL|CSCRIPT|DEFAULT] APPL=application [CLASS=class] [MEMO=N|O|A] [NBPER=number] [RETRY=(NNN,MM)] [DEFINFO=information] [DEFSEV=severity] [INTERACTIVE| NONINTERACTIVE] [DIR_FILES=directory]

  Voir aussi Items GENINF

• UPR_STATUS

  Statut de terminaison de l'Uproc.

  uxupd UPR UPR=uproc [VUPR=version] UPR_STATUS ENABLE=Y|N|y|n [SET=C|A] [RETCODE=value[,EQ|LO|GT|NE]] [EXT_RETCODE=n1;n2;[n3,n4];[n5,n6]/n7] [STRING=string] [REGEXP|NOREGEXP] [SEARCH_FILE=filename]

  Voir aussi Items UPR_STATUS

• CTLDUR

  Durée d'exécution de l'Uproc

  uxupd UPR UPR=uproc [VUPR=version] CTLDUR [MAXDUR=(HHHMMSS|nnn,K|F|C=filename)|NONE] [MINDUR=(HHHMMSS|nnn,R|C=filename)|NONE] [MAXWDUR=(HHHMMSS|nnn,F|A|C=filename)|NONE]

  Voir aussi Items CTLDUR

• NOTIFY

  Notification par email lors de la terminaison de l'Uproc.

  uxupd UPR UPR=uproc [VUPR=version] NOTIFY [MAIL=Y|N] [COMPLETED=Y|N] [ABORTED=Y|N] [REFUSED=Y|N] [TIMEOVERRUN=Y|N] [JOBLOG=Y|N|value] [RECIPIENT="email1;email2…"]

  Voir aussi Items NOTIFY

• LAUNCHVAR add

  Ajoute une variable.

  uxupd UPR UPR=uproc [VUPR=version] LAUNCHVAR add VARNAME=variable [VTYPE=D|Q|P|T] VFORMAT=format [VALMIN=value] [VALMAX=value] VVALUE=value

• LAUNCHVAR dlt

  Supprime une variable.

  uxupd UPR UPR=uproc [VUPR=version] LAUNCHVAR dlt VARNAME=variable

  Voir aussi Items Variables

• INCCLASS add

  Ajoute une classe d'incompatibilité.

  uxupd UPR UPR=uproc [VUPR=version] INCCLASS add XCLASS=class

• INCCLASS dlt

  Supprime une classe d'incompatibilité.

  uxupd UPR UPR=uproc [VUPR=version] INCCLASS dlt XCLASS=class

  Voir aussi Items classes d'incompatibilité et successeurs

• TERMINS add

  Ajoute une consigne de terminaison.

  uxupd UPR UPR=uproc [VUPR=version] TERMINS add TERMNO=number TERM=uproc [PDATE=ANY|SAME|(±n,n,n)|(a, ,n)] [MU=SAME|"MU(mu)"|"MUT(type)"|"HDP({XY})"] [SESS=ANY|SAME|SAMERUN|EXPL(session)] [USER=ANY|SAME] [STATUS=TERMINATED|ABNORMAL]

• TERMINS dlt

  Supprime une consigne de terminaison.

  uxupd UPR UPR=uproc [VUPR=version] TERMINS dlt TERMNO=number

  Voir aussi Items consignes de terminaison et conditions

• DEPCON add

  Ajoute une condition d'enchaînement.

  uxupd UPR UPR=uproc [VUPR=version] DEPCON add CONDNO=number DEP=uproc [IFPLANNED] [PDATE=ANY|SAME|(±n,n,n)|(a, ,n)] [DTYPE=A|W|C|H] [MU=SAME|"MU(mu)"|"MUT(type)"|"HDP({XY})"] [SESS=ANY|SAME|SAMERUN|EXPL(session)] [USER=ANY|SAME] [STATUS=TERMINATED|ABNORMAL|ENDED|ABSENT] [EXPECTED|EXCLUDED] [NOFATAL|FATAL]

• DEPCON dlt

  Supprime une condition d'enchaînement. La formule de lancement doit tout d'abord être mise à jour avec la nouvelle formule de lancement complète.

  uxupd UPR UPR=uproc [VUPR=version] DEPCON dlt CONDNO=number

  Voir aussi Items consignes de terminaison et conditions

• INCCON add

  Ajoute une condition de non simultanéité.

  uxupd UPR UPR=uproc [VUPR=version] INCCON add CONDNO=number INC=uproc [PDATE=ANY|SAME] [MU=SAME|"MU(mu)"|"MUT(type)"|"HDP({XY})"] [SESS=ANY|SAME|SAMERUN|EXPL(session)] [USER=ANY|SAME] [EXPECTED|EXCLUDED] [NOFATAL|FATAL]

• INCCON dlt

  Supprime une condition de non simultanéité. La formule de lancement doit tout d'abord être mise à jour avec la nouvelle formule de lancement complète.

  uxupd UPR UPR=uproc [VUPR=version] INCCON dlt CONDNO=number

  Voir aussi Items consignes de terminaison et conditions

• RESCON add

  Ajoute une condition de ressource.

  Important ! Sous Solaris (intel et sparc), la commande /usr/xpg4/bin/grep doit être accessible pour que l'attribut PARSING puisse être utilisé dans la condition de ressource.

  uxupd UPR UPR=uproc [VUPR=version] RESCON add CONDNO=number RES=resource [PDATE=ANY|SAME|(±n,n,n)|(a, ,n)] [DTYPE=A|W|C|H] [MU=SAME|"MU(mu)"|"MUT(type)"|"HDP({XY})"] [ONE|ALL] [VERIF|NOVERIF] [UNLOCK|LOCK] [EXPECTED|EXCLUDED] [NOFATAL|FATAL] [ATTRIB=EXIST|SIZE|DATEUNCHANGE|SIZEUNCHANGE|DATCREA|DATMOD|GROUP|PARSING] [OPER=#|=|<|>|<=|>=|~=] [VALUE=value] [QT1=value] [QT2=value]

• RESCON dlt

  Supprime une condition de ressource. La formule de lancement doit tout d'abord être mise à jour avec la nouvelle formule de lancement complète.

  uxdlt UPR UPR=uproc [VUPR=version] RESCON dlt CONDNO=number

  Voir aussi Items consignes de terminaison et conditions

• FORMULA

  Définit la formule de lancement.

  uxupd UPR UPR=uproc [VUPR=version] FORMULA LFORM=formula

  Voir aussi Item Formule de lancement

• SUCCESSOR add

  Crée un successeur de l'Uproc

  uxupd UPR UPR=uproc [VUPR=version] SUCCESSOR add SUCC_UPR=uproc

• SUCCESSOR dlt

  Supprime un successeur de l'Uproc

  uxupd UPR UPR=uproc [VUPR=version] SUCCESSOR dlt SUCC_UPR=uproc

  Voir aussi Items classes d'incompatibilité et successeurs

• FTP_GET

  Récupère des fichiers par FTP.

  uxupd UPR UPR=uproc [VUPR=version] FTP_GET [PARTNER=hostname] [ORIGIN_FILENAME=filename] [ORIGIN_PATHNAME=path] [TARGET_FILENAME=filename] [TARGET_PATHNAME=path] [LOGON=username|anonymous] [PASSWORD=password] [MODE=ASCII|BINARY] [ACTION=REPLACE|ABORT|NONE] [CRLF|NOCRLF] [DELETE|NODELETE] [NEWER|NONEWER] [RECURSIVE|NORECURSIVE] [BUFFER_SIZE=value] [RETRY=value] [UMASK=value]

• FTP_PUT

  Envoie des fichiers par FTP.

  uxupd UPR UPR=uproc [VUPR=version] FTP_PUT [PARTNER=hostname] [ORIGIN_FILENAME=filename] [ORIGIN_PATHNAME=path] [TARGET_FILENAME=filename] [TARGET_PATHNAME=path] [LOGON=username|anonymous] [PASSWORD=password] [MODE=ASCII|BINARY] [ACTION=REPLACE|ABORT|APPEND|NONE] [DELETE|NODELETE] [NEWER|NONEWER] [RECURSIVE|NORECURSIVE] [BUFFER_SIZE=value] [RETRY=value]

  Voir aussi Items FTP 

La commande uxdup UPR duplique une Uproc ainsi que l'ensemble de ses caractéristiques. Si cette Uproc a un script interne, le script est également dupliqué. Sa syntaxe est la suivante :

uxupd UPR UPR=uproc VUPR=version TUPR=uproc TVUPR=version [TLABEL=label]

La commande uxshw UPR affiche les caractéristiques d'une Uproc, son script (s'il est interne), ses variables (les valeurs des variables de type mot de passe sont affichées sous la forme d'étoiles *******), sa formule de lancement et le détail des conditions. Pour ne pas afficher le script (interne) le paramètre nœud U_UPR_SCRIPT_NODISP peut être définit. Reportez-vous au Manuel Utilisateur d'Univiewer. Sa syntaxe est la suivante :

La commande uxdlt UPR supprime une Uproc. Sa syntaxe est la suivante :

uxdlt UPR UPR=uproc [VUPR=version]

La commande uxlst UPR liste les Uprocs. Sa syntaxe est la suivante :

uxlst UPR [UPR=uproc] [VUPR=version] [DOM=domain] [APPL=application] [INF|FULL] [OUTPUT=filename]

La commande uxtra UPR transfère les Uprocs dans un autre espace de la même société sur le même nœud. Sa syntaxe est la suivante :

uxtra UPR UPR=uproc [VUPR=version] TESP=I|S|X

La commande uxscv UPR permet de définir la version courante d'une Uproc (espace application et intégration uniquement). Sa syntaxe est la suivante :

uxscv UPR UPR=uproc [VUPR=version]

La commande uxrls UPR permet de libérer une Uproc. Sa syntaxe est la suivante :

uxrls UPR UPR=uproc [VUPR=version]

La commande uxext UPR extrait la définition complète d'une Uproc (avec son CL si celui-ci est déclaré interne). Sa syntaxe est la suivante :

uxext UPR UPR=uproc [VUPR=version] [REPL] [ENABLE|NOENABLE] [NOVERIF] OUTPUT=filename

La commande uxins UPR insère la définition complète d'une Uproc dans les fichiers correspondants de Dollar Universe (avec son éventuel CL) pour le même espace et la même version de Dollar Universe que l'extraction. Sa syntaxe est la suivante :

uxins UPR UPR=uproc [VUPR=version] [REPL] [ENABLE|NOENABLE] INPUT=filename

• Si des Uprocs ont été extraites des espaces exploitation ou simulation (version 000), elles peuvent être insérées dans les espaces intégration ou application en définissant au préalable la nouvelle valeur de la version (paramètre nœud S_VUPR_REINSERT, catégorie Réglages de l'interface commande):

  S_VUPR_REINSERT=XYZ

  XYZ étant la nouvelle valeur de la version de l'Uproc soit au minimum 001 pour pouvoir être insérée dans les espaces intégration ou application.

• Toutes les commandes d'insertion suivantes utiliseront ce paramètre pour définir la version des Uprocs insérées (quelque soit l'espace cible).

Voir aussi Autres items

Description des items

Items GENINF

• UPR=

  Code Uproc. Requiert la saisie d'un code Uproc ou * (valeur générique acceptée sauf pour uxadd).
  Format : 64 caractères alphanumériques.

• VUPR=

  Version d'Uproc. Permet la saisie d'une version d'Uproc (valeur explicite).
  Format : 3 caractères numériques.

  Défaut:

  • uxext : toutes les versions des Uprocs renseignées sont extraites (inutile avec SIM et EXP).
  • Autres commandes :la version est obligatoire dans les espaces APP et INT, elle est facultative dans les espaces SIM et EXP (systématiquement à 000).

• LABEL=

  (Optionnel) Libellé descriptif de l'Uproc.
  Format : 64 caractères alphanumériques.

• FPERIOD=

  (Optionnel) Période fonctionnelle. Indique le format de la date de traitement qui sera associée à l'exécution de l'Uproc.
  Les valeurs possibles sont : N (sans), D (jour), W (semaine), T (décade), F (quinzaine), M (mois), 2 (bimestre), 3 (trimestre), Q (quadrimestre), S (semestre), Y (année).

  Défaut : N (sans)

• UPT=

  (Optionnel) Type de l'Uproc. Pour une Uproc à CL interne indiquer CL_INT, pour une Uproc à CL externe sélectionner CL_EXT, pour une Uproc de type Commande indiquer CMD. Sélectionnez FTP_GET ou FTP_PUT pour les transferts de fichiers. D'autres types peuvent être disponibles selon les Managers Dollar Universe installés.

  Défaut : CL_INT

• CLFIL=

  (Optionnel) CL externe associé à l'Uproc. Ne peut être utilisé qu'avec le type d'Uproc CL_EXT. Indique le chemin d'accès et le nom de la procédure associée à l'Uproc.
  Format : 128 caractères maximum.

• CL_INT=

  (Optionnel) Chemin ciblant un fichier unique dont le contenu sera copié en tant que script interne pour une Uproc de type CL_INT.
  Format : 256 caractères maximum.
  

• COMMAND=

  (Optionnel) Ligne de commande à exécuter. Ne peut être utilisé qu'avec le type d'Uproc CMD. La ligne de commande doit contenir :

  • Le chemin d'accès à la commande (sinon, la commande est recherchée dans un des répertoires de la variable PATH).
  • La commande et ses arguments.

  Le chemin et les arguments de la commande peuvent contenir des variables selon la syntaxe : !VARIABLE!. Se reporter au Manuel de Référence de Dollar Universe pour la manipulation de ces variables.
  Format : 256 caractères maximum.

• EXECDIR=

  (Optionnel) Répertoire d'exécution de la ligne de commande. Ne peut être utilisé qu'avec le type d'Uproc CMD.
  Format : 258 caractères maximum.

  Défaut : le répertoire home du compte de soumission qui exécute l'Uproc.

• SHELL=

  (Optionnel) Contient le shell utilisé pour exécuter la commande de l'Uproc. Par exemple: "/bin/sh". Cet item n’est utilisable que pour les Uprocs de type CMD.
  Par exemple : SHELL=/usr/bin/ruby

• SHELLARG=

  (Optionnel) Contient les arguments de ce shell. Cet item n’est utilisable que pour les Uprocs de type CMD. Par exemple : SHELLARG="-e !CMD!"
  Lorsque l’Uproc CMD s’exécute, la commande devient alors : "/usr/bin/ruby -e !CMD!"
  (!CMD! étant la commande définie dans l'Uproc).
  Si la commande est saisie dans l’Uproc est : sleep(10), la ligne de commande sera :
  /usr/bin/ruby -e sleep(10)
  

• SHELLTYPE=

  (Optionnel) Contient le type de shell pour une Uproc de type CL_INT, CL_EXT ou CMD uniquement sur un nœud en version 6.7 minimum. Les autres valeurs sont : POWERSHELL, CSCRIPT (sauf type CMD) ou PERL.

  Défaut : DEFAULT: le type de shell est indiqué si nécessaire dans le script.

• APPL=

  Code application. Utilisé avec uxadd et uxupd : Indique à quelle application l'Uproc est rattachée.
  Optionnel avec uxupd.
  Format : 64 caractères alphanumériques.

• CLASS=

  (Optionnel) Classe d'appartenance de l'Uproc. Indique à quelle classe l'Uproc est associée.
  Format : 64 caractères alphanumériques.

• MEMO=

  (Optionnel) Indique le mode de mémorisation de l'Uproc dans le fichier des événements jobs. Trois valeurs sont possibles :

  • N : sans mémorisation,
  • O : une exécution,
  • A : toutes les exécutions.

  Dans le cas où l'Uproc est mémorisée (choix O ou A), cette information doit être complétée par l'item NBPER.

  Défaut : N.

• NBPER=

  (Optionnel) Nombre de périodes de mémorisation de l'Uproc. Indique le nombre de périodes (fonctionnelles) sur lesquelles les événements seront conservés dans la base des événements.
  Format : 2 caractères numériques.

  Défaut : 0 (sans limitation).

• RETRY=

  (Optionnel) Si le lanceur attribue l'état Incidenté à l'exécution, le lanceur réitérera l'exécution de l'Uproc jusqu'à obtenir un état Terminé.
  Format: (NNN,MM):

  • NNN: nombre maximum de tentatives d'exécution pour obtenir un état final Terminé. Maximum 999.
  • MM: intervalle en minutes entre chaque tentative. Entre la fin de l'exécution précédente et le redémarrage de la nouvelle exécution. La valeur "0" signifie un redémarrage immédiat. Maximum 59 minutes.

• DEFINFO=

  (Optionnel) Valeur par défaut du paramètre Information de l'Uproc qui sera affiché dans le suivi des exécutions. Texte libre tronqué à 50 caractères s'il est plus long.

• DEFSEV=

  (Optionnel) Valeur par défaut du paramètre Sévérité de l'Uproc qui sera affiché dans le suivi des exécutions.
  Format : nombre entier de 0000 à 9999 sur 4 caractères.

• INTERACTIVE | NOINTERACTIVE

  (Optionnel) sous Windows uniquement, mode de soumission

  • INTERACTIVE: le job est soumis en mode interactif par le biais du service "Interactive Desktop".
  • NOINTERACTIVE : le job est soumis en mode batch, par le biais du Service Utilisateur du compte de soumission. Si aucun service utilisateur n’est disponible, le système tente de soumettre le Job en mode interactif par le biais du service "Interactive Desktop".

  Défaut : NOINTERACTIVE

• DIR_FILES=

  (Optionnel) Chemin ciblant un répertoire dont le contenu sera copié en tant que fichiers de l'Uproc.

Items UPR_STATUS

• ENABLE=

  Active ou désactive la gestion de l'état de terminaison de l'Uproc. Ne peut être utilisé qu'avec la famille STATUS. Obligatoire.
  Format : 1 caractère : Y, y, N, n :

  • Y ou y : active la gestion de l'état de terminaison
  • N ou n : désactive la gestion de l'état de terminaison

• SET=

  (Optionnel) Nouvel état de terminaison de l'Uproc si la règle définie est vérifiée. Ne peut être utilisé qu'avec la famille STATUS.
  Format : 1 caractère :

  • C : état Terminé
  • A : état Incidenté

  Défaut : C

• RETCODE=

  (Optionnel, incompatible avec EXT_RETCODE, STRING et SEARCH_FILE) Test sur le code retour du script de l'Uproc (sous UNIX/OpenVMS) ou sur la variable RESEXE (sous Windows). Ne peut être utilisé qu'avec la famille STATUS. Format 4n[,2c].

  • 4n : Code retour attendu. Nombre entier positif ou négatif.
  • (Optionnel) 2c : Opérateur de test de la valeur. Les valeurs possible sont : EQ (égal), GT (supérieur à), LO (inférieur à) ou NE (différent de).
    Défaut : EQ (égal).

  Exemple:

  uxupd UPR EXP UPR=STATUS_UPR UPR_STATUS ENABLE=Y SET=A RETCODE=0.LO

• EXT_RETCODE=

  (Optionnel, incompatible avec RETCODE, STRING et SEARCH_FILE) Test sur le code retour du script de l'Uproc (sous UNIX/OpenVMS) ou sur la variable RESEXE (sous Windows). Ne peut être utilisé qu'avec la famille STATUS.
  Format : n1;n2;[n3,n4];[n5,n6]/n7 sur 64 caractères maximum. La liste des valeurs peut être composée:

  • D'une valeur simple : format : * ou nombre entier positif ou négatif (de -32767 à 32768), par exemple: -2
  • D'une plage de valeurs entières positives ou négatives (de -32767 à 32768) : format : [min,max], par exemple: [-10,10] : de -10 à 10 inclus.
  • De valeurs calculées à partir d'un multiple. Format : N/m (N positif ou négatif, m positif uniquement), par exemple: */3 : tous les multiples de 3.
  • De valeurs calculées dans une plage (de -32767 à 32768) selon le multiple spécifié (m positif uniquement) : format [min,max]/m, par exemple: [1,10]/4 : 4 et 8. Chacune des valeurs ou des plages doit être séparée par un point virgule. La liste ne doit pas dépasser 64 caractères.

  Exemple: -2;[-10,10];*/3;[1,10]/4

• STRING=

  (Optionnel, incompatible avec RETCODE et EXT_RETCODE) Test sur la présence d'une chaîne de caractères dans le fichier spécifié par  l'item SEARCH_FILE. Ne peut être utilisé qu'avec la famille STATUS.
  Format : 128 caractères. Si la chaîne contient des espaces, il faut l'entourer de guillemets.

  Utilisé avec le mot clé REGEXP, ce champ correspond à une expression régulière (librairie Tcl/Tk version 8.1 avec l'option "ERE" signifiant que seule la syntaxe 8.0 est supportée; suivez cette URL https://tcl.tk/doc/howto/regexp81.html#part1_2 pour plus de détails).
  Les caractères suivants sont supportés pour les expressions régulières :

  • Générique : pour remplacer n'importe quel caractère “.”
  • Répétition : zéro ou plusieurs occurrences du caractère ou de la classe précédant “*”
  • Position dans la ligne : début de ligne “^”
  • Position dans la ligne: fin de ligne “$”
  • Classe de caractères: chaîne qui contient l'un des caractères. Exemple : [clas]
  • Classe inversée : chaîne qui ne contient pas l'un des caractères. Exemple : [^clas]
  • Plage de caractères : tous les caractères dans la plage définie. Exemple : [0-9]
  • Échappement : pour rechercher le caractère spécial “x”. Exemple : \x
  • Position dans le mot : début du mot. Exemple : \<xyz
  • Position dans le mot: fin du mot. Exemple : xyz\>

  Exemple :

  uxupd UPR EXP UPR=STATUS_UPR UPR_STATUS ENABLE=Y SET=C STRING=Execution_OK SEARCH_FILE=/data/result_file.txt

• REGEXP | NOREGEXP

  (Optionnel) Expression régulière

  • REGEXP : indique que STRING contient une expression régulière.
  • NOREGEXP : indique que STRING ne contient pas d'expression régulière.

  Défaut NOREGEXP.

• SEARCH_FILE=

  (Optionnel, incompatible avec RETCODE et EXT_RETCODE) Fichier dans lequel la chaîne de caractères STRING sera recherchée. Ne peut être utilisé qu'avec la famille STATUS.
  Format : 256 caractères. Si la chaîne contient des espaces, il faut l'entourer de guillemets.

  Défaut : fichier log de l'Uproc.

Items CTLDUR

• MAXDUR=

  (Optionnel) Contrôler une durée d'exécution trop longue.
  Format : (HHHMMSS|nnn,K | F | C=256c) ou NONE pour effacer la valeur. Si la durée indiquée (HHHMMSS ou nnn%) est atteinte avant la terminaison de l'Uproc, l'action choisie sera exécutée :

  • K: arrête l'Uproc
  • F: force le statut à Terminé
  • C: exécute le script indiqué : renseignez le chemin et le nom du script à exécuter (maximum 256 caractères)

  Exemples :

  uxupd upr upr=MY_UPROC ctldur maxdur="(119,C=hello)"

  uxupd upr upr=MY_UPROC ctldur maxdur="(0010203,F)"

  uxupd upr upr=MY_UPROC ctldur maxdur="(0010203,R)"

  uxupd upr upr=MY_UPROC ctldur maxdur="(0010203,C=C:\my\own\script.bat)"

  uxupd upr upr=MY_UPROC ctldur maxdur=NONE

• MINDUR=

  (Optionnel) Contrôler une durée d'exécution trop courte.
  Format: (HHHMMSS|nnn,R | C=256c) ou NONE pour effacer la valeur. Si l'Uproc se termine avant la durée indiquée (HHHMMSS ou nnn%), l'action choisie sera exécutée :

  • R: reprise de l'Uproc
  • C: exécute le script indiqué : renseignez le chemin et le nom du script à exécuter (maximum 256 caractères)

• MAXWDUR=

  (Optionnel) contrôler une durée d'attente trop longue avant l'exécution.
  Format : (HHHMMSS|nnn,F | A | C=256c) ou NONE pour effacer la valeur. Si le temps d'attente (HHHMMSS ou nnn%) avant l'exécution est dépassé, l'action choisie sera exécutée.

  • F: force le statut à Terminé
  • A: force le statut à Incidenté
  • C: exécute le script indiqué : renseignez le chemin et le nom du script à exécuter (maximum 256 caractères)

Items NOTIFY

• MAIL=

  (Optionnel) Active la notification email pour cette Uproc.
  Format : Y ou N.

  • Y (yes) : active la notification par email lorsque l'un des états sélectionnés (ci-dessous) est atteint.
  • N (no) : désactive la notification par email. Valeur par défaut.

  Exemple :

  uxupd UPR EXP UPR=DEF_UPR NOTIFY MAIL=Y ABORTED=Y REFUSED=Y JOBLOG=400 recipient="admin@Automic.com;admin_du@Automic.com"

• COMPLETED=

  (Optionnel) Indique si l'état Terminé doit déclencher une notification par email (valeur Y : yes).
  Format : Y ou N

  Défaut : N

• ABORTED=

  (Optionnel) Indique si l'état Incidenté doit déclencher une notification par email (valeur Y : yes).
  Format : Y ou N

  Défaut : N

• REFUSED=

  (Optionnel) Indique si l'état Refusé doit déclencher une notification par email (valeur Y : yes).
  Format : Y ou N

  Défaut : N

• TIMEOVERRUN=

  (Optionnel) Indique si l'état "Horaire dépassé" doit déclencher une notification par email (valeur Y : yes).
  Format : Y ou N

  Défaut : N

• JOBLOG=

  (Optionnel) Indique si le log de l'Uproc doit être attaché à l'email.
  Format :

  • N : le log de l'Uproc n'est pas attaché à l'email envoyé.
  • Y : le log de l'Uproc est attaché à l'email envoyé quelle que soit sa taille.
  • 4 caractères numériques : le log de l'Uproc n'est attaché à l'email que si la taille ne dépasse pas la valeur indiquée en kilo octets.

  Défaut : N

• RECIPIENT=

  (Optionnel sous Windows) Liste des adresses email des destinataires de la notification. Sur UNIX, la liste de plus d'une adresse doit être encadrée de guillemets " ".
  Format : 256 caractères maximum : "email1;email2;…"

Items Variables

• VARNAME=

  Nom de la variable. Requiert la saisie du nom de la variable de l'Uproc.
  Format : 20 caractères alphanumériques.

• VTYPE=

  (Optionnel) Type de la variable. La variable peut être de type texte, mot de passe, quantité ou date. Du type dépend le contrôle du format de la variable.
  Format :

  • Q : quantité,
  • T : texte,
  • P : mot de passe
  • D : date

  Défaut : T

• VFORMAT=

  Format de la variable. Optionnel pour une variable de type quantité pour laquelle cette information ne présente pas de sens.

  • Pour une variable de type Date, le format doit être choisi entre les trois valeurs suivantes : AAAA/MM/JJ ou JJ/MM/AAAA ou MM/JJ/AAAA.
  • Pour une variable de type texte ou mot de passe, le format exprime la longueur maximum du texte saisi (guillemets non compris) : au maximum 255 caractères.
    Défaut : 255 caractères

  Exemples :

  uxupd UPR EXP UPR=D_LOAD_FIL LAUNCHVAR add VARNAME=VARDATE VTYPE=D VFORMAT="YYYY/MM/DD" VVALUE="2002/07/01"

  uxupd UPR EXP UPR=D_LOAD_FIL LAUNCHVAR add VARNAME=VARTXT VVALUE=\"Last var\"

  uxupd UPR EXP UPR=D_LOAD_FIL LAUNCHVAR add VARNAME=PASSWD VTYPE=P VVALUE=MyPassword

• VALMIN=, VALMAX=

  (Optionnel) Plage pour une variable de type Quantité uniquement. VALMIN et VALMAX doivent indiquer dans quelle plage la valeur de la variable devra être saisie. VALMIN indique la valeur inférieure, VALMAX la valeur supérieure de cette plage.
  Format : 12 caractères numériques ou 11 caractères numériques plus le signe.

  Défaut : 0 et 999999999999.

  Note : pour une valeur numérique négative, VALMIN est obligatoire, sinon il est défini ) 0 et le contrôle de la cohérence affichera l'erreur "Incorrect value".

  Exemples :

  uxupd UPR EXP UPR=D_LOAD_FIL LAUNCHVAR add VARNAME=VARNUM VTYPE=Q VVALUE=123

  uxupd UPR EXP UPR=D_LOAD_FIL LAUNCHVAR add VARNAME=VARNUMNEG VTYPE=Q VAMIN=-9999 VVALUE=-123

• VVALUE=

  Valeur de la variable. La valeur de la variable doit être compatible avec son type, son format et éventuellement sa plage, dans le cas contraire la commande sera refusée. Si la valeur contient des caractères non alphanumériques (espaces, /…) elle doit être encadrée de guillemets. La valeur d'une variable mot de passe doit être saisie en clair mais elle ne sera pas affichée dans la sortie de la commande.

  • Variable date : 10 caractères
  • Variable quantité : 12 caractères numériques ou 11 caractères numériques plus le signe.
  • Variables mot de passe et texte : 255 caractères

Items classes d'incompatibilité et successeurs

• XCLASS=

  Classe d'incompatibilité de l'Uproc. Indique que l'Uproc est incompatible avec une Uproc de cette classe.
  Format : entre parenthèses, les différentes classes d'incompatibilité sont séparées par des virgules, les espaces sont interdits. 255 caractères.

  Exemple : l'Uproc est déclarée incompatible avec les classes CLASSE1 et CLASSE2 :

  uxupd UPR EXP UPR=UPROC1 INCCLASS XCLASS=(CLASSE1,CLASSE2)

• SUCC_UPR=

  Successeur de l’Uproc. Spécifie l'Uproc successeur de l'Uproc courante. Les Uprocs successeurs sont examinées dans l'ordre dans lequel elles sont ajoutées et ne peuvent être ajoutées qu'une par une.
  Format: 64 caractères.

  Exemple:

  uxupd UPR EXP UPR=UPROC1 SUCCESSOR add UPROC1_SUCCESSOR_1

Items consignes de terminaison et conditions

• TERMNO=

  Numéro désignant la consigne de terminaison. Un numéro est associé à chaque consigne, deux consignes différentes ne peuvent pas porter le même numéro.
  Format : 2 caractères numériques.

• TERM=

  Consigne de terminaison. Indique le code de l'Uproc correspondant à l'événement qui doit être purgé par l'exécution de la consigne de terminaison.
  Format : 64 caractères alphanumériques.

  Exemple :

  uxupd UPR EXP UPR=D_LOAD_FIL TERMINS add TERMNO=01 TERM=D_LOAD_FIL PDATE="(-1,,)" STATUS=ABNORMAL

• CONDNO=

  Numéro désignant la condition. Un numéro est associé à chaque condition (quel que soit le type), deux conditions différentes ne peuvent pas porter le même numéro.
  Format : 2 caractères numériques.

• DEP=

  Condition d'enchaînement. Indique le code de l'Uproc correspondant à la condition d'enchaînement.
  Format : 64 caractères alphanumériques.

  Exemples :

  uxupd UPR EXP UPR=D_BACKUP DEPCON add CONDNO=01 DEP=D_LOAD_FIL MU="mu(SATURN)"

  uxupd UPR EXP UPR=D_BACKUP DEPCON add CONDNO=02 DEP=D_LOAD_FIL MU="hdp({AH})"

• INC=

  Condition de non simultanéité. Indique le code de l'Uproc correspondant à la condition de non simultanéité.
  Format : 64 caractères alphanumériques.

  Exemple :

  uxupd UPR EXP UPR=D_BACKUP INCCON add CONDNO=01 INC=D_BACKUP PDATE=ANY

• RES=

  Condition de ressource. Indique la référence de la ressource correspondant à la condition de ressource.
  Format : 64 caractères alphanumériques.

  Exemple :

  uxupd UPR EXP UPR=D_LOAD_FIL RESCON add CONDNO=01 RES=D_FIL_PAY

• IFPLANNED

  (Optionnel) Indicateur pour que la condition ne soit examinée par le lanceur que si l'Uproc conditionnante est planifiée / exécutée, en tenant compte des éléments : compte de soumission / session / UG et date de traitement. Si l'événement n'est pas présent et si le lancement n'est pas planifié, la condition est complètement ignorée (évite d'attendre un traitement qui n'aura pas lieu). Reportez-vous au Manuel de Référence pour la description complète.

• PDATE=

  (Optionnel) Contrôle sur la date de traitement. Indique le décalage recherché entre la date de traitement de l'Uproc conditionnée et de l'Uproc ou de la ressource conditionnante.
  Format :

  • (±n,n,n) : dépend de la période fonctionnelle de l'Uproc conditionnante, il s'exprime en "+ ou -" un nombre d'unités calendaire entre parenthèses, séparés par des virgules.
    Exemple : PDATE=(+1,-1,) pour une période fonctionnelle jour peut être traduit par : jour +1, mois –1, même année.
    
  • SAME: le contrôle doit porter sur la même date de traitement (globalement), si le contrôle doit porter sur la même unité calendaire un caractère blanc peut être utilisé dans le triplet.
  • ANY: le contrôle ne tient pas compte de la date de traitement, si le contrôle ne doit pas tenir compte d'une unité calendaire particulière la lettre "a" peut être utilisée dans le triplet.
    Exemple PDATE=(a, , ) peut être traduit par : quel que soit le jour pour le même mois et la même année.

  Le tableau suivant résume les unités calendaire proposées en fonction de la période fonctionnelle de l'Uproc :

  	Unités calendaires
  Période fonctionnelle	Jour	Sem.	Décad.	Quinz.	mois	2 M.	3 M.	4 M.	6 M.	12 M.
  Sans
  Jour	*				*					*
  Semaine		*								*
  Décade			*		*					*
  Quinzaine				*	*					*
  Mois					*					*
  Bimestre						*				*
  Trimestre							*			*
  Quadrimestre								*		*
  Semestre									*	*
  Année										*

  Défaut : SAME

• DTYPE=

  (Optionnel) Contrôle sur la date de traitement. Indique le type de jour (indiqué par PDATE) à considérer pour les Uprocs à période fonctionnelle jour.
  Format:

  • A: (any) quelque que soit le type de jour : ouvré, chômé, férié : le nombre indiqué par PDATE est calculé en jours calendaires,
  • W: (worked) le nombre indiqué par PDATE est calculé en jours ouvrés (en relation avec le calendrier de référence de l'unité de gestion considérée),
  • C: (closed) le nombre indiqué par PDATE est calculé en jours chômés,
  • H: (holiday) le nombre indiqué par PDATE est calculé en jours fériés.

• MU=

  (Optionnel) Contrôle sur les unités de gestion. Indique sur quel ensemble d'unités de gestion la condition doit être recherchée.

  • SAME: le contrôle doit porter sur la même unité de gestion.
  • MU(mu): le contrôle doit porter sur une unité de gestion spécifique, où mu représente le code de l'unité de gestion visée (64 caractères alphanumériques).
  • MUT(type): le contrôle doit porter sur un type d'unité de gestion, où type représente le type d'unité de gestion (1 caractère alphanumérique).
  • HDP({XY}): le contrôle doit porter sur des dépendances d'unité de gestion, où X représente le type des unités de gestion visées (1 caractère alphanumérique) et Y le type d'unité de gestion origine de la dépendance (1 caractère alphanumérique).

  Défaut : SAME

• ONE | ALL

  (Optionnel) Unités de gestion visées.Utilisé uniquement pour les conditions d'enchaînement ou de ressource, dans le cas où le contrôle des unités de gestion porte sur un type d'unité de gestion ou un TIH.

  • ONE signifie que la condition est attendue sur au moins une des unités de gestion visées.
  • ALL signifie que la condition est attendue sur toutes les unités de gestion visées.

  Défaut : ALL.

• SESS=

  (Optionnel) Contrôle sur la session. Indique sur quelle session la condition doit être recherchée.

  • ANY: le contrôle ne prend pas en compte la notion de session.
  • SAME: le contrôle porte sur la même session.
  • SAMERUN: le contrôle porte sur la même session et la même exécution.
  • EXPL(session): le contrôle porte sur une session spécifique, où session est le code de la session visée.

  Défaut : ANY

• STATUS=

  (Optionnel) Etat recherché. Indique le statut recherché de l'Uproc. Pour les conditions d'enchaînement ou consignes de terminaison :

  • TERMINATED: l'état recherché est "TERMINE".
  • ABNORMAL: l'état recherché est "INCIDENTE".

  Pour les conditions d'enchaînement uniquement :

  • ENDED: l'état recherché est "TERMINE" ou "INCIDENTE".
  • ABSENT: l'état recherché est "ABSENT".

Défaut : TERMINATED

• USER=

  (Optionnel) Compte de soumission. Indique avec quel type de contrôle sur le compte de soumission la condition doit être recherchée.

  • SAME: le contrôle porte sur le même compte utilisateur.
  • ANY: le contrôle ne prend pas en compte la notion de compte de soumission.

  Défaut : ANY

• EXPECTED | EXCLUDED

  (Optionnel) logique booléenne.

  • EXPECTED : Indique que la condition (ou la consigne) exprimée est recherchée vraie (valeur par défaut).
  • EXCLUDED : Indique que la condition (ou la consigne) recherchée doit être le contraire de ce qui est exprimé.

  Défaut : EXPECTED

• FATAL | NOFATAL

  (Optionnel) Comportement du lanceur vis à vis de l'absence de la condition.

  • FATAL : Si la condition exprimée n'est pas vérifiée lors du premier pilotage de l'Uproc, le Lanceur abandonne le lancement et le place dans l'état "refusé au pilotage".
  • NOFATAL : si la condition exprimée n'est pas vérifiée lors du premier pilotage de l'Uproc, le Lanceur placera le lancement en attente d'événement. L'Uproc sera à nouveau pilotée lors de l'arrivée de l'événement attendu.

  Défaut : NOFATAL

• VERIF | NOVERIF

  (Optionnel) Vérification du fichier pour une condition de ressource.

  • VERIF : indique que l'automate doit vérifier la présence physique de la ressource lors du pilotage de l'Uproc portant la condition.
  • NOVERIF : indique que l'automate ne doit pas vérifier la présence physique de la ressource (elle ne sera vue alors que comme une ressource logique).

  Défaut : VERIF

• LOCK | UNLOCK

  (Optionnel) Allocation de la ressource.

  • LOCK: indique que l'Uproc conditionnée s'attribue la totalité de la ressource durant son exécution et qu'aucune autre Uproc, conditionnée par cette ressource ne pourra s'exécuter. Si la condition de ressource est déclarée UNLOCK mais que la ressource a été définie "LOCK" le comportement sera identique.
  • UNLOCK : indique que l'Uproc conditionnée ne s'attribue que les quotas définis dans la condition (valeur par défaut). D'autres Uprocs conditionnées sur cette ressource pourront s'exécuter dans la mesure des quotas disponibles.

  Défaut : UNLOCK

• ATTRIB=

  (Optionnel) Utilisé pour les ressources de nature FIL. L'attribut du fichier à vérifier est l'un des suivants :
  EXIST, SIZE, DATEUNCHANGE, SIZEUNCHANGE, DATCREA, DATMOD, GROUP, PARSING.
  Reportez-vous au manuel de référence pour la signification de chaque attribut.

  Si ATTRIB OPER VALUE est vérifié, la condition est validée.

• OPER=

  (Optionnel) Utilisé pour les ressources de nature FIL. Opérateur utilisé pour vérifier la valeur de l'attribut du fichier. Il peut être l'un des suivants :
  #, =, <, >, <=, >=

• VALUE=

  (Optionnel) Utilisé pour les ressources de nature FIL.Valeur recherchée de l'attribut ATTRIB.

• QT1= et QT2=

  (Optionnel) Quotas nécessaires. Dans le cas d'une condition et d'une ressource déclarées UNLOCK, le Lanceur examine, au moment du pilotage, si les quotas exprimés dans la condition sont effectivement disponibles. S'ils le sont, l'Uproc sera soumise à l'exécution et bloquera les quotas correspondants. Plusieurs Uprocs peuvent ainsi se partager une même ressource.
  Format: Valeur numérique comprise entre 0 et 9999.

  Défaut : 0

Item Formule de lancement

• LFORM=

  (Optionnel) Formule de lancement. Logique booléenne qui exprime la totalité de la formule de lancement pour l'Uproc visée et l'action en cours.
  Format: longueur maximum doit être de 400 caractères.

  • Cnn : indique la condition numéro nn,
  • = : indique que la condition est recherchée vraie,
  • # : indique que la condition est recherchée fausse,
  • AND ou ET : indique que les deux conditions doivent être vérifiées,
  • OR ou OU : indique que l'une ou l'autre des deux conditions doivent être vérifiées.

  "AND" a priorité sur "OR", des parenthèses peuvent être utilisées pour définir des groupes de conditions réunies par des "OR". Par exemple : LFORM="((=C01 AND (=C02 OR #C03)))"

  Exemple :

  uxupd UPR EXP UPR=D_LOAD_FIL FORMULA LFORM=\"=C01 AND =C02\"

Items FTP 

• PARTNER=

  (Optionnel) Nom physique de la machine cible ou adresse IP.
  Format : 255 caractères alphanumériques max.

  Exemple : nom d'hôte

  uxupd UPR EXP UPR=GET_FILES FTP_GET PARTNER=”WinXP” ORIGIN_PATHNAME=”/tmp/” CRLF TYPE=BINARY UMASK=700 ACTION=REPLACE RETRY=3

  Exemple : adresse IP

  uxupd UPR EXP UPR=PUT_FILE FTP_PUT PARTNER=”192.168.1.100” ORIGIN_FILENAME=”data.txt” TARGET_PATHNAME=”/tmp/” ACTION=ABORT

• ORIGIN_FILENAME=

  (Optionnel) Nom du fichier à transférer.

  Défaut : tous les fichiers du répertoire

• ORIGIN_PATHNAME=

  (Optionnel) Nom du répertoire contenant les fichiers à transférer. Caractère * interdit.

  Défaut : répertoire de connexion de l'utilisateur FTP.

• TARGET_FILENAME=

  Nom du fichier cible.

  Défaut : inchangé.

• TARGET_PATHNAME=

  Nom du répertoire de réception des fichiers. Caractère * interdit.

  Défaut : répertoire de connexion du compte de soumission de l'Uproc.

• LOGON=

  (Optionnel) Utilisateur de connexion FTP.

  Défaut : anonymous

• PASSWORD=

  Mot de passe de l'utilisateur de connexion FTP. Les mots de passe ne sont pas affichés dans l'interface graphique.

• MODE=

  (Optionnel) Type de transfert : ASCII ou BINARY

  Défaut : ASCII

• ACTION=

  (Optionnel) Comportement si le fichier cible existe déjà : REPLACE (remplacer), ABORT (annuler erreur), APPEND (concaténer, FTP_PUT uniquement) ou NONE (ne rien faire).

  Défaut : ABORT

• CRLF | NOCRLF

  (Optionnel) Conversion des caractères CR. L’option CRLF n’est pas disponible pour FTP_PUT.

  • CRLF: tous les caractères CR sont convertis en LF durant le transfert ASCII.
  • NOCRLF: pas de conversion durant le transfert ASCII. sauf pour les soumissions.

  Défaut :NOCRLF

• DELETE | NODELETE

  (Optionnel) Suppression du fichier origine

  • DELETE: supprime le fichier origine si le transfert est réussi.
  • NODELETE : le fichier origine n'est pas supprimé si le transfert est réussi.

  Défaut : NODELETE

• NEWER | NONEWER

  (Optionnel) Vérification de la date du fichier

  • NEWER : transfère le fichier si sa date de modification est plus récente que celle du fichier cible.
  • NONEWER : transfère le fichier quelle que soit sa date.

  Défaut : NONEWER.

  Attention ! Cette option n'est pas supportée par défaut par SFTP. Pour savoir si SFTP a été configuré, reportez-vous à la valeur du paramètre nœud U_FT_SFTP. U_FT_SFTP.

• RECURSIVE | NORECURSIVE

  (Optionnel) Fichiers transférés

  • RECURSIVE : transfère tous les fichiers et sous-répertoires contenus dans le chemin ORIGIN_PATHNAME (les paramètres ORIGIN_FILENAME et TARGET_FILENAME ne doivent plus être saisis). Le nombre de niveaux de répertoires ne doit pas dépasser 150.
  • NORECURSIVE : seuls les fichiers du répertoire courant sont transférés.

  Défaut : NORECURSIVE.

  L'option RECURSIVE utilise en interne la commande FTP LIST pour obtenir la liste des fichiers et des répertoires du serveur distant. La réponse attendue du serveur doit être formatée de telle sorte que chaque ligne doit commencer par les droits des fichiers au format UNIX. Cette réponse variant d'un serveur à un autre, la fonction ne pourra pas être utilisée si la réponse a un format différent. Dans ce cas, un fonctionnement dégradé peut être utilisé : chaque fichier du serveur distant est testé à l'aide d'une commande FTP CWD pour vérifier l'existence d'un répertoire. Ce fonctionnement dégradé est moins performant mais il peut être activé à l'aide du paramètre nœud U_FT_GET_DIR_FAILOVER dans la catégorie "Paramètres nœud – Paramétrage FTP".

• BUFFER_SIZE=

  (Optionnel) Définit la taille du buffer de communication en blocs de 512 octets.
  Format : nombre entier sur 2 chiffres entre 01 et 64.

• UMASK=

  (Optionnel) Masque appliqué aux permissions du fichier local.
  Format : 3 caractères numériques.

  • Uprocs FTP_GET : Si UMASK n'est pas défini ou est défini à 000, les fichiers sont téléchargés par défaut avec les permissions 666 (pour un utilisateur root) ou 640 (pour un utilisateur non root). Sinon, les permissions du fichier sont obtenues en soustrayant UMASK de la valeur par défaut (666 ou 640).
  • Uprocs FTP_PUT : UMASK n'est pas utilisable. Sur systèmes UNIX, les fichiers sont téléchargés avec leurs permissions d’origine. Sous Windows, les fichiers sont téléchargés avec les permissions 755 (les permissions octal n’existant pas nativement sous Windows).

Autres items

• TUPR=

  Code de l'Uproc résultat de la duplication.
  Format : 64 caractères alphanumériques.

• TVUPR=

  Version de l'Uproc résultat de la duplication.
  Format : 3 caractères numériques.

• TLABEL=

  (Optionnel) Libellé descriptif de l'Uproc résultat de la duplication.
  Format : 64 caractères alphanumériques.

• APPL=

  Code de l'application. Utilisée avec uxlst et uxshw : permet la sélection des Uprocs rattachées à une application (valeur générique acceptée).
  Format : 64 caractères alphanumériques.

• DOM=

  Code domaine. Format : 1 caractère alphanumérique. Indique à quel domaine l'Uproc est rattachée.

• SCRIPT

  (Optionnel) Peut être utilisé avec la commande uxshw upr uniquement. Cette option permet d'afficher en sortie le script de l'Uproc si le paramètre nœud U_UPR_SCRIPT_NODISP (catégorie Réglages avancés) a été défini à "Oui". Reportez-vous au Manuel Utilisateur d'Univiewer.

  Défaut : cette variable n'est pas définie et le script de l'Uproc est affiché même si l'item SCRIPT est absent.

• TESP=

  (Optionnel) Code de l'espace cible du transfert : X pour Exploitation, S pour Simulation ou I pour intégration.

• ENABLE

  (Optionnel) Option de libération. Indique si l'Uproc sera insérée dans l'état libéré. L'action de libération sera nécessaire avant toute modification d'Uproc si l'objet est inséré avec le qualifier NOENABLE.

  Défaut : ENABLE.

• INF | FULL

  (Optionnel) Option d'affichage.

  • INF : Limite l'affichage au nom des objets.
  • FULL : Affiche toutes les informations disponibles sur la liste des objets.

  Défaut : FULL

• OUTPUT=

  • Fichier de sortie de la commande uxext.
  • (Optionnel) Fichier de stockage de l'affichage pour les commandes uxshw ou uxlst.

  Défaut : la sortie est envoyée à l'écran.

• INPUT=

  Fichier d'entrée pour la commande uxins.

• NOVERIF

  (Optionnel) peut être utilisé avec la commande uxext uniquement. Cette option permet de ne pas vérifier le fichier d'extraction avant d'y écrire de nouveaux enregistrements et d'améliorer ainsi les performances de cette commande. Cet item ne doit être utilisé que pour un nouveau fichier.

• REPL

  (Optionnel) Indicateur de remplacement. Indique si l'enregistrement extrait (inséré) annule et remplace l'enregistrement déjà existant dans le fichier de destination;

  Défaut : l'extraction (l'insertion) est refusée pour chaque enregistrement déjà existant (signalé par un message pour chaque occurrence).

Exemples

• Crée une Uproc de type commande :

  uxadd UPR EXP UPR=CMD_UPR LABEL=\”My Command Uproc\” UPT=CMD COMMAND=netstat EXECDIR=/temp FPERIOD=D APPL=EJ MEMO=O NBPER=1

• Crée l'Uproc D_LOAD_FIL version 000 label "Chargement du fichier" dans l'environnement courant (société, nœud) en espace exploitation, période fonctionnelle : jour, fichier de commande : c:\temp\ D_LOAD_FIL.bat, application BK :

  uxadd UPR EXP UPR=D_LOAD_FIL LABEL=\"Loading of file\" UPT=CL_EXT CLFIL=c:\temp\D_LOAD_FIL.bat APPL="BK"

• Duplique une Uproc :

  uxdup UPR EXP UPR=IU_TEST VUPR=000 TUPR=IU_TEST2 TVUPR=000 TLABEL=\"Duplicated Uproc\"

• Modifie la période fonctionnelle de l'Uproc à jour, mémorisée 1 exécution 1 période :

  uxupd UPR EXP UPR=D_LOAD_FIL GENINF FPERIOD=D memo="O" NBPER=1

• Crée l'Uproc DEF_UPR de type CL_EXT (script: "C:\script.bat"), et défini les valeurs par défaut des paramètres Information à "Default information for this Uproc" et Sévérité à 1 :

  uxadd UPR EXP UPR=DEF_UPR APPL=U_ UPT=CL_EXT CLFIL=C:\script.bat DEFINFO=\"Default information for this Uproc\" DEFSEV=0001

• Modifie l'Uproc D_LOAD_FIL pour lui définir une formule de lancement composée de deux conditions de ressources en ET, la première sur la présence de la ressource fichier D_FIL_PAY et la seconde sur la disponibilité totale de la ressource logique D_BASE :

  uxupd UPR EXP UPR=D_LOAD_FIL RESCON add CONDNO=01 RES=D_FIL_PAY

  uxupd UPR EXP UPR=D_LOAD_FIL RESCON add CONDNO=02 RES=D_BASE LOCK

  uxupd UPR EXP UPR=D_LOAD_FIL FORMULA LFORM=\"=C01 ET =C02\"

• Crée l'Uproc D_BACKUP en espace exploitation label "Sauvegarde" dans l'environnement courant, période fonctionnelle : jour, fichier de commande : c:\temp\D_BACKUP.bat, application BK (domaine T) :

  uxadd UPR EXP UPR=D_BACKUP LABEL=Sauvegarde FPERIOD=d UPT=CL_EXT CLFIL=c:\temp\D_BACKUP.bat appl=BK

• Modifie l'Uproc D_BACKUP pour lui définir une formule de lancement composée d'une condition d'enchaînement sur l'Uproc D_LOAD_FIL (dans l'état Terminé par défaut). Cette Uproc libérera dans son script la ressource D_BASE allouée en totalité par l'Uproc D_LOAD_FIL :

  uxupd UPR EXP UPR=D_BACKUP DEPCON add CONDNO=01 DEP=D_LOAD_FIL

  uxupd UPR EXP UPR=D_BACKUP FORMULA LFORM="=C01"

• Crée pour l'Uproc D_LOAD_FIL une variable VARTXT de type texte, d’une longueur maximum de 30 caractères, de valeur par défaut "XY_VARTXT" :

  uxupd UPR UPR=D_LOAD_FIL LAUNCHVAR add VARNAME=VARTXT VTYPE=T VVALUE="XY_VARTXT" VFORMAT="30"

• Crée pour l'Uproc D_LOAD_FIL une variable de type date au format année/mois/jour, de valeur par défaut 1999/12/31 :

  uxupd UPR UPR=D_LOAD_FIL LAUNCHVAR add VARNAME=VARDATE VTYPE=D VVALUE="1999/12/31" VFORMAT="AAAA/MM/JJ"

• Affiche les détails de l'Uproc à l'écran :

  uxshw UPR EXP UPR=D_LOAD_FIL

• Liste toutes les Uprocs dans le fichier c:\temp\lstUpr.txt :

  uxlst UPR OUTPUT="c:\temp\lstUpr.txt"

• Supprime toutes les Uprocs commençant par "TEST" :

  uxdlt UPR UPR=TEST*

• Transfère de l'espace Application vers l'espace Exploitation toutes les Uprocs qui commencent par "D_" :

  uxtra UPR app UPR=D_* TESP=X

• Définit la version 002 des Uprocs "D_" comme la version courante :

  uxscv UPR APP UPR=D_* VUPR=002

• Libère toutes les Uprocs dans l'environnement courant :

  uxrls UPR UPR=*

• Extrait toutes les Uprocs commençant par D_ de l'espace exploitation et archive les données dans le fichier c:\temp\DOC.ext :

  uxext UPR EXP UPR=D* output=c:\temp\DOC.ext

• Insère toutes les Uprocs du fichier c:\temp\DOC.ext dans l'environnement courant (société, nœud) en espace exploitation sauf si elles existent déjà :

  uxins UPR EXP UPR=* input=c:\temp\DOC.ext