Scripts de configuration JMS

La bibliothèque de scripts propose de nombreuses procédures de script pour gérer les configurations JMS (Java™ Messaging Service). Consultez les informations sur l'utilisation des scripts qui interrogent les configurations JMS. 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 AdminJMS se trouve dans le répertoire racine_serveur_app/scriptLibraries/resources/JMS/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.
Utilisez les procédures de script suivantes pour configurer JMS dans votre environnement :

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

createGenericJMSConnectionFactory

Ce script crée une fabrique de connexions JMS dans votre configuration. Le script renvoie l'ID configuration de la nouvelle fabrique générique de connexions JMS dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, le nom de la nouvelle fabrique de connexions, le nom JNDI, ainsi que le nom JNDI externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 2. Arguments du script createGenericJMSConnectionFactory. Exécutez le script pour créer une fabrique de connexions JMS générique.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS.
connFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
extJndiName Indique le nom JNDI employé pour lier la file d'attente à l'espace de nom du serveur d'applications. Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource. Ce nom est utilisé pour lier les informations relatives à la liaison des plateformes. La liaison associe les ressources définies dans le descripteur de déploiement du module aux ressources réelles (physiques) liées sous JNDI par la plateforme.
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. Autres attributs disponibles pour le script.
Attributs Description Exemple
XAEnabled Spécifie si le traitement de la restauration XA est activée.
['XAEnabled', 'false']
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.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['authMechanismPreference', 
'BASIC_PASSWORD']
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 JMS applicables à l'instance de fabrique de connexions JMS 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']]]
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
diagnoseConnectionUsage Indique si le diagnostic de l'utilisation des connexions est activé.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'true']
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', 'true']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
sessionPool Indique les propriétés de regroupement des sessions JMS applicables à l'instance de connexion JMS 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.

["sessionPool\",
[["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"]]]
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). Autre attribut disponible pour le script.
Attributs Description Exemple
type Indique QUEUE pour les files d'attente, TOPIC pour les sujets et UNIFIED pour les files d'attente et les sujets.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['type', 'TOPIC']

Syntaxe

AdminJMS.createGenericJMSConnectionFactory(nodeName, 
 serverName, jmsProvider, connFactoryName, jndiName, 
 extJndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createGenericJMSConnectionFactory("myNode", "myServer", 
 "JMSTest", "JMSCFTest", "jmsjndi", "extjmsjndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createGenericJMSConnectionFactory("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", "XAEnabled=false, 
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
description='my JMS Connection Factory',
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true, 
providerType=myJMSProviderType, type=TOPIC, xaRecoveryAuthAlias=myCellManager01/a1")

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

AdminJMS.createGenericJMSConnectionFactory("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My Generic JMSConnection Factory", 
"JNDIName", "extJNDIName", [['XAEnabled', 'false'], ['authDataAlias', 'myAuthDataAlias'], 
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'], 
['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'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeCreationInterval', '10'], 
['surgeThreshold', '10'], ['testConnection', 'true'], ['testConnectionInterval', '10'], 
['unusedTimeout', '10000']]], ['description', 'My description'], 
['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'], 
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'], 
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig', 
[['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], 
['value', 50000]]]]]], ['providerType', 'myJMSProviderType'], ['sessionPool', 
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], 
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], 
['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], [
'unusedTimeout', '10000']]], ['type', 'TOPIC'], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

Script createGenericJMSConnectionFactoryUsingTemplate

Ce script crée une fabrique de connexions JMS générique dans votre configuration à partir d'un modèle. Le script renvoie l'ID configuration de la fabrique de connexions JMS créée avec un modèle dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, l'ID de modèle, le nom de la fabrique de connexions, le nom JNDI, ainsi que le nom JNDI externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 5. Arguments du script createGenericJMSConnectionFactoryUsingTemplate. Exécutez le script pour créer une fabrique de connexions JMS générique.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS.
templateID Indique l'ID configuration du modèle à utiliser.
connFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
extJndiName Indique le nom JNDI employé pour lier la file d'attente à l'espace de nom du serveur d'applications. Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource. Ce nom est utilisé pour lier les informations de liaison de la plateforme. La liaison associe les ressources définies dans le descripteur de déploiement du module aux ressources réelles (physiques) liées sous JNDI par la plateforme.
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. Autres attributs disponibles pour le script.
Attributs Description Exemple
XAEnabled Spécifie si le traitement de la restauration XA est activée.
['XAEnabled', 'false']
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.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['authMechanismPreference', 
'BASIC_PASSWORD']
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 JMS applicables à l'instance de fabrique de connexions JMS 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']]]
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
diagnoseConnectionUsage Indique si le diagnostic de l'utilisation des connexions est activé.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'true']
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', 'true']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
sessionPool Indique les propriétés de regroupement des sessions JMS applicables à l'instance de connexion JMS 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.

["sessionPool\",
[["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"]]]
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). Autre attribut disponible pour le script.
Attributs Description Exemple
type Indique QUEUE pour les files d'attente, TOPIC pour les sujets et UNIFIED pour les files d'attente et les sujets.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['type', 'TOPIC']

Syntaxe

