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.
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')
- Utilizando JACL:
$AdminTask listSqljProfiles -interactive
- Utilizando Jython:
print AdminTask.listSqljProfiles('-interactive')
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.
- 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
- 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:
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.hasChanges()
.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')
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.
- 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
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 ]]')