Opções para os comandos AdminApp object install, installInteractive, edit, editInteractive, update e updateInteractive usando o script wsadmin

Este tópico lista as opções disponíveis para os comandos install, installInteractive, edit, editInteractive, update e updateInteractive do objeto AdminApp.

É possível usar os comandos para o objeto AdminApp para instalar, editar, atualizar e gerenciar as configurações do aplicativo. Este tópico fornece opções adicionais a serem utilizadas com os comandos install, installInteractive, edit, editInteractive, update e updateInteractive para administrar seus aplicativos. As opções listadas neste tópico se aplicam a todos esses comandos, exceto quando comunicado.

É possível configurar ou atualizar um valor de configuração usando opções em modo em lote. Para identificar qual objeto de configuração deve ser configurado ou atualizado, os valores de campos apenas leitura são usados para localizar o objeto de configuração correspondente. Todos os valores de campos apenas leitura devem corresponder a um objeto de configuração existente, caso contrário, o comando falhará.

É possível usar a correspondência de padrões para simplificar a tarefa de fornecimento dos valores requeridos para determinadas opções complexas. A correspondência de padrões é aplicada apenas a campos obrigatórios ou de leitura.

Atenção: Se um aplicativo estiver em execução, a alteração de uma configuração do aplicativo fará com que ele seja reiniciado. Em servidores independentes, o aplicativo será reiniciado depois de salvar a alteração. Em produtos de vários servidores, o aplicativo reinicia após você salvar a alteração e os arquivos sincronizarem no nó onde o aplicativo está instalado. Para controlar quando a sincronização ocorrerá em produtos com vários servidores, cancele a seleção de Sincronizar Alterações com Nós na página de Preferências do Console.
As opções a seguir estão disponíveis para os comandos install, installInteractive, edit, editInteractive, update e updateInteractive:

ActSpecJNDI

A opção ActSpecJNDI liga as especificações de ativação Java™ 2 Connector (J2C) aos nomes da Java Naming and Directory Interface (JNDI). É possível, opcionalmente, ligar as especificações de ativação do J2C em seu aplicativo ou módulo para um destino de nome de JNDI. É possível atribuir um valor a cada um dos elementos da opção ActSpecJNDI: campos RARModule, uri, j2cid e j2c.jndiName. O conteúdo da opção depois de executar as ligações padrão incluirá:
  • RARModule: <rar module name>
  • uri: <rar name>,META-INF/ra.xml
  • Identificador do objeto: <messageListenerType>
  • Nome de JNDI: null
Para utilizar essa opção, você deve especificar a propriedade Destination no arquivo ra.xml e configurar o tipo introspectivo da propriedade Destination como javax.jms.Destination

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Exemplo de uso do modo em lote

Utilizando 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}}} 
Utilizando Jacl com correspondência de padrões:
$AdminApp install $embeddedEar {-ActSpecJNDI
 {{.* .*.rar,.* javax.jms.MessageListener jndi5}
 {.*  .*.rar,.*  javax.jms.MessageListener2 jndi6}}} 
Utilizando 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']]]) 
Utilizando Jython com correspondência de padrões:
AdminApp.install(embeddedEar, ['-ActSpecJNDI',
 [['.*', '.*.rar,.*', 'javax.jms.MessageListener', 'jndi5'],
 ['.*', '.*.rar,.*', 'javax.jms.MessageListener2', 'jndi6']]]) 

allowDispatchRemoteInclude

A opção allowDispatchRemoteInclude permite que um aplicativo corporativo despache inclusões para os recursos entre os módulos da Web que estão em Java virtual machines diferentes em um ambiente de nó gerenciado por meio do mecanismo despachante de solicitação padrão.

Exemplo de uso do modo em lote

Utilizando 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
Utilizando Jython:
deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute (deployments, 'deployedObject')
rrdAttr = ['allowDispatchRemoteInclude', 'true']
attrs = [rrdLocalAttr]
AdminConfig.modify (deploymentObject, attrs)

allowPermInFilterPolicy

A opção allowPermInFilterPolicy especifica que o servidor de aplicativos deve continuar com o processo de implementação do aplicativo mesmo quando o aplicativo contiver permissões que estejam no critério de filtro. Essa opção não requer um valor.

allowServiceRemoteInclude

A opção allowServiceRemoteInclude permite que um aplicativo corporativo atenda um pedido de inclusão para um aplicativo corporativo com a opção allowDispatchRemoteInclude configurada como true.

Exemplo de uso do modo em lote

Utilizando 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
Utilizando Jython:
deployments = AdminConfig.getid ('/Deployment:RRDEnabledAppname/')
deploymentObject = AdminConfig.showAttribute ('deployments', 'deployedObject')
rrdAttr = ['allowServiceRemoteInclude', 'true']
attrs = [rrdAttr] 
AdminConfig.modify (deploymentObject, attrs) 

appname

A opção appname especifica o nome do aplicativo. O valor padrão é o nome de exibição do aplicativo.

BackendIdSelection

A opção BackendIdSelection especifica o ID de backend para os módulos JAR (Java Archive) do enterprise bean que possuem beans CMP (Container-Managed Persistence). Um módulo JAR do enterprise bean pode suportar várias configurações de backend, conforme especificado, utilizando uma ferramenta de montagem de aplicativo. Utilize essa opção para alterar o ID de backend durante a instalação.

Exemplo de uso do modo em lote

Utilizando Jacl:
$AdminApp install myapp.ear {-BackendIdSelection 
 {{Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml  DB2UDBNT_V72_1}}} 
Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.ear {-BackendIdSelection 
 {{.* Annuity20EJB.jar,.* DB2UDBNT_V72_1}}} 
Utilizando Jython:
AdminApp.install('myapp.ear', '[-BackendIdSelection 
 [[Annuity20EJB Annuity20EJB.jar,META-INF/ejb-jar.xml  DB2UDBNT_V72_1]]]')
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-BackendIdSelection',
 [['.*', 'Annuity20EJB.jar,.*', 'DB2UDBNT_V72_1']]])

BindJndiForEJBBusiness

A opção BindJndiForEJBBusiness liga os módulos EJB com as interfaces de negócio aos nomes de JNDI. Verifique se cada módulo EJB com as interfaces de negócio está ligado a um nome de JNDI.

O conteúdo atual da opção após a execução das ligações padrão inclui:
  • Módulo: Ejb1
  • Bean: MessageBean
  • URI: sample.jar,META-INF/ejb-jar.xml
  • Interface de negócio: com.ibm.sample.business.bnd.LocalTargetOne
  • Nome de JNDI: []: ejblocal:ejb/LocalTargetOne

Se você especificar o nome de JNDI de recurso de destino utilizando a opção BindJndiForEJBBusiness, não especifique um nome de JNDI de interface de negócio na opção BindJndiForEJBBusiness. Se você não especificar o nome de JNDI do recurso de destino, especifique um nome de JNDI da interface de negócio. Se você não especificar um nome da JNDI da interface de negócios, o tempo de execução fornecerá um padrão de contêiner.

Para obter uma visualização de não-interface, o valor da interface de negócios é uma cadeia vazia ("").

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Exemplo de uso do modo em lote

Utilizando Jacl:
$AdminApp install $ear {-BindJndiForEJBBusiness {{ ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 }}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install $ear {-BindJndiForEJBBusiness {{ .* .* .*.jar,.* test.ejb1 jndi1 }}}
Utilizando Jython:
AdminApp.install(ear, '[-BindJndiForEJBBusiness [[ejb_1.jar ejb1 
  ejb_1.jar,META-INF/ejb-jar.xml test.ejb1 jndi1 ]]]')
Utilizando Jython com correspondência de padrões:
AdminApp.install(ear, '[-BindJndiForEJBBusiness [[.* .* .*.jar,.* test.ejb1 jndi1]]]')

BindJndiForEJBMessageBinding

A opção BindJndiForEJBMessageBinding liga os enterprise beans acionados por mensagens para atender aos nomes de porta ou para os nomes Java Naming and Directory Interface (JNDI) da especificação de ativação. Utilize essa opção para fornecer dados que estejam faltando ou atualize uma tarefa. Quando um enterprise bean ativado por mensagem é ligado a um nome JNDI da especificação de ativação, você também pode especificar o nome JNDI de destino e alias de autenticação.

Cada elemento da opção BindJndiForEJBMessageBinding consiste dos seguintes campos: EJBModule, EJB, uri, listenerPort, JNDI, jndi.dest e actspec.auth. Alguns desses campos podem ser valores designados: listenerPort, JNDI, jndi.dest e actspec.auth.

O conteúdo atual da opção após a execução das ligações padrão inclui:
  • Módulo: Ejb1
  • Bean: MessageBean
  • URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • Porta listener: [null]:
  • Nome de JNDI: [eis/MessageBean]:
  • Nome de JNDI de Destino: [jms/TopicName]:
  • Alias de Autenticação ActivationSpec: [null]:

Se uma propriedade de configuração de ativação destinationLookup não for fornecida como uma anotação ou no descritor de implementação, e um nome JNDI de destino não estiver no arquivo de ligação IBM, o Nome JNDI de destino padrão será coletado da referência de mensagem correspondente.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Exemplo de uso do modo em lote

Utilizando Jacl:
$AdminApp install $ear {-BindJndiForEJBMessageBinding {{Ejb1 MessageBean 
 ejb-jar-ic.jar,META-INF/ejb-jar.xml myListenerPort jndi1 jndiDest1 actSpecAuth1}}} 
Utilizando Jacl com correspondência de padrões:
$AdminApp install $ear {-BindJndiForEJBMessageBinding {{.*  .*
  .*.jar,.* myListenerPort jndi1 jndiDest1 actSpecAuth1}}}
Utilizando Jython:
AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['Ejb1', 'MessageBean', 'ejb-jar-ic.jar,META-INF/ejb-jar.xml', 'myListenerPort',
 'jndi1', 'jndiDest1', 'actSpecAuth1']]]) 
Utilizando Jython com correspondência de padrões:
AdminApp.install( ear, ['-BindJndiForEJBMessageBinding',
 [['.*', '.*', '.*.jar,.*', 'myListenerPort', 'jndi1', 'jndiDest1', 'actSpecAuth1']]])

BindJndiForEJBNonMessageBinding

A opção BindJndiForEJBNonMessageBinding liga os enterprise beans aos nomes do Java Naming and Directory Interface (JNDI). Certifique-se de que cada bean corporativo não orientado a mensagens em seu aplicativo ou módulo esteja ligado a um nome de JNDI. Utilize essa opção para fornecer dados que estejam faltando ou atualize uma tarefa.

O conteúdo atual da opção após a execução das ligações padrão inclui:
  • Módulo: Ejb1
  • Bean: MessageBean
  • URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • Nome JNDI do Recurso de Destino: [com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC]
  • Nome JNDI Inicial Local: [null]
  • Nome JNDI Inicial Remoto: [null]

Restrições especiais existem para os módulos do Enterprise JavaBeans (EJB) 3.0 e superior. Se você especificar o nome de JNDI do recurso de destino, não especifique os nomes de JNDI de início local ou remoto. Você também não pode especificar o campo de JNDI para interfaces de negócio na opção BindJndiForEJBBusiness. Se você não especificar o nome de JNDI do recruso de destino, os campos de nome de JNDI de início local e remoto serão opcionais. Se você especificar nomes JNDI locais e remotos, o tempo de execução fornece um contêiner padrão.

Se você não utilizar os módulos EJB 3.0, deverá especificar o nome de JNDI do recurso de destino.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Exemplo de uso do modo em lote

Utilizando Jacl:

