Grupo de Comandos de Gerenciamento de Aplicativos para o Objeto AdminTask

É possível utilizar as linguagens de script Jython ou Jacl para gerenciar aplicativos com a ferramenta wsadmin. Use os comandos e parâmetros no grupo AppManagementCommands que podem ser usados para exibir e processar os perfis do SQL Java™ (SQLJ) ou os arquivos de ligação IBM Optim PureQuery Runtime.

O grupo de comandos AppManagementCommands para o objeto AdminTask inclui os seguintes comandos:

listSqljProfiles

O comando listSqljProfiles analisa o arquivo archive corporativo (EAR) do aplicativo especificado e retorna uma lista de arquivos SQLJ. Os perfis SQLJ possuem uma extensão do nome de arquivo .ser. Se houver quaisquer arquivos no arquivo EAR que não sejam de perfis SQLJ, mas possuem uma extensão do nome do arquivo .ser, esses arquivos também poderão ser listados.

Parâmetros e valores de retorno

-appName
O nome do aplicativo instalado. Seu aplicativo deve ser instalado antes de executar uma customização e ligação nele. Este parâmetro é requerido.

Exemplos

Uso de exemplo do modo em lote:

  • Utilizando JACL:
    $AdminTask listSqljProfiles {-appName application_name}
  • Utilizando Jython:
    print AdminTask.listSqljProfiles('-appName application_name')
Uso de exemplo de modo interativo:
  • Utilizando JACL:
    $AdminTask listSqljProfiles -interactive
  • Utilizando Jython:
    print AdminTask.listSqljProfiles('-interactive')
A saída é exibida com a sintaxe específica para o sistema operacional local. A lista de perfis disponíveis pode ser incluída a um arquivo de grupo com extensão .grp diretamente.

processSqljProfiles

O comando processSqljProfiles cria uma customização do DB2 dos perfis SQLJ. O comando, opcionalmente, por padrão, chama o binder do perfil SQLJ para ligar os pacotes do DB2.
Boas Práticas Boas Práticas: Se você estiver processando um aplicativo corporativo grande ou muitos perfis SQLJ, o processo poderá demorar mais do que o tempo limite padrão para a ferramenta wsadmin. O tempo limite de conexão padrão para a ferramenta wsadmin é configurado para 3 minutos. Se o tempo limite padrão for atingido e você perder a conexão com o servidor, o console wsadmin emitirá uma instrução de tempo limite. Você pode verificar o log de saída do sistema para obter os resultados finais do processo de customização e ligação e o período de tempo desse processo. Não inicie o comando processSqljProfiles novamente enquanto o comando anterior não for concluído ou os resultados poderão ser imprevisíveis.
Para evitar essa desconexão, configure o tempo limite de sessão para um tempo maior. Consulte o log de saída do sistema para obter o tempo total de processamento e utilize esse período de tempo como base para o novo valor de tempo limite. Para estender o valor de tempo limite padrão, altere o arquivo de propriedades wsadmin correspondente ao tipo de conexão que está sendo utilizado:
  • Para o tipo de conexão SOAP, altere a seguinte entrada no arquivo soap.client.props:
    com.ibm.SOAP.requestTimeout=180
  • Para os tipos de conexão JSR160RMI e RMI, altere a seguinte entrada no arquivo sas.client.props:
    com.ibm.CORBA.requestTimeout=180
  • Para o tipo de conexão IPC, altere a seguinte entrada no arquivo ipc.client.props:
    com.ibm.IPC.requestTimeout=180
bprac
Há duas maneiras pelas quais é possível verificar se a ligação ou a customização ocorreu:
  • Se você executou um processo de customização, poderá executar uma consulta a partir da linha de comandos para ver os arquivos EAR do aplicativo que foram alterados:
    wsadmin>print AdminConfig.hasChanges()
    A consulta retornará 0 se não houver nenhuma mudança e retornará 1 se ocorrerem mudanças no servidor. Para visualizar os arquivos de configuração que possuem mudanças não salvas, execute:
    wsadmin>print AdminConfig.queryChanges()
    .
  • Visualize o log de Saída do Sistema para determinar se a ligação ou o processamento foi bem-sucedido.

Objeto de destino

Os perfis SQLJ do aplicativo instalado. Esses perfis são únicos, arquivos .ser seriais ou perfis que são agrupados em um arquivo de grupo de grupo .grp. Esse objeto de destino é requerido.

Parâmetros e valores de retorno

