Métadonnées facultatives

En tant que développeur, vous pouvez choisir de faire en sorte que l’environnement d’exécution TI (Transaction Integrator) envoie et reçoit des métadonnées vers et à partir du programme de transaction mainframe (TP), et vous pouvez choisir le contenu de ces métadonnées.

Notes

Les métadonnées ne sont pas prises en charge pour l’appel de programme distribué (DPC).

Vous pouvez envoyer ou recevoir :

• Aucune métadonnées.

• Uniquement le nom de la méthode en tant que métadonnées.

• Toutes les métadonnées, y compris le nom de la méthode.

  L’environnement d’exécution TI envoie ou reçoit des métadonnées vers ou à partir du TP comme indiqué. Les métadonnées aident le TP à :

• Identification du format des métadonnées (informations de version).

• Identification du nom de la méthode utilisée pour appeler le TP.

• Rapport d’informations détaillées sur les erreurs au client.

  Les métadonnées ne sont pas visibles par le client Automation. Les métadonnées sont remises au TP hôte (ou reçus de) dans le cadre du message de demande envoyé au TP (ou du message de réponse reçu de).

  Le jeu de métadonnées comprend les données suivantes :

• Version au moment de l’exécution TI.

  Chaîne de caractères, comme « Microsoft TI version 1.0.0 », qui identifie de manière unique la version de l’environnement d’exécution TI qui a généré la demande.

• Nom de la méthode (chaîne de 32 caractères) appelé par le code de l’application cliente.

• ID de bloc de métadonnées.

  Guid, au format caractère, qui identifie de manière unique ce bloc de données d’exception. Le GUID prend en charge la possibilité d’avoir des formats d’exception supplémentaires à l’avenir et permet de garantir la validité des données reçues.

• Variables sans utilisations attribuées à ce jour (réservées) :

  • Indicateur booléen indiquant si le TP est prêt à la validation.

  • Indicateur booléen indiquant si le TP est prêt à effectuer un travail supplémentaire.

  • Deux entiers courts pour contenir des éléments du numéro de version de l’environnement d’exécution TI, un entier court pour contenir le numéro de version principale et l’autre pour contenir le numéro de version mineure.

• Bloc d’exception (utilisé uniquement dans les réponses).

  GUID, au format binaire, qui identifie de manière unique ce bloc de données d’exception. Le GUID permet la prise en charge d’autres formats d’exception à l’avenir et permet de s’assurer que les données reçues sont valides :

  • Indicateur booléen qui indique si le TP est prêt à la validation.

  • Indicateur booléen qui indique si le TP est prêt à effectuer un travail supplémentaire.

  • Indicateur booléen qui indique si une exception doit être retournée à l’application cliente. S’il est défini, cet indicateur entraîne également l’arrêt de la transaction.

  • Entier 16 bits qui identifie l’erreur (voir la note plus loin dans cette rubrique). Vous pouvez affecter cette valeur, ainsi que le message de 256 caractères qui décrit l’erreur, à partir du serveur afin que la valeur affectée soit retournée lorsqu’une erreur d’exécution TI se produit.

  • Entier 32 bits qui identifie l’ID de contexte dans le fichier d’aide TP (le cas échéant).

  • Message de 256 caractères qui décrit l’erreur. Vous pouvez affecter cette valeur, ainsi que l’entier 16 bits qui identifie l’erreur à partir du serveur, afin que la valeur affectée soit retournée lorsqu’une erreur d’exécution TI se produit.

  Les métadonnées se trouvent toujours au début du message.

Notes

Les messages d’erreur TI ont des numéros entre 0 et 9999. Les numéros de message d’erreur de métadonnées retournés par le mainframe peuvent se trouver dans la même plage. Pour distinguer les messages d’erreur TI des messages de métadonnées retournés par le mainframe, TI ajoute 10000 au nombre de messages d’erreur de métadonnées retournés à partir du mainframe.