Scripts de configuration JDBC

La bibliothèque de scripts propose de nombreuses procédures de script pour gérer les configurations JDBC (Java™ Database Connectivity) dans votre environnement. Consultez les informations sur l'utilisation des scripts qui configurent les paramètres JDBC. Vous pouvez exécuter chaque script individuellement ou combiner plusieurs procédures pour créer des scripts d'automatisation personnalisés pour votre environnement.

Chaque procédure de script AdminJDBC se trouve dans le répertoire racine_serveur_app/scriptLibraries/resources/JDBC/V70.

Depuis la Version 7, la bibliothèque de scripts Jython fournit des fonctions de script pour les fournisseurs JDBC, les ressources JMS et les fournisseurs de ressources à la portée du serveur. Vous pouvez écrire vos propres scripts personnalisés pour configurer des ressources au niveau de la cellule, du noeud ou du cluster.
Eviter les incidents Eviter les incidents: Ne modifiez pas les procédures de script de la bibliothèque de scripts. Pour écrire des procédures de bibliothèque de scripts personnalisés, utilisez les scripts du répertoire racine_serveur_app/scriptLibraries en tant qu'exemples de syntaxe Jython. Enregistrez les scripts personnalisés dans un nouveau sous-répertoire pour éviter d'écraser la bibliothèque.gotcha
Raccourci : Depuis Fix Pack 5, la bibliothèque de scripts Jython fournit des fonctions de script pour les fournisseurs JDBC, les ressources JMS et les fournisseurs de ressources à la portée de la cellule, du noeud, du serveur ou du cluster. Les fournisseurs de ressources sont les fournisseurs de messagerie, d'URL et d'environnement de ressources. Vous n'avez pas besoin de rédiger des scripts personnalisés pour configurer des ressources à une portée particulière.
Avertissement : Les modèles de script et leur syntaxe apparaissent sur plusieurs lignes pour des raisons liées à l'affichage.

Format de l'argument de portée

Le format de portée s'applique aux scripts de la bibliothèque de scripts qui possèdent l'argument de portée.

Une cellule est facultative sur des portées de noeud, de serveur et de cluster. Un noeud est obligatoire sur la portée de noeud.

Vous pouvez délimiter le type à l'aide d'une virgule (,) ou d'un signe deux-points (:). Vous pouvez utiliser les minuscules pour le type (cell=, node=, server= ou cluster=.)

Les exemples du tableau suivant sont divisés en plusieurs lignes à des fins de publication.

