DLL utilisateur

La DLL utilisateur vous permet d'effectuer des traitements complexes lors d'une mise à niveau de la base de données.

Elle est implémentée sous la forme d'un programme SADELIA ou VADELIA BATCH respectant une interface d'appel précise. Ce programme s'exécute en connexion à la base de données.

Avec une base SQL ou BTrieve, le programme peut être un SADELIA ou un VADELIA utilisant le serveur logique LOCAL. Dans le cas d'une base AS/400, le programme doit obligatoirement être un SADELIA et doit être déployé sur le serveur avant d'exécuter DBTOOL sur le poste client.

En version JAVA le programme doit obligatoirement être un programme Visual Adélia de type BATCH généré en mode Java "Standard" (les programmes de type SADELIA ne sont pas supportés). Les classes et les ressources du programme doivent être présentes dans le CLASSPATH à l'exécution.

Les lignes suivantes doivent être insérées dans la section déclarative du programme SADELIA :

* Paramètre réservé – NE PAS MODIFIER

NUM_BIN_4 Reserved

* Numéro de service appelé

NUM_BIN_4 ActionCode

* Contient le numéro de la version d'origine durant la phase de migration

NUM_E(15,9) Param1

* Contient le numéro de la version intermédiaire durant la phase de migration

NUM_E(15,9) Param2

* Code retour indiquant le statut de l'exécution

* 0 => exécution ok

* > 0 => avertissement, l'exécution de l'utilitaire continue

* < 0 => erreur, l'exécution de l'utilitaire s'arrête

NUM_BIN_4 ReturnCode

PARAM Reserved ActionCode Param1 Param2 ReturnCode

La variable ActionCode contient le numéro de service requis.

Service	Description	Action requise
0	Réservé.	Indiquer 0 dans ReturnCode.
1	Réservé.	Indiquer 0 dans ReturnCode.
2	Demande la version.	Indiquer le numéro de version courant dans Param2. Indiquer le statut de l'opération dans ReturnCode.
3	Réservé.	Indiquer 0 dans ReturnCode.
4	Appelé avant l'exécution du script de la section PDM.	Exécuter les opérations nécessaires à votre application. Indiquer le statut de l'opération dans ReturnCode.
5	Appelé avant l'exécution du script de la section Data.	Exécuter les opérations nécessaires à votre application. Indiquer le statut de l'opération dans ReturnCode.
6	Appelé après l'exécution du script de la section Data.	Exécuter les opérations nécessaires à votre application. Indiquer le statut de l'opération dans ReturnCode.

L'algorithme de base de la mise à jour devient :

appel_service (reserved, 2, version_base, 0, coderetour)

tant_que version_base < version_courante

si rechercher_script_pdm (version_base, version_intermediaire) = erreur

sortir (erreur)

fin

appel_service (reserved, 4, version_base, version_intermediaire, coderetour)

si (coderetour <> 0)

sortir (erreur)

fin

si executer_script_pdm (version_base) = erreur

sortir (erreur)

fin

appel_service (reserved, 5, version_base, version_intermediaire, coderetour)

si (coderetour <> 0)

sortir (erreur)

fin

si rechercher_executer_script_donnees (version_base) = erreur

sortir (erreur)

fin

appel_service (reserved, 6, version_base, version_intermediaire, coderetour)

si (coderetour <> 0)

sortir (erreur)

fin

version_base = version_intermediaire

REFAIRE

↑ Haut de page