-appName
O nome do aplicativo instalado. Seu aplicativo deve ser instalado antes de executar uma customização e ligação nele. Este parâmetro é requerido.
-classpath
O caminho que informa ao servidor de aplicativos onde localizar os arquivos JAR do driver SQLJ necessários. Esse parâmetro é opcional.
-dburl
O local do servidor DB2 na rede. Esse parâmetro é opcional.
-user
Nome do usuário da conta que executa o acesso ao banco de dados DB2. Esse parâmetro é opcional.
-password
Senha da conta que acessa o banco de dados DB2. Esse parâmetro é opcional.
-options
Opções adicionais que são usadas com o comando db2sqljcustomize podem ser inseridos no parâmetro -options, exceto para os parâmetros listados anteriormente. Esse parâmetro é opcional. Para obter informações adicionais sobre o comando db2sqljcustomize, consulte db2sqljcustomize - customizador do perfil SQLJ.
-profiles
O local dos arquivos .ser ou do arquivo .grp dos perfis SQLJ. Esse parâmetro é requerido.

Exemplos

Uso de exemplo do modo em lote:

  • Utilizando Jacl:

    $AdminTask processSqljProfiles {-appName FVT -classpath {C:/IBM/SQLLIB/java/db2jcc.jar } -url 
     jdbc:db2://server.domain.ibm.com:50000/JTEST1 -user dbuser1 -password ***** -options "-rootpkgname MYPKG" -profiles 
     {c:/temp/ApplicationSerNames.grp }} 

  • Utilizando Jython:

    AdminTask.processSqljProfiles('[-appName Application -classpath ["C:/IBM/SQLLIB/java/db2jcc.jar"] 
     -dbURL "jdbc:db2://server.domain.ibm.com:50000/JTEST1" -user dbuser1 -password ***** -options [-rootpkgname MYPKG] -profiles 
     ["c:/temp/ApplicationSerNames.grp"]]')

Uso de exemplo de modo interativo:

wsadmin>print AdminTask.processSqljProfiles('-interactive') Process serialized SQLJ 
 profiles. Processe os perfis SQLJ serializados em um aplicativo instalado.  Customize os perfis com informações de tempo de execução e ligue os pacotes SQL estáticos em um banco de dados.   Consulte a documentação de customização e ligação do SQLJ do Banco de Dados.    Execute apenas a ligação. 
 commit. (bindOnly): false  *Application name. (appName): Application  Classpath to SQLJ tools. (classpath): 
 C:/IBM/SQLLIB/java/db2jcc.jar  Database connection URL. (dbURL):  Database connection user name. (user):  Database connection 
 senha. (password):  Options for SQLJ tools. (options):  *SQLJ profile names. (profiles): c:/temp/ApplicationSerNames.grp   
 Processar perfis SQLJ serializados.    F (Finish) C (Cancel)   Select [F, C]: [F]  WASX7278I: Generated command line: 
 AdminTask.processSqljProfiles('[-bindOnly false -appName Application -classpath [C:/IBM/SQLLIB/java/db2jcc.jar] -profiles 
 [c:/temp/ApplicationSerNames.grp ]]') 

listPureQueryBindFiles

O comando listPureQueryBindFiles analisa um arquivo EAR do aplicativo especificado e retorna uma lista de arquivos .bindprops e .pdqxml que são localizados. Os arquivos de opções de ligação PureQuery possuem uma extensão do nome de arquivo .bindprops. Os arquivos de ligação possuem uma extensão de nome de arquivo .pdqxml. Se o arquivo EAR contiver arquivos que não são arquivos de ligação pureQuery, mas que possuem uma extensão do nome de arquivo .bindprops ou .pdqxml, esses arquivos também poderão ser listados.

Parâmetros e valores de retorno

-appName
O nome do aplicativo instalado. Esse parâmetro é requerido.

Exemplos

Uso de exemplo do modo em lote:

  • Utilizando JACL:

    $AdminTask listPureQueryBindFiles {-appName application_name}
  • Utilizando Jython:

    print AdminTask.listPureQueryBindFiles('-appName application_name')
Uso de exemplo de modo interativo:
  • Utilizando JACL:

    $AdminTask listPureQueryBindFiles -interactive
  • Utilizando Jython:

    print AdminTask.listPureQueryBindFiles('-interactive')

A saída é exibida com a sintaxe específica para o sistema operacional local.

processPureQueryBindFiles

O comando processPureQueryBindFiles chama o utilitário de ligação pureQuery do DB2 em uma lista de arquivos de ligação pureQuery.
Boas Práticas Boas Práticas: Se você estiver processando um aplicativo corporativo grande ou muitos arquivos de ligação pureQuery utilizando wsadmin, o processo poderá demorar mais do que o tempo limite padrão para a ferramenta wsadmin. O tempo limite de conexão padrão para a ferramenta wsadmin é configurado para 3 minutos. Se o tempo limite padrão for atingido e o processo em execução no servidor ainda não tiver sido concluído, o console wsadmin emitirá uma instrução de tempo limite. Você pode verificar o log de saída do sistema no servidor para obter os resultados finais do processo de ligação e a hora em que esse processo foi concluído. Não inicie o comando processPureQueryBindFiles novamente enquanto o comando anterior não for concluído ou os resultados poderão ser imprevisíveis.
Para evitar esse tempo limite, configure o tempo limite de solicitação do wsadmin para um tempo maior. Após um processo de customização e ligação bem-sucedido, utilize o log de saída do sistema para obter uma estimativa do tempo total de processamento. Utilize esse período de tempo como base para o novo valor de tempo limite. Para estender o valor de tempo limite padrão, altere o arquivo de propriedades wsadmin correspondente ao tipo de conexão que está sendo utilizado:
  • Para o tipo de conexão SOAP, altere a seguinte entrada no arquivo soap.client.props:
    com.ibm.SOAP.requestTimeout=180
  • Para os tipos de conexão JSR160RMI e RMI, altere a seguinte entrada no arquivo sas.client.props:
    com.ibm.CORBA.requestTimeout=180
  • Para o tipo de conexão IPC, altere a seguinte entrada no arquivo ipc.client.props:
    com.ibm.IPC.requestTimeout=180
