IBM Developer Workbench Versão 9.1.0.2 - Notas sobre o Release

Índice

1.0 Sobre este release

O Developer Workbench Versão 9.1.0.2 contém aprimoramentos e correções no release da versão 9.1.

Voltar ao Índice.

1.1 O que Há de Novo neste Release

O Developer Workbench Versão 9.1.0.2 fornece os seguintes novos recursos:

• Suporte para o DB2 para z/OS Versão 9:
  • É possível criar uma conexão JDBC com o DB2 para z/OS Versão 9 no Database Explorer.
  • É possível utilizar o ambiente de trabalho para criar, testar e implementar os seguintes tipos de rotinas que têm como alvo o DB2 para z/OS Versão 9 em um projeto de desenvolvimento de dados:
    • Os procedimentos armazenados nativos SQL, incluindo várias versões de procedimentos armazenados nativos
    • Procedimentos armazenados externos SQL
    • Procedimentos armazenados Java (JDBC e SQLJ)
    • Funções definidas pelo usuário escalares SQL
  • É possível utilizar o ambiente de trabalho para desenvolver procedimentos armazenados Java que têm como alvo o DB2 para z/OS Versão 9 que dependem das classes em arquivos JAR diferentes do arquivo JAR no qual o procedimento armazenado está implementado. É possível importar um arquivo JAR para um projeto de desenvolvimento de dados para permitir que esse tipo de procedimento Java armazenado seja compilado e empacotado localmente. Você também pode utilizar o ambiente de trabalho para implementar ou eliminar um arquivo JAR a partir de um servidor de banco de dados e visualizar as propriedades dos arquivos JAR implementados a partir do Database Explorer.
  • É possível utilizar o depurador do procedimento armazenado integrado no ambiente de trabalho para depurar procedimentos armazenados que têm como alvo o DB2 para z/OS Versão 9.
• Documentação traduzida e texto da interface com o usuário para UDFs OLE DB e XML. Consulte a seção de correção de documentação destas notas sobre o release para obter informações sobre algumas etapas de pré-requisitos que devem ser concluídas antes de criar UDFs OLE DB ou XML.
• Suporte para a extensão .db2 com arquivos que contêm instruções SQL e scripts. Além dos arquivos com extensões .sql e .ddl, é possível editar e importar arquivos SQL que têm uma extensão .db2.
• Suporte para criar um único pacote para procedimentos SQLJ armazenados. Para criar um único pacote, especifique um nível de isolamento no campo Opções de Ligação do assistente Implementar Rotinas.
• Suporte para salvar rotinas com erros. Ao salvar uma rotina no Editor de Rotina que contém erros, você vê uma mensagem que mostra que há erros no código-fonte, mas você pode salvar o código-fonte com os erros para não perder o trabalho.

Voltar ao Índice.

1.2 Histórico de Correção de Produtos

Os problemas conhecidos a seguir da versão 9.1 ou 9.1.0.1 foram corrigidos:

• Antes de excluir um projeto, feche as rotinas abertas e os editores SQL que pertencem ao projeto. Se você não fechar as rotinas e os editores SQL abertos, apesar de o projeto e seu conteúdo ainda serem excluídos, você verá mensagens de erro.
• Se você estiver depurando um procedimento armazenado Java que chama um segundo procedimento armazenado Java, não poderá depurar o segundo procedimento armazenado. Você não pode percorrer o procedimento de armazenamento aninhado e qualquer ponto de interrupção que você configure no procedimento armazenado aninhado será ignorado. Essa restrição destina-se ao DB2 UDB para Linux, UNIX e Windows.

1.3 Limitações e Problemas Conhecidos

Este release contém os seguintes problemas e limitações conhecidos.

• Geral
• Desenvolvimento de Rotina
• Depurador de Procedimentos Armazenados

Geral

