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
- Inicie el script wsadmin. Para obtener más información, consulte el artículo Inicio del cliente de scripts wsadmin.
- Identifique el ID de configuración del nodo donde se instala el adaptador de
recursos, tal como se muestra en los ejemplos siguientes:
Salida de ejemplo:
mynode(cells/mycell/nodes/mynode|node.xml#Node_1)
- Identifique los atributos opcionales.
El objeto
J2CResourceAdapter no requiere argumentos específicos. Utilice el mandato siguiente para
mostrar los atributos opcionales del objeto 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
- 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:
- 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)
- 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.
- 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.