Scripts de Configuração do Aplicativo no Nível de Negócios

A biblioteca de scripts fornece vários procedimentos de script para automatizar as configurações do servidor de aplicativos. Utilize os scripts deste tópico para criar, consultar e gerenciar seus aplicativos no nível de negócios. É possível executar cada script individualmente ou combinar os procedimentos para criar scripts de automação customizados.

Os procedimentos do script AdminBLA estão localizados no diretório app_server_root/scriptLibraries/application/V70.

Utilize os seguintes procedimentos de script para configurar e administrar seus aplicativos no nível de negócios:
Utilize os seguintes procedimentos de script para consultar suas configurações de aplicativos no nível de negócios:
Evitar Problemas Evitar Problemas: Os comandos, viewBLA, viewAsset e viewCompUnit só exibem saída para o console e não retornam dados para o script Jython de chamada. Esses comandos não pretendem ser usados como parte de um script para armazenar a saída do comando para uma variável de sequência. Usando esses comandos em um script Jython para armazenar a saída para uma variável de sequência, a variável de sequência conterá apenas o valor "Operação Bem-sucedida!".

Quando chamados, como pretendido, com a interface wsadmin de Jython, esses comandos exibem corretamente a saída para o console.

gotcha

addCompUnit

Esse script inclui recursos, bibliotecas compartilhadas ou aplicativos adicionais no nível de negócios como unidades de composição no aplicativo vazio no nível de negócios. Uma unidade de composição representa um recurso em um aplicativo no nível de negócios. Uma unidade de configuração permite que o conteúdo do recurso interaja com outros recursos no aplicativo. Ela também permite que o tempo de execução do produto carregue e execute o conteúdo do recurso.

Para executar o script, especifique os argumentos de nome do aplicativo no nível de negócios e a origem da unidade de composição, conforme definido na seguinte tabela:
Tabela 1. Descrições do Argumento addCompUnit. Execute o script para incluir uma unidade de composição em um aplicativo em nível de negócios.
Argumento Descrição
blaName Especifica o nome do aplicativo no nível de negócios no qual o sistema inclui a unidade de composição.
compUnitID Especifica o nome da unidade de composição a ser incluída no aplicativo no nível de negócios de interesse.
deployableUnit Especifica, opcionalmente, o nome da unidade implementável do recurso. Uma unidade implementável é a menor parte de um recurso que pode ser escolhida individualmente para implementação
compUnitName Especifica opcionalmente o nome da unidade de composição a ser incluída.
compUnitDescription Especifica, opcionalmente, uma descrição para a nova unidade de composição.
startingWeight Especifica, opcionalmente, o peso do início da unidade de composição.
target Especifica, opcionalmente, o destino para o qual a unidade de composição é mapeada.
activationPlan Especifica, opcionalmente, o plano de ativação para a unidade de composição.

Sintaxe

AdminBLA.addCompUnit(blaName, compUnitID, deployableUnit, compUnitName,
 compUnitDescription, startingWeight, target, activationPlan)

Exemplo de uso

AdminBLA.addCompUnit("bla1", "asset1.zip", "default", "myCompositionUnit", "cu description", "1", 
"server1", "specname=actplan1")

createEmptyBLA

Esse script cria um novo aplicativo no nível de negócios em seu ambiente. Crie um aplicativo no nível de negócios vazio e, em seguida, inclua recursos, bibliotecas compartilhadas ou aplicativos no nível de negócios como unidades de composição no aplicativo no nível de negócios vazio.

Para executar o script, especifique o argumento de nome do aplicativo no nível de negócios, conforme definido na seguinte tabela:
Tabela 2. Descrições do Argumento createEmptyBLA. Execute o script para criar um aplicativo em nível de negócios.
Argumento Descrição
blaName Especifica o nome a ser designado ao novo aplicativo no nível de negócios.
description Especifica, opcionalmente, uma descrição para o aplicativo no nível de negócios.

Sintaxe

