Scripts de configuración JDBC

La biblioteca de scripts proporciona muchos procedimientos de script para gestionar las configuraciones JDBC (Java™ Database Connectivity) del entorno. Consulte la información de uso para scripts que configurar los valores de JDBC. 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 AdminJDBC se encuentran en el directorio raíz_servidor_aplicaciones/scriptLibraries/resources/JDBC/V70.

A partir de la versión 7, la biblioteca de scripts Jython proporciona funciones de script para proveedores JDBC y recursos JMS y proveedores de recursos en el ámbito del servidor. Puede escribir sus propios scripts para configurar recursos en la célula, nodo o nivel de clúster.
Avoid trouble Avoid trouble: No edite los procedimientos de script de la biblioteca de scripts. Para escribir procedimientos personalizados de la biblioteca de scripts, utilice los scripts del directorio raíz_servidor_aplic/scriptLibraries como ejemplo de sintaxis de Jython. Guarde los scripts personalizados en un subdirectorio nuevo para evitar sobrescribir la biblioteca.gotcha
Vía de acceso rápida: A partir del fixpack 5, la biblioteca de scripts Jython proporciona funciones de script para recursos JMS y proveedores de recursos en el ámbito de célula, el nodo, el servidor o clúster. Los proveedores de recursos incluyen proveedores de correo, proveedores de URL y proveedores del entorno de recursos. No tiene que escribir scripts personalizados para configurar recursos en un ámbito determinado.
Atención: Los scripts del ejemplo de uso y la sintaxis del script se han partido en varias líneas para facilitar la impresión.

Formato del argumento scope

El formato de scope se aplica a los scripts de la biblioteca de scripts que tienen el argumento scope.

Una célula es opcional en los ámbitos de nodo, servidor y clúster. Se requiere un nodo en el ámbito de servidor.

Puede delimitar el tipo utilizando una coma (,) o un signo de dos puntos (:). Puede utilizar las minúsculas para el tipo (cell=, node=, server= o cluster=.)

Los ejemplos de la tabla siguiente se dividen en varias líneas para facilitar su publicación.