[Windows]
$AdminApp install c:/myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install /myapp.ear {-BindJndiForEJBNonMessageBinding {{Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC ""  ""}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install app_server_rootapps/myapps/installableApps/JobbankTargetEJBApp.ear
 {-BindJndiForEJBNonMessageBinding {{.* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" }}}

Utilizando Jython:

[Windows]
AdminApp.install('C:/myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', '[-BindJndiForEJBNonMessageBinding [[Ejb1 MessageBean 
  ejb-jar-ic.jar,META-INF/ejb-jar.xml com.acme.ejbws.AnnuityMgmtSvcEJB2xJAXRPC "" ""]]]')
Utilizando Jython com correspondência de padrões:
AdminApp.install('app_server_root/apps/myapps/installableApps/JobbankTargetEJBApp.ear',
 '[ -BindJndiForEJBNonMessageBinding [[ .* .* ResumeBankAppEJB.jar,META-INF/ejb-jar.xml
 ejb/com/app/ResumeBank/ResumeBank "" "" ]] ]' )

blaname

Utilize a opção blaname para especificar o nome do aplicativo no nível de negócio sob o qual o sistema cria o aplicativo Java EE. Essa opção é opcional. Se você não especificar um valor, o sistema definirá o nome como nome de aplicativo Java EE. Essa opção só fica disponível com o comando install.

buildVersion

A opção buildVersion exibe a versão do build de um arquivo EAR do aplicativo. Não é possível modificar essa opção porque ela é de leitura. Essa opção retorna as informações de versão do build para um aplicativo EAR se você tiver especificado a versão de build no arquivo de aplicativo EAR MANIFEST.MF .

Célula

A opção cell especifica o nome da célula para instalar ou atualizar um aplicativo inteiro ou para atualizar a fim de incluir um novo módulo. Se desejar atualizar um aplicativo inteiro, essa opção ser aplicará somente se o aplicativo contiver um novo módulo que não exista no aplicativo instalado.

Uso de exemplo do modo em lote

Utilizando Jacl:

[Windows]
$AdminApp install "C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install "/apps/myapps/installableApps/JobbankTargetEJBApp.ear" {-cell cellName}

Utilizando Jython:

[Windows]
AdminApp.install('C:/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/apps/myapps/installableApps/JobbankTargetEJBApp.ear', '[-cell cellName]')

clientMode

A opção clientMode especifica se você deve implementar módulos de cliente em um destino de implementação isolado (isolated), um nó federado de um gerenciador de implementação (federated) ou um servidor de aplicativos (server_deployed). Se especificar esta opção, instale os módulos do cliente apenas em um destino de implementação da Versão 8.0 ou posterior.

O valor padrão é isolated.

A opção do modo de implementação do cliente afeta a forma como as consultas java: são tratadas. Todos os namespaces de URL Java (global, aplicativo, módulo e componente) são locais em processos de cliente isolados. Os namespaces residem em um servidor nos processos do cliente federados e nos implementados pelo servidor. O servidor ou cluster escolhido como destino para um módulo de cliente determina onde esses namespaces são criados. Todas as consultas java: para módulos federados ou de servidor implementado do cliente serão direcionados para o servidor ou cluster de destino. O módulo do cliente não é realmente executado no servidor ou cluster de destino. Diversas instâncias do mesmo módulo do cliente compartilharão o namespace do componente nos modos federados e nos implementados pelo servidor. A escolha do modo federado é simplesmente uma declaração da intenção de ativar o módulo do cliente usando o Java Network Launching Protocol (JNLP), mas os mecanismos Java Naming and Directory Interface (JNDI) dos modos federado e implementado pelo servidor são iguais.

cluster

A opção cluster especifica o nome de cluster para instalar ou atualizar um aplicativo inteiro ou para atualizar um aplicativo a fim de incluir um novo módulo. Essa opção aplica-se apenas a um ambiente do WebSphere Application Server, Network Deployment. Se quiser atualizar um aplicativo inteiro, essa opção aplica-se somente se o aplicativo contiver um novo módulo que não exista no aplicativo instalado. Não é possível usar as opções -cluster e -server em conjunto.

Se desejar implementar um aplicativo e especificar o servidor HTTP durante a implementação de forma que o aplicativo aparecerá no arquivo plugin-cfg.xml gerado, você deverá primeiro instalar o aplicativo com um destino igual a -cluster. Depois de instalar o aplicativo e antes de salvar, use o comando edit do objeto AdminApp para incluir o mapeamento adicional ao servidor da Web.

Uso de exemplo do modo em lote

Utilizando Jacl:

[Windows]
$AdminApp install "C:/myapp.ear" {-cluster clusterName}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install "myapp.ear" {-cluster clusterName}

Utilizando Jython:

[Windows]
AdminApp.install('C:/myapp/myapp.ear', '[-cluster clusterName]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/myapp/myapp.ear', '[-cluster clusterName]')

contents

A opção contents especifica o arquivo que contém o conteúdo que você deseja atualizar. Por exemplo, dependendo do tipo de conteúdo, o arquivo pode ser um arquivo EAR, um módulo, um zip parcial ou um único arquivo. O caminho para o arquivo deve ser local para o cliente de script. A opção contents é requerida, a menos que você tenha especificado a opção delete.

contenturi

A opção contenturi especifica o URI do arquivo que você está incluindo, atualizando ou removendo de um aplicativo. Essa opção se aplica apenas ao comando update. A opção contenturi é requerida se o tipo de conteúdo for file ou modulefile. Esta opção é ignorada para outros tipos de conteúdo.

contextroot

A opção contextroot especifica a raiz de contexto que é usada quando instalar um arquivo Web Application Archive (WAR) independente.

CorrectOracleIsolationLevel

A opção CorrectOracleIsolationLevel especifica o nível de isolamento do provedor do tipo Oracle. Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa. O último campo de cada entrada especifica o nível de isolamento. Os valores válidos do nível de isolamento são 2 ou 4.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. Só é necessário fornecer os dados para as linhas ou entradas que sejam informação ausente ou que requeiram uma atualização.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
 {{AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.ear {-CorrectOracleIsolationLevel
  {{.*  jms/MyQueueConnectionFactory jms/Resource1 2}}
Utilizando Jython:
AdminApp.install('myapp.ear', '[-CorrectOracleIsolationLevel
 [[AsyncSender jms/MyQueueConnectionFactory jms/Resource1 2]]]')
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-CorrectOracleIsolationLevel',
 [['.*', 'jms/MyQueueConnectionFactory', 'jms/Resource1', 2]]])

CorrectUseSystemIdentity

A opção CorrectUseSystemIdentity substitui RunAs System para RunAs Roles. Os enterprise beans que você instala contém uma identidade de sistema RunAs. É possível, opcionalmente, alterar essa identidade para uma função Executar Como. Utilize essa opção para fornecer dados que estejam faltando ou atualize uma tarefa.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Uso de exemplo do modo em lote

Utilizando 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}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.ear {-CorrectUseSystemIdentity
 {{.*  .*  .*  getValue() RunAsUser2 user2 password2}
 {.*  .*  .*  Increment() RunAsUser2 user2 password2}}}
Utilizando 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]]]')
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-CorrectUseSystemIdentity',
 [['.*', '.*', '.*', 'getValue()', 'RunAsUser2', 'user2', 'password2'],
 ['.*', '.*', '.*', 'Increment()', 'RunAsUser2', 'user2', 'password2']]])

createMBeansForResources

A opção createMBeansForResources especifica que os MBeans são criados para todos os recursos, como servlets, arquivos JSP (JavaServer Pages) e enterprise beans, que são definidos em um aplicativo quando o aplicativo inicia em um destino de implementação. Essa opção não requer um valor. A definição padrão é a opção nocreateMBeansForResources.

CtxRootForWebMod

A opção CtxRootForWebMod edita a raiz de contexto do módulo da Web. É possível editar uma raiz de contexto definida no arquivo application.xml utilizando essa opção. O conteúdo atual dessa opção depois de executar ligações padrão é o seguinte:
  • Módulo da Web: xxx
  • URI: xxx
  • ContextRoot: <context root>
Se um módulo da Web for um Servlet 2.5, o conteúdo dessa opção será preenchido apenas a partir do descritor de implementação XML. Não é possível obter informações sobre a implementação com base nas anotações com essa opção.

Uso de exemplo do modo em lote

Utilizando Jacl:

$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname ivtApp -CtxRootForWebMod
 {{"IVT Application" ivt_app.war,WEB-INF/web.xml /mycontextroot}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.ear {-appname MyApp -CtxRootForWebMod {{.* .* /mycontextroot}}}

Utilizando Jython:

AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'ivtApp ', '-CtxRootForWebMod',
 [["IVT Application", 'ivt_app.war,WEB-INF/web.xml', '/mycontextroot']]])
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-CtxRootForWebMod',
 [['.*', '.*', '/mycontextroot']]])

custom

A opção custom especifica um par de nome-valor utilizando o formato name=value. Utilize a opção custom para transmitir opções para as extensões de implementação do aplicativo. Consulte a documentação de extensão de implementação de aplicativo para obter as opções personalizadas disponíveis.

CustomActivationPlan

A opção CustomActivationPlan especifica os componentes de tempo de execução a serem incluídos ou removidos dos componentes de tempo de execução padrão que são utilizados para executar o aplicativo. Somente utilize essa opção quando o servidor de aplicativos não puder obter todos os componentes de tempo de execução necessários inspecionando o aplicativo.

Uso de exemplo do modo em lote

Utilizando Jython:
AdminApp.install('Increment.jar','[-CustomActivationPlan [["Increment Enterprise Java Bean"
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')
Utilizando Jython com correspondência de padrões:
AdminApp.install('Increment.jar','[-CustomActivationPlan [[.*
 Increment.jar,META-INF/ejb-jar.xml WebSphere:specname=WS_ComponentToAdd ""]]')
Tabela 1. Componentes de CustomActivationPlan a serem incluídos. Especifique um valor de WS_ComponentToAdd no comando.
Componente Valor de WS_ComponentToAdd
Contêiner de EJB WS_EJBContainer
Contêiner do Portlet WS_PortletContainer
JavaServer Faces (JSF) WS_JSF
Contêiner do SIP WS_SipContainer
Serviço de escopo de compensação WS_Compensation
Perfil do aplicativo WS_AppProfile
Sessão de Atividade WS_ActivitySession
Internacionalização WS_I18N
Beans de inicialização WS_StartupService

DataSourceFor10CMPBeans

A opção DataSourceFor10CMPBeans especifica origens de dados opcionais para beans CMP (Container-Managed Persistence) 1.x individuais. Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa.

O mapeamento de uma origem de dados específica para um bean CMP substituirá a origem de dados padrão para o módulo que contém o bean corporativo. Cada elemento da opção DataSourceFor10CMPBeans consiste nos seguintes campos: EJBModule, EJB, uri, JNDI, userName, password, login.config.name e auth.props. Desses campos, os seguintes podem ser valores designados: JNDI, userName, password, login.config.name e auth.props.

O conteúdo atual da opção após a execução das ligações padrão inclui:
  • Módule: Increment CMP 1.1 EJB
  • Bean: IncCMP11
  • URI: IncCMP11.jar,META-INF/ejb-jar.xml
  • Nome JNDI do Recurso de Destino: [DefaultDatasource]:
  • Nome do Usuário: [null]:
  • Senha: [null]:
  • Nome da configuração de login: [null]: Use esta opção para criar uma configuração de login customizada. O cliente pode utilizar JAAS para criar um design de login.
  • Propriedades: [null]: Utilize essa opção para criar uma configuração de login customizada. O cliente pode utilizar JAAS para criar um design de login.

Se o login.config.name for definido para DefaultPrincipalMapping, uma propriedade é criada com o nome com.ibm.mapping.authDataAlias. O valor da propriedade é definido por auth.props. Se o nome de login.config não estiver definido para DefaultPrincipalMapping, auth.props pode especificar várias propriedades. O formato da cadeia é websphere:name= <nome1>,value=<valor1>,description=<desc1>. Especifique várias propriedades utilizando o sinal de mais (+).

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas que sejam informações ausentes ou que requeiram atualização.

Uso de exemplo do modo em lote

Utilizando Jacl:

[Windows]
$AdminApp install C:/app1.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB"
 IncCMP11 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}} 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{"Increment CMP 1.1 EJB" IncCMP11
 IncCMP11.jar,META-INF/ejb-jar.xml myJNDI user1 password1 loginName1 authProps1}}} 

Utilizando Jacl com correspondência de padrões:

[Windows]
$AdminApp install C:/myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  
 IncCMP11.jar,.* myJNDI user1 password1 loginName1 authProps1}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-DataSourceFor10CMPBeans {{.*  .*  IncCMP11.jar,.*
 myJNDI user1 password1 loginName1 authProps1}}}

Utilizando Jython:

[Windows]
AdminApp.install('C:/app1.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1', 'password1',
 'loginName1', 'authProps1']]]) 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [["Increment CMP 1.1 EJB",
 'IncCMP11', 'IncCMP11.jar,META-INF/ejb-jar.xml', 'myJNDI', 'user1',
 'password1', 'loginName1', 'authProps1']]]) 

Utilizando Jython com correspondência de padrões:

[Windows]
AdminApp.install('C:/myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*', 
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-DataSourceFor10CMPBeans', [['.*', '.*',
 'IncCMP11.jar,.*', 'myJNDI', 'user1', 'password1', 'loginName1', 'authProps1']]])

DataSourceFor20CMPBeans

A opção DataSourceFor20CMPBeans especifica origens de dados opcionais para beans CMP (Container-Managed Persistence) 2.x individuais. Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa.

O mapeamento de uma origem de dados específica para um bean CMP substituirá a origem de dados padrão para o módulo que contém o bean corporativo. Cada elemento da opção DataSourceFor20CMPBeans consiste nos seguintes campos: EJBModule, EJB, uri, JNDI, resAuth, login.config.name e auth.props. Desses campos, os seguintes podem ser valores designados: JNDI, resAuth, login.config.name e auth.props.