bprac

Para verificar se a ligação ocorreu, visualize o log de Saída do Sistema para determinar se o processamento de ligação foi bem-sucedido.

Parâmetros e valores de retorno

-appName
O nome de um aplicativo instalado que contém os arquivos de ligação pureQuery a serem processados. Seu aplicativo deve ser instalado antes de executar uma ligação nele.
-classpath
Uma lista de caminhos para os arquivos Java archive (JAR) que contêm o utilitário de ligação IBM Optim PureQuery Runtime e suas dependências: pdq.jar, pdqmgmt.jar, db2jcc4.jar ou db2jcc.jar, db2jcc_license_cisuz.jar ou db2jcc_license_cu.jar. Utilize / ou \\\\ como um separador de arquivo. Utilize um espaço em branco para separar os caminhos para os arquivos JAR.
-dburl
A URL para conexão com o banco de dados. O formato é jdbc:db2://server_name:port/database_name.
-user
Nome do usuário da conta que executa o acesso ao banco de dados DB2.
-password
Senha da conta que acessa o banco de dados DB2.
-options
Quaisquer opções adicionais que forem necessárias pelo utilitário de ligação IBM Optim PureQuery Runtime. Forneça opções de ligação como -bindoptions "bind_options_string". Para obter informações adicionais sobre o utilitário de ligação do IBM Optim PureQuery Runtime, consulte o tópico sobre o utilitário pureQuery Bind.
-files
Uma lista dos nomes dos arquivos de ligação pureQuery a serem processados. Os nomes do caminho do arquivo de ligação devem ser relativos ao arquivo EAR do aplicativo que os contêm. Utilize / ou \\\\ como um separador de arquivo. Se você especificar vários caminhos de perfil, utilize um espaço em branco para separá-los.

Exemplos

Uso de exemplo do modo em lote:

  • Utilizando Jacl:

    $AdminTask processPureQueryBindFiles {-appName MyApp -classpath {/pdq_home/pdq.jar /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar } -url jdbc:db2://hostname:50000/databasename -user dbuser1 -password dbpswrd1 -options {-bindoptions "BLOCKING NO"} -files {META-INF/xyz.bindprops META-INF/abc.bindprops }}
  • Utilizando Jython:

    print AdminTask.processPureQueryBindFiles('[-appName MyApp -classpath [/pdq_home/pdq.jar 
     /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar ] -url 
     jdbc:db2://hostname:50000/databasename -user dbuser1 -password dbpswrd1 -options [-bindoptions "BLOCKING NO"] -files 
     [META-INF/xyz.bindprops META-INF/abc.bindprops ]]')

Uso de exemplo de modo interativo:

print AdminTask.processPureQueryBindFiles('-interactive') Process pureQuery bind files.  
 Processe os arquivos de ligação pureQuery em um aplicativo instalado.  Ligue os pacotes SQL estáticos em um banco de dados.  Consulte a documentação do utilitário de ligação pureQuery 
 .  *Nome do aplicativo. (appName): MyApp Classpath to pureQuery Bind utility. (classpath): 
 /pdq_home/pdq.jar /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar *Database 
 connection URL. (url): jdbc:db2://hostname:50000/databasename Database connection user name. (user): dbuser1 Database connection 
 senha. (password): dbpswrd1 Options for the pureQuery Bind utility. (options): -bindoptions "BLOCKING NO" *pureQuery bind file 
 names. (files): META-INF/xyz.bindprops META-INF/abc.bindprops  Process pureQuery bind files.  F (Finish) C (Cancel)  Select [F, 
 C]: [F] WASX7278I: Generated command line: AdminTask.processPureQueryBindFiles('[-appName MyApp -classpath [/pdq_home/pdq.jar 
 /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar ] -url 
 jdbc:db2://hostname:50000/databasename -user dbuser1 -password ***** -options [-bindoptions "BLOCKING NO"] -files 
 [META-INF/xyz.bindprops META-INF/abc.bindprops ]]')

Í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_atappmancommandsgroup
Nome do arquivo: rxml_atappmancommandsgroup.html