Tutoriels Forum ORSYP Dollar Universe Steps dUproc Janvier

Tutoriels Forum ORSYP : Dollar Universe – Steps d’Uproc Janvier 2011 © Copyright ORSYP 2011

Concept § Les steps (ou jalons) dans le script d’une Uproc de Dollar Universe permettent de reprendre un job incidenté depuis un point choisi : Ø Depuis le step où le job s’est incidenté (valeur par défaut quand les steps sont utilisés) Ø Depuis le début (en utilisant le step 00) Ø Depuis n’importe quel autre step Ø Depuis le step 99. Ceci est une bonne pratique recommandée par ORSYP Professional Services. Le step 99 contient habituellement simplement le code retour succès. Il est ainsi possible de reprendre un job incidenté sans en exécuter le contenu fonctionnel mais en déclenchant la suite de la Session § Les steps sont un bon moyen de trouver un compromis entre des Uprocs monofonctionnelles et des Uprocs avec d’énormes scripts : Ø Éviter d’avoir des milliers et des milliers d’Uprocs élémentaires Ø Éviter d’avoir des scripts énormes qui sont difficiles à maintenir et à troubleshooter © Copyright ORSYP - 2011 1

Commande et variable § Commande pour définir le step courant dans le script : Ø uxset step nn Ø L’exécutable uxset est localisé dans le répertoire exec Ø nn est la valeur du step (de 00 à 99) Ø Nota : Il peut être utile de laisser des steps disponibles dans le cas de futurs ajouts dans le script § Variable stockant le step : Ø S_NUMJALON (utiliser $S_NUMJALON sur Unix, %S_NUMJALON% sur Windows) Ø Vous utiliserez cette variable et testerez sa valeur pour aller au jalon adéquat Ø Nota : La valeur du step est calculée en sortie du job § Il est aussi possible d’utiliser commande et variable dans l’ ante uproc Ø Le step 99 peut être géré dans le script u_ante_uproc, permettant une implémentation facile de cette fonctionnalité même quand elle n’a pas été prévue initialement © Copyright ORSYP - 2011 2

Exemples § Script UNIX : STEP 00() { env } STEP 01() { $UXEXE/uxset step 01 $UXEXE/uxset msg "**********" $UXEXE/uxset msg " I ’m the 1 st step " $UXEXE/uxset msg "**********" sleep 20 } STEP 02() { $UXEXE/uxset step 02 VAR=7 sleep 20 $UXEXE/uxset parm "Literal" $VAR "Bye" exit 0 } STEP 99() { $UXEXE/uxset step 99 $UXEXE/uxset msg "****************" $UXEXE/uxset msg " Technical recovery step 99 " $UXEXE/uxset msg "****************" exit 0 } $UXEXE/uxsurjob 30 $S_NUMPROC & set -xv case $S_NUMJALON in 00) STEP 00; STEP 01; STEP 02; ; 01) STEP 01; STEP 02; ; 02) STEP 02; ; 03) STEP 99; ; *) $UXEXE/uxset msg " Relaunch at the wrong step " ; ; esac Cette Uproc s’incidente si elle dépasse 30 secondes d’elapsed time et utilise les jalons. Elle remonte un message à la trace automate dans le 1 er step, passe 3 paramètres (littéraux et variables) à tous ses fils dans la Session dans le 2 e step, et met en œuvre un step 99 de reprise technique. © Copyright ORSYP - 2011 3

Exemples § Script Windows : echo on %UXEXE%uxsurjob 30 %S_NUMPROC% if %S_NUMJALON% == 00 goto STEP%S_NUMJALON% if %S_NUMJALON% == 01 goto STEP%S_NUMJALON% if %S_NUMJALON% == 02 goto STEP%S_NUMJALON% if %S_NUMJALON% == 99 goto STEP%S_NUMJALON% %UXEXE%uxset msg "*****************" %UXEXE%uxset msg " Relaunch at the wrong step " %UXEXE%uxset msg "*****************" set resexe=1 goto FIN : STEP 00 set : STEP 01 %uxexe%uxset step 01 %UXEXE%uxset msg "***********" %UXEXE%uxset msg " I ’m the 1 st step " %UXEXE%uxset msg "***********" %UXEXE%uxsleep 20 : STEP 02 %uxexe%uxset step 02 set Var=7 %UXEXE%uxsleep 20 %UXEXE%uxset parm "Literal" "%Var%" "Bye" set resexe=0 goto FIN : STEP 99 %uxexe%uxset step 99 %UXEXE%uxset msg "****************" %UXEXE%uxset msg " Technical recovery step 99 " %UXEXE%uxset msg "****************" set resexe=0 : FIN Cette Uproc s’incidente si elle dépasse 30 secondes d’elapsed time et utilise les jalons. Elle remonte un message à la trace automate dans le 1 er step, passe 3 paramètres (littéraux et variables) à tous ses fils dans la Session dans le 2 e step, et met en œuvre un step 99 de reprise technique. © Copyright ORSYP - 2011 4