O conteúdo atual da opção depois de executar ligações padrão inclui o seguinte:
  • Módulo: Increment enterprise bean
  • Bean: Increment
  • URI: Increment.jar,META-INF/ejb-jar.xml
  • Nome JNDI do Recurso de Destino: [null]:
  • Autorização de Recurso: [Por aplicativo]:
  • Nome da configuração de login: [null]: Use esta opção para criar uma configuração de login customizada. O cliente pode utilizar JAAS para criar um design de login.
  • Propriedades: []: Utilize essa opção para criar uma configuração de login customizada. O cliente pode utilizar JAAS para criar um design de login.

Se o login.config.name for definido para DefaultPrincipalMapping, uma propriedade é criada com o nome com.ibm.mapping.authDataAlias. O valor da propriedade é definido por auth.props. Se o nome de login.config não estiver definido para DefaultPrincipalMapping, auth.props pode especificar várias propriedades. O formato da cadeia é websphere:name= <nome1>,value=<valor1>,description=<desc1>. Especifique várias propriedades utilizando o sinal de mais (+).

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. Só é necessário fornecer dados para linhas ou entradas que sejam informações ausentes ou que requeiram uma atualização.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install Increment.jar {-DataSourceFor20CMPBeans
 {{"Increment Enterprise Java Bean" Increment
 Increment.jar,META-INF/ejb-jar.xml jndi1 container "" ""}}} 
Utilizando Jacl com correspondência de padrões:
$AdminApp install Increment.jar {-DataSourceFor20CMPBeans {{.*  .*
 Increment.jar,.*  jndi1 container "" ""}}}
Utilizando Jython:
AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans',
 [["Increment Enterprise Java Bean", 'Increment',
 'Increment.jar,META-INF/ejb-jar.xml', 'jndi1', 'container', '', '']]])
Utilizando Jython com correspondência de padrões:
AdminApp.install('Increment.jar', ['-DataSourceFor20CMPBeans', [['.*', '.*',
 'Increment', 'Increment.jar,.*', 'jndi1', 'container', '', '']]])

DataSourceFor10EJBModules

A opção DataSourceFor10EJBModules especifica a origem de dados padrão para o módulo de enterprise beans que contêm beans CMP (Container-Managed Persistence) 1.x. Utilize essa opção para fornecer dados que estejam faltando ou atualize uma tarefa.

Cada elemento da opção DataSourceFor10EJBModules consiste nos seguintes campos: EJBModule, uri, JNDI, userName, password, login.config.name e auth.props. Desses campos, os seguintes podem ser valores designados: JNDI, userName, password, login.config.name e auth.props.

O conteúdo atual da opção após a execução das ligações padrão inclui:
  • Módulo: Increment CMP 1.1 enterprise bean
  • uri: IncCMP11.jar,META-INF/ejb-jar.xml
  • Nome JNDI do Recurso de Destino: [DefaultDatasource]:
  • Nome do Usuário: [null]:
  • Senha: [null]:
  • Nome da configuração de login: [null]: Use esta opção para criar uma configuração de login customizada. O cliente pode utilizar JAAS para criar um design de login.
  • Propriedades: [null]: Utilize essa opção para criar uma configuração de login customizada. O cliente pode utilizar JAAS para criar um design de login.

Se o login.config.name for definido para DefaultPrincipalMapping, uma propriedade é criada com o nome com.ibm.mapping.authDataAlias. O valor da propriedade é definido por auth.props. Se o nome de login.config não estiver definido para DefaultPrincipalMapping, auth.props pode especificar várias propriedades. O formato da cadeia é websphere:name= <nome1>,value=<valor1>,description=<desc1>. Especifique várias propriedades utilizando o sinal de mais (+).

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install myapp.ear {-DataSourceFor10EJBModules {{"Increment CMP 1.1 EJB"
 IncCMP11.jar,META-INF/ejb-jar.xml yourJNDI user2 password2 loginName authProps}}} 
Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.ear {-DataSourceFor10EJBModules
 {{.* IncCMP11.jar,.* yourJNDI user2 password2 loginName authProps}}}
Utilizando Jython:
AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules', [["Increment CMP 1.1 EJB",
 'IncCMP11.jar,META-INF/ejb-jar.xml', 'yourJNDI', 'user2', 'password2', 
 'loginName', 'authProps']]]) 
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-DataSourceFor10EJBModules',
 [['.*', 'IncCMP11.jar,.*', 'yourJNDI', 'user2', 'password2', 'loginName', 'authProps']]])

DataSourceFor20EJBModules

A opção DataSourceFor20EJBModules especifica a origem de dados padrão para o módulo de enterprise beans 2.x que contêm beans CMP (Container Managed Persistence) 2.x. Utilize essa opção para fornecer dados que estejam faltando ou atualize uma tarefa.

Cada elemento da opção DataSourceFor20EJBModules consiste nos seguintes campos: EJBModule, uri, JNDI, resAuth, login.config.name e auth.props. Desses campos, os seguintes podem ser valores atribuídos: JNDI, resAuth, login.config.name, auth.props e propriedades de origem de dados estendidos.

O conteúdo atual da opção após a execução das ligações padrão inclui:
  • Módulo: Increment enterprise bean
  • URI: Increment.jar,META-INF/ejb-jar.xml
  • Nome JNDI do Recurso de Destino: [DefaultDatasource]:
  • Autorização de Recurso: [Por aplicativo]:
  • Nome da configuração de login: [null]: Use esta opção para criar uma configuração de login customizada. O cliente pode utilizar JAAS para criar um design de login.
  • Propriedades: []: Utilize essa opção para criar uma configuração de login customizada. O cliente pode utilizar JAAS para criar um design de login.
  • Propriedades de Origem de dados estendida: []: Use essa opção para que a origem de dados que usa o conjunto heterogêneo possa se conectar com um banco de dados DB2. O padrão para a propriedade é property1=value1+property2=value2.

O último campo de cada entrada dessa tarefa especifica o valor para autorização de recurso. Os valores válidos para autorização de recurso são per connection factory ou container.

Se o login.config.name for definido para DefaultPrincipalMapping, uma propriedade é criada com o nome com.ibm.mapping.authDataAlias. O valor da propriedade é definido por auth.props. Se o nome de login.config não estiver definido para DefaultPrincipalMapping, auth.props pode especificar várias propriedades. O formato da cadeia é websphere:name= <nome1>,value=<valor1>,description=<desc1>. Especifique várias propriedades utilizando o sinal de mais (+).

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install Increment.jar {-DataSourceFor20EJBModules
 {{"Increment Enterprise Java Bean" Increment.jar,META-INF/ejb-jar.xml
 jndi2 container "" "" ""}}} 
Utilizando Jacl com correspondência de padrões:
$AdminApp install Increment.jar {-DataSourceFor20EJBModules {{.*
 Increment.jar,.* jndi2 container "" "" ""}}}
Nota: Se usar valores múltiplos para propriedades estendidas de origem de dados, será necessário designar os valores para uma variável e usá-la para o valor da propriedade. Exemplo:
set s \"value1,value2\"
Na substituição de comandos, referencie a variável, conforme mostrado no exemplo a seguir:
"clientApplicationInformation=value1,value2" com "clientapplication=$s"
Utilizando Jython:
AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [["Increment Enterprise Java Bean", 'Increment.jar,META-INF/ejb-jar.xml',
 'jndi2', 'container', '', '', '']]])
Utilizando Jython com correspondência de padrões:
AdminApp.install('Increment.jar', ['-DataSourceFor20EJBModules',
 [['.*', 'Increment.jar,.*', 'jndi2', 'container', '', '', '']]])
Nota: Se você usar diversos valores para propriedades de origem de dados estendidos, deverá fechar os dois valores entre os caracteres aspas duplas. Exemplo:
'property1="value1,value2"+property2="value3,value4"'

defaultbinding.cf.jndi

A opção defaultbinding.cf.jndi especifica o nome Java Naming and Directory Interface (JNDI) para o connection factory padrão.

defaultbinding.cf.resauth

A opção defaultbinding.cf.resauth especifica a RESAUTH para o connection factory.

defaultbinding.datasource.jndi

A opção defaultbinding.datasource.jndi especifica o nome de JNDI (Java Naming and Directory Interface) para a origem de dados padrão.

defaultbinding.datasource.password

A opção defaultbinding.datasource.password especifica a senha para a origem de dados padrão.

defaultbinding.datasource.username

A opção defaultbinding.datasource.username especifica o nome do usuário para a origem de dados padrão.

defaultbinding.ee.defaults

Novo Recurso Novo Recurso:
newfeat
A opção defaultbinding.ee.defaults especifica o uso da opção de recursos padrão pré-configurados para Java EE.

defaultbinding.ejbjndi.prefix

A opção defaultbinding.ejbjndi.prefix especifica o prefixo para o nome Java Naming and Directory Interface (JNDI) do enterprise bean.

[z/OS] Para usar a opção defaultbinding.ejbjndi.prefix na plataforma z/OS, deverá também especificara opção usedefaultbindings. Se você não especificar o uso da opção usedefaultbindings, o padrão será a opção nousedefaultbindings.

defaultbinding.force

A opção defaultbinding.force especifica que as ligações padrão substituem as ligações atuais.

defaultbinding.strategy.file

A opção defaultbinding.strategy.file especifica um arquivo de estratégia de ligações padrão customizadas.

defaultbinding.virtual.host

A opção defaultbinding.virtual.host especifica o nome padrão para um host virtual.

depl.extension.reg (obsoleto)

Recurso Reprovado Recurso Reprovado: A opção depl.extension.reg é reprovada. Não há nenhuma opção de replicação disponível.depfeat

deployejb

A opção deployejb especifica para executar a ferramenta EJBDeploy durante a instalação. Essa opção não requer um valor. O EJBDeploy é executado durante a instalação dos módulos EJB 1.x ou 2.x. A ferramenta de implementação EJB não é executada durante a instalação dos módulos EJB 3.x.

Essa opção é ignorada quando o EAR ou módulo a ser instalado ou atualizado contiver o descritor de implementação de aplicativo Java Platform, Enterprise Edition (Java EE) 7, o descritor de implementação do módulo EJB 3.2 ou o descritor de implementação do módulo da web 3.1.

Se você pré-implementar o arquivo enterprise archive (EAR) do aplicativo usando a ferramenta EJBDeploy, o valor padrão será nodeployejb. Caso contrário, o valor padrão será deployejb.

Você deve usar esta função deployejb nas seguintes situações:
  • O arquivo EAR foi montado utilizando uma ferramenta de montagem, como o Rational Application Developer, e a ferramenta EJBDeploy não foi executada durante a montagem.
  • O arquivo EAR não foi montado utilizando uma ferramenta de montagem, como o Rational Application Developer.
  • O arquivo EAR foi montado utilizando versões do AAT (Application Assembly Tool) anteriores à Versão 5.0.

Se um módulo EJB estiver compactado em um archive Web (WAR), não será necessário usar a opção deployejb.

Para essa opção, instale somente em um destino de implementação do Versão 9.0.

deployejb.classpath

A opção deployejb.classpath especifica um caminho de classe extra para a ferramenta EJBDeploy.

deployejb.complianceLevel

A opção deployejb.complianceLevel especifica o nível de conformidade com JDK para a ferramenta EJBDeploy.

Os valores possíveis incluem:
1.4 (padrão) 5.0 6.0

Para obter uma lista de níveis de conformidade JDK suportados simultaneamente, execute ejbdeploy -? .

deployejb.dbschema

A opção deployejb.dbschema especifica o esquema do banco de dados para a ferramenta EJBDeploy.

deployejb.dbtype

A opção deployejb.dbtype especifica o tipo de banco de dados para a ferramenta EJBDeploy.

Os valores possíveis incluem:
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
Os seguintes bancos de dados suportam a Linguagem de Consulta Estruturada em Java (SQLJ): DB2UDB_V82, DB2UDB_V81, DB2UDBOS390_V7 e DB2UDBOS390_V8.

Para obter uma lista de tipos de fornecedores de banco de dados suportados, execute o comando ejbdeploy -? .

deployejb.dbaccesstype

A opção deployejb.dbaccesstype especifica o tipo de acesso ao banco de dados para a ferramenta EJBDeploy. Os valores válidos são SQLj e JDBC. O padrão é JDBC.

deployejb.rmic

A opção deployejb.rmic especifica opções RMIC extras a serem utilizadas para a ferramenta EJBDeploy.

deployejb.sqljclasspath

A opção deployejb.sqljclasspath especifica o local das classes do conversor SQLJ.

deployws

A opção deployws especifica implementar os serviços da Web durante a instalação. Essa opção não requer um valor.

