Configuration de nouveaux adaptateurs de ressources J2C aide de scripts wsadmin

L'outil wsadmin permet de configurer les adaptateurs de ressources Java™ 2 Connector avec les fichiers RAR (Resource Adapter Archive). Ce fichier RAR fournit les classes et d'autres codes pour prendre en charge un adaptateur de ressources afin d'accéder à un système EIS (Enterprise Information System) spécifique, tel qu'un système CICS (Customer Information Control System). Ne configurez des adaptateurs de ressources pour un système EIS qu'après avoir installé le fichier RAR approprié.

Avant de commencer

Un fichier RAR, qui est souvent dénommé connecteur JCA (Java Connector Architecture), doit être conforme à la spécification JCA 1.5 et 1.6. En outre, pour assurer la compatibilité des adaptateurs de ressources avec JCA version 1.6, les modules RAR prennent en charge les annotations Java. Pour plus d'informations sur la prise en charge des annotations et les métadonnées, consultez la rubrique Prise en charge des annotations dans les modules RAR par la spécification JCA 1.6.

Pour cela, utilisez un outil d'assemblage pris en charge (voir la description fournie dans l'article sur les outils d'assemblage) qui vous permettra d'assembler dans un fichier RAR déployable différents fichiers JAR (fichiers d'archive Java), d'autres composants exécutables, des classes d'utilitaire, etc. Vous êtes ensuite prêt pour installer le fichier RAR dans Application Server.

Vous disposez de deux solutions pour mener à bien cette tâche. Grâce à cette rubrique, vous allez installer des adaptateurs de ressources à l'aide de l'objet AdminConfig. Mais, pour installer un adaptateur de ressources J2C, vous pouvez aussi utiliser le script installJ2CResourceAdapter de la bibliothèque de scripts AdminJ2C. Exemple :
AdminJ2C.installJ2CResourceAdapter(“myNode", "C:\temp\jca15cmd.rar", "J2CTest")

La bibliothèque de scripts propose un ensemble de procédures permettant d'automatiser les fonctions d'administration les plus courantes. Vous pouvez exécuter chaque procédure de script individuellement ou combiner plusieurs procédures pour développer rapidement de nouveaux scripts.

Procédure

  1. Lancez le script wsadmin. Pour plus d'informations, reportez-vous à l'article Démarrage du client de scriptage wsadmin.
  2. Identifiez l'ID configuration du noeud sur lequel l'adaptateur de ressources est installé, comme le montrent les exemples suivants :
    • A l'aide de Jacl :

      set node [$AdminConfig getid /Cell:mycell/Node:mynode/]
    • Avec Jython :

      node = AdminConfig.getid('/Cell:mycell/Node:mynode/')
      print node
    Exemple de sortie :
    mynode(cells/mycell/nodes/mynode|node.xml#Node_1)
  3. Identifiez les attributs facultatifs.

    L'objet J2CResourceAdapter ne requiert pas d'arguments spécifiques. Utilisez la commande suivante pour afficher les attributs facultatifs de l'objet J2CResourceAdapter :

    • A l'aide de Jacl :

      $AdminConfig defaults J2CResourceAdapter
    • Avec Jython :

      print AdminConfig.defaults('J2CResourceAdapter')
    La sortie de commande suivante affiche chaque attribut facultatif et le type de données correspondant et précise les attributs par défaut :
    Attribut                       Type                            Valeur par défaut
    name         String
    description                     String
    classpath                       String
    nativepath                      String
    providerType                    String
    isolatedClassLoader             boolean                         false
    archivePath                     String
    threadPoolAlias                 String                          Default
    singleton                       boolean                         false
    hACapability                    ENUM                            RA_NO_HA
    isEnableHASupport               boolean                         false
    propertySet                     J2EEResourcePropertySet
    jaasLoginConfiguration          JAASConfigurationEntry
    deploymentDescriptor            Connector
    connectionDefTemplateProps      ConnectionDefTemplateProps
    activationSpecTemplateProps     ActivationSpecTemplateProps
    j2cAdminObjects                 J2CAdminObject
    adminObjectTemplateProps        AdminObjectTemplateProps
    j2cActivationSpec               J2CActivationSpec
    properties                      Property
  4. Configurez les attributs de votre choix.

    Déterminez les attributs à configurer pour l'adaptateur de ressources J2C. Dans les exemples suivants, les commandes définissent le chemin d'accès des fichiers RAR dans la variable rarFile et les options de configuration des noms et des descriptions dans la variable option :

    • A l'aide de Jacl :

      [AIX Solaris HP-UX Linux Windows]
      set rarFile c:/currentScript/cicseci.rar
      set option {-rar.name  RAR1 -rar.desc "New resource adapter"} 
      [z/OS][IBM i]
      set rarFile /currentScript/cicseci.rar
      set option {-rar.name  RAR1 -rar.desc "New resource adapter"}
    • En langage Jython :

      [AIX Solaris HP-UX Linux Windows]
      rarFile = 'c:/currentScript/cicseci.rar'
      option  = '[-rar.name  RAR1 -rar.desc "New resource adapter"]'
      [z/OS]
      rarFile = '/currentScript/cicseci.rar'
      option  = '[-rar.name  RAR1 -rar.desc "New resource adapter"]'
  5. Create a resource adapter.

    Utilisez la commande installResourceAdapter pour que l'objet AdminConfig installe l'adaptateur de ressources avec les options de configuration précédemment définies, comme illustré dans les exemples suivants :

    • Avec Jacl :

      $AdminConfig installResourceAdapter $rarFile mynode $option
    • Avec Jython :

      AdminConfig.installResourceAdapter(rarFile, 'mynode', option)
    Exemple de sortie :
    RAR1(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)
  6. Enregistrez les modifications apportées à la configuration. Pour plus d'informations, reportez-vous à la rubrique Enregistrement des modifications de configuration avec l'outil wsadmin.
  7. Dans un environnement de déploiement en réseau uniquement, synchronisez le noeud. Pour plus d'informations, reportez-vous à la rubrique Synchronisation des noeuds à l'aide de l'outil wsadmin.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_jcadapter
Nom du fichier : txml_jcadapter.html