Les API à  l’oeuvre – avec des JOBS

La figure 1 montre la liste de paramètres de l’API QGYOLJOB, telle qu’elle est documentée à l’Information Center d’IBM (publib.boulder.ibm. com/infocenter/iseries/v5r3/topic/apis/ qgyoljob. htm). La commande WRKJOB utilise le groupe de paramètres requis et le groupe de paramètres facultatifs 1. Le groupe de paramètres facultatifs 2 n’est pertinent que si vous voulez spécifiquement extraire des données statistiques de performances pour les jobs actifs. Par conséquent, je laisserai ces paramètres à l’écart dans cet article. La figure 2 affiche le prototype d’API QGYOLJOB avec l’appel d’API réel pour montrer les paramètres et leur interrelation. Pour illustrer l’interrelation entre les paramètres, j’ai groupé les 14 paramètres de l’appel d’API QGYOLJOB. Ce groupage n’a rien à voir avec les groupes de paramètres requis et facultatifs dans la documentation d’IBM. L’intention est simplement de présenter sous une forme facilement compréhensible la liste de paramètres plutôt complexe.

Examinons les paramètres de A en figure 2. OLJB0200 est la structure de données (figure 3) renvoyée par l’API QGYOLJOB. Le deuxième paramètre est une expression qui passe la taille de la structure de données OLBB0100 à l’API afin qu’elle sache quelle quantité de stockage elle peut adresser en toute sécurité. Sur la définition de structure de données j’ai spécifié une longueur accordant un espace supplémentaire pour que l’API renvoie les données de clé (attributs de job supplémentaires) définies par le paramètre KeyInf (que j’expliquerai plus loin).

Enfin, le troisième paramètre donne à l’API le nom de format et la structure de données. Le paramètre nom de format permet à IBM de développer différents ensembles d’information de renvoi, en termes d’extension et de type et, tout aussi important, d’ajouter de nouveaux formats pour préserver l’avenir.

Les deux paramètres en B spécifient la structure de données de clé de champ et sa longueur, respectivement. On l’a vu, pour certains formats de renvoi tels que OLJB0200 qui lui-même a un format prédéfini, vous pouvez spécifier en plus un certain nombre d’identificateurs de champs (clés de champs) pour composer un ensemble variable d’attributs de jobs répondant à vos exigences.

Pour chaque clé spécifiée en E, l’API QGYOLJOB renverra l’attribut de job associé dans une structure de données (figure 4), en définissant les métadonnées de l’attribut de job et le décalage du début de la structure de données OLJB0200 à la valeur d’attribut. Comme on l’a dit plus haut, les valeurs d’attributs sont renvoyées immédiatement après la part fixe de la structure de données OLJB0200.