Tabla 1. Ejemplos de vía de acceso de contención, ID de configuración y tipo de un ámbito concreto. El ámbito puede ser Célula, Nodo, Servidor o Clúster.
Ámbito Vía de acceso de contención ID de configuración Tipo
Cell /Cell:myCell/
myCell(cells/myCell|
cell.xml#Cell_1)
Cell=myCell o cell=myCell
Nodo /Cell:myCell/Node:myNode/ o /Node:myNode/
myNode(cells/myCell
/nodes/myNode|
node.xml#Node_1)
Cell=myCell,
Node=myNode
o
Cell=myCell:
Node=myNode
o
cell=myCell,
node=myNode
Servidor
/Cell:myCell/Node:
myNode/
Server:myServer/
o
/Node:myNode/Server:
myServer/
myServer(cells
/myCell/
nodes/myNode/
servers/myServer|
server.xml#Server_1)
Cell=myCell,
Node=myNode,
Server=myServer
o bien
Node=myNode:
Server=myServer
o bien
cell=myCell,
Node=myNode,
Server=myServer
Clúster
/Cell:myCell/
ServerCluster:
myCluster/
o bien
/ServerCluster:
myCluster/
myCluster(cells
/myCell/clusters/
myCluster|
cluster.xml
#ServerCluster_1)
Cell=myCell,
Cluster=myCluster
o bien
Cell=myCell:
Cluster=myCluster
o bien
cell=myCell,
Cluster=myCluster

createDataSource

Este script crea un origen de datos nuevo en la configuración. El script devuelve el ID de configuración del origen de datos nuevo.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, proveedor JDBC y nombre de origen de datos. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 2. Script createDataSource. Argumentos necesarios y opcionales.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jdbcProvider Especifica el nombre del proveedor JDBC de interés.
dsName Especifica el nombre que se debe asignar al nuevo origen de datos.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 3. Atributos opcionales. Varios scripts tienen estos atributos.
Atributos Descripción Ejemplo
authDataAlias Especifica el alias que se utiliza para la autenticación de base de datos en tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.  
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JDBC de la instancia de fábrica de conexiones JDBC padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["connectionPool",[["agedTimeout","100"],
["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],
["maxConnections","12"],["minConnections","5"],
["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],
["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy","EntirePool"],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],
["unusedTimeout","10000"]]]
datasourceHelperClassname Especifica el nombre de la clase de implementación DataStoreHelper que amplía las posibilidades de la clase de implementación del controlador JDBC. Las posibilidades ampliadas permiten que el controlador JDBC pueda realizar funciones específicas de los datos.
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
description Especifica una descripción del origen de datos.
['description', 'My description']
jndiName Especifica el nombre de la interfaz JNDI (Java Naming and Directory Interface) correspondiente a este origen de datos.
['jndiName', 'myJndiName']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'false']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'false']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
"retryInterval", "12343"],"retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name", "myName"],"required","false"],
["type","String"],["validationExpression",""],
"value','myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[name databaseName][type string][value mys]] 
[name driverType][type integer][value 4]] 
[name serverName][type string][value localhost]]
[[name portNumber][type integer][value 50000]] ]]]]
relationalResourceAdapter Especifica el adaptador de recursos relacional que utiliza el origen de datos. El ID de adaptador de recursos J2C (Java 2 Connector) de J2CResourceAdapterID se puede identificar con el mandato AdminConfig.list('J2CResourceAdapter').
[relationalResourceAdapter "WebSphere Relational Resource 
Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
statementCacheSize Especifica el número de sentencias que el producto puede almacenar en la caché para cada conexión. El producto optimiza el proceso de las sentencias preparadas y las sentencias a las que se puede llamar almacenando en la caché aquellas que no se utilizan en una conexión activa. Ambos tipos de sentencias mejoran el rendimiento de las transacciones entre una aplicación y un almacén de datos. Si las sentencias se almacenan en la memoria caché estarán disponibles con mayor rapidez.
['statementCacheSize', 5]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['-xaRecoveryAuthAlias', 'myCellManager01/a1']
Tabla 4. Atributos opcionales (continuación). El atributo providerType también está disponible para el script.
Atributos Descripción Ejemplo
providerType Especifica el tipo de proveedor JDBC que utiliza este proveedor JDBC.
['providerType', 'DB2 Using IBM JCC Driver']

Sintaxis

Atributo opcional providerType

Sintaxis

Utilice la sintaxis de mandato siguiente para buscar el nombre del tipo de proveedor JDBC. Sólo los ID de plantilla de proveedor JDBC que contienen la subserie templates/system|jdbc-resource-provider-templates.xml tienen nombres válidos de tipo de proveedor JDBC. El nombre del tipo de proveedor JDBC y su subserie forman el ID de plantilla de proveedor JDBC.
AdminConfig.listTemplates('JDBCProvider')
Resultado parcial de ejemplo que muestra el ID de plantilla de proveedor JDBC para el nombre del tipo de proveedor JDBC de Derby JDBC Provider (XA):
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Algunos ID de plantilla de proveedor JDBC:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
AdminJDBC.createDataSource(nodeName, serverName, 
 jdbcProvider, dsName, attributes)

Ejemplo de uso

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

AdminJDBC.createDataSource("myNode", "myServer", "myJDBCProvider", 
 "myDataSource")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createDataSource("IBM-F4A849C57A0Node01", "server1", "My JDBC Name2", "MyJDBCDS", 
"authDataAlias=cellManager01/myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
datasourceHelperClassname=com.ibm.websphere.rsadapter.DB2DataStoreHelper, 
description='My description', diagnoseConnectionUsage=true, jndiName=myJndiName, 
logMissingTransactionContext=false, manageCachedHandles=false, providerType='DB2 Using IBM JCC Driver', 
xaRecoveryAuthAlias=myCellManager01/xa1")

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

AdminJDBC.createDataSource("IBM-F4A849C57A0Node01", "server1", "My JDBC Name2", "MyJDBCDS", 
[['authDataAlias', 'cellManager01/myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['connectionPool', [['agedTimeout', 100], 
['connectionTimeout', 1000], ['freePoolDistributionTableSize', 10], ['maxConnections', 12], ['minConnections', 5], 
['numberOfFreePoolPartitions', 3], ['numberOfSharedPoolPartitions', 6], ['numberOfUnsharedPoolPartitions', 3], 
['properties', [[['name', 'name1a'], ['value', 'value1a']], [['name', 'name1b'], ['value', 'value1b']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', 10000], ['stuckThreshold', 3], ['stuckTime', 10], ['stuckTimerTime', 10], 
['surgeThreshold', 10], ['testConnection', 'true']]], ['datasourceHelperClassname', 
'com.ibm.websphere.rsadapter.DB2DataStoreHelper'], 
['description', 'My description'], ['diagnoseConnectionUsage', 'true'], ['jndiName', 'myJndiName'], 
['logMissingTransactionContext', 'false'], 
['manageCachedHandles', 'false'], ['mapping', [['authDataAlias', 'anAlias'], ['mappingConfigAlias', 'anotherTest']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', 12343], ['retryLimit', 4]]], ['properties', 
[[['name', 'name1'], ['value', 'value1']], [['name', 'name2'], ['value', 'value2']]]], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'integer'], ['value', 4]], [['name', 'serverName'], ['type', 'String'], ['value', 'localhost']], 
[['name', 'portNumber'], ['type', 'integer'], ['value', 50000]]]]]], ['providerType', 'DB2 Using IBM JCC Driver'], 
['relationalResourceAdapter', 'SIB JMS Resource Adapter
(cells/IBM-F4A849C57A0Cell01/nodes/IBM-F4A849C57A0Node01/servers/server1|resources.xml#J2CResourceAdapter_1232911649746)'], 
['statementCacheSize', 5], ['xaRecoveryAuthAlias', 'myCellManager01/xa1']] )

createDataSourceUsingTemplate

Este script utiliza una plantilla para crear un origen de datos nuevo en la configuración. El script devuelve el ID de configuración del origen de datos nuevo.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, proveedor JDBC, ID de plantilla y nombre de origen de datos. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 5. Script createDataSourceUsingTemplate. Argumentos necesarios y opcionales.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jdbcProvider Especifica el nombre del proveedor JDBC de interés.
templateID Especifica el ID de configuración de la plantilla que se debe utilizar para crear el miembro del clúster.
dsName Especifica el nombre que se debe asignar al nuevo origen de datos.
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. Varios scripts tienen estos atributos.
Atributos Descripción Ejemplo
authDataAlias Especifica el alias que se utiliza para la autenticación de base de datos en tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.  
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JDBC de la instancia de fábrica de conexiones JDBC padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["connectionPool",[["agedTimeout","100"],
["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],
["maxConnections","12"],["minConnections","5"],
["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],
["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy","EntirePool"],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],
["unusedTimeout","10000"]]]
datasourceHelperClassname Especifica el nombre de la clase de implementación DataStoreHelper que amplía las posibilidades de la clase de implementación del controlador JDBC. Las posibilidades ampliadas permiten que el controlador JDBC pueda realizar funciones específicas de los datos.
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
description Especifica una descripción del origen de datos.
['description', 'My description']
jndiName Especifica el nombre de la interfaz JNDI (Java Naming and Directory Interface) correspondiente a este origen de datos.
['jndiName', 'myJndiName']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'false']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'false']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
"retryInterval", "12343"],"retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name", "myName"],"required","false"],
["type","String"],["validationExpression",""],
"value','myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[name databaseName][type string][value mys]] 
[name driverType][type integer][value 4]] 
[name serverName][type string][value localhost]]
[[name portNumber][type integer][value 50000]] ]]]]
relationalResourceAdapter Especifica el adaptador de recursos relacional que utiliza el origen de datos. El ID de adaptador de recursos J2C (Java 2 Connector) de J2CResourceAdapterID se puede identificar con el mandato AdminConfig.list('J2CResourceAdapter').
[relationalResourceAdapter "WebSphere Relational Resource 
Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
statementCacheSize Especifica el número de sentencias que el producto puede almacenar en la caché para cada conexión. El producto optimiza el proceso de las sentencias preparadas y las sentencias a las que se puede llamar almacenando en la caché aquellas que no se utilizan en una conexión activa. Ambos tipos de sentencias mejoran el rendimiento de las transacciones entre una aplicación y un almacén de datos. Si las sentencias se almacenan en la memoria caché estarán disponibles con mayor rapidez.
['statementCacheSize', 5]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['-xaRecoveryAuthAlias', 'myCellManager01/a1']
Tabla 7. Atributos opcionales (continuación). Varios scripts tienen este atributo.
Atributos Descripción Ejemplo
providerType Especifica el tipo de proveedor JDBC que utiliza este proveedor JDBC.
['providerType', 'DB2 Using IBM JCC Driver']

Sintaxis

Atributo opcional providerType

Sintaxis

Utilice la sintaxis de mandato siguiente para buscar el nombre del tipo de proveedor JDBC. Sólo los ID de plantilla de proveedor JDBC que contienen la subserie templates/system|jdbc-resource-provider-templates.xml tienen nombres válidos de tipo de proveedor JDBC. El nombre del tipo de proveedor JDBC y su subserie forman el ID de plantilla de proveedor JDBC.
AdminConfig.listTemplates('JDBCProvider')
Resultado parcial de ejemplo que muestra el ID de plantilla de proveedor JDBC para el nombre del tipo de proveedor JDBC de Derby JDBC Provider (XA):
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Algunos ID de plantilla de proveedor JDBC:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
AdminJDBC.createDataSourceUsingTemplate(nodeName, 
 serverName, jdbcProvider, templateID, dsName, 
 attributes)

Ejemplo de uso

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

AdminJDBC.createDataSourceUsingTemplate("myNode", "myServer", 
 "myJDBCProvider", "Derby JDBC Driver 
 DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_derby_1)", "myDataSource")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createDataSourceUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JDBC Name2", 
"DB2 Universal JDBC Driver DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_DB2_UNI_1)", 
"MyJDBCDS", "authDataAlias=cellManager01/myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
datasourceHelperClassname=com.ibm.websphere.rsadapter.DB2DataStoreHelper, description='My description', 
diagnoseConnectionUsage=true, jndiName=myJndiName, logMissingTransactionContext=false, manageCachedHandles=false, 
providerType='DB2 Using IBM JCC Driver', xaRecoveryAuthAlias=myCellManager01/xa1")

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

AdminJDBC.createDataSourceUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JDBC Name2", 
"DB2 Universal JDBC Driver DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_DB2_UNI_1)", 
"MyJDBCDS", [['authDataAlias', 'cellManager01/myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['connectionPool', [['agedTimeout', 100], ['connectionTimeout', 1000], 
['freePoolDistributionTableSize', 10], 
['maxConnections', 12], 
['minConnections', 5], ['numberOfFreePoolPartitions', 3], ['numberOfSharedPoolPartitions', 6], 
['numberOfUnsharedPoolPartitions', 3], 
['properties', [[['name', 'name1a'], ['value', 'value1a']], [['name', 'name1b'], ['value', 'value1b']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', 10000], ['stuckThreshold', 3], ['stuckTime', 10], ['stuckTimerTime', 10], 
['surgeThreshold', 10], ['testConnection', 'true']]], ['datasourceHelperClassname', 
'com.ibm.websphere.rsadapter.DB2DataStoreHelper'], 
['description', 'My description'], ['diagnoseConnectionUsage', 'true'], ['jndiName', 'myJndiName'], 
['logMissingTransactionContext', 'false'], 
['manageCachedHandles', 'false'], ['mapping', [['authDataAlias', 'anAlias'], ['mappingConfigAlias', 'anotherTest']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', 12343], ['retryLimit', 4]]],
 ['properties', [[['name', 'name1'], 
['value', 'value1']], [['name', 'name2'], ['value', 'value2']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'String'], ['value', 'localhost']], [['name', 'portNumber'], ['type', 'integer'], 
['value', 50000]]]]]], ['providerType', 'DB2 Using IBM JCC Driver'], 
['relationalResourceAdapter', 
'SIB JMS Resource Adapter(cells/IBM-F4A849C57A0Cell01/clusters/c1|resources.xml#J2CResourceAdapter_1232911649746)'], 
['statementCacheSize', 5], ['xaRecoveryAuthAlias', 'myCellManager01/xa1']] )

createDataSourceAtScope

Este script crea un origen de datos nuevo en la configuración en el ámbito que especifique. El script devuelve el ID de configuración del origen de datos nuevo. El procedimiento de script utiliza el mandato administrativo createDatasource para crear un origen de datos nuevo. El script createDataSource crea un origen de datos nuevo con el mandato AdminConfig create.

Para ejecutar el script, especifique los argumentos de ámbito, proveedor JDBC, nombre de origen de datos y nombre de base de datos. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 8. Script createDataSourceAtScope. Argumentos necesarios y opcionales.
Argumento Descripción
scope Especifica un ámbito de célula, nodo, servidor o clúster del proveedor de JDBC.
JDBCName Especifica el nombre del proveedor JDBC de interés.
datasourceName Especifica el nombre que se debe asignar al nuevo origen de datos.
jndiName Especifica el nombre de la interfaz JNDI (Java Naming and Directory Interface) correspondiente a este origen de datos.
dataStoreHelperClassName Especifica el nombre de la clase de implementación DataStoreHelper que amplía las posibilidades de la clase de implementación del controlador JDBC para llevar a cabo funciones de datos específicos.
dbName (URL de la base de datos Oracle) Especifica el nombre que se va a asignar a la base de datos del proveedor JDBC.

En un proveedor JDBC que utiliza la base de datos Oracle, el argumento especifica el URL de la base de datos de la que el origen de datos obtiene conexiones. Por ejemplo, jdbc:oracle:thin:@localhost:1521:sample para un controlador ligero y jdbc:oracle:oci8:@sample para un controlador pesado.

otherAttributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
resoureAttributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
failonerror Especifica los programas de utilidad de administración procesa una condición de error.
Tabla 9. Atributos opcionales. Varios scripts tienen estos atributos.
Atributos Descripción
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
componentManagedAuthenticationAlias Especifica el alias que se utiliza para autenticar bases de datos durante el tiempo de ejecución.
containerManagedPersistence Especifica que se ha habilitado la persistencia gestionada por contenedor cuando se ha establecido en true.
description Especifica una descripción del origen de datos.
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
Tabla 10. Atributos de recursos . Varios scripts tienen estos atributos.
Atributos Descripción
driverType Especifica el tipo de origen de datos. El tipo de origen de datos es válido sólo para los proveedores JDBC que tienen un tipo de base de datos de DB2.
portNumber Especifica el número de puerto del servidor de base de datos. El número de puerto es válido sólo para los proveedores JDBC que tienen un tipo de base de datos de DB2, Informix, Sybase o SQLServer.
serverName Especifica el nombre de host del servidor de base de datos o dirección IP. El nombre del servidor es válido sólo para los proveedores JDBC que tienen un tipo de base de datos de DB2, Informix, Sybase o SQLServer.
ifxIFHOST Especifica el tiempo de espera de conexión para obtener un bloqueo en la base de datos. De manera predeterminada, la base de datos Informix devuelve un error cuando no puede adquirir un bloqueo, en lugar de esperar a que el propietario actual del bloqueo lo libere. Para modificar este comportamiento, establezca la propiedad en el número de segundos que debe esperar a que se produzca un bloqueo. El valor predeterminado es de dos segundos. Cualquier valor negativo se convierte en un tiempo de espera ilimitado. Este atributo es válido sólo para los proveedores JDBC que tienen un tipo de base de datos de Informix.
informixLockModeWait Especifica el nombre de la máquina física del servidor que alberga la instancia de Informix. Puede especificar un nombre de host o una dirección IP. También puede especificar el Protocolo de Internet Versión 6 (IPv6) si es compatible con la base de datos del host. Este atributo es válido sólo para los proveedores JDBC que tienen un tipo de base de datos de Informix.

Sintaxis

AdminJDBC.createDataSourceAtScope(scope,
 jdbcProvider, dsName, databaseName, attributes)

Ejemplo de uso

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

AdminJDBC.createDataSourceAtScope("myScope", "myJDBCProvider", 
 "myDataSource",  "myDatabase")

Scripts de ejemplo del tipo de base de datos DB2:

El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1",
"MyTestJDBCProviderName", "newds2", "newds2/jndi", "com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper", "db1", 
" category=myCategory, componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, containerManagedPersistence=true, 
description='My description', xaRecoveryAuthAlias=CellManager01/xaAliase", "serverName=localhost, 
driverType=4,portNumber=50000")

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

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"MyTestJDBCProviderName", "newds2", "newds2/jndi", "com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper", 
"db1", [['category', 'myCategory'], ['componentManagedAuthenticationAlias',
'CellManager01/AuthDataAliase'], ['containerManagedPersistence', 'true'], ['description', 'My description'], 
['xaRecoveryAuthAlias', 'CellManager01/xaAliase']] , [['serverName', 'localhost'], ['driverType', 4], ['portNumber', 50000]])

