當使用 wsadmin Scripting 時，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
應用程式名稱
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
詳細
WebServicesClientBindDeployedWSDL
WebServicesClientBindPortInfo
WebServicesClientBindPreferredPort
WebServicesServerBindPort
WebServicesClientCustomProperty
WebServicesServerCustomProperty

ActSpecJNDI

ActSpecJNDI 選項會將 Java™ 2 Connector (J2C) 啟動規格連結到目的地「Java 命名和目錄介面 (JNDI)」名稱。您可以選擇性地將應用程式或模組中的 J2C 啟動規格連結到目的地 JNDI 名稱。您可以指派 ActSpecJNDI 選項下列各元素的值：RARModule、uri、j2cid 和 j2c.jndiName 欄位。執行預設連結之後的選項內容包括：

RARModule: <rar module name>
uri: <rar name>,META-INF/ra.xml
Object identifier: <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 之 Enterprise Bean Java 保存檔 (JAR) 模組的後端系統 ID。 Enterprise Bean JAR 模組可以利用應用程式組合工具，依照指定來支援多個後端配置。在安裝期間，請利用這個選項來變更後端系統 ID。

批次模式用法範例

使用 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連結選項會將訊息驅動 Enterprise Bean 連結至接聽器埠名稱或啟動規格「Java 命名和目錄介面 (JNDI)」名稱。請利用這個選項來提供遺漏的資料或更新作業。當訊息驅動 Enterprise 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]:
ActivationSpec 鑑別別名：[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 選項會將 Enterprise Bean 連結至「Java 命名和目錄介面 (JNDI)」名稱。請確定您的應用程式或模組中的每個非訊息驅動 Enterprise 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 名稱，就不要指定本端起始位置或遠端起始位置 JNDI 名稱。另外，您也不能在 BindJndiForEJBBusiness 選項中，指定商業介面欄位的 JNDI。如果未指定目標資源 JNDI 名稱，本端和遠端起始位置 JNDI 名稱欄位就是選用的。如果未指定本端和遠端 JNDI 名稱，執行時期會提供儲存器預設值。

如果未使用 EJB 3.0 模組，您必須指定目標資源 JNDI 名稱。

請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。您必須提供遺漏資訊或需要更新的列或項目的資料。

批次模式用法範例

使用 Jacl：

$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('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 選項指定 Cell 名稱來安裝或更新整個應用程式，或更新應用程式以便新增模組。如果您想要更新整個應用程式，只有在應用程式包含已安裝的應用程式中沒有的新模組時，這個選項才適用。

批次模式用法範例

使用 Jacl：

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

使用 Jython：

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

clientMode

clientMode 選項指定是否將用戶端模組部署至隔離的部署目標 (isolated)、部署管理程式的聯合節點 (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 "myapp.ear" {-cluster clusterName}

使用 Jython：

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

內容

contents 選項指定含有要更新之內容的檔案。例如，依內容類型而定，這個檔案可能是 EAR 檔、模組、局部 zip 或單一檔案。檔案路徑必須是在 Scripting 用戶端的本端。除非您指定了 delete 選項，否則 contents 選項是必要的。

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 選項會將「執行系統身分」取代為「執行身分角色」。您安裝的 Enterprise Bean 包含一個執行系統身分。您可以選擇性地將這個身分改成執行身分角色。請利用這個選項來提供遺漏的資料或更新作業。

請利用 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

createMBeanForResources 選項指定在部署目標上啟動應用程式時，建立應用程式中所定義之所有資源（如：Servlet、JavaServer Pages (JSP) 檔和 Enterprise Bean 等）的 MBean。這個選項不需要值。預設值是 nocreateMBeanForResources 選項。

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

自訂

自訂選項利用 name=value 格式來指定名稱值配對。請利用 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 會置換含有 Enterprise 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]:
登入配置名稱：[null]: 請利用這個選項來建立自訂登入配置。用戶端可以利用 JAAS 來建立登入設計。
內容：[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 myapp.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB" IncCMP11
 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}}

搭配型樣比對來使用 Jacl：

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

使用 Jython：

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('myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*',
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])

