EXE-REB-ARD : Exécution requete REB sur base archivage dynamique
BUT
Ce mot clé permet d’exécuter une requête de type REB et dont le contenu fait référence à des tables d’une base d’archivage. La base d’archivage sera donnée à l’appel du mot clé par initialisation de la variable VBP.Base_ARD.
Le paramètre utilisateur Paramètres généraux (PARAM-GEN,PARAMETRES,ML-BAS-ARD) doit contenir, dans sa désignation, la référence d’une base d’archivage du site ou doit être vide.
SYNTAXE
VBP.Base_ARD = Base_Archivage
EXE-REB-ARD REQUETE= Requête AVEC ERREUR= Erreur
PARAMETRES
Paramètre | E/S | O | Type | Description |
Base_Archivage | Oui | Caractère | Variable partagée VBP.Base_ARD contenant la référence de la base d’archivage devant être utilisée par la requête à exécuter. | |
Requête | E | Oui | Caractère | Référence requête REB à exécuter. Cette référence peut être donnée par une variable locale, une constante globale, une constante locale ou bien une référence de requête REB choisie parmi la liste des requêtes REB disponibles. |
Erreur | S | Oui | Caractère | Code retour d’exécution de la requête REB. Il s’agit d’une variable locale interne à la requête (voir Notes ci-dessous pour des explications complémentaires) |
EXEMPLES
POUR CHAQUE ISIA.ISTSBase AVEC ISIA.ISTSBase.ISTsDefProjet = CLO. « DIAPASON » ET
ISIA.ISTSBase.ISTSTypBase = CLO. « A » :
INIT VBP.Base_ARD = ISIA.ISTSBase.ISTsDefBase
EXE-REB-ARD REQUETE=CalculARD AVEC ERREUR= VLO.Erreur
Cette instruction exécute la requête REB dont la référence est « CalculARD » ; le retour de la requête est retranscris dans la variable locale Erreur.
VLO.NomReq = CLO."CalculARD"
EXE-REB REQUETE= VLO.NomReq AVEC ERREUR= VLO.Erreur
Cette instruction exécute la requête REB dont la référence est contenue dans la variable locale VLO.NomReq précédemment initialisée ; le retour de la requête est retranscris dans la variable locale Erreur.
NOTES
La variable locale Erreur est vide si l’exécution s’est correctement déroulée ; sinon, elle peut contenir des codes erreurs internes à DIAPASON (dont les libellés correspondent à requête inexistante ou non disponible) ou la valeur initialisée dans le mot clé LC-ERREUR de la requête REB venant d’être exécutée.
Toutes les variables de type SCR, VCR, VBP et XML sont partagées entre la requête père et la requête REB enfant. Dans le cas particulier des contextes des requêtes REP et LOP, les variables VBP utilisées dans ce type de requête doivent auparavant être déclarées utilisées dans la partie REN et LOS correspondante.
La connexion à la base d’archivage étant dynamique et forcée par le mot clé EXE-REB-ARD, il n’est pas nécessaire que la requête de niveau le plus haut dispose d’une base de données d’archivage à connecter (parmi les bases nécessaires) pour l’exécution d’elle même et de toutes les requêtes REB susceptibles d’être utilisées.