AdminBLA.createEmptyBLA(blaName, description)

Exemplo de uso

AdminBLA.createEmptyBLA("myBLA", "bla to control transactions")

deleteAsset

Esse script remove um recurso registrado de sua configuração.

Para executar o script, especifique o argumento de ID do recurso, conforme definido na seguinte tabela:
Tabela 3. Descrição do Argumento deleteAsset. Execute o script para excluir um ativo.
Argumento Descrição
assetID Especifica o nome do recurso a ser excluído.

Sintaxe

AdminBLA.deleteAsset(assetID)

Exemplo de uso

AdminBLA.deleteAsset("asset.zip")

deleteBLA

Esse script remove um aplicativo no nível de negócios de sua configuração.

Para executar o script, especifique o argumento de nome do aplicativo no nível de negócios, conforme definido na seguinte tabela:
Tabela 4. Descrição do Argumento deleteBLA. Execute o script para excluir um aplicativo em nível de negócios.
Argumento Descrição
blaName Especifica o nome do aplicativo no nível de negócios a ser excluído.

Sintaxe

AdminBLA.deleteBLA(blaName)

Exemplo de uso

AdminBLA.deleteBLA("myBLA")

deleteCompUnit

Esse script remove uma unidade de composição de uma configuração de aplicativo no nível de negócios específica.

Para executar o script, especifique os argumentos de nome do aplicativo no nível de negócios e a unidade de composição, conforme definido na seguinte tabela:
Tabela 5. Descrições do Argumento deleteCompUnit. Execute o script para excluir uma unidade de composição de um aplicativo em nível de negócios.
Argumento Descrição
blaName Especifica o nome do aplicativo no nível de negócios de interesse.
compUnitID Especifica o identificador da unidade de composição a ser excluída.

Sintaxe

AdminBLA.deleteCompUnit(blaName, compUnitID)

Exemplo de uso

AdminBLA.deleteCompUnit("myBLA", "asset.zip")

editAsset

Esse script edita os metadados de um recurso registrado específico.

Para executar o script, especifique os argumentos definidos na seguinte tabela:
Tabela 6. Descrições do Argumento editAsset. Execute o script para alterar um ativo.
Argumento Descrição
assetID Especifica o nome do recurso a ser editado.
assetDescription Especifica, opcionalmente, a nova descrição do recurso de interesse.
assetDestinationURL Especifica, opcionalmente, a nova URL de destino do recurso de interesse.
assetTypeAspects Especifica, opcionalmente, os novos aspectos de tipo do recurso de interesse.
assetRelationships Especifica, opcionalmente, as novas configurações de relacionamento do recurso.
filePermission Especifica, opcionalmente, a nova configuração de permissão de arquivo do recurso de interesse.
validateAsset Especifica, opcionalmente, se o comando validará o recurso.

Sintaxe

AdminBLA.editAsset(assetID, assetDescription, assetDestinationURL, 
assetTypeAspects, assetRelationships, filePermission, validateAsset)

Exemplo de uso

AdminBLA.editAsset("asset1.zip", "asset for testing", "c:/installedAssets/asset1.zip", "WebSphere:spec=sharedlib", "", ".*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755", "true")

editCompUnit

Esse script edita uma unidade de composição específica em um aplicativo no nível de negócios.

Para executar o script, especifique os argumentos de nome do aplicativo no nível de negócios e o ID da unidade de composição, conforme definido na seguinte tabela:
Tabela 7. Descrições do Argumento editCompUnit. Execute o script para alterar uma unidade de composição.
Argumento Descrição
blaName Especifica o nome do aplicativo no nível de negócios ao qual a unidade de composição está associada.
compUnitID Especifica o nome da unidade de composição a ser editada.
compUnitDescription Especifica, opcionalmente, uma nova descrição para a unidade de composição.
startingWeight Especifica, opcionalmente, um novo peso de início para a unidade de composição.
target Especifica, opcionalmente, um novo destino para o qual a unidade de composição é mapeada.
activationPlan Especifica, opcionalmente, um novo plano de ativação para a unidade de composição.