Tableau 1. Exemple de chemin d'imbrication, d'ID de configuration et de type pour une portée donnée. La portée peut être une cellule, un noeud, un serveur ou un Cluster.
Portée Chemin d'imbrication ID configuration Type
Cell /Cell:myCell/
myCell(cells/myCell|
cell.xml#Cell_1)
Cell=myCell ou cell=myCell
Noeud /Cell:myCell/Node:myNode/ ou /Node:myNode/
myNode(cells/myCell
/nodes/myNode|
node.xml#Node_1)
Cell=myCell,
Node=myNode
ou
Cell=myCell:
Node=myNode
ou
cell=myCell,
node=myNode
Serveur
/Cell:myCell/Node:
myNode/
Server:myServer/
ou
/Node:myNode/Server:
myServer/
myServer(cells
/myCell/
nodes/myNode/
servers/myServer|
server.xml#Server_1)
Cell=myCell,
Node=myNode,
Server=myServer
ou
Node=myNode:
Server=myServer
or
cell=myCell,
Node=myNode,
Server=myServer
Cluster
/Cell:myCell/
ServerCluster:
myCluster/
or
/ServerCluster:
myCluster/
myCluster(cells
/myCell/clusters/
myCluster|
cluster.xml
#ServerCluster_1)
Cell=myCell,
Cluster=myCluster
or
Cell=myCell:
Cluster=myCluster
or
cell=myCell,
Cluster=myCluster

createDataSource

Ce script crée une source de données dans votre configuration. Le script renvoie l'ID de configuration de la nouvelle source de données.

Pour exécuter le script, indiquez les arguments correspondant au nom du noeud, au nom du serveur, au fournisseur JDBC et à la source de données. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 2. Script createDataSource. Arguments obligatoires et facultatifs.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jdbcProvider Indique le nom du fournisseur JDBC qui vous intéresse.
dsName Indique le nom à attribuer à la nouvelle source de données.
attributes
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 3. Attributs facultatifs. Plusieurs scripts comportent ces attributs.
Attributs Description Exemple
authDataAlias Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Indique le mécanisme d'authentification. Les valeurs valides sont BASIC_PASSWORD pour l'authentification de base, et KERBEROS pour l'authentification Kerberos.  
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
connectionPool Indique les propriétés de regroupement des connexions JDBC applicables à l'instance de fabrique de connexions JDBC parente.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["connectionPool",[["agedTimeout","100"],
["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],
["maxConnections","12"],["minConnections","5"],
["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],
["properties",[["description","My description"],
["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 Nom de la classe d'implémentation DataStoreHelper qui étend les capacités de la classe d'implémentation du pilote JDBC. Les capacités étendues permettent au pilote JDBC d'exécuter des fonctions spécifiques sur les données.
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
description Fournit une description de la source de données.
['description', 'My description']
jndiName Indique le nom JNDI (Java Naming and Directory Interface) de la source de données.
['jndiName', 'myJndiName']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'false']
manageCachedHandles Spécifie si cette source de données est utilisée pour la persistance gérée par conteneur des beans enterprise. La valeur par défaut est true.
['manageCachedHandles', 'false']
mappage Définit le mappage du nom de connexion de configuration à un nom d'alias d'authentification spécifié.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Indique les paramètres de configuration du test initial de la connexion.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["preTestConfig",[["preTestConnection", "true"],
"retryInterval", "12343"],"retryLimit", "4"]]]
properties Indique une propriété de type typage ou description.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["properties",[["description","My description"],
["name", "myName"],"required","false"],
["type","String"],["validationExpression",""],
"value','myValue"]]]
propertySet Facultatif. Indique des propriétés de ressource au format suivant : [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

[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 Indique l'adaptateur de ressources relationnelles utilisé par la source de données. Vous pouvez identifier les ID d'adaptateur de ressources Java 2 Connector (J2C) disponibles (J2CResourceAdapterID) avec la commande AdminConfig.list('J2CResourceAdapter').
[relationalResourceAdapter "WebSphere Relational Resource 
Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
statementCacheSize Indique le nombre d'instructions que le produit peut placer dans le cache pour chaque connexion. Le produit optimise le traitement des instructions préparées et des instructions d'appel en plaçant dans la mémoire cache les instructions qui ne sont pas utilisées dans une connexion active. Ces deux types d'instruction améliorent les performances des transactions entre une application et un magasin de données. La mise en cache des instructions les rend facilement accessibles.
['statementCacheSize', 5]
xaRecoveryAuthAlias Alias d'authentification de base de données utilisé lors du traitement de la reprise XA. Lorsque cette propriété est indiquée, la valeur par défaut est l'alias utilisé pour l'authentification de l'application.
['-xaRecoveryAuthAlias', 'myCellManager01/a1']
Tableau 4. Attributs facultatifs (suite). L'attribut providerType est également disponible pour le script.
Attributs Description Exemple
providerType Indique le type du fournisseur JDBC utilisé.
['providerType', 'DB2 Using IBM JCC Driver']

Syntaxe

Attribut facultatif de type de fournisseur

Syntaxe

Utilisez la syntaxe de commande suivante pour rechercher le nom du type defournisseur JDBC. Seuls les ID de modèle de fournisseur JDBC qui contiennent la sous-chaîne templates/system|jdbc-resource-provider-templates.xml contiennent des noms de type de fournisseur JDBC valides. Le nom du type de fournisseur JDBC et sa sous-chaîne forment l'ID de modèle du fournisseur JDBC.
AdminConfig.listTemplates('JDBCProvider')
Exemple de résultat partiel montrant l'ID de modèle du fournisseur JDBC pour le nom de type de fournisseur JDBC de Derby JDBC Provider (XA) :
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Voici quelques ID de modèle de fournisseur 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)

Exemple de syntaxe

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminJDBC.createDataSource("myNode", "myServer", "myJDBCProvider", 
 "myDataSource")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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

Ce script crée une source de données dans votre configuration à partir d'un modèle. Le script renvoie l'ID configuration de la nouvelle source de données.

Pour exécuter le script, indiquez les arguments correspondant au nom du noeud, au nom du serveur, au fournisseur JDBC, à l'ID de modèle et à la source de données. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 5. Script createDataSourceUsingTemplate. Arguments obligatoires et facultatifs.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jdbcProvider Indique le nom du fournisseur JDBC qui vous intéresse.
templateID Indique l'ID configuration du modèle à utiliser pour créer la source de données.
dsName Indique le nom à attribuer à la nouvelle source de données.
attributes
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 6. Attributs facultatifs. Plusieurs scripts comportent ces attributs.
Attributs Description Exemple
authDataAlias Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Indique le mécanisme d'authentification. Les valeurs valides sont BASIC_PASSWORD pour l'authentification de base, et KERBEROS pour l'authentification Kerberos.  
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
connectionPool Indique les propriétés de regroupement des connexions JDBC applicables à l'instance de fabrique de connexions JDBC parente.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["connectionPool",[["agedTimeout","100"],
["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],
["maxConnections","12"],["minConnections","5"],
["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],
["properties",[["description","My description"],
["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 Nom de la classe d'implémentation DataStoreHelper qui étend les capacités de la classe d'implémentation du pilote JDBC. Les capacités étendues permettent au pilote JDBC d'exécuter des fonctions spécifiques sur les données.
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
description Fournit une description de la source de données.
['description', 'My description']
jndiName Indique le nom JNDI (Java Naming and Directory Interface) de la source de données.
['jndiName', 'myJndiName']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'false']
manageCachedHandles Spécifie si cette source de données est utilisée pour la persistance gérée par conteneur des beans enterprise. La valeur par défaut est true.
['manageCachedHandles', 'false']
mappage Définit le mappage du nom de connexion de configuration à un nom d'alias d'authentification spécifié.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Indique les paramètres de configuration du test initial de la connexion.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["preTestConfig",[["preTestConnection", "true"],
"retryInterval", "12343"],"retryLimit", "4"]]]
properties Indique une propriété de type typage ou description.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["properties",[["description","My description"],
["name", "myName"],"required","false"],
["type","String"],["validationExpression",""],
"value','myValue"]]]
propertySet Facultatif. Indique des propriétés de ressource au format suivant : [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

[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 Indique l'adaptateur de ressources relationnelles utilisé par la source de données. Vous pouvez identifier les ID d'adaptateur de ressources Java 2 Connector (J2C) disponibles (J2CResourceAdapterID) avec la commande AdminConfig.list('J2CResourceAdapter').
[relationalResourceAdapter "WebSphere Relational Resource 
Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
statementCacheSize Indique le nombre d'instructions que le produit peut placer dans le cache pour chaque connexion. Le produit optimise le traitement des instructions préparées et des instructions d'appel en plaçant dans la mémoire cache les instructions qui ne sont pas utilisées dans une connexion active. Ces deux types d'instruction améliorent les performances des transactions entre une application et un magasin de données. La mise en cache des instructions les rend facilement accessibles.
['statementCacheSize', 5]
xaRecoveryAuthAlias Alias d'authentification de base de données utilisé lors du traitement de la reprise XA. Lorsque cette propriété est indiquée, la valeur par défaut est l'alias utilisé pour l'authentification de l'application.
['-xaRecoveryAuthAlias', 'myCellManager01/a1']
Tableau 7. Attributs facultatifs (suite). Plusieurs scripts comportent cet attribut.
Attributs Description Exemple
providerType Indique le type du fournisseur JDBC utilisé.
['providerType', 'DB2 Using IBM JCC Driver']

Syntaxe

Attribut facultatif de type de fournisseur

Syntaxe

Utilisez la syntaxe de commande suivante pour rechercher le nom du type defournisseur JDBC. Seuls les ID de modèle de fournisseur JDBC qui contiennent la sous-chaîne templates/system|jdbc-resource-provider-templates.xml contiennent des noms de type de fournisseur JDBC valides. Le nom du type de fournisseur JDBC et sa sous-chaîne forment l'ID de modèle du fournisseur JDBC.
AdminConfig.listTemplates('JDBCProvider')
Exemple de résultat partiel montrant l'ID de modèle du fournisseur JDBC pour le nom de type de fournisseur JDBC de Derby JDBC Provider (XA) :
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Voici quelques ID de modèle de fournisseur 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)

Cas d'utilisation

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminJDBC.createDataSourceUsingTemplate("myNode", "myServer", 
 "myJDBCProvider", "Derby JDBC Driver 
 DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_derby_1)", "myDataSource")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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

Ce script crée une source de données dans votre configuration avec une portée que vous définissez. Le script renvoie l'ID de configuration de la nouvelle source de données. Le script utilise la commande d'administration createDatasource pour créer la source de données. Le script createDataSource crée la source de données à l'aide de la commande create d'AdminConfig.

Pour exécuter le script, indiquez les arguments de la portée, du fournisseur JDBC, du nom de source de données et du nom de base de données. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 8. Script createDataSourceAtScope. Arguments obligatoires et facultatifs.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JDBC.
JDBCName Indique le nom du fournisseur JDBC qui vous intéresse.
datasourceName Indique le nom à attribuer à la nouvelle source de données.
jndiName Indique le nom JNDI (Java Naming and Directory Interface) de la source de données.
dataStoreHelperClassName Indique le nom de la classe d'implémentation DataStoreHelper, qui étend les capacités de la classe d'implémentation du pilote JDBC sélectionné pour exécuter les fonctions spécifiques à la base de données.
dbName (URL pour la base de données Oracle) Indique le nom à attribuer à la base de données pour le fournisseur JDBC.

Dans le cas d'un fournisseur JDBC utilisant une base de données Oracle, l'argument indique l'URL de la base de données à partir de laquelle la source de données obtient les connexions. Par exemple : jdbc:oracle:thin:@localhost:1521:sample pour un driver simple et jdbc:oracle:oci8:@sample pour un driver complexe.

otherAttributes
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
resoureAttributes
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
failonerror Indique l'utilitaire d'administration qui traite un cas d'erreur.
Tableau 9. Attributs facultatifs. Plusieurs scripts comportent ces attributs.
Attributs Description
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
componentManagedAuthenticationAlias Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution.
containerManagedPersistence Si la valeur de cet argument est true, la persistance gérée par le conteneur est activée.
description Fournit une description de la source de données.
xaRecoveryAuthAlias Alias d'authentification de base de données utilisé lors du traitement de la reprise XA. Lorsque cette propriété est indiquée, la valeur par défaut est l'alias utilisé pour l'authentification de l'application.
Tableau 10. Attributs de la ressource. Plusieurs scripts comportent ces attributs.
Attributs Description
driverType Indique le type de la source de données. Cet argument ne s'applique qu'aux fournisseur JDBC utilisant une base de données de type DB2.
portNumber Indique le numéro de port du serveur de base de données. Cet argument ne s'applique qu'aux fournisseurs JDBC utilisant une base de données de type DB2, Informix, Sybase, ou SQLServer.
serverName Indique le nom d'hôte ou l'adresse IP du serveur de base de données. Cet argument ne s'applique qu'aux fournisseurs JDBC utilisant une base de données de type DB2, Informix, Sybase ou SQLServer.
ifxIFHOST Indique le délai d'attente d'une connexion avant l'obtention d'un verrou dans la base de données. Par défaut, la base de données Informix génère une erreur quand elle ne parvient pas à obtenir un verrou au lieu d'attendre que le propriétaire actuel du verrou le libère. Pour modifier ce comportement, réglez cette propriété sur la durée d'attente d'acquisition d'un verrou (exprimée en secondes). La valeur par défaut est 2 secondes. Toute valeur négative se traduit par un délai d'attente illimité. Cet argument ne s'applique qu'aux fournisseur JDBC utilisant une base de données de type Informix.
informixLockModeWait Indique le nom de la machine physique du serveur qui héberge l'instance de la base de données Informix. Vous pouvez saisir un nom d'hôte ou une adresse IP. Vous pouvez également saisir un code IPv6 (Internet Protocol Version 6) si la base de données hôte le permet. Cet argument ne s'applique qu'aux fournisseur JDBC utilisant une base de données de type Informix.

Syntaxe

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

Cas d'utilisation

L'exemple de script suivant contient uniquement des attributs obligatoires :

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

Exemples de script pour la base de données DB2 :

L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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]])

Exemples de script pour la base de données Derby :

L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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']])

Exemples de script pour la base de données Informix :

L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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") 

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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]])

Exemples de script pour la base de données Oracle :

L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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']])

Exemples de script pour la base de données SQLServer :

L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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]])

