Cette section décrit les commandes sur les exceptions. L'Environnement par défaut (espace - nœud) peut être modifié.
La commande uxadd OEX ajoute une exception dans la liste des exceptions. Sa syntaxe est la suivante :
uxadd OEX TYPE=SKIP|BYPASS|HOLD|JUMP MU=mu|MUT=mut UPR=uproc [VUPR=version] [TSK=task] [TASK_MU=mu] [SES=session] [VSES=version] [NUMLANC=numlanc] [NUMSESS=numsess] [NUMORDART_SE=number] [EVT|NOEVT] [LABEL=label] [PDATE=date] [ESTART=(date,hhmm)|NOW] [EEND=(date,hhmm)|NOW+1] [MAXCOUNT=nnnnnn]
La commande uxupd OEX modifie une exception. Sa syntaxe est la suivante :
uxupd OEX [TYPE=SKIP|BYPASS|HOLD|JUMP] MU=mu|MUT=mut UPR=uproc [VUPR=version] [TSK=task] [SES=session] [VSES=version] [NUMLANC=numlanc] [NUMSESS=numsess] [NUMORDART_SE=number] [EVT|NOEVT] [LABEL=label] [PDATE=date] [ESTART=(date,hhmm)] [EEND=(date,hhmm)] [LSTART=(date,hhmm)] [LEND=(date,hhmm)][MAXCOUNT=nnnnnn]
La commande uxdlt OEX supprime une exception. Sa syntaxe est la suivante :
uxdlt OEX TYPE=SKIP|BYPASS|HOLD|JUMP MU=mu|MUT=mut UPR=uproc [VUPR=version] [TSK=task] [SES=session] [VSES=version] [NUMLANC=numlanc] [NUMSESS=numsess] [NUMORDART_SE=number] [PDATE=date] [ESTART=(date,hhmm)] [EEND=(date,hhmm)]
La commande uxlst OEX liste les exceptions. Sa syntaxe est la suivante :
uxlst OEX [TYPE=SKIP|BYPASS|HOLD|JUMP] [MU=mu|MUT=mut] [UPR=uproc] [VUPR=version] [TSK=task] [SES=session] [VSES=version] [NUMLANC=numlanc] [NUMSESS=numsess] [NUMORDART_SE=number] [PDATE=date] [ESTART=(date,hhmm)] [EEND=(date,hhmm)] [FULL|INF] [OUTPUT=filename]
TYPE=
(Obligatoire pour uxadd) Type de l'exception. Saisir l'un des quatre mots- clé ci-dessous :
MU=
(Obligatoire pour uxadd si MUT est absent) Saisissez le code de l'unité de gestion ou * (valeur générique acceptée sauf pour uxadd), incompatible avec MUT.
Format : 64 caractères alphanumériques.
MUT=
(Obligatoire pour uxadd si MU est absent) Saisissez le code du type de l'unité de gestion ou * (valeur générique acceptée sauf pour uxadd), incompatible avec MU.
Format : 1 caractère alphanumérique.
UPR=
(Obligatoire pour uxadd) Saisissez le code de l'Uproc ou * (valeur générique acceptée sauf pour uxadd).
Format : 64 caractères alphanumériques.
VUPR=
(Optionnel) Version de l'Uproc. Permet la saisie d'une version particulière d'une Uproc (inutile avec SIM et EXP).
Format : 3 caractères numériques.
TSK=
(Optionnel) Code de la tâche principale : une exception ne peut pas être créée sur une tâche spécifique.
Format : 64 caractères alphanumériques.
TASK_MU=
(Optionnel) Code de l'Unité de Gestion de la tâche. L'Unité de Gestion de la tâche et celle de l'exception peuvent être différentes si une Unité de Gestion spécifique ou un TIH est défini dans la Session (ou dans le cas d'une tâche provoquée ou optionnelle). Si le code de la tâche n'est pas spécifié, ce champ n'est pas utilisé. Si le code de la tâche est spécifié et que ce champ est vide, le code de l'Unité de Gestion de la tâche est automatiquement utilisé comme code de l'Unité de Gestion de l'exception.
Format : 64 caractères alphanumériques.
SES=
(Obligatoire si NUMSESS est spécifié) Code session.
Format : 64 caractères alphanumériques.
VSES=
(Optionnel) Version de session. Format : 3 caractères numériques (inutile avec EXP).
NUMSESS=
(Optionnel) Numéro d'exécution de la session.
Format : 7 caractères numériques. Permet la saisie du numéro d'exécution de la session. Ce numéro permet de différencier deux Lancements portant sur la même session sur la même unité de gestion pour la même date de traitement.
NUMLANC=
(Optionnel) Numéro de lancement. Permet la saisie d'un numéro de lancement. Ce numéro permet de différencier deux lancement portant sur la même tâche pour la même date de traitement. Si NUMLANC est renseigné avec une valeur >0, VUPR (si différent de la valeur par défaut), SES (si nécessaire) et VSES (idem) doivent également être saisis.
Format : 7 caractères numériques.
NUMORDART_SE=
(Obligatoire si NUMSESS est spécifié et pour les exceptions de type JUMP) Numéro de l'Uproc dans la session pour différencier deux Uprocs dans la même session.
Format : 7 caractères numériques.
EVT | NOEVT
(Optionnel) Pour les exceptions de type JUMP, si l'exécution n'a pas eu lieu :
Défaut : NOEVT
LABEL=
(Optionnel) Description de l'exception.
Format : 64 caractères alphanumériques.
PDATE=
(Optionnel) Date de traitement associée au lancement. La valeur dépend de la période fonctionnelle de l'Uproc.
Format indiqué par la valeur du paramètre U_FMT_DATE. Le nombre de caractères doit être respecté exactement.
Si PDATE est valorisé par des zéros (00/00/0000,0000) pour les commandes uxadd et uxupd oex, l'exception sera définie sans date de traitement et sera appliquée seulement aux lancements sans date de traitement.
ESTART=
(Optionnel) Date et heure de début de la plage d'exception (pour uxadd) ou filtre sur cette plage pour les autres commandes.
Format : (U_FMT_DATE,hhmm)
EEND=
(Optionnel) Date et heure de fin de la plage d'exception (pour uxadd) ou filtre sur cette plage pour les autres commandes.
Format : (U_FMT_DATE,hhmm)
Si ESTART et EEND sont valorisés par des zéros (00/00/0000,0000) l'exception sera définie sans plage horaire.
LSTART=
(Optionnel) Nouvelle date et heure de début de la plage d'exception.
Format : (U_FMT_DATE,hhmm).
LEND=
(Optionnel) Nouvelle date et heure de fin de la plage d'exception.
Format : (U_FMT_DATE,hhmm).
MAXCOUNT=
(Optionnel) Nombre de lancement pour lesquels l'exception sera appliquée. Au-delà, l'exception ne sera plus appliquée même si la plage horaire est valide ou même si la date de traitement est valide.
INF | FULL
(Optionnel) Option d'affichage.
Défaut : INF
OUTPUT=
(Optionnel) Nom du fichier de stockage de l'affichage pour la commande uxlst. Si l'item n'est pas renseigné, la sortie est envoyée à l'écran.
Crée une exception de type "lancement sans pilotage" pour le lancement de l'Uproc D_LOAD_FIL sur l'unité de gestion SIEGE pour une date au format AAAMMJJ :
uxadd OEX EXP TYPE=BYPASS UPR=D_LOAD_FIL MU=SIEGE PDATE=20110714
Modifie cette exception pour en changer le type à JUMP :
uxupd OEX EXP TYPE=JUMP UPR=D_LOAD_FIL MU=SIEGE
Supprime l'exception créée et modifiée précédemment :
uxdlt OEX EXP TYPE=JUMP UPR=D_LOAD_FIL MU=SIEGE PDATE=20110714
Liste toutes les exceptions dans le fichier c:\temp\LstOex.txt :
uxlst oex full output=c:\temp\LstOex.txt