Sintaxe

AdminBLA.editCompUnit(blaName, compUnitID, compUnitDescription, 
startingWeight, target, activationPlan)

Exemplo de uso

AdminBLA.editCompUnit("bla1", "asset1.zip","cu description", "1", 
"server1", "specname=actplan1")

exportAsset

Esse script exporta um recurso registrado para um arquivo no sistema.

Para executar o script, especifique os argumentos de ID de recurso e de nome do arquivo, conforme definido na seguinte tabela:
Tabela 8. Descrições do Argumento exportAsset. Execute o script para exportar um ativo.
Argumento Descrição
assetID Especifica o identificador do recurso a ser exportado.
fileName Especifica o caminho de arquivo completo para o qual o sistema exporta o recurso.

Sintaxe

AdminBLA.exportAsset(assetID, fileName)

Exemplo de uso

[Windows]
AdminBLA.exportAsset("asset.zip", "c:\temp\a.zip")
[AIX][Linux][Solaris][HP-UX][IBM i][z/OS]
AdminBLA.exportAsset("asset.zip", "/temp/a.zip")

importAsset

Esse script importa e registra um recurso em um domínio de gerenciamento em sua configuração.

Para executar o script, especifique os argumentos assetID, displayDescription e deployableUnit, conforme definido na seguinte tabela:
Tabela 9. Descrições do Argumento importAsset. Execute o script para importar um ativo.
Argumento Descrição
assetID Especifica o recurso a ser importado.
displayDescription Especifica, opcionalmente, se o script exibirá a descrição do recurso.
dispDeployableUnit Especifica, opcionalmente, se o script exibirá as unidades implementáveis do recurso a ser importado.

Sintaxe

AdminBLA.importAsset(assetID, displayDescription, dispDeployableUnit)

Exemplo de uso

AdminBLA.importAsset("asset.zip", "true", "true")

startBLA

Esse script inicia o processo aplicativo no nível de negócios em sua configuração.

Para executar o script, especifique o argumento de nome do aplicativo no nível de negócios, conforme definido na seguinte tabela:
Tabela 10. Descrição do Argumento startBLA. Execute o script para iniciar um aplicativo em nível de negócios.
Argumento Descrição
blaName Especifica o nome do aplicativo no nível de negócios a ser iniciado.

Sintaxe

AdminBLA.startBLA(blaName)

Exemplo de uso

AdminBLA.startBLA("myBLA")

stopBLA

Esse script pára o processo aplicativo no nível de negócios em sua configuração.

Para executar o script, especifique o argumento de nome do aplicativo no nível de negócios, conforme definido na seguinte tabela:
Tabela 11. Descrição do Argumento stopBLA. Execute o script para parar um aplicativo em nível de negócios.
Argumento Descrição
blaName Especifica o nome do aplicativo no nível de negócios a ser parado.

Sintaxe

AdminBLA.stopBLA(blaName)

Exemplo de uso

AdminBLA.stopBLA("myBLA")

help

Esse script exibe os procedimentos de script suportados pela biblioteca de scripts AdminBLA. Para exibir ajuda detalhada para um script específico, especifique o nome do script de interesse, conforme definido na seguinte tabela:
Tabela 12. Descrição do Argumento help. Execute o script para exibir a ajuda.
Argumento Descrição
script Especifica o nome do script de interesse.

Sintaxe

AdminBLA.help(script)

Exemplo de uso

AdminBLA.help("createEmptyBLA")

listAssets

Esse script exibe os recursos registrados em sua configuração.

