Gestion des erreurs dans les Serveurs

Le Composant Applicatif permet d'implémenter sous forme de traitements des services associés à une Vue Logique. Au cours de ces traitements, le Composant Applicatif peut détecter des erreurs. Il doit alors retourner toutes les informations concernant ces erreurs dans sa réponse au client, pour que celui-ci puisse agir en conséquence.

Principe

Deux types d'erreur sont possibles :
  • Les erreurs standard qui sont détectées après les accès standard aux Segments de données ou aux contrôles sur les données de la Vue Logique. Il est possible de modifier les libellés associés aux erreurs standard.
  • Les erreurs spécifiques qui correspondent aux erreurs que vous décrivez entièrement en code source.

Lorsqu'un Composant Applicatif détecte des erreurs, un ROLLBACK est directement effectué – avant de retourner la réponse contenant les erreurs – avec un retour à la partie cliente, sans appel aux Composants Applicatifs suivants.

Mise en place

  1. Indiquez les options suivantes sur des lignes de type O, dans les Lignes -GO des entités serveur suivantes :
    • ACCESERR et DATAERR dans le Composant Applicatif. Le nombre d'erreurs que le Composant Applicatif peut détecter avant de repasser la main au programme appelant est défini par ces deux options. Pour une application TUI, ces deux seules options sont nécessaires.
    • ACCESERR, DATAERR, ERRLAB et ERRSERV dans le Dialogue Serveur pour les développements mono-vue.
  2. Décrivez, dans chaque Composant Applicatif et Vue Logique, les libellés d'erreur associés aux codes des erreurs gérées en spécifique. Ces erreurs correspondent à des erreurs positionnées dans le Composant Applicatif par les opérateurs ERU (erreur utilisateur) ou ERR (erreur sur Rubrique) ou ERL (erreur sur verrouillage ou déverrouillage logique). Vous écrivez les libellés associés à ces erreurs sur des lignes de type U dans les Lignes -GE des entités suivantes :
    • Composant Applicatif pour les erreurs positionnées par ERU ou ERL,
    • Vue Logique pour les erreurs positionnées par ERR.
    Remarque : Vous pouvez aussi modifier les libellés associés aux erreurs standard. Ces erreurs sont détectées suite aux accès standard aux Segments de données ou aux contrôles sur les données de la Vue Logique.
  3. Créez et décrivez le serveur des libellés d'erreur afin d'accéder au fichier des libellés d'erreur.
    Pour gérer les erreurs, les quatre variables suivantes sont générées en WORKING-STORAGE SECTION dans le Composant Applicatif :
    • IER : nombre d'erreurs d'accès Segment initialisé à partir de l'option ACCESERR
    • IED : nombre d'erreurs sur Rubrique initialisé à partir de l'option DATAERR
    • K50L : indice de travail du nombre d'erreurs d'accès Segment
    • K50D : indice de travail du nombre d'erreurs sur Rubrique
  4. Générez le fichier des libellés d'erreur. Le fichier généré est un fichier séquentiel à partir duquel vous créez le fichier des libellés d'erreur de votre application, avec l'organisation voulue (table relationnelle, fichier VSAM, etc.). Un fichier de libellés d'erreur est constitué d'enregistrements de 100 caractères comportant les éléments suivants :
    • Une clé d'accès (ERKEY, 29 caractères)
    • Un code gravité (un caractère : E pour erreur, W pour avertissement)
    • Le libellé proprement dit

Vos commentaires