使用 wsadmin 脚本编制的 AdminApp 对象 install、installInteractive、edit、editInteractive、update 和 updateInteractive 命令的选项

本主题列示了 AdminApp 对象的 install、installInteractive、edit、editInteractive、 update 和 updateInteractive 命令的可用选项。

可以使用 AdminApp 对象的命令来安装、编辑、更新和管理应用程序配置。此主题提供了其他可以在 install、installInteractive、edit、editInteractive、update 和 updateInteractive 命令中使用以便对应用程序进行管理的选项。本主题中列出的选项适用于所有这些命令，除非另有声明。

您可以在批处理方式下使用选项来设置或更新配置值。为了确定要设置或更新哪个配置对象，将使用只读字段的值来查找相应的配置对象。只读字段的所有值都必须与现有配置对象匹配，否则命令将失败。

您可以使用模式匹配来简化为某些复杂选项提供必需值的任务。模式匹配仅适用于必需字段或只读字段。

注意: 如果应用程序正在运行，那么更改应用程序设置会导致应用程序重新启动。在独立服务器上，应用程序在您保存更改后将重新启动。在多服务器产品上，应用程序将在您保存更改后重新启动，并且在安装应用程序的节点上，文件将同步。要控制对多服务器产品进行同步的时间，请取消选择控制台首选项页面上的将更改与节点同步。

以下选项可用于 install、installInteractive、edit、editInteractive、update 和 updateInteractive 命令：

ActSpecJNDI
allowDispatchRemoteInclude
allowPermInFilterPolicy
allowServiceRemoteInclude
appname
BackendIdSelection
BindJndiForEJBBusiness
BindJndiForEJBMessageBinding
BindJndiForEJBNonMessageBinding
blaname
buildVersion
单元 (cell)
clientMode
集群
内容
contenturi
contextroot
CorrectOracleIsolationLevel
CorrectUseSystemIdentity
createMBeansForResources
CtxRootForWebMod
定制
CustomActivationPlan
DataSourceFor10CMPBeans
DataSourceFor20CMPBeans
DataSourceFor10EJBModules
DataSourceFor20EJBModules
defaultbinding.cf.jndi
defaultbinding.cf.resauth
defaultbinding.datasource.jndi
defaultbinding.datasource.password
defaultbinding.datasource.username
defaultbinding.ee.defaults
defaultbinding.ejbjndi.prefix
defaultbinding.force
defaultbinding.strategy.file
defaultbinding.virtual.host
depl.extension.reg（建议不要使用）
deployejb
deployejb.classpath
deployejb.complianceLevel
deployejb.dbschema
deployejb.dbtype
deployejb.dbaccesstype
deployejb.rmic
deployejb.sqljclasspath
deployws
deployws.classpath
deployws.jardirs
distributeApp
EmbeddedRar
enableClientModule
EnsureMethodProtectionFor10EJB
EnsureMethodProtectionFor20EJB
filepermission
installdir（建议不要使用）
installed.ear.destination
JSPCompileOptions
JSPReloadForWebMod
MapEJBRefToEJB
MapEnvEntryForApp
MapEnvEntryForClientMod
MapEnvEntryForEJBMod
MapEnvEntryForWebMod
MapInitParamForServlet
MapJaspiProvider
MapMessageDestinationRefToEJB
MapModulesToServers
MapResEnvRefToRes
MapResRefToEJB
MapRolesToUsers
MapRunAsRolesToUsers
MapSharedLibForMod
MapWebModToVH
MetadataCompleteForModules
ModuleBuildID
noallowDispatchRemoteInclude
noallowPermInFilterPolicy
noallowServiceRemoteInclude
节点
nocreateMBeansForResources
nodeployejb
nodeployws
nodistributeApp
noenableClientModule
noreloadEnabled
nopreCompileJSPs
noprocessEmbeddedConfig
nouseAutoLink
nouseMetaDataFromBinary
nousedefaultbindings
novalidateSchema
操作
processEmbeddedConfig
preCompileJSPs
reloadEnabled
reloadInterval
SharedLibRelationship
服务器
目标
更新
update.ignore.new
update.ignore.old
useAutoLink
usedefaultbindings
useMetaDataFromBinary
validateinstall
validateSchema
Verbose
WebServicesClientBindDeployedWSDL
WebServicesClientBindPortInfo
WebServicesClientBindPreferredPort
WebServicesServerBindPort
WebServicesClientCustomProperty
WebServicesServerCustomProperty

ActSpecJNDI

ActSpecJNDI 选项将 Java™ 2 连接器 (J2C) 激活规范绑定到目标 Java 命名和目录接口 (JNDI) 名称。可根据情况将应用程序或模块中的 J2C 激活规范绑定至目标 JNDI 名称。可以对 ActSpecJNDI 选项的如下各个元素进行赋值：RARModule、uri、j2cid 和 j2c.jndiName 字段。运行缺省绑定后该选项的内容包括：

RARModule；<rar module name>
uri：<rar name>,META-INF/ra.xml
对象标识：<messageListenerType>
JNDI 名称：Null

要使用此选项，您必须在 ra.xml 文件中指定 Destination 属性，并且将 Destination 属性的自省类型设置为 javax.jms.Destination。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install $embeddedEar {-ActSpecJNDI
 {{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener jndi5}
 {"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener2 jndi6}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install $embeddedEar {-ActSpecJNDI
 {{.* .*.rar,.* javax.jms.MessageListener jndi5}
 {.*  .*.rar,.*  javax.jms.MessageListener2 jndi6}}}

使用 Jython：

AdminApp.install(embeddedEar, ['-ActSpecJNDI',
 [["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'jndi5'],
 ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener2', 'jndi6']]])

将 Jython 与模式匹配配合使用：

AdminApp.install(embeddedEar, ['-ActSpecJNDI',
 [['.*', '.*.rar,.*', 'javax.jms.MessageListener', 'jndi5'],
 ['.*', '.*.rar,.*', 'javax.jms.MessageListener2', 'jndi6']]])

allowDispatchRemoteInclude

allowDispatchRemoteInclude 选项使企业应用程序能够通过标准请求分派器机制将包含内容分派给受管节点环境中不同 Java 虚拟机中的 Web 模块中的资源。

批处理方式示例用法

使用 Jacl：

set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowDispatchRemoteInclude true]
set attrs [list $rrdLocalAttr]
$AdminConfig modify $deploymentObject $attrs

使用 Jython：

deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute (deployments, 'deployedObject')
rrdAttr = ['allowDispatchRemoteInclude', 'true']
attrs = [rrdLocalAttr]
AdminConfig.modify (deploymentObject, attrs)

allowPermInFilterPolicy

allowPermInFilterPolicy 选项指定应用程序服务器应该继续应用程序部署过程，即使应用程序包含过滤器策略中的策略许可权时亦如此。此选项不需要值。

allowServiceRemoteInclude

allowServiceRemoteInclude 选项使企业应用程序能够为 allowDispatchRemoteInclude 选项设置为 true 的企业应用程序中的包含请求提供服务。

批处理方式示例用法

使用 Jacl：

set deployments [$AdminConfig getid /Deployment:RRDEnabledAppname/]
set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]
set rrdAttr [list allowServiceRemoteInclude true]
set attrs [list $rrdAttr]
$AdminConfig modify $deploymentObject $attrs

使用 Jython：

deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute ('deployments', 'deployedObject')
rrdAttr = ['allowServiceRemoteInclude', 'true']
attrs = [rrdAttr] 
AdminConfig.modify (deploymentObject, attrs)

appname

appname 选项指定应用程序的名称。缺省值为应用程序的显示名称。

BackendIdSelection

BackendIdSelection 选项为具有容器管理的持久性 (CMP) Bean 的企业 Bean Java 归档 (JAR) 模块指定后端标识。企业 bean JAR 模块可以支持多后端配置，如使用应用程序组装工具所指定的那样。在安装期间，使用此选项更改后端标识。

批处理方式示例用法

使用 Jacl：

$AdminApp install myapp.ear {-BackendIdSelection 
 {{Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml DB2UDBNT_V72_1}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-BackendIdSelection 
 {{.* Annuity20EJB.jar,.* DB2UDBNT_V72_1}}}

使用 Jython：

AdminApp.install('myapp.ear', '[-BackendIdSelection 
 [[Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml DB2UDBNT_V72_1]]]')

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-BackendIdSelection',
 [['.*', 'Annuity20EJB.jar,.*', 'DB2UDBNT_V72_1']]])

BindJndiForEJBBusiness

BindJndiForEJBBusiness 选项将带业务接口的 EJB 模块绑定至 JNDI 名称。确保每个带业务接口的 EJB 模块都绑定至 JNDI 名称。

运行缺省绑定后此选项的当前内容包括：

模块：Ejb1
Bean：MessageBean
URI：sample.jar,META-INF/ejb-jar.xml
业务接口：com.ibm.sample.business.bnd.LocalTargetOne
JNDI 名称：[]：ejblocal:ejb/LocalTargetOne

如果使用 BindJndiForEJBNonMessageBinding 选项指定目标资源 JNDI 名称，请不要在 BindJndiForEJBBusiness 选项中指定业务接口 JNDI 名称。如果未指定目标资源 JNDI 名称，请指定业务接口 JNDI 名称。如果您未指定业务接口 JNDI 名称，那么运行时将提供容器缺省值。

对于非接口视图，业务接口值为空字符串 ("")。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install $ear {-BindJndiForEJBBusiness {{ ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 }}}

将 Jacl 与模式匹配配合使用：

$AdminApp install $ear {-BindJndiForEJBBusiness {{ .* .* .*.jar,.* test.ejb1 jndi1 }}}

使用 Jython：

AdminApp.install(ear, '[-BindJndiForEJBBusiness [[ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 ]]]')

将 Jython 与模式匹配配合使用：

AdminApp.install(ear, '[-BindJndiForEJBBusiness [[.* .* .*.jar,.* test.ejb1 jndi1]]]')

BindJndiForEJBMessageBinding

BindJndiForEJBMessage绑定选项将消息驱动的企业 Bean 绑定到侦听器端口名或激活规范 Java 命名和目录接口 (JNDI) 名称。使用此选项提供缺少的数据或更新任务。当消息驱动的企业 Bean 绑定至激活规范 JNDI 名称时，您还可以指定目标 JNDI 名称和认证别名。

BindJndiForEJBMessage绑定选项的每个元素都包含以下字段 :EJBModule ， EJB ， uri ， listenerPort， JNDI ， jndi.dest和 actspec.auth。可以为这些字段中的某些字段指定值: listenerPort， JNDI ， jndi.dest和 actspec.auth。

运行缺省绑定后此选项的当前内容包括：

模块：Ejb1
Bean：MessageBean
URI：ejb-jar-ic.jar,META-INF/ejb-jar.xml
侦听器端口：[Null]：
JNDI 名称：[eis/MessageBean]：
目标 JNDI 名称：[jms/TopicName]：
激活规范认证别名：[Null]：

如果 destinationLookup 激活配置属性未作为注释提供或未在部署描述符中提供，且 IBM 绑定文件中没有目标 JNDI 名称，那么会从相应消息引用中收集缺省目标 JNDI 名称。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install $ear {-BindJndiForEJBMessageBinding {{Ejb1 MessageBean 
 ejb-jar-ic.jar,META-INF/ejb-jar.xml myListenerPort jndi1 jndiDest1 actSpecAuth1}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install $ear {-BindJndiForEJBMessageBinding {{.*  .*
  .*.jar,.* myListenerPort jndi1 jndiDest1 actSpecAuth1}}}

使用 Jython：

AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['Ejb1', 'MessageBean', 'ejb-jar-ic.jar,META-INF/ejb-jar.xml', 'myListenerPort',
 'jndi1', 'jndiDest1', 'actSpecAuth1']]])

将 Jython 与模式匹配配合使用：

AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['.*', '.*', '.*.jar,.*', 'myListenerPort', 'jndi1', 'jndiDest1', 'actSpecAuth1']]])

BindJndiForEJBNonMessageBinding

BindJndiForEJBNonMessageBinding 选项将企业 Bean 绑定到 Java 命名和目录接口 (JNDI) 名称。确保您的应用程序或模块中的每个非每个消息驱动的企业 Bean 绑定至一个 JNDI 名称。使用此选项提供缺少的数据或更新任务。

运行缺省绑定后此选项的当前内容包括：

模块：Ejb1
Bean：MessageBean
URI：ejb-jar-ic.jar,META-INF/ejb-jar.xml
目标资源 JNDI 名称：[com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC]
本地主 JNDI 名称：[Null]
远程主 JNDI 名称：[Null]