DataSourceFor20CMPBeans

DataSourceFor20CMPBeans 選項指定個別的 2.x 儲存器管理持續性 (CMP) Bean 的選用資料來源。請利用這個選項來提供遺漏的資料或更新作業。

將特定資料來源對映至 CMP Bean 會置換含有 Enterprise 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]:
資源權限：[每一個應用程式]:
登入配置名稱：[null]: 請利用這個選項來建立自訂登入配置。用戶端可以利用 JAAS 來建立登入設計。
內容：[]: 請利用這個選項來建立自訂登入配置。用戶端可以利用 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 之 Enterprise 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]:
登入配置名稱：[null]: 請利用這個選項來建立自訂登入配置。用戶端可以利用 JAAS 來建立登入設計。
內容：[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 之 Enterprise 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]:
資源權限：[每一個應用程式]:
登入配置名稱：[null]: 請利用這個選項來建立自訂登入配置。用戶端可以利用 JAAS 來建立登入設計。
內容：[]: 請利用這個選項來建立自訂登入配置。用戶端可以利用 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 選項指定預設 Connection Factory 的「Java 命名和目錄介面 (JNDI)」名稱。

defaultbinding.cf.resauth

defaultbinding.cf.resauth 選項指定 Connection Factory 的 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 選項指定 Enterprise 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 模組包含 Entity Bean ，在下列情況下，您必須使用這個 deployejb 選項:

EAR 檔是利用 Rational® Application Developer 等組合工具來組合的，且組合期間未執行 EJBDeploy 工具。
EAR 檔不是利用 Rational Application Developer 等組合工具來組合的。
使用 5.0 版以前的應用程式組合工具 (AAT) 版本組合了 EAR 檔。

如果 EJB 模組包裝在 Web 保存檔 (WAR) 中，您不需要使用這個 deployejb 選項。

對於此選項，僅安裝至 9.0版部署目標，其 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 選項指定要用於 EJBDeploy 工具的額外 RMIC 選項。

deployejb.sqljclasspath

deployejb.sqljclasspath 選項指定 SQLJ 轉換器類別的位置。

deployws

deployws 選項指定在安裝期間部署 Web 服務。這個選項不需要值。

預設值如下：nodeployws。

對於此選項，僅安裝至 9.0版部署目標，其 Java SDK 層次與部署管理程式相同或更高。

deployws.classpath

deployws.classpath 選項指定部署 Web 服務時所用的額外類別路徑。

如果要指定多個項目的類別路徑，請利用搭配 CLASSPATH 環境變數使用時所用的相同分隔字元來分開各個項目。

[z/OS] 使用冒號 (:) 來分開各個項目。

deployws.jardirs

deployws.jardirs 選項指定部署 Web 服務時所用的額外延伸目錄。

distributeApp

distributeApp 選項指定應用程式管理元件配送應用程式二進位檔。這個選項不需要值。這個設定是預設值。

EmbeddedRar

EmbeddedRar 選項會將 Java 2 Connector 物件連結到 JNDI 名稱。您必須將應用程式或模組中的每個 Java 2 Connector 物件（如：J2C Connection Factory、J2C 啟動規格和 J2C 管理物件）連結到 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 選項指定部署用戶端模組。如果要部署的檔案有一或多個要部署的用戶端模組，請選取這個選項。如果您選取這個選項，則只能將用戶端模組安裝到 8.0 版或更新版的部署目標。

這個選項不需要值。預設值是 noenableClientModule。依預設，在部署期間，會忽略 enableClientModule 選項，不會部署用戶端模組。

EnsureMethodProtectionFor10EJB

EnsureMethodProtectionFor10EJB 選項會選取 1.x Enterprise 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 Enterprise 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 Class Path: <jsp class path>
使用完整套件名稱：Yes | No
JDK 來源層次：xx
停用 JSP 執行時期編譯：Yes | No

對於「使用完整套件名稱」和「停用 JSP 執行時期編」，請以語言環境專用的語言來指定 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 enable class reloading: <Yes | No>
JSP reload interval in seconds: <jsp reload internal number>

請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。