Exemples de script pour la base de données Sybase :

L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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

Ce script utilise un modèle pour créer une source de données dans votre configuration avec une portée que vous définissez. Le script renvoie l'ID configuration de la nouvelle source de données.

Pour exécuter le script, indiquez les arguments correspondant à la portée, au fournisseur JDBC, à l'ID de modèle et à la source de données. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 11. Script createDataSourceUsingTemplateAtScope. Arguments obligatoires et facultatifs.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JDBC.
jdbcProvider Indique le nom du fournisseur JDBC qui vous intéresse.
templateID Indique l'ID configuration du modèle à utiliser pour créer la source de données.
dsName Indique le nom à attribuer à la nouvelle source de données.
attributes
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 12. Attributs facultatifs. Plusieurs scripts comportent ces attributs.
Attributs Description Exemple
authDataAlias Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution.
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference Indique le mécanisme d'authentification. Les valeurs valides sont BASIC_PASSWORD pour l'authentification de base, et KERBEROS pour l'authentification Kerberos.  
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
connectionPool Indique les propriétés de regroupement des connexions JDBC applicables à l'instance de fabrique de connexions JDBC parente.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["connectionPool",[["agedTimeout","100"],
["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],
["maxConnections","12"],["minConnections","5"],
["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],
["properties",[["description","My description"],
["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 Nom de la classe d'implémentation DataStoreHelper qui étend les capacités de la classe d'implémentation du pilote JDBC. Les capacités étendues permettent au pilote JDBC d'exécuter des fonctions spécifiques sur les données.
com.ibm.websphere.rsadapter.DB2DataStoreHelper
com.ibm.websphere.rsadapter.DerbyDataStoreHelper
...
description Fournit une description de la source de données.
['description', 'My description']
jndiName Indique le nom JNDI (Java Naming and Directory Interface) de la source de données.
['jndiName', 'myJndiName']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'false']
manageCachedHandles Spécifie si cette source de données est utilisée pour la persistance gérée par conteneur des beans enterprise. La valeur par défaut est true.
['manageCachedHandles', 'false']
mappage Définit le mappage du nom de connexion de configuration à un nom d'alias d'authentification spécifié.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig Indique les paramètres de configuration du test initial de la connexion.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["preTestConfig",[["preTestConnection", "true"],
"retryInterval", "12343"],"retryLimit", "4"]]]
properties Indique une propriété de type typage ou description.

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

["properties",[["description","My description"],
["name", "myName"],"required","false"],
["type","String"],["validationExpression",""],
"value','myValue"]]]
propertySet Facultatif. Indique des propriétés de ressource au format suivant : [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

[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 Indique l'adaptateur de ressources relationnelles utilisé par la source de données. Vous pouvez identifier les ID d'adaptateur de ressources Java 2 Connector (J2C) disponibles (J2CResourceAdapterID) avec la commande AdminConfig.list('J2CResourceAdapter').
[relationalResourceAdapter "WebSphere Relational Resource 
Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
statementCacheSize Indique le nombre d'instructions que le produit peut placer dans le cache pour chaque connexion. Le produit optimise le traitement des instructions préparées et des instructions d'appel en plaçant dans la mémoire cache les instructions qui ne sont pas utilisées dans une connexion active. Ces deux types d'instruction améliorent les performances des transactions entre une application et un magasin de données. La mise en cache des instructions les rend facilement accessibles.
['statementCacheSize', 5]
xaRecoveryAuthAlias Alias d'authentification de base de données utilisé lors du traitement de la reprise XA. Lorsque cette propriété est indiquée, la valeur par défaut est l'alias utilisé pour l'authentification de l'application.
['-xaRecoveryAuthAlias', 'myCellManager01/a1']
Tableau 13. Attributs facultatifs (suite). Plusieurs scripts comportent cet attribut.
Attributs Description Exemple
providerType Indique le type du fournisseur JDBC utilisé.
['providerType', 'DB2 Using IBM JCC Driver']

Syntaxe

Attribut facultatif de type de fournisseur

Syntaxe

Utilisez la syntaxe de commande suivante pour rechercher le nom du type defournisseur JDBC. Seuls les ID de modèle de fournisseur JDBC qui contiennent la sous-chaîne templates/system|jdbc-resource-provider-templates.xml contiennent des noms de type de fournisseur JDBC valides. Le nom du type de fournisseur JDBC et sa sous-chaîne forment l'ID de modèle du fournisseur JDBC.
AdminConfig.listTemplates('JDBCProvider')
Exemple de résultat partiel montrant l'ID de modèle du fournisseur JDBC pour le nom de type de fournisseur JDBC de Derby JDBC Provider (XA) :
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Voici quelques ID de modèle de fournisseur 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)

Cas d'utilisation

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminJDBC.createDataSourceUsingTemplateAtScope("myNode", "myServer", 
 "myJDBCProvider", "Derby JDBC Driver 
 DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_derby_1)", "myDataSource")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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")

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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

Ce script crée un fournisseur JDBC dans votre environnement. Le script renvoie l'ID configuration du nouveau fournisseur JDBC.

Pour exécuter le script, indiquez les arguments correspondant au nom du noeud, au nom du serveur, au fournisseur JDBC et à la classe d'implémentation. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 14. Script createJDBCProvider. Arguments obligatoires et facultatifs.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jdbcProvider Indique le nom à attribuer au nouveau fournisseur JDBC.
implementationClass Indique le nom de la classe d'implémentation à utiliser.
attributes
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 15. Attributs facultatifs. Plusieurs scripts comportent ces attributs.
Attributs Description Exemple
classpath Liste de chemins ou de noms de fichiers d'archive Java (JAR) qui, ensemble, spécifient l'emplacement des classes du fournisseur de ressources. Utilisez le point-virgule (;) pour séparer les chemins de classe.
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
isolatedClassLoader Si la valeur associée est true, indique que le fournisseur de ressource sera chargé dans son propre chargeur de classe.
Avertissement : Un fournisseur ne peut pas être isolatedClassLoader lorsque le chemin de la bibliothèque native est spécifié.
['isolatedClassLoader', 'false']
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple *.dll ou *.so. Séparez les entrées de chemin natif avec un point-virgule (;).
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
Tableau 16. Attributs facultatifs (suite). Plusieurs scripts comportent ces attributs.
Attributs Description Exemple
propertySet Facultatif. Indique des propriétés de ressource au format suivant : [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

[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 Indique le type du fournisseur JDBC utilisé.
['providerType', 'DB2 Universal JDBC Driver Provider']
xa Les valeurs admises sont true et false. Si cet attribut a pour valeur true, les sources de données du fournissent génèrent des connexions que les applications utilisent dans les transactions globales de validation à deux phases. S'il a pour valeur false, les sources de données génèrent des connexions que les applications utilisent dans les transactions locales de validation à une seule phase.
true

false

Syntaxe

Attribut facultatif de classe d'implémentation

Syntaxe

Utilisez la syntaxe de commande suivante pour rechercher l'attribut implementationClassName en indiquant l'ID de modèle du fournisseur JDBC pour JDBCProvID :
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
Exemple de syntaxe de l'attribut implementationClassName :
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
Résultat :
com.ibm.db2.jcc.DB2XADataSource
Les noms d'implémentation possibles sont notamment :
  • 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
Attribut facultatif de type de fournisseur

Syntaxe

Utilisez la syntaxe de commande suivante pour rechercher le nom du type defournisseur JDBC. Seuls les ID de modèle de fournisseur JDBC qui contiennent la sous-chaîne templates/system|jdbc-resource-provider-templates.xml contiennent des noms de type de fournisseur JDBC valides. Le nom du type de fournisseur JDBC et sa sous-chaîne forment l'ID de modèle du fournisseur JDBC.
AdminConfig.listTemplates('JDBCProvider')
Exemple de résultat partiel montrant l'ID de modèle du fournisseur JDBC pour le nom de type de fournisseur JDBC de Derby JDBC Provider (XA) :
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Voici quelques ID de modèle de fournisseur 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)

Cas d'utilisation

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminJDBC.createJDBCProvider("myNode", "myServer", "myJDBCProvider", 
 "myImplementationClass")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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 ") 

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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]]]]]]])