O valor padrão é: nodeployws.

deployws.classpath

A opção deployws.classpath especifica o caminho de classe extra a ser usado quando implementar os serviços da Web.

Para especificar os caminhos de classe de várias entradas, separe as entradas com o mesmo separador que é usado com a variável de ambiente CLASSPATH.

[Windows]Use um ponto e vírgula (;) para separar as entradas.

[AIX][HP-UX][Linux][Solaris][z/OS]Use dois pontos (:) para separar as entradas.

deployws.jardirs

A opção deployws.jardirs especifica os diretórios de extensão extra a serem usados quando implementar os serviços da Web.

distributeApp

A opção distributeApp especifica que o componente de gerenciamento de aplicativos distribui binários de aplicativos. Essa opção não requer um valor. Essa configuração é a padrão.

EmbeddedRar

A opção EmbeddedRar liga objetos do Java 2 Connector a nomes JNDI. Você deve ligar cada objeto Java 2 Connector em seu aplicativo ou módulo, tais como fábricas de conexão J2C, especificações de ativação J2C e objetos administrativos J2C a um nome JNDI. Cada elemento da opção EmbeddedRar contém os seguintes campos: RARModule, uri, j2cid, j2c.name, j2c.jndiName. É possível designar os seguintes valores para os campos: j2c.name, j2c.jndiName.

O conteúdo atual da opção após a execução das ligações padrão inclui:
Módulo conector: <rar module name> 
URI: <rar name>,META-INF/ra.xml 
Object identifier: <identifier of the J2C object> 
name: j2cid 
JNDI name: eis/j2cid
Em que j2cid é:
Connection factory J2C: connectionFactoryInterface
J2C admin object: adminObjectInterface
J2C activation specification: message listener type

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Se o ID não for exclusivo no arquivo ra.xml, -<number> será incluído. Por exemplo, javax.sql.DataSource-2.

Uso de exemplo do modo em lote

Utilizando 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}}} 
Utilizando Jacl com correspondência de padrões:
$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}}}
Utilizando 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']]]) 
Utilizando Jython com correspondência de padrões:
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

A opção enableClientModule especifica a implementação de módulos do cliente. Selecione essa opção se o arquivo a ser implementado tiver um ou mais módulos do cliente que você deseja implementar. Se selecionar esta opção, instale os módulos do cliente somente em um destino de implementação da Versão 8.0 ou posterior.

Essa opção não requer um valor. O valor padrão é noenableClientModule. Por padrão, a opção enableClientModule é ignorada durante a implementação e os módulos do cliente não são implementados.

EnsureMethodProtectionFor10EJB

A opção EnsureMethodProtectionFor10EJB seleciona proteções de métodos para métodos desprotegidos de enterprise beans 1.x. Especifique deixar o método como desprotegido ou atribua proteção que recuse qualquer acesso. Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Uso de exemplo do modo em lote

Utilizando 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}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.ear {-EnsureMethodProtectionFor10EJB
 {{.* IncrementEJBBean.jar,.* ""} {.* TimeoutEJBBean.jar,.*
 methodProtection.denyAllPermission}}}
Utilizando 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]]]')
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor10EJB',
 [['.*', 'IncrementEJBBean.jar,.*', ""], ['.*', 'TimeoutEJBBean.jar,.*', 
 'methodProtection.denyAllPermission']]])

O último campo de cada entrada dessa tarefa especifica o valor da proteção. Os valores de proteção válidos incluem: methodProtection.denyAllPermission. Você também pode deixar o valor em branco se quiser que o método permaneça desprotegido.

EnsureMethodProtectionFor20EJB

A opção EnsureMethodProtectionFor20EJB seleciona proteções de métodos para métodos desprotegidos de enterprise beans 2.x. Especifique atribuir uma função de segurança ao método desprotegido, inclua o método na lista de exclusão ou marque o método como limpo. É possível atribuir várias funções para um método, separando os nomes das funções com vírgulas. Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram uma atualização dos dados existentes.

Uso de exemplo do modo em lote

Utilizando 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}}}

Utilizando Jacl com correspondência de padrões:

$AdminApp install myapp.ear {-EnsureMethodProtectionFor20EJB
 {{.* customerEjb.jar,.* methodProtection.uncheck}
 {.* supplierEjb.jar,.* methodProtection.exclude}}}
Utilizando 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]]]')
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-EnsureMethodProtectionFor20EJB',
 [['.*', 'customerEjb.jar,.*', 'methodProtection.uncheck'],
 ['.*', 'supplierEjb.jar,.*', 'methodProtection.exclude']]])

O último campo de cada entrada dessa tarefa especifica o valor da proteção. Os valores de proteção válidos incluem: methodProtection.uncheck, methodProtection.exclude ou uma lista de funções de segurança separadas por vírgulas.

filepermission

A opção filepermission permite configurar permissões de arquivos apropriadas em arquivos de aplicativos localizados no diretório de instalação. As permissões de arquivo especificadas no nível do aplicativo devem ser um subconjunto da permissão de arquivo no nível do nó que define a permissão de arquivo mais tolerante que pode ser especificada. Caso contrário, os valores de permissão do nível do nó serão utilizadas para configurar permissões de arquivo no destino da instalação. O padrão de nome de arquivo é uma expressão comum. O valor padrão é o seguinte:
.*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755

Uso de exemplo do modo em lote

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

installdir (reprovado)

Recurso Reprovado Recurso Reprovado: A opção installdir está obsoleta. Essa opção foi substituída pela opção installed.ear.destination.depfeat

installed.ear.destination

A opção installed.ear.destination especifica o diretório no qual colocar os binários do aplicativo.

JSPCompileOptions

A opção JSPCompileOptions especifica as opções de compilação Java ServerPages (JSP) para os módulos da Web. Essa opção é válida apenas se você também usar a opção preCompileJSPs. O conteúdo atual dessa opção depois de executar ligações padrão é o seguinte:
  • Módulo da Web: xxx
  • URI: xxx
  • Caminho de Classe JSP: <caminho de classe jsp>
  • Usar Nomes de Pacote Completos: Sim | Não
  • Nível da Origem do JDK: xx
  • Desativar Compilação de Tempo de Execução JSP: Sim | Não

Para Usar Nomes de Pacote Completos e Desativar Compilação de Tempo de Execução JSP, especifique um valor Sim ou Não no idioma específico do código de idioma. O produto suporta os valores AppDeploymentOption.Yes e AppDeploymentOption.No em vez de Sim e Não, no entanto, recomenda-se especificar Sim ou Não no idioma do código de idioma.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -preCompileJSPs -JSPCompileOptions {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml jspcp Sim 15 Não}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install ivtApp.ear {-appname MyApp -preCompileJSPs -JSPCompileOptions
 {{.* .* jspcp Yes 15 No}}}
Utilizando 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']]])
Utilizando Jython com correspondência de padrões:
AdminApp.install('ivtApp.ear', ['-appname', 'MyApp', '-preCompileJSPs',
 '-JSPCompileOptions', [['.*', '.*', 'jspcp', 'Yes', 15, 'No']]])

JSPReloadForWebMod

A opção JSPReloadForWebMod edita os atributos de recarregamento JSP para o módulo da Web. Você pode especificar os atributos de recarregamento do servlet e do JSP para cada módulo. O conteúdo atual da opção depois de executar ligações padrão é o seguinte:
  • Módulo da Web: xxx
  • URI: xxx
  • JSP ativa recarregamento de classe: <Sim | Não>
  • Intervalo de recarregamento JSP em segundos: <número interno de recarregamento jsp>

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo.

Para o recarregamento de classe de ativação do JSP, especifique um valor Yes ou No no idioma específico para o código do idioma. O produto suporta os valores AppDeploymentOption.Yes e AppDeploymentOption.No em vez de Sim e Não, no entanto, recomenda-se especificar Sim ou Não no idioma do código de idioma.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{"IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -JSPReloadForWebMod {{.* .* Yes 5}}}
Utilizando Jython:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod [["IVT Application"
 ivt_app.war,WEB-INF/web.xml Yes 5 ]]'])
Utilizando Jython com correspondência de padrões:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp', '-JSPReloadForWebMod', [['.*', '.*', 'Yes', ‘5']]])
Configurações suportadas Configurações suportadas: Para arquivos de extensão e de ligação IBM®, a extensão do nome do arquivo .xmi ou .xml é diferente dependendo de você estar utilizando um aplicativo pré-Java EE 5 ou um módulo ou um aplicativo ou módulo Java EE 5 ou posterior. Um arquivo de extensão ou de ligação IBM é denominado ibm-*-ext.xmi ou ibm-*-bnd.xmi em que * é o tipo de arquivo de extensão ou de ligação como app, aplicativo, ejb-jar ou web. As seguintes condições se aplicam:
  • Para um aplicativo ou módulo que usa um Java EE versão anterior à versão 5, a extensão do arquivo deverá ser .xmi.
  • Para um aplicativo ou módulo que usa Java EE 5 ou posterior, a extensão do arquivo deve ser .xml. Se os arquivos .xmi forem incluídos no aplicativo ou módulo, o produto ignorará os arquivos .xmi.

No entanto, um módulo Java EE 5 ou posterior pode existir dentro de um aplicativo que inclui arquivos pré-Java EE 5 e usa a extensão do nome do arquivo .xmi.

Os arquivos ibm-webservices-ext.xmi, ibm-webservices-bnd.xmi, ibm-webservicesclient-bnd.xmi, ibm-webservicesclient-ext.xmi, e ibm-portlet-ext.xmi continuam a usar as extensões de arquivo .xmi.

sptcfg

MapEJBRefToEJB

A opção MapEJBRefToEJB mapeia referências corporativas Java para enterprise beans. Você deve mapear cada referência de bean corporativo definida em seu aplicativo para um bean corporativo. Utilize esta opção para fornecer dados que estejam faltando ou uma atualização de uma tarefa.

Se a referência EJB for de um módulo EJB 3.x, Web 2.4 ou Web 2.5, o nome de JNDI será opcional. Se você especificar a opção useAutoLink, o nome de JNDI será opcional. O tempo de execução fornece um contêiner padrão. Um módulo EJB 3.0 ou superior não pode conter beans de entidade de persistência gerenciados por contêiner ou gerenciados por bean. A instalação falha quando um bean de entidade do gerenciado por contêiner ou gerenciado por bean for compactado em um módulo EJB 3.x do aplicativo Java EE. É possível empacotar apenas beans de persistência gerenciados por contêiner ou gerenciados por bean em um módulo EJB 2.1 ou anterior.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. Você precisa fornecer os dados apenas para linhas ou entradas com informações faltando, ou aqueles onde você deseja atualizar os dados existentes.

Uso de exemplo do modo em lote

Utilizando 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}}}

Utilizando Jacl com correspondência de padrões:

[Windows]
$AdminApp install C:/myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MapEJBRefToEJB {{.* .* .* .* .* MyBean}}}
Utilizando 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]]]')

Utilizando Jython com correspondência de padrões:

[Windows]
AdminApp.install('C:/myapp.ear', ['-MapEJBRefToEJB',
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-MapEJBRefToEJB', 
 [['.*', '.*', '.*', '.*', '.*', 'MyBean']]])

MapEnvEntryForApp

A opção MapEnvEntryForApp edita o valor env-entry do aplicativo. É possível usar esta opção para editar o valor de env-entry no arquivo application.xml.

O conteúdo atual dessa opção depois de executar ligações padrão é o seguinte:
  • Nome: xxx
  • Tipo: xxx
  • Descrição: xxx
    Evitar Problemas Evitar Problemas: Se, depois de executar as ligações padrão, o valor for null, você deverá alterá-lo para .* antes de executar esta tarefa. O valor .* é o valor curinga que permite que qualquer descrição seja uma correspondência. Se você deixar o valor como null, ocorrerão exceções quando você executar a tarefa MapEnvEntryForApp.gotcha
  • Valor: <valor env-entry>

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp -MapEnvEntryForApp {{MyApp/appEnvEntry String null newEnvEntry}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForApp {{.* .* .* newEnvEntry}}}
Utilizando Jython:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp3', '-MapEnvEntryForApp', [['MyApp/appEnvEntry', 'String', 'null', 'newEnvEntry']]])
Utilizando Jython com correspondência de padrões:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForApp', [['.*', '.*', '.*', 'newEnvEntry']]])

Se houver um novo caractere de linha na descrição, utilize a sintaxe a seguir:

Utilizando Jacl com correspondência de padrões:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForApp {{.* .* (?s).* newEnvEntry}}}
Utilizando Jython com correspondência de padrões:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForApp',
 [['.*', '.*', '(?s).*', 'newEnvEntry']]])

MapEnvEntryForClientMod