• Para ativar o Developer Workbench em Red Hat Enterprise Linux 3, inclua export MOZILLA_FIVE_HOME=<local do mozilla> em /opt/IBM/DWB/V9.1/dwb_prod/shortcut_dwb.
• Se você definir uma tabela que contenha dados XML, mas que não inclua uma chave primária, atualizar a coluna XML falhará no editor de tabela. Você deve incluir uma chave primária ou índice exclusivo na tabela que contém os dados XML.
• O desenvolvimento em XQuery no construtor XQuery é suportado somente em projetos de desenvolvimento de dados associados às conexões do DB2 para Linux, UNIX e Windows Versão 9.
• Depois de criar um servidor federado no Database Explorer, o servidor recém-criado não será automaticamente exibido na pasta Servidor Definido (Defined Server). Você deve atualizar a pasta para ver o novo servidor.
• No Linux, se seu sistema utilizar JDK 1.4.1 como o JDK padrão, os processo do Developer Workbench podem não ser fechados quando você sair do DWB. Para evitar esse problema, utilize o JDK que o DWB fornece: /opt/IBM/DWB/V9.1/dwb_prod/eclipse/jdk/bin.

Desenvolvimento de rotina

• Os UDTs (Tipos Definidos pelo Usuário) não são suportados como parâmetros para as rotinas.
• Visual Explain não está disponível para funções definidas pelo usuário que têm como destino os bancos de dados DB2 para z/OS. O ambiente de trabalho suporta somente expressões, não instruções, para funções do z/OS definidas pelo usuário.
• Ao criar uma rotina pela primeira vez em um projeto de desenvolvimento de dados, as opções do Visual Explain podem não estar disponíveis no assistente Novo Procedimento Armazenado, no assistente Nova Função Definida pelo Usuário ou no editor de rotina. Para obter uma solução alternativa para esse problema, feche e abra novamente o espaço de trabalho e as opções do Visual Explain são ativadas.
• Ao implementar um procedimento armazenado ou uma função definida pelo usuário utilizando o recurso de implementação Ant, pode aparecer a seguinte mensagem se você não tiver o arquivo tools.jar localizado em seu caminho de classe: Impossível localizar tools.jar (Unable to locate tools.jar). Esperava-se encontrá-lo em F:\jre\1.4.2\lib\tools.jar (Expected to find it in F:\jre\1.4.2\lib\tools.jar). Ignore essa mensagem. tools.jar faz parte do JRE (Java Runtime Environment), e não parte do recurso de implementação Ant.
• Para implementar procedimentos armazenados Java que são destinados ao DB2 UDB para iSeries a partir do sistema de arquivos, utilizando a implementação Ant, você deve certificar-se de ter o jt400.jar em seu caminho de classe de sistema.
• Ao criar um procedimento armazenado Java e alterar o nome do método, clicar com o botão direito no editor e clicar em Salvar (Save) não funcionará. Para salvar o procedimento armazenado atualizado, clique em Arquivo > Salvar (File > Save).
• Se tentar implementar um procedimento armazenado exportado, utilizando as instruções em DeployInstructions.txt, você pode receber uma mensagem de erro informando: ...[createsp] Não foi possível conectar-se ao banco de dados de destino (Could not connect to the target database). [createsp] com.ibm.db2.jcc.DB2Driver... Para solucionar este problema, assegure-se de que db2jcc.jar e os arquivos de licença apropriados estejam em seu caminho de classe de sistema.
• Antes de excluir um projeto de desenvolvimento de dados, feche as rotinas abertas e os editores SQL que pertencem ao projeto. Se você não fechar as rotinas abertas e os editores SQL, o projeto e seu conteúdo ainda serão excluídos, mas você verá mensagens de erro.
• Você pode ver um erro não é possível carregar classe (cannot load class) ao implementar ou executar procedimentos armazenados Java. Isso pode acontecer se houver uma correspondência na versão JDK entre o RAD v7 e o servidor DB2, se o servidor DB2 estiver em um JDK de nível inferior. Para evitar esse erro, você deve especificar a opção "-source 1.4" no campo Compilar Opções (Compile options) do assistente de Rotinas de Implementação quando estiver  implementando procedimentos armazenados Java em servidores que utilizam um nível JDK 1.4. (por exemplo, um servidor DB2 Universal Database para Linux, UNIX e Windows V8.2). Em geral, utilize a opção de compilação apropriada "-source JDK level" para corresponder ao nível JDK no servidor de banco de dados.
• Se você arrastar e soltar um procedimento armazenado ou UDF entre servidores diferentes (por exemplo, de um servidor DB2 UDB para Linux, UNIX e Windows para um servidor DB2 UDB para z/OS), verá um aviso durante a operação de arrastar e soltar sobre determinadas incompatibilidades entre dois servidores. Se você continuar com a operação e, em seguida, tentar abrir o procedimento armazenado ou UDF, poderá ver um erro.
• Executar um Perfil SQL em um servidor DB2 UDB para Linux, UNIX e Windows V8.2 pode provocar uma exceção de ponteiro nulo se o servidor estiver precisando do procedimento armazenado de pré-requisito (SYSIBM.SQLCAMESSAGECCSID) que é necessário para o driver JCC recuperar o texto da mensagem de erro. Para solucionar este problema, você pode criar uma conexão ao servidor sem a configuração retrieveMessagesFromServerOnGetMessage=true.
• Durante o monitoramento da execução de procedimentos SQL, os eventos de perfil são gerados para instruções DML como INSERT, SELECT, DELETE e UPDATE que são emitidos no procedimento. No entanto, os eventos não são gerados de uma maneira determinista para as instruções de procedimento para as designações de variável e estruturas de controle como WHILE ou IF. Portanto, os dados de ajuste não serão capturados para essas instruções de procedimento.

