Comandos para o Objeto AdminConfig Utilizando Programação de Script Wsadmin

Use o objeto AdminConfig para chamar comandos de configuração e criar ou alterar elementos da configuração do WebSphere Application Server, por exemplo, criando uma origem de dados.

É possível iniciar o cliente de script sem um servidor em execução, se quiser utilizar somente operações locais. Para executar no modo local, utilize a opção -conntype NONE para iniciar o cliente de script. Você recebe uma mensagem de que está executando no modo local. Se um servidor estiver no momento executando, não execute a ferramenta AdminConfig no modo local. Mudanças na configuração que são feitas no modo local não são refletidas na configuração do servidor em execução. Se você salvar uma configuração conflitante, pode corromper a configuração.

Em um ambiente de gerenciador de implementação, as atualizações de configuração estão disponíveis apenas se um cliente de script estiver conectado a um gerenciador de implementação.

Quando conectado a um agente de nó ou a um servidor de aplicativos gerenciado, você não poderá atualizar a configuração porque a configuração desses processos do servidor são cópias da configuração principal que está localizada no gerenciador de implementação. As cópias são criadas em uma máquina de nó quando uma sincronização da configuração ocorre entre o gerenciador de implementação e o agente do nó. Faça alterações na configuração dos processos do servidor conectando um cliente de script a um gerenciador de implementação. Por esse motivo, para alterar uma configuração, não execute um cliente de definição de script em modo local em uma máquina de nó. Essa configuração não é suportada.

Configurações suportadas Configurações suportadas: É possível usar a lista Jython ou a sintaxe de sequência para transmitir parâmetros para um comando wsadmin. Se tiver um parâmetro que inclui uma vírgula como um caractere, entretanto, será necessário usar a sintaxe de sequência Jython para transmitir os parâmetros.
Para usar o comando create, por exemplo, você poderá inserir o comando semelhante ao seguinte:
params='[[name name1] [nameInNameSpace nameSpace_Name] [string_to_bind "value, withComma"]]' 
AdminConfig.create(type, parent, params)
Também é possível usar o comando modify:
AdminConfig.modify(type, params)
sptcfg

attributes

Utilize o comando attributes para retornar uma lista dos atributos de nível superior para um determinado tipo.

Objeto de Destino

Nenhuma.

Parâmetros Obrigatórios

object type
Especifica o nome do tipo de objeto que é baseado nos arquivos de configuração XML. O tipo de objeto não tem que ter o mesmo nome exibido pelo console administrativo.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

"properties Property*" "serverSecurity ServerSecurity" 
"server Server@" "id Long" "stateManagement StateManageable" 
"name String" "moduleVisibility EEnumLiteral(MODULE, 
COMPATIBILITY, SERVER, APPLICATION)" "services Service*" 
"statisticsProvider StatisticsProvider" 

Exemplos

  • Utilizando Jacl:
    $AdminConfig attributes ApplicationServer
  • Utilizando Jython:
    print AdminConfig.attributes('ApplicationServer')

checkin

Utilize o comando checkin para verificar um arquivo no repositório de configuração que é descrito pelo URI (Identificador Uniforme de Recursos) do documento. Esse método aplica-se somente às configurações do gerenciador de implementação.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

URI
O URI do documento está relacionado à raiz do repositório de configuração, por exemplo:
  • [AIX Solaris HP-UX Linux Windows]app_server_root\config
  • [IBM i]/WebSphere/AppServer/config
  • [z/OS]\WebSphere\AppServer\config
file name
Especifica o nome do arquivo de origem a ser verificado.
opaque object
Especifica um objeto que o comando extract do objeto AdminConfig retorna por uma chamada anterior.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

"properties Property*" "serverSecurity ServerSecurity" 
"server Server@" "id Long" "stateManagement StateManageable" 
"name String" "moduleVisibility EEnumLiteral(MODULE, 
COMPATIBILITY, SERVER, APPLICATION)" "services Service*" 
"statisticsProvider StatisticsProvider" 

Exemplos

  • Utilizando Jacl:
    [AIX][HP-UX][IBM i][Linux][Solaris]
    $AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml /mydir/myfile $obj
    [Windows]
    $AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml c:\\mydir\myfile $obj
    [z/OS]
    $AdminConfig checkin cells/MyCell/Node/MyNode/serverindex.xml \mydir\myfile $obj
  • Utilizando Jython:
    [AIX][HP-UX][IBM i][Linux][Solaris]
    print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', '/mydir/myfile',  obj)
    [Windows]
    print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', 'c:\mydir\myfile',  obj)
    [z/OS]
    print AdminConfig.checkin('cells/MyCell/Node/MyNode/serverindex.xml', '\mydir\myfile',  obj)

convertToCluster

Utilize o comando convertToCluster para converter um servidor para que seja o primeiro membro de um novo cluster de servidores.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

server ID
O ID de configuração do servidor de interesse.
cluster name
Especifica o nome do cluster de interesse.

Parâmetros Opcionais

Nenhum.

Saída de amostra

myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)

Exemplos

  • Utilizando Jacl:
    set serverid [$AdminConfig getid /Server:myServer/]
    $AdminConfig convertToCluster $serverid myCluster
  • Utilizando Jython:
    serverid = AdminConfig.getid('/Server:myServer/')
    print AdminConfig.convertToCluster(serverid, 'myCluster')

criar

Utilize o comando create para criar objetos de configuração.

Objeto de destino

Nenhuma.

Parâmetros Necessários

tipo
Especifica o nome do tipo de objeto que é baseado nos arquivos de configuração XML. Esse valor de parâmetro não precisar ter o mesmo nome que o console administrativo exibe.
ID-pai
Especifica o ID de configuração do objeto-pai.
attributes
Especifica quaisquer atributos a serem incluídos no ID de configuração.

Parâmetros Opcionais

Nenhuma.

Saída de Amostra