对于 Enterprise JavaBeans (EJB) 3.0 和更高版本的模块，存在特殊约束。如果指定目标资源 JNDI 名称，请不要指定本地 home 或远程 home JNDI 名称。您也不能在 BindJndiForEJBBusiness 选项中指定“业务接口的 JNDI”字段。如果未指定目标资源 JNDI 名称，那么本地和远程 home JNDI 名称字段可选。如果您未指定本地和远程 JNDI 名称，那么运行时会提供容器缺省值。

如果没有使用 EJB 3.0 模块，那么必须指定目标资源 JNDI 名称。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install c:/myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}

$AdminApp install /myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install app_server_rootapps/myapps/installableApps/JobbankTargetEJBApp.ear
 {-BindJndiForEJBNonMessageBinding {{.* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" }}}

使用 Jython：

AdminApp.install('C:/myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')

AdminApp.install('myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')

将 Jython 与模式匹配配合使用：

AdminApp.install('app_server_root/apps/myapps/installableApps/JobbankTargetEJBApp.ear',
 '[ -BindJndiForEJBNonMessageBinding [[ .* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" ]] ]' )

blaname

使用 blaname 选项来指定业务级别应用程序的名称，系统会以该名称创建 Java EE 应用程序。此选项是可选的。如果未指定值，那么系统会将该名称设置为 Java EE 应用程序名称。此选项仅可与 install 命令一起使用。

buildVersion

buildVersion 选项显示应用程序 EAR 文件的构建版本。因为该选项是只读的，所以无法对其进行修改。如果已在 MANIFEST.MF 应用程序 EAR 文件中指定构建版本，那么此选项返回应用程序 EAR 的构建版本信息。

单元 (cell)

cell 选项指定要安装或更新整个应用程序或更新应用程序以添加新模块的单元名称。如果要更新整个应用程序，那么仅当应用程序包含在安装的应用程序中不存在的新模块时此选项才适用。

批处理方式示例用法

使用 Jacl：

$AdminApp install "C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}

$AdminApp install "/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}

使用 Jython：

AdminApp.install('C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')

AdminApp.install('/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')

clientMode

clientMode 选项指定是将客户机模块部署到隔离的部署目标 (isolated) ， Deployment Manager 的联合节点 (federated) 还是应用程序服务器 (server_deployed)。如果指定此选项，请仅将客户机模块安装到 8.0 或更高版本的部署目标上。

缺省值为 isolated。

客户机部署方式的选择会影响 java: 查找的处理方式。所有 Java URL 名称空间（全局、应用程序、模块和组件）都在隔离客户机进程本地。这些名称空间驻留在服务器上联合的客户机进程和服务器部署的客户机进程中。被选中作为客户机模块的目标的服务器或集群确定在何处创建这些名称空间。针对联合的或已部署服务器的客户机模块的所有 java: 查找都被引导至目标服务器或集群。客户机模块不会实际在目标服务器或集群中运行。同一客户机模块的多个实例都将以联合方式和服务器部署方式共享组件名称空间。选择联合方式只是声明有使用 Java 网络启动协议 (JNLP) 来启动客户机模块的意图，但联合方式和服务器部署方式的 Java 命名和目录接口 (JNDI) 结构相同。

集群

cluster 选项指定要安装或更新整个应用程序或要更新应用程序以添加新模块的集群名。此选项仅适用于 WebSphere® Application Server Network Deployment 环境。如果要更新整个应用程序，那么仅当应用程序包含在安装的应用程序中不存在的新模块时此选项才适用。不能同时使用 -cluster 和 -server 选项。

如果要部署某个应用程序并在部署期间指定 HTTP 服务器，以便该应用程序将出现在生成的 plugin-cfg.xml 文件中，那么您必须首先使用目标 -cluster 安装该应用程序。在安装应用程序之后和进行保存之前，请使用 AdminApp 对象的 edit 命令将其他映射添加到 Web 服务器。

批处理方式示例用法

使用 Jacl：

$AdminApp install "C:/myapp.ear" {-cluster clusterName}

$AdminApp install "myapp.ear" {-cluster clusterName}

使用 Jython：

AdminApp.install('C:/myapp/myapp.ear', '[-cluster clusterName]')

AdminApp.install('/myapp/myapp.ear', '[-cluster clusterName]')

内容

contents 选项指定包含您要更新的内容的文件。例如，根据内容类型，文件可以是 EAR 文件、模块、部分压缩的文件或单个文件。文件路径必须是脚本编制客户机的本地文件。 contents 选项是必需的，除非您已经指定了 delete选项。

contenturi

contenturi 选项指定您正在添加、更新或从应用程序除去的文件的 URI。此选项仅适用于 update 命令。如果内容类型为 file 或 modulefile，那么 contenturi 选项是必需的。其他内容类型忽略此选项。

contextroot

contextroot 选项指定您在安装独立的 Web 应用程序归档 (WAR) 文件时使用的上下文根。

CorrectOracleIsolationLevel

CorrectOracleIsolationLevel 选项指定 Oracle 类型提供程序的隔离级别。使用此选项提供缺少的数据或更新任务。每个条目的最后一个字段指定隔离级别。有效隔离级别值为 2 或 4。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。仅需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
 {{AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
  {{.*  jms/MyQueueConnectionFactory jms/Resource1 2}}

使用 Jython：

AdminApp.install('myapp.ear', '[-CorrectOracleIsolationLevel
 [[AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2]]]')

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-CorrectOracleIsolationLevel',
 [['.*', 'jms/MyQueueConnectionFactory', 'jms/Resource1', 2]]])

CorrectUseSystemIdentity

CorrectUseSystemIdentity 选项将 RunAs 系统替换为 RunAs 角色。您安装的企业 bean 包含 RunAs 系统身份。您可以可选地将此身份更改为 RunAs 角色。使用此选项提供缺少的数据或更新任务。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install myapp.ear {-CorrectUseSystemIdentity {{Inc "Increment Bean Jar"
 Increment.jar,META-INF/ejb-jar.xml getValue() RunAsUser2 user2 password2} 
 {Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment()
 RunAsUser2 user2 password2}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-CorrectUseSystemIdentity
 {{.*  .*  .*  getValue() RunAsUser2 user2 password2}
 {.*  .*  .*  Increment() RunAsUser2 user2 password2}}}

使用 Jython：

AdminApp.install('myapp.ear', '[-CorrectUseSystemIdentity
 [[Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml getValue()
 RunAsUser2 user2 password2] 
 [Inc "Increment Bean Jar" Increment.jar,META-INF/ejb-jar.xml Increment()
 RunAsUser2 user2 password2]]]')

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-CorrectUseSystemIdentity',
 [['.*', '.*', '.*', 'getValue()', 'RunAsUser2', 'user2', 'password2'],
 ['.*', '.*', '.*', 'Increment()', 'RunAsUser2', 'user2', 'password2']]])

createMBeansForResources

createMBeansForResources 选项指定为所有资源（例如在部署目标上启动应用程序时在应用程序中定义的 servlet、JavaServer Pages (JSP) 文件和企业 Bean）创建 MBean。此选项不需要值。缺省设置为 nocreateMBeansForResources 选项。

CtxRootForWebMod

CtxRootForWebMod 选项编辑 Web 模块的上下文根。可使用此选项来编辑 application.xml 文件中定义的上下文根。运行缺省绑定后此选项的当前内容如下：

Web 模块：xxx
URI：xxx
ContextRoot：<context root>

如果 Web 模块是 Servlet 2.5，那么将仅从 XML 部署描述符来填充此选项的内容。您无法通过此选项从注释中获取部署信息。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname ivtApp -CtxRootForWebMod
 {{"IVT Application" ivt_app.war,WEB-INF/web.xml /mycontextroot}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-appname MyApp -CtxRootForWebMod {{.* .* /mycontextroot}}}

使用 Jython：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'ivtApp ', '-CtxRootForWebMod',
 [["IVT Application", 'ivt_app.war,WEB-INF/web.xml', '/mycontextroot']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-CtxRootForWebMod',
 [['.*', '.*', '/mycontextroot']]])

定制

custom 选项指定使用格式 name=value 的名称/值对。使用 custom 选项将选项传递到应用程序部署扩展。请参阅应用程序部署扩展文档获取可用的 custom 选项。

CustomActivationPlan

CustomActivationPlan 选项指定要在用来运行应用程序的缺省运行时组件中添加或移除的运行时组件。仅当应用程序服务器通过检查应用程序无法获取所有必需运行时组件时才使用此选项。

批处理方式示例用法

使用 Jython：

AdminApp.install('Increment.jar','[-CustomActivationPlan [["Increment Enterprise Java Bean"
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')

将 Jython 与模式匹配配合使用：

AdminApp.install('Increment.jar','[-CustomActivationPlan [[.*
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')

表 1. CustomActivation要添加的计划组件。在命令中指定 WS_ComponentToAdd 值。
组件	WS_ComponentToAdd 值
EJB 容器	WS_EJBContainer
Portlet 容器	WS_PortletContainer
JavaServer Faces (JSF)	WS_JSF
SIP 容器	WS_SipContainer
补偿作用域服务	WS_Compensation
应用程序概要文件	WS_AppProfile
活动会话	WS_ActivitySession
国际化	WS_I18N
启动 bean	WS_StartupService

DataSourceFor10CMPBeans

DataSourceFor10CMPBeans 选项为个别 1.x 容器管理的持久性 (CMP) Bean 指定可选的数据源。使用此选项提供缺少的数据或更新任务。

映射特定的数据源到 CMP Bean 将覆盖包含企业 bean 的模块的缺省数据源。 DataSourceFor10CMPBeans 选项的每个元素均由以下字段组成：EJBModule、EJB、uri、JNDI、userName、password、login.config.name 和 auth.props。这些字段中，以下字段可以指定值：JNDI、userName、password、login.config.name 和 auth.props。

运行缺省绑定后此选项的当前内容包括：

模块：Increment CMP 1.1 EJB
Bean：IncCMP11
URI：IncCMP11.jar,META-INF/ejb-jar.xml
目标资源 JNDI 名称：[DefaultDatasource]：
用户名：[Null]：
密码：[Null]：
Login configuration name: [null]: 使用此选项来创建定制登录配置。客户机可以使用 JAAS 来创建登录设计。
Properties: [null]: 使用此选项来创建定制登录配置。客户机可以使用 JAAS 来创建登录设计。

如果 login.config.name 设置为 DefaultPrincipalMapping，那么创建名为 com.ibm.mapping.authDataAlias 的属性。属性的值由 auth.props 设置。如果 login.config 名称未设置为 DefaultPrincipalMapping，那么 auth.props 可以指定多个属性。字符串格式为 websphere:name= <name1>,value=<value1>,description=<desc1>。使用加号 (+) 指定多个属性。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install C:/app1.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB"
 IncCMP11 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}}

$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB" IncCMP11
 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install C:/myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  
 IncCMP11.jar,.* myJNDI user1 password1 loginName1 authProps1}}}

$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  IncCMP11.jar,.*
 myJNDI user1 password1 loginName1 authProps1}}}

使用 Jython：

AdminApp.install('C:/app1.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1', 'password1',
 'loginName1', 'authProps1']]])

AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1',
 'password1', 'loginName1', 'authProps1']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('C:/myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*', 
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])

AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*',
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])

DataSourceFor20CMPBeans

DataSourceFor20CMPBeans 选项为个别 2.x 容器管理的持久性 (CMP) Bean 指定可选的数据源。使用此选项提供缺少的数据或更新任务。

映射特定的数据源到 CMP Bean 将覆盖包含企业 bean 的模块的缺省数据源。 DataSourceFor20CMPBeans 选项的每个元素均由以下字段组成：EJBModule、EJB、uri、JNDI、resAuth、login.config.name 和 auth.props。这些字段中，以下字段可以指定值：JNDI、resAuth、login.config.name 和 auth.props。

运行缺省绑定后此选项的当前内容包括：

模块：Increment enterprise bean
Bean：Increment
URI：Increment.jar,META-INF/ejb-jar.xml
目标资源 JNDI 名称：[Null]：
资源授权：[按应用程序]：
Login configuration name: [null]: 使用此选项来创建定制登录配置。客户机可以使用 JAAS 来创建登录设计。
Properties: []: 使用此选项来创建定制登录配置。客户机可以使用 JAAS 来创建登录设计。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。仅需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install Increment.jar {-DataSourceFor20CMPBeans
 {{"Increment Enterprise Java Bean" Increment
 Increment.jar,META-INF/ejb-jar.xml jndi1 container "" ""}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install Increment.jar {-DataSourceFor20CMPBeans {{.*  .*
 Increment.jar,.*  jndi1 container "" ""}}}

使用 Jython：

AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans',
 [["Increment Enterprise Java Bean", 'Increment',
 'Increment.jar,META-INF/ejb-jar.xml', 'jndi1', 'container', '', '']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans', [['.*', '.*',
 'Increment', 'Increment.jar,.*', 'jndi1', 'container', '', '']]])