對於 JSP 啟用重新載入類別功能，請以語言環境專用的語言來指定 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

MapEJBRefToEJB 選項會將 Enterprise Java 參照對映至 Enterprise Bean。您必須將您的應用程式所定義的每個 Enterprise Bean 參照對映至某個 Enterprise Bean。使用此選項來提供遺漏資料或更新作業。

如果是從 EJB 3.x、Web 2.4 或 Web 2.5 模組進行 EJB 參照，JNDI 名稱便是選用的。如果您指定 useAutoLink 選項，JNDI 名稱就是選用的。執行時期提供儲存器預設值。 EJB 3.0 或更新版本的模組不能包含儲存器管理或 Bean 管理持續性的 Entity Bean。如果將儲存器管理或 Bean 管理持續性的 Entity 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 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('myapp.ear', ['-MapEJBRefToEJB', 
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])

MapEnvEntryForApp

MapEnvEntryForApp 選項會編輯應用程式的 env-entry 值。您可以利用這個選項來編輯 application.xml 檔中的 env-entry 值。

執行預設連結之後，這個選項的現行內容如下：

名稱：xxx
類型：xxx
說明：xxx
避免麻煩: 在執行預設連結之後，如果值是 null 值，您必須將值變更為 .* ，才能執行這項作業。 .* 值是萬用字元值，任何說明都會成為相符項目。如果您將值保留為 null，則當您執行 MapEnvEntryFor應用程式作業時，會發生異常狀況。
Value: <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 選項會編輯用戶端模組的 env-entry 值。您可以利用這個選項來編輯用戶端模組 application-client.xml 檔中的環境項目值。

執行預設連結之後，這個選項的現行內容如下：

用戶端模組：xxx
URI：xxx
名稱：xxx
類型：xxx
說明：xxx
Value: <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 異常狀況。
Value: <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 異常狀況。
Value: <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
Value: <initial parameter value>

如果 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

對於「使用 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，並將它對映到部署管理程式所管理的兩部伺服器：

使用 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]:
登入配置名稱：[null]: 請利用這個選項來建立自訂登入配置。用戶端可以利用 JAAS 來建立登入設計。
內容：[]: 請利用這個選項來建立自訂登入配置。用戶端可以利用 JAAS 來建立登入設計。
延伸資料來源內容: []: 請使用這個選項，以便使用異質儲存區的資料來源可以連接至 DB2 資料庫。內容型樣如下：property1=value1+property2=value 2。

Java 2 Connector (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/no)
`Yes`	指允許所有已鑑別的使用者存取 (yes/no)
`""`	指對映的使用者
`""`	指對映的群組
`"AllAuthenticatedInTrustedRealms"`	指將存取權授與授信網域範圍中任何有效的使用者。
`"Mapped users access ids"`	指對映的使用者存取 ID
`"Mapped groups access ids"`	指對映的群組存取 ID

MapRunAsRolesToUsers

MapRunAsRolesToUsers 選項會將執行身分角色對映至使用者。您安裝的 Enterprise Bean 包含預先定義的執行身分角色。當與另一個 Enterprise Bean 互動時，必須以特定角色來執行以便於識別的 Enterprise Bean，會使用執行身分角色。請利用這個選項來提供遺漏的資料或更新作業。

請利用 AdminApp 物件的 taskInfo 指令來取得應用程式所需要資料的相關資訊。您必須提供遺漏資訊或需要更新的列或項目的資料。

批次模式用法範例

使用 Jacl：

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

使用 Jython：

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 目錄中，或在部署描述子中完整指定 meta 資料。

執行預設連結之後，這個選項的現行內容如下：

模組：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 myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}

搭配型樣比對來使用 Jacl：

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

使用 Jython：

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

搭配型樣比對來使用 Jython：

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

ModuleBuildID

ModuleBuildID 選項會顯示應用程式 EAR 檔中模組的建置 ID。您無法修改這個選項，因為它是唯讀的。如果您已在模組或應用程式 EAR 檔的 MANIFEST.MF 中指定建置 ID ，這個選項會傳回模組的建置資訊。建置資訊由模組名稱、模組 URI 和建置 ID 組成。