Esse comando retorna uma cadeia do nome do objeto de configuração, como esta saída de amostra exibe:
ds1(cells/mycell/nodes/DefaultNode/servers/server1|resources.xml#DataSource_6)

Exemplos

  • Utilizando Jacl:
    set jdbc1 [$AdminConfig getid /JDBCProvider:jdbc1/]
    $AdminConfig create DataSource $jdbc1 {{name ds1}}
  • Utilizando atributos da cadeia Jython:
    jdbc1 = AdminConfig.getid('/JDBCProvider:jdbc1/')
    print AdminConfig.create('DataSource', jdbc1, '[[name ds1]]')
  • Utilizando Jython com atributos object:
    jdbc1 = AdminConfig.getid('/JDBCProvider:jdbc1/')
    print AdminConfig.create('DataSource', jdbc1, [['name', 'ds1']])
  • Use o exemplo a seguir para criar uma porta:
    #replace server1 with your server name                                       
    serverName = 'server1'                                                       
                                                                                 
    #replace smtitant24Node03 with your node name                                
    node = AdminConfig.getid('/Node:smtitan24Node03')                            
    #print node                                                                  
    serverEntries = AdminConfig.list('ServerEntry',                              
    node).split(java.lang.System.getProperty('line.separator'))                  
                                                                                 
    for serverEntry in serverEntries:                                            
      sName = AdminConfig.showAttribute(serverEntry, "serverName")               
      if sName == serverName:                                                    
        #print serverEntry                                                       
        #replace OVERLAY_TEST with the value you want for your endPointName      
        id = AdminConfig.create('NamedEndPoint', serverEntry,                    
    '[[endPointName "OVERLAY_TEST"]]')                                           
        #print id                                                                
        start = id.find('#')                                                     
        #print start                                                             
        end = id.find(')',start)                                                 
        #print end                                                               
        str = id[start:end]                                                      
        server = id[0:start]                                                     
        #print server                                                            
        #print str                                                               
        #replace 8888 with the value you want for your port                      
        AdminConfig.create('EndPoint', server+str+')', '[[port "8888"] [host     
    "*"]]')                                                                      
        AdminConfig.save()                                                       
        #AdminConfig.reset() 

createClusterMember

Utilize o comando createClusterMember para criar um novo objeto de servidor no nó que o parâmetro node id especifica. Esse servidor é criado como um novo membro do cluster existente especificado pelo parâmetro cluster id e contém atributos especificados no parâmetro member attributes. O servidor é criado por meio do modelo do servidor especificado pelo atributo template id e contém o nome especificado pelo atributo memberName. O atributo memberName é obrigatório. As opções de gabaritos estão disponíveis apenas para o primeiro membro de cluster que criar. Todos os membros de cluster criados após o primeiro membro serão idênticos.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

cluster ID
Especifica o ID da configuração do cluster de interesse.
node ID
Especifica o ID da configuração do nó de interesse.
template ID
Especifica o ID de modelo a ser utilizado para criar o servidor.
member attributes
Especifica quaisquer atributos a serem incluídos no membro de cluster. O atributo memberName é necessário e define o nome do membro de cluster a ser criado.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

Esse comando retorna o ID da configuração do membro de cluster recém-criado, como exibe o exemplo a seguir:
myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)

Exemplos

  • Utilizando Jacl:
    set clid [$AdminConfig getid /ServerCluster:myCluster/]
    set nodeid [$AdminConfig getid /Node:mynode/]
    $AdminConfig createClusterMember $clid $nodeid {{memberName newMem1} {weight 5}}
  • Utilizando atributos da cadeia Jython:
    clid = AdminConfig.getid('/ServerCluster:myCluster/') 
    nodeid = AdminConfig.getid('/Node:mynode/')
    print AdminConfig.createClusterMember(clid, nodeid, '[[memberName newMem1] [weight 5]]')
  • Utilizando Jython com atributos object:
    clid = AdminConfig.getid('/ServerCluster:myCluster/') 
    nodeid = AdminConfig.getid('/Node:mynode/') 
    print AdminConfig.createClusterMember(clid, nodeid, [['memberName', 'newMem1'], ['weight', 5]])

createDocument

Utilize o comando createDocument para criar um novo documento no repositório de configuração.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

document URI
Especifica o nome do documento a ser criado no repositório.
file name
Especifica um nome de arquivo local válido do documento a ser criado.

Parâmetros Opcionais

Nenhum.

Exemplos

  • Utilizando Jacl:
    [AIX][HP-UX][IBM i][Linux][Solaris]
    $AdminConfig createDocument cells/mycell/myfile.xml /mydir/myfile
    [Windows]
    $AdminConfig createDocument cells/mycell/myfile.xml c:/mydir/myfile
    [z/OS]
    $AdminConfig createDocument cells/mycell/myfile.xml /mydir/myfile
  • Utilizando Jython com atributos string:
    [AIX Solaris HP-UX Linux Windows]
    AdminConfig.createDocument('cells/mycell/myfile.xml', 'c:/mydir/myfile')
    [IBM i]
    AdminConfig.createDocument('cells/mycell/myfile.xml', '/mydir/myfile')
    [z/OS]
    AdminConfig.createDocument('cells/mycell/myfile.xml', '/mydir/myfile')

createUsingTemplate

Utilize o comando createUsingTemplate para criar um tipo de objeto com o pai fornecido, utilizando um modelo. Você pode utilizar este comando para criação de um servidor com o tipo APPLICATION_SERVER. Se desejar criar um servidor com um tipo que não seja APPLICATION_SERVER, utilize o comando createGenericServer ou createWebServer.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

tipo
Especifica o tipo de objeto a ser criado.
parent
Especifica o ID de configuração do pai.
template
Especifica um ID de configuração de um objeto existente. Esse objeto pode ser um objeto de modelo retornado utilizando o comando listTemplates ou qualquer outro objeto existente do tipo correto.

Parâmetros Opcionais

Atributos
Especifica os valores de atributo para o objeto. Os atributos especificados utilizando esse parâmetro substituem as configurações no modelo.

Saída de Amostra

