JMS 配置脚本

此脚本编制库提供许多脚本过程来管理 Java™ 消息服务 (JMS) 配置。请参阅有关用于查询 JMS 配置的脚本的用法信息。您可以单独运行每个脚本,也可以组合许多过程以创建环境的定制自动化脚本。

每个 AdminJMS 管理脚本过程位于 app_server_root/scriptLibraries/resources/JMS/V70 目录中。

从 V7 开始,Jython 脚本库在服务器作用域为 JDBC 提供程序、JMS 资源和资源提供程序提供了脚本功能。可以在单元、节点或集群级别编写您自己的定制脚本来配置资源。
避免故障 避免故障: 请不要编辑脚本库中的脚本过程。要编写定制脚本库过程,请将 app_server_root/scriptLibraries 目录中的脚本用作 Jython 语法样本。请将定制脚本保存到新的子目录中,以避免覆盖脚本库。gotcha
捷径: 从 FP5 开始,Jython 脚本库在单元、节点、服务器或集群作用域为 JDBC 提供程序、JMS 资源以及资源提供程序提供了脚本功能。资源提供程序包括邮件提供程序、URL 提供程序和资源环境提供程序。不必在特定作用域编写定制脚本来配置资源。
注意: 为打印方便,用法示例脚本和脚本语法被拆分为多行。

作用域参数的格式

作用域格式应用于脚本库中具有该作用域参数的脚本。

在节点、服务器和集群作用域上,单元是可选的。在服务器作用域上,节点是必需的。

可以使用逗号 (,) 或分号 (:) 来定界类型。可以使用小写表示类型(cell=、node=、server= 或 cluster=)。

为了方便发布,下表中的示例分布在多行上。

表 1. 特定作用域的包含路径、配置标识和类型示例. 作用域可以是单元、节点、服务器或集群。
作用域 包含路径 配置标识 类型
单元 /Cell:myCell/
myCell(cells/myCell|
cell.xml#Cell_1)
Cell=myCell 或 cell=myCell
节点 /Cell:myCell/Node:myNode/ 或 /Node:myNode/
myNode(cells/myCell
/nodes/myNode|
node.xml#Node_1)
Cell=myCell,
Node=myNode
Cell=myCell:
Node=myNode
cell=myCell,
node=myNode
Server
/Cell:myCell/Node:
myNode/
Server:myServer/
/Node:myNode/Server:
myServer/
myServer(cells
/myCell/
nodes/myNode/
servers/myServer|
server.xml#Server_1)
Cell=myCell,
Node=myNode,
Server=myServer
Node=myNode:
Server=myServer
cell=myCell,
Node=myNode,
Server=myServer
集群
/Cell:myCell/
ServerCluster:
myCluster/
/ServerCluster:
myCluster/
myCluster(cells
/myCell/clusters/
myCluster|
cluster.xml
#ServerCluster_1)
Cell=myCell,
Cluster=myCluster
Cell=myCell:
Cluster=myCluster
cell=myCell,
Cluster=myCluster

createGenericJMSConnectionFactory

此脚本会在配置中创建新的通用 JMS 连接工厂。此脚本会返回在各自单元中创建的 JMS 连接工厂的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、新连接工厂的名称、JNDI 名称以及外部 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 2. createGenericJMSConnectionFactory 脚本的参数. 运行脚本来创建常规 JMS 连接工厂。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProvider 指定 JMS 提供程序的名称。
connFactoryName 指定要分配给新连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
extJndiName 指定用于将队列绑定到应用程序服务器名称空间的 JNDI 名称。按约定,使用标准 JNDI 名称;例如,格式为 jms/Name,其中 Name 是资源的逻辑名称。该名称用于链接平台绑定信息。绑定使模块部署描述符定义的资源与由平台绑定到 JNDI 的实际(物理)资源相关联。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 3. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
XAEnabled 指定是否启用 XA 恢复处理。
['XAEnabled', 'false']
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['authMechanismPreference', 
'BASIC_PASSWORD']
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JMS 连接工厂实例的 JMS 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description 指定资源适配器的描述。
['description', 'My description']
diagnoseConnectionUsage 指定是否启用连接使用诊断。
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'true']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'true']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
sessionPool 指定父 JMS 连接实例的 JMS 会话池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['xaRecoveryAuthAlias', 'myCellManager01/a1']
表 4. 可选属性(续). 可用于脚本的其他属性。
属性 描述 示例
type 指定 QUEUE(用于队列)、TOPIC(用于主题)以及 UNIFIED(同时用于队列和主题)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['type', 'TOPIC']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createGenericJMSConnectionFactoryUsingTemplate

此脚本会使用模板在配置中创建通用 JMS 连接工厂。此脚本会返回在各自单元中使用模板来创建的 JMS 连接工厂的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、模板标识、连接工厂名称、JNDI 名称以及外部 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 5. createGenericJMSConnectionFactoryUsingTemplate 脚本的参数. 运行脚本来创建常规 JMS 连接工厂。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProvider 指定 JMS 提供程序的名称。
templateID 指定要使用的模板的配置标识。
connFactoryName 指定要分配给新连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
extJndiName 指定用于将队列绑定到应用程序服务器名称空间的 JNDI 名称。按约定,使用标准 JNDI 名称;例如,格式为 jms/Name,其中 Name 是资源的逻辑名称。该名称用于链接平台绑定信息。绑定使模块部署描述符定义的资源与由平台绑定到 JNDI 的实际(物理)资源相关联。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 6. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
XAEnabled 指定是否启用 XA 恢复处理。
['XAEnabled', 'false']
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['authMechanismPreference', 
'BASIC_PASSWORD']
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JMS 连接工厂实例的 JMS 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description 指定资源适配器的描述。
['description', 'My description']
diagnoseConnectionUsage 指定是否启用连接使用诊断。
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'true']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'true']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
sessionPool 指定父 JMS 连接实例的 JMS 会话池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['xaRecoveryAuthAlias', 'myCellManager01/a1']
表 7. 可选属性(续). 可用于脚本的其他属性。
属性 描述 示例
type 指定 QUEUE(用于队列)、TOPIC(用于主题)以及 UNIFIED(同时用于队列和主题)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['type', 'TOPIC']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createGenericJMSConnectionFactoryAtScope

此脚本会在配置中您所指定的作用域内创建新的通用 JMS 连接工厂。此脚本会返回在各自单元中创建的 JMS 连接工厂的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、新连接工厂的名称、JNDI 名称以及外部 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 8. createGenericJMSConnectionFactoryAtScope 脚本的参数. 运行脚本来创建常规 JMS 连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
jmsProvider 指定 JMS 提供程序的名称。
connFactoryName 指定要分配给新连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
extJndiName 指定用于将队列绑定到应用程序服务器名称空间的 JNDI 名称。按约定,使用标准 JNDI 名称;例如,格式为 jms/Name,其中 Name 是资源的逻辑名称。该名称用于链接平台绑定信息。绑定使模块部署描述符定义的资源与由平台绑定到 JNDI 的实际(物理)资源相关联。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 9. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
XAEnabled 指定是否启用 XA 恢复处理。
['XAEnabled', 'false']
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['authMechanismPreference', 
'BASIC_PASSWORD']
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JMS 连接工厂实例的 JMS 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description 指定资源适配器的描述。
['description', 'My description']
diagnoseConnectionUsage 指定是否启用连接使用诊断。
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'true']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'true']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
sessionPool 指定父 JMS 连接实例的 JMS 会话池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['xaRecoveryAuthAlias', 'myCellManager01/a1']
表 10. 可选属性(续). 可用于脚本的其他属性。
属性 描述 示例
type 指定 QUEUE(用于队列)、TOPIC(用于主题)以及 UNIFIED(同时用于队列和主题)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['type', 'TOPIC']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createGenericJMSConnectionFactoryUsingTemplateAtScope

此脚本会使用模板在配置中您所指定的作用域内创建通用 JMS 连接工厂。此脚本会返回在各自单元中使用模板来创建的 JMS 连接工厂的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、模板标识、连接工厂名称、JNDI 名称以及外部 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 11. createGenericJMSConnectionFactoryUsingTemplateAtScope 脚本的参数. 运行脚本来创建常规 JMS 连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
jmsProvider 指定 JMS 提供程序的名称。
templateID 指定要使用的模板的配置标识。
connFactoryName 指定要分配给新连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
extJndiName 指定用于将队列绑定到应用程序服务器名称空间的 JNDI 名称。按约定,使用标准 JNDI 名称;例如,格式为 jms/Name,其中 Name 是资源的逻辑名称。该名称用于链接平台绑定信息。绑定使模块部署描述符定义的资源与由平台绑定到 JNDI 的实际(物理)资源相关联。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 12. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
XAEnabled 指定是否启用 XA 恢复处理。
['XAEnabled', 'false']
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['authMechanismPreference', 
'BASIC_PASSWORD']
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JMS 连接工厂实例的 JMS 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description 指定资源适配器的描述。
['description', 'My description']
diagnoseConnectionUsage 指定是否启用连接使用诊断。
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'true']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'true']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
sessionPool 指定父 JMS 连接实例的 JMS 会话池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['xaRecoveryAuthAlias', 'myCellManager01/a1']
表 13. 可选属性(续). 可用于脚本的其他属性。
属性 描述 示例
type 指定 QUEUE(用于队列)、TOPIC(用于主题)以及 UNIFIED(同时用于队列和主题)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['type', 'TOPIC']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createGenericJMSDestination

此脚本会在配置中创建通用 JMS 目标。此脚本会返回在各自单元中创建的 JMS 目标的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、JMS 目标名称、JNDI 名称以及外部 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 14. createGenericJMSDestination 脚本的参数. 运行脚本来创建常规 JMS 目标。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProvider 指定 JMS 提供程序的名称。
genericJMSDestination 指定要分配给新通用 JMS 目标的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
extJndiName 指定用于将队列绑定到应用程序服务器名称空间的 JNDI 名称。按约定,使用标准 JNDI 名称;例如,格式为 jms/Name,其中 Name 是资源的逻辑名称。该名称用于链接平台绑定信息。绑定使模块部署描述符定义的资源与由平台绑定到 JNDI 的实际(物理)资源相关联。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 15. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] [[name driverType]
[type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
type 指定 QUEUE(用于队列)、TOPIC(用于主题)以及 UNIFIED(同时用于队列和主题)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['type', 'QUEUE']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createGenericJMSDestinationUsingTemplate

此脚本会使用模板在配置中创建通用 JMS 目标。此脚本会返回在各自单元中创建的 JMS 目标的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、模板标识、通用 JMS 目标名称、JNDI 名称以及外部 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:

表 16. createGenericJMSDestinationUsingTemplate 脚本的参数. 运行脚本来创建常规 JMS 目标。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProvider 指定 JMS 提供程序的名称。
templateID 指定要使用的模板的配置标识。
genericJMSDestination 指定要分配给新通用 JMS 目标的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
extJndiName 指定用于将队列绑定到应用程序服务器名称空间的 JNDI 名称。按约定,使用标准 JNDI 名称;例如,格式为 jms/Name,其中 Name 是资源的逻辑名称。该名称用于链接平台绑定信息。绑定使模块部署描述符定义的资源与由平台绑定到 JNDI 的实际(物理)资源相关联。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 17. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] [[name driverType]
[type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
type 指定 QUEUE(用于队列)、TOPIC(用于主题)以及 UNIFIED(同时用于队列和主题)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['type', 'QUEUE']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createGenericJMSDestinationAtScope

此脚本会在配置中您所指定的作用域内创建通用 JMS 目标。此脚本会返回在各自单元中创建的 JMS 目标的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、JMS 目标名称、JNDI 名称以及外部 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 18. createGenericJMSDestinationAtScope 脚本的参数. 运行脚本来创建常规 JMS 目标。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
serverName 指定相关服务器的名称。
jmsProvider 指定 JMS 提供程序的名称。
genericJMSDestination 指定要分配给新通用 JMS 目标的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
extJndiName 指定用于将队列绑定到应用程序服务器名称空间的 JNDI 名称。按约定,使用标准 JNDI 名称;例如,格式为 jms/Name,其中 Name 是资源的逻辑名称。该名称用于链接平台绑定信息。绑定使模块部署描述符定义的资源与由平台绑定到 JNDI 的实际(物理)资源相关联。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 19. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] [[name driverType]
[type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
type 指定 QUEUE(用于队列)、TOPIC(用于主题)以及 UNIFIED(同时用于队列和主题)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['type', 'QUEUE']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createGenericJMSDestinationUsingTemplateAtScope

此脚本会使用模板在配置中您所指定的作用域内创建通用 JMS 目标。此脚本会返回在各自单元中创建的 JMS 目标的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、模板标识、通用 JMS 目标名称、JNDI 名称以及外部 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:

表 20. createGenericJMSDestinationUsingTemplateAtScope 脚本的参数. 运行脚本来创建常规 JMS 目标。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
serverName 指定相关服务器的名称。
jmsProvider 指定 JMS 提供程序的名称。
templateID 指定要使用的模板的配置标识。
genericJMSDestination 指定要分配给新通用 JMS 目标的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
extJndiName 指定用于将队列绑定到应用程序服务器名称空间的 JNDI 名称。按约定,使用标准 JNDI 名称;例如,格式为 jms/Name,其中 Name 是资源的逻辑名称。该名称用于链接平台绑定信息。绑定使模块部署描述符定义的资源与由平台绑定到 JNDI 的实际(物理)资源相关联。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 21. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] [[name driverType]
[type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
type 指定 QUEUE(用于队列)、TOPIC(用于主题)以及 UNIFIED(同时用于队列和主题)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['type', 'QUEUE']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createJMSProvider

此脚本会在配置中创建 JMS 提供程序。此脚本会返回在各自单元中创建的 JMS 提供程序的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、外部初始上下文工厂名称以及外部提供程序 URL 参数。可选择性地指定属性。在以下各表中定义了参数和属性:

表 22. createJMSProvider 脚本的参数. 运行脚本来创建 JMS 提供程序。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProvider 指定要分配给新 JMS 提供程序的名称。
extContextFactory 为 JMS 提供程序指定初始上下文工厂的 Java 类名。
extProviderURL 指定用于外部 JNDI 查询的 JMS 提供程序 URL。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 23. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
classpath 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。
'-classpath', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description 指定 JMS 提供程序的描述。
['description', 'My description']
isolatedClassLoader 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。
注意: 当指定了本机库路径时,无法隔离提供程序。
['isolatedClassLoader', 'true']
nativepath 指定任何本机库(例如,*.dll*.so)的可选路径。使用分号 (;) 来分隔本机路径条目。
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] 
]]]]
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
supportsASF 如果设置为 true,那么指定 JMS 提供程序支持应用程序服务器工具 (ASF),而 ASF 会为应用程序提供并行和事务支持。
['supportsASF', 'true']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createJMSProviderUsingTemplate

