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.
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
authenticationAlias | Especifica el alias de autenticación de la especificación de activación J2C creada. |
|
description | Especifica la descripción de la especificación de activación J2C creada. |
|
destinationJndiName | Especifica el nombre JNDI de destino de la especificación de activación J2C creada. |
|
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")
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.
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:
|
Atributos | Descripción | Ejemplo |
---|---|---|
description | Especifica la descripción del objeto administrativo J2C creado. |
|
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")
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.
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:
|
Atributo | Descripción | Ejemplo |
---|---|---|
authDataAlias | Especifica el alias de datos de autenticación gestionada por componente de la fábrica de conexiones creada. |
|
description | Especifica la descripción de la fábrica de conexiones J2C creada. |
|
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")
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.
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:
|
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]](../images/windows.gif)
AdminJ2C.installJ2CResourceAdapter("myNode",
"C:\temp\jca15cmd.rar", "J2CTest")
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
AdminJ2C.installJ2CResourceAdapter("myNode", "/temp/jca15cmd.rar", "J2CTest")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
![[Windows]](../images/windows.gif)
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]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
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]](../images/windows.gif)
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]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
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']])