執行預設連結之後，這個選項的現行內容會類似下列各項：

模組：CacheClient
URI：CacheClient.jar,META-INF/application-client.xml
建置 ID：alpha

模組：MailConnector
URI：Mail.rar,META-INF/ra.xml
建置 ID：abc

模組：CacheWeb1
URI：CacheWeb1.war,WEB-INF/web.xml
建置 ID：alpha

模組：JspWeb1
URI：JspWeb1.war,WEB-INF/web.xml
建置 ID：v1.0

模組：Servlet
URI：Servlet.war,WEB-INF/web.xml
建置 ID：0.5

批次模式用法範例

使用 Jython：

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

noallowDispatchRemoteInclude

noallowDispatchRemoteInclude 選項會停用企業應用程式透過標準要求分派器機制，將 includes 分派給受管理節點環境中不同 Java 虛擬機器的 Web 模組之間的資源。

noallowPermInFilterPolicy

noallowPermInFilterPolicy 選項指定當應用程式包含過濾原則中的原則許可權，就不繼續執行應用程式部署程序。這個選項是預設值，不需要值。

noallowServiceRemoteInclude

noallowServiceRemoteInclude 選項會使企業應用程式無法處理 allowDispatchRemoteInclude 選項設為 true 的企業應用程式所發出的併入要求。

節點

node 選項指定節點名稱來安裝或更新整個應用程式，或更新應用程式以便新增模組。如果您想要更新整個應用程式，只有在應用程式包含已安裝的應用程式中沒有的新模組時，這個選項才適用。

批次模式用法範例

使用 Jacl：

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

使用 Jython：

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

nocreateMBeansForResources

nocreateMBeanForResources 選項指定在部署目標上啟動應用程式時，不建立應用程式中所定義之所有資源（如：Servlet、JavaServer Pages 檔和 Enterprise Bean 等）的 MBean。這個選項是預設值，不需要值。

nodeployejb

nodeployejb 選項指定在安裝期間，不執行 EJBDeploy 工具。這個選項是預設值，不需要值。

nodeployws

nodeployws 選項指定在安裝期間，不部署 Web 服務。這個選項是預設值，不需要值。

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 選項指定執行時期所用的 meta 資料，如：部署描述子、連結、延伸，等等，是取自配置儲存庫。這個選項是預設值，不需要值。請利用這個選項來指示，執行時期所用的 meta 資料是取自企業保存檔 (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 /apps/app1/my.xml -contenturi app1.jar/my.xml}

使用 Jython 字串：

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

使用 Jython 清單：

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

其中 AdminApp 是 Scripting 物件，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 檔將內嵌配置載入應用程式範圍。

如果您從現行 Cell 以外的 Cell 中匯出應用程式，且在初次安裝應用程式時，並未指定 installed.ear.destination 選項的 $(CELL) 變數，請使用 nonprocessEmbeddedConfig 選項，以在 profile_root/installedApps/current_cell_name 目錄中展開加強型 EAR 檔。否則，請使用此 processEmbeddedConfig 選項，在 profile_root/installedApps/original_cell_name 目錄中展開加強型 EAR 檔，其中 original_cell_name 是初次安裝應用程式所在的 Cell。如果初次安裝應用程式時，針對 installed.ear.destination 選項指定了 $(CELL) 變數，安裝作業便會在 profile_root/installedApps/current_cell_name 目錄中展開加強型 EAR 檔。

preCompileJSPs

preCompileJSPs 選項指定前置編譯 JavaServer Pages 檔。這個選項不需要值。預設值是 nopreCompileJSPs。如果您想要前置編譯 JavaServer Pages 檔，請將它指定為安裝作業的一部分。預設值是不前置編譯 JavaServer Pages 檔。在部署期間，系統不處理 preCompileJSPs 選項，JavaServer Pages 檔不會進行前置編譯。這個旗標是利用組合工具來自動設定。

對於此選項，僅安裝至 9.0版部署目標，其 Java SDK 層次與部署管理程式相同或更高。

reloadEnabled

