Scripts de configuración J2C

La biblioteca de scripts proporciona muchos procedimientos de script para gestionar las configuraciones J2C (Java™ 2 Connector). Utilice los scripts de este tema para crear especificaciones de activación, objetos administrativos y fábricas de conexiones y para instalar adaptadores de recursos. Puede ejecutar cada script de forma individual o combinar varios procedimientos para crear scripts de automatización personalizados para el entorno.

Los procedimientos de script de gestión J2C se encuentran en el directorio raíz_servidor_aplicaciones/scriptLibraries/resources/J2C.

Utilice los procedimientos de script siguientes para configurar J2C en el entorno:

createJ2CActivationSpec

Este script crea una especificación de activación J2C en la configuración. El script devuelve el ID de configuración de la nueva especificación de activación J2C.

Para ejecutar el script, especifique el adaptador de recursos, el nombre de especificación de activación, el tipo de escucha de mensajes y el nombre JNDI (Java). Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 1. Script createJ2CActivationSpec. Ejecute el script para crear una especificación de activación J2C.
Argumento Descripción
resourceAdapterID Especifica el ID de configuración del adaptador de recursos de interés.
activationSpecName Especifica el nombre que debe asignarse a la nueva especificación de activación.
messageListenerType Especifica el tipo de escucha de mensajes.
jndiName Especifica el nombre JNDI (Java Naming and Directory Interface).
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 2. Atributos opcionales. Otros atributos disponibles para el script.
Atributos Descripción Ejemplo
authenticationAlias Especifica el alias de autenticación de la especificación de activación J2C creada.
["authenticationAlias", "myAlias"]
description Especifica la descripción de la especificación de activación J2C creada.
["description", "Mi descripción"]
destinationJndiName Especifica el nombre JNDI de destino de la especificación de activación J2C creada.
["destinationJndiName", "myDestinationJndi"]

Sintaxis

AdminJ2C.createJ2CActivationSpec(resourceAdapterID, 
 activationSpecName, messageListenerType, jndiName, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJ2C.createJ2CActivationSpec(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_1184091767578))", "J2CASTest", "javax.jms.MessageListener2", "jndiAS")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJ2C.createJ2CActivationSpec(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)", 
"J2CASTest","javax.jms.MessageListener", "jndi/as1", 
"description=this is my J2C ActivationSpecification, 
destinationJndiName=jndi/J2CAS, authenticationAlias=J2CASTest")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJ2C.createJ2CActivationSpec(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)", 
"J2CAC1", "javax.jms.MessageListener", "jndi/as", [['description','new j2cActivationSpec'], 
['destinationJndiName','ds/jndi'], ['authenticationAlias','test']])

createJ2CAdminObject

Este script crea un objeto administrativo J2C en la configuración. El script devuelve el ID de configuración del objeto administrativo J2C nuevo.

Para ejecutar el script, especifique los argumentos de adaptador de recursos, nombre de la especificación de activación, nombre JNDI (Java Naming and Directory Interface) y nombre de la interfaz de objetos administrativos. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 3. Script createJ2CAdminObject. Ejecute el script para crear un objeto administrativo J2C.
Argumento Descripción
resourceAdapterID Especifica el ID de configuración del adaptador de recursos de interés.
activationSpecName Especifica el nombre que debe asignarse a la nueva especificación de activación.
adminObjectInterface Especifica el nombre de la interfaz de objetos administrativos.
jndiName Especifica el nombre JNDI (Java Naming and Directory Interface).
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 4. Atributos opcionales. Otros atributos disponibles para el script.
Atributos Descripción Ejemplo
description Especifica la descripción del objeto administrativo J2C creado.
["description", "Mi descripción"]

Sintaxis

AdminJ2C.createJ2CAdminObject(resourceAdapterID, 
 activationSpecName, adminObjectInterface, jndiName, 
 attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

AdminJ2C.createJ2CAdminObject(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_1184091767578)",
 "J2CAOTest", "fvt.adapter.message.FVTMessageProvider2", "jndiAO")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJ2C.createJ2CAdminObject(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)", 
"J2CAOTest", "fvt.adapter.message.FVTMessageProvider", "jndi/ao1", 
"description=este es mi J2C AdminObject")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJ2C.createJ2CAdminObject(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)", 
"J2CAO1", "fvt.adapter.message.FVTMessageProvider", "jndi/ao", 
[['description','new j2cAdminObject']])

createJ2CConnectionFactory

Este script crea una fábrica de conexiones J2C nueva en la configuración. El script devuelve el ID de configuración de la fábrica de conexiones J2C nueva.

Para ejecutar el script, especifique los argumentos de adaptador de recursos, nombre de la fábrica de conexiones, interfaz de la fábrica de conexiones y nombre de JNDI (Java Naming and Directory Interface). Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 5. Script createJ2CConnectionFactory. Ejecute el script para crear una fábrica de conexiones J2C.
Argumento Descripción
resourceAdapterID Especifica el ID de configuración del adaptador de recursos de interés.
connFactoryName Especifica el nombre para asignar a la fábrica de conexiones nueva.
connFactoryInterface Especifica la interfaz de la fábrica de conexiones.
jndiName Especifica el nombre JNDI (Java Naming and Directory Interface).
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 6. Atributos opcionales. Otros atributos disponibles para el script.
Atributo Descripción Ejemplo
authDataAlias Especifica el alias de datos de autenticación gestionada por componente de la fábrica de conexiones creada.
["authDataAlias", "myAuthDataAlias"]
description Especifica la descripción de la fábrica de conexiones J2C creada.
["description", "Mi descripción"]