Scripts de ejemplo de la base de datos Derby:

El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Derby JDBC Provider", "Derby DataSource", "newds2/jndi", "com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper", 
"db1",  " category=myCategory, componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, 
containerManagedPersistence=true, description=My description, xaRecoveryAuthAlias=CellManager01/xaAliase")

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

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Derby JDBC Provider", "Derby DataSource", "newds2/jndi", "com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper", 
"db1",  [['category', 'myCategory'], ['componentManagedAuthenticationAlias', 'CellManager01/AuthDataAliase'], 
['containerManagedPersistence', 'true'], ['description', 'My description'], ['xaRecoveryAuthAlias', 
'CellManager01/xaAliase']])

Scripts de ejemplo de la base de datos Informix:

El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01", "Informix JDBC Driver Test", "My DataSource", 
"My JNDIName", "com.ibm.websphere.rsadapter.InformixDataStoreHelper", "MyDB", " category=myCategory, 
componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, containerManagedPersistence=true,
description='My description',
xaRecoveryAuthAlias=CellManager01/xaAliase", "serverName=ol_myserver, portNumber=50000, ifxIFXHOST=localhost,
informixLockModeWait=2") 

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

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01", "Informix JDBC Driver Test", "My DataSource", 
"My JNDIName", "com.ibm.websphere.rsadapter.InformixDataStoreHelper", "MyDB", [['category', 'myCategory'], 
['componentManagedAuthenticationAlias', 'CellManager01/AuthDataAliase'], ['containerManagedPersistence', 'true'],
['description', 'My description'], ['xaRecoveryAuthAlias', 'CellManager01/xaAliase']] , [['serverName', 'ol_myserver'],
['portNumber', 1526], ['ifxIFXHOST', 'localhost'], ['informixLockModeWait', 2]])