Depurador de procedimento armazenado

• Quando estiver conectado a um servidor UNIX DB2, podem ocorrer exceções de tempo limite quando você estiver incluindo pontos de interrupção ou executando no modo de depuração.
• O depurador não é executado para um procedimento armazenado cujo nome contenha caracteres em inglês e em chinês.
• As expressões para observação são suportadas apenas para procedimentos armazenados Java dinâmicos. Elas não são suportadas para os procedimentos armazenados SQL e SQLJ.
• O depurador não pára em um ponto de interrupção, se não estiver posicionado no primeiro token de uma instrução executável, como SET. Além disso, não pára em DECLARE CONTINUE, CLOSE CURSOR ou ROLLBACK.
• Se você estiver depurando um procedimento armazenado Java e selecionar uma ação Terminar (Terminate), pode demorar vários minutos para que a sessão de depuração seja totalmente terminada. As novas sessões de depuração que são iniciadas durante esse momento podem se comportar de forma instável.
• Quando estiver depurando um procedimento Java armazenado chamado de outro procedimento SQL ou Java armazenado, o botão Retorno da Etapa é desativado. Para obter uma solução alternativa para esse problema, é possível incluir um ponto de interrupção na próxima linha do procedimento armazenado de chamada e, em seguida, clicar em Retomar para voltar ao procedimento armazenado de chamada.
• Quando um procedimento armazenado Java chama outro procedimento armazenado e, em seguida, você retorna ao procedimento Java armazenado, pode ser que pare em algum código Java intermediário. Para obter uma solução alternativa para esse problema, utilize o botão Retorno de Etapa para retornar à estrutura de pilha de procedimento Java armazenado.
• Se você receber um erro Tempo Limite Ocorrido ao Aguardar pelo Pacote (Timeout occurred while waiting for packet) enquanto estiver depurando um procedimento armazenado Java, tente aumentar a configuração de tempo limite Java. Para aumentar a configuração de tempo limite Java, clique em Janela > Preferências na barra de menus do ambiente de trabalho. Expanda o nó Java e clique em Depurar (Debug). Na página de preferências Depurar (Debug), aumente o valor Tempo Limite do Depurador (Debugger timeout(ms)) na seção Tempo Limite de Comunicação (Communication timeout). Recomenda-se que você, pelo menos, dobre o valor padrão.
• Quando você estiver depurando um procedimento armazenado Java, se utilizar a ação Alterar Valor (Change Value) para modificar uma variável que tenha um valor de cadeia vazio, o botão OK no diálogo de edição talvez não fique ativado. Para ativar o botão, selecione o botão de opção Inserir uma Avaliação (Input an evaluation), configure o valor para uma cadeia não-vazia (por exemplo, 'a') e, em seguida, selecione o botão de opção Inserir Texto Literal (Input literal text). O botão OK então ficará disponível.
• Se você não encontrar as variáveis locais ao depurar um procedimento armazenado Java, o procedimento armazenado pode ter sido implementado sem a opção do compilador -g. Certifique-se de especificar a opção do compilador -g ao implementar os procedimentos armazenados Java.
• Se você encontrar uma mensagem 'estrutura de pilha inválida' (invalid stack frame) na visualização Variáveis (Variables), vá para a visualização Depurar (Debug) e clique no objeto de encadeamento acima da estrutura de pilha e, em seguida, clique na estrutura de pilha. Isso deve atualizar a visualização Variáveis (Variables) e o erro não deve mais aparecer.
• Ao depurar um procedimento armazenado SQLJ que esteja sendo executado no DB2 UDB para iSeries V5 R4, a linha atual que está sendo executada não corresponderá à linha de origem SQLJ indicada exibida na visualização Depurar (Debug), a menos que tenha aplicado um iSeries PTF que atualize o mapa da linha para corresponder à origem SQLJ em vez da origem Java.
• As preferências do depurador para o tempo limite do gerenciador de sessão não são reconhecidas. Essas preferências são configuradas da seguinte maneira: Clique em Janela > Preferências (Window > Preferences), expanda o nó Executar/Depurar (Run/Debug) e clique em DB2 Stored Procedure Debugger. Modifique o campo Tempo Limite do Gerenciador de Sessão em Minutos (Session manager timeout in minutes).
• O depurador não pode processar um procedimento armazenado que tenha um grande número de variáveis no DB2 para Linux, UNIX e Windows. O número máximo de variáveis é 200.
• Movimento do cursor em uma sessão de depuração: Em alguns casos, quando houver mais de uma declaração de variável em um procedimento, você deve clicar em Percorrer em (Step Into) ou Percorrer sobre (Step Over) mais de uma vez para mover-se para a próxima linha. Por exemplo, você deve clicar duas vezes nessa linha: DECLARE v_dept, v_actdept CHAR(3); e três vezes nesta linha: DECLARE v_bonus, v_deptbonus, v_newbonus DECIMAL(9,2). Você deve clicar inúmeras vezes igual ao número de declarações de variável.
• Se você iniciar uma sessão de depuração para um procedimento armazenado Java e incluir pontos de interrupção e, em seguida, desativar os pontos de interrupção, os pontos de interrupção ainda estarão ativados. Para solucionar esse problema, ao iniciar uma nova sessão de depuração, você deve remover primeiro todos os antigos pontos de interrupção e, em seguida, incluir novos pontos de interrupção.
• Em alguns casos quando você estiver trabalhando com vários projetos de desenvolvimento de dados, talvez encontre um erro ao tentar depurar um procedimento armazenado que diz "Impossível Localizar o Procedimento Armazenado PROCNAME" (Unable to locate stored procedure PROCNAME). "Procedimento pode ter sido excluído do espaço de trabalho" (Procedure may have been deleted from workspace) ou "Origem Não Localizada" (Source not found).
• Se você estiver depurando um procedimento armazenado SQL logo depois de terminar uma sessão de depuração de um procedimento armazenado Java, o depurador pode mostrar "A função definida pelo usuário... foi interrompida pelo usuário" (User defined function ... has been interrupted by the user).  Para solucionar esse problema, tente depurar o procedimento armazenado SQL novamente.