O comando retorna o ID da configuração do novo objeto, como exibe o exemplo a seguir:
myCluster(cells/mycell/clusters/myCluster|cluster.xml#ClusterMember_2)

Exemplos

  • Utilizando Jacl:
    set node [$AdminConfig getid /Node:mynode/]
    set templ [$AdminConfig listTemplates JDBCProvider "DB2 JDBC Provider (XA)"]
    $AdminConfig createUsingTemplate JDBCProvider $node {{name newdriver}} $templ 
  • Utilizando Jython com atributos string:
    node = AdminConfig.getid('/Node:mynode/')
    templ = AdminConfig.listTemplates('JDBCProvider', "DB2 JDBC Provider (XA)")
    print AdminConfig.createUsingTemplate('JDBCProvider', node, '[[name newdriver]]', templ)
  • Utilizando Jython com atributos object:
    node = AdminConfig.getid('/Node:mynode/')
    templ = AdminConfig.listTemplates('JDBCProvider', "DB2 JDBC Provider (XA)")
    print AdminConfig.createUsingTemplate('JDBCProvider', node, [['name', 'newdriver']], templ)

defaults

Utilize o comando defaults para exibir os valores padrão para os atributos de um determinado tipo. Esse método exibe todos os possíveis atributos contidos por um objeto de um tipo específico. Se o atributo tiver um valor padrão, esse método também exibirá o tipo e o valor padrão para cada atributo.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

tipo
Especifica o tipo de objeto a ser retornado. O nome do tipo de objeto especificado é baseado nos arquivos de configuração XML. O nome não precisa ser o mesmo nome que o console administrativo exibe.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retorna uma cadeia que contém uma lista de atributos com seu tipo e valor, como exibe o exemplo a seguir:
Attribute               Type   	 Default

usingMultiRowSchema             Booleano                        false
maxInMemorySessionCount         Inteiro                         1000
allowOverflow                   Booleano                        true
scheduleInvalidation            Booleano                        false
writeFrequency                  ENUM
writeInterval                   Inteiro                         120
writeContents                   ENUM
invalidationTimeout             Inteiro                         30
invalidationSchedule            InvalidationSchedule

Exemplos

  • Utilizando Jacl:
    $AdminConfig defaults TuningParams
  • Utilizando Jython:
    print AdminConfig.defaults('TuningParams')

deleteDocument

Utilize o comando deleteDocument para excluir um documento do repositório de configuração.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

documentURI
Especifica o documento a ser excluído do repositório.

Parâmetros Opcionais

Nenhum.

Exemplos

  • Utilizando Jacl:
    $AdminConfig deleteDocument cells/mycell/myfile.xml
  • Utilizando Jython:
    AdminConfig.deleteDocument('cells/mycell/myfile.xml')

existsDocument

Utilize o comando existsDocument para testar a existência de um documento no repositório de configuração.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

documentURI
Especifica o documento a ser testado no repositório.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retornará um valor true se o documento existir, como exibe o exemplo a seguir:
1

Exemplos

  • Utilizando Jacl:
    $AdminConfig existsDocument cells/mycell/myfile.xml
  • Utilizando Jython:
    print AdminConfig.existsDocument('cells/mycell/myfile.xml')

extract

Utilize o comando extract para extrair um arquivo do repositório de configuração descrito pelo URI do documento e o coloca no arquivo denominado por filename. Esse método aplica-se somente às configurações do gerenciador de implementação.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

documentURI
Especifica o documento a ser extraído do repositório de configuração. O URI do documento deve existir no repositório. O URI do documento está relacionado à raiz do repositório de configuração, por exemplo:
  • [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]/WebSphere/AppServer/config
  • [Windows]app_server_root\config
filename
Especifica o nome do arquivo para o qual extrair o documento. O parâmetro filename deve ser um nome de arquivo local válido onde existe o conteúdo do documento. Se o arquivo especificado pelo parâmetro filename existir, o arquivo extraído o substituirá.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retorna um objeto "digest" opaco que deve ser utilizado para verificar o arquivo novamente, utilizando o comando checkin.

Exemplos

  • Utilizando Jacl:
    [AIX][HP-UX][IBM i][Linux][Solaris]
    set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml /mydir/myfile] 
    [Windows]
    set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml c:\\mydir\myfile] 
    [z/OS]
    set obj [$AdminConfig extract cells/MyCell/nodes/MyNode/serverindex.xml \mydir\myfile] 
  • Utilizando Jython:
    [AIX][HP-UX][IBM i][Linux][Solaris]
    obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','/mydir/myfile')
    [Windows]
    obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml',  'c:\mydir\myfile')
    [z/OS]
    obj = AdminConfig.extract('cells/MyCell/nodes/MyNode/serverindex.xml','\mydir\myfile')

getCrossDocumentValidationEnabled

Utilize o comando getCrossDocumentValidationEnabled para retornar uma mensagem com a configuração de ativação de documento cruzado atual. Esse método retorna true se a validação entre documentos estiver ativada.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

Nenhuma.

Saída de Amostra

O comando retorna uma cadeia que contém a mensagem com a definição de validação entre documentos, como exibe o exemplo a seguir:
WASX7188I: Ativação da validação entre documentos definida para true

Exemplos

  • Utilizando Jacl:
    $AdminConfig getCrossDocumentValidationEnabled
  • Utilizando Jython:
    print AdminConfig.getCrossDocumentValidationEnabled()

getid

Utilize o comando getid para retornar o ID de configuração de um objeto.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