Scripts de ejemplo de la base de datos Oracle:

El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Oracle JDBC Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.OracleDataStoreHelper", 
"http://myURL.com",  "category=myCategory, componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, 
containerManagedPersistence=true, description='My description', xaRecoveryAuthAlias=CellManager01/xaAliase")

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

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Oracle JDBC Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.OracleDataStoreHelper", 
"http://myURL.com",
[['category', 'myCategory'], ['componentManagedAuthenticationAlias', 'CellManager01/AuthDataAliase'], 
['containerManagedPersistence', 'true'], ['description', 'My description'], ['xaRecoveryAuthAlias',
 'CellManager01/xaAliase']])

Scripts de ejemplo de la base de datos SQLServer:

El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Microsoft SQL Server JDBC Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.SQLserverDataStoreHelper", 
"myDBName", " category=myCategory, componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, 
containerManagedPersistence=true, description='My description', xaRecoveryAuthAlias=CellManager01/xaAliase", 
"serverName=localhost, portNumber=1433")

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

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Microsoft SQL Server JDBC Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.SQLserverDataStoreHelper", 
"myDBName", [['category', 'myCategory'], ['componentManagedAuthenticationAlias', 'CellManager01/AuthDataAliase'], 
['containerManagedPersistence', 'true'], ['description', 'My description'], ['xaRecoveryAuthAlias', 'CellManager01/xaAliase']] , 
[['serverName', 'localhost'], ['portNumber', 1433]])

Scripts de ejemplo de la base de datos Sybase:

El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Sybase JDBC 3 Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.SybaseserverDataStoreHelper", 
"myDBName", " category=myCategory, componentManagedAuthenticationAlias=CellManager01/AuthDataAliase, 
containerManagedPersistence=true, description='My description', xaRecoveryAuthAlias=CellManager01/xaAliase", 
"serverName=localhost, portNumber=1433")

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

AdminJDBC.createDataSourceAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"Sybase JDBC 3 Driver", "My DataSource", "My JNDIName", "com.ibm.websphere.rsadapter.SybaseserverDataStoreHelper", 
"myDBName", [['category', 'myCategory'], ['componentManagedAuthenticationAlias', 'CellManager01/AuthDataAliase'], 
['containerManagedPersistence', 'true'], ['description', 'My description'], ['xaRecoveryAuthAlias', 'CellManager01/xaAliase']] , 
[['serverName', 'localhost'], ['portNumber', 2638]])

createDataSourceUsingTemplateAtScope

Este script utiliza una plantilla para crear un origen de datos nuevo en la configuración en el ámbito que especifique. El script devuelve el ID de configuración del origen de datos nuevo.