reloadEnabled 選項指定將掃描應用程式檔案系統來尋找已更新的檔案，以便動態重新載入變更。如果啟用這個選項且應用程式類別已變更，則應用程式會停止並重新啟動，以重新載入更新過的類別。這個選項不是預設值且不需要值。預設值是 noreloadEnabled 選項。

reloadInterval

reloadInterval 選項指定掃描應用程式檔案系統來尋找已更新檔案的時段（秒）。有效範圍是大於零。預設值是 3 秒。

SharedLibRelationship

SharedLibRelationship 選項會將資產或組合單元 ID 指派為每個 Java EE 模組的共用程式庫。

執行預設連結之後，現行選項內容包括：

模組：EJB3BNDBean.jar
URI：EJB3BNDBean.jar,META-INF/ejb-jar.xml
關係 ID：請指定資產或組合單元 ID，例如，[WebSphere:cuname=sharedLibCU1,cuedition=1.0] 或 WebSphere:assetname=sharedLibAsset1.jar
組合單元名稱：請選擇性地指定資產關係 ID 的組合單元名稱。如果您未指定組合單元名稱，系統會使用與資產相同的名稱。 []
相符目標：[Yes]:

您可以依照下列準則所說明來指定關係中的資產和組合單元 ID：

如果您指定資產，系統會在 Java EE 應用程式所屬的商業層次應用程式中，建立一個含有這個資產的組合單元。
如果您指定了組合單元名稱的值，系統位置會使每個名稱與對應的關係 ID 值相符。
如果關係 ID 是一個組合單元 ID，系統會忽略對應的組合單元名稱。
如果關係 ID 是一個資產 ID，系統會利用相對應的組合單元名稱來建立組合單元。

如果要指定多個資產或組合單元 ID，請用加號字元 (+)，將各個值隔開。