AdminJMS.createGenericJMSConnectionFactoryUsingTemplate(nodeName, 
 serverName, jmsProvider, templateID, 
 connFactoryName, jndiName, extJndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createGenericJMSConnectionFactoryUsingTemplate("myNode", "myServer", 
 "JMSTest", "Generic QueueConnectionFactory for 
 Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"JMSCFTest", "jmsjndi", "extjmsjndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createGenericJMSConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Generic QueueConnectionFactory for Windows
(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName",  "XAEnabled=false, 
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
description='my JMS Connection Factory using template',
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true, 
providerType=myJMSProviderType, type=TOPIC, xaRecoveryAuthAlias=myCellManager01/a1")

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

AdminJMS.createGenericJMSConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Generic QueueConnectionFactory for Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['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'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeCreationInterval', '10'], 
['surgeThreshold', '10'], ['testConnection', 'true'], ['testConnectionInterval', '10'], 
['unusedTimeout', '10000']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myJMSProviderType'], ['sessionPool', [['agedTimeout', '100'], 
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['type', 'TOPIC'], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

Script createGenericJMSConnectionFactoryAtScope

Ce script crée une fabrique de connexions JMS dans votre configuration avec une portée que vous définissez. Le script renvoie l'ID configuration de la nouvelle fabrique générique de connexions JMS dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, le nom de la nouvelle fabrique de connexions, le nom JNDI, ainsi que le nom JNDI externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 8. Arguments du script createGenericJMSConnectionFactoryAtScope. Exécutez le script pour créer une fabrique de connexions JMS générique.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
jmsProvider Indique le nom du fournisseur JMS.
connFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
extJndiName Indique le nom JNDI employé pour lier la file d'attente à l'espace de nom du serveur d'applications. Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource. Ce nom est utilisé pour lier les informations de liaison de la plateforme. La liaison associe les ressources définies dans le descripteur de déploiement du module aux ressources réelles (physiques) liées sous JNDI par la plateforme.
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 9. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
XAEnabled Spécifie si le traitement de la restauration XA est activée.
['XAEnabled', 'false']
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.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['authMechanismPreference', 
'BASIC_PASSWORD']
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 JMS applicables à l'instance de fabrique de connexions JMS 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']]]
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
diagnoseConnectionUsage Indique si le diagnostic de l'utilisation des connexions est activé.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'true']
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', 'true']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
sessionPool Indique les propriétés de regroupement des sessions JMS applicables à l'instance de connexion JMS 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.

["sessionPool\",
[["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"]]]
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 10. Attributs facultatifs (suite). Autre attribut disponible pour le script.
Attributs Description Exemple
type Indique QUEUE pour les files d'attente, TOPIC pour les sujets et UNIFIED pour les files d'attente et les sujets.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['type', 'TOPIC']

Syntaxe

AdminJMS.createGenericJMSConnectionFactoryAtScope(scope, 
 jmsProvider, connFactoryName, jndiName, 
 extJndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createGenericJMSConnectionFactoryAtScope("myScope", "JMSTest", "JMSCFTest", "jmsjndi", 
"extjmsjndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createGenericJMSConnectionFactoryAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My Generic JMSConnection Factory", "JNDIName", "extJNDIName", 
"XAEnabled=false, authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, 
category=myCategory, diagnoseConnectionUsage=false, logMissingTransactionContext=true, 
description='my JMS Connection Factory at scope',
manageCachedHandles=true, providerType=myJMSProviderType, type=TOPIC, 
xaRecoveryAuthAlias=myCellManager01/a1")

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

AdminJMS.createGenericJMSConnectionFactoryAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My Generic JMSConnection Factory", "JNDIName", "extJNDIName", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['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'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], 
['retryLimit', '4']]], ['properties', [[['description', 'My description'], ['name', 'myName'], 
['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], 
[['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myJMSProviderType'], ['sessionPool', [['agedTimeout', '100'], 
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], 
['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['type', 'TOPIC'], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

Script createGenericJMSConnectionFactoryUsingTemplateAtScope

Ce script utilise un modèle pour créer une fabrique de connexions JMS dans votre configuration avec une portée que vous définissez. Le script renvoie l'ID configuration de la fabrique de connexions JMS créée avec un modèle dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, l'ID de modèle, le nom de la fabrique de connexions, le nom JNDI, ainsi que le nom JNDI externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 11. Arguments du script createGenericJMSConnectionFactoryUsingTemplateAtScope. Exécutez le script pour créer une fabrique de connexions JMS générique.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
jmsProvider Indique le nom du fournisseur JMS.
templateID Indique l'ID configuration du modèle à utiliser.
connFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
extJndiName Indique le nom JNDI employé pour lier la file d'attente à l'espace de nom du serveur d'applications. Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource. Ce nom est utilisé pour lier les informations relatives à la liaison des plateformes. La liaison associe les ressources définies dans le descripteur de déploiement du module aux ressources réelles (physiques) liées sous JNDI par la plateforme.
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. Autres attributs disponibles pour le script.
Attributs Description Exemple
XAEnabled Spécifie si le traitement de la restauration XA est activée.
['XAEnabled', 'false']
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.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['authMechanismPreference', 
'BASIC_PASSWORD']
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 JMS applicables à l'instance de fabrique de connexions JMS 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']]]
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
diagnoseConnectionUsage Indique si le diagnostic de l'utilisation des connexions est activé.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'true']
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', 'true']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
sessionPool Indique les propriétés de regroupement des sessions JMS applicables à l'instance de connexion JMS 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.

["sessionPool\",
[["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"]]]
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). Autre attribut disponible pour le script.
Attributs Description Exemple
type Indique QUEUE pour les files d'attente, TOPIC pour les sujets et UNIFIED pour les files d'attente et les sujets.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['type', 'TOPIC']

Syntaxe

AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope(scope, 
  jmsProvider, templateID, 
 connFactoryName, jndiName, extJndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope("myScope", 
 "JMSTest", "Generic QueueConnectionFactory for 
 Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"JMSCFTest", "jmsjndi", "extjmsjndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", 
"Generic QueueConnectionFactory for Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", "XAEnabled=false, 
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true, 
description='my JMS Connection Factory using a template and scope',
providerType=myJMSProviderType, type=TOPIC, xaRecoveryAuthAlias=myCellManager01/a1")

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

AdminJMS.createGenericJMSConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", 
"Generic QueueConnectionFactory for Windows(templates/system|JMS-resource-provider-templates.xml#GenericJMSConnectionFactory_1)", 
"My Generic JMSConnection Factory", "JNDIName", "extJNDIName", 
[['XAEnabled', 'false'], ['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['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'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], 
['surgeCreationInterval', '10'], ['surgeThreshold', '10'], ['testConnection', 'true'], 
['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], ['description', 'My description'], 
['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'], 
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'], 
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig', [['preTestConnection', 'true'], 
['retryInterval', '12343'], ['retryLimit', '4']]], ['properties', [[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myJMSProviderType'], 
['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], 
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'], ['validationExpression', ''], 
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], 
['surgeCreationInterval', '10'], ['surgeThreshold', '10'], ['testConnection', 'true'], 
['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], ['type', 'TOPIC'], 
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

Script createGenericJMSDestination

Ce script crée une destination JMS générique dans votre configuration. Le script renvoie l'ID de configuration de la nouvelle destination JMS créée dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, le nom de la destination JMS, le nom JNDI, ainsi que le nom JNDI externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 14. Arguments du script createGenericJMSDestination. Exécutez le script pour créer une destination JMS générique.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS.
genericJMSDestination Indique le nom à attribuer à la nouvelle destination JMS générique.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
extJndiName Indique le nom JNDI employé pour lier la file d'attente à l'espace de nom du serveur d'applications. Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource. Ce nom est utilisé pour lier les informations de liaison de la plateforme. La liaison associe les ressources définies dans le descripteur de déploiement du module aux ressources réelles (physiques) liées sous JNDI par la plateforme.
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. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
type Indique QUEUE pour les files d'attente, TOPIC pour les sujets et UNIFIED pour les files d'attente et les sujets.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['type', 'QUEUE']

Syntaxe

AdminJMS.createGenericJMSDestination(nodeName, 
 serverName, jmsProvider, genericJMSDestination, 
 jndiName, extJndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createGenericJMSDestination("myNode", "myServer", "JMSTest", 
 "JMSDest", "destjndi", "extDestJndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createGenericJMSDestination("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My JMSDestination", "JNDIName", "extJNDIName", "category=myCategory, description='My description', 
providerType=myProviderType, type=QUEUE")

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

AdminJMS.createGenericJMSDestination("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'], ['description', 
'My description'], ['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['type', 'QUEUE']] )

Script createGenericJMSDestinationUsingTemplate

Ce script crée une destination JMS générique dans votre configuration à partir d'un modèle. Le script renvoie l'ID de configuration de la nouvelle destination JMS créée dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, l'ID de modèle, le nom de la destination générique JMS, le nom JNDI, ainsi que le nom JNDI externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :

Tableau 16. Arguments du script createGenericJMSDestinationUsingTemplate. Exécutez le script pour créer une destination JMS générique.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS.
templateID Indique l'ID configuration du modèle à utiliser.
genericJMSDestination Indique le nom à attribuer à la nouvelle destination JMS générique.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
extJndiName Indique le nom JNDI employé pour lier la file d'attente à l'espace de nom du serveur d'applications. Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource. Ce nom est utilisé pour lier les informations de liaison de la plateforme. La liaison associe les ressources définies dans le descripteur de déploiement du module aux ressources réelles (physiques) liées sous JNDI par la plateforme.
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 17. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
type Indique QUEUE pour les files d'attente, TOPIC pour les sujets et UNIFIED pour les files d'attente et les sujets.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['type', 'QUEUE']

Syntaxe

AdminJMS.createGenericJMSDestinationUsingTemplate(nodeName, 
 serverName, jmsProvider, templateID, 
 genericJMSDestination, jndiName, extJndiName, 
 attributes)

Exemple de syntaxe

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

AdminJMS.createGenericJMSDestinationUsingTemplate("myNode", "myServer", 
 "JMSTest", 
 "Example.JMS.Generic.Win.Topic(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_2)", 
 "JMSDest", "destjndi", "extDestJndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createGenericJMSDestinationUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example.JMS.Generic.Win.Queue(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)", 
"My JMSDestination", "JNDIName", "extJNDIName","category=myCategory, description='My description', 
providerType=myProviderType, type=QUEUE ")

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

AdminJMS.createGenericJMSDestinationUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example.JMS.Generic.Win.Queue(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)", 
"My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'], 
['description', 'My description'], ['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value','localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['type', 'QUEUE']] )

Script createGenericJMSDestinationAtScope

Ce script crée une destination générique JMS dans votre configuration avec une portée que vous définissez. Le script renvoie l'ID de configuration de la nouvelle destination JMS créée dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, le nom de la destination JMS, le nom JNDI, ainsi que le nom JNDI externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 18. Arguments du script createGenericJMSDestinationAtScope. Exécutez le script pour créer une destination JMS générique.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS.
genericJMSDestination Indique le nom à attribuer à la nouvelle destination JMS générique.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
extJndiName Indique le nom JNDI employé pour lier la file d'attente à l'espace de nom du serveur d'applications. Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource. Ce nom est utilisé pour lier les informations de liaison de la plateforme. La liaison associe les ressources définies dans le descripteur de déploiement du module aux ressources réelles (physiques) liées sous JNDI par la plateforme.
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 19. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
type Indique QUEUE pour les files d'attente, TOPIC pour les sujets et UNIFIED pour les files d'attente et les sujets.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['type', 'QUEUE']

Syntaxe

AdminJMS.createGenericJMSDestinationAtScope(scope, 
 jmsProvider, genericJMSDestination, 
 jndiName, extJndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createGenericJMSDestinationAtScope("myScope", "JMSTest", 
 "JMSDest", "destjndi", "extDestJndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createGenericJMSDestinationAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My JMSDestination", "JNDIName", "extJNDIName", "category=myCategory, 
description='My description', providerType=myProviderType, type=QUEUE")

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

AdminJMS.createGenericJMSDestinationAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'], 
['description', 'My description'], ['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value',50000]]]]]], ['providerType', 'myProviderType'], ['type', 'QUEUE']] )

Script createGenericJMSDestinationUsingTemplateAtScope

Ce script utilise un modèle pour créer une destination générique JMS dans votre configuration avec une portée que vous définissez. Le script renvoie l'ID de configuration de la nouvelle destination JMS créée dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, l'ID de modèle, la destination générique JMS, le nom JNDI, ainsi que le nom JNDI externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :

Tableau 20. Arguments du script createGenericJMSDestinationUsingTemplateAtScope. Exécutez le script pour créer une destination JMS générique.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS.
templateID Indique l'ID configuration du modèle à utiliser.
genericJMSDestination Indique le nom à attribuer à la nouvelle destination JMS générique.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
extJndiName Indique le nom JNDI employé pour lier la file d'attente à l'espace de nom du serveur d'applications. Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource. Ce nom est utilisé pour lier les informations de liaison de la plateforme. La liaison associe les ressources définies dans le descripteur de déploiement du module aux ressources réelles (physiques) liées sous JNDI par la plateforme.
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. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
type Indique QUEUE pour les files d'attente, TOPIC pour les sujets et UNIFIED pour les files d'attente et les sujets.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['type', 'QUEUE']

Syntaxe

AdminJMS.createGenericJMSDestinationUsingTemplateAtScope(scope, 
 jmsProvider, templateID, 
 genericJMSDestination, jndiName, extJndiName, 
 attributes)

Exemple de syntaxe

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

AdminJMS.createGenericJMSDestinationUsingTemplateAtScope("myScope", 
 "JMSTest", 
 "Example.JMS.Generic.Win.Topic(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_2)", 
 "JMSDest", "destjndi", "extDestJndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createGenericJMSDestinationUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example.JMS.Generic.Win.Queue
(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)", 
"My JMSDestination", "JNDIName", "extJNDIName", "category=myCategory, 
description='My description', providerType=myProviderType, type=QUEUE")

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

AdminJMS.createGenericJMSDestinationUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example.JMS.Generic.Win.Queue
(templates/system|JMS-resource-provider-templates.xml#GenericJMSDestination_1)", 
"My JMSDestination", "JNDIName", "extJNDIName", [['category', 'myCategory'], ['description', 'My description'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['type', 'QUEUE']] )

Script createJMSProvider

Ce script crée un fournisseur JMS dans votre configuration. Le script renvoie l'ID de configuration du fournisseur JMS créé dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, le nom de la fabrique contextuelle initiale externe, ainsi que l'adresse URL du fournisseur externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :

Tableau 22. Arguments du script createJMSProvider. Exécutez le script pour créer un fournisseur JMS.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom à attribuer au nouveau fournisseur JMS.
extContextFactory Indique le nom de la classe Java de la fabrique de contexte initiale du fournisseur JMS.
extProviderURL Spécifie l'URL du fournisseur JMS pour les recherches JNDI externes.
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 23. Attributs facultatifs. Autres attributs disponibles pour le script.
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', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description Fournit une description du fournisseur JMS.
['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 : Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
['isolatedClassLoader', 'true']
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple, *.dll et *.so. Séparez les entrées de chemin natif avec un point-virgule (;).
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
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 de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
supportsASF Si la valeur associée est true, indique que le fournisseur JMS prend en charge la fonction Application Server Facilities (ASF) qui permet aux applications d'utiliser des opérations transactionnelles et simultanées.
['supportsASF', 'true']

Syntaxe

AdminJMS.createJMSProvider(nodeName, serverName, 
 jmsProvider, extContextFactory, extProviderURL, 
 attributes)

Exemple de syntaxe

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

AdminJMS.createJMSProvider("myNode", "myServer", "JMSTest1", 
 "extInitCF", "extPURL")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createJMSProvider("IBM-F4A849C57A0Node01", "server1", "MyJMSProvider", "extInitCF", "extPURL", 
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar', 
description='My JMSProvider description',isolatedClassLoader=true, 
nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}, providerType=myJMSProviderType, supportsASF=true")

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

AdminJMS.createJMSProvider("IBM-F4A849C57A0Node01", "server1", "MyJMSProvider", "extInitCF", "extPURL", 
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], ['description', 'My JMSProvider description'], 
['isolatedClassLoader', 'true'], ['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myJMSProviderType'], 
['supportsASF', 'true']] )

Script createJMSProviderUsingTemplate

Ce script crée un fournisseur JMS dans votre configuration à partir d'un modèle. Le script renvoie l'ID de configuration du fournisseur JMS créé avec un modèle dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, l'ID de configuration du modèle de fournisseur JMS, le nom à attribuer au nouveau fournisseur JMS, le nom de la fabrique contextuelle initiale externe, ainsi que l'URL du fournisseur externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :

Tableau 24. Arguments du script createJMSProviderUsingTemplate. Exécutez le script pour créer un fournisseur JMS.
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 de fournisseur JMS à utiliser.
jmsProvider Indique le nom à attribuer au nouveau fournisseur JMS.
extContextFactory Indique le nom de la classe Java de la fabrique de contexte initiale du fournisseur JMS.
extProviderURL Spécifie l'URL du fournisseur JMS pour les recherches JNDI externes.
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 25. Attributs facultatifs. Autres attributs disponibles pour le script.
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', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description Fournit une description du fournisseur JMS.
['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 : Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
['isolatedClassLoader', 'true']
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple, *.dll et *.so. Séparez les entrées de chemin natif avec un point-virgule (;).
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
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 de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
supportsASF Si la valeur associée est true, indique que le fournisseur JMS prend en charge la fonction Application Server Facilities (ASF) qui permet aux applications d'utiliser des opérations transactionnelles et simultanées.
['supportsASF', 'true']

Syntaxe

AdminJMS.createJMSProviderUsingTemplate(nodeName, 
 serverName, templateID, jmsProvider, 
 extContextFactory, extProviderURL, attributes)

Exemple de syntaxe

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

AdminJMS.createJMSProviderUsingTemplate("myNode", "myServer", "WebSphere JMS 
 Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#builtin_jmsprovider)", 
 "JMSTest", "extInitCF", "extPURL")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createJMSProviderUsingTemplate("IBM-F4A849C57A0Node01", "server1", 
"WebSphere JMSProvider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)", 
"MyJMSProvider", "extInitCF", "extPURL", 
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar', description='My JMSProvider description', 
isolatedClassLoader=true, nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}, 
providerType=myJMSProviderType,supportsASF=true")
L'exemple de script suivant contient des attributs facultatifs fournis au format liste :
AdminJMS.createJMSProviderUsingTemplate("IBM-F4A849C57A0Node01", "server1", 
"WebSphere JMSProvider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)", 
"MyJMSProvider", "extInitCF", "extPURL", 
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], 
['description', 'My JMSProvider description'], ['isolatedClassLoader', 'true'], 
['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], 
[['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myJMSProviderType'], ['supportsASF', 'true']])

Script createJMSProviderAtScope

Ce script crée un fournisseur JMS dans votre configuration avec une portée que vous définissez. Le script renvoie l'ID de configuration du fournisseur JMS créé dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, le nom de la fabrique contextuelle initiale externe, ainsi que l'adresse URL du fournisseur externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :

Tableau 26. Arguments du script createJMSProviderAtScope. Exécutez le script pour créer un fournisseur JMS.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
jmsProvider Indique le nom à attribuer au nouveau fournisseur JMS.
extContextFactory Indique le nom de la classe Java de la fabrique de contexte initiale du fournisseur JMS.
extProviderURL Spécifie l'URL du fournisseur JMS pour les recherches JNDI externes.
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 27. Attributs facultatifs. Autres attributs disponibles pour le script.
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', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description Fournit une description du fournisseur JMS.
['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 : Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
['isolatedClassLoader', 'true']
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple, *.dll et *.so. Séparez les entrées de chemin natif avec un point-virgule (;).
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
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 de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
supportsASF Si la valeur associée est true, indique que le fournisseur JMS prend en charge la fonction Application Server Facilities (ASF) qui permet aux applications d'utiliser des opérations transactionnelles et simultanées.
['supportsASF', 'true']

Syntaxe

AdminJMS.createJMSProviderAtScope(scope, 
 jmsProvider, extContextFactory, extProviderURL, 
 attributes)

Exemple de syntaxe

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

AdminJMS.createJMSProvider("myScope", "JMSTest1", 
 "extInitCF", "extPURL")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS. createJMSProviderAtScope ("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"MyJMSProvider", "extInitCF", "extPURL", 
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar', description='My JMSProvider description', 
isolatedClassLoader=true, nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}, 
providerType=myJMSProviderType,supportsASF=true")

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

AdminJMS.createJMSProviderAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"MyJMSProvider", "extInitCF", "extPURL", [['classpath', 
'${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar;
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], ['description', 'My JMSProvider description'], 
['isolatedClassLoader', 'true'], ['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myJMSProviderType'], 
['supportsASF', 'true']] )

Script createJMSProviderUsingTemplateAtScope

Ce script utilise un modèle pour créer un fournisseur JMS avec une portée que vous définissez. Le script renvoie l'ID de configuration du fournisseur JMS créé avec un modèle dans la cellule concernée.

Pour exécuter le script, indiquez la portée, l'ID de configuration du modèle de fournisseur JMS, le nom à attribuer au nouveau fournisseur JMS, le nom de la fabrique contextuelle initiale externe, ainsi que l'URL du fournisseur externe comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :

Tableau 28. Arguments du script createJMSProviderUsingTemplateAtScope. Exécutez le script pour créer un fournisseur JMS.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
templateID Indique l'ID configuration du modèle de fournisseur JMS à utiliser.
jmsProvider Indique le nom à attribuer au nouveau fournisseur JMS.
extContextFactory Indique le nom de la classe Java de la fabrique de contexte initiale du fournisseur JMS.
extProviderURL Spécifie l'URL du fournisseur JMS pour les recherches JNDI externes.
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 29. Attributs facultatifs. Autres attributs disponibles pour le script.
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', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description Fournit une description du fournisseur JMS.
['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 : Vous ne pouvez pas isoler un fournisseur si vous spécifiez un chemin de bibliothèque native.
['isolatedClassLoader', 'true']
nativepath Spécifie un chemin d'accès facultatif aux bibliothèques natives, par exemple, *.dll et *.so. Séparez les entrées de chemin natif avec un point-virgule (;).
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
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 de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
supportsASF Si la valeur associée est true, indique que le fournisseur JMS prend en charge la fonction Application Server Facilities (ASF) qui permet aux applications d'utiliser des opérations transactionnelles et simultanées.
['supportsASF', 'true']

Syntaxe

AdminJMS.createJMSProviderUsingTemplateAtScope(scope, 
 templateID, jmsProvider, 
 extContextFactory, extProviderURL, attributes)

Exemple de syntaxe

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

AdminJMS.createJMSProviderUsingTemplateAtScope("myScope", "WebSphere JMS 
 Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#builtin_jmsprovider)", 
 "JMSTest", "extInitCF", "extPURL")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS. Script createJMSProviderUsingTemplateAtScope 
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"WebSphere JMSProvider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)", 
"MyJMSProvider", "extInitCF", "extPURL", 
"classpath='${DB2_JCC_DRIVER_PATH}/db2jcc4.jar;${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar', description='My JMSProvider description', 
isolatedClassLoader=true, nativepath=${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}, 
providerType=myJMSProviderType,supportsASF=true")
L'exemple de script suivant contient des attributs facultatifs fournis au format liste :
AdminJMS.createJMSProviderUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01, Node=IBM-F4A849C57A0Node01", 
"WebSphere JMS Provider(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jmsprovider)", 
"MyJMSProvider", "extInitCF", "extPURL", 
[['classpath', '${DB2_JCC_DRIVER_PATH}/db2jcc4.jar; ${UNIVERSAL_JDBC_DRIVER}/db2jcc_license_cu.jar; 
${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar'], ['description', 'My JMSProvider description'], 
['isolatedClassLoader', 'true'], ['nativepath', '${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value',50000]]]]]], ['providerType', 'myJMSProviderType'], 
['supportsASF', 'true']] )

Script createWASQueue

Ce script crée une file d'attente WebSphere Application Server dans votre configuration. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration de la file d'attente WebSphere Application Server créée dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, le nom à attribuer à la file d'attente, ainsi que le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :

Tableau 30. Arguments du script createWASQueue. Exécutez le script pour créer une file d'attente.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
queueName Indique le nom à attribuer à la nouvelle file d'attente.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
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 31. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
expiry Indique le délai au-delà duquel les messages sont envoyés à cette destination et pris en charge en fonction de leurs options de traitement. Les valeurs possibles sont APPLICATION_DEFINE, SPECIFIED et UNLIMITED.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['expiry', 'SPECIFIED']
persistence Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et SPECIFIED.
['priority', 'SPECIFIED']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
specifiedExpiry Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés.
['specifiedExpiry', '1000']
specifiedPriority Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9.
['specifiedPriority', '0']

Syntaxe

AdminJMS.createWASQueue(nodeName, serverName, 
 jmsProvider, queueName, jndiName, 
 attributes)

Exemple de syntaxe

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

AdminJMS.createWASQueue("myNode", "myServer", "JMSTest", 
 "WASQueueTest", "queuejndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASQueue("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", 
"My WASQueue Name", "JNDIName", "category =myCategory, description='My description', 
expiry=SPECIFIED, persistence=NONPERSISTENT, priority=SPECIFIED, specifiedExpiry=1000, 
specifiedPriority=0")

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

AdminJMS.createWASQueue("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", "My WASQueue Name", 
"JNDIName", [['category ', 'myCategory'], ['description', 'My description'], ['expiry', 'SPECIFIED'], 
['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

Script createWASQueueUsingTemplate

Ce script crée une file d'attente WebSphere Application Server dans votre configuration à partir d'un modèle. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration de la file d'attente WebSphere Application Server créée avec un modèle dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, l'ID de configuration du modèle, le nom à attribuer à la file d'attente, ainsi que le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 32. Arguments du script createWASQueueUsingTemplate. Exécutez le script pour créer une file d'attente.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
templateID Indique l'ID configuration du modèle de file d'attente WebSphere Application Server à utiliser.
queueName Indique le nom à attribuer à la nouvelle file d'attente.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
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 33. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
expiry Indique le délai au-delà duquel les messages sont envoyés à cette destination et pris en charge en fonction de leurs options de traitement. Les valeurs possibles sont APPLICATION_DEFINE, SPECIFIED et UNLIMITED.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['expiry', 'SPECIFIED']
persistence Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et SPECIFIED.
['priority', 'SPECIFIED']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
specifiedExpiry Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés.
['specifiedExpiry', '1000']
specifiedPriority Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9.
['specifiedPriority', '0']

Syntaxe

AdminJMS.createWASQueueUsingTemplate(nodeName, 
 serverName, jmsProvider, templateID, queueName, 
 jndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createWASQueueUsingTemplate("myNode", "myServer", "JMSTest", 
 "WASQueueTest", "queuejndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASQueueUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", "My WASQueue Name", 
"JNDIName", “category =myCategory, description='My description', expiry=SPECIFIED, 
providerType=myProviderType, specifiedExpiry=1000, specifiedPriority=0”)

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

Usage: AdminJMS.createWASQueueUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", "My WASQueue Name", 
"JNDIName", [['category ', 'myCategory'], ['description', 'My description'], ['expiry', 'SPECIFIED'], 
['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

Script createWASQueueAtScope

Ce script crée une file d'attente WebSphere Application Server dans votre configuration avec une portée que vous définissez. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration de la file d'attente WebSphere Application Server créée dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, le nom à attribuer à la file d'attente, ainsi que le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :

Tableau 34. Arguments du script createWASQueueAtScope. Exécutez le script pour créer une file d'attente.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
queueName Indique le nom à attribuer à la nouvelle file d'attente.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
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 35. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
expiry Indique le délai au-delà duquel les messages sont envoyés à cette destination et pris en charge en fonction de leurs options de traitement. Les valeurs possibles sont APPLICATION_DEFINE, SPECIFIED et UNLIMITED.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['expiry', 'SPECIFIED']
persistence Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et SPECIFIED.
['priority', 'SPECIFIED']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
specifiedExpiry Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés.
['specifiedExpiry', '1000']
specifiedPriority Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9.
['specifiedPriority', '0']

Syntaxe

AdminJMS.createWASQueueAtScope(scope, 
 jmsProvider, queueName, jndiName, 
 attributes)

Exemple de syntaxe

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

AdminJMS.createWASQueueAtScope("scope", "JMSTest", 
 "WASQueueTest", "queuejndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASQueueAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", “category =myCategory, description='My description', 
expiry=SPECIFIED, providerType=myProviderType, specifiedExpiry=1000, specifiedPriority=0”)

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

AdminJMS.createWASQueueAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", [['category ', 'myCategory'], ['description', 'My description'], 
['expiry', 'SPECIFIED'], ['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], [
'providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

Script createWASQueueUsingTemplateAtScope

Ce script utilise un modèle pour créer une file d'attente WebSphere Application Server dans votre configuration avec une portée que vous définissez. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration de la file d'attente WebSphere Application Server créée avec un modèle dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, l'ID de configuration du modèle, le nom à attribuer à la file d'attente, ainsi que le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 36. Arguments du script createWASQueueUsingTemplateAtScope. Exécutez le script pour créer une file d'attente.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
templateID Indique l'ID configuration du modèle de file d'attente WebSphere Application Server à utiliser.
queueName Indique le nom à attribuer à la nouvelle file d'attente.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
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 37. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
expiry Indique le délai au-delà duquel les messages sont envoyés à cette destination et pris en charge en fonction de leurs options de traitement. Les valeurs possibles sont APPLICATION_DEFINE, SPECIFIED et UNLIMITED.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['expiry', 'SPECIFIED']
persistence Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et SPECIFIED.
['priority', 'SPECIFIED']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
specifiedExpiry Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés.
['specifiedExpiry', '1000']
specifiedPriority Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9.
['specifiedPriority', '0']

Syntaxe

AdminJMS.createWASQueueUsingTemplateAtScope(scope, 
 jmsProvider, templateID, queueName, 
 jndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createWASQueueUsingTemplateAtScope("myScope", "JMSTest", 
 "WASQueueTest", "queuejndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASQueueUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", 
"My WASQueue Name", "JNDIName", "category =myCategory, description='My description', expiry=SPECIFIED, 
providerType=myProviderType, specifiedExpiry=1000, specifiedPriority=0")

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

AdminJMS.createWASQueueUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example.JMS.WAS.Q1(templates/system|JMS-resource-provider-templates.xml#WASQueue_1)", 
"My WASQueue Name", "JNDIName", [['category ', 'myCategory'], ['description', 'My description'], ['expiry', 'SPECIFIED'], 
['persistence', 'NONPERSISTENT'], ['priority', 'SPECIFIED'], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

createSIBJMSQueue

Ce script crée une file d'attente JMS dans votre configuration avec une portée que vous définissez. Le script renvoie l'ID configuration de la file d'attente JMS SIB créée.

Pour exécuter le script, indiquez la portée, le nom de file d'attente JMS, le nom à attribuer à la file d'attente, ainsi que le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 38. Arguments du script createSIBJMSQueue. Exécutez le script pour créer une file d'attente JMS.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
nom Indique le nom de la file d'attente JMS qui vous intéresse.
queueName Indique le nom de la destination du bus d'intégration de services vers laquelle la file d'attente JMS est mappée.
jndiName Indique le nom JNDI utilisé par le système pour lier la file d'attente à l'espace de nom du serveur d'applications.
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 39. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
description Indique une description de la file d'attente JMS SIB.
DeliveryMode Indique le mode de distribution des messages. Les valeurs admises sont Application, NonPersistent et Persistent.
timeToLive Indique le délai en millisecondes avant l'expiration d'un message.
priority Indique la priorité des messages. Les valeurs admises sont des entiers compris entre 0 et 9 inclus.
readAhead Indique la valeur de lecture anticipée. Les valeurs admises sont Default, AlwaysOn et AlwaysOff.
busName Indique le nom du bus sur lequel se trouve la file d'attente.
ScopeToLocalQP Indique si la destination de file d'attente SIB est sectorisée sur un point de file d'attente locale lorsqu'elle est adressée à l'aide de cette file d'attente JMS.
ProducerBind Indique la façon dont les fournisseurs JMS se connectent aux points de la file d'attente de cluster. Une valeur de TRUE indique qu'un point de file d'attente doit être sélectionné lorsque la session est ouverte et ne doit jamais changer. Une valeur de FALSE indique qu'un point de file d'attente est sélectionné à chaque envoi de message.
ProducerPreferLocal Indique si les points de file d'attente locale du fournisseur sont utilisés.
GatherMessages Indique si les consommateurs et les navigateurs JMS reçoivent des messages à partir de n'importe quel point de file d'attente plutôt que du point de file d'attente unique auquel ils sont connectés.

Syntaxe

AdminJMS.createSIBJMSQueue(scope, 
 name, queueName, 
 jndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createSIBJMSQueue("myScope", "myName", 
 "SIBJMSQueueTest", "queuejndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createSIBJMSQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName7", "myQueueName7", "readAhead=AlwaysOff,timeToLive=9")

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

AdminJMS.createSIBJMSQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName7", "myQueueName7", [['readAhead', 'AlwaysOff'], ['timeToLive', '9']])

createWMQQueue

This script creates queue type destination for the IBM MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created IBM MQ queue.

Pour exécuter le script, indiquez la portée, le nom de la destination de type file d'attente, le nom à attribuer à la file d'attente, ainsi que le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 40. Arguments du script createWMQQueue. Exécutez le script pour créer une destination de type file d'attente.
Argument Description
scope Specifies a scope of cell, node, server, or cluster for the IBM MQ messaging provider.
nom Specifies the name of the IBM MQ messaging provider queue type destination.
queueName Specifies the name of the IBM MQ queue to store messages for the queue type destination definition of the IBM MQ messaging provider.
jndiName Indique le nom utilisé pour lier cet objet à l'interface JNDI WebSphere Application Server.
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 41. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
ccsid Indique l'ID de jeu de caractères codés.
decimalEncoding Indique le paramètre de codage décimal pour cette file d'attente. Les valeurs admises sont Normal et Inversé.
description Specifies an administrative description to associate with this IBM MQ JMS queue type destination.
expiry Indique le délai au-delà duquel les messages envoyés à cette destination arrivent à expiration et sont pris en charge en fonction de leurs options de traitement. Les valeurs admises sont APP, UNLIM ou tout entier positif.
floatingPointEncoding Indique le paramètre de codage en virgule flottante pour cette file d'attente. Les valeurs admises sont IEEENormal, IEEEReversed et z/OS.
integerEncoding Indique le paramètre de codage d'entiers pour cette file d'attente. Les valeurs admises sont Normal et Inversé.
persistence Indique le niveau de persistance utilisé pour stocker les messages envoyés à cette destination. Les valeurs admises sont APP, QDEF, PERS, NON ou HIGH.
priority Indique le niveau de priorité à affecter aux messages envoyés à cette destination. Les valeurs admises sont APP, QDEF, 0, 1, 2, 3, 4, 5, 6, 7, 8 ou 9.
qmgr Specifies the queue manager on which the IBM MQ queue resides.
readAheadClose Indique le comportement obtenu lorsque le système ferme un destinataire de messages qui reçoit des messages en mode asynchrone. Le destinataire de messages utilise un module d'écoute de message d'une destination dont le paramètre readAhead a pour valeur true. Lorsque la valeur DELIVERALL est indiquée, l'appel de méthode de fermeture attend que tous les messages soumis à une lecture anticipée soient distribués au destinataire avant la fermeture de ce dernier. Lorsque la valeur DELIVERCURRENT est indiquée, la méthode close() attend uniquement la fin de la distribution en cours avant la fermeture du destinataire. Les valeurs admises sont DELIVERALL et DELIVERCURRENT.
readAhead Indique si les messages des destinataires non persistants peuvent être lus en mode anticipée et mis en cache. Les valeurs admises sont YES, NO ou QDEF.
sendAsync Indique si les messages peuvent être envoyés à cette destination sans qu'il soit nécessaire que le gestionnaire de files d'attente en accuse réception. Les valeurs admises sont YES, NO ou QDEF.
useRFH2 Indique si un en-tête RFH version 2 est ajouté aux messages envoyés à cette destination. Les valeurs admises sont true ou false.
useNativeEncoding Indique les paramètres de codage natif de cette file d'attente.

Syntaxe

AdminJMS.createWMQQueue(scope, 
 name, queueName, 
 jndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createWMQQueue("myScope", "myName", 
 "WMQQueueTest", "queuejndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWMQQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName8", "myQueueName8", "readAhead=YES,description=myDescription")

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

AdminJMS.createWMQQueue
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName8", "myQueueName8", [['readAhead', 'YES'], ['description', 'myDescription']])

Script createWASQueueConnectionFactory

Ce script crée une fabrique de connexions de file d'attente WebSphere Application Server dans votre configuration. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration de la fabrique de connexions de file d'attente WebSphere Application Server créée dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, le nom à attribuer à la fabrique de connexions de file d'attente, ainsi que le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :

Tableau 42. Arguments du script createWASQueueConnectionFactory. Exécutez le script pour créer une fabrique de connexions de file d'attente.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
queueConnFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions de file d'attente WebSphere Application Server.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
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 43. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
XAEnabled Spécifie si le traitement de la restauration XA est activée.
['XAEnabled', 'false']
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.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['authMechanismPreference', 
'BASIC_PASSWORD']
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 JMS applicables à l'instance de fabrique de connexions JMS 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']]]
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
diagnoseConnectionUsage Indique si le diagnostic de l'utilisation des connexions est activé.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'true']
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', 'true']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
sessionPool Indique les propriétés de regroupement des sessions JMS applicables à l'instance de connexion JMS 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.

["sessionPool\",
[["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"]]]
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']

Syntaxe

AdminJMS.createWASQueueConnectionFactory(nodeName, 
 serverName, jmsProvider, queueConnFactoryName, 
 jndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createWASQueueConnectionFactory("myNode", "myServer", 
 "JMSTest", "queueCFTest", "queuejndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASQueueConnectionFactory("IBM-F4A849C57A0Node01", "server1", 
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", “XAEnabled=false, 
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD,  category=myCategory, 
description='My description', diagnoseConnectionUsage=false, logMissingTransactionContext=true, 
manageCachedHandles=true, providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")

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

AdminJMS.createWASQueueConnectionFactory("IBM-F4A849C57A0Node01", "server1", 
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['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'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]], 
['xaRecoveryAuthAlias', 'myCellManager01/a1']] ))

Script createWASQueueConnectionFactoryUsingTemplate

Ce script crée une fabrique de connexions de file d'attente WebSphere Application Server dans votre configuration à partir d'un modèle. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration de la fabrique de connexions de file d'attente WebSphere Application Server créée avec un modèle dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, l'ID configuration du modèle, le nom à attribuer à la fabrique de connexions de file d'attente, ainsi que le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 44. Arguments du script createWASQueueConnectionFactoryUsingTemplate. Exécutez le script pour créer une fabrique de connexions de file d'attente.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
templateID Indique l'ID configuration du modèle de fabrique de connexions de file d'attente WebSphere Application Server à utiliser.
queueConnFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions de file d'attente WebSphere Application Server.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
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 45. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
XAEnabled Spécifie si le traitement de la restauration XA est activée.
['XAEnabled', 'false']
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.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['authMechanismPreference', 
'BASIC_PASSWORD']
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 JMS applicables à l'instance de fabrique de connexions JMS 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']]]
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
diagnoseConnectionUsage Indique si le diagnostic de l'utilisation des connexions est activé.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'true']
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', 'true']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
sessionPool Indique les propriétés de regroupement des sessions JMS applicables à l'instance de connexion JMS 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.

["sessionPool\",
[["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"]]]
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']

Syntaxe

AdminJMS.createWASQueueConnectionFactoryUsingTemplate(nodeName, 
 serverName, jmsProvider, templateID, 
 queueConnFactoryName, jndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createWASQueueConnectionFactoryUsingTemplate("myNode", "myServer", 
 "JMSTest", "Example WAS 
 QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
 "queueCFTest", "queuecfjndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASQueueConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example WAS QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
"My WASQueue Name", "JNDIName", “XAEnabled=false, authDataAlias=myAuthDataAlias, 
authMechanismPreference=BASIC_PASSWORD,  category=myCategory, description='My description', 
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true, 
providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")

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

AdminJMS.createWASQueueConnectionFactoryUsingTemplate("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"Example WAS QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
"My WASQueue Name", "JNDIName", [['XAEnabled', 'false'],['authDataAlias', 'myAuthDataAlias'], 
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'], ['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'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'],['surgeCreationInterval', '10'], ['surgeThreshold', '10'], 
['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]], 
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

Script createWASQueueConnectionFactoryAtScope

Ce script crée une fabrique de connexions de file d'attente WebSphere Application Server dans votre configuration avec une portée que vous définissez. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration de la fabrique de connexions de file d'attente WebSphere Application Server créée dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, le nom à attribuer à la fabrique de connexions de file d'attente ainsi que le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :

Tableau 46. Arguments du script createWASQueueConnectionFactoryAtScope. Exécutez le script pour créer une fabrique de connexions de file d'attente.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
queueConnFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions de file d'attente WebSphere Application Server.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
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 47. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
XAEnabled Spécifie si le traitement de la restauration XA est activée.
['XAEnabled', 'false']
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.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['authMechanismPreference', 
'BASIC_PASSWORD']
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 JMS applicables à l'instance de fabrique de connexions JMS 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']]]
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
diagnoseConnectionUsage Indique si le diagnostic de l'utilisation des connexions est activé.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'true']
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', 'true']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
sessionPool Indique les propriétés de regroupement des sessions JMS applicables à l'instance de connexion JMS 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.

["sessionPool\",
[["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"]]]
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']

Syntaxe

AdminJMS.createWASQueueConnectionFactoryAtScope(scope, 
 jmsProvider, queueConnFactoryName, 
 jndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createWASQueueConnectionFactoryAtScope("myScope", 
 "JMSTest", "queueCFTest", "queuejndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASQueueConnectionFactoryAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", “XAEnabled=false, authDataAlias=myAuthDataAlias, 
authMechanismPreference=BASIC_PASSWORD,  category=myCategory, description='My description', diagnoseConnectionUsage=false, 
logMissingTransactionContext=true, manageCachedHandles=true, providerType=myProviderType,
 xaRecoveryAuthAlias=myCellManager01/a1")

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

AdminJMS.createWASQueueConnectionFactoryAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASQueue Name", "JNDIName", [['XAEnabled', 'false'], ['authDataAlias', 'myAuthDataAlias'], 
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'], ['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'], ['validationExpression', ' '], 
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeCreationInterval', '10'], 
['surgeThreshold', '10'], ['testConnection', 'true'], ['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], 
['description', 'My description'], ['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'], 
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'], 
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig', [['preTestConnection', 'true'], 
['retryInterval', '12343'], 
['retryLimit', '4']]], ['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], ['sessionPool', 
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], 
['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'], ['name', 'myName'], 
['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], 
['surgeThreshold', '10'], ['testConnection', 'true']]], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

Script createWASQueueConnectionFactoryUsingTemplateAtScope

Ce script utilise un modèle pour créer une fabrique de connexions de file d'attente WebSphere Application Server dans votre configuration avec une portée que vous définissez. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration de la fabrique de connexions de file d'attente WebSphere Application Server créée avec un modèle dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, l'ID de configuration du modèle, le nom à attribuer à la fabrique de connexions de file d'attente ainsi que le nom JNDI comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 48. Arguments du script createWASQueueConnectionFactoryUsingTemplateAtScope. Exécutez le script pour créer une fabrique de connexions de file d'attente.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
templateID Indique l'ID configuration du modèle de fabrique de connexions de file d'attente WebSphere Application Server à utiliser.
queueConnFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions de file d'attente WebSphere Application Server.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
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 49. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
XAEnabled Spécifie si le traitement de la restauration XA est activée.
['XAEnabled', 'false']
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.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['authMechanismPreference', 
'BASIC_PASSWORD']
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 JMS applicables à l'instance de fabrique de connexions JMS 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']]]
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
diagnoseConnectionUsage Indique si le diagnostic de l'utilisation des connexions est activé.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'true']
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', 'true']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
sessionPool Indique les propriétés de regroupement des sessions JMS applicables à l'instance de connexion JMS 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.

["sessionPool\",
[["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"]]]
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']

Syntaxe

AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope(scope, 
 jmsProvider, templateID, 
 queueConnFactoryName, jndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope("myScope",
 "JMSTest", "Example WAS 
 QueueConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
 "queueCFTest", "queuecfjndi")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example WAS QueueConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
"My WASQueue Name", "JNDIName", “XAEnabled=false, authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD,  
category=myCategory, description='My description', diagnoseConnectionUsage=false, logMissingTransactionContext=true, 
manageCachedHandles=true, providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")

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

AdminJMS.createWASQueueConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example WAS QueueConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASQueueConnectionFactory_1)", 
"My WASQueue Name", "JNDIName", [['XAEnabled', 'false'],['authDataAlias', 'myAuthDataAlias'], 
['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['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'], ['validationExpression', ''], ['value', 'myValue']]]],
 ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeCreationInterval', '10'], ['surgeThreshold', '10'], ['testConnection', 'true'], 
['testConnectionInterval', '10'], ['unusedTimeout', '10000']]], ['description', 'My description'],
 ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], 
['mappingConfigAlias', 'mappingConfigAliasValue']]], ['preTestConfig', [['preTestConnection', 'true'], 
['retryInterval', '12343'], 
['retryLimit', '4']]], ['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', [[['name', 'databaseName'], 
['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], 
['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], ['sessionPool', 
[['agedTimeout', '100'], 
['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], 
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'],
 ['testConnection', 'true']]], 
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

Script createWASTopic

Ce script crée un sujet WebSphere Application Server dans votre configuration JMS. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration du sujet WebSphere Application Server créé dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, le nom à attribuer au sujet, le nom JNDI, ainsi que le sujet comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 50. Arguments du script createWASTopic. Exécutez le script pour créer un sujet.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
topicName Indique le nom à attribuer au nouveau sujet.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
topic Indique (sous la forme d'un qualificatif dans l'espace de sujet) le nom du sujet à 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 51. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
expiry Indique le délai au-delà duquel les messages sont envoyés à cette destination et pris en charge en fonction de leurs options de traitement. Les valeurs possibles sont APPLICATION_DEFINE, SPECIFIED et UNLIMITED.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['expiry', 'SPECIFIED']
persistence Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et SPECIFIED.
['priority', 'SPECIFIED']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
specifiedExpiry Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés.
['specifiedExpiry', '1000']
specifiedPriority Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9.
['specifiedPriority', '0']

Syntaxe

AdminJMS.createWASTopic(nodeName, serverName, 
 jmsProvider, topicName, jndiName, topic, 
 attributes)

Exemple de syntaxe

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

AdminJMS.createWASTopic("myNode", "myServer", "JMSTest", 
 "TopicTest", "topicjndi", "mytopic")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My WASTopic", "JNDIName", "A WAS Topic",” category=myCategory, description='My description', 
expiry=SPECIFIED, persistence=PERSISTENT, priority=APPLICATION_DEFINED")

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

AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", "My WASTopic", 
"JNDIName", "A WAS Topic", [['category', 'myCategory'], ['description', 'My description'], 
['expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], 
['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

Script createWASTopicUsingTemplate

Ce script crée un sujet WebSphere Application Server dans votre configuration JMS à partir d'un modèle. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration du sujet WebSphere créé dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, l'ID configuration du modèle, le nom à attribuer au sujet, le nom JNDI, ainsi que le sujet comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 52. Arguments du script createWASTopicUsingTemplate. Exécutez le script pour créer un sujet.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
templateID Indique l'ID configuration du modèle de sujet WebSphere Application Server à utiliser.
topicName Indique le nom à attribuer au nouveau sujet.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
topic Indique (sous la forme d'un qualificatif dans l'espace de sujet) le nom du sujet à 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 53. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
expiry Indique le délai au-delà duquel les messages sont envoyés à cette destination et pris en charge en fonction de leurs options de traitement. Les valeurs possibles sont APPLICATION_DEFINE, SPECIFIED et UNLIMITED.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['expiry', 'SPECIFIED']
persistence Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et SPECIFIED.
['priority', 'SPECIFIED']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
specifiedExpiry Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés.
['specifiedExpiry', '1000']
specifiedPriority Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9.
['specifiedPriority', '0']

Syntaxe

AdminJMS.createWASTopicUsingTemplate(nodeName, 
 serverName, jmsProvider, templateID, topicName, 
 jndiName, topic, attributes)

Exemple de syntaxe

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

AdminJMS.createWASTopicUsingTemplate("myNode", "myServer", "JMSTest", 
 "Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)", 
"TopicTest", 
 "topicjndi", "mytopic")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My WASTopic", "JNDIName", "A WAS Topic",” category=myCategory, description='My description', 
expiry=SPECIFIED, persistence=PERSISTENT, priority=APPLICATION_DEFINED”)
L'exemple de script suivant contient des attributs facultatifs fournis au format liste :
AdminJMS.createWASTopic("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", "My WASTopic", 
"JNDIName", "A WAS Topic", [['category', 'myCategory'], ['description', 'My description'], [
'expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'], 
['propertySet', [['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], 
['value', 'myDbName']], [['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], 
[['name', 'serverName'], ['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], 
['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

Script createWASTopicAtScope

Ce script crée un sujet WebSphere Application Server dans votre configuration JMS avec une portée que vous définissez. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration du sujet WebSphere Application Server créé dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, le nom à attribuer au sujet, le nom JNDI, ainsi que le sujet comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 54. Arguments du script createWASTopicAtScope. Exécutez le script pour créer un sujet.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
topicName Indique le nom à attribuer au nouveau sujet.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
topic Indique (sous la forme d'un qualificatif dans l'espace de sujet) le nom du sujet à 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 55. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
expiry Indique le délai au-delà duquel les messages sont envoyés à cette destination et pris en charge en fonction de leurs options de traitement. Les valeurs possibles sont APPLICATION_DEFINE, SPECIFIED et UNLIMITED.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['expiry', 'SPECIFIED']
persistence Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et SPECIFIED.
['priority', 'SPECIFIED']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
specifiedExpiry Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés.
['specifiedExpiry', '1000']
specifiedPriority Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9.
['specifiedPriority', '0']

Syntaxe

AdminJMS.createWASTopicAtScope(scope, 
 jmsProvider, topicName, jndiName, topic, 
 attributes)

Exemple de syntaxe

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

AdminJMS.createWASTopic("myScope", "JMSTest", 
 "TopicTest", "topicjndi", "mytopic")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASTopicAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASTopic", "JNDIName", "A WAS Topic", ” category=myCategory, description='My description', 
expiry=SPECIFIED, persistence=PERSISTENT, priority=APPLICATION_DEFINED”)

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

AdminJMS.createWASTopicAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASTopic", "JNDIName", "A WAS Topic", [['category', 'myCategory'], 
['description', 'My description'], 
['expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

Script createWASTopicUsingTemplateAtScope

Ce script utilise un modèle pour créer un sujet WebSphere Application Server dans votre configuration JMS avec une portée que vous définissez. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration du sujet WebSphere créé dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, l'ID configuration du modèle, le nom à attribuer au sujet, le nom JNDI, ainsi que le sujet comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 56. Arguments du script createWASTopicUsingTemplateAtScope. Exécutez le script pour créer un sujet.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
jmsProvider Indique le nom du fournisseur JMS qui vous intéresse.
templateID Indique l'ID configuration du modèle de sujet WebSphere Application Server à utiliser.
topicName Indique le nom à attribuer au nouveau sujet.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
topic Indique (sous la forme d'un qualificatif dans l'espace de sujet) le nom du sujet à 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 57. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource.
['category', 'myCategory']
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
expiry Indique le délai au-delà duquel les messages sont envoyés à cette destination et pris en charge en fonction de leurs options de traitement. Les valeurs possibles sont APPLICATION_DEFINE, SPECIFIED et UNLIMITED.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['expiry', 'SPECIFIED']
persistence Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT.
['persistence', 'NONPERSISTENT']
priority Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et SPECIFIED.
['priority', 'SPECIFIED']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myProviderType']
specifiedExpiry Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés.
['specifiedExpiry', '1000']
specifiedPriority Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9.
['specifiedPriority', '0']

Syntaxe

AdminJMS.createWASTopicUsingTemplateAtScope(scope, 
 jmsProvider, templateID, topicName, 
 jndiName, topic, attributes)

Exemple de syntaxe

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

AdminJMS.createWASTopicUsingTemplateAtScope("myScope", "JMSTest", 
 "Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)", 
"TopicTest", 
 "topicjndi", "mytopic")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASTopicUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)", 
"My WASTopic", "JNDIName", "A WAS Topic", ” category=myCategory, description='My description', expiry=SPECIFIED, 
persistence=PERSISTENT, priority=APPLICATION_DEFINED”)
L'exemple de script suivant contient des attributs facultatifs fournis au format liste :
AdminJMS.createWASTopicUsingTemplateAtScope("Cell=IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "Example.JMS.WAS.T1(templates/system|JMS-resource-provider-templates.xml#WASTopic_1)", 
"My WASTopic", "JNDIName", "A WAS Topic", [['category', 'myCategory'], ['description', 'My description'], 
['expiry', 'SPECIFIED'], ['persistence', 'PERSISTENT'], ['priority', 'APPLICATION_DEFINED'], ['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['specifiedExpiry', '1000'], ['specifiedPriority', '0']] )

createSIBJMSTopic

Ce script crée un sujet JMS pour le fournisseur de messagerie par défaut avec une portée que vous définissez. Le script renvoie l'ID configuration du sujet JMS SIB créé.

Pour exécuter le script, indiquez la portée, le nom à attribuer au sujet, ainsi que le nom JNDI. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 58. Arguments du script createSIBJMSTopic. Exécutez le script pour créer un sujet JMS.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie par défaut.
nom Indique le nom à attribuer au nouveau sujet.
jndiName Indique le nom JNDI utilisé par le système pour lier cet objet à l'interface JNDI WebSphere Application Server.
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 59. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
description Indique une description du sujet JMS SIB.
espace de sujet Indique le nom de l'espace de sujet SIB sous-jacent vers lequel pointe le sujet.
topicName Indique le sujet utilisé dans l'espace de sujet, par exemple, stock/IBM.
deliveryMode Indique le mode de distribution des messages. Les valeurs admises sont Application, Non persistant, et Persistant.
timeToLive Indique le délai d'expiration des messages, en millisecondes.
priority Indique le niveau de priorité à affecter aux messages envoyés à cette destination. Les valeurs admises sont 0, 1, 2, 3, 4, 5, 6, 7, 8 ou 9.
readAhead Indique la valeur de lecture anticipée. Les valeurs admises sont AsConnection, AlwaysOn et AlwaysOff.
busName Nom du bus sur lequel se trouve le sujet.

Syntaxe

AdminJMS.createSIBJMSTopic(scope, 
 name, 
 jndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createSIBJMSTopic("myScope", "myName", "myJNDIName")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createSIBJMSTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" , 
"myJndiName9", "readAhead=AlwaysOff,timeToLive=6")
L'exemple de script suivant contient des attributs facultatifs fournis au format liste :
AdminJMS.createSIBJMSTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" , 
"myJndiName9", [['readAhead', 'AlwaysOff'], ['timeToLive', '6']])

createWMQTopic

This script creates a JMS topic destination for the IBM MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created IBM MQ topic.

Pour exécuter le script, indiquez la portée, le nom à attribuer au sujet, ainsi que le nom JNDI. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 60. Arguments du script createWMQTopic. Exécutez le script pour créer une destination de sujet JMS.
Argument Description
scope Specifies a scope of cell, node, server, or cluster for the IBM MQ messaging provider.
nom Indique le nom à attribuer au nouveau sujet.
jndiName Indique le nom JNDI utilisé par le système pour lier cet objet à l'interface JNDI WebSphere Application Server.
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 61. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
brokerCCDurSubQueue Indique le nom de la file d'attente à partir de laquelle un destinataire de connexion reçoit des messages d'abonnement durables.
brokerDurSubQueue Indique le nom de la file d'attente à partir de laquelle un destinataire de connexion reçoit des messages d'abonnement non durables.
brokerPubQmgr Indique le nom du gestionnaire de files d'attente sur lequel le courtier s'exécute.
brokerPubQueue Indique le nom de la file d'attente à laquelle des messages de publication sont envoyés.
brokerVersion Indique le niveau de fonctionnalité requis pour les opérations de publication et d'abonnement.
ccsid Indique l'ID de jeu de caractères codés.
decimalEncoding Indique le paramètre de codage décimal pour ce sujet. Les valeurs admises sont Normal et Inversé.
description Specifies an administrative description to associate with this IBM MQ JMS topic type destination.
expiry Indique le délai au-delà duquel les messages envoyés à cette destination arrivent à expiration et sont pris en charge en fonction de leurs options de traitement. Les valeurs admises sont APP, UNLIM ou tout entier positif.
floatingPointEncoding Indique le paramètre de codage en virgule flottante pour ce sujet. Les valeurs admises sont IEEENormal, IEEEReversed et z/OS.
integerEncoding Indique le paramètre de codage d'entiers pour cet sujet. Les valeurs admises sont Normal et Inversé.
persistence Indique le niveau de persistance utilisé pour stocker les messages envoyés à cette destination. Les valeurs admises sont APP, TDEF, PERS, NON ou HIGH.
priority Indique le niveau de priorité à affecter aux messages envoyés à cette destination. Les valeurs admises sont APP, TDEF, 0, 1, 2, 3, 4, 5, 6, 7, 8 ou 9.
readAheadClose Indique le comportement obtenu lorsque le système ferme un destinataire de messages qui reçoit des messages en mode asynchrone. Le destinataire de messages utilise un module d'écoute de message d'une destination dont le paramètre readAhead a pour valeur true. Lorsque la valeur DELIVERALL est indiquée, l'appel de méthode de fermeture attend que tous les messages soumis à une lecture anticipée soient distribués au destinataire avant la fermeture de ce dernier. Lorsque la valeur DELIVERCURRENT est indiquée, la méthode close() attend uniquement la fin de la distribution en cours avant la fermeture du destinataire. Les valeurs admises sont DELIVERALL et DELIVERCURRENT.
readAhead Indique si les messages des destinataires non persistants peuvent être lus en mode anticipée et mis en cache. Les valeurs admises sont YES, NO ou TDEF.
sendAsync Indique si les messages peuvent être envoyés à cette destination sans qu'il soit nécessaire que le gestionnaire de files d'attente en accuse réception. Les valeurs admises sont YES, NO ou TDEF.
useRFH2 Indique si un en-tête RFH version 2 est ajouté aux messages envoyés à cette destination. Les valeurs admises sont true ou false.
useNativeEncoding Indique les paramètres de codage natif de ce sujet.
wildcardFormat Indique les jeux de caractères qui doivent être interprétés comme caractères génériques dans les sujets.

Syntaxe

AdminJMS.createWMQTopic(scope, 
 name, 
 jndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createWMQTopic("myScope", "myName", "myJNDIName")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWMQTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName10", "myTopicName10", "readAhead=YES,sendAsync=NO")
L'exemple de script suivant contient des attributs facultatifs fournis au format liste :
AdminJMS.createWMQTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName10", "myTopicName10", [['readAhead', 'YES'], ['sendAsync', 'NO']])

createWASTopicConnectionFactory

Ce script crée une fabrique de connexions de sujet WebSphere Application Server dans votre configuration. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration de la fabrique de connexions de sujet WebSphere Application Server créée dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, le nom à attribuer à la fabrique de connexions, le nom JNDI, ainsi que le port comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 62. Arguments du script createWASTopicConnectionFactory. Exécutez le script pour créer une fabrique de connexions de sujet.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProviderName Indique le nom du fournisseur JMS qui vous intéresse.
topicConnFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
port Indiquez le port qui vous intéresse.
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 63. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
XAEnabled Spécifie si le traitement de la restauration XA est activée.
['XAEnabled', 'false']
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.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['authMechanismPreference', 
'BASIC_PASSWORD']
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 JMS applicables à l'instance de fabrique de connexions JMS 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']]]
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
diagnoseConnectionUsage Indique si le diagnostic de l'utilisation des connexions est activé.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'true']
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', 'true']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
sessionPool Indique les propriétés de regroupement des sessions JMS applicables à l'instance de connexion JMS 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.

["sessionPool\",
[["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"]]]
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 64. Attributs facultatifs (suite). Autres attributs disponibles pour le script.
Attributs Description Exemple
ICclient Indique l'ID du client.
['clientID', 'myClientID']
cloneSupport Indique si la fabrique de connexions de sujet WebSphere est prise en charge entre des clones.
['cloneSupport', 'true']

Syntaxe

AdminJMS.createWASTopicConnectionFactory(nodeName, 
 serverName, jmsProviderName, topicConnFactoryName, 
 jndiName, port, attributes)

Exemple de syntaxe

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

AdminJMS.createWASTopicConnectionFactory("myNode", "myServer", 
 "JMSTest", "TopicCFTest", "topiccfjndi", "DIRECT")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASTopicConnectionFactory("IBM-F4A849C57A0Node01", "server1", 
"My JMS Provider Name1", "My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false, 
authDataAlias=myAuthDataAlias, authMechanismPreference=BASIC_PASSWORD, category=myCategory, 
clientID=myClientID, cloneSupport=true, description='My description', diagnoseConnectionUsage=false, 
logMissingTransactionContext=true, manageCachedHandles=true, providerType=myProviderType, 
xaRecoveryAuthAlias=myCellManager01/a1")

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

AdminJMS.createWASTopicConnectionFactory("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"My WASTopicConnectionFactory", "JNDIName", "DIRECT", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['clientID', 'myClientID'], ['cloneSupport', 'true'], 
['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'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'], 
['testConnection', 'true']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'java.lang.String'], ['value', 'localhost']], [['name', 'portNumber'], 
['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], ['sessionPool', 
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], 
['maxConnections', '12'], ['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]], 
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

Script createWASTopicConnectionFactoryUsingTemplate

Ce script crée une fabrique de connexions de sujet WebSphere Application Server dans votre configuration à partir d'un modèle. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration du sujet WebSphere créé avec un modèle dans la cellule concernée.

Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, l'ID configuration du modèle, le nom à attribuer à fabrique de connexions, le nom JNDI, ainsi que le port comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 65. Arguments du script createWASTopicConnectionFactoryUsingTemplate. Exécutez le script pour créer une fabrique de connexions de sujet.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.
jmsProviderName Indique le nom du fournisseur JMS qui vous intéresse.
templateID Indique l'ID configuration de la fabrique de connexions de sujet WebSphere Application Server à utiliser.
topicConnFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
port Indique le port qui vous intéresse.
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 66. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
XAEnabled Spécifie si le traitement de la restauration XA est activée.
['XAEnabled', 'false']
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.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['authMechanismPreference', 
'BASIC_PASSWORD']
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 JMS applicables à l'instance de fabrique de connexions JMS 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']]]
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
diagnoseConnectionUsage Indique si le diagnostic de l'utilisation des connexions est activé.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'true']
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', 'true']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
sessionPool Indique les propriétés de regroupement des sessions JMS applicables à l'instance de connexion JMS 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.

["sessionPool\",
[["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"]]]
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 67. Attributs facultatifs (suite). Autre attribut disponible pour le script.
Attributs Description Exemple
type Indique QUEUE pour les files d'attente, TOPIC pour les sujets et UNIFIED pour les files d'attente et les sujets.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['type', 'TOPIC']

Syntaxe

AdminJMS.createWASTopicConnectionFactoryUsingTemplate(nodeName, 
 serverName, jmsProviderName, templateID, 
 topicConnFactoryName, jndiName,  port, attributes)

Exemple de syntaxe

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

AdminJMS.createWASTopicConnectionFactoryUsingTemplate("myNode", "myServer", 
 "JMSTest", "First Example WAS 
 TopicConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
 "TopicCFTest", "topiccfjndi", "DIRECT")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASTopicConnectionFactoryUsingTemplate
("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
"My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false, authDataAlias=myAuthDataAlias, 
authMechanismPreference=BASIC_PASSWORD, category=myCategory, clientID=myClientID, cloneSupport=true, 
description='My description', diagnoseConnectionUsage=false, logMissingTransactionContext=true, 
manageCachedHandles=true, providerType=myProviderType, xaRecoveryAuthAlias=myCellManager01/a1")

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

AdminJMS.createWASTopicConnectionFactoryUsingTemplate
("IBM-F4A849C57A0Node01", "server1", "My JMS Provider Name1", 
"First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
"My WASTopicConnectionFactory", "JNDIName", "'DIRECT'", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference', 'BASIC_PASSWORD'], 
['category', 'myCategory'], ['clientID', 'myClientID'], ['cloneSupport', 'true'], 
['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'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'], 
['testConnection', 'true']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], ['manageCachedHandles', 'true'], ['mapping', 
[['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'], 
['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', [['resourceProperties', 
[[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], [['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], ['properties', [[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'], 
['testConnection', 'true']]], ['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

Script createWASTopicConnectionFactoryAtScope

Ce script crée une fabrique de connexions de sujet WebSphere Application Server dans votre configuration avec une portée que vous définissez. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration de la fabrique de connexions de sujet WebSphere Application Server créée dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, le nom à attribuer à la fabrique de connexions, le nom JNDI, ainsi que le port comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 68. Arguments du script createWASTopicConnectionFactoryAtScope. Exécutez le script pour créer une fabrique de connexions de sujet.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
jmsProviderName Indique le nom du fournisseur JMS qui vous intéresse.
topicConnFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
port Indiquez le port qui vous intéresse.
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 69. Attributs facultatifs (suite). Autre attribut disponible pour le script.
Attributs Description Exemple
type Indique QUEUE pour les files d'attente, TOPIC pour les sujets et UNIFIED pour les files d'attente et les sujets.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['type', 'TOPIC']

Syntaxe

AdminJMS.createWASTopicConnectionFactoryAtScope(scope, 
 jmsProviderName, topicConnFactoryName, 
 jndiName, port, attributes)

Exemple de syntaxe

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

AdminJMS.createWASTopicConnectionFactoryAtScope("myScope", 
 "JMSTest", "TopicCFTest", "topiccfjndi", "DIRECT")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASTopicConnectionFactoryAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false, 
authDataAlias=myAuthDataAlias, 
authMechanismPreference=BASIC_PASSWORD, category=myCategory, clientID=myClientID, cloneSupport=true, 
description='My description', 
diagnoseConnectionUsage=false, logMissingTransactionContext=true, manageCachedHandles=true, 
providerType=myProviderType, 
xaRecoveryAuthAlias=myCellManager01/a1")

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

AdminJMS.createWASTopicConnectionFactoryAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "My WASTopicConnectionFactory", "JNDIName", "'DIRECT'", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], ['authMechanismPreference','BASIC_PASSWORD'], ['category', 'myCategory'], 
['clientID', 'myClientID'], ['cloneSupport', 'true'], ['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'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]], 
['description', 'My description'], 
['diagnoseConnectionUsage', 'false'], ['logMissingTransactionContext', 'true'], 
['manageCachedHandles', 'true'], 
['mapping', [['authDataAlias', 'authDataAliasValue'], ['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', 
[['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]], ['properties', 
[[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], ['propertySet', 
[['resourceProperties', [[['name','databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], ['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], 
['type', 'java.lang.String'], 
['value', 'localhost']], [['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], 
['providerType', 'myProviderType'], ['sessionPool', [['agedTimeout', '100'], ['connectionTimeout', '1000'], 
['freePoolDistributionTableSize', 10], ['maxConnections', '12'], ['minConnections', '5'], 
['numberOfFreePoolPartitions', '3'], 
['numberOfSharedPoolPartitions', '6'], ['numberOfUnsharedPoolPartitions', '3'], ['properties', 
[[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeThreshold', '10'], ['testConnection', 'true']]], 
['xaRecoveryAuthAlias','myCellManager01/a1']] )

Script createWASTopicConnectionFactoryUsingTemplateAtScope

Ce script utilise un modèle pour créer une fabrique de connexions de sujet WebSphere Application Server dans votre configuration avec une portée que vous définissez. N'utilisez les ressources JMS que pour les applications qui effectuent des opérations de messagerie avec un serveur JMS intégré à WebSphere Application Server version 5.1 dans une cellule 7.0. Le script renvoie l'ID de configuration du sujet WebSphere créé avec un modèle dans la cellule concernée.

Pour exécuter le script, indiquez la portée, le nom de fournisseur JMS, l'ID configuration du modèle, le nom à attribuer à la fabrique de connexions, le nom JNDI, ainsi que le port comme arguments. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 70. Arguments du script createWASTopicConnectionFactoryUsingTemplateAtScope. Exécutez le script pour créer une fabrique de connexions de sujet.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
jmsProviderName Indique le nom du fournisseur JMS qui vous intéresse.
templateID Indique l'ID configuration de la fabrique de connexions de sujet WebSphere Application Server à utiliser.
topicConnFactoryName Indique le nom à attribuer à la nouvelle fabrique de connexions.
jndiName Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
port Indique le port qui vous intéresse.
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 71. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description Exemple
XAEnabled Spécifie si le traitement de la restauration XA est activée.
['XAEnabled', 'false']
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.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['authMechanismPreference', 
'BASIC_PASSWORD']
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 JMS applicables à l'instance de fabrique de connexions JMS 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']]]
description Fournit une description de l'adaptateur de ressource.
['description', 'My description']
diagnoseConnectionUsage Indique si le diagnostic de l'utilisation des connexions est activé.
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
['logMissingTransactionContext', 'true']
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', 'true']
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]] ]]]]
provider Indique la classe d'implémentation du pilote JDBC pour accéder à une base de données du fournisseur. Pour créer un pool de connexions à cette base de données, associez une source de données au fournisseur JMS.
['provider', 'myJMSProvider']
providerType Indique le type de fournisseur JMS de ce fournisseur JMS.
['providerType', 'myJMSProviderType']
sessionPool Indique les propriétés de regroupement des sessions JMS applicables à l'instance de connexion JMS 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.

["sessionPool\",
[["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"]]]
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 72. Attributs facultatifs (suite). Autre attribut disponible pour le script.
Attributs Description Exemple
type Indique QUEUE pour les files d'attente, TOPIC pour les sujets et UNIFIED pour les files d'attente et les sujets.

Ne placez pas les valeurs entre guillemets pour le format chaîne de la commande.

['type', 'TOPIC']

Syntaxe

AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope(scope, 
 jmsProviderName, templateID, 
 topicConnFactoryName, jndiName,  port, attributes)

Exemple de syntaxe

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

AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope("myScope", 
 "JMSTest", "First Example WAS 
 TopicConnectionFactory(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
 "TopicCFTest", "topiccfjndi", "DIRECT")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
"My WASTopicConnectionFactory", "JNDIName", "DIRECT", “XAEnabled=false, authDataAlias=myAuthDataAlias,
 authMechanismPreference=BASIC_PASSWORD, 
category=myCategory, clientID=myClientID, cloneSupport=true, description='My description',
 diagnoseConnectionUsage=false, 
logMissingTransactionContext=true, manageCachedHandles=true, providerType=myProviderType, 
xaRecoveryAuthAlias=myCellManager01/a1”)

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

AdminJMS.createWASTopicConnectionFactoryUsingTemplateAtScope
("Cell= IBM-F4A849C57A0Cell01,Node=IBM-F4A849C57A0Node01,Server=server1", 
"My JMS Provider Name1", "First Example WAS TopicConnectionFactory
(templates/system|JMS-resource-provider-templates.xml#WASTopicConnectionFactory_1)", 
"My WASTopicConnectionFactory", "JNDIName", "'DIRECT'", [['XAEnabled', 'false'], 
['authDataAlias', 'myAuthDataAlias'], 
['authMechanismPreference', 'BASIC_PASSWORD'], ['category', 'myCategory'], ['clientID', 'myClientID'], 
['cloneSupport', 'true'], 
['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'], 
['validationExpression', ''], ['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], 
['reapTime', '10000'], ['surgeThreshold', '10'], 
['testConnection', 'true']]], ['description', 'My description'], ['diagnoseConnectionUsage', 'false'], 
['logMissingTransactionContext', 'true'], 
['manageCachedHandles', 'true'], ['mapping', [['authDataAlias', 'authDataAliasValue'], 
['mappingConfigAlias', 'mappingConfigAliasValue']]], 
['preTestConfig', [['preTestConnection', 'true'], ['retryInterval', '12343'], ['retryLimit', '4']]],
 ['properties', [[['description', 'My description'], 
['name', 'myName'], ['required', 'false'], ['validationExpression', ''], ['value', 'myValue']]]], 
['propertySet', 
[['resourceProperties', [[['name', 'databaseName'], ['type', 'java.lang.String'], ['value', 'myDbName']], 
[['name', 'driverType'], 
['type', 'java.lang.Integer'], ['value', 4]], [['name', 'serverName'], ['type', 'java.lang.String'], 
['value', 'localhost']], 
[['name', 'portNumber'], ['type', 'java.lang.Integer'], ['value', 50000]]]]]], ['providerType', 'myProviderType'], 
['sessionPool', 
[['agedTimeout', '100'], ['connectionTimeout', '1000'], ['freePoolDistributionTableSize', 10], 
['maxConnections', '12'], 
['minConnections', '5'], ['numberOfFreePoolPartitions', '3'], ['numberOfSharedPoolPartitions', '6'], 
['numberOfUnsharedPoolPartitions', '3'], 
['properties', [[['description', 'My description'], ['name', 'myName'], ['required', 'false'],
 ['validationExpression', ''], 
['value', 'myValue']]]], ['purgePolicy', 'EntirePool'], ['reapTime', '10000'], ['surgeThreshold', '10'],
 ['testConnection', 'true']]], 
['xaRecoveryAuthAlias', 'myCellManager01/a1']] )

createSIBJMSConnectionFactory

Ce script crée une fabrique de connexions JMS SIB pour le fournisseur de messagerie par défaut avec une portée que vous définissez. Le script renvoie l'ID configuration de la fabrique de connexions JMS SIB créée.

Pour exécuter le script, indiquez les arguments correspondants à la portée, au nom, au nom JNDI et au nom de bus. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 73. Arguments du script createSIBJMSConnectionFactory. Exécutez le script pour créer une fabrique de connexions JMS.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
nom Indique le nom administratif affecté à cette fabrique de connexions.
jndiName Indique le nom JNDI spécifié dans les liaisons des beans gérés par message associés à cette fabrique de connexions.
busName Indique le nom du bus d'intégration de services avec lequel les connexions sont établies.
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 74. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
authDataAlias Indique un ID utilisateur et un mot de passe à utiliser pour authentifier les connexions au fournisseur JMS pour l'authentification gérée par l'application.
containerAuthAlias Indique un alias d'authentification gérée par composant à partir duquel les données d'identification de sécurité sont utilisées pour établir une connexion au fournisseur JMS.
mappingAlias Indique l'alias de mappage JAAS (Java Authentication and Authorization Service) à utiliser lors de la détermination des données d'identification liées à la sécurité. Les données d'identification liées à la sécurité sont utilisées lors de l'établissement d'une connexion au fournisseur JMS.
xaRecoveryAuthAlias Indique l'alias d'authentification utilisé lors du traitement de la reprise XA.
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou regrouper la fabrique de connexions.
description Fournit une description de la fabrique de connexions.
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
manageCachedHandles Indique si les descripteurs placés en cache, qui sont des descripteurs conservés dans les variables d'instance d'un bean, doivent être surveillés par le conteneur.
ICclient Indique l'ID client qui est requis uniquement pour les abonnements durables.
userName Indique le nom d'utilisateur qui sert à créer des connexions à partir de la fabrique de connexions.
mot_de_passe Indique le mot de passe qui sert à créer des connexions à partir de la fabrique de connexions.
nonPersistentMapping Indique une valeur de mappage non persistant. Les valeurs admises sont BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination et None.
persistentMapping Indique une valeur de mappage persistant. Les valeurs admises sont BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination et None.
durableSubscriptionHome Indique la valeur de l'interface home des abonnements durables.
readAhead Indique la valeur de lecture anticipée. Les valeurs admises sont Default, AlwaysOn et AlwaysOff.
target Indique le nom d'une cible qui se convertit en groupe de moteurs de messagerie.
targetType Indique le type du nom dans le paramètre cible. Les valeurs admises sont BusMember, Custom et ME.
targetSignificance Indique l'importance du groupe cible. Les valeurs admises sont Préférée et Requise.
targetTransportChain Indique le nom du protocole qui permet la connexion à un moteur de messagerie éloigné.
providerEndPoints Indique une liste de triplets de noeuds finaux séparés par des virgules au format hôte:port:chaîne.
connectionProximity Indique la proximité des moteurs de messagerie acceptables. Les valeurs admises sont Bus, Hôte, Cluster et Serveur.
tempQueueNamePrefix Indique un préfixe de nom de file d'attente temporaire.
tempTopicNamePrefix Indique un préfixe de nom de sujet temporaire.
shareDataSourceWithCMP Indique comment contrôler les sources de données partagées.
shareDurableSubscriptions Indique comment contrôler les abonnements durables partagés. Les valeurs admises sont InCluster, AlwaysShared et NeverShared.
consumerDoesNotModifyPayloadAfterGet Indique que, lorsqu'une application utilisant des messages reçoit des messages de type objet ou octet, le système sérialise les données de message uniquement lorsque cela s'avère nécessaire. L'application est connectée au bus à l'aide de cette fabrique de connexions. Les applications obtenant les données de ces messages doivent traiter les données sous forme de données en lecture seule. Les valeurs admises sont true et false. La valeur par défaut est false.
producerDoesNotModifyPayloadAfterSet Indique que, lorsqu'une application utilisant des messages reçoit des messages de type objet ou octet, les données ne sont pas copiées et sont sérialisées par le système uniquement lorsque cela s'avère nécessaire. L'application est connectée au bus à l'aide de cette fabrique de connexions. Les applications qui envoient ce type de message ne doivent pas modifier les données une fois que celles-ci sont définies dans un message. Les valeurs admises sont true et false. La valeur par défaut est false.

Syntaxe

AdminJMS.createSIBJMSConnectionFactory(scope, 
 name, jndiName, 
 busName, attributes)

Exemple de syntaxe

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

AdminJMS.createSIBJMSConnectionFactory("myScope", "myName", "myJNDIName", 
"MyBusName")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWMQConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName2", "readAhead=AlwaysOff,description=my description")

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

AdminJMS.createSIBJMSConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName"
, "myJndiName1", "myBusName", [['readAhead', 'AlwaysOff'], ['description', 'my description']])

createWMQConnectionFactory

The script creates a connection factory for the IBM MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created IBM MQ connection factory.

Pour exécuter le script, indiquez les arguments correspondants à la portée, au nom et au nom JNDI. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 75. Arguments du script createWMQConnectionFactory. Exécutez le script pour créer une fabrique de connexions.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
nom Specifies the administrative name assigned to this IBM MQ messaging provider connection factory.
jndiName Indique le nom et l'emplacement utilisés pour lier cet objet à l'interface JNDI de WebSphere Application Server.
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 76. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
maxBatchSize Indique le nombre maximal de messages à extraire en une seule fois de la file d'attente en cas de distribution des messages en mode asynchrone.
brokerCCSubQueue Indique le nom de la file d'attente à partir de laquelle sont extraits les messages d'abonnement non durables d'un destinataire de connexions. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerCtrlQueue Indique la file d'attente de contrôle de courtier à utiliser si cette fabrique de connexions doit s'abonner à un sujet. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerQmgr Indique le nom du gestionnaire de files d'attente sur lequel le courtier s'exécute. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerSubQueue Indique la file d'attente à utiliser pour obtenir des messages d'abonnement si cette fabrique de connexions s'abonne à un sujet. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerVersion Indique le niveau de fonctionnalité requis pour les opérations de publication et d'abonnement. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerPubQueue Indique la file d'attente à laquelle les messages de publication doivent être envoyés lors de l'utilisation d'un courtier avec files d'attente. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
ccdtQmgrName Indique le nom du gestionnaire de files d'attente utilisé pour sélectionner une ou plusieurs entrées dans une table de définition de canal du client.
ccdtUrl Indique l'adresse URL d'une table de définition de canal du client. Use this attribute for this connection factory, when contacting the IBM MQ messaging provider. Les fabriques de connexions créées à l'aide de cet attribut sont des fabriques de connexions ccdtURL.
ccsid Indique l'ID de jeu de caractères codés à utiliser sur les connexions.
cleanupInterval Indique l'intervalle entre les exécutions en arrière-plan de l'utilitaire de nettoyage des publications et abonnements. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
cleanupLevel Indique le niveau de nettoyage des magasins d'abonnement BROKER ou MIGRATE. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
clientId Indique l'ID client utilisé pour les connexions lancées à l'aide de cette fabrique de connexions.
clonedSubs Indique si plusieurs instances du même abonné aux sujets durables peuvent s'exécuter simultanément. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
compressHeaders Détermine si les en-têtes de message sont compressés ou non.
compressPayload Détermine si les charges de messages sont compressées ou non.
containerAuthAlias Specifies a container managed authentication alias that has security credentials that are used for establishing a connection to the IBM MQ messaging provider.
description Fournit une description de la fabrique de connexions.
failIfQuiescing Indique le comportement de certains appels adressés au gestionnaire de files d'attente lorsque celui-ci se trouve à l'état de veille.
localAddress Indique l'un des éléments suivants ou les deux :
  • Interface de réseau local à utiliser.
  • Port local ou plage de ports locaux à utiliser.
mappingAlias Indique l'alias de mappage JAAS à utiliser lors de la détermination des données d'identification liées à la sécurité. The security related credentials are used when establishing a connection to the IBM MQ.
modelQueue Specifies the IBM MQ model queue definition to use as a basis when creating JMS temporary destinations. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
msgRetention Indique si le destinataire de connexion conserve les messages indésirables dans la file d'attente d'entrée. Si cet attribut a pour valeur true, les messages sont conservés. Si la valeur false est indiquée, les messages sont éliminés selon les options de mise au rebut. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
msgSelection Indique l'emplacement dans lequel la sélection des messages doit s'effectuer. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
pollingInterval Indique le temps maximal, en millisecondes, qui s'écoule au cours d'un intervalle d'interrogation. Si un module d'écoute de message au sein d'une session n'a pas de message approprié dans sa file d'attente, le module d'écoute de message utilise l'intervalle d'interrogation pour déterminer la fréquence à laquelle interroger sa file d'attente pour identifier un message. Augmentez la valeur de cette propriété si les sessions n'ont pas fréquemment de message approprié disponible. Cet attribut n'est applicable que dans le conteneur client.
providerVersion Indique la version minimale et les fonctionnalités du gestionnaire de files d'attente.
pubAckInterval Indique le nombre de publications à envoyer à un courtier avec files d'attente avant d'envoyer une publication qui demande un accusé de réception. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
qmgrHostname Specifies the hostname that this connection factory uses when attempting a client mode connection to IBM MQ.
qmgrName Specifies the queue manager name that this connection factory uses when contacting the IBM MQ messaging provider. Les fabriques de connexions créées à l'aide de ce paramètre sont des fabriques de connexions définies par l'utilisateur.
qmgrPortNumber Specifies the port number that this connection factory uses when attempting a client mode connection to IBM MQ.
qmgrSvrconnChannel Specifies the SVRCONN channel to use when connecting to IBM MQ. Les fabriques de connexions créées à l'aide de ce paramètre sont des fabriques de connexions définies par l'utilisateur.
rcvExitInitData Indique les données d'initialisation à transmettre à l'exit d'émission.
rcvExit Indique la liste des noms de classe d'exit de réception séparés par des virgules.
replyWithRFH2 Indique si, lors de la réponse à un message, un en-tête RFH version 2 est inclus dans le message de réponse. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
rescanInterval Indique le temps maximal, en millisecondes, qui s'écoule au cours d'un intervalle de scannage. When a message consumer in the point-to-point domain uses a message selector to select which messages it wants to receive, the IBM MQ JMS client searches the IBM MQ queue for suitable messages in the sequence determined by the MsgDeliverySequence attribute of the queue. Après avoir détecté un message approprié, le client le transmet au destinataire et reprend la recherche pour identifier le message approprié suivant à partir de la position en cours de la file d'attente. Le client continue la recherche jusqu'à ce qu'il atteigne la fin de la file d'attente ou que l'intervalle de temps indiqué par cette propriété arrive à expiration. Dans chaque cas, le client retourne au début de la file d'attente pour continuer sa recherche et un nouvel intervalle de temps commence. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
secExitInitData Indique les données d'initialisation à transmettre à l'exit de sécurité.
secExit Indique la liste des noms de classe d'exit de sécurité séparés par des virgules.
sendExitInitData Indique les données d'initialisation à transmettre à l'exit d'émission.
sendExit Indique la liste des noms de classe d'exit d'émission séparés par des virgules.
sparseSubs Indique les règles d'extraction des messages d'un objet TopicSubscriber. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
sslConfiguration Définit une configuration SSL (Secure Sockets Layer) spécifique permettant de sécuriser les connexions réseau au gestionnaire de files d'attente.
sslCrl Specifies a list of LDAP servers which can be used to provide certificate revocation information if this connection factory establishes an SSL connection to IBM MQ.
sslPeerName Indique un nom d'homologue à mettre en correspondance avec le nom distinctif présent dans le certificat de l'homologue. Cet attribut est utilisé lorsque la fabrique de connexions établit une connexion SSL avec le gestionnaire de files d'attente.
sslResetCount Indique le nombre d'octets à transmettre avant de réinitialiser la clé de chiffrement symétrique utilisée pour la session SSL. Cet attribut est utilisé lorsque la fabrique de connexions établit une connexion SSL avec le gestionnaire de files d'attente.
sslType Indique l'éventuelle configuration lorsque la fabrique de connexions établit une connexion SSL avec le gestionnaire de files d'attente.
stateRefreshInt Indique le délai maximal, en millisecondes, entre les régénérations de la transaction à exécution prolongée qui détecte le moment où un abonné perd sa connexion établie avec le gestionnaire de files d'attente. Cette propriété n'est applicable que si l'attribut subStore a pour valeur QUEUE. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
subStore Specifies that IBM MQ JMS stores persistent data relating to active subscriptions. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
support2PCProtocol Indique si la fabrique de connexions agit comme une ressource capable de participer à des traitements de validation à deux phases répartis.
tempQueuePrefix Specifies the prefix to apply to IBM MQ temporary queues. Ces files d'attente temporaires représentent des destinations de type file d'attente temporaire JMS. Cet attribut n'est applicable qu'aux fabriques de connexions de file d'attente.
tempTopicPrefix Specifies the prefix to apply to IBM MQ temporary topics. Ces sujets temporaires représentent des destinations de type sujet temporaire JMS. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
wildcardFormat Indique les jeux de caractères qui doivent être interprétés comme caractères génériques dans les sujets. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
wmqTransportType Specifies how this connection factory connects to IBM MQ. Les fabriques de connexions créées à l'aide de cet attribut sont définies par l'utilisateur. Les valeurs admises sont BINDINGS, BINDINGS_THEN_CLIENT et CLIENT.
xaRecoveryAuthAlias Specifies the authentication alias to connect to IBM MQ for XA recovery.

Syntaxe

AdminJMS.createWMQConnectionFactory(scope, 
 name, jndiName, 
 attributes)

Exemple de syntaxe

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

AdminJMS.createWMQConnectionFactory("myScope", "myName", "myJNDIName")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWMQConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName2", "maxBatchSize=15,description=my description")

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

AdminJMS.createWMQConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName2", [['maxBatchSize', '15'], ['description', 'my description']])

createSIBJMSQueueConnectionFactory

Ce script crée une fabrique de connexions de file d'attente JMS SIB pour le fournisseur de messagerie par défaut avec une portée que vous définissez. Il renvoie l'ID configuration de la fabrique de connexions de file d'attente JMS SIB créée.

Pour exécuter le script, indiquez les arguments correspondants à la portée, au nom, au nom JNDI et au nom de bus. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 77. Arguments du script createSIBJMSQueueConnectionFactory. Exécutez le script pour créer une fabrique de connexions de file d'attente JMS.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
nom Indique le nom administratif affecté à cette fabrique de connexions.
jndiName Indique le nom JNDI spécifié dans les liaisons des beans gérés par message associés à cette fabrique de connexions.
busName Indique le nom du bus d'intégration de services avec lequel les connexions sont établies.
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 78. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
authDataAlias Indique un ID utilisateur et un mot de passe à utiliser pour authentifier les connexions au fournisseur JMS pour l'authentification gérée par l'application.
containerAuthAlias Indique un alias d'authentification gérée par composant à partir duquel les données d'identification de sécurité sont utilisées pour établir une connexion au fournisseur JMS.
mappingAlias Indique l'alias de mappage JAAS (Java Authentication and Authorization Service) à utiliser lors de la détermination des données d'identification liées à la sécurité. Les données d'identification liées à la sécurité sont utilisées lors de l'établissement d'une connexion au fournisseur JMS.
xaRecoveryAuthAlias Indique l'alias d'authentification utilisé lors du traitement de la reprise XA.
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou regrouper la fabrique de connexions.
description Fournit une description de la fabrique de connexions.
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
manageCachedHandles Indique si les descripteurs placés en cache, qui sont des descripteurs conservés dans les variables d'instance d'un bean, doivent être surveillés par le conteneur.
ICclient Indique l'ID client qui est requis uniquement pour les abonnements durables.
userName Indique le nom d'utilisateur qui sert à créer des connexions à partir de la fabrique de connexions.
mot_de_passe Indique le mot de passe qui sert à créer des connexions à partir de la fabrique de connexions.
nonPersistentMapping Indique une valeur de mappage non persistant. Les valeurs admises sont BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination et None.
persistentMapping Indique une valeur de mappage persistant. Les valeurs admises sont BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination et None.
durableSubscriptionHome Indique la valeur de l'interface home des abonnements durables.
readAhead Indique la valeur de lecture anticipée. Les valeurs admises sont Default, AlwaysOn et AlwaysOff.
target Indique le nom d'une cible qui se convertit en groupe de moteurs de messagerie.
targetType Indique le type du nom dans le paramètre cible. Les valeurs admises sont BusMember, Custom et ME.
targetSignificance Indique l'importance du groupe cible. Les valeurs admises sont Préférée et Requise.
targetTransportChain Indique le nom du protocole qui permet la connexion à un moteur de messagerie éloigné.
providerEndPoints Indique une liste de triplets de noeuds finaux séparés par des virgules au format hôte:port:chaîne.
connectionProximity Indique la proximité des moteurs de messagerie acceptables. Les valeurs admises sont Bus, Hôte, Cluster et Serveur.
tempQueueNamePrefix Indique un préfixe de nom de file d'attente temporaire.
tempTopicNamePrefix Indique un préfixe de nom de sujet temporaire.
shareDataSourceWithCMP Indique comment contrôler les sources de données partagées.
shareDurableSubscriptions Indique comment contrôler les abonnements durables partagés. Les valeurs admises sont InCluster, AlwaysShared et NeverShared.
consumerDoesNotModifyPayloadAfterGet Indique que, lorsqu'une application utilisant des messages reçoit des messages de type objet ou octet, le système sérialise les données de message uniquement lorsque cela s'avère nécessaire. L'application est connectée au bus à l'aide de cette fabrique de connexions. Les applications obtenant les données de ces messages doivent traiter les données sous forme de données en lecture seule. Les valeurs admises sont true et false. La valeur par défaut est false.
producerDoesNotModifyPayloadAfterSet Indique que, lorsqu'une application utilisant des messages reçoit des messages de type objet ou octet, les données ne sont pas copiées et sont sérialisées par le système uniquement lorsque cela s'avère nécessaire. L'application est connectée au bus à l'aide de cette fabrique de connexions. Les applications qui envoient ce type de message ne doivent pas modifier les données une fois que celles-ci sont définies dans un message. Les valeurs admises sont true et false. La valeur par défaut est false.

Syntaxe

AdminJMS.createSIBJMSQueueConnectionFactory(scope, 
 name, jndiName, 
 busName, attributes)

Exemple de syntaxe

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

AdminJMS.createSIBJMSQueueConnectionFactory("myScope", "myName", "myJNDIName", 
"MyBusName")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createSIBJMSQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" , 
"myJndiName3", "myBusName", "readAhead=AlwaysOff,description=my description")

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

AdminJMS.createSIBJMSQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" , 
"myJndiName3", "myBusName", [['readAhead', 'AlwaysOff'], ['description', 'my description']])

createWMQQueueConnectionFactory

The script creates a queue connection factory for the IBM MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created IBM MQ queue connection factory.

Pour exécuter le script, indiquez les arguments correspondants à la portée, au nom et au nom JNDI. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 79. Arguments du script createWMQQueueConnectionFactory. Exécutez le script pour créer une fabrique de connexions de file d'attente.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
nom Specifies the administrative name assigned to this IBM MQ messaging provider connection factory.
jndiName Indique le nom et l'emplacement utilisés pour lier cet objet à l'interface JNDI de WebSphere Application Server.
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 80. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
maxBatchSize Indique le nombre maximal de messages à extraire en une seule fois de la file d'attente en cas de distribution des messages en mode asynchrone.
brokerCCSubQueue Indique le nom de la file d'attente à partir de laquelle sont extraits les messages d'abonnement non durables d'un destinataire de connexions. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerCtrlQueue Indique la file d'attente de contrôle de courtier à utiliser si cette fabrique de connexions doit s'abonner à un sujet. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerQmgr Indique le nom du gestionnaire de files d'attente sur lequel le courtier s'exécute. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerSubQueue Indique la file d'attente à utiliser pour obtenir des messages d'abonnement si cette fabrique de connexions s'abonne à un sujet. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerVersion Indique le niveau de fonctionnalité requis pour les opérations de publication et d'abonnement. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerPubQueue Indique la file d'attente à laquelle les messages de publication doivent être envoyés lors de l'utilisation d'un courtier avec files d'attente. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
ccdtQmgrName Indique le nom du gestionnaire de files d'attente utilisé pour sélectionner une ou plusieurs entrées dans une table de définition de canal du client.
ccdtUrl Indique l'adresse URL d'une table de définition de canal du client. Use this attribute for this connection factory, when contacting the IBM MQ messaging provider. Les fabriques de connexions créées à l'aide de cet attribut sont des fabriques de connexions ccdtURL.
ccsid Indique l'ID de jeu de caractères codés à utiliser sur les connexions.
cleanupInterval Indique l'intervalle entre les exécutions en arrière-plan de l'utilitaire de nettoyage des publications et abonnements. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
cleanupLevel Indique le niveau de nettoyage des magasins d'abonnement BROKER ou MIGRATE. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
clientId Indique l'ID client utilisé pour les connexions lancées à l'aide de cette fabrique de connexions.
clonedSubs Indique si plusieurs instances du même abonné aux sujets durables peuvent s'exécuter simultanément. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
compressHeaders Détermine si les en-têtes de message sont compressés ou non.
compressPayload Détermine si les charges de messages sont compressées ou non.
containerAuthAlias Specifies a container managed authentication alias that has security credentials that are used for establishing a connection to the IBM MQ messaging provider.
description Fournit une description de la fabrique de connexions.
failIfQuiescing Indique le comportement de certains appels adressés au gestionnaire de files d'attente lorsque celui-ci se trouve à l'état de veille.
localAddress Indique l'un des éléments suivants ou les deux :
  • Interface de réseau local à utiliser.
  • Port local ou plage de ports locaux à utiliser.
mappingAlias Indique l'alias de mappage JAAS à utiliser lors de la détermination des données d'identification liées à la sécurité. The security related credentials are used when establishing a connection to the IBM MQ.
modelQueue Specifies the IBM MQ model queue definition to use as a basis when creating JMS temporary destinations. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
msgRetention Indique si le destinataire de connexion conserve les messages indésirables dans la file d'attente d'entrée. Si cet attribut a pour valeur true, les messages sont conservés. Si la valeur false est indiquée, les messages sont éliminés selon les options de mise au rebut. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
msgSelection Indique l'emplacement dans lequel la sélection des messages doit s'effectuer. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
pollingInterval Indique le temps maximal, en millisecondes, qui s'écoule au cours d'un intervalle d'interrogation. Si un module d'écoute de message au sein d'une session n'a pas de message approprié dans sa file d'attente, le module d'écoute de message utilise l'intervalle d'interrogation pour déterminer la fréquence à laquelle interroger sa file d'attente pour identifier un message. Augmentez la valeur de cette propriété si les sessions n'ont pas fréquemment de message approprié disponible. Cet attribut n'est applicable que dans le conteneur client.
providerVersion Indique la version minimale et les fonctionnalités du gestionnaire de files d'attente.
pubAckInterval Indique le nombre de publications à envoyer à un courtier avec files d'attente avant d'envoyer une publication qui demande un accusé de réception. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
qmgrHostname Specifies the hostname that this connection factory uses when attempting a client mode connection to IBM MQ.
qmgrName Specifies the queue manager name that this connection factory uses when contacting the IBM MQ messaging provider. Les fabriques de connexions créées à l'aide de ce paramètre sont des fabriques de connexions définies par l'utilisateur.
qmgrPortNumber Specifies the port number that this connection factory uses when attempting a client mode connection to IBM MQ.
qmgrSvrconnChannel Specifies the SVRCONN channel to use when connecting to IBM MQ. Les fabriques de connexions créées à l'aide de ce paramètre sont des fabriques de connexions définies par l'utilisateur.
rcvExitInitData Indique les données d'initialisation à transmettre à l'exit d'émission.
rcvExit Indique la liste des noms de classe d'exit de réception séparés par des virgules.
replyWithRFH2 Indique si, lors de la réponse à un message, un en-tête RFH version 2 est inclus dans le message de réponse. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
rescanInterval Indique le temps maximal, en millisecondes, qui s'écoule au cours d'un intervalle de scannage. When a message consumer in the point-to-point domain uses a message selector to select which messages it wants to receive, the IBM MQ JMS client searches the IBM MQ queue for suitable messages in the sequence determined by the MsgDeliverySequence attribute of the queue. Après avoir détecté un message approprié, le client le transmet au destinataire et reprend la recherche pour identifier le message approprié suivant à partir de la position en cours de la file d'attente. Le client continue la recherche jusqu'à ce qu'il atteigne la fin de la file d'attente ou que l'intervalle de temps indiqué par cette propriété arrive à expiration. Dans chaque cas, le client retourne au début de la file d'attente pour continuer sa recherche et un nouvel intervalle de temps commence. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
secExitInitData Indique les données d'initialisation à transmettre à l'exit de sécurité.
secExit Indique la liste des noms de classe d'exit de sécurité séparés par des virgules.
sendExitInitData Indique les données d'initialisation à transmettre à l'exit d'émission.
sendExit Indique la liste des noms de classe d'exit d'émission séparés par des virgules.
sparseSubs Indique les règles d'extraction des messages d'un objet TopicSubscriber. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
sslConfiguration Définit une configuration SSL (Secure Sockets Layer) spécifique permettant de sécuriser les connexions réseau au gestionnaire de files d'attente.
sslCrl Specifies a list of LDAP servers which can be used to provide certificate revocation information if this connection factory establishes an SSL connection to IBM MQ.
sslPeerName Indique un nom d'homologue à mettre en correspondance avec le nom distinctif présent dans le certificat de l'homologue. Cet attribut est utilisé lorsque la fabrique de connexions établit une connexion SSL avec le gestionnaire de files d'attente.
sslResetCount Indique le nombre d'octets à transmettre avant de réinitialiser la clé de chiffrement symétrique utilisée pour la session SSL. Cet attribut est utilisé lorsque la fabrique de connexions établit une connexion SSL avec le gestionnaire de files d'attente.
sslType Indique l'éventuelle configuration lorsque la fabrique de connexions établit une connexion SSL avec le gestionnaire de files d'attente.
stateRefreshInt Indique le délai maximal, en millisecondes, entre les régénérations de la transaction à exécution prolongée qui détecte le moment où un abonné perd sa connexion établie avec le gestionnaire de files d'attente. Cette propriété n'est applicable que si l'attribut subStore a pour valeur QUEUE. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
subStore Specifies that IBM MQ JMS stores persistent data relating to active subscriptions. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
support2PCProtocol Indique si la fabrique de connexions agit comme une ressource capable de participer à des traitements de validation à deux phases répartis.
tempQueuePrefix Specifies the prefix to apply to IBM MQ temporary queues. Ces files d'attente temporaires représentent des destinations de type file d'attente temporaire JMS. Cet attribut n'est applicable qu'aux fabriques de connexions de file d'attente.
tempTopicPrefix Specifies the prefix to apply to IBM MQ temporary topics. Ces sujets temporaires représentent des destinations de type sujet temporaire JMS. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
wildcardFormat Indique les jeux de caractères qui doivent être interprétés comme caractères génériques dans les sujets. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
wmqTransportType Specifies how this connection factory connects to IBM MQ. Les fabriques de connexions créées à l'aide de cet attribut sont définies par l'utilisateur. Les valeurs admises sont BINDINGS, BINDINGS_THEN_CLIENT et CLIENT.
xaRecoveryAuthAlias Specifies the authentication alias to connect to IBM MQ for XA recovery.

Syntaxe

AdminJMS.createWMQQueueConnectionFactory(scope, 
 name, jndiName, 
 attributes)

Exemple de syntaxe

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

AdminJMS.createWMQQueueConnectionFactory("myScope", "myName", "myJNDIName")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWMQQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName
" , "myJndiName4", "maxBatchSize=15,description=my description")

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

AdminJMS.createWMQQueueConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName4", [['maxBatchSize', '15'], ['description', 'my description']])

createSIBJMSTopicConnectionFactory

Ce script crée une fabrique de connexions de sujet JMS SIB pour le fournisseur de messagerie par défaut avec une portée que vous définissez. Il renvoie l'ID configuration de la fabrique de connexions de sujet JMS SIB créée.

Pour exécuter le script, indiquez les arguments correspondants à la portée, au nom, au nom JNDI et au nom de bus. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 81. Arguments du script createSIBJMSTopicConnectionFactory. Exécutez le script pour créer une fabrique de connexions de sujet JMS SIB.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
nom Indique le nom administratif affecté à cette fabrique de connexions.
jndiName Indique le nom JNDI spécifié dans les liaisons des beans gérés par message associés à cette fabrique de connexions.
busName Indique le nom du bus d'intégration de services avec lequel les connexions sont établies.
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 82. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
authDataAlias Indique un ID utilisateur et un mot de passe à utiliser pour authentifier les connexions au fournisseur JMS pour l'authentification gérée par l'application.
containerAuthAlias Indique un alias d'authentification gérée par composant à partir duquel les données d'identification de sécurité sont utilisées pour établir une connexion au fournisseur JMS.
mappingAlias Indique l'alias de mappage JAAS (Java Authentication and Authorization Service) à utiliser lors de la détermination des données d'identification liées à la sécurité. Les données d'identification liées à la sécurité sont utilisées lors de l'établissement d'une connexion au fournisseur JMS.
xaRecoveryAuthAlias Indique l'alias d'authentification utilisé lors du traitement de la reprise XA.
catégorie Indique la catégorie que vous pouvez utiliser pour classifier ou regrouper la fabrique de connexions.
description Fournit une description de la fabrique de connexions.
logMissingTransactionContext Spécifie si la journalisation du contexte des transactions manquantes est activée ou non.
manageCachedHandles Indique si les descripteurs placés en cache, qui sont des descripteurs conservés dans les variables d'instance d'un bean, doivent être surveillés par le conteneur.
ICclient Indique l'ID client qui est requis uniquement pour les abonnements durables.
userName Indique le nom d'utilisateur qui sert à créer des connexions à partir de la fabrique de connexions.
mot_de_passe Indique le mot de passe qui sert à créer des connexions à partir de la fabrique de connexions.
nonPersistentMapping Indique une valeur de mappage non persistant. Les valeurs admises sont BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination et None.
persistentMapping Indique une valeur de mappage persistant. Les valeurs admises sont BestEffortNonPersistent, ExpressNonPersistent, ReliableNonPersistent, ReliablePersistent, AssuredPersistent, AsSIBDestination et None.
durableSubscriptionHome Indique la valeur de l'interface home des abonnements durables.
readAhead Indique la valeur de lecture anticipée. Les valeurs admises sont Default, AlwaysOn et AlwaysOff.
target Indique le nom d'une cible qui se convertit en groupe de moteurs de messagerie.
targetType Indique le type du nom dans le paramètre cible. Les valeurs admises sont BusMember, Custom et ME.
targetSignificance Indique l'importance du groupe cible. Les valeurs admises sont Préférée et Requise.
targetTransportChain Indique le nom du protocole qui permet la connexion à un moteur de messagerie éloigné.
providerEndPoints Indique une liste de triplets de noeuds finaux séparés par des virgules au format hôte:port:chaîne.
connectionProximity Indique la proximité des moteurs de messagerie acceptables. Les valeurs admises sont Bus, Hôte, Cluster et Serveur.
tempQueueNamePrefix Indique un préfixe de nom de file d'attente temporaire.
tempTopicNamePrefix Indique un préfixe de nom de sujet temporaire.
shareDataSourceWithCMP Indique comment contrôler les sources de données partagées.
shareDurableSubscriptions Indique comment contrôler les abonnements durables partagés. Les valeurs admises sont InCluster, AlwaysShared et NeverShared.
consumerDoesNotModifyPayloadAfterGet Indique que, lorsqu'une application utilisant des messages reçoit des messages de type objet ou octet, le système sérialise les données de message uniquement lorsque cela s'avère nécessaire. L'application est connectée au bus à l'aide de cette fabrique de connexions. Les applications obtenant les données de ces messages doivent traiter les données sous forme de données en lecture seule. Les valeurs admises sont true et false. La valeur par défaut est false.
producerDoesNotModifyPayloadAfterSet Indique que, lorsqu'une application utilisant des messages reçoit des messages de type objet ou octet, les données ne sont pas copiées et sont sérialisées par le système uniquement lorsque cela s'avère nécessaire. L'application est connectée au bus à l'aide de cette fabrique de connexions. Les applications qui envoient ce type de message ne doivent pas modifier les données une fois que celles-ci sont définies dans un message. Les valeurs admises sont true et false. La valeur par défaut est false.

Syntaxe

AdminJMS.createSIBJMSTopicConnectionFactory(scope, 
 name, jndiName, 
 busName, attributes)

Exemple de syntaxe

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

AdminJMS.createSIBJMSTopicConnectionFactory("myScope", "myName", "myJNDIName", 
"MyBusName")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createSIBJMSTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName5", "myBusName", "readAhead=AlwaysOff,description=my description")

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

AdminJMS.createSIBJMSTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName5", "myBusName", [['readAhead', 'AlwaysOff'], ['description', 'my description']])

createWMQTopicConnectionFactory

The script creates a topic connection factory for the IBM MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created IBM MQ topic connection factory.

Pour exécuter le script, indiquez les arguments correspondants à la portée, au nom et au nom JNDI. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 83. Arguments du script createWMQTopicConnectionFactory. Exécutez le script pour créer une fabrique de connexions de sujet.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur JMS.
nom Specifies the administrative name assigned to this IBM MQ messaging provider connection factory.
jndiName Indique le nom et l'emplacement utilisés pour lier cet objet à l'interface JNDI de WebSphere Application Server.
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 84. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
maxBatchSize Indique le nombre maximal de messages à extraire en une seule fois de la file d'attente en cas de distribution des messages en mode asynchrone.
brokerCCSubQueue Indique le nom de la file d'attente à partir de laquelle sont extraits les messages d'abonnement non durables d'un destinataire de connexions. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerCtrlQueue Indique la file d'attente de contrôle de courtier à utiliser si cette fabrique de connexions doit s'abonner à un sujet. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerQmgr Indique le nom du gestionnaire de files d'attente sur lequel le courtier s'exécute. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerSubQueue Indique la file d'attente à utiliser pour obtenir des messages d'abonnement si cette fabrique de connexions s'abonne à un sujet. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerVersion Indique le niveau de fonctionnalité requis pour les opérations de publication et d'abonnement. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
brokerPubQueue Indique la file d'attente à laquelle les messages de publication doivent être envoyés lors de l'utilisation d'un courtier avec files d'attente. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
ccdtQmgrName Indique le nom du gestionnaire de files d'attente utilisé pour sélectionner une ou plusieurs entrées dans une table de définition de canal du client.
ccdtUrl Indique l'adresse URL d'une table de définition de canal du client. Use this attribute for this connection factory, when contacting the IBM MQ messaging provider. Les fabriques de connexions créées à l'aide de cet attribut sont des fabriques de connexions ccdtURL.
ccsid Indique l'ID de jeu de caractères codés à utiliser sur les connexions.
cleanupInterval Indique l'intervalle entre les exécutions en arrière-plan de l'utilitaire de nettoyage des publications et abonnements. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
cleanupLevel Indique le niveau de nettoyage des magasins d'abonnement BROKER ou MIGRATE. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
clientId Indique l'ID client utilisé pour les connexions lancées à l'aide de cette fabrique de connexions.
clonedSubs Indique si plusieurs instances du même abonné aux sujets durables peuvent s'exécuter simultanément. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
compressHeaders Détermine si les en-têtes de message sont compressés ou non.
compressPayload Détermine si les charges de messages sont compressées ou non.
containerAuthAlias Specifies a container managed authentication alias that has security credentials that are used for establishing a connection to the IBM MQ messaging provider.
description Fournit une description de la fabrique de connexions.
failIfQuiescing Indique le comportement de certains appels adressés au gestionnaire de files d'attente lorsque celui-ci se trouve à l'état de veille.
localAddress Indique l'un des éléments suivants ou les deux :
  • Interface de réseau local à utiliser.
  • Port local ou plage de ports locaux à utiliser.
mappingAlias Indique l'alias de mappage JAAS à utiliser lors de la détermination des données d'identification liées à la sécurité. The security related credentials are used when establishing a connection to the IBM MQ.
modelQueue Specifies the IBM MQ model queue definition to use as a basis when creating JMS temporary destinations. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
msgRetention Indique si le destinataire de connexion conserve les messages indésirables dans la file d'attente d'entrée. Si cet attribut a pour valeur true, les messages sont conservés. Si la valeur false est indiquée, les messages sont éliminés selon les options de mise au rebut. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
msgSelection Indique l'emplacement dans lequel la sélection des messages doit s'effectuer. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
pollingInterval Indique le temps maximal, en millisecondes, qui s'écoule au cours d'un intervalle d'interrogation. Si un module d'écoute de message au sein d'une session n'a pas de message approprié dans sa file d'attente, le module d'écoute de message utilise l'intervalle d'interrogation pour déterminer la fréquence à laquelle interroger sa file d'attente pour identifier un message. Augmentez la valeur de cette propriété si les sessions n'ont pas fréquemment de message approprié disponible. Cet attribut n'est applicable que dans le conteneur client.
providerVersion Indique la version minimale et les fonctionnalités du gestionnaire de files d'attente.
pubAckInterval Indique le nombre de publications à envoyer à un courtier avec files d'attente avant d'envoyer une publication qui demande un accusé de réception. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
qmgrHostname Specifies the hostname that this connection factory uses when attempting a client mode connection to IBM MQ.
qmgrName Specifies the queue manager name that this connection factory uses when contacting the IBM MQ messaging provider. Les fabriques de connexions créées à l'aide de ce paramètre sont des fabriques de connexions définies par l'utilisateur.
qmgrPortNumber Specifies the port number that this connection factory uses when attempting a client mode connection to IBM MQ.
qmgrSvrconnChannel Specifies the SVRCONN channel to use when connecting to IBM MQ. Les fabriques de connexions créées à l'aide de ce paramètre sont des fabriques de connexions définies par l'utilisateur.
rcvExitInitData Indique les données d'initialisation à transmettre à l'exit d'émission.
rcvExit Indique la liste des noms de classe d'exit de réception séparés par des virgules.
replyWithRFH2 Indique si, lors de la réponse à un message, un en-tête RFH version 2 est inclus dans le message de réponse. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
rescanInterval Indique le temps maximal, en millisecondes, qui s'écoule au cours d'un intervalle de scannage. When a message consumer in the point-to-point domain uses a message selector to select which messages it wants to receive, the IBM MQ JMS client searches the IBM MQ queue for suitable messages in the sequence determined by the MsgDeliverySequence attribute of the queue. Après avoir détecté un message approprié, le client le transmet au destinataire et reprend la recherche pour identifier le message approprié suivant à partir de la position en cours de la file d'attente. Le client continue la recherche jusqu'à ce qu'il atteigne la fin de la file d'attente ou que l'intervalle de temps indiqué par cette propriété arrive à expiration. Dans chaque cas, le client retourne au début de la file d'attente pour continuer sa recherche et un nouvel intervalle de temps commence. Ce paramètre n'est applicable qu'aux fabriques de connexions de file d'attente.
secExitInitData Indique les données d'initialisation à transmettre à l'exit de sécurité.
secExit Indique la liste des noms de classe d'exit de sécurité séparés par des virgules.
sendExitInitData Indique les données d'initialisation à transmettre à l'exit d'émission.
sendExit Indique la liste des noms de classe d'exit d'émission séparés par des virgules.
sparseSubs Indique les règles d'extraction des messages d'un objet TopicSubscriber. Ce paramètre n'est applicable qu'aux fabriques de connexions de sujet.
sslConfiguration Définit une configuration SSL (Secure Sockets Layer) spécifique permettant de sécuriser les connexions réseau au gestionnaire de files d'attente.
sslCrl Specifies a list of LDAP servers which can be used to provide certificate revocation information if this connection factory establishes an SSL connection to IBM MQ.
sslPeerName Indique un nom d'homologue à mettre en correspondance avec le nom distinctif présent dans le certificat de l'homologue. Cet attribut est utilisé lorsque la fabrique de connexions établit une connexion SSL avec le gestionnaire de files d'attente.
sslResetCount Indique le nombre d'octets à transmettre avant de réinitialiser la clé de chiffrement symétrique utilisée pour la session SSL. Cet attribut est utilisé lorsque la fabrique de connexions établit une connexion SSL avec le gestionnaire de files d'attente.
sslType Indique l'éventuelle configuration lorsque la fabrique de connexions établit une connexion SSL avec le gestionnaire de files d'attente.
stateRefreshInt Indique le délai maximal, en millisecondes, entre les régénérations de la transaction à exécution prolongée qui détecte le moment où un abonné perd sa connexion établie avec le gestionnaire de files d'attente. Cette propriété n'est applicable que si l'attribut subStore a pour valeur QUEUE. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
subStore Specifies that IBM MQ JMS stores persistent data relating to active subscriptions. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
support2PCProtocol Indique si la fabrique de connexions agit comme une ressource capable de participer à des traitements de validation à deux phases répartis.
tempQueuePrefix Specifies the prefix to apply to IBM MQ temporary queues. Ces files d'attente temporaires représentent des destinations de type file d'attente temporaire JMS. Cet attribut n'est applicable qu'aux fabriques de connexions de file d'attente.
tempTopicPrefix Specifies the prefix to apply to IBM MQ temporary topics. Ces sujets temporaires représentent des destinations de type sujet temporaire JMS. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
wildcardFormat Indique les jeux de caractères qui doivent être interprétés comme caractères génériques dans les sujets. Cet attribut n'est applicable qu'aux fabriques de connexions de sujet.
wmqTransportType Specifies how this connection factory connects to IBM MQ. Les fabriques de connexions créées à l'aide de cet attribut sont définies par l'utilisateur. Les valeurs admises sont BINDINGS, BINDINGS_THEN_CLIENT et CLIENT.
xaRecoveryAuthAlias Specifies the authentication alias to connect to IBM MQ for XA recovery.

Syntaxe

AdminJMS.createWMQTopicConnectionFactory(scope, 
 name, jndiName, 
 attributes)

Exemple de syntaxe

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

AdminJMS.createWMQTopicConnectionFactory("myScope", "myName", "myJNDIName")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWMQTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName6", "maxBatchSize=15,description=my description")

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

AdminJMS.createWMQTopicConnectionFactory
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName6", [['maxBatchSize', '15'], ['description', 'my description']])

createSIBJMSActivationSpec

Ce script crée une spécification d'activation JMS pour le fournisseur de messagerie par défaut avec une portée que vous définissez. Il renvoie l'ID configuration de la spécification d'activation JMS SIB créée.

Pour exécuter le script, indiquez les arguments correspondants à la portée, au nom de la spécification d'activation, au nom JNDI et à la destination du nom JNDI. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 85. Arguments du script createSIBJMSActivationSpec. Exécutez le script pour créer une spécification d'activation JMS.
Argument Description
scope Indique la portée d'une cellule, d'un noeud, d'un serveur ou d'un cluster pour le fournisseur de messagerie par défaut avec laquelle la spécification d'activation JMS doit être créée.
nom Indique le nom affecté à cette spécification d'activation.
jndiName Indique le nom JNDI indiqué dans les liaisons des beans gérés par message associés à cette spécification d'activation.
destinationJndiName Indique le nom JNDI de la file d'attente ou du sujet JMS de destination utilisé par le bean géré par message.
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 86. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
description Indique la spécification d'activation JMS que le fournisseur de messagerie par défaut utilise pour valider les propriétés activation-configuration pour un bean géré par message (MDB) JMS.
acknowledgeMode Indique la façon dont la session accuse réception des messages qu'elle reçoit.
authenticationAlias Indique le nom d'un alias d'authentification J2C utilisé pour l'authentification gérée par composant des connexions au bus d'intégration de services.
busName Nom du bus d'intégration de services avec lequel les connexions sont établies.
clientId Indique l'identificateur client JMS. L'identificateur client est obligatoire pour les abonnements à des sujets durables.
destinationType Indique si le bean géré par message utilise une destination de sujet ou de file d'attente.
durableSubscriptionHome Indique le nom de l'interface home des abonnements durables. Cet attribut identifie le moteur de messagerie où tous les abonnements durables auxquels cette spécification d'activation permet d'accéder sont gérés.
maxBatchSize Indique le nombre maximal de messages reçus par le moteur de messagerie dans un seul lot.
maxConcurrency Indique le nombre maximal de noeuds finaux auxquels les messages sont simultanément délivrés.
messageSelector Indique le sélecteur de message JMS permettant de déterminer quels sont les messages reçus par le bean géré par message (MDB).
mot_de_passe Indique le mot de passe à utiliser pour la sécurité du connecteur Java 2.
subscriptionDurability Indique si un abonnement à un sujet JMS est durable ou non.
subscriptionName Indique le nom de l'abonnement requis pour les abonnements de sujet durables.
shareDurableSubscriptions Indique comment les abonnements durables sont partagés.
userName Indique l'ID utilisateur à utiliser pour la sécurité du connecteur Java 2.
readAhead Indique la valeur de lecture anticipée. Les valeurs admises sont Default, AlwaysOn et AlwaysOff.
target Indique la valeur de la nouvelle cible de la spécification d'activation JMS SIB.
targetType Indique la valeur de la nouvelle cible de la spécification d'activation JMS SIB. Les valeurs admises sont BusMember, Custom et ME.
targetSignificance Indique l'importance du groupe cible.
targetTransportChain Indique le nom du protocole qui permet la connexion à un moteur de messagerie éloigné.
providerEndPoints Indique une liste de triplets de noeuds finaux séparés par des virgules au format hôte:port:chaîne.
shareDataSourceWithCMP Indique comment les sources de données sont partagées.
consumerDoesNotModifyPayloadAfterGet Cet attribut, lorsqu'il est activé, indique que les messages de type objet reçus via cette spécification d'activation ne verront leurs données de message sérialisées par le système que lorsque cela s'avère nécessaire. Les applications obtenant des données de ces messages doivent traiter les données sous forme de données en lecture seule. Les valeurs admises sont true et false. La valeur par défaut est false.
forwarderDoesNotModifyPayloadAfterSet Lorsque cet attribut est activé, les données des messages de type objet-octet acheminés via cette spécification d'activation et dont la charge est modifiée ne sont pas copiées lorsqu'elles sont envoyées dans le message. Le système sérialise les données des messages uniquement lorsque cela s'avère nécessaire. Les applications qui envoient ce type de message ne doivent pas modifier les données une fois que celles-ci sont envoyées dans le message. Les valeurs admises sont true et false. La valeur par défaut est false.
alwaysActivateAllMDBs Indique la règle de sélection par le serveur des beans MDB. Cette règle détermine les serveurs qui peuvent gérer les beans MDB déployés sur eux. Les valeurs admises sont true et false. La valeur par défaut est false. Spécifiez la valeur true pour activer les beans MDB sur tous les serveurs. Sinon, seuls les serveurs avec un moteur de messagerie en cours d'exécution sont utilisés.
retryInterval Indique le délai (en secondes) entre deux tentatives de connexion à un moteur de messagerie, pour la connexion initiale et pour toute les tentatives ultérieures d'établir une meilleure connexion. La valeur par défaut est 30. Le délai doit être supérieur à zéro.
autoStopSequentialMessageFailure Indique que le noeud final est arrêté lorsque le nombre de messages qui ont échoué de façon séquentielle aura atteint la limite configurée. En raison de dépendances de traitement dans le bean MDB, il se peut que le nombre réel de messages traités dépasse cette valeur.
failingMessageDelay Indique la période de temps qui s'écoule avant la nouvelle tentative d'envoi d'un message. La transmission d'un message est retentée lorsque celui-ci ne parvient pas à être traité par le bean géré par message (MDB) et qu'il n'a pas atteint le nombre maximal d'échecs de transmission. La transmission d'autres messages peut être tentée pendant ce délai sauf si le seuil d'échecs séquentiels et l'accès concurrent maximum sont définis sur 1.

Syntaxe

AdminJMS.createSIBJMSActivationSpec(scope, 
 name, jndiName, 
 destinationJndiName, attributes)

Exemple de syntaxe

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

AdminJMS.createSIBJMSActivationSpec("myScope", "myName", 
 "myJNDIName", "myDestinationName")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createSIBJMSActivationSpec(
"server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName11", "myDestinationJndiName11", "readAhead=AlwaysOff,maxBatchSize=54")

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

AdminJMS.createSIBJMSActivationSpec
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName11", "myDestinationJndiName11", [['readAhead', 'AlwaysOff'], ['maxBatchSize', '54']])

createWMQActivationSpec

This script creates a new activation specification for the IBM MQ messaging provider at the scope that you specify. The script returns the configuration ID of the created IBM MQ activation specification.

Pour exécuter le script, indiquez les arguments correspondants à la portée, au nom de la spécification d'activation, au nom JNDI et à la destination du nom JNDI. Vous pouvez également indiquer des attributs. Les arguments et attributs possibles sont répertoriés dans les tableaux suivants :
Tableau 87. Arguments du script createWMQActivationSpec. Exécutez le script pour créer une spécification d'activation.
Argument Description
scope Specifies a scope of cell, node, server, or cluster for the activation specification of the IBM MQ messaging provider.
nom Indique le nom affecté à cette spécification d'activation.
jndiName Indique le nom et l'emplacement utilisés pour lier cet objet à l'interface JNDI de WebSphere Application Server.
destinationJndiName Specifies the JNDI name of a IBM MQ messaging provider queue or topic type destination. Lorsqu'un bean géré par message est déployé avec cette spécification d'activation, les messages destinés à ce bean sont reçus à partir de cette destination.
destinationType Indique le type de la destination. Les valeurs admises sont javax.jms.Queue et javax.jms.Topic. L'argument ne possède pas de valeur par défaut.
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 88. Attributs facultatifs. Autres attributs disponibles pour le script.
Attributs Description
authAlias Specifies the authentication alias used to obtain the credentials that this activation specification needs to establish a connection to IBM MQ.
brokerCCDurSubQueue Indique le nom de la file d'attente à partir de laquelle un destinataire de connexion reçoit des messages d'abonnement durables.
brokerCCSubQueue Indique le nom de la file d'attente à partir de laquelle sont extraits les messages d'abonnement non durables d'un destinataire de connexions.
brokerCtrlQueue Indique la file d'attente de contrôle de courtier à utiliser lorsque cette spécification d'activation s'abonne à un sujet.
brokerQmgr Indique le nom du gestionnaire de files d'attente sur lequel le courtier s'exécute.
brokerSubQueue Indique la file d'attente à utiliser pour obtenir des messages d'abonnement si cette spécification d'activation s'abonne à un sujet.
brokerVersion Indique le niveau de fonctionnalité requis pour les opérations de publication et d'abonnement.
ccdtQmgrName Indique le nom du gestionnaire de files d'attente qui permet de sélectionner une ou plusieurs entrées dans une table de définition de canal du client.
ccdtUrl Indique l'adresse URL d'une table de définition de canal du client. Use this attribute for this activation specification when contacting IBM MQ. Les spécifications d'activation créées à l'aide de cet attribut sont des spécifications d'activation ccdtURL.
ccsid Indique l'ID de jeu de caractères codés utilisé sur les connexions.
cleanupInterval Indique l'intervalle entre les exécutions en arrière-plan de l'utilitaire de nettoyage des publications et abonnements.
cleanupLevel Indique le niveau de nettoyage des magasins d'abonnement broker ou migrate.
clientId Indique l'ID client utilisé pour les connexions lancées à l'aide de cette spécification d'activation.
clonedSubs Indique si plusieurs instances du même abonné aux sujets durables peuvent s'exécuter simultanément.
compressHeaders Indique si les en-têtes de message sont compressés.
compressPayload Indique si les charges de messages sont compressées.
description Spécifie une description d'administration affectée à la spécification d'activation.
failIfQuiescing Indique le comportement de certains appels adressés au gestionnaire de files d'attente lorsque celui-ci se trouve à l'état de veille.
failureDeliveryCount Indique le nombre d'échecs de distribution séquentiels autorisés avant que le noeud final ne soit suspendu.
maxPoolSize Indique le nombre maximal de sessions serveur dans le pool de sessions serveur utilisé par le destinataire de connexions.
messageSelector Indique les messages qui sont distribués.
msgRetention Indique si le destinataire de connexion conserve les messages indésirables dans la file d'attente d'entrée. Si cet attribut a pour valeur true, les messages sont conservés. Si la valeur false est indiquée, les messages sont éliminés selon les options de mise au rebut.
msgSelection Indique l'emplacement dans lequel la sélection des messages doit s'effectuer.
poolTimeout Indique la période (en millisecondes) pendant laquelle une session serveur non utilisée est maintenue ouverte dans le pool de sessions serveur avant sa fermeture pour cause d'inactivité.
providerVersion Indique la version minimale et les fonctionnalités du gestionnaire de files d'attente.
qmgrHostname Specifies the hostname which used for this activation specification, when attempting a client mode connection to IBM MQ.
qmgrName Specifies the name of the queue manager for this activation specification, when contacting IBM MQ. Les spécifications d'activation créées à l'aide de cet attribut sont définies par l'utilisateur.
qmgrPortNumber Specifies the port number for this activation specification, when attempting a client mode connection to IBM MQ.
qmgrSvrconnChannel Specifies the SVRCONN channel to use when connecting to IBM MQ. Les spécifications d'activation créées à l'aide de cet attribut sont définies par l'utilisateur.
rcvExitInitData Indique les données d'initialisation à transmettre à l'exit d'émission.
rcvExit Indique la liste des noms de classe d'exit de réception séparés par des virgules.
rescanInterval Indique le temps maximal, en millisecondes, qui s'écoule au cours d'un intervalle de scannage. When a message consumer in the point-to-point domain uses a message selector to select which messages it wants to receive, the IBM MQ JMS client searches the IBM MQ queue for suitable messages in the sequence determined by the MsgDeliverySequence attribute of the queue. Après avoir détecté un message approprié, le client le transmet au destinataire et reprend la recherche pour identifier le message approprié suivant à partir de la position en cours de la file d'attente. Le client continue la recherche jusqu'à ce qu'il atteigne la fin de la file d'attente ou que l'intervalle de temps indiqué par cette propriété arrive à expiration. Dans chaque cas, le client retourne au début de la file d'attente pour continuer sa recherche et un nouvel intervalle de temps commence.
secExitInitData Indique les données d'initialisation à transmettre à l'exit de sécurité.
secExit Indique un nom de classe d'exit de sécurité.
sendExitInitData Indique les données d'initialisation à transmettre à l'exit d'émission.
sendExit Indique la liste des noms de classe séparés par des virgules pour l'exit d'émission.
sparseSubs Indique les règles d'extraction des messages d'un objet abonné de sujet.
sslConfiguration Indique le nom de la configuration SSL utilisée pour sécuriser les connexions réseau au gestionnaire de files d'attente.
sslCrl Specifies a list of LDAP servers which can be used to provide certificate revocation information if this activation specification establishes an SSL connection to IBM MQ.
sslPeerName Indique une valeur à mettre en correspondance avec le nom distinctif présent dans le certificat de l'homologue. Cet attribut est utilisé lorsque la spécification d'activation établit une connexion SSL avec le gestionnaire de files d'attente.
sslResetCount Indique le nombre d'octets à transmettre avant de réinitialiser la clé de chiffrement symétrique pour la session SSL. Cet attribut est utilisé lorsque la spécification d'activation établit une connexion SSL avec le gestionnaire de files d'attente.
sslType Indique la configuration SSL utilisée pour la connexion réseau au gestionnaire de files d'attente.
startTimeout Indique la période, en millisecondes, pendant laquelle la distribution d'un message à un bean géré par message (MDB) doit commencer après la planification de la distribution de ce message. A l'issue de cette période, le message est renvoyé à la file d'attente.
stateRefreshInt Indique l'intervalle, en millisecondes, entre les régénérations de la transaction à exécution prolongée qui détecte si un abonné perd sa connexion établie avec le gestionnaire de files d'attente. Cet attribut n'est applicable que si l'attribut subStore a pour valeur QUEUE.
stopEndpointIfDeliveryFails Indique si le noeud final est arrêté quand la distribution des messages échoue le nombre de fois indiqué par l'attribut failureDeliveryCount.
subscriptionDurability Indique si un abonnement durable ou non durable est utilisé pour distribuer des messages à un bean géré par message abonné à ce sujet.
subscriptionName Indique le nom de l'abonnement durable.
subStore Specifies where IBM MQ JMS stores persistent data relating to active subscriptions.
wildcardFormat Indique les jeux de caractères qui doivent être interprétés comme caractères génériques dans les sujets.
wmqTransportType Specifies the manner in which, for this activation specification, a connection is established with IBM MQ. Les spécifications d'activation créées à l'aide de cet attribut sont définies par l'utilisateur. Les valeurs admises sont BINDINGS, BINDINGS_THEN_CLIENT et CLIENT.
localAddress Indique l'une des options suivantes ou les deux :
  • Interface de réseau local à utiliser
  • Port local ou plage de ports locaux à utiliser

Syntaxe

AdminJMS.createSIBJMSActivationSpec(scope,name, jndiName, 
 destinationJndiName, destinationType,attributes)

Exemple de syntaxe

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

AdminJMS.createSIBJMSActivationSpec("myScope", "myName", 
 "myJNDIName", "myDestinationName", "myDestinationType")
L'exemple de script suivant contient des attributs facultatifs fournis au format chaîne :
AdminJMS.createWMQActivationSpec
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName12", "myDestinationJndiName12", "javax.jms.Topic", "poolTimeout=2222,startTimeout=9999")

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

AdminJMS.createWMQActivationSpec
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", 
"myName" , "myJndiName12", "myDestinationJndiName12", "javax.jms.Topic", [['poolTimeout', '2222'], 
['startTimeout', '9999']])

startListenerPort

Ce script démarre un port d'écoute dans votre environnement. Le script renvoie la valeur 1 ou -1 selon, respectivement, la réussite ou l'échec du démarrage du port d'écoute par le système.

Pour exécuter le script, spécifiez le nom du noeud et du serveur en tant qu'arguments, comme défini dans le tableau ci-après :
Tableau 89. Arguments du script startListenerPort. Exécutez le script pour démarrer un port d'écoute.
Argument Description
nodeName Indique le nom du noeud qui vous intéresse.
serverName Indique le nom du serveur qui vous intéresse.

Syntaxe

AdminJMS.startListenerPort(nodeName, 
 serverName)

Exemple de syntaxe

AdminJMS.startListenerPort("myNode", "myServer")

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_7adminjms
Nom du fichier : rxml_7adminjms.html