Para ejecutar el script, especifique los argumentos de ámbito, proveedor JDBC, ID de plantilla y nombre de origen de datos. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 11. Script createDataSourceUsingTemplateAtScope. Argumentos necesarios y opcionales.
Argumento Descripción
scope Especifica un ámbito de célula, nodo, servidor o clúster del proveedor de JDBC.
jdbcProvider Especifica el nombre del proveedor JDBC de interés.
templateID Especifica el ID de configuración de la plantilla que se debe utilizar para crear el miembro del clúster.
dsName Especifica el nombre que se debe asignar al nuevo origen de datos.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 12. Atributos opcionales. Varios scripts tienen estos atributos.
Atributos Descripción Ejemplo
authDataAlias Especifica el alias que se utiliza para la autenticación de base de datos en tiempo de ejecución.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Especifica el mecanismo de autenticación. Los valores válidos son BASIC_PASSWORD para autenticación básica y KERBEROS para autenticación Kerberos.  
categoría Especifica la categoría que puede utilizarse para clasificar o agrupar recursos.
['category', 'myCategory']
connectionPool Especifica las propiedades de agrupación de conexiones JDBC de la instancia de fábrica de conexiones JDBC padre.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["connectionPool",[["agedTimeout","100"],
["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],
["maxConnections","12"],["minConnections","5"],
["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],
["properties",[["description","Mi descripción"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy","EntirePool"],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],
["unusedTimeout","10000"]]]
datasourceHelperClassname Especifica el nombre de la clase de implementación DataStoreHelper que amplía las posibilidades de la clase de implementación del controlador JDBC. Las posibilidades ampliadas permiten que el controlador JDBC pueda realizar funciones específicas de los datos.
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
description Especifica una descripción del origen de datos.
['description', 'My description']
jndiName Especifica el nombre de la interfaz JNDI (Java Naming and Directory Interface) correspondiente a este origen de datos.
['jndiName', 'myJndiName']
logMissingTransactionContext Especifica si se han habilitado los registros cronológicos de contexto de transacciones que faltan.
['logMissingTransactionContext', 'false']
manageCachedHandles Especifica si este origen de datos se utiliza para la persistencia gestionada por contenedor de enterprise beans. El valor predeterminado es true.
['manageCachedHandles', 'false']
mapping Especifica la correlación del inicio de sesión de configuración con un nombre de alias de autenticación especificado.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Especifica los valores de configuración de conexión de preprueba.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["preTestConfig",[["preTestConnection", "true"],
"retryInterval", "12343"],"retryLimit", "4"]]]
properties Especifica un tipo de propiedad definida o un tipo de propiedad descriptiva.

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

["properties",[["description","Mi descripción"],
["name", "myName"],"required","false"],
["type","String"],["validationExpression",""],
"value','myValue"]]]
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[name databaseName][type string][value mys]] 
[name driverType][type integer][value 4]] 
[name serverName][type string][value localhost]]
[[name portNumber][type integer][value 50000]] ]]]]
relationalResourceAdapter Especifica el adaptador de recursos relacional que utiliza el origen de datos. El ID de adaptador de recursos J2C (Java 2 Connector) de J2CResourceAdapterID se puede identificar con el mandato AdminConfig.list('J2CResourceAdapter').
[relationalResourceAdapter "WebSphere Relational Resource 
Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
statementCacheSize Especifica el número de sentencias que el producto puede almacenar en la caché para cada conexión. El producto optimiza el proceso de las sentencias preparadas y las sentencias a las que se puede llamar almacenando en la caché aquellas que no se utilizan en una conexión activa. Ambos tipos de sentencias mejoran el rendimiento de las transacciones entre una aplicación y un almacén de datos. Si las sentencias se almacenan en la memoria caché estarán disponibles con mayor rapidez.
['statementCacheSize', 5]
xaRecoveryAuthAlias Especifica el alias de autenticación de la base de datos que se utiliza durante el proceso de recuperación XA. Si se especifica esta propiedad, el valor predeterminado es el alias de autenticación de la aplicación.
['-xaRecoveryAuthAlias', 'myCellManager01/a1']
Tabla 13. Atributos opcionales (continuación). Varios scripts tienen este atributo.
Atributos Descripción Ejemplo
providerType Especifica el tipo de proveedor JDBC que utiliza este proveedor JDBC.
['providerType', 'DB2 Using IBM JCC Driver']

Sintaxis

Atributo opcional providerType

Sintaxis

Utilice la sintaxis de mandato siguiente para buscar el nombre del tipo de proveedor JDBC. Sólo los ID de plantilla de proveedor JDBC que contienen la subserie templates/system|jdbc-resource-provider-templates.xml tienen nombres válidos de tipo de proveedor JDBC. El nombre del tipo de proveedor JDBC y su subserie forman el ID de plantilla de proveedor JDBC.
AdminConfig.listTemplates('JDBCProvider')
Resultado parcial de ejemplo que muestra el ID de plantilla de proveedor JDBC para el nombre del tipo de proveedor JDBC de Derby JDBC Provider (XA):
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Algunos ID de plantilla de proveedor JDBC:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
AdminJDBC.createDataSourceUsingTemplateAtScope(nodeName, 
 serverName, jdbcProvider, templateID, dsName, 
 attributes)

Ejemplo de uso

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

AdminJDBC.createDataSourceUsingTemplateAtScope("myNode", "myServer", 
 "myJDBCProvider", "Derby JDBC Driver 
 DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_derby_1)", "myDataSource")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createDataSourceUsingTemplateAtScope("/Cell:IBM-F4A849C57A0Cell01/Node:IBM-F4A849C57A0Node01/Server:server1", 
"My JDBC Name2",
"DB2 Universal JDBC Driver DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_DB2_UNI_1)", 
"MyJDBCDS", "authDataAlias=cellManager01/myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
datasourceHelperClassname=com.ibm.websphere.rsadapter.DB2DataStoreHelper, description='My description', 
diagnoseConnectionUsage=true, jndiName=myJndiName, logMissingTransactionContext=false, manageCachedHandles=false, 
providerType='DB2 Using IBM JCC Driver', xaRecoveryAuthAlias=myCellManager01/xa1")

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

AdminJDBC.createDataSourceUsingTemplateAtScope("/Cell:IBM-F4A849C57A0Cell01/Node:IBM-F4A849C57A0Node01/Server:server1", 
"My JDBC Name2",
"DB2 Universal JDBC Driver DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_DB2_UNI_1)", 
"MyJDBCDS", [['authDataAlias', 'cellManager01/myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['connectionPool', [['agedTimeout', 100], ['connectionTimeout', 1000], 
['freePoolDistributionTableSize', 10], 
['maxConnections', 12], ['minConnections', 5], ['numberOfFreePoolPartitions', 3], ['numberOfSharedPoolPartitions', 6], 
['numberOfUnsharedPoolPartitions', 3], ['properties', [[['name', 'name1a'], ['value', 'value1a']], [['name', 'name1b'], 
['value', 'value1b']]]], ['purgePolicy', 'EntirePool'], ['reapTime', 10000], ['stuckThreshold', 3], ['stuckTime', 10], 
['stuckTimerTime', 10], ['surgeThreshold', 10], ['testConnection', 'true']]], 
['datasourceHelperClassname', 'com.ibm.websphere.rsadapter.DB2DataStoreHelper'], 
['description', 'My description'], ['diagnoseConnectionUsage', 'true'], ['jndiName', 'myJndiName'], 
['logMissingTransactionContext', 'false'], 
['manageCachedHandles', 'false'], ['mapping', [['authDataAlias', 'anAlias'], ['mappingConfigAlias', 'anotherTest']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', 12343], ['retryLimit', 4]]], 
['properties', [[['name', 'name1'], 
['value', 'value1']], [['name', 'name2'], ['value', 'value2']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'],
['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'String'], ['value', 'localhost']], [['name', 'portNumber'], ['type', 'integer'], ['value', 50000]]]]]],
['providerType', 'DB2 Using IBM JCC Driver'], 
['relationalResourceAdapter', 
'SIB JMS Resource Adapter(cells/IBM-F4A849C57A0Cell01/clusters/c1|resources.xml#J2CResourceAdapter_1232911649746)'], 
['statementCacheSize', 5], ['xaRecoveryAuthAlias', 'myCellManager01/xa1']] )

createJDBCProvider

Este script crea un proveedor JDBC nuevo en el entorno. El script devuelve el ID de configuración del proveedor JDBC nuevo.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, proveedor JDBC y clase de implementación. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 14. Script createJDBCProvider. Argumentos necesarios y opcionales.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
jdbcProvider Especifica el nombre para asignar al proveedor JDBC nuevo.
implementationClass Especifica el nombre de la clase de implementación que se va a utilizar.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 15. Atributos opcionales. Varios scripts tienen estos atributos.
Atributos Descripción Ejemplo
classpath Especifica una lista de vías de acceso o nombres de archivos JAR (Java Archive) que forman conjuntamente la ubicación de las clases de proveedores de recursos. Utilice un punto y coma (;) para separar las vías de acceso de clases.
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
isolatedClassLoader Si se establece en true, especifica que el proveedor de recursos se ha cargado en su propio cargador de clases.
Atención: No se puede aislar un proveedor cuando se especifica una vía de acceso de biblioteca nativa.
['isolatedClassLoader', 'false']
nativepath Especifica una vía de acceso opcional a cualquier biblioteca nativa, como por ejemplo *.dll y *.so. Las entradas de las vías de acceso nativas están separadas por un punto y coma (;).
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
Tabla 16. Atributos opcionales (continuación). Varios scripts tienen estos atributos.
Atributos Descripción Ejemplo
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
providerType Especifica el tipo de proveedor JDBC que utiliza este proveedor JDBC.
['providerType', 'DB2 Universal JDBC Driver Provider']
xa Los valores posibles son true y false. Si se establece en true, los orígenes de datos para el proveedor generan conexiones que utilizan las aplicaciones en las transacciones globales de compromiso en dos fases. Si se establece en false, los orígenes de datos generan conexiones que utilizan las aplicaciones en las transacciones locales de una sola fase.
true

false

Sintaxis

Atributo opcional de clase de implementación

Sintaxis

Utilice el mandato siguiente para buscar el atributo implementationClassName al especificar el ID de plantilla de proveedor JDBC de JDBCProvID:
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
Ejemplo de uso del atributo implementationClassName:
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
Resultado:
com.ibm.db2.jcc.DB2XADataSource
Posibles nombres de clase de implementación:
  • com.ibm.db2.jcc.DB2ConnectionPoolDataSource
  • com.ibm.db2.jcc.DB2XADataSource
  • com.ibm.db2.jdbc.app.UDBConnectionPoolDataSource
  • com.ibm.db2.jdbc.app.UDBXADataSource
  • com.ibm.as400.access.AS400JDBCConnectionPoolDataSource
  • com.ibm.as400.access.AS400JDBCXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource
  • org.apache.derby.jdbc.ClientXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource40
  • org.apache.derby.jdbc.ClientXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource40
  • org.apache.derby.jdbc.EmbeddedXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource
  • org.apache.derby.jdbc.EmbeddedXADataSource
  • com.informix.jdbcx.IfxConnectionPoolDataSource
  • com.informix.jdbcx.IfxXADataSource oracle.jdbc.pool.OracleConnectionPoolDataSource
  • oracle.jdbc.xa.client.OracleXADataSource
  • com.sybase.jdbc3.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc3.jdbc.SybXADataSource
  • com.sybase.jdbc4.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc4.jdbc.SybXADataSource
  • com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource
  • com.microsoft.sqlserver.jdbc.SQLServerXADataSource
  • com.ddtek.jdbcx.sqlserver.SQLServerDataSource
Atributo opcional providerType

Sintaxis

Utilice la sintaxis de mandato siguiente para buscar el nombre del tipo de proveedor JDBC. Sólo los ID de plantilla de proveedor JDBC que contienen la subserie templates/system|jdbc-resource-provider-templates.xml tienen nombres válidos de tipo de proveedor JDBC. El nombre del tipo de proveedor JDBC y su subserie forman el ID de plantilla de proveedor JDBC.
AdminConfig.listTemplates('JDBCProvider')
Resultado parcial de ejemplo que muestra el ID de plantilla de proveedor JDBC para el nombre del tipo de proveedor JDBC de Derby JDBC Provider (XA):
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Algunos ID de plantilla de proveedor JDBC:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
AdminJDBC.createJDBCProvider(nodeName, serverName, 
 jdbcProvider, implementationClass, attributes)

Ejemplo de uso

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

AdminJDBC.createJDBCProvider("myNode", "myServer", "myJDBCProvider", 
 "myImplementationClass")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createJDBCProvider("IBM-F4A849C57A0Node01", "server1", "My JDBC Name", 
"com.ibm.db2.jcc.DB2ConnectionPoolDataSource",  
" classpath=${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar, 
description='My description', isolatedClassLoader=false, nativepath=${DB2_JCC_DRIVER_NATIVEPATH},  
providerType='DB2 Univesal JDBC Driver Provider', xa=true ") 

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

AdminJDBC.createJDBCProvider("IBM-F4A849C57A0Node01", "server1", "My JDBC Name", 
"com.ibm.db2.jcc.DB2ConnectionPoolDataSource",  
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'],
['description', 'My description'], ['isolatedClassLoader', 'false'], ['nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}'], 
['providerType', 'DB2 Univesal JDBC Driver Provider'], ['xa', 'true'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'Integer'], ['value', 50000]]]]]]])

createJDBCProviderUsingTemplate

Este script utiliza una plantilla para crear un proveedor JDBC nuevo en el entorno. El script devuelve el ID de configuración del proveedor JDBC nuevo.

Para ejecutar el script, especifique los argumentos de nombre de nodo, nombre de servidor, ID de plantilla, nombre de proveedor JDBC y clase de implementación. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 17. Script createJDBCProviderUsingTemplate. Argumentos necesarios y opcionales.
Argumento Descripción
nodeName Especifica el nombre del nodo de interés.
serverName Especifica el nombre del servidor de interés.
templateID Especifica el ID de configuración de la plantilla que se debe utilizar para crear el proveedor JDBC.
jdbcProvider Especifica el nombre para asignar al proveedor JDBC nuevo.
implementationClass Especifica el nombre de la clase de implementación que se va a utilizar.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 18. Atributos opcionales. Varios scripts tienen estos atributos.
Atributos Descripción Ejemplo
classpath Especifica una lista de vías de acceso o nombres de archivos JAR (Java Archive) que forman conjuntamente la ubicación de las clases de proveedores de recursos. Utilice un punto y coma (;) para separar las vías de acceso de clases.
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
isolatedClassLoader Si se establece en true, especifica que el proveedor de recursos se ha cargado en su propio cargador de clases.
Atención: No se puede aislar un proveedor cuando se especifica una vía de acceso de biblioteca nativa.
['isolatedClassLoader', 'false']
nativepath Especifica una vía de acceso opcional a cualquier biblioteca nativa, como por ejemplo *.dll y *.so. Las entradas de las vías de acceso nativas están separadas por un punto y coma (;).
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
Tabla 19. Atributos opcionales (continuación). Varios scripts tienen estos atributos.
Atributos Descripción Ejemplo
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
providerType Especifica el tipo de proveedor JDBC que utiliza este proveedor JDBC.
['providerType', 'DB2 Universal JDBC Driver Provider']
xa Los valores posibles son true y false. Si se establece en true, los orígenes de datos para el proveedor generan conexiones que utilizan las aplicaciones en las transacciones globales de compromiso en dos fases. Si se establece en false, los orígenes de datos generan conexiones que utilizan las aplicaciones en las transacciones locales de una sola fase.
true

false

Sintaxis

Atributo opcional de clase de implementación

Sintaxis

Utilice el mandato siguiente para buscar el atributo implementationClassName al especificar el ID de plantilla de proveedor JDBC de JDBCProvID:
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
Ejemplo de uso del atributo implementationClassName:
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
Resultado:
com.ibm.db2.jcc.DB2XADataSource
Posibles nombres de clase de implementación:
  • com.ibm.db2.jcc.DB2ConnectionPoolDataSource
  • com.ibm.db2.jcc.DB2XADataSource
  • com.ibm.db2.jdbc.app.UDBConnectionPoolDataSource
  • com.ibm.db2.jdbc.app.UDBXADataSource
  • com.ibm.as400.access.AS400JDBCConnectionPoolDataSource
  • com.ibm.as400.access.AS400JDBCXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource
  • org.apache.derby.jdbc.ClientXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource40
  • org.apache.derby.jdbc.ClientXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource40
  • org.apache.derby.jdbc.EmbeddedXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource
  • org.apache.derby.jdbc.EmbeddedXADataSource
  • com.informix.jdbcx.IfxConnectionPoolDataSource
  • com.informix.jdbcx.IfxXADataSource oracle.jdbc.pool.OracleConnectionPoolDataSource
  • oracle.jdbc.xa.client.OracleXADataSource
  • com.sybase.jdbc3.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc3.jdbc.SybXADataSource
  • com.sybase.jdbc4.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc4.jdbc.SybXADataSource
  • com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource
  • com.microsoft.sqlserver.jdbc.SQLServerXADataSource
  • com.ddtek.jdbcx.sqlserver.SQLServerDataSource
Atributo opcional providerType

Sintaxis

Utilice la sintaxis de mandato siguiente para buscar el nombre del tipo de proveedor JDBC. Sólo los ID de plantilla de proveedor JDBC que contienen la subserie templates/system|jdbc-resource-provider-templates.xml tienen nombres válidos de tipo de proveedor JDBC. El nombre del tipo de proveedor JDBC y su subserie forman el ID de plantilla de proveedor JDBC.
AdminConfig.listTemplates('JDBCProvider')
Resultado parcial de ejemplo que muestra el ID de plantilla de proveedor JDBC para el nombre del tipo de proveedor JDBC de Derby JDBC Provider (XA):
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Algunos ID de plantilla de proveedor JDBC:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
AdminJDBC.createJDBCProviderUsingTemplate(nodeName, 
 serverName, templateID, jdbcProvider, 
 implementationClass, attributes)

Ejemplo de uso

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

AdminJDBC.createJDBCProviderUsingTemplate("myNode", "myServer", "Derby JDBC 
 Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#JDBCProvider_1124467079638)", 
 "myJDBCProvider", "myImplementationClass") 
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createJDBCProviderUsingTemplate("IBM-F4A849C57A0Node01", "server1", 
"DB2 Universal JDBC Driver Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_1)", 
"My JDBC Name", "com.ibm.db2.jcc.DB2ConnectionPoolDataSource",  
"classpath= ${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar, 
description='My description', isolatedClassLoader=false, nativepath=${DB2_JCC_DRIVER_NATIVEPATH},  
providerType='DB2 Univesal JDBC Driver Provider', xa=true ") 

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

AdminJDBC.createJDBCProviderUsingTemplate("IBM-F4A849C57A0Node01", "server1", 
"DB2 Universal JDBC Driver Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_1)", 
 My JDBC Name",
"com.ibm.db2.jcc.DB2ConnectionPoolDataSource",  
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], 
['description', 'My description'], ['isolatedClassLoader', 'false'], ['nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}'], 
['providerType', 'DB2 Univesal JDBC Driver Provider'], ['xa', 'true'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'Integer'], ['value', 50000]]]]]]])