1.4 Correções da Documentação

No tópico chamado "Utilizando o Visual Explain para Rotinas", há uma instrução incorreta sobre quais servidores são suportados no Visual Explain. O Visual Explain é suportado no sistema operacional e servidores a seguir:

O Visual Explain está disponível na plataforma Windows(R). Os seguintes servidores são suportados:

• DB2 UDB para Linux, UNIX e Windows, Versão 8.2
• DB2 Versão 9 para Linux, UNIX e Windows
• DB2 UDB para z/OS Versão 7 e Versão 8

Os pré-requisitos a seguir são requeridos antes de poder criar UDFs OLE DB com o Developer Workbench:

• DB2 UDB para Linux, UNIX e Windows, Versão 8 ou posterior.
• OLE DB 2.0 ou posterior, disponível na Microsoft no endereço http://www.microsoft.com. Se tentar chamar uma função de tabela OLE DB sem antes instalar o OLE DB, o DB2^(R) emite SQLCODE -465, SQLSTATE 58032, código de razão 35. Para obter os requisitos do sistema e os provedores OLE DB disponíveis para suas origens de dados, consulte a documentação de sua origem de dados. Para a especificação OLE DB, consulte Microsoft OLE DB 2.0 Programmer's Reference and Data Access SDK, Microsoft Press, 1998.
• db2olefn.dll deve estar registrado em seu computador. Para registrar esse arquivo DLL, digite regsvr32 DB2installdir\sqllib\function\db2olefn.dll em uma linha de comandos, onde DB2installdir é o diretório raiz onde o DB2 foi instalado.