Sintaxis

AdminJ2C.createJ2CConnectionFactory(resourceAdapterID, 
 connFactoryName, connFactoryInterface, jndiName, 
 attributes)

Ejemplo de uso

AdminJ2C.createJ2CConnectionFactory(
"J2CTest(cells/myCell/nodes/myNode|resources.xml#J2CResourceAdapter_11840917675
578)", "J2CCFTest", "javax.sql.DataSource2", "jndiCF")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJ2C.createJ2CConnectionFactory(
"J2CTest(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1245171531343)", 
"J2CCFTest", "javax.sql.DataSource", "jndi/j2ccftest", 
"description=esta es mi J2CConnectionFactory, authDataAlias=J2CTest")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

AdminJ2C.createJ2CConnectionFactory(
"myj2c(cells/AMYLIN4Cell01/nodes/AMYLIN4CellManager03|resources.xml#J2CResourceAdapter_1238380711218)", 
"J2CCFTest", "javax.sql.DataSource2", "jndi/cf", 
[['description', 'new j2ccf'], ['authDataAlias', 'test']]) 

installJ2CResourceAdapter

Este script instala un adaptador de recursos J2C en la configuración. El script devuelve el ID de configuración del nuevo adaptador de recursos J2C.

Para ejecutar el script, especifique los argumentos de nombre de nodo, archivo de adaptador de recursos (RAR) y nombre de adaptador de recurso. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 7. Script installJ2CResourceAdapter. Ejecute el script para instalar un adaptador de recursos J2C.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
rarFile Especifica la vía de acceso completa del archivo RAR que se debe instalar.
resourceAdapterName Especifica el nombre que se debe asignar al nuevo adaptador de recursos.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 8. Atributos opcionales. Otros atributos disponibles para el script.
Atributos Descripción
rar.desc Especifica la descripción del adaptador de recursos J2C.
rar.archivePath Especifica el nombre de la vía de acceso donde se extrae el archivo. Si esta vía de acceso no se especifica, el archivo se extrae al directorio $CONNECTOR_INSTALL_ RAÍZ.
rar.classpath Especifica la classpath adicional.
rar.nativePath Especifica la vía de acceso nativa.
rar.threadPoolAlias Especifica el alias de la agrupación de hebras.
rar.propertiesSet Especifica el conjunto de propiedades del adaptador de recursos J2C.
rar.DeleteSourceRar Especifica si se va a suprimir el archivo RAR de origen.
rar.isolatedClassLoader Especifica el valor booleano del cargador de clases aislado.
rar.enableHASupport Especifica el valor booleano de la alta disponibilidad habilitada.
rar.HACapability Especifica el tipo de prestación de alta disponibilidad.

Sintaxis

AdminJ2C.installJ2CResourceAdapter(nodeName, rarFile, 
 resourceAdapterName, attributes)

Ejemplo de uso

El script de ejemplo siguiente sólo contiene atributos obligatorios:

[Windows]
AdminJ2C.installJ2CResourceAdapter("myNode", 
 "C:\temp\jca15cmd.rar", "J2CTest")
[IBM i][z/OS][Linux][Solaris][AIX][HP-UX]
AdminJ2C.installJ2CResourceAdapter("myNode", "/temp/jca15cmd.rar", "J2CTest")

El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:

[Windows]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4CellManager03", "c:\ears\jca15cmd.rar", "J2CTest", "rar.desc=this is J2C, 
rar.archivePath=c:\temp\test.rar, rar.classpath=c:\temp, rar.isolatedClassLoader=false, rar.enableHASupport=true, 
rar.DeleteSourceRar=false")
[IBM i][z/OS][Linux][Solaris][AIX][HP-UX]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4CellManager03", "/ears/jca15cmd.rar", "J2CTest", "rar.desc=this is J2C, 
rar.archivePath=/temp/test.rar, rar.classpath=/temp, rar.isolatedClassLoader=false, rar.enableHASupport=true, 
rar.DeleteSourceRar=false")

El script de ejemplo siguiente contiene atributos opcionales en un formato de lista:

[Windows]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4Node09", "c:\ears\jca15cmd.rar", "j2ctest", [['rar.desc', 'this is J2C'], 
['rar.archivePath', 'c:\temp\test.rar'], ['rar.classpath', 'c:\temp'], ['rar.nativePath', ''], ['rar.threadPoolAlias', 'test'], 
['rar.isolatedClassLoader', 'false'], ['rar.enableHASupport', 'true'], ['rar.DeleteSourceRar', 'false']])
[IBM i][z/OS][Linux][Solaris][AIX][HP-UX]
AdminJ2C.installJ2CResourceAdapter("AMYLIN4Node09", "/ears/jca15cmd.rar", "j2ctest", [['rar.desc', 'this is J2C'], 
['rar.archivePath', '/temp/test.rar'], ['rar.classpath', '/temp'], ['rar.nativePath', ''], ['rar.threadPoolAlias', 'test'], 
['rar.isolatedClassLoader', 'false'], ['rar.enableHASupport', 'true'], ['rar.DeleteSourceRar', 'false']])

Icon that indicates the type of topic Reference topic



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