DataSourceFor10EJBModules

DataSourceFor10EJBModules 选项为包含 1.x 容器管理的持久性 (CMP) Bean 的企业 Bean 模块指定缺省数据源。使用此选项提供缺少的数据或更新任务。

DataSourceFor10EJBModules 选项的每个元素均由以下字段组成：EJBModule、uri、JNDI、userName、password、login.config.name 和 auth.props。这些字段中，以下字段可以指定值：JNDI、userName、password、login.config.name 和 auth.props。

运行缺省绑定后此选项的当前内容包括：

模块：Increment CMP 1.1 enterprise bean
URI：IncCMP11.jar,META-INF/ejb-jar.xml
目标资源 JNDI 名称：[DefaultDatasource]：
用户名：[Null]：
密码：[Null]：
Login configuration name: [null]: 使用此选项来创建定制登录配置。客户机可以使用 JAAS 来创建登录设计。
Properties: [null]: 使用此选项来创建定制登录配置。客户机可以使用 JAAS 来创建登录设计。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install myapp.ear {-DataSourceFor10EJBModules {{"Increment CMP 1.1 EJB"
 IncCMP11.jar,META-INF/ejb-jar.xml yourJNDI user2 password2 loginName authProps}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-DataSourceFor10EJBModules
 {{.* IncCMP11.jar,.* yourJNDI user2 password2 loginName authProps}}}

使用 Jython：

AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules', [["Increment CMP 1.1 EJB",
 'IncCMP11.jar,META-INF/ejb-jar.xml', 'yourJNDI', 'user2', 'password2', 
 'loginName', 'authProps']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules',
 [['.*', 'IncCMP11.jar,.*', 'yourJNDI', 'user2', 'password2', 'loginName', 'authProps']]])

DataSourceFor20EJBModules

DataSourceFor20EJBModules 选项为包含 2.x 容器管理的持久性 (CMP) Bean 的企业 bean 2.x 模块指定缺省数据源。使用此选项提供缺少的数据或更新任务。

DataSourceFor20EJBModules 选项的每个元素均由以下字段组成：EJBModule、uri、JNDI、resAuth、login.config.name 和 auth.props。可对这些字段中的以下字段分配值：JNDI、resAuth、login.config.name、auth.props 和扩展数据源属性。

运行缺省绑定后此选项的当前内容包括：

模块：Increment enterprise bean
URI：Increment.jar,META-INF/ejb-jar.xml
目标资源 JNDI 名称：[DefaultDatasource]：
资源授权：[按应用程序]：
Login configuration name: [null]: 使用此选项来创建定制登录配置。客户机可以使用 JAAS 来创建登录设计。
Properties: []: 使用此选项来创建定制登录配置。客户机可以使用 JAAS 来创建登录设计。
扩展数据源属性: []: 使用此选项，以便使用异构池的数据源可以连接到 DB2® 数据库。该属性的模式为 property1=value1+property2=value2。

此任务的每个条目中最后一个字段指定资源权限的值。资源授权的有效值为 per connection factory 或 container。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install Increment.jar {-DataSourceFor20EJBModules
 {{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 jndi2 container "" "" ""}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install Increment.jar {-DataSourceFor20EJBModules {{.*
 Increment.jar,.* jndi2 container "" "" ""}}}

注: 如果将多个值用于扩展数据源属性，那么必须将这些值分配给变量，并将该变量用于该属性值。例如：

set s \"value1,value2\"

如以下示例所示，在命令替换中引用该变量：

"clientApplicationInformation=value1,value2" with "clientapplication=$s"

使用 Jython：

AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [["Increment Enterprise Java Bean", 'Increment.jar,META-INF/ejb-jar.xml',
 'jndi2', 'container', '', '', '']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [['.*', 'Increment.jar,.*', 'jndi2', 'container', '', '', '']]])

注: 如果对扩展数据源属性使用多个值，请使用双引号字符将两个值括起来。例如：

'property1="value1,value2"+property2="value3,value4"'

defaultbinding.cf.jndi

defaultbinding.cf.jndi 选项指定缺省连接工厂的 Java 命名和目录接口 (JNDI) 名称。

defaultbinding.cf.resauth

defaultbinding.cf.resauth 选项为连接工厂指定 RESAUTH。

defaultbinding.datasource.jndi

defaultbinding.datasource.jndi 选项为缺省数据源指定 Java 命名和目录接口 (JNDI) 名称。

defaultbinding.datasource.password

defaultbinding.datasource.password 选项为缺省数据源指定密码。

defaultbinding.datasource.username

defaultbinding.datasource.username 选项为缺省数据源指定用户名。

defaultbinding.ee.defaults

defaultbinding.ee.defaults 选项指定 Java EE的预配置缺省资源选项。

defaultbinding.ejbjndi.prefix

defaultbinding.ejbjndi.prefix 选项指定企业 Bean Java 命名和目录接口 (JNDI) 名称的前缀。

[z/OS] 要在 z/OS® 平台上使用 defaultbinding.ejbjndi.prefix 选项，还必须指定 usedefaultbindings 选项。如果您不指定使用 usedefaultbindings 选项，那么缺省为 nousedefaultbindings 选项。

defaultbinding.force

defaultbinding.force 选项指定覆盖当前绑定的缺省绑定。

defaultbinding.strategy.file

defaultbinding.strategy.file 选项指定定制缺省绑定策略文件。

defaultbinding.virtual.host

defaultbinding.virtual.host 选项指定虚拟主机的缺省名称。

depl.extension.reg（建议不要使用）

不推荐使用的功能部件: 不推荐使用 depl.extension.reg 选项。没有可用的复制选项。

deployejb

deployejb 选项指定以在安装期间运行 EJBDeploy 工具。此选项不需要值。 EJBDeploy 工具仅在 EJB 1.x 或 2.x 模块安装期间运行。在安装 EJB 3.x 模块期间，不会运行 EJB 部署工具。

当要安装或更新的 EAR 或模块包含 Java Platform, Enterprise Edition (Java EE) 7 应用程序部署描述符、EJB 3.2 模块部署描述符或 Web 3.1 模块部署描述符时，将忽略此选项。

如果您使用 EJBDeploy 工具预部署应用程序企业归档 (EAR) 文件，那么缺省值为 nodeployejb。如果不是这样，缺省值为 deployejb。

如果 EJB 模块包含实体 Bean ，那么必须在以下情况下使用此 deployejb 选项:

该 EAR 文件是使用组装工具（例如，Rational® Application Developer）组装的，但在组装期间未运行 EJBDeploy 工具。
该 EAR 文件不是使用组装工具（例如 Rational Application Developer）组装的。
该 EAR 文件是使用 V5.0 以前的 Application Assembly Tool (AAT) 版本组装的。

如果 EJB 模块打包到 Web 归档 (WAR) 中，那么不必使用此 deployejb 选项。

对于此选项，请仅安装到 V 9.0 部署目标上，该部署目标具有与 Deployment Manager 相同的或更高的 Java SDK 级别。

deployejb.classpath

deployejb.classpath 选项为 EJBDeploy 工具指定额外的类路径。

deployejb.complianceLevel

deployejb.complianceLevel 选项为 EJBDeploy 工具指定 JDK 一致性级别。

可能的值包括：

1.4 (default) 5.0 6.0

要获取当前受支持的 JDK 一致性级别的列表，请运行 ejbdeploy -? 命令。

deployejb.dbschema

deployejb.dbschema 选项为 EJBDeploy 工具指定数据库模式。

deployejb.dbtype

deployejb.dbtype 选项为 EJBDeploy 工具指定数据库类型。

可能的值包括：

DB2UDB_V81 DB2UDB_V82 DB2UDB_V91 DB2UDB_V95 DB2UDBOS390_V8 DB2UDBOS390_NEWFN_V8 DB2UDBOS390_V9 
 DB2UDBISERIES_V53 DB2UDBISERIES_V54 DB2UDBISERIES_V61  DERBY_V10 DERBY_V101 INFORMIX_V100 INFORMIX_V111 INFORMIX_V115 
 MSSQLSERVER_2005 ORACLE_V10G ORACLE_V11G SYBASE_V15 SYBASE_V125

下列数据库支持 Java 中结构化查询语言 (SQLJ) ：DB2UDB_V82、DB2UDB_V81、DB2UDBOS390_V7 和 DB2UDBOS390_V8。

要获取受支持的数据库供应商类型的列表，请运行 ejbdeploy -? 命令。

deployejb.dbaccesstype

deployejb.dbaccesstype 选项为 EJBDeploy 工具指定数据库访问的类型。有效值为 SQLj 和 JDBC。缺省值为 JDBC。

deployejb.rmic

deployejb.rmic 选项指定其他 RMIC 选项以用于 EJBDeploy 工具。

deployejb.sqljclasspath

deployejb.sqljclasspath 选项指定 SQLJ 转换程序类的位置。

deployws

deployws 选项指定要在安装期间部署 Web Service。此选项不需要值。

缺省值为：nodeployws。

对于此选项，请仅安装到 V 9.0 部署目标上，该部署目标具有与 Deployment Manager 相同的或更高的 Java SDK 级别。

deployws.classpath

deployws.classpath 选项指定在您部署 Web Service 时要使用的其他类路径。

要指定多个条目的类路径，请使用与 CLASSPATH 环境变量使用的相同分隔符分隔这些条目。

[Windows] 请使用分号 (;) 来分隔这些条目。

[Linux] [AIX] [z/OS] [HP-UX] [Solaris] 使用冒号 (:) 来分隔条目。

deployws.jardirs

deployws.jardirs 选项指定在您部署 Web Service 时要使用的其他扩展目录。

distributeApp

distributeApp 选项指定应用程序管理组件分发应用程序二进制文件。此选项不需要值。此设置是缺省值。

EmbeddedRar

EmbeddedRar 选项将 Java 2 连接器对象绑定至 JNDI 名称。必须将应用程序或模块（例如，J2C连接工厂、J2C 激活规范和 J2C 管理对象）中的每个 Java 2 连接器对象绑定至 JNDI 名称。 EmbeddedRar 选项的每个元素都包含以下字段: RARModule， uri， j2cid， j2c.name和 j2c.jndiName。您可以将以下值分配给字段: j2c.name和 j2c.jndiName。

运行缺省绑定后此选项的当前内容包括：

Connector module: <rar module name> 
URI: <rar name>,META-INF/ra.xml 
Object identifier: <identifier of the J2C object> 
name: j2cid 
JNDI name: eis/j2cid

其中 j2cid 为：

J2C connection factory: connectionFactoryInterface
J2C admin object: adminObjectInterface
J2C activation specification: message listener type

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

If the ID is not unique in the ra.xml file, -<number> will be added. 例如，javax.sql.DataSource-2。

批处理方式示例用法

使用 Jacl：

$AdminApp install $embeddedEar {-EmbeddedRar {{"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml 
 javax.sql.DataSource javax.sql.DataSource1 eis/javax.sql.javax.sql.DataSSource1} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2 javax.sql.DataSource2 eis/javax.sql.DataSource2} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml javax.jms.MessageListener javax.jms.MessageListener1 eis/javax.jms.MessageListener1} {"FVT Resource 
 Adapter" jca15cmd.rar,META-INF/ra.xml javax.jms.MessageLListener2 javax.jms.MessageListener2 eis/javax.jms.MessageListener2} 
 {"FVT Resource Adapter" jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider 
 fvt.adapter.message.FVTMessageProvider1 eis/fvt.adapter.message.FVTMessageProvider1} {"FVT Resource Adapter" 
 jca15cmd.rar,META-INF/ra.xml fvt.adapter.message.FVTMessageProvider2 fvt.adapter.message.FVTMessageProvider2 
 eis/fvt.adapter.message.FVTMessageProvider2}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install $embeddedEar {-EmbeddedRar {{.*  .*  .*  javax.sql.DataSource1  
 eis/javax.sql.javax.sql.DataSSource1} {.*  .*  .*  javax.sql.DataSource2  eis/javax.sql.DataSource2} {.*  .*  .*  
 javax.jms.MessageListener1  eis/javax.jms.MessageListener1} {.*  .*  .*  javax.jms.MessageListener2  
 eis/javax.jms.MessageListener2} {.*  .*  .*  fvt.adapter.message.FVTMessageProvider1  
 eis/fvt.adapter.message.FVTMessageProvider1} {.*  .*  .*  fvt.adapter.message.FVTMessageProvider2  
 eis/fvt.adapter.message.FVTMessageProvider2}}}

使用 Jython：

AdminApp.install(embeddedEar, ['-EmbeddedRar', [["FVT Resource Adapter", 
 'jca15cmd.rar,META-INF/ra.xml', 'javax.sql.DataSource', 'javax.sql.DataSource1', 'eis/javax.sql.javax.sql.DataSSource1'], ["FVT 
 Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml javax.sql.DataSource2', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'], 
 ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageListener', 'javax.jms.MessageListener1', 
 'eis/javax.jms.MessageListener1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 'javax.jms.MessageLListener2', 
 'javax.jms.MessageListener2', 'eis/javax.jms.MessageListener2'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml 
 fvt.adapter.message.FVTMessageProvider', 'fvt.adapter.message.FVTMessageProvider1', 
 'eis/fvt.adapter.message.FVTMessageProvider1'], ["FVT Resource Adapter", 'jca15cmd.rar,META-INF/ra.xml', 
 'fvt.adapter.message.FVTMessageProvider2', 'fvt.adapter.message.FVTMessageProvider2', 
 'eis/fvt.adapter.message.FVTMessageProvider2']]])

将 Jython 与模式匹配配合使用：

AdminApp.install(embeddedEar, ['-EmbeddedRar', [['.*', '.*', '.*', 'javax.sql.DataSource1', 
 'eis/javax.sql.javax.sql.DataSSource1'], ['.*', '.*', '.*', 'javax.sql.DataSource2', 'eis/javax.sql.DataSource2'], ['.*', '.*', 
 '.*', 'javax.jms.MessageListener1', 'eis/javax.jms.MessageListener1'], ['.*', '.*', '.*', 'javax.jms.MessageListener2', 
 'eis/javax.jms.MessageListener2'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider1', 
 'eis/fvt.adapter.message.FVTMessageProvider1'], ['.*', '.*', '.*', 'fvt.adapter.message.FVTMessageProvider2', 
 'eis/fvt.adapter.message.FVTMessageProvider2']]])

enableClientModule

enableClientModule 选项指定部署客户机模块。如果要部署的文件具有一个或多个要部署的客户机模块，请选择此选项。如果选择此选项，请将客户机模块仅安装到 V8.0 或更高版本的部署目标上。

此选项不需要值。缺省值为 noenableClientModule。缺省情况下，部署期间会忽略 enableClientModule 选项，并且不会部署客户机模块。

EnsureMethodProtectionFor10EJB

EnsureMethodProtectionFor10EJB 选项为 1.x 企业 Bean 的不受保护的方法选择方法保护。指定将方法保留为不受保护的方法，或指定拒绝所有访问的保护。使用此选项提供缺少的数据或更新任务。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install Increment.jar {-EnsureMethodProtectionFor10EJB
 {{"Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""}
 {"Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
 methodProtection.denyAllPermission}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-EnsureMethodProtectionFor10EJB
 {{.* IncrementEJBBean.jar,.* ""} {.* TimeoutEJBBean.jar,.*
 methodProtection.denyAllPermission}}}

使用 Jython：

AdminApp.install('Increment.jar', '[-EnsureMethodProtectionFor10EJB
 [["Increment EJB Module" IncrementEJBBean.jar,META-INF/ejb-jar.xml ""]
 ["Timeout EJB Module" TimeoutEJBBean.jar,META-INF/ejb-jar.xml
 methodProtection.denyAllPermission]]]')

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor10EJB',
 [['.*', 'IncrementEJBBean.jar,.*', ""], ['.*', 'TimeoutEJBBean.jar,.*', 
 'methodProtection.denyAllPermission']]])

此任务的每个条目中最后一个字段指定保护的值。有效保护值包含：methodProtection.denyAllPermission。如果要方法保持不受保护，您还可以保留此值空白。

EnsureMethodProtectionFor20EJB

EnsureMethodProtectionFor20EJB 选项为 2.x 企业 Bean 的不受保护的方法选择方法保护。指定以将安全角色指定给不受保护的方法、将方法添加到排除列表或将方法标记为已清除。可通过用逗号分隔角色名称，为一个方法指定多个角色。使用此选项提供缺少的数据或更新任务。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新现有数据的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
 {{CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck}
 {SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
 {{.* customerEjb.jar,.* methodProtection.uncheck}
 {.* supplierEjb.jar,.* methodProtection.exclude}}}

使用 Jython：

AdminApp.install('myapp.ear', '[-EnsureMethodProtectionFor20EJB 
 [[CustmerEjbJar customerEjb.jar,META-INF/ejb-jar.xml methodProtection.uncheck]
 [SupplierEjbJar supplierEjb.jar,META-INF/ejb-jar.xml methodProtection.exclude]]]')

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor20EJB',
 [['.*', 'customerEjb.jar,.*', 'methodProtection.uncheck'],
 ['.*', 'supplierEjb.jar,.*', 'methodProtection.exclude']]])

