Structure des objets métier pour les programmes RPG, COBOL et Java

L'objet métier de l'adaptateur iSeries est plat. Les attributs peuvent être les paramètres input, output ou inout. Le concepteur de l'objet métier doit utiliser un de ces attributs comme clé.

Figure 3. L'objet métier parent iSeries
L'objet métier parent iSeries

Il y a également un attribut enfant de type Connection. Il contient des informations sur la connexion avec la machine AS/400, le nom d'hôte, le nom d'utilisateur et le mot de passe. Ces attributs sont tous obligatoires. Par conséquent, is Required est vrai pour tous. Cet objet métier Connection est un attribut enfant de tous les objets métier iSeries.

Remarque :
Dans l'objet métier iSeries, les informations spécifiques à l'application de l'objet métier de connexion peuvent être vides. Ceci est dû au fait que l'ASI de l'objet métier n'est pas traité par l'adaptateur.

Les informations entre parenthèses dans la figure 5 représentent les informations spécifiques à l'application de l'objet métier.

Remarque :
Les noms de verbes ne sont pas sensibles à la casse. Par exemple, le verbe getqueue peut s'écrire GETQUEUE ou GetQueue.
Figure 4. L'objet métier enfant iSeries
L'objet métier enfant iSeries

Figure 5. Exemple d'objet métier RPG
Exemple d'objet métier RPG

L'objet métier RPG est composé du verbe CALLRPG ou CALLPGM, et le nom du programme (chemin complet de IFSFile) est défini en tant qu'ASI du verbe. CALLRPG est utilisé pour appeler les programmes RPG, et CALLPGM pour appeler tout PGM (y compris les programmes RPG, COBOL et Java). Outre l'attribut enfant Connection, l'objet métier RPG possède des attributs correspondants aux paramètres du programme RPG. Le nom de l'attribut est identique à celui du paramètre correspondant indiqué dans le programme source. La propriété MaxLength des attributs (représentant un paramètre RPG) est dérivée de la longueur du paramètre correspondant, précisée dans le PARM Spec du programme source. Si le paramètre est un nombre, la longueur de la partie décimale est également mentionnées dans l'ASI sous la forme DecimalPositions=n et packedDec=true.

L'adaptateur peut être utilisé pour appeler plusieurs fois un PGM avec un même objet métier Request, mais plusieurs instances. Un exemple est proposé en Figure 6.

Figure 6. Un seul objet métier Request, avec plusieurs instances
Objet métier Request unique avec plusieurs instances

La Figure 7 représente l'objet métier parent avec ses informations de connexion, et l'objet métier enfant avec les informations sur le paramètre PGM. Les informations sur la connexion figurent dans l'objet métier Connection, et le Verb ASI est identique au chemin du programme à appeler.

Figure 7. Objet métier parent avec informations sur la connexion
Objet métier parent avec informations sur la connexion

L'objet métier enfant est présenté dans la Figure 8 avec des attributs correspondant aux informations de paramètre du programme.

Figure 8. Objet métier enfant avec informations sur le paramètre correspondant
Objet métier enfant avec informations sur le paramètre correspondant

L'exemple de la Figure 9 présente un objet métier avec deux instances de l'objet métier multi_child. Le programme sera donc exécuté deux fois. Veillez à utiliser les fichiers XSD appropriés pour l'extraction de plusieurs enregistrements.

Figure 9. Objet métier avec deux instances d'un objet métier multi-child
Objet métier avec deux instances d'un objet métier multi-child

Traitement de l'objet métier Connector

Le connecteur transmet les objets métier entre le courtier d'intégration et le système AS/400.

Lorsqu'un courtier d'intégration transmet un objet métier au connecteur, celui-ci procède comme suit :

  1. Il utilise les informations de l'attribut enfant de la connexion pour se connecter au système AS/400.
  2. Il établit la liste des paramètres pour le programme RPG en fonction des attributs contenus dans l'objet métier.
  3. Il exécute le programme RPG correspondant à l'objet métier.
  4. Il retourne le résultat de l'exécution du programme : réussite ou échec.

Pour créer des objets métier, vous utiliserez Business Object Designer ODA. Créez la définition de l'objet métier et ajoutez les attributs requis. Configurez ensuite le connecteur pour prendre en charge l'objet métier. Pour plus d'informations sur le Business Object Designer ODA, voir le Création et modification d'objets métier.

Copyright IBM Corp. 2003, 2005