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
- 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.
- 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.
- 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
- 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