此任务的每个条目中最后一个字段指定保护的值。有效保护值包括：methodProtection.uncheck、methodProtection.exclude 或由逗号分隔的安全角色列表。

filepermission

filepermission 选项使您能够对位于安装目录中的应用程序文件设置适当的文件许可权。您在应用程序级别指定的文件许可权必须是节点级别文件许可权的子集（节点级别文件许可权定义可以指定的最不严格的文件许可权）。否则，节点级别许可权值用来在安装目标中设置文件许可权。文件名模式是正则表达式。缺省值如下：

.*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname MyApp -cell myCell -node myNode -server server1
 -filepermission .*\\.jsp=777#.*\\.xml=755}

使用 Jython：

AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-cell", "myCell", "-node", "myNode", "-server", "server1",
 "-filepermission", ".*\\.jsp=777#.*\\.xml=755"])

installdir（建议不要使用）

不推荐使用的功能部件: 不推荐使用 installdir 选项。此选项由 installed.ear.destination 选项替换。

installed.ear.destination

installed.ear.destination 选项指定要放置应用程序二进制文件的目录。

JSPCompileOptions

JSPCompileOptions 选项指定 Web 模块的 Java ServerPages (JSP) 编译选项。仅当您还使用 preCompileJSPs 选项时，此选项才有效。运行缺省绑定后此选项的当前内容如下：

Web 模块：xxx
URI：xxx
JSP 类路径：<jsp 类路径>
使用完整包名：Yes | No
JDK 源级别：xx
禁用 JSP 运行时编译：Yes | No

对于 Use Full Package Names 和 Disable JSP Runtime Compilation，请以特定于语言环境的语言指定 Yes 或 No 值。产品支持值 AppDeploymentOption.Yes 和 AppDeploymentOption.No ，而不是 Yes 和 No。但是，建议您在语言环境中指定 Yes 或 No 。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -preCompileJSPs -JSPCompileOptions {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml jspcp Yes 15 No}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install ivtApp.ear {-appname MyApp -preCompileJSPs -JSPCompileOptions
 {{.* .* jspcp Yes 15 No}}}

使用 Jython：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-preCompileJSPs', '-JSPCompileOptions',
 [["IVT Application", 'ivt_app.war,WEB-INF/web.xml', 'jspcp',
 'Yes', 15, 'No']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('ivtApp.ear', ['-appname', 'MyApp', '-preCompileJSPs',
 '-JSPCompileOptions', [['.*', '.*', 'jspcp', 'Yes', 15, 'No']]])

JSPReloadForWebMod

JSPReloadForWebMod 选项编辑 Web 模块的 JSP 重新装入属性。您可以为每个模块指定 Servlet 和 JSP 的重新装入属性。运行缺省绑定后此选项的当前内容如下：

Web 模块：xxx
URI：xxx
JSP 启用类重新装入：<Yes | No>
JSP 重新装入时间间隔（以秒计）：<jsp reload internal number>

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。

对于 JSP enable class reloading，请以特定于语言环境的语言指定 Yes 或 No 值。产品支持值 AppDeploymentOption.Yes 和 AppDeploymentOption.No ，而不是 Yes 和 No。但是，建议您在语言环境中指定 Yes 或 No 。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{.* .* Yes 5}}}

使用 Jython：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod [["IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5 ]]'])

将 Jython 与模式匹配配合使用：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod', [['.*', '.*', 'Yes', ‘5']]])

受支持的配置: 对于 IBM® 扩展和绑定文件，根据您是使用Java EE 5 之前的应用程序或模块，还是使用 Java EE 5 或更高版本的应用程序或模块， .xmi 或 .xml 文件扩展名有所不同。 IBM 扩展或绑定文件名为 ibm-*-ext.xmi 或 ibm-*-bnd.xmi ，其中 * 是扩展或绑定文件的类型，例如 app， application， ejb-jar或 web。存在下列条件：

对于使用版本 5 之前的 Java EE 版本的应用程序或模块，文件扩展名必须为 .xmi。
对于使用 Java EE 5 或更高版本的应用程序或模块，文件扩展名必须为 .xml。如果应用程序或模块随附 .xmi 文件，那么产品会忽略 .xmi 文件。

但是， Java EE 5 或更高版本的模块可以存在于包含Java EE 5 之前的文件并使用 .xmi 文件扩展名的应用程序中。

ibm-webservices-ext.xmi、ibm-webservices-bnd.xmi、ibm-webservicesclient-bnd.xmi、ibm-webservicesclient-ext.xmi 和 ibm-portlet-ext.xmi 文件继续使用 .xmi 文件扩展名。

MapEJBRefToEJB

EJB 选项将企业 Java 引用映射到企业 Bean。必须将定义在应用程序中的每个企业 Bean 引用映射至一个企业 Bean。使用此选项可提供缺少的数据或对任务进行更新。

如果 EJB 引用来自于 EJB 3.x、Web 2.4 或 Web 2.5 模块，那么 JNDI 名称是可选的。如果指定 useAutoLink 选项，那么 JNDI 名称为可选。运行时提供容器缺省值。 EJB 3.0 或更高版本模块不能包含容器管理的或 Bean 管理的持久性实体 Bean。当容器管理的或 Bean 管理的持久性实体 Bean 打包在 Java EE 应用程序的 EJB 3.x 模块中时，安装会失败。只能将容器管理的或 Bean 管理的持久性 Bean 打包在 EJB 2.1 或更低版本模块中。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。您只需要提供缺少信息的行或条目的数据，或您要更新现有数据的那些行或条目的数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install techapp.ear {-MapEJBRefToEJB {{"JAASLogin" "" JAASLoginWeb.war,
WEB-INF/web.xml WSsamples/JAASLogin jaasloginejb.SampleBean TechApp/JAASLogin}}
-MapWebModToVH {{"Web Application" Tech.war,WEB-INF/web.xml default_host}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install C:/myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}

$AdminApp install myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}

使用 Jython：

AdminApp.install('techapp.ear','[
-MapEJBRefToEJB [["JAASLogin" "" JAASLoginWeb.war,WEB-INF/web.xml WSsamples/JAASLogin]]
-MapWebModToVH [["Web Application" tech.war,WEB-INF/web.xml default_host]]]')

将 Jython 与模式匹配配合使用：

AdminApp.install('C:/myapp.ear', ['-MapEJBRefToEJB',
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])

AdminApp.install('myapp.ear', ['-MapEJBRefToEJB', 
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])

MapEnvEntryForApp

MapEnvEntryForApp 选项适用于编辑应用程序的 env-entry 值。您可以使用此选项来编辑 application.xml 文件中 env-entry 的值。

运行缺省绑定后此选项的当前内容如下：

名称：xxx
类型：xxx
描述：xxx
避免麻烦: 如果在运行缺省绑定后，该值为 null 值，那么必须在运行此任务之前将该值更改为 .* 。 .* 值是通配符值，它允许任何描述成为匹配项。如果您让该值保留为 null，那么当您运行 MapEnvEntryForEJBMod 任务时，将发生异常。
值：<env-entry value>

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForApp {{MyApp/appEnvEntry String null newEnvEntry}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForApp {{.* .* .* newEnvEntry}}}

使用 Jython：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp3', '-MapEnvEntryForApp', [['MyApp/appEnvEntry', 'String', 'null', 'newEnvEntry']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForApp', [['.*', '.*', '.*', 'newEnvEntry']]])

如果描述中存在换行符，请使用以下语法：

