Le programme de traitement d'erreurs ("Error handler") est un programme Visual Adélia Cloud généré.
Par défaut, le programme SVCERR (com.hardis.adelia.cloud.common.dialogs.SVCERR) fourni par HARDIS reprend les mêmes fonctionnalités que celui intégré en v8.2. Cependant, HARDIS fournit également un programme SVCERC (com.hardis.adelia.cloud.common.dialogs.SVCERC) exploitant les fonctionnalités présentées ci-dessous.
Remarque : le choix du programme du traitement d'erreurs se fait dans le fichier de configuration des paramètres d'exécution CfgParamExec.properties à l'aide de la clé SVCERR_HDLER.
Exemple :
SVCERR_HDLER=com.hardis.adelia.cloud.common.dialogs.SVCERC
Par défaut, une erreur d'exécution de service génère toujours l'affichage d'une boîte de message.
Le programme SVCERRC propose une nouvelle boîte de dialogue initialisée à l'aide des valeurs définies dans le fichier MwError.properties.
Les nouvelles options de MwError.properties peuvent être fixées à l'aide des macros suivantes :
EXIT_ON_ERROR = 1 |
Permet d'interrompre le programme. |
REGISTER_ERROR = 1 |
Permet de générer une trace de niveau *ERROR dans le mécanisme de traces. |
REGISTER_APP_NAME = NomApp |
Nom utilisé pour préfixer la trace Middleware. |
DISCONNECT_ON_ERROR = 1 |
Permet de forcer la déconnexion du serveur logique. |
Les cases à cocher
Enregistrer un événement
Deux cas possibles :
Si cette case est cochée et que l'utilisateur ferme la boîte à l'aide du bouton OK, une trace est ajoutée dans le mécanisme de traces, et l'application poursuit son exécution.
Si cette case est cochée et que l'utilisateur ferme la boîte à l'aide du bouton Terminer, une trace est ajoutée dans le mécanisme de traces, puis l'application se termine.
Déconnecter
Si cette case est cochée et que l'utilisateur ferme la boîte à l'aide du bouton OK, le serveur logique concerné est déconnecté, et l'application poursuit son exécution.
Que cette case soit cochée ou décochée, lorsque l'utilisateur ferme la boîte à l'aide du bouton Terminer, l'application se termine et le serveur logique concerné est déconnecté.
Par ailleurs, un utilisateur désirant écrire son propre programme de traitement d'erreurs peut écrire un programme VADELIA. Ce programme doit alors remplacer celui par défaut (Cf. CfgParamExec.properties).
Par ailleurs, un utilisateur désirant écrire son propre programme de traitement d'erreurs peut écrire un programme VADELIA de nom IBM SVCERR. Ce programme doit alors remplacer celui par défaut.
Ce programme doit définir les paramètres suivants :
NUM_BIN_4 |
NumErrMw |
Numéro erreur Middleware. |
BOOL |
GestES |
Gestion entrée/sortie. |
ALPHA(128) |
NomPgm |
Nom du programme. |
ALPHA(128) |
ServLog |
Nom du serveur logique |
NUM_BIN_4 |
NumServ |
Numéro du service |
Remarque : Il est possible de faire appel au programme de traitement d'erreurs par défaut depuis le nouveau programme en faisant appel à ce programme à l'aide de l'ordre APPELER.
Exemple :
ALPHA(128) NOMPGMDEF
NOMPGMDEF = 'com.hardis.adelia.cloud.common.dialogs.SVCERR'
APPELER &NOMPGMDEF NumErrMw GestES NomPGm ServLog NumServ
Fonctions de la VaToolBox supplémentaires utiles à l'écriture d'un programme de traitement d'erreurs :