A opção MapEnvEntryForClientMod edita o valor de env-entry do módulo do cliente. É possível usar essa opção para editar o valor das entradas de ambiente no arquivo application-client.xml do módulo do cliente.

O conteúdo atual dessa opção depois de executar ligações padrão é o seguinte:
  • Módulo do cliemte: xxx
  • URI: xxx
  • Nome: xxx
  • Tipo: xxx
  • Descrição: xxx
  • Valor: <env-entry value>

Use o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para o módulo do cliente.

Uso de exemplo do modo em lote

Utilizando 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}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.* .* .*
  .* .* newValue}}} 
Utilizando 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']]])
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '.*', '.*', 'newValue']]]) 

Se houver um novo caractere de linha na descrição, utilize a sintaxe a seguir:

Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForClientMod {{.* .* .*
 (?s).* newValue}}}
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForClientMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForEJBMod

A opção MapEnvEntryForEJBMod edita o valor env-entry do módulo EJB. É possível usar essa opção para editar o valor de entradas de ambiente no módulo EJB, ejb-jar.xml.

O conteúdo atual dessa opção depois de executar ligações padrão é o seguinte:
  • Módulo: xxx
  • URI: xxx
  • Bean: xxx
  • Nome: xxx
  • Tipo: xxx
  • Descrição: xxx
    Evitar Problemas Evitar Problemas: Se, depois de executar as ligações padrão, o valor for null, você deverá alterá-lo para .* antes de executar esta tarefa. O valor .* é o valor curinga que permite que qualquer descrição seja uma correspondência. Se o valor permanecer como null, ocorrerão exceções WASX7017E e WASX7111E quando a tarefa MapEnvEntryForEJBMod for executada. gotcha
  • Valor: <valor env-entry>

Se um módulo EJB usar um EJB 3.0 ou anterior, o conteúdo dessa opção será preenchido apenas a partir do descritor de implementação XML. Não é possível obter informações sobre a implementação com base nas anotações com essa opção.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo.

Uso de exemplo do modo em lote

Utilizando 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}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.jar {-appname MyApp -MapEnvEntryForEJBMod {{.*  .*  .*
  .* .* .* newValue}}} 
Utilizando 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']]])
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '.*', '.*', '.*', 'newValue']]]) 

Se houver um novo caractere de linha na descrição, utilize a sintaxe a seguir:

Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.ear {-appname MyApp -MapEnvEntryForEJBMod {{.*  .*  .*
 (?s).* newValue}}}
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapEnvEntryForEJBMod',
 [['.*', '.*', '.*', '(?s).*', '*', '*' 'newValue']]])

MapEnvEntryForWebMod

A opção MapEnvEntryForWebMod edita o valor env-entry do módulo da Web. É possível utilizar essa opção para editar o valor de env-entry no arquivo web.xml.

O conteúdo atual dessa opção depois de executar ligações padrão é o seguinte:
  • Módulo da Web: xxx
  • URI: xxx
  • Nome: xxx
  • Tipo: xxx
  • Descrição: xxx
    Evitar Problemas Evitar Problemas: Se, depois de executar as ligações padrão, o valor for null, você deverá alterá-lo para .* antes de executar esta tarefa. O valor .* é o valor curinga que permite que qualquer descrição seja uma correspondência. Se o valor permanecer como null, ocorrerão exceções WASX7017E e WASX7111E quando a tarefa MapEnvEntryForWebMod for executada. gotcha
  • Valor: <valor env-entry>

Se um módulo da Web usar um Servlet 2.5, o conteúdo dessa opção será preenchido apenas a partir do descritor de implementação XML. Não é possível obter informações sobre a implementação com base nas anotações com essa opção.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo.

Uso de exemplo do modo em lote

Utilizando 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}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp2 -MapEnvEntryForWebMod {{.* .* .* .* newEnvEntry}}}
Utilizando 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']]])
Utilizando Jython com correspondência de padrões:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp4', '-MapEnvEntryForWebMod', [['.*', '.*', '.*', '.*', 'newEnvEntry']]])

Se houver um novo caractere de linha na descrição, utilize a sintaxe a seguir:

Utilizando Jacl com correspondência de padrões:
$AdminApp install app_server_root/installableApps/ivtApp.ear
 {-appname MyApp5 -MapEnvEntryForWebMod {{.* .* .* (?s).* newEnvEntry}}}
Utilizando Jython com correspondência de padrões:
AdminApp.install('app_server_root/installableApps/ivtApp.ear',
 ['-appname', 'MyApp6', '-MapEnvEntryForWebMod',
 [['.*', '.*', '.*', '(?s).*', 'newEnvEntry']]])

MapInitParamForServlet

A opção MapInitParamForServlet edita o parâmetro inicial de um módulo da Web. É possível usar essa opção para editar o parâmetro inicial de um servlet no arquivo web.xml. O conteúdo atual dessa opção depois de executar as ligações padrão é o seguinte:
  • Módulo da Web: xxx
  • URI: xxx
  • Servlet: xxx
  • Nome: xxx
  • Descrição: null
  • Valor: <valor de parâmetro inicial>
Se um módulo da Web usar um Servlet 2.5 ou superior, o conteúdo dessa opção será preenchido apenas a partir do descritor de implementação XML. Não é possível obter informações sobre a implementação com base nas anotações com essa opção.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo.

Exemplo de uso do modo em lote

Utilizando 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}}} 
Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.ear {-appname MyApp -MapInitParamForServlet
 {{.*  .*  .*  .*  .*  MyInitParamValue}}}
Utilizando 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']]])
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-appname', 'MyApp', '-MapInitParamForServlet',
 [['.*', '.*', '.*', '.*', '.*', 'MyInitParamValue']]])

MapJaspiProvider

A opção MapJaspiProvider especifica o aplicativo da Web ou os módulos da Web a partir de onde deseja substituir as configurações Java Authentication SPI (JASPI) a partir da configuração de segurança global ou de domínio. O conteúdo dessa opção é o seguinte:
  • Módulo: xxx
  • URI: xxx
  • Usar o JASPI: Yes | No | Inherit
  • Nome do provedor JASPI: xxx

Para Usar o JASPI, especifique um valorYes, No ou Inherit no idioma específico para o código do idioma.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que precisam de atualização.

Exemplo de uso do modo em lote

Utilizando Jacl:
$AdminApp install myapp.ear {-MapJaspiProvider {{myapp META-INF/application.xml Yes Provider1} }}
Utilizando Jython:
AdminApp.install('myapp.ear', '[-appname myapp
 -MapJaspiProvider [[myapp META-INF/application.xml Yes Provider1] ]]')

MapMessageDestinationRefToEJB

A opção MapMessageDestinationRefToEJB mapeia referências de destino de mensagem para nomes JNDI (Java Naming and Directory Interface) de objetos administrativos dos adaptadores de recursos instalados. Você deve mapear cada referência de destino de mensagem definida em seu aplicativo para um objeto administrativo. Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa.

O conteúdo atual da opção após a execução das ligações padrão inclui:
  • Módulo: ejb-jar-ic.jar
  • Bean: MessageBean
  • URI: ejb-jar-ic.jar,META-INF/ejb-jar.xml
  • Objeto de destino de mensagem: jms/GSShippingQueue
  • Nome de JNDI do Recurso de Destino: [jms/GSShippingQueue]:
Se a referência de destino da mensagem for de um módulo EJB 3.0 ou anterior, o nome de JNDI será opcional e o tempo de execução fornecerá um contêiner padrão.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Exemplo de uso do modo em lote

Utilizando Jacl:
$AdminApp install BankFull.ear {-MapMessageDestinationRefToEJB {{BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue} }}  
Utilizando Jacl com correspondência de padrões:
$AdminApp install $earfile {-MapMessageDestinationRefToEJB {{.*  .*  .*  MyConnection
 jndi2} {.* .*  .*  PhysicalTopic jndi3} {.*  .*  .*  jms/ABC jndi4}}} 
Utilizando Jython:
AdminApp.install('BankFull.ear', '[ -MapMessageDestinationRefToEJB [[ BankCMRQLEJB
 Sender BankCMRQLEJB.jar,META-INF/ejb-jar.xml BankJSQueue BankJSQueue ]]]' )
Utilizando Jython com correspondência de padrões:
AdminApp.install(ear1, ['-MapMessageDestinationRefToEJB', [['.*', '.*', '.*', 'MyConnection', 
 'jndi2'], ['.*', '.*', '.*', 'PhysicalTopic', 'jndi3'], ['.*', '.*', '.*', 'jms/ABC', 'jndi4']]])

MapModulesToServers

A opção MapModulesToServers especifica o servidor de aplicativos em que você deseja instalar os módulos contidos em seu aplicativo. É possível instalar módulos no mesmo servidor ou dispersá-los entre vários servidores. Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Uso de exemplo do modo em lote

O seguinte exemplo instala Increment.jar em um servidor:

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

O seguinte exemplo instala oIncrement.jar e mapeia-o para dois servidores que são gerenciados por um gerenciador de implementação:

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

O seguinte exemplo inclui server2 e server3 para um aplicativo que está instalado:

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

O exemplo a seguir remove o server1 do aplicativo que está instalado:

Utilizando Jacl:
$AdminApp edit myapp {-MapModulesToServers
 {{.* .* -WebSphere:cell=mycell,node=mynode,server=server1}}
 -update -update.ignore.old} 
Utilizando Jython:
AdminApp.edit('myapp', ['-MapModulesToServers',
 [['.*', '.*', '-WebSphere:cell=mycell,node=mynode,server=server1']]]) 

MapResEnvRefToRes

A opção MapResEnvRefToRes mapeia referências do ambiente de recursos para recursos. Você deve mapear cada referência do ambiente de recursos definida em seu aplicativo para um recurso. Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Uso de exemplo do modo em lote

Utilizando 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}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install app_server_root/installableApps/sibwsjmsepl.ear {
 -MapResEnvRefToRes {{.* .* .* .* .* jndi1}}}
Utilizando 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 ]]]' ) 
Utilizando Jython com correspondência de padrões:
AdminApp.install('app_server_root/installableApps/sibwsjmsepl.ear',
 ['-MapResEnvRefToRes', [['.*', '.*', '.*', '.*', '.*', 'jndi1']]])

MapResRefToEJB

A opção MapResRefToEJB mapeia referências de recursos para recursos. Você deve mapear cada referência de recurso definida em seu aplicativo para um recurso. Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa.

Os parâmetros do MapResRefToEJB incluem:
  • Módulo: Ejb1
  • Bean: MailEJBObject
  • URI: deplmtest.jar,META-INF/ejb-jar.xml
  • Referência de Recurso: jms/MyConnectionFactory
  • Tipo de Recurso: javax.jms.ConnectionFactory
  • Nome JNDI do Recurso de Destino: [jms/MyConnectionFactory]:
  • Nome da Configuração de Login: [null]: Utilize essa opção para criar uma configuração de login customizada. O cliente pode utilizar JAAS para criar um design de login.
  • Propriedades: []: Utilize essa opção para criar uma configuração de login customizada. O cliente pode utilizar JAAS para criar um design de login.
  • Propriedades de Origem de dados estendida: []: Use essa opção para que a origem de dados que usa o conjunto heterogêneo possa se conectar com um banco de dados DB2. O padrão para a propriedade é property1=value1+property2=value 2.

A configuração do login do DefaultPrincipalMapping é utilizada pelos Java 2 Connectors (J2C) para mapearem usuários aos proprietários definidos nas entradas dos dados de autenticação do J2C. Se o login.config.name for definido para DefaultPrincipalMapping, uma propriedade é criada com o nome com.ibm.mapping.authDataAlias. O valor da propriedade é definido por auth.props. Se o nome de login.config não estiver definido para DefaultPrincipalMapping, auth.props pode especificar várias propriedades. O formato da cadeia é websphere:name= <name1>,value=<value1>,description=<desc1>. Especifique várias propriedades utilizando o sinal de mais (+).

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Uso de exemplo do modo em lote

Utilizando 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 ""}}} 
Utilizando Jacl com correspondência de padrões:
$AdminApp install myapp.ear {-MapResRefToEJB 
 {{deplmtest.jar .*  .*  .*  .*  jndi1 login1 authProps1
 "clientApplicationInformation=new application"}
 {"JavaMail Sample WebApp" .*  .*  .*  .*  jndi2 login2 authProps2 ""}}}
Nota: Se usar valores múltiplos para propriedades estendidas de origem de dados, será necessário designar os valores para uma variável e usá-la para o valor da propriedade. Exemplo:
set s \"value1,value2\"
Na substituição de comandos, referencie a variável, conforme mostrado no exemplo a seguir:
"clientApplicationInformation=value1,value2" com "clientapplication=$s"
Utilizando 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', '']]]) 
Utilizando Jython com correspondência de padrões:
AdminApp.install('myapp.ear', ['-MapResRefToEJB', 
 [['deplmtest.jar', '.*', '.*', '.*', '.*', 'jndi1', 'login1', 'authProps1',
 'clientApplicationInformation=new application+clientWorkstation=9.10.117.65'],
 ["JavaMail Sample WebApp", '', '.*', '.*', '.*', 'jndi2', 'login2',
 'authProps2', '']]])