将 Jacl 与模式匹配配合使用：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForApp {{.* .* (?s).* newEnvEntry}}}

将 Jython 与模式匹配配合使用：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForApp',
 [['.*', '.*', '(?s).*', 'newEnvEntry']]])

MapEnvEntryForClientMod

MapEnvEntryForClientMod 选项会编辑客户机模块的环境条目值。您可以使用此选项来编辑客户机模块 application-client.xml 文件中的环境条目的值。

运行缺省绑定后此选项的当前内容如下：

客户机模块：xxx
URI：xxx
名称：xxx
类型：xxx
描述：xxx
值：<env-entry value>

使用 AdminApp 对象的 taskInfo 命令来获取客户机模块所需数据的相关信息。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/myapp.ear
 {-appname MyApp -MapEnvEntryForClientMod {{"Client Module" client.jar,META-INF/application-client.xml
  clientObject String null newValue}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.*  .*  .*
  .* .* newValue}}}

使用 Jython：

AdminApp.install('app_server_root/installableApps/myapp.ear',
 ['-appname', 'MyApp', '-MapEnvEntryForClientMod', [["Client Module",
 'client.jar,META-INF/application-client.xml', 'clientObject',
 'String', 'null', 'newValue']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '.*', '.*', 'newValue']]])

如果描述中存在换行符，请使用以下语法：

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.* .* .*
 (?s).* newValue}}}

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForEJBMod

MapEnvEntryForEJBMod 选项编辑 EJB 模块的 env-entry 值。您可以使用此选项来编辑 EJB 模块 ejb-jar.xml 中的环境条目的值。

运行缺省绑定后此选项的当前内容如下：

模块：xxx
URI：xxx
Bean：xxx
名称：xxx
类型：xxx
描述：xxx
避免麻烦: 如果在运行缺省绑定后，该值为 null 值，那么必须在运行此任务之前将该值更改为 .* 。 .* 值是通配符值，它允许任何描述成为匹配项。如果您让该值保留为 null，那么当您运行 MapEnvEntryForEJBMod 任务时，将发生 WASX7017E 和 WASX7111E 异常。
值：<env-entry value>

如果 EJB 模块使用 EJB 3.0 或更高版本，那么将仅从 XML 部署描述符填充此选项的内容。您无法通过此选项从注释中获取部署信息。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForEJBMod {{"IVT EJB Module" ivtEJB.jar,META-INF/ejb-jar.xml
  ivtEJBObject ejb/ivtEJBObject String null newValue}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.jar {-appname MyApp -MapEnvEntryForEJBMod {{.*  .*  .*
  .* .* .* newValue}}}

使用 Jython：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-MapEnvEntryForEJBMod', [["IVT EJB Module",
 'ivtEJB.jar,META-INF/ejb-jar.xml', 'ivtEJBObject', 'ejb/ivtEJBObject',
 'String', 'null', 'newValue']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '.*', '.*', '.*', 'newValue']]])

如果描述中存在换行符，请使用以下语法：

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForEJBMod {{.* .* .*
 (?s).* newValue}}}

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForWebMod

MapEnvEntryForWebMod 选项编辑 Web 模块的 env-entry 值。您可以使用此选项来编辑 web.xml 文件中 env-entry 的值。

运行缺省绑定后此选项的当前内容如下：

Web 模块：xxx
URI：xxx
名称：xxx
类型：xxx
描述：xxx
避免麻烦: 如果在运行缺省绑定后该值为 null 值，那么必须在运行此任务之前将该值更改为 .* 。 .* 值是通配符值，它允许任何描述成为匹配项。如果您让该值保留为 null，那么当您运行 MapEnvEntryForWebMod 任务时，将发生 WASX7017E 和 WASX7111E 异常。
值：<env-entry value>

如果 Web 模块使用 Servlet 2.5，那么将仅从 XML 部署描述符来填充此选项的内容。您无法通过此选项从注释中获取部署信息。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForWebMod {{"IVT Application" ivt_app.war,
 WEB-INF/web.xml ivt/ivtEJBObject String null newEnvEntry}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForWebMod {{.* .* .* .* newEnvEntry}}}

使用 Jython：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp3', '-MapEnvEntryForWebMod', [["IVT Application",
 'ivt_app.war,WEB-INF/web.xml', 'ivt/ivtEJBObject', 'String', 'null', 'newEnvEntry']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForWebMod', [['.*', '.*', '.*', '.*', 'newEnvEntry']]])

如果描述中存在换行符，请使用以下语法：

将 Jacl 与模式匹配配合使用：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForWebMod {{.* .* .* (?s).* newEnvEntry}}}

将 Jython 与模式匹配配合使用：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForWebMod',
 [['.*', '.*', '.*', '(?s).*', 'newEnvEntry']]])

MapInitParamForServlet

MapInitParamForServlet 选项编辑 Web 模块的初始参数。您可以使用此选项来编辑 web.xml 文件中 Servlet 的初始参数。运行缺省绑定后此选项的当前内容如下：

Web 模块：xxx
URI：xxx
Servlet：xxx
名称：xxx
描述：Null
值：<初始参数值>

如果 Web 模块使用 Servlet 2.5 或更高版本，那么将仅从 XML 部署描述符填充此选项的内容。您无法通过此选项从注释中获取部署信息。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapInitParamForServlet {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml ivtservlet pName1 null MyInitParamValue}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-appname MyApp -MapInitParamForServlet
 {{.*  .*  .*  .*  .*  MyInitParamValue}}}

使用 Jython：

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-MapInitParamForServlet', [["IVT Application",
 'ivt_app.war,WEB-INF/web.xml', 'ivtservlet', 'pName1', 'null', 'MyInitParamValue']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapInitParamForServlet',
 [['.*', '.*', '.*', '.*', '.*', 'MyInitParamValue']]])

MapJaspiProvider

MapJaspiProvider 选项指定全局或域安全性配置中您要在其中覆盖 Java 认证 SPI (JASPI) 设置的 Web 应用程序或 Web 模块。此选项的内容如下所示：

模块：xxx
URI：xxx
使用 JASPI: 是 | 否 | 继承
JASPI 提供程序名称：xxx

对于 Use JASPI，请以特定于语言环境的语言指定 Yes、No 或 Inherit 值。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install myapp.ear {-MapJaspiProvider {{myapp META-INF/application.xml Yes Provider1} }}

使用 Jython：

AdminApp.install('myapp.ear', '[-appname myapp
 -MapJaspiProvider [[myapp META-INF/application.xml Yes Provider1] ]]')

MapMessageDestinationRefToEJB

MapMessageDestinationRefToEJB 选项将消息目标引用从安装的资源适配器映射到管理对象的 Java 命名和目录接口 (JNDI) 名称。必须将应用程序中定义的每个消息目标引用映射到管理对象。使用此选项提供缺少的数据或更新任务。

运行缺省绑定后此选项的当前内容包括：

模块：ejb-jar-ic.jar
Bean：MessageBean
URI：ejb-jar-ic.jar,META-INF/ejb-jar.xml
消息目标对象：jms/GSShippingQueue
目标资源 JNDI 名称：[jms/GSShippingQueue]：

如果消息目标引用来自 EJB 3.0 或更高版本模块，那么 JNDI 名称是可选的，并且运行时将提供容器缺省值。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install BankFull.ear {-MapMessageDestinationRefToEJB {{BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue} }}

将 Jacl 与模式匹配配合使用：

$AdminApp install $earfile {-MapMessageDestinationRefToEJB {{.*  .*  .*  MyConnection
 jndi2} {.* .*  .*  PhysicalTopic jndi3} {.*  .*  .*  jms/ABC jndi4}}}

使用 Jython：

AdminApp.install('BankFull.ear', '[ -MapMessageDestinationRefToEJB [[ BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue ]]]' )

将 Jython 与模式匹配配合使用：

AdminApp.install(ear1, ['-MapMessageDestinationRefToEJB', [['.*', '.*', '.*', 'MyConnection', 
 'jndi2'], ['.*', '.*', '.*', 'PhysicalTopic', 'jndi3'], ['.*', '.*', '.*', 'jms/ABC', 'jndi4']]])

MapModulesToServers

MapModulesToServers 选项指定您要安装包含在应用程序中的模块的应用程序服务器。您可以在同一服务器上安装模块或在几台服务器间分散它们。使用此选项可提供缺少的数据或更新到任务。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

以下示例将 Increment.jar 安装在一个服务器上：

使用 Jacl：

$AdminApp install Increment.jar {-MapModulesToServers
 {{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1}}}

使用 Jython：