此脚本会使用模板在配置中创建 JMS 提供程序。此脚本会返回在各自单元中使用模板来创建的 JMS 提供程序的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序模板的配置标识、要分配给新 JMS 提供程序的名称、外部初始上下文工厂以及外部提供程序 URL 参数。可选择性地指定属性。在以下各表中定义了参数和属性:

表 24. createJMSProviderUsingTemplate 脚本的参数. 运行脚本来创建 JMS 提供程序。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
templateID 指定要使用的 JMS 提供程序模板的配置标识。
jmsProvider 指定要分配给新 JMS 提供程序的名称。
extContextFactory 为 JMS 提供程序指定初始上下文工厂的 Java 类名。
extProviderURL 指定用于外部 JNDI 查询的 JMS 提供程序 URL。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 25. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
classpath 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。
'-classpath', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description 指定 JMS 提供程序的描述。
['description', 'My description']
isolatedClassLoader 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。
注意: 当指定了本机库路径时,无法隔离提供程序。
['isolatedClassLoader', 'true']
nativepath 指定任何本机库(例如,*.dll*.so)的可选路径。使用分号 (;) 来分隔本机路径条目。
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] 
]]]]
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
supportsASF 如果设置为 true,那么指定 JMS 提供程序支持应用程序服务器工具 (ASF),而 ASF 会为应用程序提供并行和事务支持。
['supportsASF', 'true']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

createJMSProviderAtScope

此脚本会在配置中您所指定的作用域内创建 JMS 提供程序。此脚本会返回在各自单元中创建的 JMS 提供程序的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、外部初始上下文工厂名称以及外部提供程序 URL 参数。可选择性地指定属性。在以下各表中定义了参数和属性:

表 26. createJMSProviderAtScope 脚本的参数. 运行脚本来创建 JMS 提供程序。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
jmsProvider 指定要分配给新 JMS 提供程序的名称。
extContextFactory 为 JMS 提供程序指定初始上下文工厂的 Java 类名。
extProviderURL 指定用于外部 JNDI 查询的 JMS 提供程序 URL。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 27. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
classpath 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。
'-classpath', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description 指定 JMS 提供程序的描述。
['description', 'My description']
isolatedClassLoader 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。
注意: 当指定了本机库路径时,无法隔离提供程序。
['isolatedClassLoader', 'true']
nativepath 指定任何本机库(例如,*.dll*.so)的可选路径。使用分号 (;) 来分隔本机路径条目。
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] 
]]]]
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
supportsASF 如果设置为 true,那么指定 JMS 提供程序支持应用程序服务器工具 (ASF),而 ASF 会为应用程序提供并行和事务支持。
['supportsASF', 'true']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createJMSProviderUsingTemplateAtScope

此脚本会使用模板在您所指定的作用域内创建 JMS 提供程序。此脚本会返回在各自单元中使用模板来创建的 JMS 提供程序的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序模板的配置标识、要分配给新 JMS 提供程序的名称、外部初始上下文工厂以及外部提供程序 URL 参数。可选择性地指定属性。在以下各表中定义了参数和属性:

表 28. createJMSProviderUsingTemplateAtScope 脚本的参数. 运行脚本来创建 JMS 提供程序。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
templateID 指定要使用的 JMS 提供程序模板的配置标识。
jmsProvider 指定要分配给新 JMS 提供程序的名称。
extContextFactory 为 JMS 提供程序指定初始上下文工厂的 Java 类名。
extProviderURL 指定用于外部 JNDI 查询的 JMS 提供程序 URL。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 29. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
classpath 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。
'-classpath', 
'${EXTERNAL_JMSPROVIDER_CLASSPATH}/extJms.jar'
description 指定 JMS 提供程序的描述。
['description', 'My description']
isolatedClassLoader 如果设置为 true,那么指定将资源提供程序装入其自己的类装入器中。
注意: 当指定了本机库路径时,无法隔离提供程序。
['isolatedClassLoader', 'true']
nativepath 指定任何本机库(例如,*.dll*.so)的可选路径。使用分号 (;) 来分隔本机路径条目。
'-nativePath', 
'${EXTERNAL_JMSPROVIDER_NATIVEPATH}'
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] 
]]]]
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
supportsASF 如果设置为 true,那么指定 JMS 提供程序支持应用程序服务器工具 (ASF),而 ASF 会为应用程序提供并行和事务支持。
['supportsASF', 'true']

语法

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

用法示例

以下示例脚本仅包含必需属性:

AdminJMS.createJMSProviderUsingTemplateAtScope("myScope", "WebSphere JMS 
 Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#builtin_jmsprovider)", 
 "JMSTest", "extInitCF", "extPURL")
以下示例脚本包含字符串格式的可选属性:
AdminJMS. 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']] )

createWASQueue

此脚本会在配置中创建 WebSphere Application Server 队列。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本会返回在各自单元中创建的 WebSphere Application Server 队列的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、要分配给队列的名称以及 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:

表 30. createWASQueue 脚本的参数. 运行脚本来创建队列。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProvider 指定相关 JMS 提供程序的名称。
queueName 指定要分配给新队列的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 31. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
expiry 指定在多长时间后,发送到此目标的消息会到期并根据消息处置选项进行处理。有效值为 APPLICATION_DEFINESPECIFIED 以及 UNLIMITED

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['expiry', 'SPECIFIED']
persistence 指定持久性的级别。有效值为 APPLICATION_DEFINEDNONPERSISTENT 以及 PERSISTENT
['persistence', 'NONPERSISTENT']
priority 指定优先级。有效值为 APPLICATION_DEFINEDSPECIFIED
['priority', 'SPECIFIED']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问特定供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
specifiedExpiry 指定在废弃此队列上的消息以前所耗用的时间(以毫秒计)。
['specifiedExpiry', '1000']
specifiedPriority 指定 WASQueue WebSphere 队列的优先级(从 0 到 9)。
['specifiedPriority', '0']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASQueueUsingTemplate

此脚本使用模板在配置中创建 WebSphere Application Server 队列。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本返回在各自单元中使用模板来创建的 WebSphere Application Server 队列的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、模板的配置标识、要分配给队列的名称以及 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 32. createWASQueueUsingTemplate 脚本的参数. 运行脚本来创建队列。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProvider 指定相关 JMS 提供程序的名称。
templateID 指定要使用的 WebSphere Application Server 队列模板的配置标识。
queueName 指定要分配给新队列的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 33. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
expiry 指定在多长时间后,发送到此目标的消息会到期并根据消息处置选项进行处理。有效值为 APPLICATION_DEFINESPECIFIED 以及 UNLIMITED

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['expiry', 'SPECIFIED']
persistence 指定持久性的级别。有效值为 APPLICATION_DEFINEDNONPERSISTENT 以及 PERSISTENT
['persistence', 'NONPERSISTENT']
priority 指定优先级。有效值为 APPLICATION_DEFINEDSPECIFIED
['priority', 'SPECIFIED']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问特定供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
specifiedExpiry 指定在废弃此队列上的消息以前所耗用的时间(以毫秒计)。
['specifiedExpiry', '1000']
specifiedPriority 指定 WASQueue WebSphere 队列的优先级(从 0 到 9)。
['specifiedPriority', '0']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASQueueAtScope

此脚本在配置中所指定作用域内创建 WebSphere Application Server 队列。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本会返回在各自单元中创建的 WebSphere Application Server 队列的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、要分配给队列的名称以及 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:

表 34. createWASQueueAtScope 脚本的参数. 运行脚本来创建队列。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
jmsProvider 指定相关 JMS 提供程序的名称。
queueName 指定要分配给新队列的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 35. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
expiry 指定在多长时间后,发送到此目标的消息会到期并根据消息处置选项进行处理。有效值为 APPLICATION_DEFINESPECIFIED 以及 UNLIMITED

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['expiry', 'SPECIFIED']
persistence 指定持久性的级别。有效值为 APPLICATION_DEFINEDNONPERSISTENT 以及 PERSISTENT
['persistence', 'NONPERSISTENT']
priority 指定优先级。有效值为 APPLICATION_DEFINEDSPECIFIED
['priority', 'SPECIFIED']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问特定供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
specifiedExpiry 指定在废弃此队列上的消息以前所耗用的时间(以毫秒计)。
['specifiedExpiry', '1000']
specifiedPriority 指定 WASQueue WebSphere 队列的优先级(从 0 到 9)。
['specifiedPriority', '0']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASQueueUsingTemplateAtScope

此脚本使用模板在配置中您所指定的作用域内创建 WebSphere Application Server 队列。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本返回在各自单元中使用模板来创建的 WebSphere Application Server 队列的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、模板的配置标识、要分配给队列的名称以及 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 36. createWASQueueUsingTemplateAtScope 脚本的参数. 运行脚本来创建队列。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
jmsProvider 指定相关 JMS 提供程序的名称。
templateID 指定要使用的 WebSphere Application Server 队列模板的配置标识。
queueName 指定要分配给新队列的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 37. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
expiry 指定在多长时间后,发送到此目标的消息会到期并根据消息处置选项进行处理。有效值为 APPLICATION_DEFINESPECIFIED 以及 UNLIMITED

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['expiry', 'SPECIFIED']
persistence 指定持久性的级别。有效值为 APPLICATION_DEFINEDNONPERSISTENT 以及 PERSISTENT
['persistence', 'NONPERSISTENT']
priority 指定优先级。有效值为 APPLICATION_DEFINEDSPECIFIED
['priority', 'SPECIFIED']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问特定供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
specifiedExpiry 指定在废弃此队列上的消息以前所耗用的时间(以毫秒计)。
['specifiedExpiry', '1000']
specifiedPriority 指定 WASQueue WebSphere 队列的优先级(从 0 到 9)。
['specifiedPriority', '0']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