Script createJDBCProviderUsingTemplate

Ce script crée un fournisseur JDBC dans votre environnement à partir d'un modèle. Le script renvoie l'ID configuration du nouveau fournisseur JDBC.

Pour exécuter le script, indiquez les arguments correspondant au nom du noeud, au nom du serveur, à l'ID de modèle, au fournisseur JDBC et à la classe d'implémentation. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 17. Script createJDBCProviderUsingTemplate. Arguments obligatoires et facultatifs.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
templateID Indique l'ID configuration du modèle à utiliser pour créer le fournisseur JDBC.
jdbcProvider Indique le nom à attribuer au nouveau fournisseur JDBC.
implementationClass Indique le nom de la classe d'implémentation à utiliser.
attributes
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 18. Attributs facultatifs. Plusieurs scripts comportent ces attributs.
Attributs Description Exemple
classpath Liste de chemins ou de noms de fichiers d'archive Java (JAR) qui, ensemble, spécifient l'emplacement des classes du fournisseur de ressources. Utilisez le point-virgule (;) pour séparer les chemins de classe.
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
isolatedClassLoader Si la valeur associée est true, indique que le fournisseur de ressource sera chargé dans son propre chargeur de classe.
Avertissement : Un fournisseur ne peut pas être isolatedClassLoader lorsque le chemin de la bibliothèque native est spécifié.
['isolatedClassLoader', 'false']
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple *.dll ou *.so. Séparez les entrées de chemin natif avec un point-virgule (;).
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
Tableau 19. Attributs facultatifs (suite). Plusieurs scripts comportent ces attributs.
Attributs Description Exemple
propertySet Facultatif. Indique des propriétés de ressource au format suivant : [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

[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 Indique le type du fournisseur JDBC utilisé.
['providerType', 'DB2 Universal JDBC Driver Provider']
xa Les valeurs admises sont true et false. Si cet attribut a pour valeur true, les sources de données du fournissent génèrent des connexions que les applications utilisent dans les transactions globales de validation à deux phases. S'il a pour valeur false, les sources de données génèrent des connexions que les applications utilisent dans les transactions locales de validation à une seule phase.
true

false

Syntaxe

Attribut facultatif de classe d'implémentation

Syntaxe

Utilisez la syntaxe de commande suivante pour rechercher l'attribut implementationClassName en indiquant l'ID de modèle du fournisseur JDBC pour JDBCProvID :
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
Exemple de syntaxe de l'attribut implementationClassName :
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
Résultat :
com.ibm.db2.jcc.DB2XADataSource
Les noms d'implémentation possibles sont notamment :
  • 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
Attribut facultatif de type de fournisseur

Syntaxe

Utilisez la syntaxe de commande suivante pour rechercher le nom du type defournisseur JDBC. Seuls les ID de modèle de fournisseur JDBC qui contiennent la sous-chaîne templates/system|jdbc-resource-provider-templates.xml contiennent des noms de type de fournisseur JDBC valides. Le nom du type de fournisseur JDBC et sa sous-chaîne forment l'ID de modèle du fournisseur JDBC.
AdminConfig.listTemplates('JDBCProvider')
Exemple de résultat partiel montrant l'ID de modèle du fournisseur JDBC pour le nom de type de fournisseur JDBC de Derby JDBC Provider (XA) :
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Voici quelques ID de modèle de fournisseur 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)

Cas d'utilisation

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminJDBC.createJDBCProviderUsingTemplate("myNode", "myServer", "Derby JDBC 
 Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#JDBCProvider_1124467079638)", 
 "myJDBCProvider", "myImplementationClass") 
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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 ") 

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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]]]]]]])

