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,
il effectue un ROLLBACK avant de renvoyer la réponse
contenant les erreurs. Il redonne le contrôle au client sans appeler
le Composant Applicatif suivant.
Mise en place
- Indiquez les options suivantes sur des lignes de type O,
dans les Lignes -GO des entités 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.
- ACCESERR, DATAERR, ERRLAB et ERRSERV dans
le Dialogue Serveur pour les développements mono-vue.
- 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 micro-patterns 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 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.
- 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
Vous devez ensuite générer les libellés
d'erreur. Pour cela, vous devez créer une instance de Libellé d'erreur
et l'associer au Dialogue. L'instance de Libellé d'erreur rassemble
les options de génération des libellés d'erreur de ce Dialogue. Vous
pouvez alors générer l'instance de Libellé 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