Spécification d'interaction ECI

Votre application J2C utilise l'interface d'interaction pour une liaison avec un programme serveur. L'adaptateur de ressources ECI fournit une implémentation de l'interface d'interaction, mais votre application ne l'utilise pas directement ; en revanche, elle utilise directement la classe ECIInteractionSpec pour définir les propriétés de l'interaction :

De même qu'avec ECIConnectionSpec, vous pouvez définir des propriétés sur la classe ECIInteractionSpec lors de la construction ou de méthodes de réglage. Contrairement à ECIConnectionSpec, la classe ECIInteractionSpec a été conçue en tant que bean Java. En conséquence, dans un environnement géré, votre serveur peut fournir des outils vous permettant de définir ces propriétés en utilisant une interface graphique sans écrire de code.

Propriétés ECIInteractionSpec

• TPNName : nom de la transaction TPN CICS sous lequel doivent être exécutés tous les programmes lancés par l'adaptateur de ressources. Cette propriété est prioritaire sur TranName et TPNName lorsque ces deux propriétés sont définies. Si TPNName est défini sur ECIInteractionSpec, cela remplace toutes les valeurs définies lors du déploiement (ou sur managedConnectionFactory, si non géré).
• commareaLength : longueur de l'élément de données.
• executeTimeout : pour définir une valeur du délai d'attente de l'interface ECI, définir la propriété ExecuteTimeout de la classe ECIInteractionSpec sur la valeur du délai d'attente de l'interface ECI. Les valeurs autorisées sont les suivantes :
  • 0 (pas de délai d'attente). Il s'agit de la valeur par défaut.
  • Un entier positif (temps en millisecondes.)
  Remarque : Si vous utilisez une passerelle CICS Transaction Gateway sousz/OS, vous ne pouvez pas définir de valeur pour le délai d'attente de l'interface ECI. Vous pouvez définir à la place le paramètre TIMEOUT dans la table des options DFHXCOPT de l'EXCI.
• functionName : définit la propriété FunctionName sur le nom du programme serveur CICS.
• interactionVerb: définit le type d'interaction effectuée par votre transaction. Les valeurs autorisées sont les suivantes :
  • SYNC_SEND pour un appel asynchrone,
  • SYNC_RECEIVE pour extraire une réponse d'un appel asynchrone,
  • SYNC_SEND_RECEIVE pour un appel synchrone.
    • Lorsqu'un appel SYNC_SEND a été émis avec la méthode execute() d'un objet ECIInteraction particulier, cette instance de ECIInteraction ne peut pas exécuter un autre SYNC_SEND ou SYNC_SEND_RECEIVE jusqu'à ce qu'un SYNC_RECEIVE ait été exécuté.
    • Les appels asynchrones simultanés vers la même connexion sont permis, sous réserve que cela ne se traduise pas par deux appels asynchrones en attente au sein de la même portée de transaction. Si c'est le cas, une LocalTransactionException est émise.
    • Si vous utilisez l'adaptateur en mode local avec WebSphere Application Server for z/OS et que vous avez besoin d'une prise en charge transactionnelle, spécifiez le type d'interaction SYNC_SEND_RECEIVE. si vous utilisez SYNC_SEND and SYNC_RECEIVE pour émettre des demandes asynchrones, les demandes ECI seront émises avec synchronisation en retour et seront à l'extérieur de la transaction globale en cours. En mode distant, les appels asynchrones fonctionnent normalement.
      • Définissez la propriété CommareaLength sur la longueur de COMMAREA transmise à CICS. Dans le cas contraire, une valeur par défaut est utilisée :
        • SYNC_SEND, SYNC_SEND_RECEIVE -- Longueur des données d'enregistrement d'entrée
        • SYNC_RECEIVE -- Valeur de ReplyLength
      • Définissez la propriété ReplyLength sur la longueur du flux de données à renvoyer à partir du démon Gateway vers l'application J2C. Cela peut minimiser les données transmises via le réseau si les données renvoyées par CICS sont inférieures à la taille COMMAREA globale et si vous connaissez la taille des données à l'avance. L'application JCA reçoit toujours une COMMAREA complète de la taille spécifiée dans CommareaLength, seule la quantité de données transmise via le réseau est réduite. Cette méthode est équivalente à la méthode setCommareaInboundLength() disponible pour la classe ECIRequest. Si vous ne définissez pas ReplyLength, CICS Transaction Gateway enlève automatiquement les zéros à droite de la COMMAREA envoyée depuis le démon Gateway vers l'application J2C, sans avoir besoin de connaître la taille des données à l'avance.
• replyLength : définit la longueur du flux de données devant être renvoyé à partir du démon Gateway vers l'application J2C. Vous pouvez réduire les données transmises sur le réseau si la taille des données renvoyées par CICS est inférieure à la taille totale de la zone de communication (COMMAREA). Vous connaissez la taille des données à l'avance.
• tranName : nom de la transaction CICS sous lequel doivent être exécutés tous les programmes lancés par l'adaptateur de ressource. Le programme appelé est exécuté sous une transaction miroir mais il est lié sous le nom de la transaction tranName. Ce nom est disponible pour le programme appelé pour la requête de l'ID de transaction. Certains serveurs utilisent l'ID de transaction pour déterminer les attributs de sécurité et des performances du programme appelé. Il est recommandé d'utiliser ce paramètre dans ces serveurs afin de contrôler le traitement de vos programmes appelés. La configuration de tranName dans ECIInteractionSpec écrase la valeur définie au moment du déploiement (ou surManagedConnectionFactoryif non géré).