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 .

- createGenericJMSConnectionFactory
- Script createGenericJMSConnectionFactoryUsingTemplate
- Script createGenericJMSConnectionFactoryAtScope
- Script createGenericJMSConnectionFactoryUsingTemplateAtScope
- Script createGenericJMSDestination
- Script createGenericJMSDestinationUsingTemplate
- Script createGenericJMSDestinationAtScope
- Script createGenericJMSDestinationUsingTemplateAtScope
- Script createJMSProvider
- Script createJMSProviderUsingTemplate
- Script createJMSProviderAtScope
- Script createJMSProviderUsingTemplateAtScope
- Script createWASQueue
- Script createWASQueueUsingTemplate
- Script createWASQueueAtScope
- Script createWASQueueUsingTemplateAtScope
- createSIBJMSQueue
- createWMQQueue
- Script createWASQueueConnectionFactory
- Script createWASQueueConnectionFactoryUsingTemplate
- Script createWASQueueConnectionFactoryAtScope
- Script createWASQueueConnectionFactoryUsingTemplateAtScope
- Script createWASTopic
- Script createWASTopicUsingTemplate
- Script createWASTopicAtScope
- Script createWASTopicUsingTemplateAtScope
- createSIBJMSTopic
- createWMQTopic
- createWASTopicConnectionFactory
- Script createWASTopicConnectionFactoryUsingTemplate
- Script createWASTopicConnectionFactoryAtScope
- Script createWASTopicConnectionFactoryUsingTemplateAtScope
- createSIBJMSConnectionFactory
- createWMQConnectionFactory
- createSIBJMSQueueConnectionFactory
- createWMQQueueConnectionFactory
- createSIBJMSTopicConnectionFactory
- createWMQTopicConnectionFactory
- createSIBJMSActivationSpec
- createWMQActivationSpec
- startListenerPort
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.
Portée | Chemin d'imbrication | ID configuration | Type |
---|---|---|---|
Cell | /Cell:myCell/ |
|
Cell=myCell ou cell=myCell |
Noeud | /Cell:myCell/Node:myNode/ ou /Node:myNode/ |
|
ou
ou
|
Serveur |
ou
|
|
ou
or
|
Cluster |
or
|
|
or
or
|
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
XAEnabled | Spécifie si le traitement de la restauration XA est activée. |
|
authDataAlias | Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution. |
|
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. |
|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
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. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
diagnoseConnectionUsage | Indique si le diagnostic de l'utilisation des connexions est activé. |
|
logMissingTransactionContext | Spécifie si la journalisation du contexte des transactions manquantes est activée ou non. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
XAEnabled | Spécifie si le traitement de la restauration XA est activée. |
|
authDataAlias | Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution. |
|
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. |
|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
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. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
diagnoseConnectionUsage | Indique si le diagnostic de l'utilisation des connexions est activé. |
|
logMissingTransactionContext | Spécifie si la journalisation du contexte des transactions manquantes est activée ou non. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
XAEnabled | Spécifie si le traitement de la restauration XA est activée. |
|
authDataAlias | Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution. |
|
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. |
|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
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. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
diagnoseConnectionUsage | Indique si le diagnostic de l'utilisation des connexions est activé. |
|
logMissingTransactionContext | Spécifie si la journalisation du contexte des transactions manquantes est activée ou non. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
XAEnabled | Spécifie si le traitement de la restauration XA est activée. |
|
authDataAlias | Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution. |
|
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. |
|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
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. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
diagnoseConnectionUsage | Indique si le diagnostic de l'utilisation des connexions est activé. |
|
logMissingTransactionContext | Spécifie si la journalisation du contexte des transactions manquantes est activée ou non. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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")
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 :
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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")
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 :
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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")
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 :
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.
|
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. |
|
description | Fournit une description du fournisseur JMS. |
|
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.
|
|
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 (;). |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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")
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 :
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.
|
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. |
|
description | Fournit une description du fournisseur JMS. |
|
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.
|
|
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 (;). |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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")
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")
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 :
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.
|
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. |
|
description | Fournit une description du fournisseur JMS. |
|
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.
|
|
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 (;). |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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")
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 :
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.
|
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. |
|
description | Fournit une description du fournisseur JMS. |
|
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.
|
|
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 (;). |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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")
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")
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 :
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
persistence | Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT. |
|
priority | Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et 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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
specifiedExpiry | Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés. |
|
specifiedPriority | Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
persistence | Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT. |
|
priority | Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et 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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
specifiedExpiry | Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés. |
|
specifiedPriority | Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9. |
|
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")
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 :
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
persistence | Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT. |
|
priority | Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et 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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
specifiedExpiry | Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés. |
|
specifiedPriority | Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
persistence | Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT. |
|
priority | Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et 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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
specifiedExpiry | Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés. |
|
specifiedPriority | Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9. |
|
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")
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.
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.
|
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")
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.
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.
|
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")
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 :
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.
|
Attributs | Description | Exemple |
---|---|---|
XAEnabled | Spécifie si le traitement de la restauration XA est activée. |
|
authDataAlias | Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution. |
|
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. |
|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
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. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
diagnoseConnectionUsage | Indique si le diagnostic de l'utilisation des connexions est activé. |
|
logMissingTransactionContext | Spécifie si la journalisation du contexte des transactions manquantes est activée ou non. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
XAEnabled | Spécifie si le traitement de la restauration XA est activée. |
|
authDataAlias | Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution. |
|
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. |
|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
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. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
diagnoseConnectionUsage | Indique si le diagnostic de l'utilisation des connexions est activé. |
|
logMissingTransactionContext | Spécifie si la journalisation du contexte des transactions manquantes est activée ou non. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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. |
|
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")
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 :
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.
|
Attributs | Description | Exemple |
---|---|---|
XAEnabled | Spécifie si le traitement de la restauration XA est activée. |
|
authDataAlias | Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution. |
|
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. |
|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
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. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
diagnoseConnectionUsage | Indique si le diagnostic de l'utilisation des connexions est activé. |
|
logMissingTransactionContext | Spécifie si la journalisation du contexte des transactions manquantes est activée ou non. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
XAEnabled | Spécifie si le traitement de la restauration XA est activée. |
|
authDataAlias | Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution. |
|
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. |
|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
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. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
diagnoseConnectionUsage | Indique si le diagnostic de l'utilisation des connexions est activé. |
|
logMissingTransactionContext | Spécifie si la journalisation du contexte des transactions manquantes est activée ou non. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
persistence | Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT. |
|
priority | Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et 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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
specifiedExpiry | Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés. |
|
specifiedPriority | Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
persistence | Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT. |
|
priority | Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et 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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
specifiedExpiry | Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés. |
|
specifiedPriority | Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9. |
|
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")
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”)
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
persistence | Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT. |
|
priority | Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et 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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
specifiedExpiry | Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés. |
|
specifiedPriority | Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
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. |
|
persistence | Indique le niveau de persistance. Les valeurs possibles sont APPLICATION_DEFINED, NONPERSISTENT et PERSISTENT. |
|
priority | Indique le niveau de priorité. Les valeurs possibles sont APPLICATION_DEFINED et 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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
specifiedExpiry | Indique le délai en millisecondes au-delà duquel les messages de cette file d'attente sont supprimés. |
|
specifiedPriority | Indique le niveau de priorité de la file d'attente WebSphere WASQueue par une valeur comprise entre 0 et 9. |
|
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")
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”)
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éé.
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.
|
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")
AdminJMS.createSIBJMSTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)", "myName" ,
"myJndiName9", "readAhead=AlwaysOff,timeToLive=6")
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.
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.
|
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")
AdminJMS.createWMQTopic
("server1(cells/avmoghe01Cell02/nodes/avmoghe01Node02/servers/server1|server.xml#Server_1237476439906)",
"myName" , "myJndiName10", "myTopicName10", "readAhead=YES,sendAsync=NO")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
XAEnabled | Spécifie si le traitement de la restauration XA est activée. |
|
authDataAlias | Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution. |
|
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. |
|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
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. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
diagnoseConnectionUsage | Indique si le diagnostic de l'utilisation des connexions est activé. |
|
logMissingTransactionContext | Spécifie si la journalisation du contexte des transactions manquantes est activée ou non. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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. |
|
Attributs | Description | Exemple |
---|---|---|
ICclient | Indique l'ID du client. |
|
cloneSupport | Indique si la fabrique de connexions de sujet WebSphere est prise en charge entre des clones. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
XAEnabled | Spécifie si le traitement de la restauration XA est activée. |
|
authDataAlias | Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution. |
|
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. |
|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
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. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
diagnoseConnectionUsage | Indique si le diagnostic de l'utilisation des connexions est activé. |
|
logMissingTransactionContext | Spécifie si la journalisation du contexte des transactions manquantes est activée ou non. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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.
|
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. |
|
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")
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.
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.
|
Attributs | Description | Exemple |
---|---|---|
XAEnabled | Spécifie si le traitement de la restauration XA est activée. |
|
authDataAlias | Indique l'alias utilisé pour effectuer l'authentification dans la base de données lors de l'exécution. |
|
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. |
|
catégorie | Indique la catégorie que vous pouvez utiliser pour classifier ou grouper la ressource. |
|
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. |
|
description | Fournit une description de l'adaptateur de ressource. |
|
diagnoseConnectionUsage | Indique si le diagnostic de l'utilisation des connexions est activé. |
|
logMissingTransactionContext | Spécifie si la journalisation du contexte des transactions manquantes est activée ou non. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
providerType | Indique le type de fournisseur JMS de ce fournisseur JMS. |
|
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. |
|
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. |
|
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. |
|
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")
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.
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.
|
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")
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.
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.
|
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 :
|
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")
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.
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.
|
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")
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.
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.
|
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 :
|
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")
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.
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.
|
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")
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.
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.
|
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 :
|
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")
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.
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.
|
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")
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.
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.
|
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 :
|
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")
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.
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")