createJDBCProviderAtScope

Este script crea un proveedor JDBC nuevo en su entorno en el ámbito que especifique. El script devuelve el ID de configuración del proveedor JDBC nuevo. El procedimiento de script utiliza el mandato administrativo createJDBCProvider para crear un proveedor JDBC nuevo. El procedimiento de script createJDBCProvider crea un proveedor JDBC nuevo con el mandato AdminConfig create.

Para ejecutar el script, especifique los argumentos de ámbito, proveedor JDBC, tipo de base de datos, tipo de proveedor y tipos de implementación. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 20. Script createJDBCProviderAtScope. Argumentos necesarios y opcionales.
Argumento Descripción
scope Especifica un ámbito de célula, nodo, servidor o clúster del proveedor de JDBC.
databaseType Especifica el tipo de base de datos que utiliza este proveedor JDBC. Los valores válidos son DB2, Derby, Informix, Oracle, Sybase, SQL Server y valores definidos por el usuario.
providerType Especifica el tipo de proveedor JDBC que utiliza este proveedor JDBC.
implType Especifica el tipo de implementación que utiliza este proveedor JDBC. Los valores válidos son origen de datos de la agrupación de conexiones y origen de datos XA.
jdbcProvider Especifica el nombre para asignar al proveedor JDBC nuevo.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 21. Atributos opcionales. Varios scripts tienen estos atributos.
Atributos Descripción Ejemplo
classpath Especifica una lista de vías de acceso o nombres de archivos JAR (Java Archive) que forman conjuntamente la ubicación de las clases de proveedores de recursos. Utilice un punto y coma (;) para separar las vías de acceso de clases.
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
isolatedClassLoader Si se establece en true, especifica que el proveedor de recursos se ha cargado en su propio cargador de clases.
Atención: No se puede aislar un proveedor cuando se especifica una vía de acceso de biblioteca nativa.
['isolatedClassLoader', 'false']
nativepath Especifica una vía de acceso opcional a cualquier biblioteca nativa, como por ejemplo *.dll y *.so. Las entradas de las vías de acceso nativas están separadas por un punto y coma (;).
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
Tabla 22. Atributos opcionales (continuación). Varios scripts tienen este atributo.
Atributos Descripción
implementationClassName Especifica la clase de implementación que se ha de utilizar para una plantilla de proveedor JDBC dada.
Atributo opcional providerType

