ProgramCall

l’utilisation
des objets ProgramParameter, ToolboxME emploie
PCML (Program Call Markup Language) pour spécifier les paramètres.
Votre client se contente alors de transmettre au
MEServer le nom du fichier PCML, l’API
appelée, et une liste des paramètres à  définir
et à  obtenir. Le MEServer charge et
analyse syntaxiquement le PCML, crée les
objets ProgramParameter nécessaires et
exécute l’appel.
Pour bénéficier de cette possibilité,
vous devez enregistrer les documents
PCML avec le MEServer avant leur utilisation,
soit pendant l’exécution soit avant
l’appel du programme, ou comme un argument
quand on démarre le MEServer.
L’enregistrement dit simplement au serveur quels sont les
programmes définis par PCML à  exécuter. En interne, le
MEServer maintient une table « hash » pour suivre les noms
et les valeurs des paramètres à  définir. La clé dans la table
hash est le nom du paramètre à  définir et la valeur clé est
celle de son paramètre correspondant. Une matrice de
chaînes associée spécifie le nom des paramètres de sortie
PCML à  renvoyer.

La figure 4 montre ProgramCall du ToolboxME. Comme
dans tout programme Toolbox, un objet AS400 est d’abord
créé avec les références requises et le nom de notre
MEServer. L’application client crée ensuite des variables
chargées de contenir les noms du fichier PCML et de l’API à 
appeler. La figure 5 montre le fichier PCML invoqué par ce
code exemple. Notons que les paires nom/valeur dans la figure
4 font référence à  une entrée de données dans notre
structure PCML. De même, une matrice de chaînes est créée
pour les paramètres que nous voulons qu’on nous renvoie
en réponse de l’appel au programme.
Une fois la méthode d’exécution statique de ProgramCall
appelée avec nos paramètres, les valeurs de renvoi reviendront
dans une matrice de chaînes. Celle-ci pourra ensuite
effectuer une itération au travers des valeurs que nous avons
spécifiées dans la variable parametersToGet.
Quand tout s’est bien exécuté, nous pouvons déconnecter
notre objet AS400 ou continuer à  effectuer d’autres actions
ou à  envoyer d’autres requêtes d’information sur notre
iSeries. La figure 6 montre la façon dont le programme se
présente sur un Palm.