Rational Developer for System z

Création d'une connexion CARMA à l'aide d'un programme

Les connexions CARMA sont établies lors de la création du noeud racine d'une hiérarchie CARMA.

Pourquoi et quand exécuter cette tâche

Le noeud racine d'une hiérarchie CARMA est un objet CARMA qui doit être configuré pour utiliser un service de transport CARMA lors de la création. Pour créer un noeud racine pour une hiérarchie CARMA et configurer son service de transport CARMA, procédez comme suit :

Procédure

  1. Utilisez la classe fabrique com.ibm.carma.CARMASystemFactory pour créer un objet CARMA avec la méthode getInstance comme illustré dans l'exemple de code suivant :
    String identifier = "ConnectionIdentifier";
    Map connectionProperties = new TreeMap();
    // insert your code to configure the connection properties here
    CARMA carma = CARMASystemFactory.getInstance().getCARMAInstance(identifier, connectionProperties);

    La chaîne d'identificateur doit être unique pour votre hiérarchie CARMA. Actuellement, le seul service de transport valide est le service de transport RSE, qui est utilisé par défaut (si vous utilisez l'autre appel de méthode qui nécessite de spécifier un ID dorsal, vous pouvez sélectionner le service de transport RSE en transmettant une valeur d'ID de "com.ibm.carma.client.rse.datastore").

    Les propriétés de connexion mappent des paires clé-valeur de magasin pour les options de configuration de transport. Si les paramètres requis pour le transport que vous utilisez ne sont pas spécifiés dans la mappe, la méthode getCARMAInstance émet une exception CARMAException. Le service de transport RSE requiert de spécifier une valeur pour la clé "aliasName" dans la mappe des propriétés de connexion. Pour la valeur de la clé "aliasName", indiquez un nom que la connexion RSE utilisera pour communiquer avec l'hôte CARMA.

  2. Stockez une référence à votre hiérarchie CARMA pour l'extraction ultérieure dans le registre CARMA :
    CarmaRegistry.getRegistry().addCarma(carma);
    L'objet CarmaRegistry singleton est utilisé par un objet CARMABrowser pour gérer la liste des connexions CARMA connues. Des événements sont envoyés à des écouteurs enregistrés lorsque des objets sont ajoutés ou retirés de la hiérarchie CARMA. Vous pouvez extraire une hiérarchie CARMA du registre CARMA en transmettant son identificateur dans la méthode getCARMA du registre CARMA.

Que faire ensuite

Vous pouvez à présent vous connecter à l'hôte CARMA de votre objet CARMA à l'aide de la méthode connect.

Conditions d'utilisation | Commentaires en retour

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)