AdminApp.install('Increment.jar', '[-MapModulesToServers
 [["Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1] ]]')

以下示例安装 Increment.jar 并将其映射至由 Deployment Manager 管理的两个服务器：

使用 Jacl：

$AdminApp install Increment.jar {-MapModulesToServers
 {{ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2}}}

使用 Jython：

AdminApp.install('Increment.jar', '[ -MapModulesToServers
 [[ "Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 WebSphere:cell=mycell,node=mynode,server=server1+WebSphere:cell=mycell,node=mynode,server=server2]]]')

以下示例为安装的应用程序添加 server2 和 server3：

使用 Jacl：

$AdminApp install myapp.ear {-MapModulesToServers {{.* .* 
 +WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3}}
 -appname myapp -update -update.ignore.old}

使用 Jython：

AdminApp.install('myapp.ear', ['-MapModulesToServers', [['.*', '.*', 
 '+WebSphere:cell=mycell,node=mynode,server=server2+WebSphere:cell=mycell,node=mynode,server=server3']],
 '-appname', 'myapp', '-update', '-update.ignore.old'])

以下示例从安装的应用程序除去 server1：

使用 Jacl：

$AdminApp edit myapp {-MapModulesToServers
 {{.* .* -WebSphere:cell=mycell,node=mynode,server=server1}}
 -update -update.ignore.old}

使用 Jython：

AdminApp.edit('myapp', ['-MapModulesToServers',
 [['.*', '.*', '-WebSphere:cell=mycell,node=mynode,server=server1']]])

MapResEnvRefToRes

MapResEnvRefToRes 选项将资源环境引用映射到资源。必须将应用程序中定义的每个资源环境引用映射到资源。使用此选项提供缺少的数据或更新任务。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/sibwsjmsepl.ear {
 -BindJndiForEJBMessageBinding {{ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" }}
 -MapResEnvRefToRes {{SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
   javax.jms.QueueConnectionFactory jndi1}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install app_server_root/installableApps/sibwsjmsepl.ear {
 -MapResEnvRefToRes {{.* .* .* .* .* jndi1}}}

使用 Jython：

AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear', '[
 -BindJndiForEJBMessageBinding [[ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml lp1 "" "" "" ]]
 -MapResEnvRefToRes [[ SOAPJMSEndpoint SOAPJMSEndpoint
   SOAPJMSEndpoint.jar,META-INF/ejb-jar.xml jms/WebServicesReplyQCF
   javax.jms.QueueConnectionFactory jndi1 ]]]' )

将 Jython 与模式匹配配合使用：

AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear',
 ['-MapResEnvRefToRes', [['.*', '.*', '.*', '.*', '.*', 'jndi1']]])

MapResRefToEJB

MapResRefToEJB 选项将资源引用映射到资源。必须将应用程序中定义的每个资源引用映射到资源。使用此选项提供缺少的数据或更新任务。

MapResRefToEJB 的参数包括：

模块：Ejb1
Bean：MailEJBObject
URI：deplmtest.jar,META-INF/ejb-jar.xml
资源引用：jms/MyConnectionFactory
资源类型：javax.jms.ConnectionFactory
目标资源 JNDI 名称：[jms/MyConnectionFactory]：
Login Configuration Name: [null]: 使用此选项来创建定制登录配置。客户机可以使用 JAAS 来创建登录设计。
Properties: []: 使用此选项来创建定制登录配置。客户机可以使用 JAAS 来创建登录设计。
扩展数据源属性: []: 使用此选项，以便使用异构池的数据源可以连接到 DB2 数据库。该属性的模式为 property1=value1+property2=value 2。

Java 2 连接器 (J2C) 使用登录配置 DefaultPrincipalMapping 将用户映射至 J2C 认证数据条目中所定义的主体。如果 login.config.name 设置为 DefaultPrincipalMapping，那么创建名为 com.ibm.mapping.authDataAlias 的属性。属性的值由 auth.props 设置。如果 login.config 名称未设置为 DefaultPrincipalMapping，那么 auth.props 可以指定多个属性。字符串格式为 websphere:name= <name1>,value=<value1>,description=<desc1>。使用加号 (+) 来指定多个属性。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install myapp.ear {-MapResRefToEJB 
 {{deplmtest.jar MailEJBObject deplmtest.jar,META-INF/ejb-jar.xml mail/MailSession9
 javax.mail.Session jndi1 login1 authProps1 "clientApplicationInformation=new application"}
 {"JavaMail Sample WebApp" "" mtcomps.war,WEB-INF/web.xml mail/MailSession9 
 javax.mail.Session jndi2 login2 authProps2 ""}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-MapResRefToEJB 
 {{deplmtest.jar .*  .*  .*  .*  jndi1 login1 authProps1
 "clientApplicationInformation=new application"}
 {"JavaMail Sample WebApp" .*  .*  .*  .*  jndi2 login2 authProps2 ""}}}

注: 如果将多个值用于扩展数据源属性，那么必须将这些值分配给变量，并将该变量用于该属性值。例如：

set s \"value1,value2\"

如以下示例所示，在命令替换中引用该变量：

"clientApplicationInformation=value1,value2" with "clientapplication=$s"

使用 Jython：

AdminApp.install('myapp.ear', ['-MapResRefToEJB', 
 [['deplmtest.jar', 'MailEJBObject', 'deplmtest.jar,META-INF/ejb-jar.xml
 mail/MailSession9', 'javax.mail.Session', 'jndi1', 'login1', 'authProps1',
 'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
 ["JavaMail Sample WebApp", "", 'mtcomps.war,WEB-INF/web.xml', 'mail/MailSession9',
 'javax.mail.Session', 'jndi2', 'login2', 'authProps2', '']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-MapResRefToEJB', 
 [['deplmtest.jar', '.*', '.*', '.*', '.*', 'jndi1', 'login1', 'authProps1',
 'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
 ["JavaMail Sample WebApp", '', '.*', '.*', '.*', 'jndi2', 'login2',
 'authProps2', '']]])

注: 如果对扩展数据源属性使用多个值，请使用双引号字符将两个值括起来。例如：

'property1="value1,value2"+property2="value3,value4"'

MapRolesToUsers

MapRolesToUsers 选项将用户映射到角色。必须将应用程序或模块中定义的每个角色映射至来自域用户注册表的用户或组。您可以通过使用管道 (|) 将用户或组分隔开，为单个角色指定多个用户或组。使用此选项可提供缺少的数据或更新任务。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install myapp.ear {-MapRolesToUsers {{"All Role" No Yes "" ""}
 {"Every Role" Yes No "" ""} {DenyAllRole No No user1 group1}}}

使用 Jython：

AdminApp.install('myapp.ear', '[-MapRolesToUsers [["All Role" No Yes "" ""]
 ["Every Role" Yes No "" ""] [DenyAllRole No No user1 group1]]]')

其中 {{"All Role" No Yes "" ""} 对应于以下内容：

表 2. MapRolesToUsers 选项描述。将每个角色映射至一个用户或组。
选项	描述
`"All Role"`	显示角色名
`No`	表明是否允许给予每个人访问权（是/否）
`Yes`	表明是否允许给予所有已认证的用户访问权（是/否）
`""`	表明已映射的用户
`""`	表明已映射的组
`"AllAuthenticatedInTrustedRealms"`	指示会向可信域中的所有有效用户授予访问权限。
`"Mapped users access ids"`	指示映射的用户访问标识
`"Mapped groups access ids"`	指示映射的组访问标识

MapRunAsRolesToUsers

MapRunAsRolesToUsers 选项将 RunAs 角色映射到用户。您安装的企业 Bean 包含预定义的 RunAs 角色。需要以特定角色运行以便在与另一个企业 Bean 交互时标识的企业 Bean 使用 RunAs 角色。使用此选项提供缺少的数据或更新任务。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install C:/myapp.ear {-MapRunAsRolesToUsers {{UserRole user1 
 password1} {AdminRole administrator administrator}}}

$AdminApp install myapp.ear {-MapRunAsRolesToUsers {{UserRole user1
 password1} {AdminRole administrator administrator}}}

使用 Jython：

AdminApp.install('C:/myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1 
 password1] [AdminRole administrator administrator]]]')

AdminApp.install('myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1
 password1][AdminRole administrator administrator]]]')

MapSharedLibForMod

MapSharedLibForMod 选项将共享库分配给应用程序或每个模块。您可以使多个共享库与应用程序和模块产生关联。运行缺省绑定后此选项的当前内容如下：

模块：xxx
URI：META-INF/application.xml
共享库：<share libraries>

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi -MapSharedLibForMod {{ DynaCacheEsi META-INF/application.xml
 sharedlib1 }{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 }}}

将 Jacl 与模式匹配配合使用：

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi -MapSharedLibForMod {{ .* .* sharedlib1 }
 { .* .* sharedlib2 }}}

使用 Jython：

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ DynaCacheEsi META-INF/application.xml sharedlib1 ]
 [ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 ]]]' )

将 Jython 与模式匹配配合使用：

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ .* .* sharedlib1 ][ .* .* sharedlib2 ]]]' )

MapWebModToVH

MapWebModToVH 选项为 Web 模块选择虚拟主机。指定要在其中安装应用程序中包含的 Web 模块的虚拟主机。可以在同一虚拟主机上安装 Web 模块，也可以将它们分散安装在几台主机上。使用此选项提供缺少的数据或更新任务。

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。需要为缺少信息或需要更新的行或条目提供数据。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi
 -MapWebModToVH {{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host }}}

将 Jacl 与模式匹配配合使用：

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-MapWebModToVH {{ .* .* default_host }}}

使用 Jython：

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[-MapWebModToVH [[ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host ]]]')

将 Jython 与模式匹配配合使用：

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 ['-MapWebModToVH', [['.*', '.*', 'default_host']]])

MetadataCompleteForModules

MetadataCompleteForModules 选项允许每个 Java EE 5 或更高版本模块写出完整的部署描述符（包括注释中的部署信息）。然后，在完成时，系统会对模块的部署描述符进行标记。

避免麻烦: 如果 Java EE 5 或更高版本的应用程序使用注释和共享库，请勿使用此选项。当应用程序使用注释和共享库时，将 metadata-complete 属性设置为 true 会导致产品将部署描述符中的 @EJB 注释错误地表示为 <ejb-ref> 而不是 <ejb-local-ref>。对于 Web 模块，将 metadata-complete 属性设置为 true 可能会导致 InjectionException 错误。如果必须将 metadata-complete 属性设置为 true，请不要使用共享库、将共享库放入应用程序服务器的 classes 或 lib 目录或者在部署描述符中指定全部元数据，以避免出错。

运行缺省绑定后此选项的当前内容如下：

模块：EJBDD_1.jar
URI：EJBDD_1.jar,META-INF/ejb-jar.xml
锁定部署描述符：[false]：

模块：EJBNoDD_2.jar
URI：EJBNoDD_2.jar,META-INF/ejb-jar.xml
锁定部署描述符：[false]：

使用 AdminApp 对象的 taskInfo 命令来获取有关应用程序需要的数据的信息。

批处理方式示例用法

使用 Jacl：

$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}

$AdminApp install myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{.* EJBDD_1.jar,.* false}}}

$AdminApp install myapp.ear 
 {-MetadataCompleteForModules {{.* EJBDD_1.jar,.* false}}}

使用 Jython：

AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', 
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])

AdminApp.install('myapp.ear', ['-MetadataCompleteForModules',
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', [['.*',
 'EJBDD_1.jar,.*', 'false']]]

