pendant un appel adressé à une API sockets, celle-ci renvoie -1 pour indiquer l’échec. Elle inscrit aussi un numéro d’erreur dans une variable spéciale appelée errno. Quand une telle défaillance est détectée, il est bon que les programmes extraient ce numéro d’erreur et l’utilisent pour indiquer à l’utilisateur ce qui a raté.

Si vous avez lu mes précédents articles sur la programmation IFS (voir la série en sept parties RPG et l’IFS, www.itpro. fr), vous observerez que les API sockets et les API IFS traitent les erreurs par le même mécanisme.

Pour obtenir la valeur errno à partir d’un programme RPG, il faut appeler une API nommée _errno (A en figure 8). Cette API donne un pointeur vers un entier qui contient un numéro d’erreur. L’API String Error (strerror) peut être utilisée pour extraire un message d’erreur en clair qui correspond à la valeur de errno. En B, on voit comment extraire ce message et l’utiliser comme entrée dans une sous-procédure appelée joblog().

La sous-procédure joblog() écrit le message d’erreur dans le job log. Par manque de place, je n’ai fourni ici aucune figure montrant comment joblog() fonctionne, mais elle se trouve dans le téléchargement de code pour cet article.