Rational Developer for System z

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

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.

Afin d'éviter un échange systématique entre le client et le Composant Applicatif à chaque erreur, le gestionnaire de services a pour rôle de mémoriser toutes les erreurs signalées par le Composant Applicatif, d'accéder au serveur de libellés d'erreur et de retourner tous les libellés explicites des erreurs rencontrées.

Le gestionnaire de services retourne à la partie cliente – par le moniteur de communication – ces erreurs applicatives qui sont placées dans la zone de communication sous une forme directement exploitable par le client.

Mise en place

Procedure

  1. Indiquez les options suivantes sur des lignes de type O, dans les Lignes -GO de l'onglet Lignes -G 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
    • ERRLAB dans le Dossier.
    • 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), 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 de l'onglet Lignes -G :
    • Du Composant Applicatif pour les erreurs positionnées par ERU ou ERL,
    • De la Vue Logique pour les erreurs positionnées par ERR.
    Note: 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.
  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 :
    • Une clé d'accès (ERKEY, 29 caractères),
    • Un code gravité (1 caractère : E pour erreur, W pour warning),
    • Le message proprement dit.

Conditions d'utilisation | Commentaires en retour

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)