Customizando e Ligando Perfis para Aplicativos SQLJ (Structured Query Language in Java)

Simplifique o processo de customização e ligação de perfis SQLJ para seus aplicativos executando estas funções no console administrativo ou com scripts. Os perfis SQLJ devem ser customizados e ligados antes que o aplicativo corporativo utilize a SQL integrada do aplicativo.

Antes de Iniciar

Você deve ter um aplicativo SQLJ já implementado e instalado no servidor de aplicativos.
Para aplicativos SQLJ que utilizam a persistência gerenciada por contêiner, é possível implementar o aplicativo de duas maneiras:
  • Implemente o aplicativo no servidor de aplicativos. Consulte o tópico sobre como implementar aplicativos SQLJ que utilizam a CMP (Container-Managed Persistence) para obter informações adicionais.
  • Implemente aplicativos SQLJ com a ferramenta ejbdeploy. Consulte o tópico sobre como implementar aplicativos SQLJ que utilizam CMP (Container-Managed Persistence) com a ferramenta ejbdeploy.
Para o aplicativo SQLJ que utiliza persistência gerenciada por bean, consulte o tópico sobre como implementar aplicativos SQLJ que utilizam persistência gerenciada por bean, servlets ou beans de sessão.

Sobre Esta Tarefa

Para utilizar os aplicativos SQLJ no servidor de aplicativos, é necessário customizar os perfis SQLJ que contêm as instruções SQL integradas. Por padrão, quatro pacotes do DB2 são criados no banco de dados, um para cada nível de isolamento. O processo de customização aprimora os perfis com informações específicas do banco de dados DB2. O banco de dados utiliza essas informações no tempo de execução.

Além da customização do perfil, é necessário ligar os perfis customizados ao banco de dados DB2. A ligação do perfil deverá ocorrer apenas depois que os perfis SQLJ forem customizados.

Você também pode customizar e ligar perfis com script ou com a ferramenta db2sqljcustomize:
  • Para suporte a script, leia o tópico sobre o grupo de comandos de gerenciamento de aplicativos para o objeto AdminTask.
  • Para obter informações sobre a ferramenta db2sqljcustomize, leia o tópico sobre como customizar e ligar perfis SQLJ com a ferramenta db2sqljcustomize para obter informações adicionais. Se você customizar perfis com a ferramenta db2sqljcustomize, será necessário reinstalar o aplicativo.

