sauf pour le paramètre 3, Request Handle. Ce handle est un identificateur unique d’une liste précédemment ouverte par l’API Open List et il s’assure que l’API QGYGTLE opère sur la même liste. Le handle Open List est renvoyé par les API Open List dans le cadre de la structure de données List Information (figure 5).

Vous pouvez omettre l’appel QGYGTLE pour une liste construite de manière synchrone, mais seulement si vous choisissez d’extraire tous les enregistrements disponibles avec l’appel QGYOLJOB initial. Pour cela, vous devez allouer suffisamment de stockage pour que la variable du récepteur d’API puisse contenir toutes les entrées possibles. Sachez cependant que cette méthode risque de compliquer un peu l’extraction des entrées de liste. C’est pourquoi, dans la plupart des cas, il vaut mieux appliquer l’extraction d’entrée unique.

J’extrais généralement les entrées de liste une à une dans des appels répétés à l’API QGYGTLE, en augmentant chaque fois de 1 le paramètre d’enregistrement Start, jusqu’à ce que toutes les entrées aient été traitées ou qu’une erreur ait été rencontrée.