Script createJDBCProviderAtScope

Ce script crée un fournisseur JDBC dans votre environment avec une portée que vous définissez. Le script renvoie l'ID configuration du nouveau fournisseur JDBC. Le script utilise la commande d'administration createJDBCProvider pour créer le fournisseur JDBC. Le script createJDBCProvider crée un fournisseur JDBC à l'aide de la commande create d'AdminConfig.

Pour exécuter le script, indiquez les arguments de la portée, du fournisseur JDBC, du type de base de données, du type de fournisseur et des types d'implémentation. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 20. Script createJDBCProviderAtScope. Arguments obligatoires et facultatifs.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JDBC.
databaseType Indique le type de base de données utilisé par ce fournisseur JDBC. Les valeurs possibles sont DB2, Derby, Informix, Oracle, Sybase, SQL Server et des valeurs définies par l'utilisateur.
providerType Indique le type du fournisseur JDBC utilisé.
implType Indique le type d'implémentation utilisé par ce fournisseur JDBC. Les valeurs possibles sont Source de données de pool de connexions et Source de données XA.
jdbcProvider Indique le nom à attribuer au nouveau fournisseur JDBC.
attributes
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 21. Attributs facultatifs. Plusieurs scripts comportent ces attributs.
Attributs Description Exemple
classpath Liste de chemins ou de noms de fichiers d'archive Java (JAR) qui, ensemble, spécifient l'emplacement des classes du fournisseur de ressources. Utilisez le point-virgule (;) pour séparer les chemins de classe.
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
isolatedClassLoader Si la valeur associée est true, indique que le fournisseur de ressource sera chargé dans son propre chargeur de classe.
Avertissement : Un fournisseur ne peut pas être isolatedClassLoader lorsque le chemin de la bibliothèque native est spécifié.
['isolatedClassLoader', 'false']
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple *.dll ou *.so. Séparez les entrées de chemin natif avec un point-virgule (;).
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
Tableau 22. Attributs facultatifs (suite). Plusieurs scripts comportent cet attribut.
Attributs Description
implementationClassName Indique la classe d'implémentation à utiliser par un modèle de fournisseur JDBC.
Attribut facultatif de type de fournisseur