此脚本在配置中您所指定的作用域内创建 JMS 队列。此脚本返回所创建 SIB JMS 队列的配置标识。

要运行此脚本,请指定作用域、JMS 队列名称、要分配给队列的名称以及 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 38. createSIBJMSQueue 脚本的参数. 运行脚本来创建 JMS 队列。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
name 指定相关 JMS 队列的名称。
queueName 指定 JMS 队列映射至的服务集成总线目标的名称。
jndiName 指定系统用于将队列绑定到应用程序服务器名称空间的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 39. 可选属性. 脚本的其他属性。
属性 描述
description 指定 SIB JMS 队列的描述。
DeliveryMode 指定消息的交付方式。有效值为 ApplicationNonPersistentPersistent
timeToLive 指定消息到期之前的时间(以毫秒计)。
priority 指定消息的优先级。有效值为从 0 到 9(含)的整数。
readAhead 指定预读值。有效值为 DefaultAlwaysOnAlwaysOff
busName 指定队列所在的总线的名称。
ScopeToLocalQP 指定使用此 JMS 队列寻址时,SIB 队列目标的作用域是否限定为本地队列点。
ProducerBind 指定 JMS 生产者如何绑定至集群队列的队列点。值 TRUE 指示在会话打开时选择了队列点且从不更改。值 FALSE 指示在每次发送消息时选择队列点。
ProducerPreferLocal 指定是否使用了生产者的本地队列点。
GatherMessages 指定是否将来自任何队列点的消息(而不是来自其连接至的单个队列点的消息)给予 JMS 使用者和浏览器。

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWMQQueue

此脚本在所指定作用域中为 IBM MQ 消息传递提供程序创建队列类型目标。此脚本返回所创建 IBM MQ 队列的配置标识。

要运行此脚本,请指定作用域、队列类型目标的名称、要分配给队列的名称以及 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 40. createWMQQueue 脚本的参数. 运行脚本来创建队列类型目标。
自变量 描述
scope IBM MQ 消息传递提供程序指定单元、节点、服务器或集群的作用域
name 指定 IBM MQ 消息传递提供程序队列类型目标的名称。
queueName 指定用于存储 IBM MQ 队列的名称,该队列用于存储 IBM MQ 消息传递提供程序的队列类型目标定义的消息。
jndiName 指定用于将此对象绑定到 WebSphere Application Server JNDI 的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 41. 可选属性. 可用于脚本的其他属性。
属性 描述
ccsid 指定编码字符集标识。
decimalEncoding 指定此队列的十进制编码设置。有效值为 NormalReversed
description 指定要与此 IBM MQ JMS 队列类型目标关联的管理描述。
expiry 指定在多长时间后,发送到此目标的消息会到期并根据消息处置选项进行处理。有效值为 APPUNLIM 或任何正整数。
floatingPointEncoding 指定此队列的浮点编码设置。有效值为 IEEENormalIEEEReversedz/OS
integerEncoding 指定此队列的整数编码设置。有效值为 NormalReversed
persistence 指定用来存储发送至此目标的消息的持久性级别。有效值为 APP, QDEF, PERS, NONHIGH
priority 指定要分配给发送到此目标的消息的优先级别。有效值为 APP, QDEF, 0, 1, 2, 3, 4, 5, 6, 7, 8,9
qmgr 指定 IBM MQ 队列所在的队列管理器。
readAheadClose 指定在关闭异步接收消息的消息使用者时发生的行为。消息使用者使用来自目标的消息侦听器,该消息侦听器将 readAhead 参数设置为 true。指定了值 DELIVERALL 时,关闭方法调用等到所有预读消息都传递到使用者,然后将其关闭。指定值 DELIVERCURRENT 时,close() 方法仅等待任何正在进行的传递结束,然后关闭使用者。有效值为 DELIVERALLDELIVERCURRENT
readAhead 指定是否可以预读和高速缓存非持久性使用者的消息。有效值为 YES, NOQDEF
sendAsync 指定是否可以将消息发送到此目标,而无需队列管理器确认其已到达。有效值为 YES, NOQDEF
useRFH2 指定 RFH V2 头是否会附加到发送至此目标的消息上。有效值为 truefalse
useNativeEncoding 指定此队列的本机编码设置。

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASQueueConnectionFactory

此脚本在配置中创建 WebSphere Application Server 队列连接工厂。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本会返回在各自单元中创建的 WebSphere Application Server 队列连接工厂的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、要分配给队列连接工厂的名称以及 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:

表 42. createWASQueueConnectionFactory 脚本的参数. 运行脚本来创建队列连接工厂。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProvider 指定相关 JMS 提供程序的名称。
queueConnFactoryName 指定要分配给新的 WebSphere Application Server 队列连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 43. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
XAEnabled 指定是否启用 XA 恢复处理。
['XAEnabled', 'false']
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['authMechanismPreference', 
'BASIC_PASSWORD']
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JMS 连接工厂实例的 JMS 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description 指定资源适配器的描述。
['description', 'My description']
diagnoseConnectionUsage 指定是否启用连接使用诊断。
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'true']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'true']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
sessionPool 指定父 JMS 连接实例的 JMS 会话池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['xaRecoveryAuthAlias', 'myCellManager01/a1']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASQueueConnectionFactoryUsingTemplate

此脚本使用模板在配置中创建 WebSphere Application Server 队列连接工厂。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本返回在各自单元中使用模板来创建的 WebSphere Application Server 队列连接工厂的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、模板的配置标识、要分配给队列连接工厂的名称以及 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 44. createWASQueueConnectionFactoryUsingTemplate 脚本的参数. 运行脚本来创建队列连接工厂。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProvider 指定相关 JMS 提供程序的名称。
templateID 指定要使用的 WebSphere Application Server 队列连接工厂模板的配置标识。
queueConnFactoryName 指定要分配给新的 WebSphere Application Server 队列连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 45. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
XAEnabled 指定是否启用 XA 恢复处理。
['XAEnabled', 'false']
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['authMechanismPreference', 
'BASIC_PASSWORD']
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JMS 连接工厂实例的 JMS 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description 指定资源适配器的描述。
['description', 'My description']
diagnoseConnectionUsage 指定是否启用连接使用诊断。
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'true']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'true']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
sessionPool 指定父 JMS 连接实例的 JMS 会话池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['xaRecoveryAuthAlias', 'myCellManager01/a1']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASQueueConnectionFactoryAtScope

此脚本在配置中所指定作用域内创建 WebSphere Application Server 队列连接工厂。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本会返回在各自单元中创建的 WebSphere Application Server 队列连接工厂的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、要分配给队列连接工厂的名称以及 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:

表 46. createWASQueueConnectionFactoryAtScope 脚本的参数. 运行脚本来创建队列连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
jmsProvider 指定相关 JMS 提供程序的名称。
queueConnFactoryName 指定要分配给新的 WebSphere Application Server 队列连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 47. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
XAEnabled 指定是否启用 XA 恢复处理。
['XAEnabled', 'false']
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['authMechanismPreference', 
'BASIC_PASSWORD']
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JMS 连接工厂实例的 JMS 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description 指定资源适配器的描述。
['description', 'My description']
diagnoseConnectionUsage 指定是否启用连接使用诊断。
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'true']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'true']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
sessionPool 指定父 JMS 连接实例的 JMS 会话池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['xaRecoveryAuthAlias', 'myCellManager01/a1']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASQueueConnectionFactoryUsingTemplateAtScope

此脚本使用模板在配置中您所指定的作用域内创建 WebSphere Application Server 队列连接工厂。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本返回在各自单元中使用模板来创建的 WebSphere Application Server 队列连接工厂的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、模板的配置标识、要分配给队列连接工厂的名称以及 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 48. createWASQueueConnectionFactoryUsingTemplateAtScope 脚本的参数. 运行脚本来创建队列连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
jmsProvider 指定相关 JMS 提供程序的名称。
templateID 指定要使用的 WebSphere Application Server 队列连接工厂模板的配置标识。
queueConnFactoryName 指定要分配给新的 WebSphere Application Server 队列连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 49. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
XAEnabled 指定是否启用 XA 恢复处理。
['XAEnabled', 'false']
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['authMechanismPreference', 
'BASIC_PASSWORD']
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JMS 连接工厂实例的 JMS 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description 指定资源适配器的描述。
['description', 'My description']
diagnoseConnectionUsage 指定是否启用连接使用诊断。
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'true']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'true']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
sessionPool 指定父 JMS 连接实例的 JMS 会话池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['xaRecoveryAuthAlias', 'myCellManager01/a1']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASTopic

此脚本在 JMS 配置中创建 WebSphere Application Server 主题。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本会返回在各自单元中创建的 WebSphere Application Server 主题的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、要分配给主题的名称、JNDI 名称以及主题参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 50. createWASTopic 脚本的参数. 运行脚本来创建主题。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProvider 指定相关 JMS 提供程序的名称。
topicName 指定要分配给新主题的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
topic 指定此主题要使用的名称(在主题空间中用作限定词)。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 51. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
expiry 指定在多长时间后,发送到此目标的消息会到期并根据消息处置选项进行处理。有效值为 APPLICATION_DEFINESPECIFIED 以及 UNLIMITED

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['expiry', 'SPECIFIED']
persistence 指定持久性的级别。有效值为 APPLICATION_DEFINEDNONPERSISTENT 以及 PERSISTENT
['persistence', 'NONPERSISTENT']
priority 指定优先级。有效值为 APPLICATION_DEFINEDSPECIFIED
['priority', 'SPECIFIED']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问特定供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
specifiedExpiry 指定在废弃此队列上的消息以前所耗用的时间(以毫秒计)。
['specifiedExpiry', '1000']
specifiedPriority 指定 WASQueue WebSphere 队列的优先级(从 0 到 9)。
['specifiedPriority', '0']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASTopicUsingTemplate

此脚本使用模板在 JMS 配置中创建 WebSphere Application Server 主题。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本会返回在各自单元中创建的 WebSphere 主题的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、模板的配置标识、要分配给主题的名称、JNDI 名称以及主题参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 52. createWASTopicUsingTemplate 脚本的参数. 运行脚本来创建主题。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProvider 指定相关 JMS 提供程序的名称。
templateID 指定要使用的 WebSphere Application Server 主题模板的配置标识。
topicName 指定要分配给新主题的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
topic 指定此主题要使用的名称(在主题空间中用作限定词)。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 53. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
expiry 指定在多长时间后,发送到此目标的消息会到期并根据消息处置选项进行处理。有效值为 APPLICATION_DEFINESPECIFIED 以及 UNLIMITED

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['expiry', 'SPECIFIED']
persistence 指定持久性的级别。有效值为 APPLICATION_DEFINEDNONPERSISTENT 以及 PERSISTENT
['persistence', 'NONPERSISTENT']
priority 指定优先级。有效值为 APPLICATION_DEFINEDSPECIFIED
['priority', 'SPECIFIED']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问特定供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
specifiedExpiry 指定在废弃此队列上的消息以前所耗用的时间(以毫秒计)。
['specifiedExpiry', '1000']
specifiedPriority 指定 WASQueue WebSphere 队列的优先级(从 0 到 9)。
['specifiedPriority', '0']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

createWASTopicAtScope

此脚本在 JMS 配置中所指定作用域内创建 WebSphere Application Server 主题。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本会返回在各自单元中创建的 WebSphere Application Server 主题的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、要分配给主题的名称、JNDI 名称以及主题参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 54. createWASTopicAtScope 脚本的参数. 运行脚本来创建主题。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
jmsProvider 指定相关 JMS 提供程序的名称。
topicName 指定要分配给新主题的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
topic 指定此主题要使用的名称(在主题空间中用作限定词)。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 55. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
expiry 指定在多长时间后,发送到此目标的消息会到期并根据消息处置选项进行处理。有效值为 APPLICATION_DEFINESPECIFIED 以及 UNLIMITED

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['expiry', 'SPECIFIED']
persistence 指定持久性的级别。有效值为 APPLICATION_DEFINEDNONPERSISTENT 以及 PERSISTENT
['persistence', 'NONPERSISTENT']
priority 指定优先级。有效值为 APPLICATION_DEFINEDSPECIFIED
['priority', 'SPECIFIED']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问特定供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
specifiedExpiry 指定在废弃此队列上的消息以前所耗用的时间(以毫秒计)。
['specifiedExpiry', '1000']
specifiedPriority 指定 WASQueue WebSphere 队列的优先级(从 0 到 9)。
['specifiedPriority', '0']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASTopicUsingTemplateAtScope

此脚本使用模板在 JMS 配置中您所指定的作用域内创建 WebSphere Application Server 主题。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本会返回在各自单元中创建的 WebSphere 主题的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、模板的配置标识、要分配给主题的名称、JNDI 名称以及主题参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 56. createWASTopicUsingTemplateAtScope 脚本的参数. 运行脚本来创建主题。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
jmsProvider 指定相关 JMS 提供程序的名称。
templateID 指定要使用的 WebSphere Application Server 主题模板的配置标识。
topicName 指定要分配给新主题的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
topic 指定此主题要使用的名称(在主题空间中用作限定词)。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 57. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
description 指定资源适配器的描述。
['description', 'My description']
expiry 指定在多长时间后,发送到此目标的消息会到期并根据消息处置选项进行处理。有效值为 APPLICATION_DEFINESPECIFIED 以及 UNLIMITED

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['expiry', 'SPECIFIED']
persistence 指定持久性的级别。有效值为 APPLICATION_DEFINEDNONPERSISTENT 以及 PERSISTENT
['persistence', 'NONPERSISTENT']
priority 指定优先级。有效值为 APPLICATION_DEFINEDSPECIFIED
['priority', 'SPECIFIED']
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string]
[value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string]
[value localhost]] 
[[name portNumber][type integer]
[value 50000]] ]]]]
provider 指定用于访问特定供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myProviderType']
specifiedExpiry 指定在废弃此队列上的消息以前所耗用的时间(以毫秒计)。
['specifiedExpiry', '1000']
specifiedPriority 指定 WASQueue WebSphere 队列的优先级(从 0 到 9)。
['specifiedPriority', '0']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

此脚本在所指定作用域中为缺省消息传递提供程序创建新的 JMS 主题。此脚本返回所创建 SIB JMS 主题的配置标识。

要运行此脚本,请指定作用域、要分配给主题的名称以及 JNDI 名称。可选择性地指定属性。在以下各表中定义了参数和属性:
表 58. createSIBJMSTopic 脚本的参数. 运行脚本来创建 JMS 主题。
自变量 描述
scope 为缺省消息传递提供程序指定单元、节点、服务器或集群的作用域
name 指定要分配给新主题的名称。
jndiName 指定系统用于将此对象绑定到 WebSphere Application Server JNDI 的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 59. 可选属性. 可用于脚本的其他属性。
属性 描述
description 指定 SIB JMS 主题的描述。
topicSpace 指定该主题指向的底层 SIB 主题空间的名称。
topicName 指定主题空间内使用的主题,例如 stock/IBM。
deliveryMode 指定消息的交付方式。有效值为 Application、NonPersistentPersistent
timeToLive 指定消息到期的时间(以毫秒计)。
priority 指定要分配给发送到此目标的消息的优先级别。有效值为 0, 1, 2, 3, 4, 5, 6, 7, 8,9
readAhead 指定预读值。有效值为 AsConnection、AlwaysOnAlwaysOff
busName 主题所在的总线的名称。

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

此脚本在所指定作用域中为 IBM MQ 消息传递提供程序创建 JMS 主题目标。此脚本返回所创建 IBM MQ 主题的配置标识。

要运行此脚本,请指定作用域、要分配给主题的名称以及 JNDI 名称。可选择性地指定属性。在以下各表中定义了参数和属性:
表 60. createWMQTopic 脚本的参数. 运行脚本以创建 JMS 主题目标。
自变量 描述
scope IBM MQ 消息传递提供程序指定单元、节点、服务器或集群的作用域
name 指定要分配给新主题的名称。
jndiName 指定系统用于将此对象绑定到 WebSphere Application Server JNDI 的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 61. 可选属性. 可用于脚本的其他属性。
属性 描述
brokerCCDurSubQueue 指定连接使用程序从中接收持久预订消息的队列的名称。
brokerDurSubQueue 指定连接使用程序从中接收非持久预订消息的队列的名称。
brokerPubQmgr 指定正在运行代理程序的队列管理器的名称。
brokerPubQueue 指定要将发布消息发送到的队列的名称。
brokerVersion 指定发布和预订操作所需要的功能级别。
ccsid 指定编码字符集标识。
decimalEncoding 指定此主题的十进制编码设置。有效值为 NormalReversed
description 指定要与此 IBM MQ JMS 主题类型目标关联的管理描述。
expiry 指定在多长时间后,发送到此目标的消息会到期并根据消息处置选项进行处理。有效值为 APPUNLIM 或任何正整数。
floatingPointEncoding 指定此主题的浮点编码设置。有效值为 IEEENormalIEEEReversedz/OS
integerEncoding 指定此主题的整数编码设置。有效值为 NormalReversed
persistence 指定用来存储发送至此目标的消息的持久性级别。有效值为 APP, TDEF, PERS, NONHIGH
priority 指定要分配给发送到此目标的消息的优先级别。有效值为 APP, TDEF, 0, 1, 2, 3, 4, 5, 6, 7, 8,9
readAheadClose 指定在关闭异步接收消息的消息使用者时发生的行为。消息使用者使用来自目标的消息侦听器,该消息侦听器将 readAhead 参数设置为 true。指定了值 DELIVERALL 时,关闭方法调用等到所有预读消息都传递到使用者,然后将其关闭。指定值 DELIVERCURRENT 时,close() 方法仅等待任何正在进行的传递结束,然后关闭使用者。有效值为 DELIVERALLDELIVERCURRENT
readAhead 指定是否可以预读和高速缓存非持久性使用者的消息。有效值为 YES, NOTDEF
sendAsync 指定是否可以将消息发送到此目标,而无需队列管理器确认其已到达。有效值为 YES, NOTDEF
useRFH2 指定 RFH V2 头是否会附加到发送至此目标的消息上。有效值为 truefalse
useNativeEncoding 指定此主题的本机编码设置。
wildcardFormat 指定将哪些字符集解释为主题通配符。

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

此脚本在配置中创建 WebSphere Application Server 主题连接工厂。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本会返回在各自单元中创建的 WebSphere Application Server 主题连接工厂的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、要分配给连接工厂的名称、JNDI 名称以及端口参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 62. createWASTopicConnectionFactory 脚本的参数. 运行脚本来创建主题连接工厂。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProviderName 指定相关 JMS 提供程序的名称。
topicConnFactoryName 指定要分配给新连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
port 指定相关端口。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 63. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
XAEnabled 指定是否启用 XA 恢复处理。
['XAEnabled', 'false']
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['authMechanismPreference', 
'BASIC_PASSWORD']
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JMS 连接工厂实例的 JMS 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description 指定资源适配器的描述。
['description', 'My description']
diagnoseConnectionUsage 指定是否启用连接使用诊断。
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'true']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'true']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
sessionPool 指定父 JMS 连接实例的 JMS 会话池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['xaRecoveryAuthAlias', 'myCellManager01/a1']
表 64. 可选属性(续). 可用于脚本的其他属性。
属性 描述 示例
clientID 指定客户机标识。
['clientID', 'myClientID']
cloneSupport 指定克隆之间是否支持 WebSphere 主题连接工厂。
['cloneSupport', 'true']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASTopicConnectionFactoryUsingTemplate

此脚本使用模板在配置中创建 WebSphere Application Server 主题连接工厂。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMS Server 来执行消息传递。此脚本会返回在各自单元中使用模板来创建的 WebSphere 主题的配置标识。

要运行此脚本,请指定节点、服务器、JMS 提供程序名称、模板的配置标识、要分配给连接工厂的名称、JNDI 名称以及端口参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 65. createWASTopicConnectionFactoryUsingTemplate 脚本的参数. 运行脚本来创建主题连接工厂。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
jmsProviderName 指定相关 JMS 提供程序的名称。
templateID 指定要使用的 WebSphere Application Server 主题连接工厂的配置标识。
topicConnFactoryName 指定要分配给新连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
port 指定相关端口。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 66. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
XAEnabled 指定是否启用 XA 恢复处理。
['XAEnabled', 'false']
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['authMechanismPreference', 
'BASIC_PASSWORD']
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JMS 连接工厂实例的 JMS 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description 指定资源适配器的描述。
['description', 'My description']
diagnoseConnectionUsage 指定是否启用连接使用诊断。
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'true']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'true']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
sessionPool 指定父 JMS 连接实例的 JMS 会话池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['xaRecoveryAuthAlias', 'myCellManager01/a1']
表 67. 可选属性(续). 可用于脚本的其他属性。
属性 描述 示例
type 指定 QUEUE(用于队列)、TOPIC(用于主题)以及 UNIFIED(同时用于队列和主题)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['type', 'TOPIC']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASTopicConnectionFactoryAtScope

此脚本在配置中所指定作用域内创建 WebSphere Application Server 主题连接工厂。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMSServer 来执行消息传递。此脚本会返回在各自单元中创建的 WebSphere Application Server 主题连接工厂的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、要分配给连接工厂的名称、JNDI 名称以及端口参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 68. createWASTopicConnectionFactoryAtScope 脚本的参数. 运行脚本来创建主题连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
jmsProviderName 指定相关 JMS 提供程序的名称。
topicConnFactoryName 指定要分配给新连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
port 指定相关端口。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 69. 可选属性(续). 可用于脚本的其他属性。
属性 描述 示例
type 指定 QUEUE(用于队列)、TOPIC(用于主题)以及 UNIFIED(同时用于队列和主题)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['type', 'TOPIC']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWASTopicConnectionFactoryUsingTemplateAtScope

此脚本使用模板在配置中您所指定的作用域内创建 WebSphere Application Server 主题连接工厂。您只应该将 JMS 资源用于特定应用程序,这些应用程序使用 V7.0 单元中的 WebSphere Application Server V5.1 嵌入式 JMS Server 来执行消息传递。此脚本会返回在各自单元中使用模板来创建的 WebSphere 主题的配置标识。

要运行此脚本,请指定作用域、JMS 提供程序名称、模板的配置标识、要分配给连接工厂的名称、JNDI 名称以及端口参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 70. createWASTopicConnectionFactoryUsingTemplateAtScope 脚本的参数. 运行脚本来创建主题连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
jmsProviderName 指定相关 JMS 提供程序的名称。
templateID 指定要使用的 WebSphere Application Server 主题连接工厂的配置标识。
topicConnFactoryName 指定要分配给新连接工厂的名称。
jndiName 指定系统用于将连接工厂绑定到名称空间的 JNDI 名称。
port 指定相关端口。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 71. 可选属性. 可用于脚本的其他属性。
属性 描述 示例
XAEnabled 指定是否启用 XA 恢复处理。
['XAEnabled', 'false']
authDataAlias 指定运行时数据库认证所使用的别名。
['authDataAlias', 'myAuthDataAlias']
authMechanismPreference 指定认证机制。有效值为 BASIC_PASSWORD(用于基本认证)和 KERBEROS(用于 Kerberos 认证)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['authMechanismPreference', 
'BASIC_PASSWORD']
category 指定可用来对资源进行分类或分组的类别。
['category', 'myCategory']
connectionPool 指定父 JMS 连接工厂实例的 JMS 连接池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