Nota: Se você usar diversos valores para propriedades de origem de dados estendidos, deverá fechar os dois valores entre os caracteres aspas duplas. Exemplo:
'property1="value1,value2"+property2="value3,value4"'

MapRolesToUsers

A opção MapRolesToUsers mapeia usuários para funções. Você deve mapear cada função definida no aplicativo ou módulo para um usuário ou grupo a partir do registro do usuário do domínio. É possível especificar vários usuários ou grupos para uma única função, separando-os por uma barra (|). Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Exemplo de uso do modo em lote

Utilizando Jacl:
$AdminApp install myapp.ear {-MapRolesToUsers {{"All Role" No Yes "" ""}
 {"Every Role" Yes No "" ""} {DenyAllRole No No user1 group1}}}
Utilizando Jython:
AdminApp.install('myapp.ear', '[-MapRolesToUsers [["All Role" No Yes "" ""]
 ["Every Role" Yes No "" ""] [DenyAllRole No No user1 group1]]]')

em que {{"All Role" No Yes "" ""} corresponde ao seguinte:

Tabela 2. Descrições da Opção MapRolesToUsers. Mapear cada função para um usuário ou um grupo.
Opção Descrição
"All Role" Representa o nome da função
NÃO Indica conceder acesso a todos (yes/no)
Sim Indica conceder acesso a todos os usuários autenticados (yes/no)
"" Indica os usuários mapeados
"" Indica os grupos mapeados
"AllAuthenticatedInTrustedRealms" Indica que qualquer usuário válido nas regiões confiáveis recebe o acesso.
"IDs de acesso de usuários mapeados" Indica os IDs de acesso de usuários mapeados
"IDs de acesso de grupos mapeados" Indica os IDs de acesso de grupos mapeados

MapRunAsRolesToUsers

A opção MapRunAsRolesToUsers mapeia Funções RunAs para usuários. Os enterprise beans que você instala contêm funções Executar Como predefinidas. Os beans corporativos que precisam ser executados como uma determinada função para reconhecimento durante a interação com outro bean corporativo utilizam funções Executar Como. Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Exemplo de uso do modo em lote

Utilizando Jacl:

[Windows]
$AdminApp install C:/myapp.ear {-MapRunAsRolesToUsers {{UserRole user1 
 password1} {AdminRole administrator administrator}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MapRunAsRolesToUsers {{UserRole user1
 password1} {AdminRole administrator administrator}}}

Utilizando Jython:

[Windows]
AdminApp.install('C:/myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1 
 password1] [AdminRole administrator administrator]]]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', '[-MapRunAsRolesToUsers [[UserRole user1
 password1] [AdminRole administrator administrator]]]')

MapSharedLibForMod

A opção MapSharedLibForMod designa bibliotecas compartilhadas a aplicativos ou a cada módulo. É possível associar várias bibliotecas compartilhadas a aplicativos ou módulos. O conteúdo atual dessa opção depois de executar ligações padrão é o seguinte:
  • Módulo: xxx
  • URI: META-INF/application.xml
  • Bibliotecas compartilhadas: <bibliotecas compartilhadas>

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo.

Uso de exemplo do modo em lote

Utilizando 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 }}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi -MapSharedLibForMod {{ .* .* sharedlib1 }
 { .* .* sharedlib2 }}}
Utilizando Jython:
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ DynaCacheEsi META-INF/application.xml sharedlib1 ]
 [ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml sharedlib2 ]]]' )
Utilizando Jython com correspondência de padrões:
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[ -MapSharedLibForMod [[ .* .* sharedlib1 ][ .* .* sharedlib2 ]]]' )

MapWebModToVH

A opção MapWebModToVH seleciona hosts virtuais para módulos da Web. Especifique o host virtual onde deseja instalar os módulos da Web que estão contidos no seu aplicativo. É possível instalar módulos da Web no mesmo host virtual ou dispersá-los entre vários hosts. Utilize essa opção para fornecer dados que estejam faltando ou para atualizar uma tarefa.

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo. É necessário fornecer dados para linhas ou entradas para as quais estejam faltando informações ou que requeiram atualização.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-appname DynaCacheEsi
 -MapWebModToVH {{ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host }}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install app_server_root/installableApps/DynaCacheEsi.ear
 {-MapWebModToVH {{ .* .* default_host }}}
Utilizando Jython:
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 '[-MapWebModToVH [[ DynaCacheEsi DynaCacheEsi.war,WEB-INF/web.xml default_host ]]]') 
Utilizando Jython com correspondência de padrões:
AdminApp.install('app_server_root/installableApps/DynaCacheEsi.ear',
 ['-MapWebModToVH', [['.*', '.*', 'default_host']]])

MetadataCompleteForModules

A opção MetadataCompleteForModules ativa cada módulo Java EE 5 ou posterior para gravar o descritor de implementação completo, incluindo informações de implementação das anotações. Em seguida, o sistema marca o descritor de implementação para o módulo como completo.

Evitar Problemas Evitar Problemas: Se seu aplicativo Java EE 5 ou superior usar anotações e uma biblioteca compartilhada não use essa opção. Quando o aplicativo usa anotações e uma biblioteca compartilhada, configurar o atributo metadata-complete como true faz com que o produto represente incorretamente uma anotação @EJB no descritor de implementação como <ejb-ref>, em vez de <ejb-local-ref>. Para módulos da Web, a configuração do atributo metadata-complete para true pode causar erros de InjectionException. Se você tiver que configurar o atributo metadata-complete como true, evite erros não utilizando uma biblioteca compartilhada, colocando a biblioteca compartilhada no diretório classes ou lib do servidor de aplicativos ou especificando completamente os metadados nos descritores de implementação.gotcha
O conteúdo atual dessa opção depois de executar ligações padrão é o seguinte:
  • Módulo: EJBDD_1.jar
  • URI: EJBDD_1.jar,META-INF/ejb-jar.xml
  • Descritor de implementação de bloqueio: [false]:
  • Módulo: EJBNoDD_2.jar
  • URI: EJBNoDD_2.jar,META-INF/ejb-jar.xml
  • Descritor de implementação de bloqueio: [false]:

Utilize o comando taskInfo do objeto AdminApp para obter informações sobre os dados necessários para seu aplicativo.

Exemplo de uso do modo em lote

Utilizando Jacl:

[Windows]
$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear {-MetadataCompleteForModules
 {{EJBDD_1.jar EJBDD_1.jar,META-INF/ejb-jar.xml false}}}

Utilizando Jacl com correspondência de padrões:

[Windows]
$AdminApp install c:/myapp.ear {-MetadataCompleteForModules
 {{.* EJBDD_1.jar,.* false}}}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install myapp.ear 
 {-MetadataCompleteForModules {{.* EJBDD_1.jar,.* false}}}

Utilizando Jython:

[Windows]
AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', 
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', ['-MetadataCompleteForModules',
 [['EJBDD_1,jar',  'EJBDD_1.jar,META-INF/ejb-jar.xml', 'false']]])

Utilizando Jython com correspondência de padrões:

