Appeller les procédures cataloguées à  partir de Domino

Vous avez peut-être déjà  exécuté des
instructions SQL à  partir d’applications
Domino en utilisant ODBC. Mais une
procédure cataloguée est une autre affaire.

On peut assimiler une procédure
cataloguée à  une application SQL compilée.
Au lieu de transmettre une
instruction SQL, on appelle une instruction précompilée. D’ailleurs, la
plupart des outils et des langages qui
utilisent SQL ou une technologie
connexe (JDBC, par exemple) peuvent
utiliser des procédures cataloguées.
De plus, une procédure cataloguée
n’est pas forcément SQL. D’ailleurs,
l’exemple utilisé dans cet article appelle
un programme CL. ODBC et
votre application Domino se soucient
peu de ce qui est appelé pourvu que
cela traite les paramètres correctement.
Si l’on transmet deux paramètres
à  la procédure, le programme
de procédure cataloguée doit attendre
deux paramètres des types de données
appropriés.

J’ai dit plus haut que les procédures
cataloguées améliorent les performances
des applications en réduisant
le volume de communications.
Supposons que pour consulter le
contenu d’une commande, il faille accéder
au fichier maître client et au fichier
des commandes ouvertes. Sans
procédures cataloguées, l’application
Domino doit exécuter deux instructions
SQL pour accéder à  ces données.
Chaque instruction SQL représente les
données transmises à , et traitées par,
l’iSeries puis retransmises à  l’application
Domino. Dans cet exemple,
l’usage d’une procédure cataloguée réduit
la communication de moitié.

La procédure cataloguée peut aussi
être un programme RPG ILE. Dans ce
cas, on transmet à  la procédure un numéro
de client et un numéro de commande
; elle accède aux deux fichiers
et renvoie des données comme le nom
du client, la date de la commande, et le
total de la commande. Cette tâche ne
demande qu’un appel à  l’iSeries au lieu
de deux, ce qui améliore à  nouveau la
performance.

L’autre intérêt des procédures cataloguées
est une meilleure fiabilité. Si
un client appelle et modifie une commande,
il faudra peut-être accéder au
fichier maître client, au fichier des entêtes
de commandes, et au fichier de
détail des commandes. Il faudra donc
exécuter trois ou plus SQL Updates, Deletes et/ou Inserts. Mais qu’en est-il
si l’on peut mettre à  jour le détail des
commandes mais pas leur en-tête ?
Comme on ne peut pas laisser ces fichiers
désynchronisés, il faut annuler
les modifications apportées au fichier
de détail des commandes et informer
l’utilisateur que la mise à  jour a
échoué. L’application Domino doit par
conséquent tester le code de renvoi de
chaque instruction SQL et, si l’une
échoue, supprimer les modifications
précédentes réussies.

Là  encore, si l’on utilise une procédure
cataloguée pour traiter les mises à 
jour, il suffit de transmettre un seul ensemble
de données et de tester un code de renvoi. La procédure cataloguée
peut annuler toute modification
effectuée si une mise à  jour échoue.
Par conséquent, le programme frontal
est plus facile à  écrire et plus fiable.
Entrons maintenant dans mon
exemple de procédure cataloguée.