Tutoriels Forum ORSYP Dollar Universe Coquille Batch ubatch

Tutoriels Forum ORSYP : Dollar Universe – Coquille Batch (u_batch) Février 2009 © Copyright ORSYP 2009

Exécution d’un job § Quand un job est soumis dans Dollar Universe, ce n’est pas seulement le script de l’ Uproc qui est exécuté, mais la “coquille batch” avec les paramètres nécessaires liés au job § La coquille batch est le fichier u_batch (+. bat sur Windows, +. com sur VMS, etc. . . ) localisé dans le répertoire exec § Arborescence des process pour un job sur Unix : root 28661 1 . /uxord TST 530 X unixbox 01 root 2747 28661 . /uxord TST 530 X unixbox 01 root 2748 2747 sh -c su - root -c '/Societe. Support/TST 530/exec/u_batch "ro root 2749 2748 -sh -c /Societe. Support/TST 530/exec/u_batch "root" "998" "TST root 2761 2749 /bin/ksh /Societe. Support/TST 530/exec/u_batch root 998 TST 530 § Job VMS en queue : 442 XAXP 02 SLEEP 30000 SYSTEM Executing Submitted 26 -FEB-2009 14: 42: 49. 44 /KEEP /LOG=S_FISERV_LOGMX: XAXP 02 SLEEP 30. 0000358 /PARAM=("SYSTEM", "998", "FISERV", "AXPBOX 02", "20090101 0000000421 00", "AX", "S_FISERV_PROCX: SLEEP 30. 000", "0000358") /NOPRINT /PRIORITY=100 File: _AXP 02$DKA 100: [TESTS. FISERV. EXEC]U_BATCH. COM; 1 (executing) © Copyright ORSYP - 2009 1

Coquille batch § La coquille batch comprend ü Pré-traitement : récupération de l’environnement (a), init du job (b), pré-traitement personnalisé (c) ü Exécution du script de l’ Uproc (d) ü Post-traitement : post-traitement personnalisé (e), terminaison du job (f) § Script u_batch Windows (“noyau”) : … call %UXMGR%uxsetenv. bat (a) … %UXEXE%uxjobinit "%S_USERNAME%" "%S_CODAUTEUR%" "%S_SOCIETE%" "%S_UG%" "LOGISTIC" "%S_ESPEXE%" %S_UPROC% "%S_NUMPROC%“ (b) … if EXIST %UXMGR%U_ANTE_UPROC. BAT call %UXMGR%U_ANTE_UPROC. BAT (c) … call %s_uproc_file% (d) … if EXIST %UXMGR%U_POST_UPROC. bat call %UXMGR%U_POST_UPROC (e) … %UXEXE%uxjobend %RESEXE% (f) § Les pré/post-traitements personnalisés sont optionnels © Copyright ORSYP - 2009 2

Coquille batch Dollar Universe Soumission du Job Directe (Unix / Windows) OS (Job Batch) Ante Uproc DQM (Unix / Windows) QM (VMS) Initialisation $U (a + b) (c) Soumission (CL de l’ Uproc) (d) Post Uproc Terminaison (e) Côté client u_batch. bat (Windows) u_batch (Unix) U_BATCH. COM (VMS) © Copyright ORSYP - 2009 Terminaison $U (f) Côté Dollar Universe 3

Coquille batch § Récupération de l’environnement : définition des variables d’ environnement (User batch, Société $U, UG, Espace, Uproc, Numproc, uxsetenv) § Init du job (uxjobinit: MAJ du statut du job, récupération des paramètres & variables du job, contrôle des droits sur le script) § Pré-traitement optionnel (Ante Uproc): script personnalisable § Script de l’ Uproc (sur certains OS c’et une copie temporaire du script de l’ Uproc qui est exécutée) § Post-traitement optionnel (Post Uproc): script personnalisable § Terminaison du job (uxjobend: MAJ des statistiques, récupération du Code Retour, réveil du Lanceur) § Les pré & post traitements personnalisables permettent de : ü Définir ou MAJ des variables qui sont communes à tous ou à la plupart des jobs (jobs communs à une application, une UG etc. . . ) ü Activer des alarmes, un envoi d’email, une mise en archive ou de renseigner des statistiques personnalisées, etc. . . © Copyright ORSYP - 2009 4