Sintaxis

Utilice la sintaxis de mandato siguiente para buscar el nombre del tipo de proveedor JDBC. Sólo los ID de plantilla de proveedor JDBC que contienen la subserie templates/system|jdbc-resource-provider-templates.xml tienen nombres válidos de tipo de proveedor JDBC. El nombre del tipo de proveedor JDBC y su subserie forman el ID de plantilla de proveedor JDBC.
AdminConfig.listTemplates('JDBCProvider')
Resultado parcial de ejemplo que muestra el ID de plantilla de proveedor JDBC para el nombre del tipo de proveedor JDBC de Derby JDBC Provider (XA):
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Algunos ID de plantilla de proveedor JDBC:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)
Atributo implementationClassName

Sintaxis

Utilice el mandato siguiente para buscar el atributo implementationClassName al especificar el ID de plantilla de proveedor JDBC de JDBCProvID:
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
Ejemplo de uso del atributo implementationClassName:
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
Resultado:
com.ibm.db2.jcc.DB2XADataSource
Posibles nombres de clase de implementación:
  • com.ibm.db2.jcc.DB2ConnectionPoolDataSource
  • com.ibm.db2.jcc.DB2XADataSource
  • com.ibm.db2.jdbc.app.UDBConnectionPoolDataSource
  • com.ibm.db2.jdbc.app.UDBXADataSource
  • com.ibm.as400.access.AS400JDBCConnectionPoolDataSource
  • com.ibm.as400.access.AS400JDBCXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource
  • org.apache.derby.jdbc.ClientXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource40
  • org.apache.derby.jdbc.ClientXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource40
  • org.apache.derby.jdbc.EmbeddedXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource
  • org.apache.derby.jdbc.EmbeddedXADataSource
  • com.informix.jdbcx.IfxConnectionPoolDataSource
  • com.informix.jdbcx.IfxXADataSource oracle.jdbc.pool.OracleConnectionPoolDataSource
  • oracle.jdbc.xa.client.OracleXADataSource
  • com.sybase.jdbc3.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc3.jdbc.SybXADataSource
  • com.sybase.jdbc4.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc4.jdbc.SybXADataSource
  • com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource
  • com.microsoft.sqlserver.jdbc.SQLServerXADataSource
  • com.ddtek.jdbcx.sqlserver.SQLServerDataSource

Script createJDBCProviderAtScope

Sintaxis

AdminJDBC.createJDBCProviderAtScope(scope,
 jdbcProvider, databaseType, providerType, implementationType,
 attributes)

Ejemplo de uso

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