Os pré-requisitos a seguir são requeridos antes de poder criar UDFs XML com o Developer Workbench:

• DB2 UDB para Linux, UNIX e Windows, Versão 8 ou posterior.
• Se quiser executar as transformações XSL no documento XML antes do processamento, seu banco de dados de destino deve ser ativado para o DB2 XML Extender. Ao ativar o DB2 XML Extender, os UDFs XSLTransform fornecidos pelo mecanismo do banco de dados estão disponíveis no banco de dados de destino para executar a transformação XSL. Para os bancos de dados locais, a ativação do DB2 XML Extender ocorre automaticamente. Para ativar um banco de dados remoto para o XML Extender, digite dxxadm enable_db sample a partir do diretório DB2installdir\sqllib\bin em uma linha de comandos, onde sample é seu banco de dados de destino e DB2installdir é o diretório no qual o DB2 foi instalado.

As ações a seguir não estão disponíveis quando você estiver trabalhando com uma conexão off-line no Database Explorer. Essas informações estão faltando no tópico chamado "Limitações para Conexões Off-line no Database Explorer":

• Configurar instruções SQL antes e depois da execução e configurar os parâmetro input ou inout através da ação de menu Executar Configurações.
• Depurar procedimentos armazenados no servidor atual.

Voltar ao Índice.

2.0 Informações da Instalação

• 2.1 Requisitos de Hardware e Software

• 2.2 Visão Geral da Instalação

• 2.3 Pré-requisitos da Instalação

• 2.4 Instalando o Fix Pack

• 2.5 Transferindo por Download o Fix Pack para Instalações Locais

• 2.6 Suporte ao Cliente
  

2.1 Requisitos de Hardware e Software

Requisitos de Hardware

Espaço em disco: 50 MB

Memória: 512 MB (1 GB recomendável)

Requisitos de Software

• Microsoft Windows 2000 Server e Professional, Microsoft Windows 2003 Server e Microsoft XP Professional
• Red Hat Enterprise Linux 3 e SUSE Linux Enterprise Server 9

Voltar ao Índice.

2.5 Transferindo por Download o Fix Pack para Instalações Locais

Deve-se instalar o fix pack diretamente a partir do servidor de atualizações da IBM; no entanto, ele também está disponível para download. Pode ser que você queira transferir por download e instalar o fix pack nas seguintes situações:

• Você tem uma conexão lenta ou instável com a Internet e deseja utilizar um gerenciador de download que pode retomar o download.
• Você tem dificuldade em acessar os servidores de atualizações da IBM por trás de um firewall.
• Você prefere transferir o fix pack por download e instalá-lo posteriormente.

Para transferir por download e instalar o fix pack, execute as seguintes etapas:

1. Transfira o fix pack por download a partir do endereço ftp://ftp.software.ibm.com/software/data/db2/udb/developerworkbench/91/zips/dwb_9102.zip.
2. Extraia o fix pack para um diretório temporário, como C:\temp.
3. Para obter instruções sobre a instalação, vá para C:\temp\dwbfp2\ e abra install_local_9102.html.

2.6 Suporte ao Cliente

Para obter novidades, eventos, suporte e outras informações para o produto, consulte a página inicial do DB2 no endereço http://www-306.ibm.com/software/data/db2/9/.

3.0 Avisos e Marcas Registradas

3.1 Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos. É possível que a IBM não ofereça os produtos, serviços ou recursos discutidos nesta publicação em outros países. Consulte um representante IBM local para obter informações sobre os produtos e serviços disponíveis atualmente em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM, poderá ser utilizado em substituição a este produto, programa ou serviço. Entretanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não-IBM são de responsabilidade do Cliente.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nesta publicação. O fornecimento desta publicação não garante ao Cliente nenhum direito sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para: Gerência de Relações Comerciais e Industriais da IBM Brasil, Av. Pasteur, 138-146, Botafogo, Rio de Janeiro, RJ, CEP 22290-240.

O parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a legislação local:

A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA" SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS IMPLÍCITAS DE NÃO-INFRAÇÃO, COMERCIALIZAÇÃO OU ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitem a exclusão de garantias expressas ou implícitas em certas transações; portanto, essa disposição pode não se aplicar ao Cliente.

Estas informações podem conter imprecisões técnicas ou erros tipográficos. Periodicamente são feitas alterações nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta publicação. A IBM pode, a qualquer momento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nesta publicação, sem aviso prévio.

Referências nesta publicação a Web sites não-IBM são fornecidos apenas por conveniência e não constituem endosso desses Web sites. Os materiais nesses Web sites não são parte dos materiais para este produto IBM e o uso destes Web sites é de inteira responsabilidade do cliente.

Licenciados deste programa que desejam obter informações sobre este assunto com objetivo de permitir: (i) a troca de informações entre programas criados independentemente e outros programas (incluindo este) e (ii) a utilização mútua das informações trocadas, devem entrar em contato com:

Tais informações podem estar disponíveis, sujeitas a termos e condições apropriadas, incluindo em alguns casos o pagamento de uma taxa.

O programa licenciado descrito nestas informações e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, Contrato de Licença de Programa Internacional IBM ou qualquer outro contrato equivalente.

As informações relativas a produtos não-IBM foram obtidas junto aos fornecedores dos respectivos produtos, de seus anúncios publicados ou de outras fontes disponíveis publicamente. A IBM não testou estes produtos e não pode confirmar a precisão de seu desempenho, compatibilidade nem qualquer outra reivindicação relacionada a produtos não-IBM. Dúvidas sobre os recursos de produtos não-IBM devem ser encaminhadas diretamente a seus fornecedores.

Todas as declarações relacionadas aos objetivos e intenções futuras da IBM estão sujeitas a alterações ou cancelamento sem aviso prévio e representam apenas metas e objetivos.

Estas informações contêm exemplos de dados e relatórios utilizados nas operações diárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplos podem incluir nomes de indivíduos, empresas, marcas e produtos. Todos estes nomes são fictícios e qualquer semelhança com nomes e endereços utilizados por uma empresa real é mera coincidência.

3.2 Marcas Registradas

IBM, Derby, Rational, DB2 Universal Database e zSeries são marcas ou marcas registradas da IBM Corporation nos Estados Unidos e/ou em outros países.

Java e todas as marcas registradas baseadas em Java são marcas registradas da Sun Microsystems, Inc. nos Estados Unidos e/ou em outros países.

Linux é uma marca registrada de Linus Torvalds nos Estados Unidos e/ou em outros países.

Microsoft, Windows 2000, Windows 2003 e Windows XP são marcas registradas da Microsoft Corporation nos Estados Unidos e/ou em outros países.

Outros nomes de empresas, produtos ou serviços podem ser marcas registradas ou marcas de serviço de terceiros.

Voltar ao Índice.