Syntaxe

Utilisez la syntaxe de commande suivante pour rechercher le nom du type defournisseur JDBC. Seuls les ID de modèle de fournisseur JDBC qui contiennent la sous-chaîne templates/system|jdbc-resource-provider-templates.xml contiennent des noms de type de fournisseur JDBC valides. Le nom du type de fournisseur JDBC et sa sous-chaîne forment l'ID de modèle du fournisseur JDBC.
AdminConfig.listTemplates('JDBCProvider')
Exemple de résultat partiel montrant l'ID de modèle du fournisseur JDBC pour le nom de type de fournisseur JDBC de Derby JDBC Provider (XA) :
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Voici quelques ID de modèle de fournisseur 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)
Attribut implementationClassName

Syntaxe

Utilisez la syntaxe de commande suivante pour rechercher l'attribut implementationClassName en indiquant l'ID de modèle du fournisseur JDBC pour JDBCProvID :
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
Exemple de syntaxe de l'attribut implementationClassName :
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
Résultat :
com.ibm.db2.jcc.DB2XADataSource
Les noms d'implémentation possibles sont notamment :
  • 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

Syntaxe

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

Cas d'utilisation

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminJDBC.createJDBCProviderAtScope("myScope", "myJDBCProvider", "myDatabaseType","myProviderType", 
"myImplementationClass")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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”)

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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'] ])