Procedimento

  1. Certifique-se de que existam as tabelas de banco de dados necessárias, conforme descrito no tópico sobre como implementar aplicativos de acesso de dados.
  2. Navegue até o aplicativo SQLJ que está instalado no servidor de aplicativos. Clique em Aplicativos > Aplicativos Corporativos do WebSphere > app_name.
    Evitar Problemas Evitar Problemas: Não execute várias sessões do console administrativo para customizar e ligar perfis que estão no mesmo arquivo EAR.gotcha
  3. Navegue até a seção de perfis SQLJ. Clique em Perfis de SQLJ. Ao clicar nesse link, o servidor de aplicativos expandirá o arquivo EAR para o aplicativo em um diretório temporário; poderá haver um atraso para o painel de perfis SQLJ ser exibido.
  4. Selecione Customizar e ligar perfis ou Ligar pacotes. Escolha sua opção com base nos perfis com os quais você está trabalhando:
    • Se seus perfis não tiverem sido customizados ou você desejar customizar os perfis novamente, escolha Customizar e ligar perfis.
    • Se os perfis já estiverem sido customizados, escolha Ligar pacotes.
  5. Escolha selecionar perfis ou um grupo de perfis para customizar e ligar.
    • Selecione perfis da lista fornecida.
      1. Selecione os perfis na lista e clique em Incluir. A lista exibirá os perfis SQLJ que estão presentes no aplicativo corporativo.
        Boas Práticas Boas Práticas:
        • Selecione mais de um perfil mantendo a tecla CTRL pressionada.
        • Selecione uma lista contínua de perfis selecionando o primeiro nome de perfil, mantendo a tecla SHIFT pressionada e selecionando o último perfil. Você selecionará o primeiro perfil, o último perfil e quaisquer perfis no meio.
        bprac
      2. Selecione Customizar/ligar os perfis SQLj selecionados como um grupo. Essa opção especifica que o servidor de aplicativos criará um arquivo .grp que contém os perfis SQLj que são processados. É possível utilizar o arquivo .grp para outras operações de ligação no futuro. Após concluir esse painel e clicar em OK, você terá a opção para fazer download do arquivo .grp.
    • Selecione Utilizar um arquivo de grupos de perfis para especificar perfis para customizar/ligar. Selecione essa opção para especificar um grupo de perfis para processar. Clique em Procurar... para localizar o arquivo no sistema.
  6. Preencha as informações necessárias para conectar-se com o banco de dados. É necessário preencher os seguintes campos:
    URL do Banco de Dados
    Especifica a URL do banco de dados para a qual os perfis serão conectados. A sintaxe típica é:
    jdbc:db2://<host name="">:<port>/<database name="">.</database></port></host> ou 
    ou
    fully_qualified_host_name:port
    Usuário
    Especifica o ID do usuário para o administrador de banco de dados no servidor onde o banco de dados está localizado.
    Senha
    Especifica a senha para o administrador de banco de dados no servidor onde o banco de dados está localizado.
    Opções Adicionais
    Especifica opções adicionais a serem utilizadas durante os processos de customização e ligação. Consulte a documentação do DB2 para obter uma lista completa de opções de customização.
    Caminho da classe
    Especifica o caminho de classe onde os arquivos sqlj.zip, db2jcc.jar ou db2jcc4.jar estão localizados.
  7. Clique em OK.
    Evitar Problemas Evitar Problemas: Se você estiver processando um aplicativo corporativo grande ou muitos perfis SQLJ, o processo poderá demorar mais que o tempo limite padrão para o console administrativo. O tempo limite de conexão padrão para o console administrativo do servidor de aplicativos é definido para 30 minutos. Se o tempo limite padrão for atingido e você perder a conexão com o servidor, verifique o log de saída do sistema para obter os resultados finais do processo de customização e ligação.

    Para evitar essa desconexão, configure o tempo limite da sessão do console para um tempo maior. Após um processo de customização e ligação bem-sucedido, verifique no log de saída do sistema para obter o tempo total de processamento. Utilize esse período de tempo como base para o novo valor de tempo limite. Para obter informações sobre como configurar o tempo limite do console, consulte o tópico sobre como alterar a expiração da sessão do console.

    gotcha

Resultados

Após o servidor de aplicativos terminar de processar os perfis SQLJ, você visualizará os resultados da customização e ligação. O painel de resultados exibe mensagens do servidor de banco de dados, assim como resultados de resumo do servidor de aplicativos.
Se a operação tiver sido concluída com êxito, a mensagem a seguir será impressa no log do sistema:
ADMA0507I=ADMA0507I: A operação SQLJ no aplicativo {0} foi concluída com êxito.  Código de saída: {1}
ADMA0507I.explanation=Esta mensagem informativa indica o status do programa.
ADMA0507I.useraction=Nenhuma ação do usuário é necessária.
Se a operação não tiver sido concluída com êxito, a mensagem a seguir será impressa no log de saída do sistema:
ADMA0506I=ADMA0506I: A operação SQLJ no aplicativo {0} não foi concluída com êxito.  Código de saída: {1}
ADMA0506I.explanation=A operação SQLJ encontrou um problema.  Esta mensagem informativa indica 
o status do programa. As mensagens anteriores na saída do comando dão detalhes do problema.
ADMA0506I.useraction=Verifique a saída de comando para a causa do problema.

Ícone que indica o tipo de tópico Tópico de Tarefa



Í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=tdat_sqljcustomize
Nome do arquivo: tdat_sqljcustomize.html