['connectionPool',
[['agedTimeout','100'],['connectionTimeout','1000'],
['freePoolDistributionTableSize',10],['maxConnections','12'],
['minConnections','5'],['numberOfFreePoolPartitions','3'],
['numberOfSharedPoolPartitions','6'],
['numberOfUnsharedPoolPartitions','3'],['properties',
[['description','My description'],['name', 'myName'],
['required','false'],['type','String'],
['validationExpression',''],['value','myValue']]],
['purgePolicy','EntirePool'],['reapTime','10000'],
['struckThreshold','3'],['struckTime','10'],
['struckTimerTime','10'],['surgeCreationInterval','10'],
['surgeThreshold','10'],['testConnection','true'],
['testConnectionInterval','10'],['unusedTimeout','10000']]]
description 指定资源适配器的描述。
['description', 'My description']
diagnoseConnectionUsage 指定是否启用连接使用诊断。
['diagnoseConnectionUsage', 'false']
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
['logMissingTransactionContext', 'true']
manageCachedHandles 指定是否将此数据源用于企业 Bean 的容器管理持久性。缺省值为 True
['manageCachedHandles', 'true']
mapping 指定配置登录至所指定认证别名的映射。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["mapping",[["authDataAlias","authDataAliasValue"],
["mappingConfigAlias","mappingConfigAliasValue"]]]
preTestConfig 指定预测试连接配置设置。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["preTestConfig",[["preTestConnection", "true"],
["retryInterval", "12343"],["retryLimit", "4"]]]
properties 指定类型化属性类型或描述性属性类型。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["properties",[["description","My description"],
["name","myName"],["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]]
propertySet 选择性地以如下格式指定资源属性:[propertySet[[resourceProperties[[[name1 nameValue1][type1 typeValue1][value1 valueValue1]]... [[namen nameValuen][typen typeValuen][valuen valueValuen]] ]]]]

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

[propertySet [[resourceProperties 
[[[name databaseName][type string][value mys]] 
[[name driverType][type integer][value 4]] 
[[name serverName][type string][value localhost]] 
[[name portNumber][type integer][value 50000]] ]]]]
provider 指定用于访问供应商数据库的 JMS 驱动程序实现类。要创建到该数据库的连接的池,请将数据源与 JMS 提供程序关联。
['provider', 'myJMSProvider']
providerType 指定此 JMS 提供程序所使用的 JMS 提供程序类型。
['providerType', 'myJMSProviderType']
sessionPool 指定父 JMS 连接实例的 JMS 会话池属性。

在脚本中使用此属性时,请使用列表格式。字符串格式不起作用,因为此属性是配置对象类型。

["sessionPool\",
[["agedTimeout","100"],["connectionTimeout","1000"],
["freePoolDistributionTableSize",10],["maxConnections","12"],
["minConnections","5"],["numberOfFreePoolPartitions","3"],
["numberOfSharedPoolPartitions","6"],
["numberOfUnsharedPoolPartitions","3"],["properties",
[["description","My description"],["name", "myName"],
["required","false"],["type","String"],
["validationExpression",""],["value","myValue"]]],
["purgePolicy",'EntirePool'],["reapTime","10000"],
["struckThreshold","3"],["struckTime","10"],
["struckTimerTime","10"],["surgeCreationInterval","10"],
["surgeThreshold","10"],["testConnection","true"],
["testConnectionInterval","10"],["unusedTimeout","10000"]]]
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的数据库认证别名。如果指定此属性,那么缺省值为应用程序认证的别名。
['xaRecoveryAuthAlias', 'myCellManager01/a1']
表 72. 可选属性(续). 可用于脚本的其他属性。
属性 描述 示例
type 指定 QUEUE(用于队列)、TOPIC(用于主题)以及 UNIFIED(同时用于队列和主题)。

对于此命令的字符串格式,请不要使用引号将任一值引起来。

['type', 'TOPIC']

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

此脚本在所指定作用域中为缺省消息传递提供程序创建新的 SIB JMS 连接工厂。此脚本返回所创建 SIB JMS 连接工厂的配置标识。

要运行此脚本,请指定作用域、名称、JNDI 名称以及总线名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 73. createSIBJMSConnectionFactory 脚本的参数. 运行脚本来创建 JMS 连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
name 指定分配给此连接工厂的管理名称。
jndiName 指定在与此连接工厂相关联的消息驱动 Bean 的绑定中指定的 JNDI 名称。
busName 指定要连接的服务集成总线的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 74. 可选属性. 可用于脚本的其他属性。
属性 描述
authDataAlias 指定用户标识和密码,其用于认证与 JMS 提供程序的连接,以便进行应用程序管理的认证。
containerAuthAlias 指定容器受管认证别名,从其使用安全凭证来建立到 JMS 提供程序的连接。
mappingAlias 指定在确定安全相关凭证时要使用的 Java 认证和授权服务 (JAAS) 映射别名。在建立到 JMS 提供程序的连接时,使用与安全性相关的凭证。
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的认证别名。
category 指定可用来对连接工厂进行分类或分组的类别。
description 指定此连接工厂的描述。
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
manageCachedHandles 指定高速缓存的句柄(即 Bean 中实例变量内保留的句柄)是否由容器跟踪
clientID 指定只有持久预订需要的客户机标识。
userName 指定用于从连接工厂创建连接的用户名。
password 指定用于从连接工厂创建连接的密码。
nonPersistentMapping 指定非持久性映射值。有效值为 BestEffortNonPersistentExpressNonPersistentReliableNonPersistentReliablePersistentAssuredPersistentAsSIBDestinationNone
persistentMapping 指定持久性映射值。有效值为 BestEffortNonPersistentExpressNonPersistentReliableNonPersistentReliablePersistentAssuredPersistentAsSIBDestinationNone
durableSubscriptionHome 指定持久预订主目录值。
readAhead 指定预读值。有效值为 DefaultAlwaysOnAlwaysOff
target 指定解析为一组消息传递引擎的目标的名称。
targetType 指定目标参数中名称的类型。有效值为 BusMemberCustomME
targetSignificance 指定目标组的显著性。 有效值为 PreferredRequired
targetTransportChain 指定连接至远程消息传递引擎的协议的名称。
providerEndPoints 指定格式为 host:port:chain 的端点三元组的逗号分隔列表。
connectionProximity 指定可接受的消息传递引擎的近似值。有效值为 BusHostClusterServer
tempQueueNamePrefix 指定临时队列名称前缀。
tempTopicNamePrefix 指定临时主题名称前缀。
shareDataSourceWithCMP 指定如何控制共享的数据源。
shareDurableSubscriptions 指定如何控制共享的持久预订。有效值为 InClusterAlwaysSharedNeverShared
consumerDoesNotModifyPayloadAfterGet 指定使用消息的应用程序接收对象或字节消息时,系统仅在必要时才序列化消息数据。使用此连接工厂将应用程序连接至总线。从这些消息获取数据的应用程序必须将数据作为只读数据处理。有效值为 TrueFalse。缺省值为 false
producerDoesNotModifyPayloadAfterSet 指定使用消息的应用程序发送对象或字节消息时,没有复制数据,系统仅在必要时才序列化数据。使用此连接工厂将应用程序连接至总线。在消息中设置数据后,发送这类消息的应用程序就不能修改数据。有效值为 TrueFalse。缺省值为 false

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWMQConnectionFactory

此脚本在所指定作用域中为 IBM MQ 消息传递提供程序创建连接工厂。此脚本返回所创建 IBM MQ 连接工厂的配置标识。

要运行此脚本,请指定作用域、名称、JNDI 名称以及参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 75. createWMQConnectionFactory 脚本的参数. 运行脚本来创建连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
name 指定分配给此 IBM MQ 消息传递提供程序连接工厂的管理名称。
jndiName 指定用于将此对象绑定到 WebSphere Application Server JNDI 的名称和位置。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 76. 可选属性. 可用于脚本的其他属性。
属性 描述
maxBatchSize 指定使用异步消息传递时从一个包中的队列获取的最大消息数。
brokerCCSubQueue 指定连接使用程序从中检索非持久预订消息的队列的名称。此参数仅对主题连接工厂有效。
brokerCtrlQueue 指定在此连接工厂用于预订主题时将使用的代理控制队列。此参数仅对主题连接工厂有效。
brokerQmgr 指定正在运行队列管理器的队列管理器的名称。此参数仅对主题连接工厂有效。
brokerSubQueue 指定在此连接工厂预订主题时用于获取预订消息的队列。此参数仅对主题连接工厂有效。
brokerVersion 指定发布和预订操作所需要的功能级别。此参数仅对主题连接工厂有效。
brokerPubQueue 指定使用基于队列的代理功能时将发布消息发送至的队列。此参数仅对主题连接工厂有效。
ccdtQmgrName 指定用于从客户机通道定义表中选择一个或多个条目的队列管理器名称。
ccdtUrl 指定客户机通道定义表的 URL。在联系 IBM MQ 消息传递提供程序时,将此属性用于此连接工厂。使用此属性创建的连接工厂是 ccdtURL 连接工厂。
ccsid 指定要在连接上使用的编码字符集标识。
cleanupInterval 指定后台执行的发布和预订清除实用程序之间的时间间隔。此参数仅对主题连接工厂有效。
cleanupLevel 指定 BROKER 或 MIGRATE 预订存储的清除级别。此参数仅对主题连接工厂有效。
clientId 指定用于使用此连接工厂启动的连接的客户机标识。
clonedSubs 指定同一持久主题订户的两个或更多实例是否可以同时运行。此参数仅对主题连接工厂有效。
compressHeaders 确定是否压缩消息头。
compressPayload 确定是否压缩消息有效内容。
containerAuthAlias 指定具有安全凭证的容器受管认证别名,这些凭证用于建立到 IBM MQ 消息传递提供程序的连接。
description 指定此连接工厂的描述。
failIfQuiescing 指定队列管理器变为停顿状态时,对其进行的某些调用的行为。
localAddress 指定下列两项或其中之一:
  • 要使用的本地网络接口。
  • 要使用的本地端口或本地端口范围。
mappingAlias 指定在确定安全相关凭证时要使用的 JAAS 映射别名。在建立与 IBM MQ 的连接时,使用与安全性相关的凭证。
modelQueue 指定在创建 JMS 临时目标时用作基础的 IBM MQ 模型队列定义。此参数仅对队列连接工厂有效。
msgRetention 指定连接使用程序是否将不需要的消息保留在输入队列中。值 true 表示保留。值 false 表示将按照消息的处置选项来处置消息。此参数仅对队列连接工厂有效。
msgSelection 指定进行消息选择的位置。此参数仅对主题连接工厂有效。
pollingInterval 指定一个轮询时间间隔所耗用的最长时间(以毫秒计)。如果会话内的消息侦听器在其队列中没有合适的消息,那么消息侦听器使用轮询时间间隔来确定轮询其队列以查找消息的频率。如果会话经常没有合适的消息,请增加此属性的值。此属性仅在客户机容器中适用。
providerVersion 指定队列管理器的最低版本和功能。
pubAckInterval 指定在发送征求确认的出版物之前发送至基于队列代理程序的出版物的数量。此属性仅对主题连接工厂有效。
qmgrHostname 指定尝试对 IBM MQ 进行客户机方式连接时此连接工厂使用的主机名。
qmgrName 指定联系 IBM MQ 消息传递提供程序时此连接工厂使用的队列管理器名称。使用此参数创建的连接工厂是用户定义的连接工厂。
qmgrPortNumber 指定尝试对 IBM MQ 进行客户机方式连接时此连接工厂使用的端口号。
qmgrSvrconnChannel 指定连接至 IBM MQ 时使用的 SVRCONN 通道。使用此参数创建的连接工厂是用户定义的连接工厂。
rcvExitInitData 指定要传递到接收出口的初始化数据。
rcvExit 指定以逗号分隔的接收出口类名的列表。
replyWithRFH2 指定回复某个消息时,是否在回复消息中包含 RFH V2 头。此参数仅对队列连接工厂有效。
rescanInterval 指定一个扫描时间间隔所耗用的最长时间(以毫秒计)。点到点域中的消息使用者使用消息选择器来选择所要接收的消息时,IBM MQ JMS 客户机将在 IBM MQ 队列中按队列的 MsgDeliverySequence 属性确定的顺序来搜索合适的消息。该客户机找到合适的消息并将其传递给使用者后,该客户机将从它在该队列中所处的当前位置开始继续搜索下一条合适的消息。客户机继续搜索队列,直到其达到队列末尾,或者直到此属性指定的时间间隔到期。在每种情况下,客户机将返回队列的开头以继续搜索,然后将开始新的时间间隔。此参数仅对队列连接工厂有效。
secExitInitData 指定要传递到安全出口的初始化数据。
secExit 指定以逗号分隔的安全出口类名的列表。
sendExitInitData 指定要传递到发送出口的初始化数据。
sendExit 指定以逗号分隔的发送出口类名的列表。
sparseSubs 指定 TopicSubscriber 对象的消息检索策略。此参数仅对主题连接工厂有效。
sslConfiguration 指定特定安全套接字层 (SSL) 配置来保护到队列管理器的网络连接。
sslCrl 指定 LDAP 服务器列表,可以使用这些服务器在此连接工厂建立与 IBM MQ 的 SSL 连接时提供证书撤销信息。
sslPeerName 指定用于与对等证书中的专有名称进行匹配的对等名称。连接工厂建立到队列管理器的 SSL 连接时,将使用此属性。
sslResetCount 指定重置用于 SSL 会话的对称加密密钥之前要传输的字节数。 连接工厂建立到队列管理器的 SSL 连接时,将使用此属性。
sslType 在连接工厂建立到队列管理器的 SSL 连接时(如果有),请指定配置。
stateRefreshInt 指定检测订户与队列管理器之间的连接是否中断的长时间运行事务的刷新之间经过的最长时间(以毫秒计)。仅当 subStore 属性的值为 QUEUE 时,此属性才有意义。 此属性仅对主题连接工厂有效。
subStore 指定 IBM MQ JMS 存储与活动预订相关的持久数据。此属性仅对主题连接工厂有效。
support2PCProtocol 指定此连接工厂是否将充当能够参与分布式两阶段落实处理的资源。
tempQueuePrefix 指定要应用于 IBM MQ 临时队列的前缀。这些临时队列表示 JMS 临时队列类型目标。此属性仅对队列连接工厂有效。
tempTopicPrefix 指定要应用于 IBM MQ 临时主题的前缀。这些临时主题表示 JMS 临时主题类型目标。此属性仅对主题连接工厂有效。
wildcardFormat 指定将哪些字符集解释为主题通配符。此属性仅对主题连接工厂有效。
wmqTransportType 指定此连接工厂如何连接至 IBM MQ。使用此属性创建的连接工厂是用户定义的。有效值为 BINDINGSBINDINGS_THEN_CLIENTCLIENT
xaRecoveryAuthAlias 指定用于连接至 IBM MQ 以进行 XA 恢复的认证别名。

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createSIBJMSQueueConnectionFactory

此脚本在所指定作用域中为缺省消息传递提供程序创建新的 SIB JMS 队列连接工厂。此脚本返回所创建 SIB JMS 队列连接工厂的配置标识。

要运行此脚本,请指定作用域、名称、JNDI 名称以及总线名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 77. createSIBJMSQueueConnectionFactory 脚本的参数. 运行脚本来创建 JMS 队列连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
name 指定分配给此连接工厂的管理名称。
jndiName 指定在与此连接工厂相关联的消息驱动 Bean 的绑定中指定的 JNDI 名称。
busName 指定要连接的服务集成总线的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 78. 可选属性. 可用于脚本的其他属性。
属性 描述
authDataAlias 指定用户标识和密码,其用于认证与 JMS 提供程序的连接,以便进行应用程序管理的认证。
containerAuthAlias 指定容器受管认证别名,从其使用安全凭证来建立到 JMS 提供程序的连接。
mappingAlias 指定在确定安全相关凭证时要使用的 Java 认证和授权服务 (JAAS) 映射别名。在建立到 JMS 提供程序的连接时,使用与安全性相关的凭证。
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的认证别名。
category 指定可用来对连接工厂进行分类或分组的类别。
description 指定此连接工厂的描述。
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
manageCachedHandles 指定高速缓存的句柄(即 Bean 中实例变量内保留的句柄)是否由容器跟踪
clientID 指定只有持久预订需要的客户机标识。
userName 指定用于从连接工厂创建连接的用户名。
password 指定用于从连接工厂创建连接的密码。
nonPersistentMapping 指定非持久性映射值。有效值为 BestEffortNonPersistentExpressNonPersistentReliableNonPersistentReliablePersistentAssuredPersistentAsSIBDestinationNone
persistentMapping 指定持久性映射值。有效值为 BestEffortNonPersistentExpressNonPersistentReliableNonPersistentReliablePersistentAssuredPersistentAsSIBDestinationNone
durableSubscriptionHome 指定持久预订主目录值。
readAhead 指定预读值。有效值为 DefaultAlwaysOnAlwaysOff
target 指定解析为一组消息传递引擎的目标的名称。
targetType 指定目标参数中名称的类型。有效值为 BusMemberCustomME
targetSignificance 指定目标组的显著性。 有效值为 PreferredRequired
targetTransportChain 指定连接至远程消息传递引擎的协议的名称。
providerEndPoints 指定格式为 host:port:chain 的端点三元组的逗号分隔列表。
connectionProximity 指定可接受的消息传递引擎的近似值。有效值为 BusHostClusterServer
tempQueueNamePrefix 指定临时队列名称前缀。
tempTopicNamePrefix 指定临时主题名称前缀。
shareDataSourceWithCMP 指定如何控制共享的数据源。
shareDurableSubscriptions 指定如何控制共享的持久预订。有效值为 InClusterAlwaysSharedNeverShared
consumerDoesNotModifyPayloadAfterGet 指定使用消息的应用程序接收对象或字节消息时,系统仅在必要时才序列化消息数据。使用此连接工厂将应用程序连接至总线。从这些消息获取数据的应用程序必须将数据作为只读数据处理。有效值为 TrueFalse。缺省值为 false
producerDoesNotModifyPayloadAfterSet 指定使用消息的应用程序发送对象或字节消息时,没有复制数据,系统仅在必要时才序列化数据。使用此连接工厂将应用程序连接至总线。在消息中设置数据后,发送这类消息的应用程序就不能修改数据。有效值为 TrueFalse。缺省值为 false

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWMQQueueConnectionFactory

此脚本在所指定作用域中为 IBM MQ 消息传递提供程序创建队列连接工厂。此脚本返回所创建 IBM MQ 队列连接工厂的配置标识。

要运行此脚本,请指定作用域、名称和 JNDI 名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 79. createWMQQueueConnectionFactory 脚本的参数. 运行脚本来创建队列连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
name 指定分配给此 IBM MQ 消息传递提供程序连接工厂的管理名称。
jndiName 指定用于将此对象绑定到 WebSphere Application Server JNDI 的名称和位置。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 80. 可选属性. 可用于脚本的其他属性。
属性 描述
maxBatchSize 指定使用异步消息传递时从一个包中的队列获取的最大消息数。
brokerCCSubQueue 指定连接使用程序从中检索非持久预订消息的队列的名称。此参数仅对主题连接工厂有效。
brokerCtrlQueue 指定在此连接工厂用于预订主题时将使用的代理控制队列。此参数仅对主题连接工厂有效。
brokerQmgr 指定正在运行队列管理器的队列管理器的名称。此参数仅对主题连接工厂有效。
brokerSubQueue 指定在此连接工厂预订主题时用于获取预订消息的队列。此参数仅对主题连接工厂有效。
brokerVersion 指定发布和预订操作所需要的功能级别。此参数仅对主题连接工厂有效。
brokerPubQueue 指定使用基于队列的代理功能时将发布消息发送至的队列。此参数仅对主题连接工厂有效。
ccdtQmgrName 指定用于从客户机通道定义表中选择一个或多个条目的队列管理器名称。
ccdtUrl 指定客户机通道定义表的 URL。在联系 IBM MQ 消息传递提供程序时,将此属性用于此连接工厂。使用此属性创建的连接工厂是 ccdtURL 连接工厂。
ccsid 指定要在连接上使用的编码字符集标识。
cleanupInterval 指定后台执行的发布和预订清除实用程序之间的时间间隔。此参数仅对主题连接工厂有效。
cleanupLevel 指定 BROKER 或 MIGRATE 预订存储的清除级别。此参数仅对主题连接工厂有效。
clientId 指定用于使用此连接工厂启动的连接的客户机标识。
clonedSubs 指定同一持久主题订户的两个或更多实例是否可以同时运行。此参数仅对主题连接工厂有效。
compressHeaders 确定是否压缩消息头。
compressPayload 确定是否压缩消息有效内容。
containerAuthAlias 指定具有安全凭证的容器受管认证别名,这些凭证用于建立到 IBM MQ 消息传递提供程序的连接。
description 指定此连接工厂的描述。
failIfQuiescing 指定队列管理器变为停顿状态时,对其进行的某些调用的行为。
localAddress 指定下列两项或其中之一:
  • 要使用的本地网络接口。
  • 要使用的本地端口或本地端口范围。
mappingAlias 指定在确定安全相关凭证时要使用的 JAAS 映射别名。在建立与 IBM MQ 的连接时,使用与安全性相关的凭证。
modelQueue 指定在创建 JMS 临时目标时用作基础的 IBM MQ 模型队列定义。此参数仅对队列连接工厂有效。
msgRetention 指定连接使用程序是否将不需要的消息保留在输入队列中。值 true 表示保留。值 false 表示将按照消息的处置选项来处置消息。此参数仅对队列连接工厂有效。
msgSelection 指定进行消息选择的位置。此参数仅对主题连接工厂有效。
pollingInterval 指定一个轮询时间间隔所耗用的最长时间(以毫秒计)。如果会话内的消息侦听器在其队列中没有合适的消息,那么消息侦听器使用轮询时间间隔来确定轮询其队列以查找消息的频率。如果会话经常没有合适的消息,请增加此属性的值。此属性仅在客户机容器中适用。
providerVersion 指定队列管理器的最低版本和功能。
pubAckInterval 指定在发送征求确认的出版物之前发送至基于队列代理程序的出版物的数量。此属性仅对主题连接工厂有效。
qmgrHostname 指定尝试对 IBM MQ 进行客户机方式连接时此连接工厂使用的主机名。
qmgrName 指定联系 IBM MQ 消息传递提供程序时此连接工厂使用的队列管理器名称。使用此参数创建的连接工厂是用户定义的连接工厂。
qmgrPortNumber 指定尝试对 IBM MQ 进行客户机方式连接时此连接工厂使用的端口号。
qmgrSvrconnChannel 指定连接至 IBM MQ 时使用的 SVRCONN 通道。使用此参数创建的连接工厂是用户定义的连接工厂。
rcvExitInitData 指定要传递到接收出口的初始化数据。
rcvExit 指定以逗号分隔的接收出口类名的列表。
replyWithRFH2 指定回复某个消息时,是否在回复消息中包含 RFH V2 头。此参数仅对队列连接工厂有效。
rescanInterval 指定一个扫描时间间隔所耗用的最长时间(以毫秒计)。点到点域中的消息使用者使用消息选择器来选择所要接收的消息时,IBM MQ JMS 客户机将在 IBM MQ 队列中按队列的 MsgDeliverySequence 属性确定的顺序来搜索合适的消息。该客户机找到合适的消息并将其传递给使用者后,该客户机将从它在该队列中所处的当前位置开始继续搜索下一条合适的消息。客户机继续搜索队列,直到其达到队列末尾,或者直到此属性指定的时间间隔到期。在每种情况下,客户机将返回队列的开头以继续搜索,然后将开始新的时间间隔。此参数仅对队列连接工厂有效。
secExitInitData 指定要传递到安全出口的初始化数据。
secExit 指定以逗号分隔的安全出口类名的列表。
sendExitInitData 指定要传递到发送出口的初始化数据。
sendExit 指定以逗号分隔的发送出口类名的列表。
sparseSubs 指定 TopicSubscriber 对象的消息检索策略。此参数仅对主题连接工厂有效。
sslConfiguration 指定特定安全套接字层 (SSL) 配置来保护到队列管理器的网络连接。
sslCrl 指定 LDAP 服务器列表,可以使用这些服务器在此连接工厂建立与 IBM MQ 的 SSL 连接时提供证书撤销信息。
sslPeerName 指定用于与对等证书中的专有名称进行匹配的对等名称。连接工厂建立到队列管理器的 SSL 连接时,将使用此属性。
sslResetCount 指定重置用于 SSL 会话的对称加密密钥之前要传输的字节数。 连接工厂建立到队列管理器的 SSL 连接时,将使用此属性。
sslType 在连接工厂建立到队列管理器的 SSL 连接时(如果有),请指定配置。
stateRefreshInt 指定检测订户与队列管理器之间的连接是否中断的长时间运行事务的刷新之间经过的最长时间(以毫秒计)。仅当 subStore 属性的值为 QUEUE 时,此属性才有意义。 此属性仅对主题连接工厂有效。
subStore 指定 IBM MQ JMS 存储与活动预订相关的持久数据。此属性仅对主题连接工厂有效。
support2PCProtocol 指定此连接工厂是否将充当能够参与分布式两阶段落实处理的资源。
tempQueuePrefix 指定要应用于 IBM MQ 临时队列的前缀。这些临时队列表示 JMS 临时队列类型目标。此属性仅对队列连接工厂有效。
tempTopicPrefix 指定要应用于 IBM MQ 临时主题的前缀。这些临时主题表示 JMS 临时主题类型目标。此属性仅对主题连接工厂有效。
wildcardFormat 指定将哪些字符集解释为主题通配符。此属性仅对主题连接工厂有效。
wmqTransportType 指定此连接工厂如何连接至 IBM MQ。使用此属性创建的连接工厂是用户定义的。有效值为 BINDINGSBINDINGS_THEN_CLIENTCLIENT
xaRecoveryAuthAlias 指定用于连接至 IBM MQ 以进行 XA 恢复的认证别名。

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createSIBJMSTopicConnectionFactory

此脚本在所指定作用域中为缺省消息传递提供程序创建新的 SIB JMS 主题连接工厂。此脚本返回所创建 SIB JMS 主题连接工厂的配置标识。

要运行此脚本,请指定作用域、名称、JNDI 名称以及总线名称参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 81. createSIBJMSTopicConnectionFactory 脚本的参数. 运行脚本来创建 SIB JMS 主题连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
name 指定分配给此连接工厂的管理名称。
jndiName 指定在与此连接工厂相关联的消息驱动 Bean 的绑定中指定的 JNDI 名称。
busName 指定要连接的服务集成总线的名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 82. 可选属性. 可用于脚本的其他属性。
属性 描述
authDataAlias 指定用户标识和密码,其用于认证与 JMS 提供程序的连接,以便进行应用程序管理的认证。
containerAuthAlias 指定容器受管认证别名,从其使用安全凭证来建立到 JMS 提供程序的连接。
mappingAlias 指定在确定安全相关凭证时要使用的 Java 认证和授权服务 (JAAS) 映射别名。在建立到 JMS 提供程序的连接时,使用与安全性相关的凭证。
xaRecoveryAuthAlias 指定 XA 恢复处理期间所使用的认证别名。
category 指定可用来对连接工厂进行分类或分组的类别。
description 指定此连接工厂的描述。
logMissingTransactionContext 指定是否启用对缺少的事务上下文进行记录。
manageCachedHandles 指定高速缓存的句柄(即 Bean 中实例变量内保留的句柄)是否由容器跟踪
clientID 指定只有持久预订需要的客户机标识。
userName 指定用于从连接工厂创建连接的用户名。
password 指定用于从连接工厂创建连接的密码。
nonPersistentMapping 指定非持久性映射值。有效值为 BestEffortNonPersistentExpressNonPersistentReliableNonPersistentReliablePersistentAssuredPersistentAsSIBDestinationNone
persistentMapping 指定持久性映射值。有效值为 BestEffortNonPersistentExpressNonPersistentReliableNonPersistentReliablePersistentAssuredPersistentAsSIBDestinationNone
durableSubscriptionHome 指定持久预订主目录值。
readAhead 指定预读值。有效值为 DefaultAlwaysOnAlwaysOff
target 指定解析为一组消息传递引擎的目标的名称。
targetType 指定目标参数中名称的类型。有效值为 BusMemberCustomME
targetSignificance 指定目标组的显著性。 有效值为 PreferredRequired
targetTransportChain 指定连接至远程消息传递引擎的协议的名称。
providerEndPoints 指定格式为 host:port:chain 的端点三元组的逗号分隔列表。
connectionProximity 指定可接受的消息传递引擎的近似值。有效值为 BusHostClusterServer
tempQueueNamePrefix 指定临时队列名称前缀。
tempTopicNamePrefix 指定临时主题名称前缀。
shareDataSourceWithCMP 指定如何控制共享的数据源。
shareDurableSubscriptions 指定如何控制共享的持久预订。有效值为 InClusterAlwaysSharedNeverShared
consumerDoesNotModifyPayloadAfterGet 指定使用消息的应用程序接收对象或字节消息时,系统仅在必要时才序列化消息数据。使用此连接工厂将应用程序连接至总线。从这些消息获取数据的应用程序必须将数据作为只读数据处理。有效值为 TrueFalse。缺省值为 false
producerDoesNotModifyPayloadAfterSet 指定使用消息的应用程序发送对象或字节消息时,没有复制数据,系统仅在必要时才序列化数据。使用此连接工厂将应用程序连接至总线。在消息中设置数据后,发送这类消息的应用程序就不能修改数据。有效值为 TrueFalse。缺省值为 false

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWMQTopicConnectionFactory

此脚本在所指定作用域中为 IBM MQ 消息传递提供程序创建主题连接工厂。此脚本返回所创建 IBM MQ 主题连接工厂的配置标识。

要运行此脚本,请指定作用域、名称、JNDI 名称以及参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 83. createWMQTopicConnectionFactory 脚本的参数. 运行脚本来创建主题连接工厂。
自变量 描述
scope 为 JMS 提供程序指定单元、节点、服务器或集群的作用域
name 指定分配给此 IBM MQ 消息传递提供程序连接工厂的管理名称。
jndiName 指定用于将此对象绑定到 WebSphere Application Server JNDI 的名称和位置。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 84. 可选属性. 可用于脚本的其他属性。
属性 描述
maxBatchSize 指定使用异步消息传递时从一个包中的队列获取的最大消息数。
brokerCCSubQueue 指定连接使用程序从中检索非持久预订消息的队列的名称。此参数仅对主题连接工厂有效。
brokerCtrlQueue 指定在此连接工厂用于预订主题时将使用的代理控制队列。此参数仅对主题连接工厂有效。
brokerQmgr 指定正在运行队列管理器的队列管理器的名称。此参数仅对主题连接工厂有效。
brokerSubQueue 指定在此连接工厂预订主题时用于获取预订消息的队列。此参数仅对主题连接工厂有效。
brokerVersion 指定发布和预订操作所需要的功能级别。此参数仅对主题连接工厂有效。
brokerPubQueue 指定使用基于队列的代理功能时将发布消息发送至的队列。此参数仅对主题连接工厂有效。
ccdtQmgrName 指定用于从客户机通道定义表中选择一个或多个条目的队列管理器名称。
ccdtUrl 指定客户机通道定义表的 URL。在联系 IBM MQ 消息传递提供程序时,将此属性用于此连接工厂。使用此属性创建的连接工厂是 ccdtURL 连接工厂。
ccsid 指定要在连接上使用的编码字符集标识。
cleanupInterval 指定后台执行的发布和预订清除实用程序之间的时间间隔。此参数仅对主题连接工厂有效。
cleanupLevel 指定 BROKER 或 MIGRATE 预订存储的清除级别。此参数仅对主题连接工厂有效。
clientId 指定用于使用此连接工厂启动的连接的客户机标识。
clonedSubs 指定同一持久主题订户的两个或更多实例是否可以同时运行。此参数仅对主题连接工厂有效。
compressHeaders 确定是否压缩消息头。
compressPayload 确定是否压缩消息有效内容。
containerAuthAlias 指定具有安全凭证的容器受管认证别名,这些凭证用于建立到 IBM MQ 消息传递提供程序的连接。
description 指定此连接工厂的描述。
failIfQuiescing 指定队列管理器变为停顿状态时,对其进行的某些调用的行为。
localAddress 指定下列两项或其中之一:
  • 要使用的本地网络接口。
  • 要使用的本地端口或本地端口范围。
mappingAlias 指定在确定安全相关凭证时要使用的 JAAS 映射别名。在建立与 IBM MQ 的连接时,使用与安全性相关的凭证。
modelQueue 指定在创建 JMS 临时目标时用作基础的 IBM MQ 模型队列定义。此参数仅对队列连接工厂有效。
msgRetention 指定连接使用程序是否将不需要的消息保留在输入队列中。值 true 表示保留。值 false 表示将按照消息的处置选项来处置消息。此参数仅对队列连接工厂有效。
msgSelection 指定进行消息选择的位置。此参数仅对主题连接工厂有效。
pollingInterval 指定一个轮询时间间隔所耗用的最长时间(以毫秒计)。如果会话内的消息侦听器在其队列中没有合适的消息,那么消息侦听器使用轮询时间间隔来确定轮询其队列以查找消息的频率。如果会话经常没有合适的消息,请增加此属性的值。此属性仅在客户机容器中适用。
providerVersion 指定队列管理器的最低版本和功能。
pubAckInterval 指定在发送征求确认的出版物之前发送至基于队列代理程序的出版物的数量。此属性仅对主题连接工厂有效。
qmgrHostname 指定尝试对 IBM MQ 进行客户机方式连接时此连接工厂使用的主机名。
qmgrName 指定联系 IBM MQ 消息传递提供程序时此连接工厂使用的队列管理器名称。使用此参数创建的连接工厂是用户定义的连接工厂。
qmgrPortNumber 指定尝试对 IBM MQ 进行客户机方式连接时此连接工厂使用的端口号。
qmgrSvrconnChannel 指定连接至 IBM MQ 时使用的 SVRCONN 通道。使用此参数创建的连接工厂是用户定义的连接工厂。
rcvExitInitData 指定要传递到接收出口的初始化数据。
rcvExit 指定以逗号分隔的接收出口类名的列表。
replyWithRFH2 指定回复某个消息时,是否在回复消息中包含 RFH V2 头。此参数仅对队列连接工厂有效。
rescanInterval 指定一个扫描时间间隔所耗用的最长时间(以毫秒计)。点到点域中的消息使用者使用消息选择器来选择所要接收的消息时,IBM MQ JMS 客户机将在 IBM MQ 队列中按队列的 MsgDeliverySequence 属性确定的顺序来搜索合适的消息。该客户机找到合适的消息并将其传递给使用者后,该客户机将从它在该队列中所处的当前位置开始继续搜索下一条合适的消息。客户机继续搜索队列,直到其达到队列末尾,或者直到此属性指定的时间间隔到期。在每种情况下,客户机将返回队列的开头以继续搜索,然后将开始新的时间间隔。此参数仅对队列连接工厂有效。
secExitInitData 指定要传递到安全出口的初始化数据。
secExit 指定以逗号分隔的安全出口类名的列表。
sendExitInitData 指定要传递到发送出口的初始化数据。
sendExit 指定以逗号分隔的发送出口类名的列表。
sparseSubs 指定 TopicSubscriber 对象的消息检索策略。此参数仅对主题连接工厂有效。
sslConfiguration 指定特定安全套接字层 (SSL) 配置来保护到队列管理器的网络连接。
sslCrl 指定 LDAP 服务器列表,可以使用这些服务器在此连接工厂建立与 IBM MQ 的 SSL 连接时提供证书撤销信息。
sslPeerName 指定用于与对等证书中的专有名称进行匹配的对等名称。连接工厂建立到队列管理器的 SSL 连接时,将使用此属性。
sslResetCount 指定重置用于 SSL 会话的对称加密密钥之前要传输的字节数。 连接工厂建立到队列管理器的 SSL 连接时,将使用此属性。
sslType 在连接工厂建立到队列管理器的 SSL 连接时(如果有),请指定配置。
stateRefreshInt 指定检测订户与队列管理器之间的连接是否中断的长时间运行事务的刷新之间经过的最长时间(以毫秒计)。仅当 subStore 属性的值为 QUEUE 时,此属性才有意义。 此属性仅对主题连接工厂有效。
subStore 指定 IBM MQ JMS 存储与活动预订相关的持久数据。此属性仅对主题连接工厂有效。
support2PCProtocol 指定此连接工厂是否将充当能够参与分布式两阶段落实处理的资源。
tempQueuePrefix 指定要应用于 IBM MQ 临时队列的前缀。这些临时队列表示 JMS 临时队列类型目标。此属性仅对队列连接工厂有效。
tempTopicPrefix 指定要应用于 IBM MQ 临时主题的前缀。这些临时主题表示 JMS 临时主题类型目标。此属性仅对主题连接工厂有效。
wildcardFormat 指定将哪些字符集解释为主题通配符。此属性仅对主题连接工厂有效。
wmqTransportType 指定此连接工厂如何连接至 IBM MQ。使用此属性创建的连接工厂是用户定义的。有效值为 BINDINGSBINDINGS_THEN_CLIENTCLIENT
xaRecoveryAuthAlias 指定用于连接至 IBM MQ 以进行 XA 恢复的认证别名。

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createSIBJMSActivationSpec

此脚本在所指定作用域中为缺省消息传递提供程序创建新的激活规范。此脚本返回所创建 SIB JMS 激活规范的配置标识。

要运行此脚本,请指定作用域、激活规范名称、JNDI 名称以及 JNDI 名称目标参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 85. createSIBJMSActivationSpec 脚本的参数. 运行脚本以创建 JMS 激活规范。
自变量 描述
scope 为将在其中创建 JMS 激活规范的缺省消息传递提供程序指定单元、节点、服务器或集群的作用域
name 指定分配给此激活规范的名称。
jndiName 指定在与此激活规范相关联的消息驱动 Bean 绑定中指定的 JNDI 名称。
destinationJndiName 指定消息驱动的 bean 使用的目标 JMS 队列或主题的 JNDI 名称。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 86. 可选属性. 可用于脚本的其他属性。
属性 描述
description 指定 JMS 激活规范,缺省消息传递提供程序将此规范用于验证 JMS 消息驱动 bean (MDB) 的激活配置属性。
acknowledgeMode 指定会话如何确认其收到的任何消息。
authenticationAlias 指定 J2C 认证别名的名称,此别名用于对服务集成总线连接进行组件管理的认证。
busName 要与其建立连接的服务集成总线的名称。
clientId 指定 JMS 客户机标识。持久主题预订需要客户机标识。
destinationType 指定消息驱动的 bean 使用队列还是主题目标。
durableSubscriptionHome 指定持久预订主目录的名称。此属性标识消息传递引擎,在其中管理通过此激活规范访问的所有持久预订。
maxBatchSize 指定在一个批次中能够从消息传递引擎接收的最大消息数。
maxConcurrency 指定以并行方式将消息传递至的端点的最大数目。
messageSelector 指定用于确定消息驱动的 bean (MDB) 所接收消息的 JMS 消息选择器。
password 指定 Java 2 连接器安全性要使用的密码。
subscriptionDurability 指定 JMS 主题预订是持久的还是非持久的。
subscriptionName 指定持久主题预订所需的预订名。
shareDurableSubscriptions 指定如何共享持久预订。
userName 指定 Java 2 连接器安全性要使用的用户标识。
readAhead 指定预读值。有效值为 DefaultAlwaysOnAlwaysOff
target 指定 SIB JMS 激活规范的新目标值。
targetType 指定 SIB JMS 激活规范的新目标值。有效值为 BusMember, CustomME
targetSignificance 指定目标组的显著性。
targetTransportChain 指定用于连接至远程消息传递引擎的协议的名称。
providerEndPoints 指定格式为 host:port:chain 的端点三元组的逗号分隔列表。
shareDataSourceWithCMP 指定如何共享数据源。
consumerDoesNotModifyPayloadAfterGet 指定启用后,通过此激活规范接收的对象消息仅在必要时才会让系统序列化其消息数据。从这些消息获取数据的应用程序必须将数据作为只读数据处理。有效值为 TrueFalse。缺省值为 false
forwarderDoesNotModifyPayloadAfterSet 指定启用后,通过已修改其有效内容的激活规范来转发的该对象或字节消息在消息中发送数据时不会复制数据。系统仅在必要时序列化消息数据。在消息中发送数据之后,发送这类消息的应用程序就不能修改数据。有效值为 TrueFalse。缺省值为 false
alwaysActivateAllMDBs 指定 MDB 服务器选择规则。该规则确定哪些服务器可以驱动部署至它们的 MDB。有效值为 TrueFalse。缺省值为 false。指定 true 以激活所有服务器中的 MDB。否则,仅使用具有正在运行的消息传递引擎的服务器。
retryInterval 指定尝试连接至消息传递引擎操作之间的延迟(以秒计),适合初始连接以及建立更好连接的任何后续尝试。缺省值为 30。该延迟必须大于零。
autoStopSequentialMessageFailure 指定连续失败消息数目达到配置的限制时,端点会停止。由于处理 MDB 中的依赖性,所处理的实际消息数目可能会超过此值。
failingMessageDelay 指定在可以重试消息之前经过的时间段。在 MDB 未能处理该消息,但是该消息尚未达到其最大失败交付限制时,将重试该消息。除非将连续失败阈值和最大并行度设置为 1,否则在此时间段内可能会尝试传送其他消息。

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

createWMQActivationSpec

此脚本在所指定作用域中为 IBM MQ 消息传递提供程序创建新的激活规范。此脚本返回所创建 IBM MQ 激活规范的配置标识。

要运行此脚本,请指定作用域、激活规范名称、JNDI 名称以及 JNDI 名称目标参数。可选择性地指定属性。在以下各表中定义了参数和属性:
表 87. createWMQActivationSpec 脚本的参数. 运行脚本以创建激活规范。
自变量 描述
scope IBM MQ 消息传递提供程序的激活规范指定单元、节点、服务器或集群的作用域
name 指定分配给此激活规范的名称。
jndiName 指定用于将此对象绑定到 WebSphere Application Server JNDI 的名称和位置。
destinationJndiName 指定 IBM MQ 消息传递提供程序队列或主题类型目标的 JNDI 名称。如果使用此激活规范来部署 MDB,那么将从此目标获取 MDB 的消息。
destinationType 指定目标的类型。有效值为 javax.jms.Queuejavax.jms.Topic。 该参数没有缺省值。
attributes
选择性地以特定格式指定其他属性:
列表格式
[["attr1", "value1"], ["attr2", "value2"]]
字符串格式
"attr1=value1, attr2=value2"
表 88. 可选属性. 可用于脚本的其他属性。
属性 描述
authAlias 指定此激活规范需要建立与 IBM MQ 的连接时,用于获取凭证的认证别名。
brokerCCDurSubQueue 指定连接使用程序从中接收持久预订消息的队列的名称。
brokerCCSubQueue 指定连接使用程序从中检索非持久预订消息的队列的名称。
brokerCtrlQueue 指定在此激活规范预订主题时将使用的代理控制队列。
brokerQmgr 指定正在运行代理程序的队列管理器的名称。
brokerSubQueue 指定在此激活预订主题时用于获取预订消息的队列。
brokerVersion 指定发布和预订操作所需要的功能级别。
ccdtQmgrName 指定从客户机通道定义表中选择一个或多个条目的队列管理器的名称。
ccdtUrl 指定客户机通道定义表的 URL。在联系 IBM MQ 时,将此属性用于此激活规范。使用此属性创建的激活规范是 ccdtURL 激活规范。
ccsid 指定要在连接上使用的编码字符集标识。
cleanupInterval 指定后台执行的发布和预订清除实用程序之间的时间间隔。
cleanupLevel 指定代理或迁移预订存储的清除级别。
clientId 指定使用此激活规范启动的连接的客户机标识。
clonedSubs 指定同一持久主题订户的两个或更多实例是否可以同时运行。
compressHeaders 指定是否压缩了消息头。
compressPayload 指定是否压缩了消息有效内容。
description 指定分配到激活规范的管理描述。
failIfQuiescing 指定队列管理器变为停顿状态时,对其进行的某些调用的行为。
failureDeliveryCount 指定在暂挂端点之前允许的连续传递失败的次数。
maxPoolSize 指定服务器会话池中由连接使用程序使用的最大服务器会话数。
messageSelector 指定传递哪些消息。
msgRetention 指定连接使用程序是否将不需要的消息保留在输入队列中。值 true 表示保留。值 false 表示将按照消息的处置选项来处置消息。
msgSelection 指定进行消息选择的位置。
poolTimeout 指定一段时间(以毫秒计),在这段时间内,未使用的服务器会话在由于不活动而被关闭之前,将在服务器会话池中保持打开状态。
providerVersion 指定队列管理器的最低版本和功能。
qmgrHostname 指定尝试对 IBM MQ 进行客户机方式连接时用于此激活规范的主机名。
qmgrName 指定联系 IBM MQ 时此激活规范的队列管理器名称。使用此属性创建的激活规范是用户定义的。
qmgrPortNumber 指定尝试对 IBM MQ 进行客户机方式连接时此激活规范的端口号。
qmgrSvrconnChannel 指定连接至 IBM MQ 时使用的 SVRCONN 通道。使用此属性创建的激活规范是用户定义的。
rcvExitInitData 指定要传递到接收出口的初始化数据。
rcvExit 指定以逗号分隔的接收出口类名的列表。
rescanInterval 指定一个扫描时间间隔所耗用的最长时间(以毫秒计)。点到点域中的消息使用者使用消息选择器来选择所要接收的消息时,IBM MQ JMS 客户机将在 IBM MQ 队列中按队列的 MsgDeliverySequence 属性确定的顺序来搜索合适的消息。该客户机找到合适的消息并将其传递给使用者后,该客户机将从它在该队列中所处的当前位置开始继续搜索下一条合适的消息。客户机继续搜索队列,直到其达到队列末尾,或者直到此属性指定的时间间隔到期。在每种情况下,客户机将返回队列的开头以继续搜索,然后将开始新的时间间隔。
secExitInitData 指定要传递到安全出口的初始化数据。
secExit 指定安全出口类名。
sendExitInitData 指定要传递到发送出口的初始化数据。
sendExit 指定以逗号分隔的发送出口的类名的列表。
sparseSubs 指定主题订户对象的消息检索策略。
sslConfiguration 指定用于保护到队列管理器的网络连接的 SSL 配置。
sslCrl 指定 LDAP 服务器列表,可以使用这些服务器在此激活规范建立与 IBM MQ 的 SSL 连接时提供证书撤销信息。
sslPeerName 指定用于与对等证书中的专有名称进行匹配的值。激活规范建立到队列管理器的 SSL 连接时,将使用此属性。
sslResetCount 指定重置用于 SSL 会话的对称加密密钥之前要传输的字节数。 激活规范建立到队列管理器的 SSL 连接时,将使用此属性。
sslType 指定用于队列管理器的网络连接的 SSL 配置。
startTimeout 指定一段时间(以毫秒计),在安排了传递某个消息的工作后,必须在这段时间内开始将该消息传递至 MDB。如果这段时间已经过去,那么会将该消息返回至队列。
stateRefreshInt 指定以毫秒计的时间间隔,用于检测订户与队列管理器之间的连接是否中断的长时间运行事务将按此时间间隔执行刷新。仅当 subStore 属性的值为 QUEUE 时,此属性才有意义。
stopEndpointIfDeliveryFails 指定当消息传递失败次数达到 failureDeliveryCount 属性所指定的次数时,是否停止端点。
subscriptionDurability 指定是使用持久预订还是非持久预订来将消息传递至预订该主题的 MDB。
subscriptionName 指定持久预订的名称。
subStore 指定 IBM MQ JMS 用于存储与活动预订相关的持久数据的位置。
wildcardFormat 指定将哪些字符集解释为主题通配符。
wmqTransportType 对于此激活规范,指定建立与 IBM MQ 的连接的方式。使用此属性创建的激活规范是用户定义的。有效值为 BINDINGS, BINDINGS_THEN_CLIENTCLIENT
localAddress 指定下列两个选项或其中之一:
  • 要使用的本地网络接口
  • 要使用的本地端口或本地端口范围

语法

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

用法示例

以下示例脚本仅包含必需属性:

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

以下示例脚本包含列表格式的可选属性:

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

startListenerPort

此脚本会在环境中启动侦听器端口。此脚本会返回值 1(如果系统成功启动侦听器端口)或值 -1(如果系统未启动侦听器端口)。

要运行此脚本,请指定节点和服务器名称参数,如下表中所定义:
表 89. startListenerPort 脚本的参数. 运行脚本以启动侦听器端口。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。

语法

AdminJMS.startListenerPort(nodeName, 
 serverName)

用法示例

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

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7adminjms
文件名:rxml_7adminjms.html