AdminJDBC.createJDBCProviderAtScope("myScope", "myJDBCProvider", "myDatabaseType","myProviderType", 
"myImplementationClass")
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createJDBCProviderAtScope("/Cell:IBM-F4A849C57A0Cell01/Node:IBM-F4A849C57A0Node01", "DB2", 
"DB2 Universal JDBC Driver Provider", "Connection pool data source", "My JDBCProvider Name", 
"description='My description', implementationClassName=com.ibm.db2.jcc.DB2ConnectionPoolDataSource, 
classpath=${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar, 
nativePath=${DB2_JCC_DRIVER_NATIVEPATH}, isolatedClassLoader=false”)

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

AdminJDBC.createJDBCProviderAtScope("/Cell:IBM-F4A849C57A0Cell01/Node:IBM-F4A849C57A0Node01", "DB2", 
"DB2 Universal JDBC Driver Provider", "Connection pool data source", "My JDBCProvider Name", [['description', 'My description'],
[ 'implementationClassName ', 'com.ibm.db2.jcc.DB2ConnectionPoolDataSource'],
[ 'classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], 
[ 'nativePath', '${DB2_JCC_DRIVER_NATIVEPATH}'], ['isolatedClassLoader', 'false'] ])

createJDBCProviderUsingTemplateAtScope

Este script utiliza una plantilla para crear un proveedor JDBC nuevo en su entorno en el ámbito que especifique. El script devuelve el ID de configuración del proveedor JDBC nuevo.

Para ejecutar el script, especifique los argumentos de ámbito, ID de plantilla, nombre de proveedor JDBC y clase de implementación. Opcionalmente puede especificar atributos. Los argumentos y los atributos se definen en las tablas siguientes:
Tabla 23. Script createJDBCProviderUsingTemplateAtScope. Argumentos necesarios y opcionales.
Argumento Descripción
scope Especifica un ámbito de célula, nodo, servidor o clúster del proveedor de JDBC.
templateID Especifica el ID de configuración de la plantilla que se debe utilizar para crear el proveedor JDBC.
jdbcProvider Especifica el nombre para asignar al proveedor JDBC nuevo.
implementationClassName Especifica el nombre de la clase de implementación que se va a utilizar.
attributes
Opcionalmente especifica atributos adicionales en un formato determinado:
Formato de lista
[["attr1", "value1"], ["attr2", "value2"]]
Formato de serie
"atr1=valor1, atr2=valor2"
Tabla 24. Atributos opcionales. Varios scripts tienen estos atributos.
Atributos Descripción Ejemplo
classpath Especifica una lista de vías de acceso o nombres de archivos JAR (Java Archive) que forman conjuntamente la ubicación de las clases de proveedores de recursos. Utilice un punto y coma (;) para separar las vías de acceso de clases.
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description Especifica una descripción del adaptador de recursos.
['description', 'My description']
isolatedClassLoader Si se establece en true, especifica que el proveedor de recursos se ha cargado en su propio cargador de clases.
Atención: No se puede aislar un proveedor cuando se especifica una vía de acceso de biblioteca nativa.
['isolatedClassLoader', 'false']
nativepath Especifica una vía de acceso opcional a cualquier biblioteca nativa, como por ejemplo *.dll y *.so. Las entradas de las vías de acceso nativas están separadas por un punto y coma (;).
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
Tabla 25. Atributos opcionales (continuación). Varios scripts tienen estos atributos.
Atributos Descripción Ejemplo
propertySet Opcionalmente especifica las propiedades de recurso con el formato siguiente: [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Cuando use este atributo en un script, utilice el formato de lista. El formato de serie no funciona porque este atributo es un tipo de objeto de configuración.

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
providerType Especifica el tipo de proveedor JDBC que utiliza este proveedor JDBC.
['providerType', 'DB2 Universal JDBC Driver Provider']
xa Los valores posibles son true y false. Si se establece en true, los orígenes de datos para el proveedor generan conexiones que utilizan las aplicaciones en las transacciones globales de compromiso en dos fases. Si se establece en false, los orígenes de datos generan conexiones que utilizan las aplicaciones en las transacciones locales de una sola fase.
true

false
Atributo opcional de clase de implementación

Sintaxis

Utilice el mandato siguiente para buscar el atributo implementationClassName al especificar el ID de plantilla de proveedor JDBC de JDBCProvID:
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
Ejemplo de uso del atributo implementationClassName:
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
Resultado:
com.ibm.db2.jcc.DB2XADataSource
Posibles nombres de clase de implementación:
  • com.ibm.db2.jcc.DB2ConnectionPoolDataSource
  • com.ibm.db2.jcc.DB2XADataSource
  • com.ibm.db2.jdbc.app.UDBConnectionPoolDataSource
  • com.ibm.db2.jdbc.app.UDBXADataSource
  • com.ibm.as400.access.AS400JDBCConnectionPoolDataSource
  • com.ibm.as400.access.AS400JDBCXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource
  • org.apache.derby.jdbc.ClientXADataSource
  • org.apache.derby.jdbc.ClientConnectionPoolDataSource40
  • org.apache.derby.jdbc.ClientXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource40
  • org.apache.derby.jdbc.EmbeddedXADataSource40
  • org.apache.derby.jdbc.EmbeddedConnectionPoolDataSource
  • org.apache.derby.jdbc.EmbeddedXADataSource
  • com.informix.jdbcx.IfxConnectionPoolDataSource
  • com.informix.jdbcx.IfxXADataSource oracle.jdbc.pool.OracleConnectionPoolDataSource
  • oracle.jdbc.xa.client.OracleXADataSource
  • com.sybase.jdbc3.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc3.jdbc.SybXADataSource
  • com.sybase.jdbc4.jdbc.SybConnectionPoolDataSource
  • com.sybase.jdbc4.jdbc.SybXADataSource
  • com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource
  • com.microsoft.sqlserver.jdbc.SQLServerXADataSource
  • com.ddtek.jdbcx.sqlserver.SQLServerDataSource
Atributo opcional providerType

Sintaxis

Utilice la sintaxis de mandato siguiente para buscar el nombre del tipo de proveedor JDBC. Sólo los ID de plantilla de proveedor JDBC que contienen la subserie templates/system|jdbc-resource-provider-templates.xml tienen nombres válidos de tipo de proveedor JDBC. El nombre del tipo de proveedor JDBC y su subserie forman el ID de plantilla de proveedor JDBC.
AdminConfig.listTemplates('JDBCProvider')
Resultado parcial de ejemplo que muestra el ID de plantilla de proveedor JDBC para el nombre del tipo de proveedor JDBC de Derby JDBC Provider (XA):
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Algunos ID de plantilla de proveedor JDBC:
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
DB2 Legacy CLI-based Type 2 JDBC Driver (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_4)
DB2 UDB for iSeries (Native - V5R1 and earlier)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_db2400_5)"
DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)

Script createJDBCProviderUsingTemplateAtScope

Sintaxis

AdminJDBC.createJDBCProviderUsingTemplateAtScope(scope, 
  templateID, jdbcProvider, 
 implementationClass, attributes)

Ejemplo de uso

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

AdminJDBC.createJDBCProviderUsingTemplateAtScope("myScope", "Derby JDBC 
 Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#JDBCProvider_1124467079638)", 
 "myJDBCProvider", "myImplementationClass") 
El script de ejemplo siguiente contiene atributos opcionales en un formato de serie:
AdminJDBC.createJDBCProviderUsingTemplateAtScope("/Cell:IBM-F4A849C57A0Cell01/ServerCluster:cluster1", 
"DB2 Universal JDBC Driver Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_1)", 
"My JDBC Name001", " com.ibm.db2.jcc.DB2ConnectionPoolDataSource", 
"classpath= ${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar, 
description='My description', isolatedClassLoader=false, nativepath=${DB2_JCC_DRIVER_NATIVEPATH},  
providerType='DB2 Univesal JDBC Driver Provider', xa=true ") 

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

AdminJDBC.createJDBCProviderUsingTemplateAtScope("/Cell:IBM-F4A849C57A0Cell01/ServerCluster:cluster1", 
"DB2 Universal JDBC Driver Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_1)", 
"My JDBC Name001", " com.ibm.db2.jcc.DB2ConnectionPoolDataSource", 
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], 
['description', 'My description'], ['isolatedClassLoader', 'false'], ['nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}'], 
['providerType', 'DB2 Univesal JDBC Driver Provider'], ['xa', 'true'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'Integer'],
['value', 50000]]]]]]])

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_7adminjdbc
File name: rxml_7adminjdbc.html