[Windows]
AdminApp.install('c:/myapp.ear', ['-MetadataCompleteForModules', [['.*',
 'EJBDD_1.jar,.*', 'false']]]
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear', 
 ['-MetadataCompleteForModules', [['.*',  'EJBDD_1.jar,.*', 'false']]]

ModuleBuildID

A opção ModuleBuildID exibe o identificador de build de um módulo em um arquivo EAR do aplicativo. Não é possível modificar essa opção porque ela é de leitura. Essa opção retornará as informações de build de um módulo se você tiver especificado o identificador de build no MANIFEST.MF de um módulo ou um arquivo EAR do aplicativo. As informações de build consistem no nome do módulo, no URI do módulo e no identificador de build.

O conteúdo atual da opção depois de executar ligações padrão é semelhante ao seguinte:
  • Módulo: CacheClient
  • URI: CacheClient.jar,META-INF/application-client.xml
  • ID do build: alpha
  • Módulo: MailConnector
  • URI: Mail.rar,META-INF/ra.xml
  • ID do build: abc
  • Módulo: CacheWeb1
  • URI: CacheWeb1.war,WEB-INF/web.xml
  • ID do build: alpha
  • Módulo: JspWeb1
  • URI: JspWeb1.war,WEB-INF/web.xml
  • ID do build: v1.0
  • Módulo: Servlet
  • URI: Servlet.war,WEB-INF/web.xml
  • ID do build: 0.5

Uso de exemplo do modo em lote

Utilizando Jython:

[Windows]
print AdminApp.taskInfo('c:/temp/Cache2.ear', 'ModuleBuildID')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
print AdminApp.taskInfo('/temp/Cache2.ear', 'ModuleBuildID')

noallowDispatchRemoteInclude

A opção noallowDispatchRemoteInclude desativa o aplicativo corporativo que despacha includes para os recursos entre os módulos da Web em Java virtual machines diferentes em um ambiente de nó gerenciado por meio do mecanismo despachante de solicitação padrão.

noallowPermInFilterPolicy

A opção noallowPermInFilterPolicy especifica não continuar com o processo de implementação do aplicativo quando o aplicativo contiver permissões de critérios que estejam no critério de filtro. Essa opção é a configuração padrão e não exige um valor.

noallowServiceRemoteInclude

A opção noallowServiceRemoteInclude não permite que o aplicativo corporativo atenda a um pedido de inclusão de um aplicativo corporativo que tenha a opção allowDispatchRemoteInclude configurada como true.

A opção node especifica o nome do nó no qual instalar ou atualizar um aplicativo inteiro ou para atualizar um aplicativo, a fim de incluir um novo módulo. Se desejar atualizar um aplicativo inteiro, essa opção ser aplicará somente se o aplicativo contiver um novo módulo que não exista no aplicativo instalado.

Uso de exemplo do modo em lote

Utilizando Jacl:

[Windows]
$AdminApp install "C:/myapp.ear" {-node nodeName}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install "/myapp.ear" {-node nodeName}

Utilizando Jython:

[Windows]
AdminApp.install('C:/myapp/myapp.ear', '[-node nodeName]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('/myapp/myapp.ear', '[-node nodeName]')

nocreateMBeansForResources

A opção nocreateMBeansForResources especifica que os MBeans não são criados para todos os recursos, como servlets, arquivos JavaServer Pages e enterprise beans, definidos em um aplicativo quando o aplicativo inicia em um destino de implementação. Essa opção é a definição padrão e um valor não é requerido.

nodeployejb

A opção nodeployejb especifica não executar a ferramenta EJBDeploy durante a instalação. Essa opção é a configuração padrão e não exige um valor.

nodeployws

A opção nodeployws especifica não implementar os serviços da Web durante a instalação. Essa opção é a configuração padrão e não exige um valor.

nodistributeApp

A opção nodistributeApp especifica que o componente de gerenciamento de aplicativos não distribui binários de aplicativos. Essa opção não requer um valor. A definição padrão é a opção distributeApp.

noenableClientModule

A opção noenableClientModule especifica a não implementação dos módulos do cliente. Esta opção não requer um valor. Esse é o padrão. O padrão é não implementar os módulos do cliente. Use a opção enableClientModule para implementar módulos do cliente.

noreloadEnabled

A opção noreloadEnabled não permite o recarregamento de classe. Essa opção é a configuração padrão e não exige um valor. Para especificar que o sistema de arquivos do aplicativo seja varrido dos arquivos atualizados, para que as mudanças sejam recarregadas dinamicamente, use a opção reloadEnabled.

nopreCompileJSPs

A opção nopreCompileJSPs especifica não pré-compilar arquivos JavaServer Pages. Essa opção é a configuração padrão e não exige um valor.

noprocessEmbeddedConfig

A opção noprocessEmbeddedConfig especifica que o sistema deve ignorar os dados de configuração integrados que sejam incluídos no aplicativo. Essa opção não requer um valor. Se o arquivo archive corporativo (EAR) do aplicativo não contiver dados de configuração integrados, a opção noprocessEmbeddedConfig será a configuração padrão. Caso contrário, a definição padrão é a opção processEmbeddedConfig.

nouseAutoLink

A opção nouseAutoLink especifica não usar a opção useAutoLink, e não resolver automaticamente as referências do Enterprise JavaBeans (EJB) a partir do módulo EJB de versões anteriores ao EJB 3.0 e a partir de versões do módulo da Web que sejam anteriores à Versão 2.4.

nouseMetaDataFromBinary

A opção nouseMetaDataFromBinary especifica se os metadados utilizados no tempo de execução, por exemplo, descritores de implementação, ligações, extensões, etc., são provenientes do repositório de configuração. Essa opção é a configuração padrão e não exige um valor. Use essa opção para indicar que os metadados que são usados no tempo de execução são provenientes do arquivo enterprise archive (EAR).

nousedefaultbindings

A opção nousedefaultbindings especifica não utilizar ligações padrão para a instalação. Essa opção é a configuração padrão e não exige um valor.

novalidateSchema

A opção novalidateSchema especifica a não validação dos descritores de implementação junto aos esquemas do descritor de implementação Java EE publicados. Essa opção não requer um valor. Esse é o padrão. O padrão é não validar os descritores de implementação.

operação

A opção operation especifica a operação que você deseja executar. Essa opção aplica-se apenas aos comandos update ou updateInteractive. Os valores válidos incluem:
  • add - Inclui novo conteúdo.
  • addupdate - Inclui ou atualiza o conteúdo com base na existência do conteúdo no aplicativo.
  • delete - Exclui conteúdo.
  • update - Atualiza o conteúdo existente.

A opção operation é requerida se o tipo de conteúdo for file ou modulefile. Se o valor do tipo de conteúdo for app, o valor da opção de operação deve ser update. A opção contenturi é ignorada quando o tipo de conteúdo é app.

Uso de exemplo do modo em lote

Os seguintes exemplos mostram como usar as opções para o comando update para atualizar um aplicativo corporativo inteiro implementado:

Utilizando Jacl:
$AdminApp update "IVT Application" app {-operation update
 -contents app_server_root/installableApps/ivtApp.ear}
Utilizando a cadeia Jython:
AdminApp.update('IVT Application', 'app', '[ -operation update
 -contents app_server_root/installableApps/ivtApp.ear ]' )

Os exemplos a seguir mostram como usar as opções para o comando update para atualizar um único arquivo em um aplicativo implementado:

Utilizando Jacl:

[Windows]
$AdminApp update app1 file {-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml}
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp update app1 file {-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml}

Utilizando a cadeia Jython:

[Windows]
AdminApp.update('app1', 'file', '[-operation update -contents 
 C:/apps/app1/my.xml -contenturi app1.jar/my.xml]')
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.update('app1', 'file', '[-operation update 
 -contents /apps/app1/my.xml -contenturi app1.jar/my.xml]')

Utilizando a lista Jython:

[Windows]
AdminApp.update('app1', 'file', ['-operation', 'update', '-contents', 
 'C:/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.update('app1', 'file', ['-operation', 'update', '-contents',
 '/apps/app1/my.xml', '-contenturi', app1.jar/my.xml'])

em que AdminApp é o objeto de script, update é o comando, app1 é o nome do aplicativo que deseja atualizar, file é o tipo de conteúdo, operation é uma opção do comando update, update é o valor da opção operation, contents é uma opção do comando update, /apps/app1/my.xml é o valor da opção contents, contenturi é uma opção do comando update, app1.jar/my.xml é o valor da opção contenturi.

processEmbeddedConfig

A opção processEmbeddedConfig processa os dados de configuração incorporados que são incluídos no aplicativo. Essa opção não requer um valor. Se o arquivo archive corporativo (EAR) do aplicativo contiver dados de configuração integrados, essa opção será a configuração padrão. Caso contrário, a definição padrão é a opção nonprocessEmbeddedConfig.

Essa configuração afeta a instalação dos arquivos EAR aprimorados. Um arquivo EAR aprimorado é resultado quando você exporta um aplicativo instalado. Arquivos EAR aprimorados possuem uma configuração integrada que consiste de arquivos, como resource.xml e variables.xml. Essa opção carrega uma configuração integrada no escopo do aplicativo a partir do arquivo EAR.

Se você exportou o aplicativo a partir de uma célula diferente da célula atual e não especificou a variável $(CELL) para a opção installed.ear.destination quando instalou pela primeira vez o aplicativo, use a opção nonprocessEmbeddedConfig para expandir o arquivo EAR aprimorado no diretório profile_root/installedApps/current_cell_name. Caso contrário, use essa opção processEmbeddedConfig para expandir o arquivo EAR aprimorado no diretório profile_root/installedApps/original_cell_name, em que original_cell_name é a célula na qual o aplicativo foi instalado pela primeira vez. Se você especificou a variável $(CELL) para a opção installed.ear.destination quando instalou pela primeira vez o aplicativo, a instalação expandirá o arquivo EAR aprimorado no diretório profile_root/installedApps/current_cell_name.

preCompileJSPs

A opção preCompileJSPs especifica pré-compilar arquivos JavaServer Pages. Essa opção não requer um valor. O valor padrão é nopreCompileJSPs. Se você deseja pré-compilar os arquivos JavaServer Pages, especifique-o como parte da instalação. O padrão é não pré-compilar os arquivos JavaServer Pages. A opção preCompileJSPs é ignorada durante a implementação e os arquivos JavaServer Pages não são pré-compilados. O sinalizador é configurado automaticamente usando as ferramentas de montagem.

reloadEnabled

A opção reloadEnabled especifica que o sistema de arquivos do aplicativo será varrido dos arquivos atualizados, para que as alterações sejam recarregadas dinamicamente. Se essa opção for ativada e se as classes do aplicativo forem alteradas, o aplicativo será parado e reiniciado para recarregar as classes atualizadas. Essa opção não é a configuração padrão e não requer um valor. A configuração padrão é a opção noreloadEnabled.

reloadInterval

A opção reloadInterval especifica o tempo em segundos que o sistema de arquivos do aplicativo será varrido dos arquivos atualizados. O intervalo válido é maior que zero. O padrão é três segundos.

SharedLibRelationship

A opção SharedLibRelationship atribui os IDs de recursos ou de unidade de composição como bibliotecas compartilhadas para cada módulo Java EE.

O conteúdo atual da opção após a execução das ligações padrão inclui:
  • Módulo: EJB3BNDBean.jar
  • URI: EJB3BNDBean.jar,META-INF/ejb-jar.xml
  • IDs de relacionamento: especifique os IDs de recurso ou da unidade de composição, como [WebSphere:cuname=sharedLibCU1,cuedition=1.0] ou WebSphere:assetname=sharedLibAsset1.jar
  • Nomes da Unidade de Composição: especifique opcionalmente os nomes da unidade de composição para os IDs de relacionamento de recurso. O sistema utilizará o mesmo nome que o do recurso se você não especificar um nome de unidade de composição. []
  • Corresponder destino: [Yes]:
É possível especificar os IDs de recursos e da unidade de composição no relacionamento, como é explicado pelas diretrizes a seguir:
  • Se você especificar um recurso, o sistema criará uma unidade de composição com esse recurso no mesmo aplicativo no nível de negócio ao qual o aplicativo Java EE pertence.
  • Se você especificar um valor para os nomes da unidade de composição, a posição do sistema corresponderá a cada nome com os valores de IDs de relacionamento correspondentes.
  • Se o ID de relacionamento for um ID de unidade de composição, o sistema ignorará o nome da unidade de composição correspondente.
  • Se o ID de relacionamento for um ID de recurso, o sistema criará a unidade de composição utilizando o nome da unidade de composição correspondente.

Para especificar mais de um ID de recurso ou de composição, separe cada valor com o sinal de mais (+).

Ao utilizar o comando edit para o aplicativo Java EE, é possível substituir o relacionamento por um novo conjunto de IDs de relacionamento de unidade de composição ou pode incluir ou remover os relacionamentos de unidade de composição existentes. Você não pode especificar um relacionamento de recurso ao utilizar o comando edit. Especifique o primeiro caractere do ID da unidade de composição como o caractere de sinal de mais (+) a ser incluído no relacionamento ou especifique o caractere de sinal de número (#) para remover o ID da unidade de composição dos relacionamentos existentes. Por exemplo, a sintaxe da unidade de composição +cuname=cu2.zip inclui a unidade de composição cu2 ao relacionamento. A sintaxe da unidade de composição #cuname=cu1.zip+cuname=cu2.zip remove as unidades de composição cu1 e cu2 do relacionamento.

Uso de exemplo do modo em lote

Utilizando Jacl:

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

Utilizando Jacl com correspondência de padrões:

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

Utilizando Jython:

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

Utilizando Jython com correspondência de padrões:

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

servidor

A opção do servidor especifica o nome do servidor no qual você deseja executar uma das seguintes ações:
  • Instale um novo aplicativo.
  • Substitua um aplicativo existente por uma versão atualizada desse aplicativo. Nesta situação, a opção do servidor é significativa apenas se a versão atualizada do aplicativo contiver um novo módulo que não existe na versão já instalada do aplicativo.
  • Adicione um novo módulo a um aplicativo existente.

Não é possível usar as opções -cluster e -server em conjunto. Se desejar implementar um aplicativo e especificar o servidor HTTP durante a implementação de forma que o aplicativo aparecerá no arquivo plugin-cfg.xml gerado, você deverá primeiro instalar o aplicativo com um destino igual a -cluster. Depois de instalar o aplicativo e antes de salvar, use o comando edit do objeto AdminApp para incluir o mapeamento adicional ao servidor da Web.

Uso de exemplo do modo em lote

Utilizando Jacl:

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

Utilizando Jython:

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

destino

A opção target especifica o destino para as funções de instalação do objeto AdminApp. A seguir há um exemplo de uma opção de destino: WebSphere:cell=mycell,node=mynode,server=myserver

É possível especificar diversos destinos delimitando-os com um sinal de mais (+). Por padrão, os destinos especificados quando você instala ou edita um aplicativo substituem as definições de destino existentes no aplicativo. É possível usar um sinal de mais (+) inicial para incluir destinos ou um sinal de menos (-) para remover destinos sem precisar especificar os destinos que não são alterados.
Nota: A sintaxe integral do mapeamento de destino precisa ser usada com a opção MapModulesToServers, quando vários domínios forem usados. Não é possível usar o sinal de mais + à esquerda para incluir um novo destino com a opção MapModulesToServers, quando vários domínios forem usados; o tempo de execução não pode resolver corretamente os domínios mapeados para os destinos de implementação.

Uso de exemplo do modo em lote

O seguinte exemplo especifica server1 como o servidor de destino para a instalação do aplicativo:

Utilizando Jacl:

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

Utilizando Jython:

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

O exemplo a seguir especifica server1 e server2 como os servidores de destino para a instalação do aplicativo:

Utilizando 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}
Utilizando 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"])

O exemplo a seguir remove server3 do aplicativo instalado:

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

O exemplo a seguir inclui server4 no aplicativo instalado:

Utilizando 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}
Utilizando 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

A opção de atualização atualiza o aplicativo instalado com a nova versão do arquivo enterprise archive (EAR). Essa opção não requer um valor.

O aplicativo a ser atualizado, que é especificado pela opção appname, já deverá estar instalado na configuração do WebSphere Application Server. A ação de atualização mescla ligações da nova versão com as ligações da versão anterior, desinstala a versão anterior e instala a nova versão. As informações sobre ligação da nova versão do arquivo EAR ou do módulo são preferidas às informações correspondentes da versão antiga. Se algum elemento de ligação estiver faltando na nova versão, o elemento correspondente da versão anterior será utilizado.

update.ignore.new

A opção update.ignore.new especifica que, durante a ação de atualização, as informações sobre ligação da versão antiga do aplicativo ou do módulo são preferidas às informações sobre ligação correspondentes da nova versão. Se algum elemento da ligação não existir na versão antiga, o elemento da nova versão será usado. Ou seja, as ligações da nova versão do aplicativo ou do módulo serão ignoradas se existir uma ligação na versão antiga. Caso contrário, as novas ligações serão aceitas e não ignoradas. Essa opção não requer um valor.

Essa opção aplica-se apenas se você especificar um dos seguintes itens:
  • A opção update para o comando install.
  • modulefile ou app como o tipo de conteúdo para o comando update.

update.ignore.old

A opção update.ignore.old especifica que, durante a ação de atualização, as informações sobre ligação da nova versão do aplicativo ou do módulo são preferidas às informações sobre ligação correspondentes da versão antiga. As ligações da versão antiga do aplicativo ou do módulo serão ignoradas. Essa opção não requer um valor. Essa opção aplica-se apenas se você especificar um dos seguintes itens:
  • A opção update para o comando install.
  • modulefile ou app como o tipo de conteúdo para o comando update.

useAutoLink

Use opção useAutoLink para resolver automaticamente as referências do Enterprise JavaBeans (EJB) a partir do módulo EJB de versões anteriores ao EJB 3.0 e a partir de versões do módulo da Web que sejam anteriores à Versão 2.4. Se você ativar a opção useAutoLink, poderá especificar opcionalmente o nome de JNDI para a opção MapEJBRefToEJB. Cada módulo no aplicativo deve compartilhar o destino comum para ativar o suporte de autolink.

Uso de exemplo do modo em lote

Utilizando Jacl:

[Windows]
$AdminApp install C:/myapp.ear {-useAutoLink} 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
$AdminApp install /myapp.ear {-useAutoLink} 

Utilizando Jython:

[Windows]
AdminApp.install('C:/myapp.ear','[-useAutoLink]') 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
AdminApp.install('myapp.ear','[-useAutoLink]') 

usedefaultbindings

A opção usedefaultbindings especifica o uso de ligações padrão para a instalação. Essa opção não requer um valor. A definição padrão é nousedefaultbindings.

Para utilizar a porta listener existente em vez de utilizar ou criar uma nova especificação de ativação, determine se a versão do EJB JAR é inferior a 2.1. O sistema cria e utiliza automaticamente uma especificação de ativação quando você especifica a opção -usedefaultbindings para implementar um aplicativo. Se uma especificação de ativação existir, o sistema ignorará a porta listener e utilizará a especificação de ativação. Para implementar um aplicativo com uma versão do EJB JAR maior ou igual a 2.1 usando portas listener definidas em vez de uma nova especificação de ativação, configure a propriedade do sistema com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting para true no arquivo wsadmin.properties no diretório de propriedades do perfil de interesse.

useMetaDataFromBinary

A opção useMetaDataFromBinary especifica que os metadados que são utilizados no tempo de execução, por exemplo, descritores de implementação, ligações, extensões, etc., sejam provenientes do arquivo EAR. Esta opção não requer um valor. O valor padrão é nouseMetaDataFromBinary, que significa que os metadados utilizados no tempo de execução vêm do repositório de configuração.

validateinstall

A opção validateinstall especifica o nível de validação de instalação do aplicativo. Os valores de opção válidos incluem:
  • off - Especifica nenhuma validação da implementação do aplicativo. Este valor é o padrão.
  • warn - Executa a validação de implementação do aplicativo e continua com o processo de implementação do aplicativo mesmo quando ocorrerem mensagens de erro ou avisos.
  • fail - Executa a validação de implementação do aplicativo e não continua com o processo de implementação do aplicativo quando existirem mensagens de erro ou avisos.

validateSchema

A opção validateSchema especifica a validação dos descritores de implementação junto aos esquemas do descritor de implementação Java EE publicados. Quando essa opção de implementação do aplicativo está selecionada, o produto analisa cada descritor de implementação para determinar a versão de especificação do Java EE para o descritor de implementação, seleciona o esquema adequado e, em seguida, verifica o descritor de implementação junto ao esquema do descritor de implementação do Java EE. Os erros de validação resultam em mensagens de erro.

Essa opção não requer um valor. O valor padrão é novalidateSchema. Por padrão, a opção validateSchema é ignorada durante a implementação e o produto não valida os descritores de implementação.

detalhado

A opção verbose faz com que mensagens adicionais sejam exibidas durante a instalação. Essa opção não requer um valor.

WebServicesClientBindDeployedWSDL

A opção WebServicesClientBindDeployedWSDL identifica o serviço da web do cliente que você está modificando. Os campos de escopo incluem: Módulo, EJB e serviços da Web. O único valor mutável para essa tarefa é o nome do arquivo WSDL implementado. Ele indica o WSDL (Web Services Description Language) utilizado pelo cliente.

O campo Módulo identifica o aplicativo corporativo ou da Web dentro do aplicativo. Se o módulo for um enterprise bean, o campo EJB identifica um enterprise bean específico no módulo. O campo de serviço da Web identifica o serviço da Web dentro do módulo do enterprise bean ou do aplicativo da Web. Este identificador corresponde ao atributo wsdl:service no arquivo WSDL, que tem um prefixo service/; por exemplo, service/WSLoggerService2.

O atributo WSDL implementado nomeia um arquivo WSDL relativo ao módulo do cliente. Um exemplo de um WSDL implementado para um aplicativo da Web é o seguinte: WEB-INF/wsdl/WSLoggerService.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{AddressBookW2JE.jar 
 AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl}}} 
Utilizando Jacl com correspondência de padrões:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindDeployedWSDL {{.*  .*  .*  
 META-INF/wsdl/DeployedWsdl1.wsdl}}}
