资源配置脚本
该脚本编制库提供多个脚本过程来自动完成应用程序服务器配置。使用邮件、URL 和资源环境配置脚本来在环境中创建并配置资源。可以分别运行每个脚本,也可将过程组合在一起来创建定制自动执行脚本。
邮件、URL 和资源管理脚本过程位于 app_server_root/scriptLibraries/resources/ 目录中。

作用域参数的格式
作用域格式应用于脚本库中具有该作用域参数的脚本。
在节点、服务器和集群作用域上,单元是可选的。在服务器作用域上,节点是必需的。
可以使用逗号 (,) 或分号 (:) 来定界类型。可以使用小写表示类型(cell=、node=、server= 或 cluster=)。
为了方便发布,下表中的示例分布在多行上。
作用域 | 包含路径 | 配置标识 | 类型 |
---|---|---|---|
单元 | /Cell:myCell/ |
|
Cell=myCell 或 cell=myCell |
节点 | /Cell:myCell/Node:myNode/ 或 /Node:myNode/ |
|
或
或
|
Server |
或
|
|
或
或
|
集群 |
或
|
|
或
或
|
createCompleteMailProvider
此脚本为邮件提供程序配置其他配置属性。邮件提供程序封装 SMTP、IMAP 和 POP3 之类的协议提供程序的集合,而邮件会话会认证用户并控制用户对消息传递系统的访问。配置您自己的邮件提供程序和会话以定制处理 JavaMail 的方式。此脚本返回所创建邮件提供程序的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
mailProviderName | 指定应用程序服务器对此邮件会话使用的邮件提供程序。 |
propName | 指定定制属性的名称。 |
propValue | 指定定制属性的值。 |
protocolName | 指定协议提供程序的名称。应用程序服务器包含 SMTP、IMAP 和 POP3 的协议提供程序。 |
className | 指定协议提供程序的实现类名。 |
mailSessionName | 指定 JavaMail 会话对象的管理名称。 |
JNDIName | 指定资源的 Java 命名和目录接口 (JNDI) 名称,其中包括所有命名子上下文。此名称提供了客户机应用程序部署描述符中定义的资源的平台绑定信息,与平台绑定到 JNDI 的实际资源之间的链接。 |
mailStoreHost | 指定接收邮件时访问的服务器。该设置由邮件存储用户标识和密码组成以表示一个有效的邮件帐户。例如,如果邮件帐户是 john_william@my.company.com,那么邮件存储主机是 my.company.com。 |
mailStoreUser | 指定给定邮件帐户的用户标识。例如,如果邮件帐户是 john_william@my.company.com,那么用户是 john_william。 |
mailStorePassword | 指定给定邮件帐户的密码。例如,如果邮件帐户是 john_william@my.company.com,那么输入标识 john_william 的密码。 |
语法
AdminResources.createCompleteMailProvider(nodeName,
serverName, mailProviderName, propName, propValue,
protocolName, className, mailSessionName, JNDIName,
mailStoreHost, mailStoreUser, mailStorePassword)
用法示例
AdminResources.createCompleteMailProvider("myNode",
"myServer", "myMailProvider", "myProp", "myPropValue", "myMailProtocol",
"com.ibm.mail.myMailProtocol.myMailStore", "myMailSession", "myMailSession/jndi", "server1",
"mailuser", "password")
createCompleteMailProviderAtScope
此脚本为所指定作用域的邮件提供程序配置其他配置属性。邮件提供程序封装 SMTP、IMAP 和 POP3 之类的协议提供程序的集合,而邮件会话会认证用户并控制用户对消息传递系统的访问。配置您自己的邮件提供程序和会话以定制处理 JavaMail 的方式。此脚本返回指定作用域的所创建邮件提供程序的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
mailProviderName | 指定应用程序服务器对此邮件会话使用的邮件提供程序。 |
propName | 指定定制属性的名称。 |
propValue | 指定定制属性的值。 |
protocolName | 指定协议提供程序的名称。应用程序服务器包含 SMTP、IMAP 和 POP3 的协议提供程序。 |
className | 指定协议提供程序的实现类名。 |
type | 指定协议提供程序的类型。有效的选项是 STORE 或 TRANSPORT。 |
mailSessionName | 指定 JavaMail 会话对象的管理名称。 |
jndiName | 指定资源的 Java 命名和目录接口 (JNDI) 名称,其中包括所有命名子上下文。此名称提供了客户机应用程序部署描述符中定义的资源的平台绑定信息,与平台绑定到 JNDI 的实际资源之间的链接。 |
otherAttributesList、mailProviderAttributesList 和 mailSessionAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
classpath | 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。 |
description | 指定邮件提供程序的描述。 |
isolatedClassLoader | 如果设置为 true,那么指定邮件提供程序通过它自己的类装入器装入。 注意: 当指定了本机库路径时,无法隔离提供程序。
|
nativepath | 指定任何本机库(例如 *.dll 和 *.so)的可选路径。请使用分号 (;) 来分隔本机路径条目。 |
providerType | 指定此邮件提供程序使用的邮件提供程序类型。 |
属性 | 描述 |
---|---|
category | 指定可用来对资源进行分类或分组的类别。 |
debug | 指定是否对此邮件会话使用调试方式。缺省值为 off。 |
description | 指定邮件提供程序的描述。 |
mailFrom | 指定因特网电子邮件地址。如果设置为 true,那么此邮件提供程序通过它自己的类装入器装入。 警告: 当指定了本机库路径时,无法隔离提供程序。
|
mailStoreHost | 指定接收邮件时要连接的服务器。 |
mailStorePort | 指定接收邮件时要连接的端口。 |
mailStoreUser | 指定当待收邮件服务器要求认证时邮件帐户的用户。 |
mailStorePassword | 指定当待收邮件服务器要求认证时邮件帐户的密码。 |
mailStoreProtocol | 指定接收邮件时要使用的协议。 |
mailTransportHost | 指定发送邮件时要连接的服务器。 |
mailTransportPort | 指定发送邮件时要连接的端口。 |
mailTransportUser | 指定当外发邮件服务器要求认证时邮件帐户的用户。 |
mailTransportPassword | 指定当外发邮件服务器要求认证时邮件帐户的密码。 |
mailTransportProtocol | 指定发送邮件时要使用的协议。 |
strict | 指定接收方地址的解析方式是否符合 RFC 822。缺省值为 true。 |
语法
AdminResources.createCompleteMailProviderAtScope(scope,
mailProviderName, propName, propValue,
protocolName, className, type, mailSessionName, JNDIName, otherAttributesList,
mailProviderAttributesList, mailSessionAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createCompleteMailProviderAtScope("myScope",
"myMailProvider", "myProp", "myPropValue", "myMailProtocol",
"com.ibm.mail.myMailProtocol.myMailStore", "myMailSession", "myMailSession/jndi", "server1", "STORE")
AdminResources.createCompleteMailProviderAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "myProp",
"myPropValue", "myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore", "STORE", "myMailSession", "myMailSession/jndi",
"classpath=c:/temp, description='this is my mail', nativepath=c:/temp/nativepath, isolatedClassLoader=true",
"category=myCategory, debug=true, description='this is my mailsession', mailStoreUser=user1, mailStorePassword=password,
mailStoreHost=user1, mailStorePort=1000, mailTransportUser=user2, mailTransportPassword=password, mailTransportHost=test2,
mailTransportPort=1001, strict=true, mailFrom=test1@gmail.com")
以下示例脚本包含列表格式的可选属性:
AdminResources.createCompleteMailProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myMailProvider", "myProp",
"myPropValue", "myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore", "STORE", "myMailSession", "myMailSession/jndi",
[['classpath', 'c:/temp'], ['description', 'this is my mail'], ['nativepath', 'c:/temp/nativepath'],
['isolatedClassLoader', 'true']]
[['category', 'myCategory'], ['debug', 'true'], ['description', 'this is my mailsession'], ['mailStoreUser', 'user1'],
['mailStorePassword', 'password'], ['mailStoreHost', 'user1'], ['mailStorePort', 1000], ['mailTransportUser', 'user2'],
['mailTransportPassword', 'password'], ['mailTransportHost', 'test2'], ['mailTransportPort', 1001], ['strict', 'true'],
['mailFrom', 'test1@gmail.com']])
createMailProvider
此脚本会在您的环境中创建邮件提供程序。应用程序服务器包含称为内置提供程序的缺省邮件提供程序。如果您使用缺省邮件提供程序,那么仅必须配置邮件会话。要使用定制的邮件提供程序,您必须首先创建邮件提供程序和会话。此脚本返回所创建邮件提供程序的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定要创建邮件提供程序的节点的名称。 |
serverName | 指定要创建邮件提供程序的服务器的名称。 |
mailProviderName | 指定要分配给新邮件提供程序的名称。 |
语法
AdminResources.createMailProvider(nodeName, serverName,
mailProviderName)
用法示例
AdminResources.createMailProvider("myNode", "myServer",
"myMailProvider")
createMailProviderAtScope
此脚本会在环境中所指定作用域内创建邮件提供程序。应用程序服务器包含称为内置提供程序的缺省邮件提供程序。如果您使用缺省邮件提供程序,那么仅必须配置邮件会话。要使用定制的邮件提供程序,您必须首先创建邮件提供程序和会话。此脚本返回指定作用域的所创建邮件提供程序的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
mailProviderName | 指定要分配给新邮件提供程序的名称。 |
otherAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
classpath | 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。 |
description | 指定邮件提供程序的描述。 |
isolatedClassLoader | 如果设置为 true,那么指定邮件提供程序通过它自己的类装入器装入。 注意: 当指定了本机库路径时,无法隔离提供程序。
|
nativepath | 指定任何本机库(例如 *.dll 和 *.so)的可选路径。请使用分号 (;) 来分隔本机路径条目。 |
providerType | 指定此邮件提供程序使用的邮件提供程序类型。 |
语法
AdminResources.createMailProviderAtScope(scope, mailProviderName, otherAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createMailProviderAtScope("myScope", "myMailProvider")
AdminResources.createMailProviderAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "classpath=c:/temp,
description='this is my mail', nativepath=c:/temp/nativepath, isolatedClassLoader=true")
以下示例脚本包含列表格式的可选属性:
AdminResources.createMailProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myMailProvider",
[['classpath', 'c:/temp'],
['description', 'this ismy mail'], ['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'true']])
createMailSession
此脚本为邮件提供程序创建新的邮件会话。邮件会话由 javax.mail.Session 类表示。邮件会话对象认证用户并控制用户对消息传递系统的访问。此脚本返回所创建邮件会话的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
mailProviderName | 指定应用程序服务器对此邮件会话使用的邮件提供程序。 |
mailSessionName | 指定 JavaMail 会话对象的管理名称。 |
JNDIName | 指定资源的 JNDI 名称,包含任何命名子上下文。 此名称提供了客户机应用程序部署描述符中定义的资源的平台绑定信息,与平台绑定到 JNDI 的实际资源之间的链接。 |
语法
AdminResources.createMailSession(nodeName, serverName,
mailProviderName, mailSessionName, JNDIName)
用法示例
AdminResources.createMailSession("myNode", "myServer", "myMailProvider",
"myMailSession", "myMailSession/jndi")
createMailSessionAtScope
此脚本为所指定作用域中邮件提供程序创建新的邮件会话。邮件会话由 javax.mail.Session 类表示。邮件会话对象认证用户并控制用户对消息传递系统的访问。此脚本返回指定作用域的所创建邮件会话的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
mailProviderName | 指定应用程序服务器对此邮件会话使用的邮件提供程序。 |
mailSessionName | 指定 JavaMail 会话对象的管理名称。 |
JNDIName | 指定资源的 JNDI 名称,包含任何命名子上下文。 此名称提供了客户机应用程序部署描述符中定义的资源的平台绑定信息,与平台绑定到 JNDI 的实际资源之间的链接。 |
otherAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
category | 指定可用来对资源进行分类或分组的类别。 |
debug | 指定是否对此邮件会话使用调试方式。缺省值为 off。 |
description | 指定邮件提供程序的描述。 |
mailFrom | 指定因特网电子邮件地址。如果设置为 true,那么此邮件提供程序通过它自己的类装入器装入。 警告: 当指定了本机库路径时,无法隔离提供程序。
|
mailStoreHost | 指定接收邮件时要连接的服务器。 |
mailStorePort | 指定接收邮件时要连接的端口。 |
mailStoreUser | 指定当待收邮件服务器要求认证时邮件帐户的用户。 |
mailStorePassword | 指定当待收邮件服务器要求认证时邮件帐户的密码。 |
mailStoreProtocol | 指定接收邮件时要使用的协议。 |
mailTransportHost | 指定发送邮件时要连接的服务器。 |
mailTransportPort | 指定发送邮件时要连接的端口。 |
mailTransportUser | 指定当外发邮件服务器要求认证时邮件帐户的用户。 |
mailTransportPassword | 指定当外发邮件服务器要求认证时邮件帐户的密码。 |
mailTransportProtocol | 指定发送邮件时要使用的协议。 |
strict | 指定接收方地址的解析方式是否符合 RFC 822。缺省值为 true。 |
语法
AdminResources.createMailSessionAtScope(scope,
mailProviderName, mailSessionName, JNDIName, otherAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createMailSessionAtScope("myScope", "myMailProvider",
"myMailSession", "myMailSession/jndi", attributes")
AdminResources.createMailSessionAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "myMailSession",
"myMailSession/jndi", "category=myCategory, debug=true, description='this is my mailsession', mailStoreUser=user1,
mailStorePassword=password, mailStoreHost=user1, mailStorePort=1000, mailTransportUser=user2, mailTransportPassword=password,
mailTransportHost=test2, mailTransportPort=1001, strict=true, mailFrom=test1@gmail.com")
以下示例脚本包含列表格式的可选属性:
AdminResources.createMailSessionAtScope("/Cell:AMYLIN4Cell01/ServerClust
er:c1/", "myMailProvider", "myMailSession", "myMailSession/jndi",
[['category','myCategory'], ['description', 'this is mailsession'], ['debug', 'true'],
['mailTransportHost', 'test1'], ['mailTransportUser', 'user2'], ['mailTransportPassword', 'password'],
['mailStoreUser', 'user1'], ['mailStorePassword', 'password'], ['mailStoreHost', 'test2'], ['strict', 'true'],
['mailFrom', 'tester@mail.com']]))
createProtocolProvider
此脚本在配置中创建协议提供程序。协议提供程序提供特定协议的实现类,以支持在 JavaMail 应用程序与邮件服务器之间进行通信。应用程序服务器包含 SMTP、IMAP 和 POP3 的协议提供程序。如果需要不同协议的定制提供程序,那么在配置提供程序之前将它们安装在应用程序服务环境中。请参阅 JavaMail API 设计规范以了解准则。在配置协议提供程序之后,请返回到邮件提供程序页面以查找用于配置邮件会话的链接。此脚本返回所创建协议提供程序的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
mailProviderName | 指定应用程序服务器在与协议提供程序建立关联时使用的邮件提供程序的名称。 |
protocolName | 指定协议提供程序的名称。应用程序服务器包含 SMTP、IMAP 和 POP3 的协议提供程序。 |
className | 指定协议提供程序的实现类名。 |
type | 指定协议提供程序的类型。有效的选项是 STORE 或 TRANSPORT。 |
语法
AdminResources.createProtocolProvider(nodeName,
serverName, mailProviderName, protocolName,
className, type)
用法示例
AdminResources.createProtocolProvider("myNode", "myServer", "myMailProvider",
"myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore",
"STORE")
createProtocolProviderAtScope
此脚本会在配置中所指定作用域内创建协议提供程序。协议提供程序提供特定协议的实现类,以支持在所指定作用域内 JavaMail 应用程序与邮件服务器之间进行通信。应用程序服务器包含 SMTP、IMAP 和 POP3 的协议提供程序。如果需要不同协议的定制提供程序,那么在配置提供程序之前将它们安装在应用程序服务环境中。请参阅 JavaMail API 设计规范以了解准则。在配置协议提供程序之后,请返回到邮件提供程序页面以查找用于配置邮件会话的链接。此脚本返回指定作用域的所创建协议提供程序的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
mailProviderName | 指定应用程序服务器在与协议提供程序建立关联时使用的邮件提供程序的名称。 |
protocolName | 指定协议提供程序的名称。应用程序服务器包含 SMTP、IMAP 和 POP3 的协议提供程序。 |
className | 指定协议提供程序的实现类名。 |
type | 指定协议提供程序的类型。有效的选项是 STORE 或 TRANSPORT。 |
otherAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
classpath | 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。 |
语法
AdminResources.createProtocolProviderAtScope(nodeName,
serverName, mailProviderName, protocolName,
className, type, otherAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createProtocolProviderAtScope("myScope", "myMailProvider",
"myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore",
"STORE")
AdminResources.createProtocolProviderAtScope("Node=AMYLIN4Node09, server=server1", "myMailProvider", "myMailProtocol",
“com.ibm.mail.myMailProtocol.myMailStore", "STORE", "classpath=c:/temp")
以下示例脚本包含列表格式的可选属性:
AdminResources.createProtocolProviderAtScope("/Cell:AMYLIN4Cell01/Server
Cluster:c1/", "myMailProvider", "myMailProtocol", "com.ibm.mail.myMailProtocol.m
yMailStore", "STORE", [['classpath', 'c:/temp']]))
createCompleteResourceEnvProvider
此脚本配置资源环境提供程序。资源环境提供程序封装了可引用对象,这些可引用对象用于将资源环境条目数据转换为配置中的资源对象。此脚本返回所创建资源环境提供程序的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
resourceEnvProviderName | 指定要分配给资源环境提供程序的名称。 |
propName | 指定要设置的定制属性的名称。 |
propValue | 指定定制属性的值。 |
factoryClass | 指定将资源环境条目数据转换为物理资源的类实例的工厂。 |
className | 为可引用对象指定类名。 |
resourceEnvEntryName | 指定资源环境条目的名称。 |
JNDIName | 指定资源环境条目的 JNDI 名称,其中包括任何命名子上下文。此名称用作由模块部署描述符定义的资源的平台绑定信息与由平台绑定到 JNDI 的实际资源之间的链接。 |
语法
AdminResources.createCompleteResourceEnvProvider(nodeName,
serverName, resourceEnvProviderName, propName,
propValue, factoryClass, className,
resourceEnvEntryName, JNDIName)
用法示例
AdminResources.createCompleteResourceEnvProvider("myNode", "myServer",
"myResEnvProvider", "myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String",
"myResEnvEntry", "res1/myResEnv")
createCompleteResourceEnvProviderAtScope
此脚本会在所指定作用域内配置资源环境提供程序。资源环境提供程序封装了可引用对象,这些可引用对象用于将资源环境条目数据转换为配置中的资源对象。此脚本返回指定作用域的所创建资源环境提供程序的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
resourceEnvProviderName | 指定要分配给资源环境提供程序的名称。 |
propName | 指定要设置的定制属性的名称。 |
propValue | 指定定制属性的值。 |
factoryClass | 指定将资源环境条目数据转换为物理资源的类实例的工厂。 |
className | 为可引用对象指定类名。 |
resourceEnvEntryName | 指定资源环境条目的名称。 |
jndiName | 指定资源环境条目的 JNDI 名称,其中包括任何命名子上下文。此名称用作由模块部署描述符定义的资源的平台绑定信息与由平台绑定到 JNDI 的实际资源之间的链接。 |
otherAttributesList、resourceEnvProviderAttributesList 和 resourceEnvEntryAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
classpath | 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。 |
description | 指定资源环境提供程序的描述。 |
isolatedClassLoader | 如果设置为 true,那么指定此资源环境提供程序通过它自己的类装入器装入。 注意: 当指定了本机库路径时,无法隔离提供程序。
|
nativepath | 指定任何本机库(例如 *.dll 和 *.so)的可选路径。请使用分号 (;) 来分隔本机路径条目。 |
providerType | 指定此资源环境提供程序使用的资源提供程序类型。 |
属性 | 描述 |
---|---|
category | 指定可用来对资源进行分类或分组的类别。 |
description | 指定资源提供程序的描述。 |
providerType | 指定此资源环境提供程序使用的邮件提供程序类型。 |
referenceable | 指定可引用对象。可引用对象封装某个工厂的类名,该工厂将资源环境条目数据转换为物理资源的类实例。 |
语法
AdminResources.createCompleteResourceEnvProviderAtScope(scope,
resourceEnvProviderName, propName,
propValue, factoryClass, className,
resourceEnvEntryName, JNDIName, otherAttributesList,
resourceEnvProviderAttributesList, resourceEnvProviderAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createCompleteResourceEnvProviderAtScope("myScope",
"myResEnvProvider", "myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String",
"myResEnvEntry", "res1/myResEnv")
AdminResources.createCompleteResourceEnvProviderAtScope("Node=AMYLIN4Node09, server=server1", "myResEnvProvider", "myProp",
"myPropValue", "com.ibm.resource.res1", "java.lang.String", "myResEnvEntry", "res1/myResEnv", "classpath=c:/temp,
description='this is my resource provider', nativepath=c:/temp/nativepath,
isolatedClassLoader=false", "category=myCategory, description='this is my resource entry',
referenceable=(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)")
以下示例脚本包含列表格式的可选属性:
AdminResources.createCompleteResourceEnvProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myResEnvProvider",
"myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String", "myResEnvEntry", "res1/myResEnv", [['classpath', 'c:/temp'],
['description', 'this is my resource provider'], ['nativepath','c:/temp/nativepath'], ['isolatedClassLoader', 'false']]
[['category', 'myCategory'], ['description', 'this is my resource entry'],
['referenceable', '(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)']])
createResourceEnvEntries
此脚本会在您的配置中创建资源环境条目。在应用程序服务器名称空间中,将把资源环境条目中包含的数据转换成代表物理资源的对象。此资源通常称为环境资源。 此脚本返回所创建资源环境条目的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
resourceEnvProviderName | 指定此条目的资源环境提供程序。提供程序封装了一些类,如果实现这些类,那么它们会将资源环境条目数据转换为资源对象。 |
referenceable | 指定可引用对象。可引用对象封装某个工厂的类名,该工厂将资源环境条目数据转换为物理资源的类实例。 |
resourceEnvEntry | 为要创建的资源环境条目指定名称。 |
JNDIName | 指定使用 JNDI 查找此环境资源时要使用的字符串。这是您绑定到资源环境引用部署描述符的字符串。 |
语法
AdminResources.createResourceEnvEntries(nodeName,
serverName, resourceEnvProviderName, referenceable,
resourceEnvEntry, JNDIName)
用法示例
AdminResources.createResourceEnvEntries("myNode", "myServer",
"myResEnvProvider", "com.ibm.resource.res1", "myResEnvEntry", "res1/myResEnv")
createResourceEnvEntriesAtScope
此脚本会在配置中所指定作用域内创建资源环境条目。在应用程序服务器名称空间中,将把资源环境条目中包含的数据转换成代表物理资源的对象。此资源通常称为环境资源。此脚本返回指定作用域的所创建资源环境条目的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
resourceEnvProviderName | 指定此条目的资源环境提供程序。提供程序封装了一些类,如果实现这些类,那么它们会将资源环境条目数据转换为资源对象。 |
resourceEnvEntry | 为要创建的资源环境条目指定名称。 |
JNDIName | 指定使用 JNDI 查找此环境资源时要使用的字符串。这是您绑定到资源环境引用部署描述符的字符串。 |
otherAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
category | 指定可用来对资源进行分类或分组的类别。 |
description | 指定资源提供程序的描述。 |
providerType | 指定此资源环境提供程序使用的邮件提供程序类型。 |
referenceable | 指定可引用对象。可引用对象封装某个工厂的类名,该工厂将资源环境条目数据转换为物理资源的类实例。 |
语法
AdminResources.createResourceEnvEntriesAtScope(scope,
resourceEnvProviderName,
resourceEnvEntry, JNDIName, otherAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createResourceEnvEntriesAtScope("myScope",
"myResEnvProvider", "myResEnvEntry", "res1/myResEnv")
AdminResources.createResourceEnvEntriesAtScope("Node=AMYLIN4Node09, server=server1", "myResEnvProvider",
"myResEnvEntry", "res1/myResEnv", "category=myCategory, description='this is my resource entry',
referenceable=(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)")
以下示例脚本包含列表格式的可选属性:
AdminResources.createResourceEnvEntriesAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myResEnvProvider",
"myResEnvEntry", "res1/myResEnv", [['category', 'myCategory'], ['description', 'this is my resource entry'],
['referenceable', '(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09|resources.xml#Referenceable_1238331401156)']])
createResourceEnvProvider
此脚本会在您的配置中创建资源环境提供程序。资源环境提供程序封装了一些类,如果实现这些类,那么它们会将资源环境条目数据转换为资源对象。此脚本返回所创建资源环境提供程序的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
resourceEnvProviderName | 指定要创建的资源环境提供程序。 |
语法
AdminResources.createResourceEnvProvider(nodeName,
serverName, resourceEnvProviderName)
用法示例
AdminResources.createResEnvProvider("myNode", "myServer",
"myResEnvProvider")
createResourceEnvProviderAtScope
此脚本会在配置中所指定作用域内创建资源环境提供程序。资源环境提供程序封装了一些类,如果实现这些类,那么它们会将资源环境条目数据转换为资源对象。此脚本返回指定作用域的所创建资源环境提供程序的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
resourceEnvProviderName | 指定要创建的资源环境提供程序。 |
otherAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
classpath | 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。 |
description | 指定资源环境提供程序的描述。 |
isolatedClassLoader | 如果设置为 true,那么指定此资源环境提供程序通过它自己的类装入器装入。 注意: 当指定了本机库路径时,无法隔离提供程序。
|
nativepath | 指定任何本机库(例如 *.dll 和 *.so)的可选路径。请使用分号 (;) 来分隔本机路径条目。 |
providerType | 指定此资源环境提供程序使用的资源提供程序类型。 |
语法
AdminResources.createResourceEnvProviderAtScope(scope,
resourceEnvProviderName, otherAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createResEnvProviderAtScope("myScope",
"myResEnvProvider")
AdminResources.createResourceEnvProviderAtScope("Node=AMYLIN4Node09, server=server1", "myResEnvProvider",
"classpath=c:/temp, description='this is my resource provider', nativepath=c:/temp/nativepath, isolatedClassLoader=false")
以下示例脚本包含列表格式的可选属性:
AdminResources.createResourceEnvProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/",
"myResEnvProvider", [['classpath', 'c:/temp'],
['description','this is my resource provider'], ['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'false']])
createResourceEnvProviderRef
此脚本会在您的配置中创建资源环境提供程序引用。资源环境引用不同于资源引用。资源环境引用允许您的应用程序客户机使用逻辑名来查找绑定在服务器 JNDI 名称空间的资源。资源引用允许应用程序使用逻辑名来查找本地 JEE 资源。JEE 规范不指定资源的特定实现。此脚本返回所创建资源环境提供程序引用标识的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
resourceEnvProviderName | 指定此引用的资源环境提供程序。提供程序封装了一些类,如果实现这些类,那么它们会将资源环境条目数据转换为资源对象。 |
factoryClass | 指定将资源环境条目数据转换为物理资源的类实例的工厂类。 |
className | 指定要与可引用对象关联的类名。 |
语法
AdminResources.createResourceEnvProviderRef(nodeName,
serverName, resourceEnvProviderName, factoryClass,
className)
用法示例
AdminResources.createResourceEnvProviderRef("myNode", "myServer",
"myResEnvProvider", "com.ibm.resource.res1", "java.lang.String")
createResourceEnvProviderRefAtScope
此脚本会在配置中所指定作用域内创建资源环境提供程序引用。资源环境引用不同于资源引用。 资源环境引用允许您的应用程序客户机使用逻辑名来查找绑定在服务器 JNDI 名称空间的资源。资源引用允许应用程序使用逻辑名来查找本地 JEE 资源。JEE 规范不指定资源的特定实现。此脚本返回指定作用域的所创建资源环境提供程序引用标识的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
resourceEnvProviderName | 指定此引用的资源环境提供程序。提供程序封装了一些类,如果实现这些类,那么它们会将资源环境条目数据转换为资源对象。 |
factoryClass | 指定将资源环境条目数据转换为物理资源的类实例的工厂类。 |
className | 指定要与可引用对象关联的类名。 |
语法
AdminResources.createResourceEnvProviderRefAtScope(scope,
resourceEnvProviderName, factoryClass,
className, otherAttributesList)
用法示例
AdminResources.createResourceEnvProviderRefAtScope("/Node:AMYLIN4Node09/Server:server1/",
"myResEnvProvider", "com.ibm.resource.res1", "java.lang.String")
configURLProvider
此脚本配置 URL 提供程序,该提供程序提供应用程序服务器通过特定协议访问 URL 时所必需的实现类。缺省 URL 提供程序允许通过 IBM® Developer Kit 支持的协议来进行连接。这些协议包括适用于大多数 URL 的 HTTP 和文件传输协议 (FTP)。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
URLProviderName | 指定要配置的 URL 提供程序的名称。 |
URLStreamHandlerClass | 指定用户定义的 Java 类(针对特定 URL 协议如 FTP 扩展 java.net.URLStreamHandler 类)的标准名称。 |
URLProtocol | 指定这个流处理程序支持的协议。例如,NNTP、SMTP、FTP。 |
propName | 指定要为 URL 提供程序设置的定制属性的名称。 |
propValue | 指定要为 URL 提供程序设置的定制属性的值。 |
URLName | 指定指向因特网或内部网资源的统一资源定位符 (URL) 名称。例如:http://www.ibm.com。 |
JNDIName | 指定 JNDI 名称。请不要在不同资源类型(如邮件会话与 URL 配置)间指定重复的 JNDI 名称。不要对同一作用域中的同一类型的多个资源指定重复的 JNDI 名称。 |
URLSpec | 指定构成 URL 的字符串。 |
语法
AdminResources.configURLProvider(nodeName, serverName,
URLProviderName, URLStreamHandlerClass, URLProtocol,
propName, propValue, URLName, JNDIName,
URLSpec)
用法示例
AdminResources.configURLProvider("myNode", "myServer", "myURLProvider",
"com.ibm.resource.url1", "ftp", "myProp", "myPropValue", "myURL", "url1/myURL",
"myURLSpec")
createCompleteURLProvider
此脚本创建 URL 提供程序,该提供程序提供应用程序服务器通过特定协议访问 URL 时所必需的实现类。缺省 URL 提供程序允许通过 IBM Developer Kit 支持的协议来进行连接。这些协议包括适用于大多数 URL 的 HTTP 和文件传输协议 (FTP)。此脚本返回所创建 URL 提供程序的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
URLProviderName | 指定要配置的 URL 提供程序的名称。 |
URLStreamHandlerClass | 指定用户定义的 Java 类(针对特定 URL 协议如 FTP 扩展 java.net.URLStreamHandler 类)的标准名称。 |
URLProtocol | 指定这个流处理程序支持的协议。例如,NNTP、SMTP、FTP。 |
语法
AdminResources.createCompleteURLProvider(nodeName,
serverName, URLProviderName, URLStreamHandlerClass,
URLProtocol)
用法示例
AdminResources.createCompleteURLProvider("myNode", "myServer",
"myURLProvider", "com.ibm.resource.url1", "ftp")
createCompleteURLProviderAtScope
此脚本会在所指定作用域中创建 URL 提供程序。URL 提供程序提供应用程序服务器通过特定协议访问 URL 时所必需的实现类。缺省 URL 提供程序允许通过 IBM Developer Kit 支持的协议来进行连接。这些协议包括适用于大多数 URL 的 HTTP 和文件传输协议 (FTP)。此脚本返回指定作用域的所创建 URL 提供程序的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
URLProviderName | 指定要配置的 URL 提供程序的名称。 |
URLStreamHandlerClass | 指定用户定义的 Java 类(针对特定 URL 协议如 FTP 扩展 java.net.URLStreamHandler 类)的标准名称。 |
URLProtocol | 指定这个流处理程序支持的协议。例如,NNTP、SMTP、FTP。 |
propName | 指定要为 URL 提供程序设置的定制属性的名称。 |
propValue | 指定要为 URL 提供程序设置的定制属性的值。 |
URLName | 指定指向因特网或内部网资源的统一资源定位符 (URL) 名称。例如:http://www.ibm.com。 |
jndiName | 指定 JNDI 名称。请不要在不同资源类型(如邮件会话与 URL 配置)间指定重复的 JNDI 名称。不要对同一作用域中的同一类型的多个资源指定重复的 JNDI 名称。 |
URLSpec | 指定构成 URL 的字符串。 |
otherAttributesList、urlProviderAttributesList 和 urlAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
classpath | 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。 |
description | 指定资源环境提供程序的描述。 |
isolatedClassLoader | 如果设置为 true,那么指定此 URL 提供程序通过它自己的类装入器装入。 注意: 当指定了本机库路径时,无法隔离提供程序。
|
nativepath | 指定任何本机库(例如 *.dll 和 *.so)的可选路径。请使用分号 (;) 来分隔本机路径条目。 |
providerType | 指定此资源环境提供程序使用的 URL 提供程序类型。 |
属性 | 描述 |
---|---|
category | 指定可用来对资源进行分类或分组的类别。 |
description | 指定资源提供程序的描述。 |
providerType | 指定此资源环境提供程序使用的邮件提供程序类型。 |
referenceable | 指定可引用对象。可引用对象封装某个工厂的类名,该工厂将资源环境条目数据转换为物理资源的类实例。 |
语法
AdminResources.createCompleteURLProviderAtScope(Scope,
URLProviderName, URLStreamHandlerClass,
URLProtocol, propName, propValue,
URLName, JNDIName, URLSpec, otherAttributesList,
urlProviderAttributesList, urlAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createCompleteURLProviderAtScope("Scope",
"myURLProvider", "com.ibm.resource.url1", "ftp", myProp", myPropValue",
"myURL", "url1/myURL", "myURLSpec")
AdminResources.createCompleteURLProviderAtScope("Node=AMYLIN4Node09, server=server1", "myURLProvider",
"com.ibm.resource.url1",
"ftp","myProp", "myPropValue", "myURL", "url1/myURL", "myURLSpec", "classpath=c:/temp, description='this
is my url provider',
nativepath=c:/temp/nativepath, isolatedClassLoader=true", "category=myCategory, description='this is my url'")
以下示例脚本包含列表格式的可选属性:
AdminResources.createCompleteURLProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/",
"myURLProvider", "com.ibm.resource.url1",
"ftp","myProp", "myPropValue", "myURL", "url1/myURL", "myURLSpec", [['classpath', 'c:/temp'],
['description', 'this is my urlProvider'],
['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'true']] [['category', 'myCategory'],
['description', 'this is my url']])
createURL
此脚本创建 URL 提供程序,该提供程序提供应用程序服务器通过特定协议访问 URL 时所必需的实现类。缺省 URL 提供程序允许通过 IBM Developer Kit 支持的协议来进行连接。这些协议包括适用于大多数 URL 的 HTTP 和文件传输协议 (FTP)。此脚本返回所创建 URL 的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
URLProviderName | 指定要对其分配 URL 的 URL 提供程序的名称。 |
URLName | 指定要创建的 URL 的名称。 |
JNDIName | 指定 JNDI 名称。请不要在不同资源类型(如邮件会话与 URL 配置)间指定重复的 JNDI 名称。不要对同一作用域中的同一类型的多个资源指定重复的 JNDI 名称。 |
URLSpec | 指定构成 URL 的字符串。 |
语法
AdminResources.createURL(nodeName, serverName,
URLProviderName, URLName, JNDIName,
URLSpec)
用法示例
AdminResources.createURL("myNode", "myServer", "myURLProvider",
"myURL", "url1/myURL", "myURLSpec")
createURLAtScope
此脚本会在所指定作用域中创建 URL 提供程序。URL 提供程序提供应用程序服务器通过特定协议访问 URL 时所必需的实现类。缺省 URL 提供程序允许通过 IBM Developer Kit 支持的协议来进行连接。这些协议包括适用于大多数 URL 的 HTTP 和文件传输协议 (FTP)。此脚本返回指定作用域的所创建 URL 的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
URLProviderName | 指定要对其分配 URL 的 URL 提供程序的名称。 |
URLName | 指定要创建的 URL 的名称。 |
JNDIName | 指定 JNDI 名称。请不要在不同资源类型(如邮件会话与 URL 配置)间指定重复的 JNDI 名称。不要对同一作用域中的同一类型的多个资源指定重复的 JNDI 名称。 |
URLSpec | 指定构成 URL 的字符串。 |
otherAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
category | 指定可用来对资源进行分类或分组的类别。 |
description | 指定 URL 提供程序的描述。 |
providerType | 指定此 URL 提供程序使用的邮件提供程序类型。 |
语法
AdminResources.createURLAtScope(scope,
URLProviderName, URLName, JNDIName,
URLSpec, otherAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createURLAtScope("myScope", "myURLProvider",
"myURL", "url1/myURL", "myURLSpec")
AdminResources.createURLAtScope("Node=AMYLIN4Node09, server=server1", "myURLProvider", "myURL", "url1/myURL",
"myURLSpec", "category=myCategory, description='this is my url'")
以下示例脚本包含列表格式的可选属性:
AdminResources.createURLAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/",
"myURLProvider", "myURL", "url1/myURL", "myURLSpec", [['category', 'myCategory'], ['description', 'this is my url']])
createURLProvider
此脚本创建 URL 提供程序,该提供程序提供应用程序服务器通过特定协议访问 URL 时所必需的实现类。缺省 URL 提供程序允许通过 IBM Developer Kit 支持的协议来进行连接。这些协议包括适用于大多数 URL 的 HTTP 和文件传输协议 (FTP)。此脚本返回所创建 URL 提供程序的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
URLProviderName | 指定要配置的 URL 提供程序的名称。 |
URLStreamHandlerClass | 指定用户定义的 Java 类(针对特定 URL 协议如 FTP 扩展 java.net.URLStreamHandler 类)的标准名称。 |
URLProtocol | 指定这个流处理程序支持的协议。例如,NNTP、SMTP、FTP。 |
语法
AdminResources.createURLProvider(nodeName,
serverName, URLProviderName, URLStreamHandlerClass,
URLProtocol)
用法示例
AdminResources.createURLProvider("myNode", "myServer",
"myURLProvider", "com.ibm.resource.url1", "ftp")
createURLProviderAtScope
此脚本会在所指定作用域中创建 URL 提供程序。URL 提供程序提供应用程序服务器通过特定协议访问 URL 时所必需的实现类。缺省 URL 提供程序允许通过 IBM Developer Kit 支持的协议来进行连接。这些协议包括适用于大多数 URL 的 HTTP 和文件传输协议 (FTP)。此脚本返回指定作用域的所创建 URL 提供程序的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
URLProviderName | 指定要配置的 URL 提供程序的名称。 |
URLStreamHandlerClass | 指定用户定义的 Java 类(针对特定 URL 协议如 FTP 扩展 java.net.URLStreamHandler 类)的标准名称。 |
URLProtocol | 指定这个流处理程序支持的协议。例如,NNTP、SMTP、FTP。 |
otherAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
classpath | 指定路径或 Java 归档 (JAR) 文件名的列表,这些路径或文件名一起构成资源提供程序类的位置。请使用分号 (;) 来分隔类路径。 |
description | 指定资源环境提供程序的描述。 |
isolatedClassLoader | 如果设置为 true,那么指定此 URL 提供程序通过它自己的类装入器装入。 注意: 当指定了本机库路径时,无法隔离提供程序。
|
nativepath | 指定任何本机库(例如 *.dll 和 *.so)的可选路径。请使用分号 (;) 来分隔本机路径条目。 |
providerType | 指定此资源环境提供程序使用的 URL 提供程序类型。 |
语法
AdminResources.createURLProviderAtScope(scope,
URLProviderName, URLStreamHandlerClass,
URLProtocol, otherAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createURLProviderAtScope("myScope",
"myURLProvider", "com.ibm.resource.url1", "ftp")
AdminResources.createURLProviderAtScope("Node=AMYLIN4Node09, server=server1", "myURLProvider", "com.ibm.resource.url1",
"ftp", "classpath=c:/temp, description='this is my url provider', nativepath=c:/temp/nativepath, isolatedClassLoader=true")
以下示例脚本包含列表格式的可选属性:
AdminResources.createURLProviderAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myURLProvider", "com.ibm.resource.url1",
"ftp", [['classpath', 'c:/temp'], ['description', 'this is my url provider'], ['nativepath', 'c:/temp/nativepath'],
['isolatedClassLoader', 'true']])
createJAASAuthenticationAlias
此脚本创建 Java 认证和授权服务 (JAAS) 认证别名。该别名标识认证数据条目。当配置资源适配器或数据源时,管理员可以使用相应别名来指定要选择哪些认证数据。此脚本返回所创建 DB2® 认证和授权服务 (JAAS) 认证别名的配置标识。
自变量 | 描述 |
---|---|
authAliasName | 指定要创建的认证别名的名称。 |
authAliasID | 有意安全域的用户标识。例如,如果特定认证数据条目用来打开与 DB2 的新连接,那么此条目包含 DB2 用户标识。 |
authAliasPW | 指定在配置库中对用户标识的密码进行编码。 |
语法
AdminResources.createJAASAuthenticationAlias(authAliasName,
authAliasID, authAliasPW)
用法示例
AdminResources.createJAASAuthenticationAlias("myJAAS", "user01",
"password")
createLibraryRef
此脚本创建库引用,库引用定义如何使用全局库。要在部署于服务器上的多个应用程序上获得库文件的第一步是为应用程序需要的每个库文件创建共享库。在创建共享库时,请为库文件设置变量。此脚本返回所创建库引用的配置标识。
自变量 | 描述 |
---|---|
libraryRefName | 指定要创建的库引用的名称。 |
applicationName | 指定要与库引用关联的应用程序的名称。 |
语法
AdminResources.createLibraryRef(libraryRefName,
applicationName)
用法示例
AdminResources.createLibraryRef("myLibrary", "myApplication")
createSharedLibrary
此脚本会在您的配置中创建共享库。要在部署于服务器上的多个应用程序上获得库文件的第一步是为应用程序需要的每个库文件创建共享库。在创建共享库时,请为库文件设置变量。此脚本返回所创建库的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
sharedLibName | 指定要分配给共享库的名称。 |
sharedLibClassPath | 指定产品在其中搜索共享库的类和资源的文件路径。如果列表中的路径是文件,那么产品搜索该 .jar 或压缩 .zip 文件的内容。如果列表中的路径是目录,那么产品搜索该目录中的 .jar 和 .zip 文件的内容。由于性能原因,仅当目录包含子目录或除 .jar 或 .zip 文件之外的文件时,产品才搜索该目录本身。 |
语法
AdminResources.createSharedLibrary(nodeName,
serverName, sharedLibName, sharedLibClassPath)
用法示例
![[Windows]](../images/windows.gif)
AdminResources.createSharedLibrary("myNode", "myServer",
"myLibrary", "c:/myLibrary.zip")
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminResources.createSharedLibrary("myNode", "myServer", "myLibrary",
"/myLibrary.zip")
createSharedLibraryAtScope
此脚本会在配置中所指定作用域内创建共享库。要在部署于服务器上的多个应用程序上获得库文件的第一步是为应用程序需要的每个库文件创建共享库。在创建共享库时,请为库文件设置变量。此脚本返回指定作用域的所创建库的配置标识。
自变量 | 描述 |
---|---|
scope | 为邮件提供程序指定单元、节点、服务器或集群的作用域。 |
sharedLibName | 指定要分配给共享库的名称。 |
sharedLibClassPath | 指定产品在其中搜索共享库的类和资源的文件路径。如果列表中的路径是文件,那么产品搜索该 .jar 或压缩 .zip 文件的内容。如果列表中的路径是目录,那么产品搜索该目录中的 .jar 和 .zip 文件的内容。由于性能原因,仅当目录包含子目录或除 .jar 或 .zip 文件之外的文件时,产品才搜索该目录本身。 |
otherAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
description | 指定共享库的描述。 |
isolatedClassLoader | 如果设置为 true,那么指定 URL 提供程序通过它自己的类装入器装入。缺省值为 false。 注意: 当指定了本机库路径时,无法隔离提供程序。
|
nativepath | 指定任何本机库(例如 *.dll 和 *.so)的可选路径。请使用分号 (;) 来分隔本机路径条目。 |
语法
AdminResources.createSharedLibraryAtScope(scope,
sharedLibName, sharedLibClassPath, otherAttributesList)
用法示例
以下示例脚本仅包含必需属性:
![[Windows]](../images/windows.gif)
AdminResources.createSharedLibraryAtScope("myScope",
"myLibrary", "c:/myLibrary.zip")
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminResources.createSharedLibraryAtScope("myScope", "myLibrary",
"/myLibrary.zip")
以下示例脚本包含字符串格式的可选属性:
![[Windows]](../images/windows.gif)
AdminResources.createSharedLibraryAtScope("Node=AMYLIN4Node09, server=server1", "myLibrary",
"c:/myLibrary.zip", "description='this is my library',
nativePath=c:/nativepath, isolatedClassLoader=true")
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminResources.createSharedLibraryAtScope("Node=AMYLIN4Node09, server=server1", "myLibrary",
"c:/myLibrary.zip", "description='this is my library',
nativePath=/nativepath, isolatedClassLoader=true")
以下示例脚本包含列表格式的可选属性:
![[Windows]](../images/windows.gif)
AdminResources.createSharedLibraryAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myLibrary",
"c:/myLibrary.zip", [['description', 'this is my library'],
['nativePath', 'c:/nativepath'], ['isolatedClassLoader', 'true']])
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminResources.createSharedLibraryAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myLibrary",
"c:/myLibrary.zip", [['description', 'this is my library'],
['nativePath', '/nativepath'], ['isolatedClassLoader', 'true']])
createScheduler
此脚本会在您的配置中创建调度程序。调度程序是持久的事务计时器服务,它们可以运行业务逻辑。每个调度程序都独立地运行任务并包含编程接口,可以使用 Java 命名和目录接口 (JNDI) 来从 JEE 应用程序中访问该编程接口。您还可以使用 Java 管理扩展 (JMX) MBean 来管理 Scheduler。请参阅信息中心中的调度程序文档,以了解有关如何配置和使用调度程序的详细信息。此脚本返回所创建调度程序的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
schedulerName | 指定用于标识此调度程序的名称,供管理使用。 |
JNDIName | 指定用于确定将此调度程序实例绑定到名称空间中哪个位置的 JNDI 名称。虽然建议使用资源引用,但是客户机可以直接查找此名称。 |
scheduleCategory | 指定可用于对此调度程序进行分类或分组的字符串。 |
datasourceJNDI | 指定用于存储持久任务的数据源的名称。名称空间中的任何可用数据源可与调度程序一起使用。通过指定表前缀使用不同的表时,多个调度程序可以共享单个数据源。 |
tablePrefix | 指定要对调度程序表附加的字符串前缀。如果每个实例指定一个不同的前缀字符串,那么多个独立的调度程序可以共享同一数据库。 |
pollInterval | 指定调度程序轮询数据库的时间间隔(以秒计)。缺省值适用于大多数应用程序。每次轮询操作都会耗用很长时间。如果时间间隔非常小,而又存在许多已调度任务,那么轮询会消耗大部分系统资源。缺省值为 30。 |
workMgmtJNDI | 指定工作管理器的 JNDI 名称,此工作管理器用来管理可以与调度程序同时运行的任务数。工作管理器还可以对应用于任务的 JEE 上下文数量进行限制。 |
语法
AdminResources.createScheduler(nodeName, serverName,
schedulerName, JNDIName, scheduleCategory,
datasourceJNDI, tablePrefix, pollInterval, workMgmtJNDI)
用法示例
AdminResources.createScheduler("myNode", "myServer", "myScheduler",
"myScheduleJndi", "Default", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager")
createSchedulerAtScope
此脚本会在配置中所指定作用域内创建调度程序。调度程序是持久的事务计时器服务,它们可以运行业务逻辑。每个调度程序都独立地运行任务并包含编程接口,可以使用 Java 命名和目录接口 (JNDI) 来从 JEE 应用程序中访问该编程接口。您还可以使用 Java 管理扩展 (JMX) MBean 来管理 Scheduler。请参阅信息中心中的调度程序文档,以了解有关如何配置和使用调度程序的详细信息。此脚本返回指定作用域的所创建调度程序的配置标识。
自变量 | 描述 |
---|---|
scope | 为 JMS 提供程序指定单元、节点、服务器或集群的作用域。 |
schedulerName | 指定用于标识此调度程序的名称,供管理使用。 |
JNDIName | 指定用于确定将此调度程序实例绑定到名称空间中哪个位置的 JNDI 名称。虽然建议使用资源引用,但是客户机可以直接查找此名称。 |
datasourceJNDI | 指定用于存储持久任务的数据源的名称。名称空间中的任何可用数据源可与调度程序一起使用。通过指定表前缀使用不同的表时,多个调度程序可以共享单个数据源。 |
tablePrefix | 指定要对调度程序表附加的字符串前缀。如果每个实例指定一个不同的前缀字符串,那么多个独立的调度程序可以共享同一数据库。 |
pollInterval | 指定调度程序轮询数据库的时间间隔(以秒计)。缺省值适用于大多数应用程序。每次轮询操作都会耗用很长时间。如果时间间隔非常小,而又存在许多已调度任务,那么轮询会消耗大部分系统资源。缺省值为 30。 |
workMgmtJNDI | 指定工作管理器的 JNDI 名称,此工作管理器用来管理可以与调度程序同时运行的任务数。工作管理器还可以对应用于任务的 JEE 上下文数量进行限制。 |
schedulerProviderID | 指定此调度程序的提供程序标识。 |
otherAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
category | 指定可用来对资源进行分类或分组的类别。 |
description | 指定 URL 提供程序的描述。 |
providerType | 指定此 URL 提供程序使用的资源提供程序类型。 |
datasourceAlias | 指定此 URL 提供程序用于访问数据源的用户名的别名和密码。 |
loginConfigName | 指定登录配置名称。 |
securityRole | 指定安全角色。 |
useAdminRoles | 指定当同时启用了此选项和管理安全性时会强制使用用户管理角色。要强制使用用户管理角色,必须使用调度程序 JMX 命令或 API 来创建和修改任务。如果未启用此选项,那么所有用户都可以创建和修改任务。缺省值为 false。 |
referenceable | 指定可引用对象。可引用对象封装某个工厂的类名,该工厂将资源环境条目数据转换为物理资源的类实例。 |
语法
AdminResources.createSchedulerAtScope(scope,
schedulerName, JNDIName,
datasourceJNDI, tablePrefix, pollInterval, workMgmtJNDI,
ScheduleProviderID, otherAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createSchedulerAtScope("myNode", "myScheduler",
"myScheduleJndi", "Default", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager, "SchedulerProvider(cells/AMYLIN4Cell01/nodes/AMY
LIN4Node09/servers/server1|resources-pme.xml#SchedulerProvider_1)")
AdminResources.createSchedulerAtScope("Node=AMYLIN4Node09, server=server1", "myScheduler",
"myScheduleJndi", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager", “SchedulerProvider(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09/servers/server1|
resources-pme.xml#SchedulerProvider_1)", "category=myCategory,
description='this is my scheduler', datasourceAlias=abc, useAdminRoles=false, loginConfigName=test,
securityRole=user1")
以下示例脚本包含列表格式的可选属性:
AdminResources.createSchedulerAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myScheduler",
"myScheduleJndi", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager", "SchedulerProvider(cells/AMYLIN4Cell01/clusters/c1|resources-pme.xml#SchedulerProvider_1)",
[['category', 'myCategory'],
['description', 'this is my scheduler'], ['datasourceAlias', 'abc'], ['useAdminRoles', 'false'],
['loginConfigName', 'test'], ['securityRole', 'user1']])
createWorkManager
此脚本会在您的配置中创建工作管理器。工作管理器包含绑定至 Java 命名和目录接口的线程池。此脚本返回所创建工作管理器的配置标识。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
workMgrName | 指定用于标识此工作管理器的名称,以方便管理。 |
JNDIName | 指定用于在名称空间中查找工作管理器的 Java 命名和目录接口 (JNDI) 名称。 |
workMgrCategory | 指定可用于对该工作管理器进行分类或分组的字符串。 |
alarmThreads | 指定用于警报的预期最大线程数。缺省值为 2。 |
minThreads | 指定此工作管理器中的最小线程数。 |
maxThreads | 指定此工作管理器中的最大线程数。 |
threadPriority | 指定此工作管理器中可用线程的优先级。每个线程都具有优先级。高优先级线程将在低优先级线程之前运行。有关线程优先级使用方式的更多信息,请参阅 Java EE 规范中 java.lang.Thread 类的 setPriority 方法的 API 文档。 |
isGrowable | 指定是否可以增加此工作管理器中的线程数。指定值 true 以指示可增加线程数。 |
serviceNames | 指定要提供给此工作管理器使用的服务列表。 |
语法
AdminResources.createWorkManager(nodeName, serverName,
workMgrName, JNDIName, workMgrCategory,
alarmThreads, minThreads, maxThreads, threadPriority,
isGrowable, serviceNames)
用法示例
AdminResources.createWorkManager("myNode", "myServer", "myWorkManager",
"Work Manager", "wm/myWorkManager", "Default", 5, 1, 10, 5, "true",
"AppProfileService UserWorkArea com.ibm.ws.i18n security")
createWorkManagerAtScope
此脚本会在配置中所指定作用域内创建工作管理器。工作管理器包含绑定至 Java 命名和目录接口的线程池。此脚本返回指定作用域的所创建工作管理器的配置标识。
自变量 | 描述 |
---|---|
scope | 为 JMS 提供程序指定单元、节点、服务器或集群的作用域。 |
workMgrName | 指定用于标识此工作管理器的名称,以方便管理。 |
JNDIName | 指定用于在名称空间中查找工作管理器的 Java 命名和目录接口 (JNDI) 名称。 |
alarmThreads | 指定用于警报的预期最大线程数。缺省值为 2。 |
minThreads | 指定此工作管理器中的最小线程数。 |
maxThreads | 指定此工作管理器中的最大线程数。 |
threadPriority | 指定此工作管理器中可用线程的优先级。每个线程都具有优先级。高优先级线程将在低优先级线程之前运行。有关线程优先级使用方式的更多信息,请参阅 Java EE 规范中 java.lang.Thread 类的 setPriority 方法的 API 文档。 |
workManagerProviderID | 指定父工作管理器提供程序的配置标识。工作管理器是按此标识创建的。可以通过现有工作管理器提供程序或通过新的工作管理器提供程序创建工作管理器。以下
wsadmin 命令是如何从服务器作用域检索现有工作管理器提供程序的配置标识的示例:
|
otherAttributesList | 选择性地以特定格式指定其他属性:
|
属性 | 描述 |
---|---|
category | 指定可用来对资源进行分类或分组的类别。 |
description | 指定 URL 提供程序的描述。 |
providerType | 指定此 URL 提供程序使用的资源提供程序类型。 |
daemonTranClass | 指定用于对守护程序工作进行工作负载分类的事务类。守护程序工作用于工作负载管理器服务。 |
defTranClass | 指定出现以下情况时用于对此工作管理器实例运行的工作进行分类的事务类名:工作上下文信息中未包含 z/OS 工作负载管理器服务类信息。 |
isDistributable | 指定此工作管理器是否可分发。缺省值为 false。 |
isGrowable | 指定是否可以增加此工作管理器中的线程数。缺省值为 true。 |
serviceNames | 指定要提供给此工作管理器使用的服务列表。 |
workReqQFullAction | 指定线程池用尽并且工作请求队列已满时执行的操作。缺省值为 0。 |
workReqQSize | 指定工作请求队列的大小。缺省值为 0。 |
workTimeout | 指定尝试释放工作单元前等待的时间(以毫秒计)。缺省值为 0。 |
referenceable | 指定可引用对象。可引用对象封装某个工厂的类名,该工厂将资源环境条目数据转换为物理资源的类实例。 |
otherAttributesList | 选择性地以特定格式指定其他属性:
|
语法
AdminResources.createWorkManagerAtScope(scope,
workMgrName, JNDIName,
alarmThreads, minThreads, maxThreads, threadPriority,
workManagerProviderID, otherAttributesList)
用法示例
以下示例脚本仅包含必需属性:
AdminResources.createWorkManagerAtScope("scope", "myWorkManager",
"Work Manager", "Default", 5, 1, 10,
"WorkManagerProvider(cells/AMYLIN4Cell01/nodes/A
MYLIN4Node09/servers/server1|resources-pme.xml#WorkManagerProvider_1)")
AdminResources.createWorkManagerAtScope("Node=AMYLIN4Node09, server=server1", "myWorkManager",
"wm/myWorkManager", "5", "1", "10", "5",
"WorkManagerProvider(cells/AMYLIN4Cell01/nodes/AMYLIN4Node09/servers/server1|resources-pme.xml#WorkManagerProvider_1)")
以下示例脚本包含列表格式的可选属性:
AdminResources.createWorkManagerAtScope("/Cell:AMYLIN4Cell01/ServerCluster:c1/", "myWorkManager",
"wm/myWorkManager", "5", "1", "10", "5",
WorkManagerProvider(cells/AMYLIN4Cell01/clusters/c1|resources-pme.xml#WorkManagerProvider_1)",
[['category', 'myCategory'], ['description', 'this is my workmanager'],
['daemonTranClass', ''], ['defTranClass', ''], ['isDistributable', 'false'], ['isGrowable', 'true'],
['serviceNames', 'security'], ['workReqQFullAction', 0],
['workReqQSize', 0], ['workTimeout', 10]])
help
自变量 | 描述 |
---|---|
script | 指定相关脚本的名称。 |
语法
AdminResources.help(script)
用法示例
AdminResources.help("createWorkManager")