AdminApp.install('myapp.ear', 
 ['-MetadataCompleteForModules', [['.*', 'EJBDD_1.jar,.*', 'false']]]

ModuleBuildID

ModuleBuildID 选项显示应用程序 EAR 文件中模块的构建标识。因为该选项是只读的，所以无法对其进行修改。如果已在模块或应用程序 EAR 文件的 MANIFEST.MF 中指定构建标识，那么此选项返回模块的构建信息。构建信息由模块名称、模块 URI 和构建标识组成。

运行缺省绑定后此选项的当前内容包括下列各项：

模块：CacheClient
URI：CacheClient.jar,META-INF/application-client.xml
构建标识：alpha

模块：MailConnector
URI：Mail.rar,META-INF/ra.xml
构建标识：abc

模块：CacheWeb1
URI：CacheWeb1.war,WEB-INF/web.xml
构建标识：alpha

模块：JspWeb1
URI：JspWeb1.war,WEB-INF/web.xml
构建标识：V1.0

模块：Servlet
URI：Servlet.war,WEB-INF/web.xml
构建标识：0.5

批处理方式示例用法

使用 Jython：

print AdminApp.taskInfo('c:/temp/Cache2.ear', 'ModuleBuildID')

print AdminApp.taskInfo('/temp/Cache2.ear', 'ModuleBuildID')

noallowDispatchRemoteInclude

noallowDispatchRemoteInclude 选项禁用企业应用程序，该应用程序通过标准请求分派器机制将 includes 分派到受管节点环境中不同 Java 虚拟机中的 Web 模块之间的资源。

noallowPermInFilterPolicy

noallowPermInFilterPolicy 选项指定当应用程序包含过滤器策略中的策略许可权时不继续应用程序部署过程。此选项是缺省设置并且不需要值。

noallowServiceRemoteInclude

noallowServiceRemoteInclude 选项禁止企业应用程序为来自已将 allowDispatchRemoteInclude 选项设置为 true 的企业应用程序的包含请求提供服务。

节点

node 选项指定要安装或更新整个应用程序或更新应用程序以添加新模块的节点名。如果要更新整个应用程序，那么仅当应用程序包含在安装的应用程序中不存在的新模块时此选项才适用。

批处理方式示例用法

使用 Jacl：

$AdminApp install "C:/myapp.ear" {-node nodeName}

$AdminApp install "/myapp.ear" {-node nodeName}

使用 Jython：

AdminApp.install('C:/myapp/myapp.ear', '[-node nodeName]')

AdminApp.install('/myapp/myapp.ear', '[-node nodeName]')

nocreateMBeansForResources

nocreateMBeansForResources 选项指定不是为所有资源（例如在部署目标上启动应用程序时在应用程序中定义的 servlet、JavaServer Pages 文件和企业 Bean）创建 MBean。此选项是缺省设置并且它不需要值。

nodeployejb

nodeployejb 选项指定不在安装期间运行 EJBDeploy 工具。此选项是缺省设置并且不需要值。

nodeployws

nodeployws 选项指定不在安装期间部署 Web Service。此选项是缺省设置并且不需要值。

nodistributeApp

nodistributeApp 选项指定应用程序管理组件不分发应用程序二进制文件。此选项不需要值。缺省设置为 distributeApp 选项。

noenableClientModule

noenableClientModule 选项指定不部署客户机模块。此选项不需要值。这是缺省设置。缺省值为不部署客户机模块。使用 enableClientModule 选项来部署客户机模块。

noreloadEnabled

noreloadEnabled 选项禁用类重新装入。此选项是缺省设置并且不需要值。要指定将扫描应用程序的文件系统以获取更新的文件从而动态地重新装入更改，请使用 reloadEnabled 选项。

nopreCompileJSPs

nopreCompileJSPs 选项指定不对 JavaServer Pages 文件进行预编译。此选项是缺省设置并且不需要值。

noprocessEmbeddedConfig

noprocessEmbeddedConfig 选项指定系统应该忽略应用程序中包含的嵌入式配置数据。此选项不需要值。如果应用程序企业归档 (EAR) 文件不包含嵌入式配置数据，那么 noprocessEmbeddedConfig 选项为缺省设置。否则，缺省设置为 processEmbeddedConfig 选项。

nouseAutoLink

nouseAuto链接选项指定不使用 useAuto链接选项，并且不自动解析 EJB 3.0 之前的 EJB 模块版本和版本 2.4之前的 Web 模块版本中的 Enterprise JavaBeans (EJB) 引用。

nouseMetaDataFromBinary

nouseMetaDataFromBinary 选项指定运行时使用的元数据，例如，来自配置库的部署描述符、绑定、扩展名等。此选项是缺省设置并且不需要值。使用此选项以指示在运行时使用的元数据来自企业归档文件 (EAR) 文件。

nousedefaultbindings

nousedefaultbindings 选项指定安装时不使用缺省绑定。此选项是缺省设置并且不需要值。

novalidateSchema

novalidateSchema 选项指定不针对已发布 Java EE 部署描述符模式验证这些部署描述符。此选项不需要值。这是缺省设置。缺省值为不验证部署描述符。

操作

operation 选项指定您要执行的操作。此选项仅适用于 update 或 updateInteractive 命令。有效值包括：

add - 添加新内容。
addupdate - 根据应用程序中的内容添加或更新内容。
delete - 删除内容。
update - 更新现有内容。

如果内容类型为 file 或 modulefile，那么 operation选项是必需的。如果内容类型的值是 app，那么 operation 选项的值必须是 update。当内容类型为 app 时，将忽略 contenturi 选项。

批处理方式示例用法

以下示例显示如何使用 update 命令的选项来更新整个已部署的企业应用程序：

使用 Jacl：

$AdminApp update "IVT Application" app {-operation update
 -contents app_server_root/installableApps/ivtApp.ear}

使用 Jython 字符串：

AdminApp.update('IVT Application', 'app', '[ -operation update
 -contents app_server_root/installableApps/ivtApp.ear ]' )

以下示例显示如何使用 update 命令的选项在部署的应用程序中更新单个文件：

使用 Jacl：

$AdminApp update app1 file {-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml}

$AdminApp update app1 file {-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml}

使用 Jython 字符串：

AdminApp.update('app1', 'file', '[-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml]')

AdminApp.update('app1', 'file', '[-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml]')

使用 Jython 列表：

AdminApp.update('app1', 'file', ['-operation', 'update', '-contents', 
 'C:/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])

AdminApp.update('app1', 'file', ['-operation',  'update', '-contents',
 '/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])

其中 AdminApp 是脚本编制对象，update 是命令，app1 是要更新的应用程序的名称，file 是内容类型，operation 是 update 命令的选项，update 是 operation 选项的值，contents 是 update 命令的选项，/apps/app1/my.xml 是 contents 选项的值，contenturi 是 update 命令的选项，app1.jar/my.xml 是 contenturi 选项的值。

processEmbeddedConfig

processEmbeddedConfig 选项处理应用程序中包含的嵌入式配置数据。此选项不需要值。如果应用程序企业归档 (EAR) 文件包含嵌入式配置数据，那么此选项是缺省设置。如果不是，那么缺省设置为 nonprocessEmbeddedConfig 选项。

此设置将影响安装增强型 EAR 文件。导出已安装的应用程序时将生成增强型 EAR 文件。增强型 EAR 文件具有嵌入式配置，该配置包括诸如 resource.xml 和 variables.xml 之类的文件。此选项将 EAR 文件中的嵌入式配置装入到应用程序作用域。

如果应用程序是从非当前单元中导出的，并且首次安装应用程序时未对 installed.ear.destination 选项指定 $(CELL) 变量，请使用 nonprocessEmbeddedConfig 选项以在 profile_root/installedApps/current_cell_name 目录中展开增强型 EAR 文件。否则，请使用 processEmbeddedConfig 选项以在 profile_root/installedApps/original_cell_name 目录中展开增强型 EAR 文件，其中 original_cell_name 是首次安装应用程序的单元。如果首次安装应用程序时对 installed.ear.destination 选项指定了 $(CELL) 变量，那么安装过程将在 profile_root/installedApps/current_cell_name 目录中展开增强型 EAR 文件。

preCompileJSPs

preCompileJSPs 选项指定对 JavaServer Pages 文件进行预编译。此选项不需要值。缺省值是 nopreCompileJSPs。如果要对 JavaServer Pages 文件进行预编译，请将其指定为安装的一部分。缺省情况是不对 JavaServer Pages 文件进行预编译。在部署期间会忽略 preCompileJSPs 选项，因此不会对 JavaServer Pages 文件进行预编译。会使用组装工具自动设置此标志。

对于此选项，请仅安装到 V 9.0 部署目标上，该部署目标具有与 Deployment Manager 相同的或更高的 Java SDK 级别。

reloadEnabled

reloadEnabled 选项指定将扫描应用程序的文件系统以获取更新的文件从而动态更改重装。如果启用了此选项，并且应用程序类已更改，那么将停止并重新启动该应用程序以重新装入已更新的类。此选项不是缺省设置并且不需要值。缺省设置是 noreloadEnabled 选项。

reloadInterval

reloadInterval 选项指定将扫描应用程序的文件系统以获取更新的文件的时间段（以秒计）。有效范围是大于 0 的值。缺省值为 3 秒。

SharedLibRelationship

SharedLibRelationship 选项将资产或组合单元标识作为每个 Java EE 模块的共享库进行分配。

运行缺省绑定后此选项的当前内容包括：

模块：EJB3BNDBean.jar
URI：EJB3BNDBean.jar,META-INF/ejb-jar.xml
关系标识：指定资产或组合单元标识，例如 [WebSphere:cuname=sharedLibCU1,cuedition=1.0] 或 WebSphere:assetname=sharedLibAsset1.jar
组合单元名称: (可选) 指定资产关系标识的组合单元名称。如果没有指定组合单元名称，那么系统将使用资产名称。[]
匹配目标：[Yes]：

可在关系中指定资产和组合单元标识，如下列准则所说明：

如果指定资产，那么系统会在 Java EE 应用程序所属的企业级应用程序中创建带有该资产的组合单元。
如果为组合单元名称指定值，那么系统位置与带有对应关系标识值的每个名称匹配。
如果关系标识是组合单元标识，那么系统会忽略对应的组合单元名称。
如果关系标识是资产标识，那么系统会创建使用对应的组合单元名称的组合单元。

要指定多个资产或组合单元标识，请使用加号字符 (+) 来分隔每个值。

当对 Java EE 应用程序使用 edit 命令时，可以用新的组合单元关系标识集来覆盖关系，也可以添加或除去现有组合单元关系。当使用 edit 命令时，您不能指定资产关系。请将组合单元标识的第一个字符指定为要添加至关系的加号字符 (+)，或指定编号符号字符 (#) 以从现有关系中除去组合单元标识。例如，+cuname=cu2.zip 组合单元语法会将 cu2 组合单元添加至关系。 #cuname=cu1.zip+cuname=cu2.zip 组合单元语法会从关系中移除 cu1 和 cu2 组合单元。

批处理方式示例用法

使用 Jacl：

$AdminApp install myapp.ear {-SharedLibRelationship {{EJB3BNDBean.jar 
 EJB3BNDBean.jar,META-INF/ejb-jar.xml WebSphere:cuname=sharedLibCU1 "" Yes}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install myapp.ear {-SharedLibRelationship {{.*
 EJB3BNDBean.jar,.* WebSphere:cuname=sharedLibCU1 "" Yes}}}

使用 Jython：

AdminApp.install('myapp.ear', ['-SharedLibRelationship',
 [['EJB3BNDBean,jar', 'EJB3BNDBean.jar,META-INF/ejb-jar.xml',
 'WebSphere:cuname=sharedLibCU1,' '', 'Yes']]])

将 Jython 与模式匹配配合使用：

AdminApp.install('myapp.ear', ['-SharedLibRelationship', [['.*',
 'EJB3BNDBean.jar,.*', 'WebSphere:cuname=sharedLibCU1', '', 'Yes']]]

服务器

server 选项指定要在其上执行下列其中一个操作的服务器的名称：

安装新的应用程序。
将现有应用程序替换为该应用程序的已更新版本。在此情况下，仅当更新后的应用程序版本包含已安装的应用程序版本中不存在的新模块时，服务器选项才有意义。
将新模块添加至现有应用程序。

不能同时使用 -cluster 和 -server 选项。如果要部署某个应用程序并在部署期间指定 HTTP 服务器，以便该应用程序将出现在生成的 plugin-cfg.xml 文件中，那么您必须首先使用目标 -cluster 安装该应用程序。在安装应用程序之后和进行保存之前，请使用 AdminApp 对象的 edit 命令将其他映射添加到 Web 服务器。

批处理方式示例用法

使用 Jacl：

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-server server1}

使用 Jython：

AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[-server server1]')

目标

target 选项为 AdminApp 对象的安装功能指定目标。以下是 target 选项的示例：WebSphere:cell=mycell,node=mynode,server=myserver

可通过用加号 (+) 定界目标来指定多个目标。缺省情况下，您安装或编辑应用程序时指定的目标替换应用程序中现有的目标定义。您可以使用前导加号 (+) 来添加目标，或者使用负号 (-) 来除去目标，而不必指定未更改的目标。

注: 使用多个域时，必须将完整目标映射语法与 MapModulesToServers 选项配合使用。使用多个域时，不能使用前导 + 符号来通过 MapModulesToServers 选项添加新目标；运行时无法正确解析映射到部署目标的域。

批处理方式示例用法

以下示例将 server1 指定为应用程序安装的目标服务器：

使用 Jacl：

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname MyApp -target WebSphere:cell=myCell,node=myNode,server=server1}

使用 Jython：

AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-target", "WebSphere:cell=myCell,node=myNode,server=server1"])

以下示例将 server1 和 server2 指定为应用程序安装的目标服务器：

使用 Jacl：

$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname MyApp -target
 WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2}

使用 Jython：

AdminApp.install("app_server_root/installableApps/DynaCacheEsi.ear",
 ["-appname", "MyApp", "-target",
 "WebSphere:cell=myCell,node=Node1,server=server1+WebSphere:cell=Cell1,node=myNode,server=server2"])

以下示例从安装的应用程序移除 server3：

使用 Jacl：

$AdminApp install
 app_server_root/binaries/DefaultApplication.ear {-appname MyApp
 -target -WebSphere:cell=GooddogCell,node=BaddogNode,server=server3
 -update -update.ignore.old}

使用 Jython：

AdminApp.install("app_server_root/binaries/DefaultApplication.ear",
 ["-appname", "MyApp",
 "-target", "-WebSphere:cell=GooddogCell,node=BaddogNode,server=server3",
 "-update", "-update.ignore.old"])

以下示例将 server4 添加到安装的应用程序：

使用 Jacl：

$AdminApp update app {-appname MyApp
 -target +WebSphere:cell=GooddogCell,node=GooddogNode,server=server4
 -contents app_server_root/binaries/DefaultApplication.ear
 -operation update -update.ignore.old}

使用 Jython：

AdminApp.update("app", ["-appname", "MyApp",
 "-target", "+WebSphere:cell=GooddogCell,node=GooddogNode,server=server4",
 "-contents", "app_server_root/binaries/DefaultApplication.ear",
 "-operation", "update", "-update.ignore.old"])

update

update 选项用企业归档 (EAR) 文件的新版本更新安装的应用程序。此选项不需要值。

要更新的应用程序 (由 appname 选项指定) 必须已安装在 WebSphere Application Server 配置中。更新操作将新版本中的绑定与旧版本中的绑定合并，卸载旧版本并安装新版本。来自新版本的 EAR 文件或模块的绑定信息优先于来自旧版本的相应绑定信息。如果新版本中缺少任何绑定元素，那么将使用旧版本中的相应元素。

update.ignore.new

update.ignore.new 选项指定：在更新操作期间，应用程序或模块的旧版本中的绑定信息优先于新版本中的相应绑定信息。如果该绑定的任何元素在旧版本中不存在，那么将使用新版本中的相应元素。这就是说，如果某个绑定在应用程序或模块的旧版本中存在，那么将忽略新版本中的绑定。否则，将使用新绑定，而不是将其忽略。此选项不需要值。

仅当您指定以下某一项时此选项才适用：

install 命令的更新选项。
modulefile 或 app 作为 update 命令的内容类型。

update.ignore.old

update.ignore.old 选项指定：在更新操作期间，应用程序或模块的新版本中的绑定信息优先于旧版本中的相应绑定信息。将忽略应用程序或模块的旧版本中的绑定。此选项不需要值。仅当您指定以下某一项时此选项才适用：

install 命令的更新选项。
modulefile 或 app 作为 update 命令的内容类型。

useAutoLink

使用 useAutoLink 选项可自动解析来自 EJB 3.0之前的 EJB 模块版本以及来自 2.4之前的 Web 模块版本的 Enterprise JavaBeans (EJB) 引用。如果启用 useAutoLink 选项，那么可选择为 MapEJBRefToEJB 选项指定 JNDI 名称。应用程序中的每个模块必须共享一个公共目标以启用自动链接支持。

批处理方式示例用法

使用 Jacl：

$AdminApp install C:/myapp.ear {-useAutoLink}

$AdminApp install /myapp.ear {-useAutoLink}

使用 Jython：

AdminApp.install('C:/myapp.ear','[-useAutoLink]')

AdminApp.install('myapp.ear','[-useAutoLink]')

usedefaultbindings

usedefaultbindings 选项指定安装时使用缺省绑定。此选项不需要值。缺省设置为 nousedefaultbindings。

要使用现有侦听器端口而不使用或创建新的激活规范，请确定 EJB JAR 版本是否低于 2.1。当指定 -usedefaultbindings 选项以部署应用程序时，系统将自动创建并使用激活规范。如果存在激活规范，那么系统将忽略侦听器端口，而改为使用激活规范。要使用定义的侦听器端口而不是新的激活规范来部署 EJB JAR 版本高于或等于 2.1 的应用程序，请将相关概要文件的属性目录中的 wsadmin.properties 文件中的 com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting 系统属性设置为 true 。

useMetaDataFromBinary

useMetaDataFrom二进制选项指定在运行时使用的元数据 (例如，部署描述符，绑定和扩展等) 来自 EAR 文件。此选项不需要值。缺省值为 nouseMetaDataFromBinary，这表示在运行时使用的元数据来自配置库。

validateinstall

validateinstall 选项指定应用程序安装验证的级别。有效选项值包括：

off - 指定无应用程序部署验证。此值是缺省值。
warn - 执行应用程序部署验证并且即使存在报告的警告或错误消息，仍继续应用程序部署处理。
fail - 执行应用程序部署验证并且当存在报告的警告或错误消息时，不继续应用程序部署处理。

validateSchema

validateSchema 选项指定针对已发布 Java EE 部署描述符模式验证这些部署描述符。选择此应用程序部署选项后，产品将分析每个部署描述符以确定部署描述符的 Java EE 规范版本，选择相应的模式，然后根据 Java EE 部署描述符模式检查部署描述符。验证错误会产生错误消息。

此选项不需要值。缺省值为 novalidateSchema。缺省情况下，部署期间会忽略 validateSchema 选项，并且产品不会验证这些部署描述符。

详细

详细选项会导致在安装期间显示其他消息。此选项不需要值。

WebServicesClientBindDeployedWSDL

WebServicesClientBindDeployedWSDL 选项标识您正在修改的客户机 Web Service。作用域限定字段包括：Module、EJB 和 Web Service。此任务的单个可变值是部署的 WSDL 文件名。它表明客户机使用的 Web 服务描述语言 (WSDL)。

Module 字段标识应用程序中的企业应用程序或 Web 应用程序。如果模块是企业 Bean，那么 EJB 字段在模块内标识特定的企业 Bean。 Web Service 字段标识企业 Bean 或 Web 应用程序模块内的 Web Service。此标识对应于 WSDL 文件中的 wsdl: service 属性，其前缀为 service/; 例如， service/WSLoggerService2.

部署的 WSDL 属性指定与客户机模块相对的 WSDL 文件。以下是 Web 应用程序的已部署 WSDL 的示例：WEB-INF/wsdl/WSLoggerService。

批处理方式示例用法

使用 Jacl：

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar 
 AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{.*  .*  .*  
 META-INF/wsdl/DeployedWsdl1.wsdl}}}

以下示例说明 BindJndiForEJBNonMessageBinding、Hermaphrodite 和 WebServicesClientBindDeployedWSDL 选项：

$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 META-INF/wsdl/DeployedWsdl1.wsdl}} 
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml 
jndi1 "" "" } { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }} 
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} }

