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 :
- Dans la barre de menus, sélectionnez Fichier > Nouveau > Projet > Projet Java puis cliquez sur Suivant.
- Créez un projet
Java
appelé SimpleCCIApp.
- Acceptez tous les autres paramètres par défaut et cliquez sur Terminer.
- Cliquez sur Oui pour confirmer le changement de
perspective lorsque vous êtes invité à passer en perspective Java.
- Cliquez sur OK pour enregistrer la ressource.
- 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.
- Dans l'assistant de nouveau package
Java,
dans la zone Nom, saisissez sample.ims puis
cliquez sur Terminer.
- 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.
- 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.
- 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 :
- Quittez l'assistant Chemin de compilation
Java.
- 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.
- Cliquez sur Suivant.
- 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.
- Cliquez sur la case à cocher située en regard de votre répertoire pour le sélectionner.
- Cliquez sur Terminer.
- 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 :
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
- Cliquez sur OK.
- 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.
- Dans l'assistant de classe
Java, exécutez la procédure suivante :
- Dans la zone Nom, saisissez CCIApp comme nom de la nouvelle classe.
- 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.
- 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.
- Cliquez sur Fichier > Enregistrer.
- Pour exécute votre application
Java,
développez, dans la vue Explorateur de projets, Autres Projets >
SimpleCCIApp.
- 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