當 edit 指令用於 Java EE 應用程式時，您可以用一組新的組合單元關係 ID 來置換關係，也可以新增或移除現有的組合單元關係。當使用 edit 指令時，您無法指定資產關係。請將組合單元 ID 的第一個字元指定為加號 (+)，以新增到關係中，或指定數字記號 (#)，將組合單元 ID 從現有的關係中移除。例如，+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 選項指定要執行下列其中一個動作之伺服器的名稱：

安裝新的應用程式。
以應用程式的更新版本來取代現有的應用程式。在這個狀況之下，只有在應用程式的更新版本包含已安裝應用程式版本中沒有的新模組時，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 選項會以新版的企業保存檔 (EAR) 來更新已安裝的應用程式。這個選項不需要值。

要更新的應用程式 (由 appname 選項指定) 必須已安裝在 WebSphere Application Server 配置中。更新動作會將新舊版本的連結合併起來，將舊版解除安裝，然後安裝新版本。新版 EAR 檔或模組的連結資訊優先於舊版中對應的連結資訊。如果新版遺漏了連結的任何元素，就會使用舊版中對應的元素。

update.ignore.new

update.ignore.new 選項指定在更新動作期間，舊版應用程式或模組的連結資訊優先於新版中對應的連結資訊。如果舊版遺漏了連結的任何元素，就會使用新版中的元素。換言之，如果應用程式或模組的舊版連結存在，就會忽略新版中的連結。否則，將允許使用而不忽略新的連結。這個選項不需要值。

只有在指定下列其中一個項目時，才適用這個選項：

install 指令的 update 選項。
modulefile 或 app，作為 update 指令的內容類型。

update.ignore.old

update.ignore.old 選項指定在更新動作期間，新版應用程式或模組的連結資訊優先於舊版中對應的連結資訊。系統不處理舊版應用程式或模組的連結。這個選項不需要值。只有在指定下列其中一個項目時，才適用這個選項：

install 指令的 update 選項。
modulefile 或 app，作為 update 指令的內容類型。

useAutoLink

請利用 useAuto鏈結選項來自動解析 EJB 3.0之前的 EJB 模組版本，以及 2.4版之前的 Web 模組版本中的 Enterprise JavaBeans (EJB) 參照。如果啟用 useAutoLink 選項，您可以選擇性地指定 MapEJBRefToEJB 選項的 JNDI 名稱。應用程式中的每個模組都必須共用一個共同的目標，才能啟用自動鏈結支援。

批次模式用法範例

使用 Jacl：

$AdminApp install /myapp.ear {-useAutoLink}

使用 Jython：

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

useMetaDataFromBinary 選項指定執行時期所用的 meta 資料，如：部署描述子、連結、延伸，等等，是取自 EAR 檔。這個選項不需要值。預設值是 nouseMetaDataFromBinary，表示執行時期所用的 meta 資料是來自配置儲存庫。

validateinstall

validateinstall 選項用來指定應用程式的安裝驗證層次。有效選項值包括：

off - 指定不進行應用程式部署驗證。此值為預設值。
warn - 執行應用程式部署驗證，即使報告了警告或錯誤訊息，也繼續應用程式部署程序。
fail - 執行應用程式部署驗證，當報告警告或錯誤訊息時，不繼續應用程式部署程序。

validateSchema

validateSchema 選項指定對照已發佈的 Java EE 部署描述子綱目來驗證部署描述子。當選取這個應用程式部署選項時，產品會分析每個部署描述子來判斷部署描述子的 Java EE 規格版本，選取適當的綱目，然後對照 Java EE 部署描述子綱目來檢查部署描述子。驗證錯誤會產生錯誤訊息。

這個選項不需要值。預設值是 novalidateSchema。依預設，在部署期間，會忽略 validateSchema 選項，產品不會驗證部署描述子。

詳細

verbose 選項會導致在安裝期間顯示其他訊息。這個選項不需要值。

WebServicesClientBindDeployedWSDL

WebServicesClientBindDeployedWSDL 選項用來識別您正在修改的用戶端 Web 服務。範圍設定欄位包括：模組、EJB 和 Web 服務。已部署的 WSDL 檔名稱是這項作業的單一可變值。它指出用戶端所用的「Web 服務說明語言 (WSDL)」。

「模組」欄位識別應用程式內的企業或 Web 應用程式。如果模組是 Enterprise Bean，EJB 欄位就識別模組內的特定 Enterprise Bean。 Web 服務欄位識別 Enterprise Bean 或 Web 應用程式模組內的 Web 服務。此 ID 對應於 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 服務的埠。範圍設定欄位包括：模組、EJB、Web 服務和埠。這項作業的可變值包括: Sync Timeout、 BasicAuth ID、 BasicAuth Password、 SSL Config和 Overridden Endpoint URI。基本鑑別和 Secure Socket Layer (SSL) 欄位會影響傳輸層次安全，而不是「Web 服務安全」。

批次模式用法範例

使用 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 服務的埠類型（介面）。不可變的值用來識別您在修改的用戶端 Web 服務的埠類型。範圍設定欄位包括：模組、EJB、Web 服務和埠類型。此作業的可變值為 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 服務埠的兩個屬性。不可變的值用來識別您在修改之 Web 服務的埠。範圍欄位包括：模組、Web 服務和埠。可改變的值包括: WSDL Service Name和 Scope。

範圍決定了實作 Java Bean 的生命週期。有效值包括：Request（每個要求的新實例）、Application（每個 web-app 一個實例），以及 Session（每個 HTTP 階段作業的新實例）。

scope 屬性不適用於 Java 訊息服務 (JMS) 所傳輸的 Web 服務。 scope 屬性不適用於 Enterprise 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 服務用戶端連結檔之說明的名稱值參數。不可變的值用來識別您在修改之 Web 服務的埠。範圍欄位包括：模組、Web 服務和埠。可變的值包括：name 和 value。

name 和 value 值的格式都包含一個代表多個名稱/值配對的字串，並以 + 字元為分隔字元。例如，name 字串 = "n1+n2+n3"；value 字串 = "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 服務伺服器連結檔之說明的名稱值參數。範圍設定欄位包括：模組、EJB 和 Web 服務。這項作業可變的值包括：name 和 value。

這些值的格式都包含一個代表多個名稱/值配對的字串，以加號 (+) 字元為分隔字元。例如，name 字串 = "n1+n2+n3"；value 字串 = "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']]])