使用 Jython：

AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindDeployedWSDL 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl]]]')

要安装 WebServicesSamples.ear 样本，必须指定 BindJndiForEJBNonMessageBinding 和 MapWebModToVH 选项以及 WebServicesClientBindDeployedWSDL 选项：

$AdminApp install WebServicesSamples.ear', '[ 
-WebServicesClientBindDeployedWSDL [[ AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 META-INF/wsdl/DeployedWsdl1.wsdl ]] 
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml 
jndi1 "" "" ] [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]] 
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )

将 Jython 与模式匹配配合使用：

AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindDeployedWSDL',
['.*', '.*', '.*',  'META-INF/wsdl/DeployedWsdl1.wsdl']]])

WebServicesClientBindPortInfo

WebServicesClientBindPortInfo 选项标识您正在修改的客户机 Web Service 的端口。作用域限定字段包括：Module、EJB、Web Service 和 Port。此任务的可变值包括: Sync Timeout， BasicAuth ID， BasicAuth Password， SSL Config和 Overridden Endpoint URI。基本认证和安全套接字层 (SSL) 字段影响传输级安全性，而不会影响 Web Service 安全性。

批处理方式示例用法

使用 Jacl：

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{AddressBookW2JE.jar 
 AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig 
 http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}}

要安装 WebServicesSamples.ear 样本，必须指定 BindJndiForEJBNonMessageBinding 和 MapWebModToVH 选项以及 WebServicesClientBindPortInfo 选项：

$AdminApp install WebServicesSamples.ear {
-WebServicesClientBindPortInfo {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig
 http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}} 
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml
 jndi1 "" "" }
 { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample
 EJB" com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }} 
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} }

将 Jacl 与模式匹配配合使用：

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{.*  .*  .*  .*  3000 
 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}}

使用 Jython：

AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPortInfo
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID
 newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS]]]')

要安装 WebServicesSamples.ear 样本，必须指定 BindJndiForEJBNonMessageBinding 和 MapWebModToVH 选项以及 WebServicesClientBindPortInfo 选项：

AdminApp.install('WebServicesSamples.ear', '[ 
-WebServicesClientBindPortInfo [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS
 3000 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS ]] 
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
 [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]] 
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )

将 Jython 与模式匹配配合使用：

AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPortInfo',
 [['.*', '.*', '.*', '.*', '3000', 'newHTTP_ID', 'newHTTP_pwd', 'sslAliasConfig',
 'http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS']]])

WebServicesClientBindPreferredPort

WebServicesClientBindPreferredPort 选项将客户机 Web Service 的首选端口（实现）与端口类型（接口）相关联。不可变值标识您正在修改的客户机 Web Service 的端口类型。作用域限定字段包括：Module、EJB、Web Service 和 Port Type。此任务的可变值为 Port。

端口类型 - 由标识接口的 WSDL 文件中的 wsdl:portType 属性定义的端口类型的 QName ("{namespace} localname")。
端口 - 由标识具有首选项的实现的 WSDL 文件中的 wsdl:service 属性内的 wsdl:port 属性定义的 QName。

批处理方式示例用法

使用 Jacl：

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort
 {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort}}}

要安装 WebServicesSamples.ear 样本，必须指定 BindJndiForEJBNonMessageBinding 和 MapWebModToVH 选项以及 WebServicesClientBindPreferredPort 选项：

$AdminApp install WebServicesSamples.ear
{-WebServicesClientBindPreferredPort {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2
 WSLoggerJMS WSLoggerJMSPort}}
-BindJndiForEJBNonMessageBinding {{ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" }
 { "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" }{ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" }}
-MapWebModToVH {{ "module_name" web_services.war,WEB-INF/web.xml default_host }
 { "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host }
 { "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host }} }

将 Jacl 与模式匹配配合使用：

$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort {{.* .* .* .* 
 WSLoggerJMSPort}}}

使用 Jython：

AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPreferredPort 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort]]]')

要安装 WebServicesSamples.ear 样本，必须指定 BindJndiForEJBNonMessageBinding 和 MapWebModToVH 选项以及 WebServicesClientBindPreferredPort 选项：

AdminApp.install('WebServicesSamples.ear',
'[ -WebServicesClientBindPreferredPort
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort ]]
-BindJndiForEJBNonMessageBinding [[ "Stock Quote Sample EJB"
 com_ibm_websphere_samples_webservices_stock_StockQuote StockQuote.jar,META-INF/ejb-jar.xml jndi1 "" "" ]
 [ "Address Book Sample EJB" com_ibm_websphere_samples_webservices_addr_AddressBookW2JE
 AddressBookW2JE.jar,META-INF/ejb-jar.xml jndi2 "" "" ][ "Address Book Sample EJB"
 com_ibm_websphere_samples_webservices_addr_AddressBookJ2WE AddressBookJ2WE.jar,META-INF/ejb-jar.xml
 jndi3 "" "" ]]
-MapWebModToVH [[ "module_name" web_services.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Bottom Up Java Bean" AddressBookJ2WB.war,WEB-INF/web.xml default_host ]
 [ "AddressBook Top Down Java Bean" AddressBookW2JB.war,WEB-INF/web.xml default_host ]]]' )

将 Jython 与模式匹配配合使用：

AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPreferredPort',
 [['.*', '.*', '.*', '.*', 'WSLoggerJMSPort']]])

WebServicesServerBindPort

WebServicesServerBindPort 选项设置 Web Service 端口的两个属性。不可变值标识您正在修改的 Web Service 的端口。作用域限定字段包括：Module、Web Service 和 Port。可变值包括：WSDL Service Name 和 Scope。

作用域确定实现 Java Bean 的生命周期。有效值包括：Request（每个请求的新实例）、Application（每个 Web-app 的一个实例）以及 Session（每个 HTTP 会话的新实例）。

作用域属性不适用于 Java 消息服务 (JMS) 传输的 Web Service。作用域属性不适用于企业 Bean。

当多个服务具有同一个端口名时，WSDL 服务名称标识服务。 WSDL 服务名称显示为 QName 字符串，例如，{namespace}localname。

批处理方式示例用法

使用 Jacl：

$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
 {{AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS {} Session}}}

将 Jacl 与模式匹配配合使用：

$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
 {{.*  WSClientTestService WSClientTest Request} {.*  StockQuoteService StockQuote Application}
 {.*  StockQuoteService StockQuote2 Session}}}

使用 Jython：

AdminApp.install('WebServicesSamples.ear', '[-WebServicesServerBindPort
 [[AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS "" Session]]]')

将 Jython 与模式匹配配合使用：

AdminApp.install('WebServicesSamples.ear', ['-WebServicesServerBindPort',
 [['.*', 'WSClientTestService', 'WSClientTest', 'Request'],
 ['.*', 'StockQuoteService', 'StockQuote', 'Application'],
 ['.*', 'StockQuoteService', 'StockQuote2', 'Session']]])

WebServicesClientCustomProperty

WebServicesClientCustomProperty 选项支持对 Web Service 的客户机绑定文件描述的名称值参数进行配置。不可变值标识您正在修改的 Web Service 的端口。作用域字段包括：Module、Web Service 和 Port。可变值包括：name 和 value。

name 和 value值的格式包括表示多个名称的字符串和使用 + 字符作为分隔符的值对。例如，名称字符串 = "n1+n2+n3" 值字符串 = "v1+v2+v3" 产生“名称/值”对：{{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}。

批处理方式示例用法

使用 Jacl：

$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty
 {{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest service/StockQuoteService
 STockQuote propname1 propValue1}
{ejbclientonly.jar Exchange service/STockQuoteService STockQuote propname2 propValue2}}}

将 Jacl 与模式匹配配合使用：

$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty
 {{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest .* .* propname1 propValue1}
 {ejbclientonly.jar Exchange .* .* propname2 propValue2}}}

使用 Jython：

AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty',
 [['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest',
 'service/StockQuoteService', 'STockQuote', 'propname1', 'propValue1'],
 ['ejbclientonly.jar', 'Exchange', 'service/STockQuoteService', 'STockQuote',
 'propname2', 'propValue2']]])

将 Jython 与模式匹配配合使用：

AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty',
 [['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest',
 '.*', '.*', 'propname1', 'propValue1'],
 ['ejbclientonly.jar', 'Exchange', '.*', '.*', 'propname2', 'propValue2']]])

WebServicesServerCustomProperty

WebServicesServerCustomProperty 选项支持对 Web Service 的服务器绑定文件描述的名称值参数进行配置。作用域限定字段包括：Module、EJB 和 Web Service。此任务的可变值包括：name 和 value。

这些值的格式包括表示多个名称的字符串和通过使用加号 (+) 字符作为分隔符的值对。例如，名称字符串 = "n1+n2+n3" 值字符串 = "v1+v2+v3" 产生“名称/值”对：{{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}。

批处理方式示例用法

使用 Jacl：

$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
 {{AddressBookW2JE.jar AddressBookService AddressBook
 com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}

将 Jacl 与模式匹配配合使用：

$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
 {{.* .* .* com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}

使用 Jython：

AdminApp.edit ( 'WebServicesSamples', '[ -WebServicesServerCustomProperty
 [[AddressBookW2JE.jar AddressBookService AddressBook
 com.ibm.websphere.webservices.http.responseContentEncoding deflate]]]')

将 Jython 与模式匹配配合使用：

AdminApp.edit ( 'WebServicesSamples', ['-WebServicesServerCustomProperty', [['.*', '.*',
 '.*', 'com.ibm.websphere.webservices.http.responseContentEncoding', 'deflate']]])