O exemplo a seguir ilustra as opções BindJndiForEJBNonMessageBinding, Hermaphrodite e 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 }} } 
Utilizando Jython:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindDeployedWSDL 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 META-INF/wsdl/DeployedWsdl1.wsdl]]]') 
Para instalar a amostra WebServicesSamples.ear, você deve especificar as opções BindJndiForEJBNonMessageBinding e MapWebModToVH, bem como a opção 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 ]]]' ) 
Utilizando Jython com correspondência de padrões:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindDeployedWSDL',
['.*', '.*', '.*', 'META-INF/wsdl/DeployedWsdl1.wsdl']]])

WebServicesClientBindPortInfo

A opção WebServicesClientBindPortInfo identifica a porta de um serviço da Web cliente que você está modificando. Os campos de escopo incluem: Module, EJB, Serviço da Web e Tipo de Porta. Os valores mutáveis para essa tarefa incluem: Sync Timeout, BasicAuth ID, BasicAuth Password, SSL Config e Overridden Endpoint URI. Os campos Autenticação Básica e Secure Sockets Layer (SSL) afetam a segurança no nível do transporte e não a Segurança de Serviços da Web.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{AddressBookW2JE.jar 
 AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID newHTTP_pwd sslAliasConfig 
 http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}} 
Para instalar a amostra WebServicesSamples.ear, você deve especificar as opções BindJndiForEJBNonMessageBinding e MapWebModToVH, bem como a opção 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 }} } 
Utilizando Jacl com correspondência de padrões:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPortInfo {{.*  .*  .*  .*  3000 
 newHTTP_ID newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS}}}
Utilizando Jython:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPortInfo
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS 3000 newHTTP_ID
 newHTTP_pwd sslAliasConfig http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS]]]') 
Para instalar a amostra WebServicesSamples.ear, você deve especificar as opções BindJndiForEJBNonMessageBinding e MapWebModToVH, bem como a opção 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 ]]]' )
Utilizando Jython com correspondência de padrões:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPortInfo',
 [['.*', '.*', '.*', '.*', '3000', 'newHTTP_ID', 'newHTTP_pwd', 'sslAliasConfig',
 'http://yunus:9090/WSLoggerEJB/services/WSLoggerJMS']]])

WebServicesClientBindPreferredPort

A opção WebServicesClientBindPreferredPort associa uma porta preferencial (implementação) a um tipo de porta (interface) para um serviço da Web cliente. Os valores imutáveis identificam um tipo de porta do serviço da Web cliente que está modificando. Os campos de escopo incluem: Module, EJB, Web service e Port Type. O valor mutável para essa tarefa é Port.
  • Port Type - QName ("{namespace} localname") de um tipo de porta definido por um atributo wsdl:portType no arquivo WSDL que identifica uma interface.
  • Port - QName de uma porta definida por um atributo wsdl:port em um atributo wsdl:service em um arquivo WSDL que identifica uma implementação que tem preferência.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort
 {{AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort}}} 
Para instalar a amostra WebServicesSamples.ear, você deve especificar as opções BindJndiForEJBNonMessageBinding e MapWebModToVH, bem como a opção 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 }} } 
Utilizando Jacl com correspondência de padrões:
$AdminApp install WebServicesSamples.ear {-WebServicesClientBindPreferredPort {{.* .* .* .* 
 WSLoggerJMSPort}}}
Utilizando Jython:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesClientBindPreferredPort 
 [[AddressBookW2JE.jar AddressBookW2JE service/WSLoggerService2 WSLoggerJMS WSLoggerJMSPort]]]') 
Para instalar a amostra WebServicesSamples.ear, você deve especificar as opções BindJndiForEJBNonMessageBinding e MapWebModToVH, bem como a opção 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 ]]]' )
Utilizando Jython com correspondência de padrões:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesClientBindPreferredPort',
 [['.*', '.*', '.*', '.*', 'WSLoggerJMSPort']]])

WebServicesServerBindPort

A opção WebServicesServerBindPort configura dois atributos de uma porta de serviço da Web. Os valores imutáveis identificam a porta de um serviço da Web que está modificando. Os campos de escopo incluem: Module, Web service e Port. Os valores mutáveis incluem: WSDL Service Name e Scope.

O escopo determina o ciclo de vida de implementação do Java bean. Os valores válidos incluem: Request (nova instância para cada pedido), Application (uma instância para cada web-app) e Session (nova instância para cada sessão HTTP).

O atributo de escopo não se aplica aos serviços da Web que um Sistema de Mensagens Java (JMS) transporta. O atributo de escopo não aplica-se aos enterprise beans.

O WSDL Service Name identifica um serviço quando mais de um serviço tem o mesmo nome de porta. O WSDL Service Name é representado como uma cadeia QName, por exemplo, {namespace}localname.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
 {{AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS {} Session}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp install WebServicesSamples.ear {-WebServicesServerBindPort
 {{.*  WSClientTestService WSClientTest Request} {.*  StockQuoteService StockQuote Application}
 {.*  StockQuoteService StockQuote2 Session}}}
Utilizando Jython:
AdminApp.install('WebServicesSamples.ear', '[-WebServicesServerBindPort
 [[AddressBookW2JE.jar service/WSLoggerService2 WSLoggerJMS "" Session]]]')
Utilizando Jython com correspondência de padrões:
AdminApp.install('WebServicesSamples.ear', ['-WebServicesServerBindPort',
 [['.*', 'WSClientTestService', 'WSClientTest', 'Request'],
 ['.*', 'StockQuoteService', 'StockQuote', 'Application'],
 ['.*', 'StockQuoteService', 'StockQuote2', 'Session']]])

WebServicesClientCustomProperty

A opção WebServicesClientCustomProperty suporta a configuração do parâmetro de valor de nome para a descrição do arquivo de ligação do cliente de um serviço da Web. Os valores imutáveis identificam a porta do serviço da Web que está modificando. Os campos de escopo incluem: Module, Web service e Port. Os valores mutáveis incluem: name e value.

O formato dos valores name e value incluem uma cadeia que representa vários pares de nome e valor, utilizando o caractere + como um separador. Por exemplo, cadeia de nomes = "n1+n2+n3" cadeia de valores = "v1+v2+v3" pares nome/valor de rendimentos: {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}},

Uso de exemplo do modo em lote

Utilizando 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}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp edit WebServicesSamples {-WebServicesClientCustomProperty
 {{join.jar com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest .* .* propname1 propValue1}
 {ejbclientonly.jar Exchange .* .* propname2 propValue2}}}
Utilizando 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']]])
Utilizando Jython com correspondência de padrões:
AdminApp.edit('WebServicesSamples', ['-WebServicesClientCustomProperty',
 [['join.jar', 'com_ibm_ws_wsfvt_test_multiejbjar_client_WSClientTest',
 '.*', '.*', 'propname1', 'propValue1'],
 ['ejbclientonly.jar', 'Exchange', '.*', '.*', 'propname2', 'propValue2']]])

WebServicesServerCustomProperty

A opção WebServicesServerCustomProperty suporta a configuração do parâmetro de valor de nome para a descrição do arquivo de ligação do servidor de um serviço da Web. Os campos de escopo incluem: Módulo, EJB e serviço da Web. Os valores mutáveis para essa tarefa incluem: name e value.

O formato desses valores inclui uma cadeia que representa vários pares de nome e valor, utilizando o caractere mais (+) como um separador. Por exemplo, cadeia de nomes = "n1+n2+n3" cadeia de valores = "v1+v2+v3" pares de nome e valor de rendimentos: {{"n1" "v1"}, {"n2" "v2"}, {"n3" " v3"}}.

Uso de exemplo do modo em lote

Utilizando Jacl:
$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
 {{AddressBookW2JE.jar AddressBookService AddressBook
 com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}
Utilizando Jacl com correspondência de padrões:
$AdminApp edit WebServicesSamples {-WebServicesServerCustomProperty
 {{.* .* .* com.ibm.websphere.webservices.http.responseContentEncoding deflate}}}
Utilizando Jython:
AdminApp.edit ( 'WebServicesSamples', '[ -WebServicesServerCustomProperty
 [[AddressBookW2JE.jar AddressBookService AddressBook
 com.ibm.websphere.webservices.http.responseContentEncoding deflate]]]')
Utilizando Jython com correspondência de padrões:
AdminApp.edit ( 'WebServicesSamples', ['-WebServicesServerCustomProperty', [['.*', '.*',
 '.*', 'com.ibm.websphere.webservices.http.responseContentEncoding', 'deflate']]])

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_taskoptions
Nome do arquivo: rxml_taskoptions.html