caminho de contenção
Especifica o caminho de conteúdo de interesse.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retorna o ID da configuração para um objeto descrito pelo caminho de conteúdo, como exibe o exemplo a seguir:
Db2JdbcDriver(cells/testcell/nodes/testnode|resources.xml#JDBCProvider_1)

Exemplos

  • Utilizando Jacl:
    $AdminConfig getid /Cell:testcell/Node:testNode/JDBCProvider:Db2JdbcDriver/
  • Utilizando Jython:
    print AdminConfig.getid('/Cell:testcell/Node:testNode/JDBCProvider:Db2JdbcDriver/')

getObjectName

Utilize o comando getObjectName para retornar uma versão de cadeia do nome do objeto para o MBean correspondente em execução. Esse método retorna uma cadeia vazia se não existir nenhum MBean correspondente em execução.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

configuration ID
Especifica o ID de configuração do nome do objeto a ser retornado.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retorna uma cadeia que contém o nome do objeto, como exibe o exemplo a seguir:
WebSphere:cell=mycell,name=server1,mbeanIdentifier=cells/mycell/nodes/mynode/servers/server1/
server.xml#Server_1,type=Server,node=mynode,process=server1,processType=UnManagedProcess

Exemplos

  • Utilizando Jacl:
    set server [$AdminConfig getid /Node:mynode/Server:server1/]
    $AdminConfig getObjectName $server
  • Utilizando Jython:
    server = AdminConfig.getid('/Node:mynode/Server:server1/')
    print AdminConfig.getObjectName(server)

getObjectType

Utilize o comando getObjectType para exibir o tipo de objeto para o ID de configuração do objeto de interesse.

Objeto de destino

Nenhum.

Parâmetros Necessários

configuration ID
Especifica o ID de configuração do nome do objeto a ser retornado.

Parâmetros Opcionais

Nenhuma.

Exemplos

  • Utilizando Jacl:
    set server [$AdminConfig getid /Node:mynode/Server:server1/]
    $AdminConfig getObjectType $server
  • Utilizando Jython:
    server = AdminConfig.getid('/Node:mynode/Server:server1/')
    print AdminConfig.getObjectType(server)

getSaveMode

Utilize o comando getSaveMode para retornar o modo que é utilizado quando você chama um comando save. O comando retorna um dos seguintes valores possíveis:
  • overwriteOnConflict - Salva alterações mesmo que estejam em conflito com outras alterações da configuração
  • rollbackOnConflict - Faz com que uma operação save falhe se as alterações estiverem em conflito com outras alterações na configuração. Este valor é o padrão.

Objeto de Destino

Nenhuma.

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retorna uma cadeia que contém a configuração atual do modo salvar, como exibe o exemplo a seguir:
rollbackOnConflict

Exemplos

  • Utilizando Jacl:
    $AdminConfig getSaveMode
  • Utilizando Jython:
    print AdminConfig.getSaveMode()

getValidationLevel

Utilize o comando getValidationLevel para retornar a validação utilizada quando os arquivos são extraídos do repositório.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

Nenhuma.

Saída de Amostra

O comando retorna uma cadeia que contém o nível de validação, como exibe o exemplo a seguir:
WASX7189I: Nível de validação definido para HIGH

Exemplos

  • Utilizando Jacl:
    $AdminConfig getValidationLevel
  • Utilizando Jython:
    print AdminConfig.getValidationLevel()

getValidationSeverityResult

Utilize o comando getValidationSeverityResult para retornar o número de mensagens de validação com a gravidade específica da validação mais recente.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

gravidade
Especifica qual o nível de gravidade para o qual retornar o número de mensagens de validação. Especifique um valor inteiro entre 0 e 9.

Parâmetros Opcionais

Nenhuma.

Saída de Amostra

O comando retorna uma cadeia que indica o número de mensagens de validação da gravidade específica, como exibe o exemplo a seguir:
16

Exemplos

  • Utilizando Jacl:
    $AdminConfig getValidationSeverityResult 1
  • Utilizando Jython:
    print AdminConfig.getValidationSeverityResult(1)

hasChanges

Utilize o comando hasChanges para determinar se existem alterações na configuração não salvas.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retornará 1 se existirem alterações na configuração não salvas ou 0 se elas não existirem, como exibe o exemplo a seguir:
1

Exemplos

  • Utilizando Jacl:
    $AdminConfig hasChanges
  • Utilizando Jython:
    print AdminConfig.hasChanges()

ajuda

Utilize o comando help para exibir informações estáticas de ajuda para o objeto AdminConfig.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retorna uma lista de opções para o comando help, como exibe o exemplo a seguir:
WASX7053I: O objeto AdminConfig se comunica com o serviço de configuração em um produto para manipular 
dados de configuração para uma instalação de Servidor de Aplicativos.  O objeto AdminConfig tem comandos para listar, 
criar, remover, exibir e modificar dados da configuração, assim como comandos para exibir informações sobre os tipos de dados de configuração.

A maioria dos comandos suportados pelo objeto AdminConfig opera de dois modos: O modo padrão é um no qual 
o objeto AdminConfig se comunica com o Servidor de Aplicativos para realizar suas tarefas. Um modo local também é 
possível, em que nenhuma comunicação de servidor ocorre.  O modo local de operação é chamado ativando 
o cliente de script sem um servidor conectado usando a opção da linha de comandos "-conntype NONE" ou configurando a 
propriedade "com.ibm.ws.scripting.connectionType=NONE" no arquivo wsadmin.properties.

Os comandos a seguir são suportados pelo objeto AdminConfig; informações mais detalhadas sobre cada um desses comando são 
disponibilizadas utilizando o comando help do objeto AdminConfig e fornecendo o nome do comando como um argumento.

attributes      Mostra os atributos de um determinado tipo
checkin         Registra a entrada de um arquivo no repositório de configuração.
convertToCluster									Converte um servidor para que seja o primeiro membro de um novo cluster de servidores
create          									Cria um objeto de configuração, especificando um tipo, um pai, uma lista de atributos e, 
																opcionalmente, um nome de atributo para o novo objeto
createClusterMember 							Cria um novo servidor que é um membro de um cluster existente.
createDocument  Cria um novo documento no repositório de configuração.
installResourceAdapter							Instala um adaptador de recursos J2C com o nome do arquivo RAR fornecido e uma cadeia de opções
no nó.
createUsingTemplate 							Cria um objeto utilizando um tipo de modelo específico.
defaults        Exibe os valores padrão para os atributos de um determinado tipo.
deleteDocument  Exclui um documento do repositório de configuração.
existsDocument  Testa a existência de um documento no repositório de configuração.
extract         Extrai um arquivo do repositório de configuração.
getCrossDocumentValidationEnabled		Retornará true se a validação entre documentos estiver ativada.
getid           									Mostra o ID da configuração de um objeto, fornecendo uma versão de cadeia de sua retenção
getObjectName   Fornecido um ID da configuração, retorna uma versão de cadeia do ObjectName 
																para o MBean em execução correspondente, se houver um.
getSaveMode     Retorna o modo utilizado quando "save" é chamado
getValidationLevel								Retorna a validação utilizada quando os arquivos são extraídos do repositório.
getValidationSeverityResult				Retorna o número de mensagens com a gravidade específica da validação mais recente.
hasChanges      Retorna true se existirem alterações da configuração que não foram salvas
help            Mostra informações da ajuda
list            Lista todos os objetos de configuração de um determinado tipo
listTemplates   									Lista todos os modelos de configuração disponíveis de um determinado tipo.
modify          Altera atributos especificados de um determinado objeto de configuração
parents         Mostra os objetos que contêm um determinado tipo
queryChanges    Retorna uma lista de arquivos que não foram salvos
remove          Remove o objeto de configuração especificado
required        Exibe os atributos obrigatórios de um determinado tipo.
reset           Descarta as alterações da configuração que não foram salvas
save            Consolida as alterações que não foram salvas no repositório de configuração
setCrossDocumentValidationEnabled		Configura o modo ativado de validação entre documentos.
setSaveMode     Altera o modo utilizado quando "save" é chamado
setValidationLevel								Configura a validação utilizada quando os arquivos são extraídos do repositório.
show            Mostra os atributos de um determinado objeto de configuração
showall         Mostra recursivamente os atributos de um determinado objeto de configuração
                									e todos os objetos contidos em cada atributo.
showAttribute   Exibe somente o valor para o único atributo especificado.
types           Mostra os possíveis tipos de configuração
validate        Chama a validação

Exemplos

  • Utilizando Jacl:
    $AdminConfig help
  • Utilizando Jython:
    print AdminConfig.help()

installResourceAdapter

Utilize o comando installResourceAdapter para instalar um adaptador de recursos J2C (Java 2 Connector) com o nome do arquivo RAR (Resource Adapter Archive) fornecido e uma cadeia de opções no nó. Quando você edita o aplicativo instalado com o RAR incorporado, apenas objetos J2C connection factory, J2C activation specs, e J2C administrative serão editados. Nenhum objeto J2C novo será criado.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Especifica o nó de interesse.
RAR file name
Especifica o nome completo do arquivo RAR que reside no nó especificado.

Parâmetros Opcionais

opções
Especifica opções adicionais para instalar um adaptador de recursos. As opções válidas incluem as seguintes opções:
  • rar.name
  • rar.desc
  • rar.archivePath
  • rar.classpath
  • rar.nativePath
  • rar.threadPoolAlias
  • rar.propertiesSet
A opção rar.name é o nome do adaptador de recursos J2C. Se essa opção não for especificada, o nome de exibição no descritor de implementação RAR será utilizado. Se esse nome não for especificado, o nome do arquivo RAR será utilizado. A opção rar.desc é uma descrição do J2CResourceAdapter.

O rar.archivePath é o nome do caminho onde o arquivo é extraído. Se essa opção não for especificada, o archive será extraído para o diretório $\{CONNECTOR_INSTALL_ROOT\}. A opção rar.classpath é o caminho de classe adicional.

rar.propertiesSet é construído com o seguinte:
name String
value String
type String
*desc String
*required true/false 
* significa que o item é opcional
Cada atributo da propriedade é especificado em um conjunto de {}. Uma propriedade é especificada em um conjunto de {}. É possível especificar várias propriedades em {}.

Saída de Amostra

O comando retorna o ID da configuração do novo objeto J2CResourceAdapter:
myResourceAdapter(cells/mycell/nodes/mynode|resources.xml#J2CResourceAdapter_1)

Exemplos

  • Utilizando Jacl:
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    $AdminConfig installResourceAdapter /rar/mine.rar mynode{-rar.name myResourceAdapter 
    -rar.desc "My rar file"} 
    [Windows]
    $AdminConfig installResourceAdapter c:/rar/mine.rar mynode {-rar.name myResourceAdapter 
    -rar.desc "My rar file"}
  • Utilizando Jython:
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    print AdminConfig.installResourceAdapter('/rar/mine.rar', 'mynode', '[-rar.name myResourceAdapter 
    -rar.desc "My rar file"]')
    [Windows]
    print AdminConfig.installResourceAdapter('c:/rar/mine.rar', 'mynode', '[-rar.name myResourceAdapter 
    -rar.desc "My rar file"]') 
Para incluir uma Cadeia
resourceProperties (name=myName,value=myVal)
na configuração do adaptador de recursos, execute os seguintes comandos:
  1. pSet = [['propertySet',[['resourceProperties',[[['name','myName'], ['type', 'String'], ['value','myVal']]]]]]]
  2. [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    myRA =AdminConfig.installResourceAdapter('/query.rar','mynodeCellManager05',
    ['-rar.desc','mydesc'])
    [Windows]
    myRA =AdminConfig.installResourceAdapter('c:\query.rar','mynodeCellManager05',
    ['-rar.desc','mydesc'])
  3. AdminConfig.modify(myRA,pSet)

list

Utilize o comando list para retornar uma lista de objeto de um determinado tipo, possivelmente com escopo definido por um pai. É possível utilizar caracteres curinga (*) ou expressões comuns Java (.*) na sintaxe de comando para customizar a consulta de procura.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

object type
Especifica o nome do tipo de objeto. O nome do tipo de objeto é baseado nos arquivos de configuração XML e não tem de ser o mesmo nome exibido pelo console administrativo.
pattern
Especifica informações de consulta de procura adicionais usando caracteres curingas ou expressões regulares Java.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retorna uma lista de objetos:
Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xml#JDBCProvider_1) 
Db2JdbcDriver(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#JDBCProvider_1) 
Db2JdbcDriver(cells/mycell/nodes/DefaultNode/servers/nodeAgent|resources.xml#JDBCProvider_1) 

Exemplos

Os exemplos a seguir listam cada objeto de configuração de provedor JDBC:
  • Utilizando Jacl:
    $AdminConfig list JDBCProvider
  • Utilizando Jython:
    print AdminConfig.list('JDBCProvider')
Os exemplos a seguir listam cada objeto de configuração de provedor JDBC que começa com a cadeia derby:
  • Utilizando Jacl:
    $AdminConfig list JDBCProvider derby*
  • Utilizando Jython:
    print AdminConfig.list('JDBCProvider', 'derby*')

É possível utilizar padrões de expressão Java comuns e padrões de curinga para especificar o nome do comando para a lista $AdminConfig, tipos e funções listTemplates.

Os exemplos a seguir listam os objetos de configuração do tipo server começando em server1:
  • Utilizando os padrões de expressão comum Jacl e Java:
    $AdminConfig list Server server1.*
  • Utilizando os padrões Jacl e de curinga:
    $AdminConfig list Server server1*
  • Utilizando os padrões Jython e de expressão comum Java::
    print AdminConfig.list("Server", "server1.*")
  • Utilizando os padrões Jython e curinga:
    print AdminConfig.list("Server", "server1*")
Os exemplos a seguir listam cada objeto de configuração desses inícios com SSLConfig:
  • Utilizando os padrões de expressão comum Jacl e Java:
    $AdminConfig types SSLConfig.*
  • Utilizando os padrões Jacl e de curinga:
    $AdminConfig types SSLConfig*
  • Utilizando os padrões Jython e de expressão comum Java:
    print AdminConfig.types("SSLConfig.*")
  • Utilizando os padrões Jython e curinga:
    print AdminConfig.types("SSLConfig*")

listTemplates

Utilize o comando listTemplates para exibir uma lista de IDs de objetos do modelo. É possível utilizar caracteres curinga (*) ou expressões comuns Java (.*) na sintaxe de comando para customizar a consulta de procura.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

object type
Especifica o nome do tipo de objeto. O nome do tipo de objeto é baseado nos arquivos de configuração XML e não tem de ser o mesmo nome exibido pelo console administrativo.
pattern
Especifica informações de consulta de procura adicionais usando caracteres curingas ou expressões regulares Java.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O exemplo exibe uma lista de todos os modelos JDBCProvider disponíveis no sistema:
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/defaultZOS|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/servertypes/APPLICATION_SERVER/servers/default|resources.xml#builtin_jdbcprovider)"
"Derby JDBC Provider (XA)(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_4)"
"Derby JDBC Provider 40 (XA)(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_2)"
"Derby JDBC Provider 40 Only (XA)(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_2)"
"Derby JDBC Provider 40 Only(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_1)"
"Derby JDBC Provider 40(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_Derby_1)"
"Derby JDBC Provider Only (XA)(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_4)"
"Derby JDBC Provider Only(templates/system|jdbc-resource-provider-only-templates.xml#JDBCProvider_derby_3)"
"Derby JDBC Provider(templates/servertypes/APPLICATION_SERVER/servers/DeveloperServer|resources.xml#JDBCProvider_1124467079638)"
"Derby JDBC Provider(templates/system|jdbc-resource-provider-templates.xml#JDBCProvider_derby_3)" 

Exemplos

Os exemplos a seguir retornam cada modelo do provedor JDBC:
  • Utilizando Jacl:
    $AdminConfig listTemplates JDBCProvider
  • Utilizando Jython:
    print AdminConfig.listTemplates('JDBCProvider')
Os exemplos a seguir retornam cada modelo do provedor JDBC que começa com a cadeia sybase:
  • Utilizando Jacl:
    $AdminConfig listTemplates JDBCProvider sybase*
  • Utilizando Jython:
    print AdminConfig.listTemplates('JDBCProvider', 'sybase*')

modify

Utilize o comando modify para suportar a modificação de atributos do objeto.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

configuration ID
Especifica o ID de configuração do objeto a ser modificado.
Atributos
Especifica os atributos a serem modificados para o ID de configuração de interesse.

Parâmetros Opcionais

Nenhum.

Exemplos

  • Utilizando Jacl:
    $AdminConfig modify ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
    GenericJMSConnectionFactory_1) {{userID newID} {password newPW}}
  • Utilizando Jython com atributos string:
    AdminConfig.modify('ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
    GenericJMSConnectionFactory_1)', '[[userID newID] [password newPW]]')
  • Utilizando Jython com atributos object:
    AdminConfig.modify('ConnFactory1(cells/mycell/nodes/DefaultNode/servers/deploymentmgr|resources.xml#
    GenericJMSConnectionFactory_1)', [['userID', 'newID'], ['password', 'newPW']])

parents

Utilize o comando parents para obter informações sobre tipos de objetos.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

object type
Especifica o tipo de objeto de interesse. O nome do tipo de objeto é baseado nos arquivos de configuração XML e não tem de ser o mesmo nome exibido pelo console administrativo.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O exemplo exibe uma lista de tipos de objetos:
Célula
Nó
Servidor

Exemplos

  • Utilizando Jacl:
    $AdminConfig parents JDBCProvider
  • Utilizando Jython:
    print AdminConfig.parents('JDBCProvider')

queryChanges

Utilize o comando queryChanges para retornar uma lista de arquivos de configuração não salvos.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O exemplo exibe uma cadeia que contém uma lista de arquivos com alterações não salvas:
WASX7146I: Os seguintes arquivos de configuração contêm alterações não salvas:
cells/mycell/nodes/mynode/servers/server1|resources.xml

Exemplos

  • Utilizando Jacl:
    $AdminConfig queryChanges
  • Utilizando Jython:
    print AdminConfig.queryChanges()

remover

Utilize o comando remove para remover um objeto de configuração.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

configuration ID
Especifica o objeto de configuração de interesse.

Parâmetros Opcionais

Nenhum.

Exemplos

  • Utilizando Jacl:
    set ds [$AdminConfig list DataSource "Default Datasource*"]
    $AdminConfig remove $ds
  • Utilizando Jython:
    ds = AdminConfig.list('DataSource', 'Default Datasource*')
    AdminConfig.remove(ds)

obrigatório

Utilize o comando required para exibir os atributos requeridos contidos por um objeto de um determinado tipo.

Objeto de destino

Nenhuma.

Parâmetros Obrigatórios

tipo
Especifica o tipo de objeto para o qual exibir os atributos necessários. O nome do tipo de objeto é baseado nos arquivos de configuração XML. Não precisa ser o mesmo nome que o console administrativo exibe.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O exemplo exibe uma cadeia que contém uma lista de atributos requeridos com seu tipo:
Attribute                       Type
streamHandlerClassName   String
protocol                        String

Exemplos

  • Utilizando Jacl:
    $AdminConfig required URLProvider
  • Utilizando Jython:
    print AdminConfig.required('URLProvider')

reset

Utilize o comando reset para reconfigurar o espaço de trabalho temporário que contém atualizações para a configuração.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

Nenhum.

Exemplos

  • Utilizando Jacl:
    $AdminConfig reset
  • Utilizando Jython:
    AdminConfig.reset()

resetAttributes

Utilize o comando resetAttributes para reconfigurar os atributos específicos para o objeto de configuração de interesse.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

configuration ID
Especifica o ID de configuração do objeto de configuração de interesse.
Atributos
Especifica o atributo a ser reconfigurado e o valor para o qual o atributo é reconfigurado.

Parâmetros Opcionais

Nenhum.

Exemplos

  • Utilizando Jacl:
    set ds [$AdminConfig list DataSource "Default Datasource*"]
    $AdminConfig resetAttributes $ds {{"description" "A new description for the data source"}}
  • Utilizando Jython:
    ds = AdminConfig.list('DataSource', 'Default Datasource*')
    AdminConfig.resetAttributes(ds, [["description", "A new description for the data source"]])

save

Utilize o comando save para salvar alterações no repositório de configuração.

Objeto de Destino

Nenhum.

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando save não retorna saída.

Exemplos

  • Utilizando Jacl:
    $AdminConfig save
  • Utilizando Jython:
    AdminConfig.save()

setCrossDocumentValidationEnabled

Utilize o comando setCrossDocumentValidationEnabled para configurar o modo ativado de validação entre documentos. Os valores incluem true ou false.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

sinalizador
Especifica se a validação entre documentos está ativada ou desativada. Especifique true para ativar ou false para desativar a validação de documento cruzado.

Parâmetros Opcionais

Nenhuma.

Saída de amostra

O comando retorna uma instrução de status para a validação entre documentos, como exibe o exemplo a seguir:
WASX7188I: Ativação da validação entre documentos definida para true

Exemplos

  • Utilizando Jacl:
    $AdminConfig setCrossDocumentValidationEnabled true
  • Utilizando Jython:
    print AdminConfig.setCrossDocumentValidationEnabled('true')

setSaveMode

Utilize o comando setSaveMode para modificar o comportamento do comando save.

Objeto de Destino

Nenhuma.

Parâmetros Obrigatórios

save mode
Especifica o modo de salvamento a ser utilizado. O valor padrão é rollbackOnConflict. Quando o sistema descobre um conflito durante o salvamento, as alterações não salvas não são confirmadas. O valor alternativo é overwriteOnConflict, que salva as alterações no repositório de configuração mesmo se existirem conflitos. Para utilizar overwriteOnConflict como o valor desse comando, o gerenciador de implementação deve estar ativado para sobrescrever configuração.

Parâmetros Opcionais

Nenhuma.

Saída de amostra

O comando setSaveMode não retorna uma saída.

Exemplos

  • Utilizando Jacl:
    $AdminConfig setSaveMode overwriteOnConflict
  • Utilizando Jython:
    AdminConfig.setSaveMode('overwriteOnConflict')

setValidationLevel

Utilize o comando setValidationLevel para configurar a validação utilizada quando os arquivos são extraídos do repositório.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Especifica a validação a ser utilizada. Cinco níveis de validação estão disponíveis: none, low, medium, high ou highest.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retorna uma cadeia que contém a configuração de nível de validação, como exibe o exemplo a seguir:
WASX7189I: Nível de validação definido para HIGH

Exemplos

  • Utilizando Jacl:
    $AdminConfig setValidationLevel high
  • Utilizando Jython:
    print AdminConfig.setValidationLevel('high')

show

Utilize o comando show para retornar os atributos de nível superior do objeto especificado.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

configuration ID
Especifica o ID da configuração do objeto de interesse.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retorna uma cadeia que contém o valor de atributo, como exibe o exemplo a seguir:
[name "Sample Datasource"] [description "Data source for the Sample entity beans"]

Exemplos

  • Utilizando Jacl:
    $AdminConfig show Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xmlJDBCProvider_1)
  • Utilizando Jython:
    print AdminConfig.show('Db2JdbcDriver(cells/mycell/nodes/DefaultNode|resources.xmlJDBCProvider_1)')

showall

Utilize o comando showall para mostrar recursivamente os atributos de um determinado objeto de configuração.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

configuration ID
Especifica o ID da configuração do objeto de interesse.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

O comando retorna uma cadeia que contém o valor de atributo, como mostra o seguinte exemplo:

Utilizando Jacl:
tcpNoDelay: null
SoTimeout: 0
bytesRead: 6669
{authMechanismPreference BASIC_PASSWORD}
{connectionPool {{agedTimeout 0}
{connectionTimeout 180}
{freePoolDistributionTableSize 0}
{maxConnections 10}
{minConnections 1}
{numberOfFreePoolPartitions 0}
{numberOfSharedPoolPartitions 0}
{numberOfUnsharedPoolPartitions 0}
{properties {}}
{purgePolicy EntirePool}
{reapTime 180}
{stuckThreshold 0}
{stuckTime 0}
{stuckTimerTime 0}
{surgeCreationInterval 0}
{surgeThreshold -1}
{testConnection false}
{testConnectionInterval 0}
{unusedTimeout 1800}}}
{datasourceHelperClassname com.ibm.websphere.rsadapter.DerbyDataStoreHelper}
{description "Datasource for the WebSphere Default Application"}
{diagnoseConnectionUsage false}
{jndiName DefaultDatasource}
{logMissingTransactionContext true}
{manageCachedHandles false}
{name "Default Datasource"}
{properties {}}
{propertySet {{resourceProperties {{{name databaseName}
{required false}
{type java.lang.String}
{value ${APP_INSTALL_ROOT}/${CELL}/DefaultApplication.ear/DefaultDB}} {{name shu
tdownDatabase}
{required false}
{type java.lang.String}
{value {}}} {{name dataSourceName}
{required false}
{type java.lang.String}
{value {}}} {{name description}
{required false}
{type java.lang.String}
{value {}}} {{name connectionAttributes}
{required false}
{type java.lang.String}
{value upgrade=true}} {{name createDatabase}
{required false}
{type java.lang.String}
{value {}}}}}}}
{provider "Derby JDBC Provider(cells/isthmusCell04/nodes/isthmusNode14/servers/s
erver1|resources.xml#JDBCProvider_1183122153343)"}
{providerType "Derby JDBC Provider"}
{relationalResourceAdapter "WebSphere Relational Resource Adapter(cells/isthmusC
ell04/nodes/isthmusNode14/servers/server1|resources.xml#builtin_rra)"}
{statementCacheSize 10}
Utilizando Jython:
[datasourceHelperClassname com.ibm.websphere.rsadapter.DerbyDataStoreHelper]
[description "Datasource for the WebSphere Default Application"]
[jndiName DefaultDatasource]
[name "Default Datasource"]
[propertySet [[resourceProperties [[[description "Location of Apache Derby default database."]
[name databaseName]
[type string]
[value ${WAS_INSTALL_ROOT}/bin/DefaultDB]] [[name remoteDataSourceProtocol]
[type string]
[value []]] [[name shutdownDatabase]
[type string]
[value []]] [[name dataSourceName]
[type string]
[value []]] [[name description]
[type string]
[value []]] [[name connectionAttributes]
[type string]
[value []]] [[name createDatabase]
[type string]
[value []]]]]]]
[provider "Apache Derby JDBC Driver(cells/pongo/nodes/pongo/servers/server1|resources.xml#JDBCProvider_1)"]
[relationalResourceAdapter "WebSphere Relational Resource Adapter(cells/pongo/nodes/pongo/servers/server1|
resources.xml#builtin_rra)"]
[statementCacheSize 0]
Você pode precisar converter a saída Jython de uma cadeia para uma lista para processamento.

Exemplos

  • Utilizando Jacl:
    $AdminConfig showall "Default Datasource(cells/mycell/nodes/DefaultNode/servers/server1:resources.xml#DataSource_1)"
  • Utilizando Jython:
    print AdminConfig.showall
      ("Default Datasource(cells/mycell/nodes/DefaultNode/servers/server1:resources.xml#DataSource_1)")

showAttribute

Utilize o comando showAttribute para exibir somente o valor para o único atributo especificado.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

configuration ID
Especifica o ID da configuração do objeto de interesse.
attribute
Especifica o atributo a ser consultado.

Parâmetros Opcionais

Nenhum.

Saída de Amostra

A saída desse comando é diferente da saída do comando show quando um único atributo é especificado. O comando showAttribute não exibe uma lista que contém o nome e o valor do atributo. Ele só exibe o valor do atributo, conforme exibido pelo seguinte exemplo:
mynode

Exemplos

  • Utilizando Jacl:
    set ns [$AdminConfig getid /Node:mynode/]
    $AdminConfig showAttribute $ns hostName
  • Utilizando Jython:
    ns = AdminConfig.getid('/Node:mynode/')
    print AdminConfig.showAttribute(ns, 'hostName')
    Antes da Versão 7.0.0.5, a linguagem de script Jython não reconhece caracteres especiais. Além disso, quando os caracteres de espaço simples e de vírgula ocorrerem entre os parâmetros de atributos, esses caracteres são tratados como delimitadores e ignorados quando o valor de atributo for salvo. Por exemplo, você pode ter o seguinte conjunto de comandos Jython:
    value='{"param1","param2"}'
    serverId=AdminConfig.getid('/Cell:cell_name/Node:node_name/Server:server_name')
    nameSpace=AdminConfig.create('StringNameSpaceBinding',serverId,[['name','TestName'],
    ['nameInSpace','TestNameSpace'],['stringToBind',value] ])
    É possível usar o seguinte comando para imprimir o valor:
    print AdminConfig.showAttribute(nameSpace, 'stringToBind')
    que resulta na seguinte saída:
    {"param1" "param2"}
    Na Versão 7.0.0.5 e superior, a linguagem de script Jython reconhece a vírgula se você precedê-la com uma barra invertida (\). Por exemplo, no conjunto de comandos Jython de exemplo original, altere a primeira linha para o seguinte comando:
    value='{"param1"\,"param2"}'
    Ao imprimir o valor, a seguinte saída será retornada:
    {"param1","param2"}

_var

Utilize o comando types para retornar uma lista dos tipos de objeto de configuração que você pode manipular. É possível utilizar caracteres curinga (*) ou expressões comuns Java (.*) na sintaxe de comando para customizar a consulta de procura.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

Nenhum.

Saída de amostra

O comando retorna uma lista de tipos de objeto, como exibe o exemplo a seguir:
AdminService
Agente
ApplicationConfig
ApplicationDeployment
ApplicationServer
AuthMechanism
AuthenticationTarget
AuthorizationConfig
AuthorizationProvider
AuthorizationTableImpl
BackupCluster
CMPConnectionFactory
CORBAObjectNameSpaceBinding
Célula
CellManager
Classloader
ClusterMember
ClusteredTarget
CommonSecureInteropComponent

Exemplos

Os exemplos as seguir retornam cada tipo de objeto em sua configuração:
  • Utilizando Jacl:
    $AdminConfig types
  • Utilizando Jython:
    print AdminConfig.types()
Os exemplos a seguir retornam cada tipo de objeto em sua configuração que contém a cadeia security:
  • Utilizando Jacl:
    $AdminConfig types *security*
  • Utilizando Jython:
    print AdminConfig.types('*security*')

uninstallResourceAdapter

Utilize o comando uninstallResourceAdapter para desinstalar um adaptador de recursos J2C (Java 2 Connector) com o ID da configuração fornecido do adaptador de recursos J2C e uma lista de opções. Quando você remove um objeto J2CResourceAdapter do repositório de configuração, o diretório instalado será removido no momento da sincronização. Um pedido de parada será enviado para o MBean J2CResourceAdapter que foi removido.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

configuration ID
Especifica o ID de configuração do adaptador de recursos a ser removido.

Parâmetros Opcionais

options list
Especifica as opções de desinstalação para o comando. A opção válida é force. Essa opção força a desinstalação do adaptador de recursos sem verificar se o adaptador de recursos está sendo utilizado por um aplicativo. O aplicativo que o está utilizando não será desinstalado. Se você não especificar a opção de força e o adaptador de recursos especificado ainda estiver em utilização, o adaptador de recursos não será desinstalado.

Saída de Amostra

O comando retorna o ID da configuração do adaptador de recursos J2C que é removido, como exibe o exemplo a seguir:
WASX7397I: Os seguintes objetos J2CResourceAdapter são removidos: 
MyJ2CRA(cells/juniarti/nodes/juniarti|resources.xml#J2CResourceAdapter_1069433028609)

Exemplos

  • Utilizando Jacl:
    set j2cra [$AdminConfig getid /J2CResourceAdapter:MyJ2CRA/]
    $AdminConfig uninstallResourceAdapter $j2cra {-force}
  • Utilizando Jython:
    j2cra = AdminConfig.getid('/J2CResourceAdapter:MyJ2CRA/')
    print AdminConfig.uninstallResourceAdapter(j2cra, '[-force]')

unsetAttributes

Utilize o comando unsetAttributes para reconfigurar os atributos específicos para um objeto de configuração dos valores padrão.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

configuration ID
Especifica o ID de configuração do objeto de configuração de interesse.
Atributos
Especifica os atributos para reconfigurar os valores padrão.

Parâmetros Opcionais

Nenhum.

Exemplos

  • Utilizando Jacl:
    set cluster [$AdminConfig getid /ServerCluster:myCluster]
    $AdminConfig unsetAttributes $cluster {"enableHA", "preferLocal"}
  • Utilizando Jython:
    cluster = AdminConfig.getid("/ServerCluster:myCluster")
    AdminConfig.unsetAttributes(cluster, ["enableHA", "preferLocal"])

validate

Utilize o comando validate para solicitar os resultados da validação da configuração baseados nos arquivos de seu espaço de trabalho, o valor do sinalizador ativado da validação entre documentos e a configuração do nível da validação. Como opção, é possível especificar um ID de configuração para definir o escopo. Se você especificar um ID de configuração, o escopo desse pedido é o objeto denominado pelo parâmetro configuration ID.

Objeto de destino

Nenhum.

Parâmetros Obrigatórios

Nenhum.

Parâmetros Opcionais

configuration ID
Especifica o ID da configuração do objeto de interesse.

Saída de Amostra

O comando retorna uma cadeia que contém os resultados da validação, como exibe o exemplo a seguir:
WASX7193I: Os resultados da validação são registrados em c:\WebSphere5\AppServer\logs\wsadmin.valout: Número total de mensagens: 16
WASX7194I: Número de mensagens de gravidade 1: 16

Exemplos

  • Utilizando Jacl:
    $AdminConfig validate
  • Utilizando Jython:
    print AdminConfig.validate()

Í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_adminconfig1
Nome do arquivo: rxml_adminconfig1.html