Script createJDBCProviderUsingTemplateAtScope

Ce script utilise un modèle pour créer un fournisseur JDBC dans votre environment avec une portée que vous définissez. Le script renvoie l'ID configuration du nouveau fournisseur JDBC.

Pour exécuter le script, indiquez les arguments correspondant à la portée, à l'ID de modèle, au fournisseur JDBC et à la classe d'implémentation. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 23. Script createJDBCProviderUsingTemplateAtScope. Arguments obligatoires et facultatifs.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JDBC.
templateID Indique l'ID configuration du modèle à utiliser pour créer le fournisseur JDBC.
jdbcProvider Indique le nom à attribuer au nouveau fournisseur JDBC.
implementationClassName Indique le nom de la classe d'implémentation à utiliser.
attributes
Facultatif. Permet d'indiquer des attributs supplémentaires dans un format particulier.
Format liste
[["attr1", "value1"], ["attr2", "value2"]]
Format chaîne
"attr1=value1, attr2=value2"
Tableau 24. Attributs facultatifs. Plusieurs scripts comportent ces attributs.
Attributs Description Exemple
classpath Liste de chemins ou de noms de fichiers d'archive Java (JAR) qui, ensemble, spécifient l'emplacement des classes du fournisseur de ressources. Utilisez le point-virgule (;) pour séparer les chemins de classe.
['-classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;
${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
isolatedClassLoader Si la valeur associée est true, indique que le fournisseur de ressource sera chargé dans son propre chargeur de classe.
Avertissement : Un fournisseur ne peut pas être isolatedClassLoader lorsque le chemin de la bibliothèque native est spécifié.
['isolatedClassLoader', 'false']
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple *.dll ou *.so. Séparez les entrées de chemin natif avec un point-virgule (;).
['-nativepath', '${DB2_JCC_DRIVER_NATIVEPATH}']
Tableau 25. Attributs facultatifs (suite). Plusieurs scripts comportent ces attributs.
Attributs Description Exemple
propertySet Facultatif. Indique des propriétés de ressource au format suivant : [propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

Si vous utilisez cet attribut dans un script, utilisez le format liste. Le format chaîne ne fonctionne pas car cet attribut est un objet de configuration.

[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 Indique le type du fournisseur JDBC utilisé.
['providerType', 'DB2 Universal JDBC Driver Provider']
xa Les valeurs admises sont true et false. Si cet attribut a pour valeur true, les sources de données du fournissent génèrent des connexions que les applications utilisent dans les transactions globales de validation à deux phases. S'il a pour valeur false, les sources de données génèrent des connexions que les applications utilisent dans les transactions locales de validation à une seule phase.
true

false
Attribut facultatif de classe d'implémentation

Syntaxe

Utilisez la syntaxe de commande suivante pour rechercher l'attribut implementationClassName en indiquant l'ID de modèle du fournisseur JDBC pour JDBCProvID :
AdminConfig.showAttribute(JDBCProvID,'implementationClassName')
Exemple de syntaxe de l'attribut implementationClassName :
print AdminConfig.showAttribute("DB2 Universal JDBC Driver Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_DB2_UNI_2)",
"implementationClassName")
Résultat :
com.ibm.db2.jcc.DB2XADataSource
Les noms d'implémentation possibles sont notamment :
  • 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
Attribut facultatif de type de fournisseur

Syntaxe

Utilisez la syntaxe de commande suivante pour rechercher le nom du type defournisseur JDBC. Seuls les ID de modèle de fournisseur JDBC qui contiennent la sous-chaîne templates/system|jdbc-resource-provider-templates.xml contiennent des noms de type de fournisseur JDBC valides. Le nom du type de fournisseur JDBC et sa sous-chaîne forment l'ID de modèle du fournisseur JDBC.
AdminConfig.listTemplates('JDBCProvider')
Exemple de résultat partiel montrant l'ID de modèle du fournisseur JDBC pour le nom de type de fournisseur JDBC de Derby JDBC Provider (XA) :
Derby JDBC Provider (XA)
(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)
Voici quelques ID de modèle de fournisseur 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

Syntaxe

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

Cas d'utilisation

L'exemple de script suivant contient uniquement des attributs obligatoires :

AdminJDBC.createJDBCProviderUsingTemplateAtScope("myScope", "Derby JDBC 
 Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#JDBCProvider_1124467079638)", 
 "myJDBCProvider", "myImplementationClass") 
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
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 ") 

L'exemple de script suivant contient des attributs facultatifs fournis au format liste :

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]]]]]]])

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7adminjdbc
Nom du fichier : rxml_7adminjdbc.html