Configuración de nuevos adaptadores de recursos J2C mediante scripts wsadmin

Utilice la herramienta de scripts wsadmin para configurar los adaptadores de recursos Java™ 2 Connector con archivos RAR (Resource Adapter Archive). Un archivo RAR proporciona las clases y otro código para dar soporte a un adaptador de recursos para acceder a un EIS (Enterprise Information System) específico como, por ejemplo, CICS (Customer Information Control System). Configure los adaptadores de recursos para un EIS únicamente después de instalar el archivo RAR adecuado.

Antes de empezar

Un archivo RAR, que suele llamarse conector JCA (Java Connector Architecture), debe cumplir con la especificación JCA 1.5 y 1.6. Para que los adaptadores de recursos admitan JCA Versión 1.6, exige un soporte añadido para las anotaciones Java en los módulos RAR. Para obtener más información sobre el soporte de anotaciones y los metadatos, consulte el tema Soporte de JCA 1.6 para anotaciones en módulos RAR.

Reúna estos requisitos utilizando una herramienta de ensamblaje soportada (como se describe en el artículo Herramientas de ensamblaje) para ensamblar una colección de archivos JAR (Java Archive) que no sean componentes ejecutables, las clases de programas de utilidad, etc, en un archivo RAR desplegable. A continuación, estará preparado para instalar el archivo RAR en el servidor de aplicaciones.

Existen dos procedimientos para realizar esta tarea. En este tema, se utiliza el objeto AdminConfig para instalar adaptadores de recursos. De manera alternativa, puede utilizar el script installJ2CResourceAdapter de la biblioteca de scripts AdminJ2C para instalar un adaptador de recursos J2C en la configuración, tal como se muestra en el siguiente ejemplo:
AdminJ2C.installJ2CResourceAdapter(“myNode", "C:\temp\jca15cmd.rar", "J2CTest")

La biblioteca de scripts proporciona un conjunto de procedimientos para automatizar las funciones de administración más comunes. Puede ejecutar cada procedimiento de script de forma individual, o combinar varios procedimientos para desarrollar rápidamente nuevos scripts.

Procedimiento

  1. Inicie el script wsadmin. Para obtener más información, consulte el artículo Inicio del cliente de scripts wsadmin.
  2. Identifique el ID de configuración del nodo donde se instala el adaptador de recursos, tal como se muestra en los ejemplos siguientes:
    • En Jacl:

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

      node = AdminConfig.getid('/Cell:mycell/Node:mynode/')
      print node
    Salida de ejemplo:
    mynode(cells/mycell/nodes/mynode|node.xml#Node_1)
  3. Identifique los atributos opcionales.

    El objeto J2CResourceAdapter no requiere argumentos específicos. Utilice el mandato siguiente para mostrar los atributos opcionales del objeto J2CResourceAdapter:

    • En Jacl:

      $AdminConfig defaults J2CResourceAdapter
    • En Jython:

      print AdminConfig.defaults('J2CResourceAdapter')
    A continuación, se proporciona la salida del mandato que muestra cada atributo opcional y el tipo de datos del atributo, y se denotan los atributos predeterminados:
    Atributo                       Tipo                            Valor por omisión
    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. Configure los atributos necesarios.

    Determine los atributos que se deben configurar para el adaptador de recursos J2C. En los siguientes ejemplos, los mandatos establecen la vía de acceso del archivo RAR en la variable rarFile y las opciones de configuración de nombre y descripción en la variable option:

    • En 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 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. Cree un adaptador de recursos.

    Utilice el mandato installResourceAdapter del objeto AdminConfig para instalar el adaptador de recursos con las opciones de configuración establecidas previamente, tal como se muestra en los ejemplos siguientes:

    • En Jacl:

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

      AdminConfig.installResourceAdapter(rarFile, 'mynode', option)
    Salida de ejemplo:
    RAR1(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)
  6. Guarde los cambios de configuración. Para obtener más información, consulte el tema Cómo guardar los cambios de configuración con la herramienta wsadmin.
  7. En un entorno sólo de despliegue de red, sincronice el nodo.Para obtener más información, consulte el tema Sincronización de nodos con la herramienta wsadmin.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_jcadapter
File name: txml_jcadapter.html