Utilisation des liaisons de données IMS dans une application CCI

Si vous décidez d'écrire votre application Java sans utiliser Rational Application pour générer un bean Java J2C et une ressource J2EE, vous pouvez tout de même utiliser l'option J2C de Rational Application Developer pour créer des liaisons de données Java pour les messages d'entrée et de sortie votre application CCI.
Lorsque vous avez créé des liaisons de données Java pour vos messages IMS d'entrée et de sortie, vous pouvez utiliser des liaisons de données dans une application CCI. La procédure suivante explique comment utiliser les liaisons de données dans une application CCI simple :
  1. Dans la barre de menus, sélectionnez Fichier > Nouveau > Projet > Projet Java puis cliquez sur Suivant.
  2. Créez un projet Java appelé SimpleCCIApp.
  3. Acceptez tous les autres paramètres par défaut et cliquez sur Terminer.
  4. Cliquez sur Oui pour confirmer le changement de perspective lorsque vous êtes invité à passer en perspective Java.
  5. Cliquez sur OK pour enregistrer la ressource.
  6. Dans la vue Explorateur de projets, développez Autres projets puis cliquez avec le bouton droit de la souris sur le projet Java nommé SimpleCCIApp et sélectionnez Nouveau > Package.
  7. Dans l'assistant de nouveau package Java, dans la zone Nom, saisissez sample.ims puis cliquez sur Terminer.
  8. Dans la vue Package, cliquez avec le bouton droit de la souris sur le projet SimpleCCIApp puis sélectionnez Propriétés > Chemin de compilation Java.
    1. Dans l'onglet Projets, cliquez sur Ajouter et sélectionnez le projet qui contient les liaisons de données Java que vous voulez que votre application CCI utilise.
    2. Dans l'onglet Projets, sélectionnez le projet contenant l'adaptateur de ressources IMS que vous voulez utiliser.
      Si vous ne disposez pas d'un projet contenant l'adaptateur de ressources IMS TM que vous voulez utiliser, vous pouvez importer le fichier RAR de l'adaptateur de ressources IMS TM dans votre espace de travail en exécutant la procédure suivante :
      1. Quittez l'assistant Chemin de compilation Java.
      2. Dans la vue Explorateur de projets, cliquez avec le bouton droit de la souris sur votre projet puis sélectionnez Importer > Système de fichiers.
      3. Cliquez sur Suivant.
      4. Dans l'assistant Système de fichiers, cliquez sur Parcourir en regard de la zone A partir du répertoire et sélectionnez votre répertoire. Vous pouvez obtenir des fichiers RAR pour les adaptateurs de ressources IMS TM à partir des répertoires suivants :
        • <RAD_install_dir>/Resource Adapters/ims pour l'adaptateur de ressources IMS JCA 1.0.
        • <RAD_install_dir>/Resouce Adapters/ims15 pour l'adaptateur de ressources IMS JCA 1.5.
      5. Cliquez sur la case à cocher située en regard de votre répertoire pour le sélectionner.
      6. Cliquez sur Terminer.
    3. Dans l'onglet Bibliothèques, ajoutez les fichiers JAR suivants au chemin de compilation du projet SimpleCCIApp en cliquant sur le bouton Ajouter fichiers JAR externes :
      • j2ee.jar
      • marshall.jar
      Ces fichiers JAR sont utilisés par les liaisons de données Java générées par Rational Application Developer. La version des fichiers JAR dépend de la version de l'adaptateur de ressources IMS TM sélectionné. Par exemple, si vous sélectionnez l'adaptateur de ressources IMS TM Adapter 9.1.0.1.1 et que vous installez l'environnement de test pour WebSphere Application Server Version 5, les fichiers JAR se trouveront dans le chemin de répertoire suivant :
      • <RAD_install_dir>/runtimes/base_v5/lib
      Si vous sélectionnez l'adaptateur de ressources IMS TM 9.1.0.2 et que vous installez l'environnement de test pour WebSphere Application Server Version 6, les fichiers JAR se trouveront dans le chemin de répertoire suivant :
      • <RAD_install_dir>/runtimes/base_v6/lib
    4. Cliquez sur OK.
  9. Dans la vue Package, développez Autres projets > SimpleCCIApp puis cliquez avec le bouton droit de la souris sur le package sample.ims et sélectionnez Nouveau > Classe.
  10. Dans l'assistant de classe Java, exécutez la procédure suivante :
    1. Dans la zone Nom, saisissez CCIApp comme nom de la nouvelle classe.
    2. Pour l'option Quels raccords de méthode voulez-vous créer ? , vérifiez que les cases public static void main(String{}args) et Méthodes abstraites héritées sont cochées et cliquez sur Terminer.
  11. Modifiez la source CCIApp.java. Copiez le code d'exemple suivant et collez-le dans le fichier :
    /*
     *
     * TODO Pour changer le modèle pour ce fichier généré :
     * Fenêtre - Préférences - Java - Style de code - Modèles de code
     */
    package sample.ims;
    
    import com.ibm.connector2.ims.ico.*;
    import javax.resource.cci.*;
    
    /**
     * 
     *
     * TODO Pour changer le modèle pour ce commentaire de type généré :
     * Fenêtre - Préférences - Java - Style de code - Modèles de code
     */
    public class CCIApp {
    
        public static void main(String[] args) {
            
            Connection conn = null;
            
            try{
                IMSManagedConnectionFactory mcf = new IMSManagedConnectionFactory();
                mcf.setHostName("yourHostName");
                mcf.setPortNumber(new Integer(0));
                mcf.setDataStoreName("yourDataStoreName");
                
                ConnectionFactory cf = (ConnectionFactory) mcf.createConnectionFactory();
                IMSConnectionSpec cSpec = new IMSConnectionSpec();
                
                conn = cf.getConnection(cSpec);
                
                Interaction interAction = conn.createInteraction(); 
                IMSInteractionSpec iSpec = new IMSInteractionSpec();
                iSpec.setInteractionVerb(1);        // SEND_RECEIVE
                iSpec.setImsRequestType(1);            // TRANSACTION
                iSpec.setCommitMode(1);                // SEND_THEN_COMMIT
                
                sample.ims.INPUTMSG input = new INPUTMSG();
                input.setIn__ll((short) input.getSize());
                input.setIn__zz((short) 0);
                input.setIn__trcd("IVTNO");
                input.setIn__cmd("DISPLAY");
                input.setIn__name1("LAST1");
                
                sample.ims.OUTPUTMSG output = new sample.ims.OUTPUTMSG();
                interAction.execute(iSpec, input, output);
                
                System.out.println(
                        "Output message is... " +
                        "\nMSG: " + output.getOut__msg() +
                        "\nNAME1: " + output.getOut__name1() +
                        "\nNAME2: " + output.getOut__name2() +
                        "\nEXTN: " + output.getOut__extn() +
                        "\nZIP: " + output.getOut__zip() 
                );
            }
            catch(Exception e)
            {
                System.out.println("Caught exception is: " + e.getMessage());
            }
        }
    }

    CCIApp.java est un programme d'application Java simple non géré et à deux niveaux. Il utilise les liaisons de données Java, sample.ims.INPUTMSG et sample.ims.OUTPUTMSG, créées par l'assistant de liaison de données Java CICS/IMS dans Rational Application Developer. Editez CCIApp.java et modifiez les valeurs utilisées par les instructions setHostName(), setPortNumber() et setDataStoreName() pour votre environnement.

  12. Cliquez sur Fichier > Enregistrer.
  13. Pour exécute votre application Java, développez, dans la vue Explorateur de projets, Autres Projets > SimpleCCIApp.
  14. Cliquez avec le bouton droit de la souris sur CCIApp.java et sélectionnez Exécuter > Application Java. Les informations suivantes s'affichent dans la vue Console :
    Message de sortie...
    MSG: ENTRY WAS DISPLAYED
    NAME1: LAST1
    NAME2: FIRST1
    EXTN: 8-111-1111
    ZIP: D01/R01

Vos commentaires