Para executar o script, opte por especificar os argumentos de ID de recurso, descrição da exibição e unidades implementáveis de exibição, conforme definido na seguinte tabela:
Tabela 13. Descrições do Argumento listAssets. Execute o script para listar ativos.
Argumento Descrição
assetID Especifica, opcionalmente, o ID de grupo para o qual exibir grupos de autorização.
displayDescription Especifica, opcionalmente, se o comando exibirá uma descrição de cada recurso. Especifique true para exibir descrições.
displayDeployUnits Especifica, opcionalmente, se o comando exibirá as unidades implementáveis que estão associadas aos recursos. Especifique true para exibir as unidades implementáveis.

Sintaxe

AdminBLA.listAssets(assetID, displayDescription, displayDeployUnits)

Exemplo de uso

AdminBLA.listAssets("asset.zip", "true", "true")

listBLAs

Esse script exibe cada aplicativo ou aplicativos no nível de negócios específicos em sua configuração.

Para executar o script, opte por especificar os argumentos de nome do aplicativo no nível de negócios e a descrição de exibição, conforme definido na seguinte tabela:
Tabela 14. Descrições do Argumento listBLAs. Execute o script para listar aplicativos em nível de negócios.
Argumento Descrição
blaName Especifica, opcionalmente, o nome de um aplicativo no nível de negócios de interesse.
displayDescription Especifica, opcionalmente, se o comando exibirá uma descrição de cada aplicativo no nível de negócios. Especifique true para exibir descrições.

Sintaxe

AdminBLA.listBLAs(blaName, displayDescription)

Exemplo de uso

AdminBLA.listBLAs("", "true")

listCompUnits

Esse script exibe unidades de composição em um aplicativo no nível de negócios.

Para executar o script, especifique o argumento de nome do aplicativo no nível de negócios, conforme definido na seguinte tabela:
Tabela 15. Descrições do Argumento listCompUnits. Execute o script para listar unidades de composição.
Argumento Descrição
blaName Especifica o nome do grupo de autorização de interesse.
displayDescription Especifica, opcionalmente, se o comando exibirá uma descrição de cada unidade de composição. Especifique true para exibir descrições.

Sintaxe

AdminBLA.listCompUnits(blaName, displayDescription)

Exemplo de uso

AdminBLA.listCompUnits("myBLA", "true")

viewBLA

Esse script exibe o nome e a descrição do aplicativo de nível de negócios de seu interesse.

Para executar o script, especifique o argumento do ID de configuração do aplicativo de nível de negócios de seu interesse, conforme definido na seguinte tabela:
Tabela 16. Descrição do Argumento viewBLA. Execute o script para visualizar informações sobre um aplicativo de nível de negócios.
Argumento Descrição
blaID Especifica o ID de configuração do aplicativo de interesse em nível de negócios.

Sintaxe

AdminBLA.viewBLA(blaID)

Exemplo de uso

AdminBLA.viewBLA("bla01.zip")

viewAsset

Esse script exibe os atributos de configuração de um recurso registrado específico.

Para executar o script, especifique o argumento de ID do recurso, conforme definido na seguinte tabela:
Tabela 17. Descrição do Argumento viewAsset. Execute o script para visualizar informações sobre um ativo.
Argumento Descrição
assetID Especifica o nome do recurso de interesse.

Sintaxe

AdminBLA.viewAsset(assetID)

Exemplo de uso

AdminBLA.viewAsset("asset.zip")

viewCompUnit

Esse script exibe os atributos de configuração de uma unidade de composição específica em um aplicativo no nível de negócios.

Para executar o script, especifique os argumentos de aplicativo no nível de negócios e ID da unidade de composição, conforme definido na seguinte tabela:
Tabela 18. Descrições do Argumento viewCompUnit. Execute o script para visualizar informações sobre uma unidade de composição.
Argumento Descrição
blaName Especifica o nome do aplicativo no nível de negócios de interesse.
compUnitID Especifica o identificador da unidade de composição de interesse.

Sintaxe

AdminBLA.viewCompUnit(blaName, compUnitID)

Exemplo de uso

AdminBLA.viewCompUnit("myBLA", "asset.zip")

Í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_7libbla
Nome do arquivo: rxml_7libbla.html