Notas sobre o Release ------------------------------------------------------------------------ IBM(R) DB2(R) Universal Database Notas sobre o Release Version 7 -- FixPak 6 (C) Copyright International Business Machines Corporation 2000, 2001. Todos os direitos reservados. Direitos Restritos aos Usurios do Governo dos Estados Unidos -- Uso, duplicao e divulgao restritos pelo documento GSA ADP Schedule Contract com a IBM Corporation. ndice * Prefcio ------------------------------------------------------------------------ Leia-me Primeiro * Destaques do FixPak 6 * Notas sobre o Produto o 2.1 CPUs Suportadas no DB2 Verso 7 para Solaris o 2.2 Correo do Locale do Chins no Linux Red Flag o 2.3 Definindo Locale Adicional do DB2 para Linux em um Ambiente Linux em Japons e Chins Simplificado o |2.4 Limitaes para Japons em PTX o 2.5 Problema do Centro de Controle no Microsoft Internet Explorer o |2.6 Perda de Funo do Centro de Controle o |2.7 CD do Netscape No Fornecido com o DB2 UDB o |2.8 Erros nos Arquivos Readme no XML o |2.9 Novas Melhorias de Negcios Inteligentes no DB2 Verso 7.2 o |2.10 Problemas no IBM DB2 OLAP Server Causados pelo FixPak 2A e Posterior o |2.11 Violao de Segmentao ao Utilizar o WebSphere 3.5.5 o |2.12 Correo Obrigatria para Aplicativos Java no AIX V4 * Notas sobre a Documentao Online (HTML, PDF e Search) o 3.1 Navegadores Web Suportados no Sistema Operacional Windows 2000 o 3.2 Pesquisando Informaes Online do DB2 no Solaris o 3.3 Comutando o NetQuestion pelo OS/2 para Utilizar TCP/IP o 3.4 Mensagens de Erro na Tentativa de Lanar o Netscape o 3.5 Requisitos de Configurao para o Adobe Acrobat Reader nos Sistemas Baseados em UNIX o 3.6 Referncia a SQL Fornecida em um Arquivo PDF ------------------------------------------------------------------------ Instalao e Configurao * Informaes Gerais sobre Instalao, Migrao e Configurao o 4.1 Fazendo Download dos Pacotes de Instalao para Todos os Clientes DB2 Suportados o 4.2 Requisito Adicional do Nvel de Correo do Solaris o |4.3 Instalando o DB2 Enterprise-Extended Edition no AIX o |4.4 Suporte ao Diretrio LDAP no Netscape + |4.4.1 Estendendo o Esquema do LDAP no Netscape o |4.5 Suporte para Plataformas Windows ME, Windows XP e Windows 2000 Datacenter Edition + |4.5.1 Windows XP + |4.5.1.1 Limitaes + |4.5.2 Windows ME + |4.5.2.1 Limitaes + |4.5.3 Windows 2000 Datacenter Server o |4.6 Instalando o DB2 no Windows 95 o 4.7 Instalando o DB2 no Windows 2000 o |4.8 Executando o DB2 no Windows 2000 Terminal Server, Modo de Administrao o 4.9 Suporte de Atualizao do Microsoft SNA Server e SNA Multisite (Commit de Duas Fases) o 4.10 Definir o ID do Usu rio e a Senha no IBM Communications Server para Windows NT (CS/NT) + 4.10.1 Definio do N o 4.11 A Instalao do DB2 Pode ser Interrompida se uma Unidade Removvel no Estiver Conectada o 4.12 Erro SQL1035N ao Utilizar CLP no Windows 2000 o 4.13 Problema de Migrao com Respeito s Exibies Definidas com os Registros Especiais o 4.14 Suporte ao Protocolo IPX/SPX no Windows 2000 o 4.15 Parando Processos do DB2 antes de Atualizar uma Verso Anterior do DB2 o 4.16 Execuo do db2iupdt aps a Instalao do DB2 se outro Produto do DB2 j Estiver Instalado o 4.17 Configurando o Ambiente Linux para Executar o Centro de Controle do DB2 o 4.18 DB2 Universal Database Enterprise Edition e DB2 Connect Enterprise Edition para Linux no S/390 o |4.19 Possvel Perda de Dados no Linux para S/390 o |4.20 Integrao do Desktop Gnome e KDE para DB2 no Linux o |4.21 Parmetros de Configurao do Kernel do Solaris (Valores Recomendados) o |4.22 DB2 Universal Database Enterprise - Extended Edition para UNIX - Iniciao R pida o 4.23 Parmetro do kernel shmseg para HP-UX o 4.24 Migrando Bancos de Dados de Controle do IBM Visual Warehouse o |4.25 Migrando ndices Exclusivos Utilizando o Comando db2uiddl o |4.26 Erro de Instalao da Verso AIX de 64 Bits + |4.26.1 Utilizando o SMIT o 4.27 Erros que Ocorreram Durante a Migrao o |4.28 Ativao da Licena do IBM(R) DB2(R) Connect + |4.28.1 Instalando sua Chave de Licena e Definindo o Tipo de Licena Utilizando o Centro de Licenas + |4.28.2 Instalando sua Chave de Licena e Definindo o Tipo de Licena Utilizando o Comando db2licm + |4.28.3 Consideraes Sobre Licena para Instalaes Distribudas o 4.29 Acessando Bancos de Ddados de Controle do Warehouse o 4.30 Produtos para Teste em CD-ROMs UNIX Enterprise Edition o 4.31 Produtos para Teste em CD-ROMs UNIX do DB2 Connect Enterprise Edition o |4.32 Configurao Adicional Necess ria Antes da Instalao do Centro de Cat logos de Informaes para a Web o |4.33 Informaes de Suporte a P gina de Cdigos e Idioma - Correo * Iniciao R pida do Data Links Manager o |5.1 Suporte no AIX 5.1 o 5.2 Dlfm Start Falha com a Mensagem: "Erro ao obter o afsfid para o prefixo" o 5.3 Definindo a Classe do Gerenciador de Armazenamento do Tivoli para Arquivos de Archive o 5.4 Requisitos de Espao em Disco para DFS Client Enabler o 5.5 Monitorando o Processo de Backend do Gerenciador do Data Links no AIX o 5.6 Instalando e Configurando o DB2 Data Links Manager para AIX: Consideraes Adicionais sobre a Instalao em Ambientes DCE-DFS o 5.7 Falha do Comando "dlfm add_prefix" o 5.8 No Evento de Pouca Freqncia que Copia o Daemon e que No Para com dlfm stop o 5.9 Instalando e Configurando o DB2 Data Links Manager para AIX: Instalando o DB2 Data Links Manager no AIX Utilizando o Utilit rio db2setup o 5.10 Instalando e Configurando DB2 Data Links Manager para AIX: Tarefa de Ps-Instalao no DCE-DFS o 5.11 Instalando e Configurando o DB2 Data Links Manager para AIX: Instalando Manualmente o DB2 Data Links Manager Utilizando o Smit o 5.12 Instalando e Configurando o DB2 Data Links DFS Client Enabler o 5.13 Instalando e Configurando o DB2 Data Links Manager para Solaris: o |5.14 Privilgios do Grupo de Administradores do Data Links no Windows NT o 5.15 Minimizar o Log para Instalao do DLFF (Data Links File System Filter) + 5.15.1 Registrando Mensagens aps a Instalao + |5.15.2 Minimizando o Registro em Sistemas Sun Solaris o 5.16 Restaurar DATALINK o 5.17 Eliminar o Data Links Manager o 5.18 Desinstalando os Componentes do DLFM Utilizando o SMIT pode Remover Conjuntos de Arquivos Adicionais o 5.19 Antes de Iniciar/Determinar o Nome do Host o 5.20 Trabalhando com o Data Links File Manager: fazendo a limpeza aps eliminar um DB2 Data Links Manager de um banco de dados DB2 o 5.21 Ao do Usu rio para a Falha do dlfm Client_conf o 5.22 DLFM1001E (Nova mensagem de erro) o 5.23 Opo do Arquivo de Configurao DLFM o |5.24 Problema Potencial ao Restaurar Arquivos o 5.25 Erro ao executar o script dmapp_prestart de Data Links/DFS no AIX o |5.26 Integrao do Tivoli Space Manager com o Data Links + |5.26.1 Restries e Limitaes o 5.27 Captulo 4. Instalando e configurando o DB2 Data Links Manager para AIX + 5.27.1 Consideraes comuns de instalao + 5.27.1.1 Migrando do DB2 File Manager Verso 5.2 para o DB2 Data Links Manager Verso 7 o |5.28 Captulo 6. Verificando a Instalao no AIX + |5.28.1 Solues Alternativas em Ambientes NFS * Suplemento da Instalao e Configurao o 6.1 Captulo 5. Instalando os Clientes DB2 em Sistemas Operacionais UNIX + |6.1.1 Parmetros de Configurao do Kernel do HP-UX o 6.2 Captulo 12. Executando Seus Prprios Aplicativos + 6.2.1 Efetuando a Vinculao dos Utilit rios de Banco de Dados Utilizando o Cliente de Run-Time + 6.2.2 Acesso de Clientes UNIX ao DB2 Utilizando ODBC o |6.3 Captulo 24. Configurando um Sistema Federado para Acessar V rias Fontes de Dados + |6.3.1 Sistemas Federados + |6.3.2 Restrio + |6.3.3 Instalando o DB2 Relational Connect + |6.3.3.1 Instalando o DB2 Relational Connect em Servidores Windows NT + |6.3.3.2 Instalando o DB2 Relational Connect em Servidores UNIX + |6.3.4 Captulo 24. Configurando o Sistema Federado para Acessar V rias Fontes de Dados + |6.3.4.1 Compreendendo o Esquema Utilizado com Pseudnimos + |6.3.4.2 Problemas ao Restaurar um Banco de Dados Federado em um Servidor Federado Diferente o |6.4 Captulo 26. Acessando Origens de Dados do Oracle + |6.4.1 Erros da Documentao o |6.5 Evitando Problemas ao Trabalhar com LOBs Remotos o |6.6 Acessando Origens de Dados do Sybase + |6.6.1 Incluindo Origens de Dados do Sybase em um Servidor Federado + |6.6.1.1 Etapa 1: Definir as Vari veis de Ambiente e Atualizar o Registro do Perfil (Apenas AIX e Solaris) + |6.6.1.2 Etapa 2: Ligar o DB2 ao Software do Cliente Sybase (Apenas AIX e Solaris) + |6.6.1.3 Etapa 3: Reciclar a Instncia do DB2 (Apenas AIX e Solaris) + |6.6.1.4 Etapa 4: Criar e Configurar um Arquivo de Interfaces + |6.6.1.5 Etapa 5: Criar o Wrapper + |6.6.1.6 Etapa 6: Opcional: Definir a Vari vel de Ambiente DB2_DJ_COMM + |6.6.1.7 Etapa 7: Criar o Servidor + |6.6.1.8 Etapa 8: Opcional: Definir a Opo do Servidor CONNECTSTRING + |6.6.1.9 Etapa 9: Criar um Mapeamento do Usu rio + |6.6.1.10 Etapa 10: Criar Pseudnimos para Tabelas e Exibies + |6.6.2 Especificando as P ginas de Cdigos do Sybase o |6.7 Acessando as Origens de Dados do Microsoft SQL Server Utilizando ODBC (Novo Captulo) + |6.7.1 Incluindo Origens de Dados do Microsoft SQL Server em um Servidor Federado + |6.7.1.1 Etapa 1: Definir as Vari veis de Ambiente (Apenas AIX) + |6.7.1.2 Etapa 2: Executar o Script de Shell (Apenas AIX) + |6.7.1.3 Etapa 3: Opcional: Definir a Vari vel de Ambiente DB2_DJ_COMM (Apenas AIX) + |6.7.1.4 Etapa 4: Reciclar a Instncia do DB2 (Apenas AIX) + |6.7.1.5 Etapa 5: Criar o Wrapper + |6.7.1.6 Etapa 6: Criar o Servidor + |6.7.1.7 Etapa 7: Criar um Mapeamento do Usu rio + |6.7.1.8 Etapa 8: Criar Pseudnimos para Tabelas e Exibies + |6.7.1.9 Etapa 9: Opcional: Obter Rastreios do ODBC + |6.7.2 Revendo P ginas de Cdigo do Microsoft SQL Server (Apenas Windows NT) o 6.8 Acessando Origens de Dados do Informix (Novo Captulo) + 6.8.1 Incluindo Origens de Dados do Informix em um Servidor Federado + 6.8.1.1 Etapa 1: Definir as Vari veis de Ambiente e Atualizar o Registro do Perfil + 6.8.1.2 Etapa 2: Ligar o DB2 ao Software Informix Client + 6.8.1.3 Etapa 3: Reciclar a instncia do DB2 + |6.8.1.4 Etapa 4: Criar o Arquivo sqlhosts do Informix + 6.8.1.5 Etapa 5: Criar o Wrapper + 6.8.1.6 Etapa 6: Opcional: Defina a Vari vel de Ambiente DB2_DJ_COMM + 6.8.1.7 Etapa 7: Criar o Servidor + 6.8.1.8 Etapa 8: Criar um Mapeamento do Usu rio + 6.8.1.9 Etapa 9: Criar Pseudnimos para Tabelas, Exibies e Sinnimos do Informix ------------------------------------------------------------------------ Administrao * Manual de Administrao o |7.1 Atualizao Disponvel * Manual de Administrao: Planejamento o |8.1 Captulo 8. Design do Banco de Dados Fsico + |8.1.1 Consideraes Sobre o Design da rea de Tabela + |8.1.1.1 Otimizando o Desempenho da rea de Tabela Quando os Dados So Colocados no Raid + |8.1.2 Chaves de Partio o 8.2 Apndice D. Incompatibilidade Entre Releases + |8.2.1 Erro SQL30081N No Retornado Quando Perda de Conexo Detectada o 8.3 Apndice E. NLS (National Language Support) + |8.3.1 Suporte ao Cdigo de Pas/Regio e P gina de Cdigos + |8.3.2 Consideraes sobre Importao/Exportao/Carregamento -- Restries para as P ginas de Cdigos 1394 e 5488 + |8.3.3 Valores de Data e Hora + |8.3.3.1 Representaes de Cadeia de Valores de Data e Hora + |8.3.3.2 Cadeias de Data + |8.3.3.3 Cadeias de Hora + |8.3.3.4 Cadeias de Marca de Hora + |8.3.3.5 Consideraes do Conjunto de Caracteres + |8.3.3.6 Formatos de Data e Hora * |Manual de Administrao: Implementao o |9.1 Captulo 8. Recuperando um Banco de Dados + |9.1.1 Como Utilizar E/S Suspensas o |9.2 Novo Mtodo para Especificar Contineres DMS no Windows 2000 e em Sistemas Posteriores o |9.3 Exemplo para Estender o Centro de Controle * |Manual de Administrao: Desempenho o |10.1 Esquemas de Tabelas Tempor rias do Sistema o |10.2 Captulo 8. Desempenho Operacional + |10.2.1 Conjunto de Buffers com Base em Bloco + |10.2.1.1 Exemplos de Conjuntos de Buffers Com Base em Blocos o |10.3 Captulo 10. Ajustando a Escala de Configurao Atravs da Incluso de Processadores + |10.3.1 Problemas Ao Incluir Ns em um Banco de Dados Particionado o |10.4 Captulo 13. Configurando o DB2 + |10.4.1 Concluso do Archive de Log Agora Verificada Mais Freqentemente o |10.5 Vari veis de Ambiente e Registro do DB2 + |10.5.1 Correes de Vari veis de Desempenho + |10.5.2 Correes e Incluses nas Vari veis de Registro Diversas + |10.5.3 Correes e Adies s Vari veis de Registro Gerais * |Manual e Referncia de Administrao de Satlites o |11.1 Configurando o DB2 Personal Edition Verso 7.2 e o DB2 Workgroup Edition como Satlites + |11.1.1 Pr-requisitos + |11.1.1.1 Consideraes de Instalao + |11.1.2 Configurando o Sistema Verso 7.2 para Sincronizao + |11.1.3 Instalando o FixPak 2 ou Superior em um Sistema Enterprise Edition Verso 6 + |11.1.3.1 Atualizando o DB2 Enterprise Edition Verso 6 para Uso como o DB2 Control Server + |11.1.4 Atualizando uma Verso 6 do Centro de Controle e do Centro de Administrao do Satlite * |Referncia de Comandos o |12.1 Atualizao Disponvel o |12.2 db2updv7 - Atualizar o Banco de Dados para o Nvel de Correo Atual da Verso 7 o |12.3 REBIND + |Missing value o |12.4 db2inidb - Inicializar um Banco de Dados Espelhado + |12.4.1 Informaes de Utilizao o |12.5 Opo Adicional no Comando GET ROUTINE + |GET ROUTINE o |12.6 CREATE DATABASE * |Recuperao de Dados e Guia e Referncia de Alta Disponibilidade o |13.1 Recuperao de Dados e Guia e Referncia de Alta Disponibilidade Disponvel Online o |13.2 Novo Backup e Comportamento de Restaurao quando LOGRETAIN=CAPTURE o |13.3 NEWLOGPATH2 Agora Chamado de DB2_NEWLOGPATH2 o |13.4 Escolhendo um Mtodo de Backup para o DB2 Data Links Manager no AIX ou Solaris o |13.5 Tivoli Storage Manager -- LAN Free Data Transfer * Guia e Referncia dos Utilit rios de Movimento dos Dados o |14.1 Alterao de Tratamento de Arquivo LOB por Exportar, Importar e Carregar + |14.1.1 Consideraes de IXF o |14.2 Suporte P gina de Cdigos para Utilit rios de Importao, Exportao e Carregamento o |14.3 db2relocatedb (Novo Comando) + |db2relocatedb - Realocar Banco de Dados o |14.4 db2move -- Novas Opes Disponveis + |Movendo Dados Usando a Ferramenta db2move o 14.5 Captulo 2. Importar + 14.5.1 Utilizando importao com inseres em buffer o 14.6 Captulo 3. Carregar + 14.6.1 Estados Pendentes Aps uma Operao de Carregamento + 14.6.2 Restries e Limitaes de Carregamento + 14.6.3 Modificador de tipo do arquivo totalfreespace o 14.7 Captulo 4. Carregador Autom tico + 14.7.1 rexecd Obrigatrio para Executar o AutoLoader Quando a Autenticao Estiver Definida como YES o 14.8 O Carregador Autom tico Pode Travar Durante uma Bifurcao o 14.9 Apndice C. Formatos de Arquivo do Utilit rio de Exportao/Importao/Carregamento * Manual de Referncia e Replicao o 15.1 Replicao e Servidores No-IBM o 15.2 Replicando no Windows 2000 o |15.3 Erro Conhecido Ao Salvar os Arquivos SQL o |15.4 Manuteno do DB2 o |15.5 Utilit rio de Diferena de Dados na Web o 15.6 Captulo 3. Cen rio de Replicao de Dados + 15.6.1 Cen rios de Replicao o 15.7 Captulo 5. Planejando a Replicao + 15.7.1 Nomes de Tabelas e Colunas + 15.7.2 Replicando o DATALINK + 15.7.3 Restries LOB + 15.7.4 Planejando a Replicao o 15.8 Captulo 6. Configurando o Ambiente de Replicao + 15.8.1 Pr-requisito Update-anywhere + 15.8.2 Configurando Seu Ambiente de Replicao o 15.9 Captulo 8. Determinao de Problemas o 15.10 Captulo 9. Capture e Apply para AS/400 o 15.11 Captulo 10. Capture e Apply para OS/390 + |15.11.1 Pr-requisitos para DB2 DataPropagator para OS/390 + |15.11.2 Esquemas de Codificao do UNICODE e ASCII no OS/390 + |15.11.2.1 Escolhendo um Esquema de Codificao + |15.11.2.2 Definindo Esquemas de Codificao o 15.12 Captulo 11. Capture e Apply para plataformas UNIX + |15.12.1 Definindo Vari veis de Ambiente para Capture e Apply no UNIX e Windows o 15.13 Captulo 14. Estruturas de Tabelas o 15.14 Captulo 15. Mensagens de Capture e Apply o 15.15 Apndice A. Iniciando os Programas Capture e Apply de um Aplicativo * Manual e Referncia do System Monitor o 16.1 db2ConvMonStream * Manual da Soluo de Problemas o 17.1 Iniciando o DB2 no Windows 95, Windows 98 e Windows ME quando o usu rio no iniciou sesso o |17.2 Captulo 1. Pr ticas Recomend veis para Deteco de Problemas + |17.2.1 Ferramenta de An lise de Problemas e Coleta de Ambiente + |17.2.1.1 Sadas de Coleta + |17.2.1.2 Exibindo o detailed_system_info.html + |17.2.1.3 Exibindo a Sintaxe da Ferramenta de Suporte ao DB2, Uma P gina por Vez o |17.3 Captulo 2. Detectando Problemas no DB2 Universal Database Server o |17.4 Captulo 8. Detectando Problemas no DB2 Data Links Manager * Utilizando o DB2 Universal Database em Plataformas de 64 bits o 18.1 Captulo 5. Configurao + 18.1.1 LOCKLIST + 18.1.2 shmsys:shminfo_shmmax o 18.2 Captulo 6. Restries * Administrao e Programao do XML Extender * |MQSeries o |20.1 Instalao e Configurao das Funes do DB2 MQSeries + |20.1.1 Instalar o MQSeries + |20.1.2 Instalar o MQSeries AMI + |20.1.3 Ativar as Funes do DB2 MQSeries o |20.2 Estilos de Mensagens do MQSeries o |20.3 Estrutura da Mensagem o |20.4 Viso Geral Funcional do MQSeries + |20.4.1 Limitaes + |20.4.2 Cdigos de Erros o |20.5 Cen rios de Utilizao + |20.5.1 Mensagens B sicas + |20.5.2 Enviando Mensagens + |20.5.3 Recuperando Mensagens + |20.5.4 Conectividade de Aplicativo a Aplicativo + |20.5.4.1 Comunicaes de Pedido/Resposta + |20.5.4.2 Publicar/Associar o |20.6 enable_MQFunctions + |enable_MQFunctions o |20.7 disable_MQFunctions + |disable_MQFunctions ------------------------------------------------------------------------ Ferramentas Administrativas * |Configurao Adicional Antes de Executar Ferramentas o |21.1 Desativando a Pilha de Ponto Flutuante no Linux o |21.2 Nvel de Java Especfico Requerido em um Ambiente Linux em Japons * Centro de Controle o 22.1 Capacidade de Administrar o Servidor do DB2 para Servidores VSE e VM o 22.2 Suporte a Java 1.2 para o Centro de Controle o 22.3 Erro "Atalho inv lido" ao Usar a Ajuda Online no Sistema Operacional Windows o 22.4 Atalhos do Teclado Que No Funcionam o 22.5 Centro de Controle Java no OS/2 o 22.6 Erro "Acesso negado ao arquivo" ao Tentar Exibir um Job Concludo no Di rio no Sistema Operacional Windows o 22.7 Teste de Conexo de Atualizao Multisites o 22.8 DB2 Control Center para OS/390 o 22.9 Correo Exigida do Centro de Controle para OS/390 o 22.10 Alterao no Di logo Criar Camada Espacial o 22.11 Informaes de Deteco de Problemas para o DB2 Control Center o 22.12 Resolvendo Problemas do Centro de Controle em Sistemas Baseados em UNIX o 22.13 Possveis Problemas Com Infopops no OS/2 o 22.14 Ajuda do Parmetro de Configurao jdk11_path o 22.15 Erro do Sistema Solaris (SQL10012N) na Utilizao do Centro de Scripts ou do Di rio o 22.16 Ajuda ao Arquivo DPREPL.DFT o 22.17 Lanando Mais de Um Applet do Centro de Controle o 22.18 Ajuda Online do Centro de Controle em Execuo como um Applet o 22.19 Executando o Centro de Controle no Modo Applet (Windows 95) o |22.20 Trabalhando com Resultados de Consulta Grande * Centro de Comandos o |23.1 P gina Interativa do Centro de Comandos Agora Reconhece o Finalizador de Instruo * Centro de Informaes o |24.1 Correes do Documento de Exemplos Java o 24.2 Erro "Atalho Inv lido" no Sistema Operacional Windows o 24.3 Abrindo links da Web externos no Netscape Navigator quando o Netscape j est aberto (Sistemas baseados em UNIX) o 24.4 Problemas ao Iniciar o Centro de Informaes * Assistentes o 25.1 Definindo o Tamanho Estendido no Assistente Criar Banco de Dados o |25.2 Assistente de Ajuda do MQSeries o |25.3 Assistente de Ajuda do OLE DB o |25.4 Construindo Procedimentos Java Armazenados para OS/390 Utilizando o Stored Procedure Builder ------------------------------------------------------------------------ Inteligncia de Negcios * Tutorial Business Intelligence o 26.1 Tutorial Revisado do Business Intelligence * Apresentao do DB2 Universal Database * |Data Warehouse Center Manual de Administrao o |28.1 Atualizao Disponvel o |28.2 Melhorias do Servidor Warehouse o |28.3 Utilizando o Agente do OS/390 para Executar um Trillium Batch System JCL o |28.4 Dois Novos Programas de Exemplo no Data Warehouse Center o |28.5 Managing ETI.Extract(R) Conversion Programs with DB2 Warehouse Manager Atualizado o |28.6 Importando e Exportando Metadados Utilizando a CWMI (Common Warehouse Metadata Interchange) + |28.6.1 Introduo + |28.6.2 Importando metadados + |28.6.3 Atualizando os metadados Aps Executar o Utilit rio de Importao + |28.6.4 Exportando metadados o |28.7 Utilit rio de Importao/Exportao de Metadados da Linguagem de Marcao + |28.7.1 Definies de Chaves + |28.7.2 Planejamentos de Etapas e Processos o |28.8 Informaes da Etapa SAP + |28.8.1 Possibilidade de Criar Tabela Logicamente Inconsistente o |28.9 Informaes do Conector SAP + |28.9.1 Restries Instalao do Conector SAP + |28.9.2 Desempenho de GetDetail BAPI * DB2 OLAP Starter Kit o |29.1 Site da Web do OLAP Server o |29.2 Nveis de Servios do Sistema Operacional Suportados o 29.3 Concluindo a Configurao do DB2 OLAP Starter Kit no UNIX o |29.4 Configurao Adicional para o Ambiente Operacional Solaris o |29.5 Configurao Adicional para Todos os Sistemas Operacionais o |29.6 Configurando o ODBC para o OLAP Starter Kit + |29.6.1 Configurando Origens de Dados em Sistemas UNIX + |29.6.1.1 Configurando as Vari veis de Ambiente ODBC + |29.6.1.2 Editando o Arquivo odbc.ini + |29.6.1.3 Incluindo uma Origem de Dados em um Arquivo odbc.ini + |29.6.1.4 Exemplo de Definies ODBC para DB2 + |29.6.1.5 Exemplo de Definies ODBC para Oracle + |29.6.2 Configurando o OLAP Metadata Catalog em Sistemas UNIX + |29.6.3 Configurando as Origens de Dados em Sistemas Windows + |29.6.4 Configurando o OLAP Metadata Catalog em Sistemas Windows + |29.6.5 Aps Voc Configurar uma Origem de Dados o 29.7 Iniciando sesso do OLAP Starter Kit Desktop + 29.7.1 Exemplo de Login do Starter Kit o 29.8 Criando e Configurando Manualmente os Bancos de Dados de Amostra para OLAP Starter Kit o |29.9 Migrando Aplicativos para OLAP Starter Kit Verso 7.2 o |29.10 Problemas e Limitaes Conhecidos o 29.11 Arquivos EQD do Complemento da Planilha OLAP Faltando * Manual de Administrao do Information Catalog Manager o 30.1 Utilit rio de Inicializao do Gerenciador do Cat logo de Informaes + 30.1.1 + 30.1.2 Questes de licenciamento + 30.1.3 Questes de instalao o |30.2 Melhorias para o Information Catalog Manager o |30.3 Incompatibilidade entre o Information Catalog Manager e o Sybase no Ambiente Windows o 30.4 Acessando os Cat logos de Informaes do DB2 Verso 5 com o Information Catalog Manager do DB2 Verso 7 o 30.5 Configurando um Cat logo de Informaes o 30.6 Trocando Metadados com Outros Produtos o 30.7 Trocando metadados utilizando o comando flgnxoln o 30.8 Trocando metadados utilizando o comando MDISDGC o 30.9 Invocando programas * Manual de Referncia do Information Catalog Manager Programming o 31.1 Cdigos de Razo do Gerenciador do Cat logo de Informaes * Manual do Usu rio do Information Catalog Manager * Information Catalog Manager: Menssagens Online o 33.1 Correes nas Mensagens FLG + 33.1.1 Mensagem FLG0260E + 33.1.2 Mensagem FLG0051E + 33.1.3 Mensagem FLG0003E + 33.1.4 Mensagem FLG0372E + 33.1.5 Mensagem FLG0615E * Information Catalog Manager: Ajuda Online o 34.1 Gerenciador do Cat logo de Informaes para a Web * DB2 Warehouse Manager Installation Guide o |35.1 Atualizao disponvel da Publicao DB2 Warehouse Manager Installation Guide Disponvel o |35.2 Requisitos de software para transformadores do warehouse o |35.3 Consideraes Ps-instalao para o Agente iSeries o |35.4 Antes de Utilizar Transformadores com o Agente do Warehouse do iSeries * Manual de Administrao do Query Patroller o 36.1 O Cliente do DB2 Query Patroller um Componente Separado o |36.2 Alterando o Status do N o 36.3 Migrando da Verso 6 do DB2 Query Patroller Utilizando dqpmigrate o 36.4 Ativando o Query Management o |36.5 Localizao da rea de Tabela para Tabelas de Controle o |36.6 Novos Parmetros para o Comando dqpstart o |36.7 Novo Parmetro para o Comando iwm_cmd o |36.8 Nova Vari vel de Registro: DQP_RECOVERY_INTERVAL o 36.9 Iniciando o Query Administrator o 36.10 Administrao do Usu rio o |36.11 Administrao da Origem de Dados o 36.12 Criando uma Fila de Jobs o |36.13 Tabela de Contabilizao do Job o 36.14 Utilizando a Interface da Linha de Comandos o 36.15 Notas do Query Enabler o 36.16 O rastreador do DB2 Query Patroller pode retornar uma p gina de coluna em branco o |36.17 Informaes Adicionais para a Ferramenta da GUI do Tracker do DB2 Query Patroller o |36.18 Query Patroller e Ferramentas de Replicao o |36.19 Melhorando o Desempenho do Query Patroller o 36.20 O Privilgio EXECUTE para Usu rios do Query Patroller Criados na Verso 6 no est Implementado o 36.21 Restries do Query Patroller o 36.22 Apndice B. Detectando problemas em clientes do DB2 Query Patroller ------------------------------------------------------------------------ Desenvolvimento de Aplicativos * Administrative API Reference o 37.1 db2ArchiveLog (nova API) + db2ArchiveLog o 37.2 db2ConvMonStream o 37.3 db2DatabasePing (nova API) + db2DatabasePing - Banco de Dados para Execuo de Ping o 37.4 db2HistData o 37.5 db2HistoryOpenScan o 37.6 db2XaGetInfo (nova API) + db2XaGetInfo - Obter Informaes para o Gerenciador de Recursos o 37.7 db2XaListIndTrans (nova API que sobrepe sqlxphqr) + db2XaListIndTrans - Lista Transaes Duvidosas o 37.8 db2GetSnapshot - Obter instantneo o |37.9 Registro de Log Esquecido o 37.10 sqlaintp - Obter mensagem de erro o 37.11 sqlbctcq - Fechar consulta do continer da rea da tabela o |37.12 sqleseti - Definir Informaes do Cliente o 37.13 sqlubkp - Backup do banco de dados o 37.14 sqlureot - Reorganizar tabela o 37.15 sqlurestore - Restaurar banco de dados o 37.16 Erro na Documentao com Relao ao Suporte de Memria Compartilhada Estendida (EXTSHM) do AIX o 37.17 SQLFUPD + 37.17.1 locklist o 37.18 SQLEDBDESC * Application Building Guide o |38.1 Atualizao Disponvel o |38.2 Notas Adicionais para Distribuio de Procedimentos SQL Compilados * |Application Development Guide o |39.1 Atualizao Disponvel o |39.2 Novos Requisitos para executeQuery e executeUpdate o |39.3 Suporte ao Driver JDBC para Mtodos Adicionais o |39.4 o |39.5 Provedor IBM OLE DB para DB2 UDB * Manual de Referncia ao CLI o 40.1 Efetuando a vinculao dos Utilit rios de Banco de Dados Utilizando o Cliente de Run-Time o 40.2 Utilizando SQL Est tico em Aplicativos CLI o 40.3 Limitaes do Perfilamento Est tico JDBC/ODBC/CLI o 40.4 Transformaes ADT o |40.5 Captulo 1. Introduo CLI + |40.5.1 Diferenas entre a CLI do DB2 e a SQL Incorporada o 40.6 Captulo 3. Utilizando Recursos Avanados + |40.6.1 Gravando Aplicativos de Multi-Encadeamento + 40.6.2 Escrevendo um Aplicativo Unicode do DB2 CLI + 40.6.2.1 Funes Unicode + 40.6.2.2 Novos Tipos de Dados e Converses V lidas + 40.6.2.3 Palavra-Chave Obsoleta/Valor de Correo + 40.6.2.4 Literais em Bancos de Dados Unicode + 40.6.2.5 Configurao das Palavras-chave CLI Nova + |40.6.3 MTS (Microsoft Transaction Server) como Transaction Monitor + 40.6.4 Scrollable Cursors + 40.6.4.1 Suporte ao cursor desloc vel no lado do servidor para OS/390 + 40.6.5 Utilizando o SQL Composto + 40.6.6 Utilizando os Procedimentos Armazenados + |40.6.6.1 Privilgios para Construir e Depurar Procedimentos SQL e Java Armazenados + 40.6.6.2 Gravando um Procedimento Armazenado em CLI + 40.6.6.3 Procedimentos Armazenados e Vinculao Autom tico da CLI o 40.7 Captulo 4. Configurando CLI/ODBC e executando amostras de aplicativos + |40.7.1 Palavras-chave de configurao + |40.7.1.1 CURRENTFUNCTIONPATH + |40.7.1.2 SKIPTRACE o 40.8 Captulo 5. Funes da CLI do DB2 + 40.8.1 SQLBindFileToParam - Ligar Referncia do Arquivo do LOB ao Parmetro do LOB + |40.8.2 SQLColAttribute -- Retornar um Atributo de Coluna + |40.8.3 SQLGetData - Obter Dados de uma Coluna + |40.8.4 SQLGetInfo - Obter Informaes Gerais + |40.8.5 SQLGetLength - Recuperar Comprimento de um Valor de Cadeia + 40.8.6 SQLNextResult - Associar o Prximo Conjunto de Resultados a Outra Manipulao de Instruo + 40.8.6.1 Objetivo + 40.8.6.2 Sintaxe + 40.8.6.3 Argumentos de Funo + 40.8.6.4 Uso + 40.8.6.5 Cdigos de Retorno + 40.8.6.6 Diagnsticos + 40.8.6.7 Restries + 40.8.6.8 Referncias + |40.8.7 SQLSetEnvAttr - Definir Atributo de Ambiente + |40.8.8 SQLSetStmtAttr -- Definir Opes Relacionadas a uma Instruo o |40.9 Apndice C. DB2 CLI e ODBC + |40.9.1 Aplicativos Unicode do ODBC + |40.9.1.1 Aplicativos Unicode Versus No-Unicode do ODBC o 40.10 Apndice D. Funes Escalares Estendidas + 40.10.1 Funes de Data e Hora o 40.11 Apndice K. Utilizando a Funcionalidade de Rastreamento do DB2 CLI/ODBC/JDBC * |Referncia de Mensagens o |41.1 Atualizao Disponvel o |41.2 Atualizaes de Mensagens o |41.3 Lendo Texto de Mensagens Online * Referncia a SQL o |42.1 Atualizao Disponvel da SQL Reference o |42.2 Ativando as Novas Funes e Procedimentos o |42.3 SET SERVER OPTION - Erro da Documentao o |42.4 GRANT (Privilgios de Tabela, Exibio ou Pseudnimo) - Erro da Documentao o 42.5 Informaes do MQSeries + 42.5.1 Funes Escalares + |42.5.1.1 MQPUBLISH + |42.5.1.2 MQREADCLOB + |42.5.1.3 MQRECEIVECLOB + |42.5.1.4 MQSEND + 42.5.2 Funes da Tabela + |42.5.2.1 MQREADALLCLOB + |42.5.2.2 MQRECEIVEALLCLOB + |42.5.3 Dados CLOB Agora So Suportados nas Funes do MQSeries o 42.6 Informaes de Tipos de Dados + 42.6.1 Promoo de Tipos de Dados + 42.6.2 Converso Entre Tipos de Dados + 42.6.3 Atribuies e Comparaes + 42.6.3.1 Atribuies de Cadeia + 42.6.3.2 Comparaes de Cadeias + 42.6.4 Regras para Tipos de Dados de Resultado + 42.6.4.1 Cadeias de Caracteres e Gr ficas em um Banco de Dados Unicode + 42.6.5 Regras para Converses de Cadeias + 42.6.6 Expresses + 42.6.6.1 Com o Operador de Concatenao + 42.6.7 Predicados o |42.7 Informaes de Unicode + |42.7.1 Funes Escalares e Unicode o |42.8 Tipo de GRAPHIC e Compatibilidade de DATE/TIME/TIMESTAMP + |42.8.1 Representaes de Cadeia de Valores de Data e Hora + |42.8.1.1 Cadeias de Data, Cadeias de Hora e Cadeias de Data e Hora + |42.8.2 Convertendo entre Tipos de Dados + |42.8.3 Atribuies e Comparaes + |42.8.4 Atribuies de Data e Hora + |42.8.5 DATE + |42.8.6 GRAPHIC + |42.8.7 TIME + |42.8.8 TIMESTAMP + |42.8.9 VARGRAPHIC o 42.9 Chaves de ndice maiores para bancos de dados Unicode + 42.9.1 ALTER TABLE + 42.9.2 CREATE INDEX + 42.9.3 CREATE TABLE o |42.10 Seo Notas da Instruo ALLOCATE CURSOR Incorreta o |42.11 Opes Adicionais na Instruo GET DIAGNOSTICS + |Instruo GET DIAGNOSTICS o |42.12 ORDER BY em Sub-selees + |42.12.1 seleo completa + |42.12.2 subselect + |42.12.3 order-by-clause + |42.12.4 select-statement + |Instruo SELECT INTO + |42.12.5 Funes OLAP (window-order-clause) * |Novo Argumento de Entrada para o Procedimento GET_ROUTINE_SAR * |Autorizao Obrigatria para a Instruo SET INTEGRITY * |Apndice N. Tabelas de Exceo * Atualizaes do Unicode o 46.1 Introduo + 46.1.1 Bancos de Dados e Aplicativos do DB2 Unicode + 46.1.2 Atualizaes de Documentao ------------------------------------------------------------------------ Conectando aos Sistemas Host * |Manual do Usu rio do DB2 Connect o |47.1 Aumentando Taxas de Transferncia de Dados do DB2 Connect + |47.1.1 Blocos de Consulta Extra + |47.1.2 RFC-1323 Window Scaling o |47.2 Suporte do DB2 Connect para Transaes Acopladas Soltas o |47.3 Suporte a Kerberos * Connectivity Supplement o 48.1 Configurando o Servidor de Aplicativos em um Ambiente VM o 48.2 Configurao do PATCH1 CLI/ODBC/JDBC e Definies do PATCH2 ------------------------------------------------------------------------ Informaes Adicionais * Outras Informaes o 49.1 O DB2 Everywhere Agora DB2 Everyplace o 49.2 Recursos de Acessibilidade do DB2 UDB Verso 7 + 49.2.1 Entrada de Dados e Navegao atravs do Teclado + 49.2.1.1 Entrada de Dados atravs do Teclado + 49.2.1.2 Foco do Teclado + 49.2.2 Recursos para Exibio Acessvel + 49.2.2.1 Modo Alto Contraste + 49.2.2.2 Definies das Fontes + 49.2.2.3 No dependente da Cor + 49.2.3 Janela de Mensagem de Alerta Alternativa + 49.2.4 Compatibilidade com Tecnologias de Apoio + 49.2.5 Documentao de F cil Acesso o 49.3 Exigncias de Mouse o 49.4 Tentativa para fazer a vinculao a partir dos Resultados do Cliente de Run-Time do DB2 em um Erro "Arquivos de Vinculao no encontrados" o 49.5 Pesquisa de Descoberta o 49.6 Janelas de Memria do HP-UX 11 o 49.7 Desinstalando o DB2 DFS Client Enabler o 49.8 Autenticao de Cliente no Windows NT o 49.9 Restries de Sistemas Federados o |49.10 Limitaes Federadas com Tabelas Particionadas MPP o 49.11 Restrio do DataJoiner o 49.12 Gerenciador do Cat logo de Informaes em Hebraico para Windows NT o 49.13 SNA SPM do DB2 Falhou ao Iniciar Aps a Inicializao do Windows o 49.14 Requisitos da Conta de Servio para DB2 no Windows NT e Windows 2000 o 49.15 Necess rio Fazer o Commit de Todos os Programas Definidos pelo Usu rio que sero Usados no Data Warehouse Center (DWC) o 49.16 Armazenamento em Cache do Cliente no Windows NT o |49.17 Life Sciences Data Connect + |49.17.1 Novos Wrappers + |49.17.2 Avisos- o 49.18 Melhorias no SQL Assist o |49.19 Ajuda para Comandos de Backup e de Restaurao o 49.20 O "Warehouse Manager" Deveria Ser "DB2 Warehouse Manager" ------------------------------------------------------------------------ Apndices * Apndice A. Avisos o A.1 Marcas ------------------------------------------------------------------------ Prefcio |Bem-vindo ao DB2 Universal Database Verso 7 FixPak 6! Nota: Ao exibir como texto, defina a fonte para espaamento uniforme para uma melhor exibio destas Notas de Release. O site do DB2 Universal Database e do DB2 Connect Support atualizado regularmente. Verifique http://www.ibm.com/software/data/db2/udb/winos2unix/support para obter as ltimas informaes. Este arquivo contm informaes sobre os seguintes produtos que no estavam disponveis quando os manuais DB2 foram impressos: IBM DB2 Universal Database Personal Edition, Verso 7.2 IBM DB2 Universal Database Workgroup Edition, Verso 7.2 IBM DB2 Universal Database Enterprise Edition, Verso 7.2 IBM DB2 Data Links Manager, Verso 7.2 IBM DB2 Universal Database Enterprise - Extended Edition, Verso 7.2 IBM DB2 Query Patroller, Verso 7.2 IBM DB2 Personal Developer's Edition, Verso 7.2 IBM DB2 Universal Developer's Edition, Verso 7.2 IBM DB2 Data Warehouse Manager, Verso 7.2 IBM DB2 Relational Connect, Verso 7.2 IBM DB2 Connect Personal Edition, Verso 7.2 IBM DB2 Connect Enterprise Edition, Verso 7.2 Um arquivo adicional de Notas de Release, instalado como READCON.TXT, fornecido para os seguintes produtos: IBM DB2 Connect Personal Edition, Verso 7.2 IBM DB2 Connect Enterprise Edition, Verso 7.2 A documentao do produto DB2 Life Sciences Data Connect est disponvel para download no site de software da IBM: http://www.ibm.com/software/data/db2/lifesciencesdataconnect/ library.html. Informaes sobre esse produto esto disponveis online em http://www.ibm.com/software/data/db2/lifesciencesdataconnect. | | | | | | | | | |Os manuais a seguir foram atualizados para o FixPak 4 e os PDFs mais atuais |esto disponveis para download online em http://www.ibm.com/software/data/db2/udb/winos2unix/support: |Manual de Administrao |Application Building Guide |Application Development Guide |Referncia de Comandos |Recuperao de Dados e Guia e Referncia de Alta Disponibilidade |Data Warehouse Center Manual de Administrao |Referncia de Mensagens |SQL Reference |DB2 Warehouse Manager Installation Guide |As informaes nestas notas so um complemento s referncias |atualizadas. Toda a documentao atualizada tambm est disponvel em |CD. Esse CD pode ser adquirido atravs do servio DB2, utilizando o |nmero de PTF U478862. Informaes sobre como entrar em contato com o |Servio DB2 esto disponveis em http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/help.d2w/report. A publicao O que H de Novo contm uma viso geral de algumas das principais melhorias do DB2 para a Verso 7.2. Se voc no tiver a verso 7.2 da publicao O que H de Novo, poder exibir e fazer download dessa verso em http://www.ibm.com/software/data/db2/udb/winos2unix/support. Para obter as informaes mais atuais sobre a famlia de produtos DB2, obtenha uma assinatura gratuita da "Revista do DB2". A edio online da revista est disponvel no endereo http://www.db2mag.com; as instrues para o pedido de uma assinatura tambm esto divulgados neste site. Nota: |Nestas Notas sobre o Release, quando feita referncia ao Windows |NT, isso inclui o Windows 2000. A referncia inclui Windows XP quando |no contexto dos produtos listados em 4.5, Suporte para Plataformas Windows ME, Windows XP e Windows 2000 Datacenter Edition, a no ser que especificado de outro modo. | Nota: |Uma barra de reviso (|) esquerda de uma p gina indica que a linha |foi includa ou modificada desde a primeira publicao das Notas sobre o |Release. | ------------------------------------------------------------------------ Leia-me Primeiro ------------------------------------------------------------------------ Destaques do FixPak 6 As seguintes novas informaes foram includas nesse FixPak. Esta lista no completa, mas destaca as principais alteraes na documentao. Certifique-se de verificar quaisquer sees das notas de release que se relacionem ao seu ambiente de trabalho para ter certeza de estar a par de todas as atualizaes pertinentes. * 2.4, Limitaes para Japons em PTX * 2.12, Correo Obrigatria para Aplicativos Java no AIX V4 * 4.3, Instalando o DB2 Enterprise-Extended Edition no AIX * 4.6, Instalando o DB2 no Windows 95 * 4.32, Configurao Adicional Necess ria Antes da Instalao do Centro de Cat logos de Informaes para a Web * 6.3.4, Captulo 24. Configurando o Sistema Federado para Acessar V rias Fontes de Dados * 6.5, Evitando Problemas ao Trabalhar com LOBs Remotos * 8.1.2, Chaves de Partio * 8.2.1, Erro SQL30081N No Retornado Quando Perda de Conexo Detectada * 8.3.3, Valores de Data e Hora * 10.4.1, Concluso do Archive de Log Agora Verificada Mais Freqentemente * 9.2, Novo Mtodo para Especificar Contineres DMS no Windows 2000 e em Sistemas Posteriores * 9.3, Exemplo para Estender o Centro de Controle * 25.4, Construindo Procedimentos Java Armazenados para OS/390 Utilizando o Stored Procedure Builder * 28.8.1, Possibilidade de Criar Tabela Logicamente Inconsistente * 35.3, Consideraes Ps-instalao para o Agente iSeries * 36.11, Administrao da Origem de Dados * 36.13, Tabela de Contabilizao do Job * 36.17, Informaes Adicionais para a Ferramenta da GUI do Tracker do DB2 Query Patroller * 38.2, Notas Adicionais para Distribuio de Procedimentos SQL Compilados * 39.2, Novos Requisitos para executeQuery e executeUpdate * 39.3, Suporte ao Driver JDBC para Mtodos Adicionais * 40.6.6.1, Privilgios para Construir e Depurar Procedimentos SQL e Java Armazenados * 42.3, SET SERVER OPTION - Erro da Documentao * 42.4, GRANT (Privilgios de Tabela, Exibio ou Pseudnimo) - Erro da Documentao * 42.8, Tipo de GRAPHIC e Compatibilidade de DATE/TIME/TIMESTAMP * 42.10, Seo Notas da Instruo ALLOCATE CURSOR Incorreta * Apndice N. Tabelas de Exceo * 47.2, Suporte do DB2 Connect para Transaes Acopladas Soltas * 47.3, Suporte a Kerberos * 40.8.3, SQLGetData - Obter Dados de uma Coluna ------------------------------------------------------------------------ Notas sobre o Produto ------------------------------------------------------------------------ 2.1 CPUs Suportadas no DB2 Verso 7 para Solaris Verses de CPU anteriores ao UltraSparc no so suportadas. ------------------------------------------------------------------------ 2.2 Correo do Locale do Chins no Linux Red Flag Se estiver utilizando o Chins Simplificado no Red Flag Linux Server Verso 1.1, entre em contato com o Red Flag para receber a correo do locale do Chins Simplificado. Sem a correo de locale do Chins Simplificado para a Verso 1.1, o DB2 no reconhece que a p gina de cdigos do Chins Simplificado 1386. ------------------------------------------------------------------------ 2.3 Definindo Locale Adicional do DB2 para Linux em um Ambiente Linux em Japons e Chins Simplificado Uma definio de locale adicional ser necess ria quando voc quiser usar as ferramentas GUI para Java, como o Centro de Controle, no sistema Linux em Japons ou Chins Simplificado. Os caracteres em Japons ou Chins no podem ser exibidos corretamente sem esta definio. Inclua a seguinte definio no perfil de usu rio ou execute-a a partir da linha de comandos antes de cada solicitao do Centro de Controle. Para um sistema em Japons: export LC_ALL=ja_JP Para um sistema em Chins Simplificado: export LC_ALL=zh_CN ------------------------------------------------------------------------ |2.4 Limitaes para Japons em PTX | | |Se voc estiver executando o DB2 UDB em japons em um sistema PTX, |possvel que alguns dos processos utilizados pelo DB2 no herdem as |informaes de locale corretas. Para evitar isso, defina manualmente as |vari veis de registro DB2CODEPAGE e DB2COUNTRY para corresponder a seu |locale. ------------------------------------------------------------------------ 2.5 Problema do Centro de Controle no Microsoft Internet Explorer Existe um problema causado pelas definies das opes de segurana do Internet Explorer (IE). O Centro de Controle usa jars sem assinatura, portanto, o acesso s informaes do sistema fica desativado pelo gerenciador de segurana. Para eliminar este problema, reconfigure as opes de segurana do IE da seguinte forma: 1. Selecione Opes da Internet no menu Exibir (IE4) ou no menu Ferramentas (IE5). 2. Na p gina Segurana, selecione Zona de sites confi veis. 3. Clique em Adicionar Sites.... 4. |Inclua o servidor Web do Centro de Controle na lista de sites |seguros. Se o servidor Web do Centro de Controle estiver no mesmo |domnio, poder ser til para incluir somente o nome do servidor Web (sem o |nome do domnio). Por exemplo: | http://ccWebServer.ccWebServerDomain | http://ccWebServer |Nota: Ao digitar a URL, voc deve utilizar o prefixo https:// ou desmarcar a |opo Exigir verificao do servidor (https:) para todos os sites |desta zona para incluir o site | 5. Clique em OK. 6. |Clique em Configuraes...(IE4) ou |em Nvel Personalizado... |(IE5).. 7. Desloque-se at Java --> Permisses Java e selecione Personalizar. 8. Clique em Configuraes Personalizadas Java.... 9. Selecione a p gina Editar Permisses. 10. Desloque-se para Contedo No-assinado --> Executar Contedo No-assinado --> Permisses Adicionais No-assinadas --> Informaes do Sistema e selecione Ativar. 11. Clique em OK em cada janela aberta. | ------------------------------------------------------------------------ |2.6 Perda de Funo do Centro de Controle |No DB2 verso 7.2, clientes do Centro de Controle Verso 6 |anteriores ao FixPak 6 e clientes verso 7 anteriores ao FixPak 7 perdem |praticamente toda a funcionalidade quando utilizados com o DB2 verso |7.2. Para corrigir isso, atualize seus clientes Verso 6 para o |FixPak 6 ou posterior e seus clientes Verso 7 para o FixPak 2 ou |posterior. |No devem ser apresentados problemas contra os clientes do Centro de |Controle do nvel inferior, aplicando FixPak 2 em um servidor DB2. ------------------------------------------------------------------------ |2.7 CD do Netscape No Fornecido com o DB2 UDB |O CD do Netscape no mais fornecido com o DB2 UDB. Os produtos |Netscape esto disponveis a partir do |http://www.netscape.com. ------------------------------------------------------------------------ |2.8 Erros nos Arquivos Readme no XML |O arquivo README.TXT para DB2 XML Extender Verso 7.1 informa |o seguinte em "Consideraes": | | 3. A verso padro do DB2 UDB DB2 UDB Verso 7.1. |Se voc deseja utilizar o DB2 UDB Verso 6.1 no AIX e Solaris, dever |assegurar-se de que voc est executando com a instncia do DB2 UDB |V6.1 e com as bibliotecas do DB2 UDB V6.1. | |Isto est incorreto. O DB2 XML Extender suportado apenas com |o DB2 Verso 7.1 e 7.2. |Os arquivos readme.aix, readme.nt e readme.sun listam |os Requisitos de Software de: | * |DB2 UDB 6.1 com FP1_U465423 ou superior (AIX) * |DB2 Universal Database Verso 6.1 ou superior com o FixPak 3 |instalado (NT) * |DB2 UDB Verso 6.1 com FixPak FP1_U465424 ou superior (Sun) | |Isto est incorreto. O DB2 XML Extender requer DB2 Verso |7.1 ou 7.2. ------------------------------------------------------------------------ |2.9 Novas Melhorias de Negcios Inteligentes no DB2 Verso 7.2 |Na publicao O que H de Novo na Verso 7.2 e em alguma outra |documentao, a referncia feita para novas melhorias de Negcios |Inteligentes que foram includas na Verso 7.2. Essas melhorias |sero disponibilizadas em uma data posterior. ------------------------------------------------------------------------ |2.10 Problemas no IBM DB2 OLAP Server Causados pelo FixPak 2A e Posterior |Se voc utiliza o IBM DB2 OLAP Server no UNIX, pode encontrar problemas no |DB2 OLAP Server aps a instalao do FixPak 2A do DB2 Universal Database |V7. O FixPak 2A e os FixPaks posteriores instalam novos drivers ODBC |que suportam UNICODE, mas o DB2 OLAP Server no suporta esses novos |drivers. A soluo alternativa para o DB2 OLAP Server comutar seus |arquivos ODBC para apontarem para os drivers ODBC no-UNICODE. |Os drivers no-UNICODE foram renomeados para incluir "_36" em seus |nomes. Por exemplo, para Solaris, o driver libdb2.so |foi renomeado para libdb2_36.so. Para obter mais |informaes sobre como alterar drivers ODBC, consulte a seo "Loading and |Configuring ODBC for the SQL Interface" no Captulo 4, "Installing on AIX, |Solaris Operating Environment, and HP-UX," da publicao OLAP Setup and |User's Guide. ------------------------------------------------------------------------ |2.11 Violao de Segmentao ao Utilizar o WebSphere 3.5.5 |Se voc estiver executando a amostra de perfil de usu rio do WebSphere |3.5.5 com DB2 V7.2 FixPak 4 ou superior em Linux390, voc |pode receber uma violao de segmentao SIGSEGV 11 (*). Esse problema |relaciona-se a um defeito no JDK e ocorrer tanto com o JDK |1.2.2 quanto com o JDK 1.3. |Esse problema pode afetar tambm outros aplicativos JDBC. |O release de servio de novembro do JDK 1.2.2 corrige esse |problema. O JDK 1.3 ser corrigido em seu release de servio de |janeiro. |Uma soluo alternativa para esse problema desativar o JIT com o seguinte |comando: |export JAVA_COMPILER=NONE ------------------------------------------------------------------------ |2.12 Correo Obrigatria para Aplicativos Java no AIX V4 |Aplicativos Java sendo executados no AIX 4.3.3 podem ser |interrompidos inesperadamente se o conjunto de arquivos de kernel |bos.mp ou bos.up estiverem no nvel |4.3.3.77. |Execute o comando lslpp -l bos.ip bos.mp |para determinar o nvel de correo do kernel. |Recomenda-se que todos os clientes Java sendo executados no AIX |4.3.3 faam atualizao para |4.3.3.78. H uma correo disponvel que far a |atualizao do kernel para o nvel sugerido. Ser necess rio obter a |correo para o APAR (Authorized Problem Analysis Report) IY25282. |Instalar a correo para IY25282 corrigir a condio de interrupo de |Java. Uma outra correo ser liberada no primeiro trimestre de 2002, |utilizando o APAR nmero IY26149. |Observe que o AIX 5.1C fornecido com IY25377, que contm a mesma |correo. |Para obter mais informaes e dicas, entre em contato com o Suporte do |AIX. ------------------------------------------------------------------------ Notas sobre a Documentao Online (HTML, PDF e Search) ------------------------------------------------------------------------ 3.1 Navegadores Web Suportados no Sistema Operacional Windows 2000 Recomendamos a utilizao do Microsoft Internet Explorer no Windows 2000. Caso utilize o Netscape, saiba o seguinte: * A concluso das pesquisas de informaes online do DB2 pode demorar no Windows 2000 utilizando o Netscape. O Netscape usar todos os recursos disponveis da CPU e ir aparentar uma execuo de durao indefinida. Embora os resultados da pesquisa possam eventualmente retornar, recomendamos que altere o foco clicando em outra janela aps submeter a pesquisa. Os resultados da pesquisa, ento, retornaro em um perodo razo vel de tempo. * Observe que ao solicitar a ajuda, ela ser exibida corretamente na janela do navegador Netscape; no entanto, se voc deixar a janela do navegador aberta e solicitar a ajuda mais tarde em uma parte diferente do Centro de Controle, nada ir se alterar no navegador. Se fechar a janela do navegador e solicitar ajuda novamente, a ajuda correta surgir . Voc pode resolver esse problema seguindo estas etapas em 3.4, Mensagens de Erro na Tentativa de Lanar o Netscape. Voc tambm pode contornar o problema fechando a janela do navegador antes de solicitar ajuda para o Centro de Controle. * Quando solicitar Ajuda do Centro de Controle ou um tpico no Centro de Informaes, voc pode obter uma mensagem de erro. Para corrigir isso, siga as etapas em 3.4, Mensagens de Erro na Tentativa de Lanar o Netscape. ------------------------------------------------------------------------ 3.2 Pesquisando Informaes Online do DB2 no Solaris Se voc tiver problemas na pesquisa de informaes online do DB2 no Solaris, verifique os parmetros de kernel do sistema em /etc/system. Aqui esto os parmetros de kernel mnimos requeridos pelo sistema de pesquisa do DB2, o NetQuestion: semsys:seminfo_semmni 256 semsys:seminfo_semmap 258 semsys:seminfo_semmns 512 semsys:seminfo_semmnu 512 semsys:seminfo_semmsl 50 shmsys:shminfo_shmmax 6291456 shmsys:shminfo_shmseg 16 shmsys:shminfo_shmmni 300 Para definir um parmetro de kernel, inclua uma linha no final de /etc/system, como no exemplo a seguir: set = value Voc deve reinicializar seu sistema para quaisquer valores alterados tomarem efeito. ------------------------------------------------------------------------ 3.3 Comutando o NetQuestion pelo OS/2 para Utilizar TCP/IP As instrues para comutar para o NetQuestion para poder usar o TCP/IP nos sistemas OS/2 esto incompletas. A localizao dos arquivos *.cfg mencionados nas instrues o subdiretrio do diretrio de instalao do NetQuestion. Para determinar o diretrio de instalao do NetQuestion, digite um destes comandos: echo %IMNINSTSRV% //para instalaes SBCS echo %IMQINSTSRV% //para instalaes DBCS ------------------------------------------------------------------------ 3.4 Mensagens de Erro na Tentativa de Lanar o Netscape Caso encontre as seguintes mensagens de erro ao tentar lanar o Netscape: No foi possvel encontrar o arquivo (ou um de seus componentes). Assegure-se de que o caminho e o nome de arquivo estejam corretos e que todas as bibliotecas requeridas estejam disponveis. Impossvel abrir "D:\Arquivos de Programas\SQLLIB\CC\.. \doc\html\db2help\XXXXX.htm" voc deve executar as seguintes etapas para corrigir esse problema no Windows NT, 95 ou 98 (consulte a seguir o que fazer no Windows 2000): 1. No menu Iniciar, selecione Programas --> Windows Explorer. O Windows Explorer aberto. 2. No Windows Explorer, selecione Exibir --> Opes. O Bloco de Notas Opes aberto. 3. Clique na guia Tipos de arquivos. A p gina Tipos de arquivos aberta. 4. Coloque em destaque o Documento Hipertexto do Netscape no campo Tipos de arquivos registrados e clique em Editar. A janela Editar os tipos de arquivos aberta. 5. Destaque "Abrir" no campo Aes. 6. Clique no boto Editar. A janela Editando a ao para o tipo aberta. 7. Desmarque a caixa de seleo Usar DDE. 8. No campo Aplicativo utilizado para executar a ao, verifique se "%1" aparece no final da cadeia (incluindo as aspas e o espao em branco antes das aspas). Caso encontre as mensagens no Windows 2000, execute as seguintes etapas: 1. A partir do menu Iniciar, selecione Windows Explorer. O Windows Explorer aberto. 2. A partir do Windows Explorer, selecione Ferramentas --> Opes de pasta. O Bloco de Notas Opes de pasta aberto. 3. Clique na guia Tipos de arquivo. 4. Na p gina Tipos de arquivo, no campo Tipos de arquivo registrados, destaque: Documento de Hipertexto HTM Netscape e clique em Avanado. A janela Editar tipo de arquivo aberta. 5. Destaque "abrir" no campo Aes. 6. Clique no boto Editar. A janela Editando ao para o tipo aberta. 7. Desmarque a caixa de seleo Usar DDE. 8. No campo Aplicativo utilizado para executar a ao, verifique se "%1" aparece no final da cadeia (incluindo as aspas e o espao em branco antes das aspas). 9. Clique em OK. 10. Repita as etapas 4 a 8 para os tipos de arquivos Documento de Hipertexto HTML Netscape e Documento de Hipertexto SHTML Netscape. ------------------------------------------------------------------------ 3.5 Requisitos de Configurao para o Adobe Acrobat Reader nos Sistemas Baseados em UNIX O Acrobat Reader oferecido apenas em Ingls nas plataformas baseadas em UNIX, e erros podem ser retornados na tentativa de abrir os arquivos PDF com idiomas locais diferentes do Ingls. Estes erros sugerem o acesso s fontes ou problemas de extrao com o arquivo PDF, porm so atualmente provocados pelo fato de que o Acrobat Reader em Ingls pode no funcionar corretamente dentro de um local de idioma diferente do Ingls no UNIX. Para exibir tais arquivos PDF, modifique para o locale do Ingls executando uma das seguintes etapas antes de lanar o Acrobat Reader em Ingls: * Edite o script de lanamento do Acrobat Reader, incluindo a seguinte linha aps a instruo #!/bin/sh no arquivo de lanamento do script: LANG=C;export LANG Esta abordagem assegurar um comportamento correto quando o Acrobat Reader for lanado por outros aplicativos, tais como Netscape Navigator ou um menu de ajuda do aplicativo. * Digite LANG=C na linha de comando para definir o ambiente de aplicativo do Acrobat Reader. Para informaes adicionais, contacte a Adobe Systems (http://www.Adobe.com). ------------------------------------------------------------------------ 3.6 Referncia a SQL Fornecida em um Arquivo PDF O apndice "Utilizando a Biblioteca do DB2" em cada publicao indica que a SQL Reference est disponvel no formato PDF como dois volumes separados. Isto est incorreto. Embora a publicao impressa aparea em dois volumes, e os dois nmeros de formul rio correspondentes estejam corretos, existe apenas um arquivo PDF e ele contm ambos os volumes. O nome do arquivo PDF db2s0x70. ------------------------------------------------------------------------ Instalao e Configurao ndice Parcial * Informaes Gerais sobre Instalao, Migrao e Configurao o 4.1 Fazendo Download dos Pacotes de Instalao para Todos os Clientes DB2 Suportados o 4.2 Requisito Adicional do Nvel de Correo do Solaris o |4.3 Instalando o DB2 Enterprise-Extended Edition no AIX o |4.4 Suporte ao Diretrio LDAP no Netscape + |4.4.1 Estendendo o Esquema do LDAP no Netscape o |4.5 Suporte para Plataformas Windows ME, Windows XP e Windows 2000 Datacenter Edition + |4.5.1 Windows XP + |4.5.1.1 Limitaes + |4.5.2 Windows ME + |4.5.2.1 Limitaes + |4.5.3 Windows 2000 Datacenter Server o |4.6 Instalando o DB2 no Windows 95 o 4.7 Instalando o DB2 no Windows 2000 o |4.8 Executando o DB2 no Windows 2000 Terminal Server, Modo de Administrao o 4.9 Suporte de Atualizao do Microsoft SNA Server e SNA Multisite (Commit de Duas Fases) o 4.10 Definir o ID do Usu rio e a Senha no IBM Communications Server para Windows NT (CS/NT) + 4.10.1 Definio do N o 4.11 A Instalao do DB2 Pode ser Interrompida se uma Unidade Removvel no Estiver Conectada o 4.12 Erro SQL1035N ao Utilizar CLP no Windows 2000 o 4.13 Problema de Migrao com Respeito s Exibies Definidas com os Registros Especiais o 4.14 Suporte ao Protocolo IPX/SPX no Windows 2000 o 4.15 Parando Processos do DB2 antes de Atualizar uma Verso Anterior do DB2 o 4.16 Execuo do db2iupdt aps a Instalao do DB2 se outro Produto do DB2 j Estiver Instalado o 4.17 Configurando o Ambiente Linux para Executar o Centro de Controle do DB2 o 4.18 DB2 Universal Database Enterprise Edition e DB2 Connect Enterprise Edition para Linux no S/390 o |4.19 Possvel Perda de Dados no Linux para S/390 o |4.20 Integrao do Desktop Gnome e KDE para DB2 no Linux o |4.21 Parmetros de Configurao do Kernel do Solaris (Valores Recomendados) o |4.22 DB2 Universal Database Enterprise - Extended Edition para UNIX - Iniciao R pida o 4.23 Parmetro do kernel shmseg para HP-UX o 4.24 Migrando Bancos de Dados de Controle do IBM Visual Warehouse o |4.25 Migrando ndices Exclusivos Utilizando o Comando db2uiddl o |4.26 Erro de Instalao da Verso AIX de 64 Bits + |4.26.1 Utilizando o SMIT o 4.27 Erros que Ocorreram Durante a Migrao o |4.28 Ativao da Licena do IBM(R) DB2(R) Connect + |4.28.1 Instalando sua Chave de Licena e Definindo o Tipo de Licena Utilizando o Centro de Licenas + |4.28.2 Instalando sua Chave de Licena e Definindo o Tipo de Licena Utilizando o Comando db2licm + |4.28.3 Consideraes Sobre Licena para Instalaes Distribudas o 4.29 Acessando Bancos de Ddados de Controle do Warehouse o 4.30 Produtos para Teste em CD-ROMs UNIX Enterprise Edition o 4.31 Produtos para Teste em CD-ROMs UNIX do DB2 Connect Enterprise Edition o |4.32 Configurao Adicional Necess ria Antes da Instalao do Centro de Cat logos de Informaes para a Web o |4.33 Informaes de Suporte a P gina de Cdigos e Idioma - Correo * Iniciao R pida do Data Links Manager o |5.1 Suporte no AIX 5.1 o 5.2 Dlfm Start Falha com a Mensagem: "Erro ao obter o afsfid para o prefixo" o 5.3 Definindo a Classe do Gerenciador de Armazenamento do Tivoli para Arquivos de Archive o 5.4 Requisitos de Espao em Disco para DFS Client Enabler o 5.5 Monitorando o Processo de Backend do Gerenciador do Data Links no AIX o 5.6 Instalando e Configurando o DB2 Data Links Manager para AIX: Consideraes Adicionais sobre a Instalao em Ambientes DCE-DFS o 5.7 Falha do Comando "dlfm add_prefix" o 5.8 No Evento de Pouca Freqncia que Copia o Daemon e que No Para com dlfm stop o 5.9 Instalando e Configurando o DB2 Data Links Manager para AIX: Instalando o DB2 Data Links Manager no AIX Utilizando o Utilit rio db2setup o 5.10 Instalando e Configurando DB2 Data Links Manager para AIX: Tarefa de Ps-Instalao no DCE-DFS o 5.11 Instalando e Configurando o DB2 Data Links Manager para AIX: Instalando Manualmente o DB2 Data Links Manager Utilizando o Smit o 5.12 Instalando e Configurando o DB2 Data Links DFS Client Enabler o 5.13 Instalando e Configurando o DB2 Data Links Manager para Solaris: o |5.14 Privilgios do Grupo de Administradores do Data Links no Windows NT o 5.15 Minimizar o Log para Instalao do DLFF (Data Links File System Filter) + 5.15.1 Registrando Mensagens aps a Instalao + |5.15.2 Minimizando o Registro em Sistemas Sun Solaris o 5.16 Restaurar DATALINK o 5.17 Eliminar o Data Links Manager o 5.18 Desinstalando os Componentes do DLFM Utilizando o SMIT pode Remover Conjuntos de Arquivos Adicionais o 5.19 Antes de Iniciar/Determinar o Nome do Host o 5.20 Trabalhando com o Data Links File Manager: fazendo a limpeza aps eliminar um DB2 Data Links Manager de um banco de dados DB2 o 5.21 Ao do Usu rio para a Falha do dlfm Client_conf o 5.22 DLFM1001E (Nova mensagem de erro) o 5.23 Opo do Arquivo de Configurao DLFM o |5.24 Problema Potencial ao Restaurar Arquivos o 5.25 Erro ao executar o script dmapp_prestart de Data Links/DFS no AIX o |5.26 Integrao do Tivoli Space Manager com o Data Links + |5.26.1 Restries e Limitaes o 5.27 Captulo 4. Instalando e configurando o DB2 Data Links Manager para AIX + 5.27.1 Consideraes comuns de instalao + 5.27.1.1 Migrando do DB2 File Manager Verso 5.2 para o DB2 Data Links Manager Verso 7 o |5.28 Captulo 6. Verificando a Instalao no AIX + |5.28.1 Solues Alternativas em Ambientes NFS * Suplemento da Instalao e Configurao o 6.1 Captulo 5. Instalando os Clientes DB2 em Sistemas Operacionais UNIX + |6.1.1 Parmetros de Configurao do Kernel do HP-UX o 6.2 Captulo 12. Executando Seus Prprios Aplicativos + 6.2.1 Efetuando a Vinculao dos Utilit rios de Banco de Dados Utilizando o Cliente de Run-Time + 6.2.2 Acesso de Clientes UNIX ao DB2 Utilizando ODBC o |6.3 Captulo 24. Configurando um Sistema Federado para Acessar V rias Fontes de Dados + |6.3.1 Sistemas Federados + |6.3.2 Restrio + |6.3.3 Instalando o DB2 Relational Connect + |6.3.3.1 Instalando o DB2 Relational Connect em Servidores Windows NT + |6.3.3.2 Instalando o DB2 Relational Connect em Servidores UNIX + |6.3.4 Captulo 24. Configurando o Sistema Federado para Acessar V rias Fontes de Dados + |6.3.4.1 Compreendendo o Esquema Utilizado com Pseudnimos + |6.3.4.2 Problemas ao Restaurar um Banco de Dados Federado em um Servidor Federado Diferente o |6.4 Captulo 26. Acessando Origens de Dados do Oracle + |6.4.1 Erros da Documentao o |6.5 Evitando Problemas ao Trabalhar com LOBs Remotos o |6.6 Acessando Origens de Dados do Sybase + |6.6.1 Incluindo Origens de Dados do Sybase em um Servidor Federado + |6.6.1.1 Etapa 1: Definir as Vari veis de Ambiente e Atualizar o Registro do Perfil (Apenas AIX e Solaris) + |6.6.1.2 Etapa 2: Ligar o DB2 ao Software do Cliente Sybase (Apenas AIX e Solaris) + |6.6.1.3 Etapa 3: Reciclar a Instncia do DB2 (Apenas AIX e Solaris) + |6.6.1.4 Etapa 4: Criar e Configurar um Arquivo de Interfaces + |6.6.1.5 Etapa 5: Criar o Wrapper + |6.6.1.6 Etapa 6: Opcional: Definir a Vari vel de Ambiente DB2_DJ_COMM + |6.6.1.7 Etapa 7: Criar o Servidor + |6.6.1.8 Etapa 8: Opcional: Definir a Opo do Servidor CONNECTSTRING + |6.6.1.9 Etapa 9: Criar um Mapeamento do Usu rio + |6.6.1.10 Etapa 10: Criar Pseudnimos para Tabelas e Exibies + |6.6.2 Especificando as P ginas de Cdigos do Sybase o |6.7 Acessando as Origens de Dados do Microsoft SQL Server Utilizando ODBC (Novo Captulo) + |6.7.1 Incluindo Origens de Dados do Microsoft SQL Server em um Servidor Federado + |6.7.1.1 Etapa 1: Definir as Vari veis de Ambiente (Apenas AIX) + |6.7.1.2 Etapa 2: Executar o Script de Shell (Apenas AIX) + |6.7.1.3 Etapa 3: Opcional: Definir a Vari vel de Ambiente DB2_DJ_COMM (Apenas AIX) + |6.7.1.4 Etapa 4: Reciclar a Instncia do DB2 (Apenas AIX) + |6.7.1.5 Etapa 5: Criar o Wrapper + |6.7.1.6 Etapa 6: Criar o Servidor + |6.7.1.7 Etapa 7: Criar um Mapeamento do Usu rio + |6.7.1.8 Etapa 8: Criar Pseudnimos para Tabelas e Exibies + |6.7.1.9 Etapa 9: Opcional: Obter Rastreios do ODBC + |6.7.2 Revendo P ginas de Cdigo do Microsoft SQL Server (Apenas Windows NT) o 6.8 Acessando Origens de Dados do Informix (Novo Captulo) + 6.8.1 Incluindo Origens de Dados do Informix em um Servidor Federado + 6.8.1.1 Etapa 1: Definir as Vari veis de Ambiente e Atualizar o Registro do Perfil + 6.8.1.2 Etapa 2: Ligar o DB2 ao Software Informix Client + 6.8.1.3 Etapa 3: Reciclar a instncia do DB2 + |6.8.1.4 Etapa 4: Criar o Arquivo sqlhosts do Informix + 6.8.1.5 Etapa 5: Criar o Wrapper + 6.8.1.6 Etapa 6: Opcional: Defina a Vari vel de Ambiente DB2_DJ_COMM + 6.8.1.7 Etapa 7: Criar o Servidor + 6.8.1.8 Etapa 8: Criar um Mapeamento do Usu rio + 6.8.1.9 Etapa 9: Criar Pseudnimos para Tabelas, Exibies e Sinnimos do Informix ------------------------------------------------------------------------ Informaes Gerais sobre Instalao, Migrao e Configurao ------------------------------------------------------------------------ 4.1 Fazendo Download dos Pacotes de Instalao para Todos os Clientes DB2 Suportados |Para fazer download de pacotes de instalao de todos os clientes |DB2 suportados, que incluem todos os clientes anteriores Verso 7, |conecte-se ao site na Web IBM DB2 FixPaks and Clients em http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/download.d2w/report. ------------------------------------------------------------------------ 4.2 Requisito Adicional do Nvel de Correo do Solaris O DB2 Universal Database Verso 7 para Solaris Verso 2.6 requer a correo 106285-02 ou superior, em complemento s correes relacionadas na publicao DB2 for UNIX Iniciao R pida. ------------------------------------------------------------------------ |4.3 Instalando o DB2 Enterprise-Extended Edition no AIX | | |Etapa 4, da seo Executando a Instalao do manual de Iniciao R pida do |DB2 Enterprise-Extended Edition para UNIX afirma que voc deve alocar um |sistema de arquivos de CD-ROM digitando o seguinte comando: | crfs -v cdrfs -p ro -d cd0 | |Para que esse comando seja concludo com xito, voc tambm deve |especificar o ponto de montagem, utilizando o comando --m. | crfs -v cdrfs -p ro -d cd0 -m /cdrom |H tambm uma etapa faltando na seo Executando a Instalao. |Depois da Etapa 5, montagem do sistema de arquivos de CD-ROM na estao de |trabalho de controle, cada n que participar de seu sistema de banco de dados |particionado dever montar remotamente o sistema de arquivos de CD-ROM. |Supondo que /cdrom ainda no existe nos ns participantes, utilize |os seguintes comandos para exportar e montar remotamente o sistema de arquivos |/cdrom na estao de trabalho de controle: | exportfs -i -o ro /cdrom | dsh mkdir /cdrom | dsh mount cws_hostname: /cdrom /cdrom |em que cws_hostname o nome do host da estao de trabalho de |controle. ------------------------------------------------------------------------ |4.4 Suporte ao Diretrio LDAP no Netscape |O DB2 suporta a utilizao de um diretrio LDAP para a administrao |central e consolidao de diretrios de banco de dados e ns. Em |releases anterior do DB2, apenas o Microsoft Active Directory e o IBM |SecureWay Directory eram suportados. Agora, o DB2 tambm suporta os |seguintes Servidores LDAP: Netscape Directory Server v4.12 ou |posterior, iPlanet(TM) Directory Server 5.0 ou posterior |4.4.1 Estendendo o Esquema do LDAP no Netscape |As instrues a seguir so para o Netscape Directory Server |4.1: |O Netscape Directory Server permite que aplicativos estendam o esquema |incluindo definies de classe de objeto e de atributo nos dois arquivos a |seguir: slapd.user_oc.conf e |slapd.user_at.conf. Esses dois arquivos esto |localizados no diretrio \slapd-\config. |Os atributos do DB2 devem ser includos em |slapd.user_at.conf da seguinte forma |Nota: Nesse contexto, bin, cis, ces e |dn correspondem a bin rio, cadeia sem distino entre maisculas e |minsculas, cadeia com distino entre maisculas e minsculas e nome |distinto, respectivamente. | : |############################################################################ |# |# IBM DB2 Universal Database V7.2 |# Attribute Definitions |# |############################################################################ | |attribute binProperty 1.3.18.0.2.4.305 bin |attribute binPropertyType 1.3.18.0.2.4.306 cis |attribute cesProperty 1.3.18.0.2.4.307 ces |attribute cesPropertyType 1.3.18.0.2.4.308 cis |attribute cisProperty 1.3.18.0.2.4.309 cis |attribute cisPropertyType 1.3.18.0.2.4.310 cis |attribute propertyType 1.3.18.0.2.4.320 cis |attribute systemName 1.3.18.0.2.4.329 cis |attribute db2nodeName 1.3.18.0.2.4.419 cis |attribute db2nodeAlias 1.3.18.0.2.4.420 cis |attribute db2instanceName 1.3.18.0.2.4.428 cis |attribute db2Type 1.3.18.0.2.4.418 cis |attribute db2databaseName 1.3.18.0.2.4.421 cis |attribute db2databaseAlias 1.3.18.0.2.4.422 cis |attribute db2nodePtr 1.3.18.0.2.4.423 dn |attribute db2gwPtr 1.3.18.0.2.4.424 dn |attribute db2additionalParameters 1.3.18.0.2.4.426 cis |attribute db2ARLibrary 1.3.18.0.2.4.427 cis |attribute db2authenticationLocation 1.3.18.0.2.4.425 cis |attribute db2databaseRelease 1.3.18.0.2.4.429 cis |attribute DCEPrincipalName 1.3.18.0.2.4.443 cis |As classes de objeto do DB2 devem ser includas no arquivo |slapd.user_oc.conf da seguinte forma: |############################################################################ |# |# IBM DB2 Universal Database V7.2 |# Object Class Definitions |# |############################################################################ | |objectclass eProperty | oid 1.3.18.0.2.6.90 | requires | objectClass | allows | cn, | propertyType, | binProperty, | binPropertyType, | cesProperty, | cesPropertyType, | cisProperty, | cisPropertyType | |objectclass eApplicationSystem | oid 1.3.18.0.2.6.8 | requires | objectClass, | systemName | | |objectclass DB2Node | oid 1.3.18.0.2.6.116 | requires | objectClass, | db2nodeName | allows | db2nodeAlias, | host, | db2instanceName, | db2Type, | description, | protocolInformation | |objectclass DB2Database | oid 1.3.18.0.2.6.117 | requires | objectClass, | db2databaseName, | db2nodePtr | allows | db2databaseAlias, | description, | db2gwPtr, | db2additionalParameters, | db2authenticationLocation, | DCEPrincipalName, | db2databaseRelease, | db2ARLibrary |Depois de incluir a definio de esquema do DB2, o Directory Server dever |ser iniciado novamente para ativar todas as alteraes. ------------------------------------------------------------------------ |4.5 Suporte para Plataformas Windows ME, Windows XP e Windows 2000 Datacenter Edition |O DB2 agora suporta plataformas Microsoft Windows ME, Windows XP e Windows |2000 Datacenter Edition. A seguir, informaes adicionais por |plataforma especfica. |4.5.1 Windows XP |Os seguintes produtos e verses suportam Windows XP de 32 bits quando |instalado com FixPak 4 ou posterior: | * |IBM DB2 UDB Personal Edition Verso 7.2 * |IBM DB2 Personal Developer's Edition Verso 7.2 * |IBM DB2 Universal Developer's Edition Verso 7.2 * |IBM DB2 Connect Personal Edition Verso 7.2 * |IBM DB2 Connect Enterprise Edition Verso 7.2 * |IBM DB2 UDB Workgroup Edition Verso 7.2 * |IBM DB2 UDB Enterprise Edition Verso 7.2 * |IBM DB2 Run-Time Client Verso 7.2 * |IBM DB2 Administration Client Verso 7.2 * |IBM DB2 Application Development Client Verso 7.2 | |O DB2 suporta os mesmos idiomas nacionais em sistemas Windows XP e em |outras verses. |4.5.1.1 Limitaes |Ao inserir IDs de usu rios e senhas durante a instalao, voc pode receber |uma mensagem de que uma conta de usu rio inserida no painel de instalao no | v lida, mesmo que seja v lida. Isso somente ocorrer com IDs de |usu rios que existam na m quina. Voc no deve ter esse problema se |digitar nomes de usu rios que no existam ainda. |Se voc optar por instalar o DB2 sob qualquer outra conta de usu rio que |no seja db2admin, voc deve assegurar que o nome de conta esteja de acordo |com as regras de nomenclatura do DB2. da m xima importncia que o |nome no contenha quaisquer espaos em branco. Por exemplo |meu_nome aceit vel, mas meu nome no . |Se voc receber o erro 1052 durante a instalao do produto, faa o |seguinte: | 1. |Deixe a janela de erro aberta. 2. |Abra uma janela de comandos. 3. |Execute o comando db2start.exe. 4. |Execute o comando especificado na janela de erro, utilizando a senha |especificada para o usu rio mostrada na linha de comandos. 5. |Retorne janela de erro e clique em OK. A instalao |continuar agora. | |Se voc estiver utilizando chins simplificado e verificar que fontes no |Centro de Controle no so exibidas corretamente, modifique o |sqllib\java\java12\jdk\jre\lib\font.properties.zh |substituindo a entrada |filename.\u5b8b\u4f53=simsun.ttf por |filename.\u5b8b\u4f53=simsun.ttc. |4.5.2 Windows ME |Os seguintes produtos e verses suportam Windows ME quando instalado com |FixPak 2 ou posterior: | * |IBM DB2 UDB Personal Edition Verso 7.1 * |IBM DB2 Personal Developer's Edition Verso 7.1 * |IBM DB2 Universal Developer's Edition Verso 7.1 * |IBM DB2 Connect Personal Edition Verso 7.1 * |IBM DB2 Run-Time Client Verso 7.1 * |IBM DB2 Administration Client Verso 7.1 * |IBM DB2 Application Development Client Verso 7.1 | |4.5.2.1 Limitaes |A capacidade do HTML Search Server no suportada no Window ME neste |momento |Ao desinstalar o DB2, voc pode receber uma mensagem de erro indicando que |o arquivo MFC42U.DLL no pode ser encontrado. Para |desinstalar o DB2 completamente, exclua manualmente o diretrio sqllib depois |que a atividade de desinstalao for concluda. |4.5.3 Windows 2000 Datacenter Server |Os seguintes produtos DB2 so certificados para Windows 2000 Datacenter |Server, Windows 2000 Advanced Server e Windows 2000 Server: | * |IBM DB2 Universal Database Enterprise - Extended Edition Verso 7.2 * |IBM DB2 Universal Database Enterprise Edition 7.2 * |IBM DB2 Database Workgroup Edition Verso 7.2 * |IBM DB2 Connect Enterprise Edition Verso 7.2 | ------------------------------------------------------------------------ |4.6 Instalando o DB2 no Windows 95 |Se voc estiver instalando o DB2 em um sistema Windows 95 que no seja em |ingls, ser necess rio atualizar manualmente sua verso do Winsock para |Winsock 2 antes de instalar o DB2 UDB. O utilit rio de |atualizao do Winsock 2 est disponvel na Microsoft. ------------------------------------------------------------------------ 4.7 Instalando o DB2 no Windows 2000 No Windows 2000, ao instalar sobre uma verso anterior do DB2 ou ao reinstalar a verso atual, assegure que as opes de recuperao para todos os servios do DB2 estejam definidas como "Sem Efeito". ------------------------------------------------------------------------ |4.8 Executando o DB2 no Windows 2000 Terminal Server, Modo de Administrao |Para DB2 UDB Verso 7.1, FixPak 3 e posterior, o DB2 pode ser |executado no Windows 2000 Terminal Server, Modo de Administrao. Antes |disso, voc no pode executar o DB2 na sesso Cliente de um Servidor Terminal |do Windows 2000, Modo de Administrao. ------------------------------------------------------------------------ 4.9 Suporte de Atualizao do Microsoft SNA Server e SNA Multisite (Commit de Duas Fases) Os aplicativos do host e do AS/400 no podem acessar servidores DB2 UDB utilizando o commit de duas fases SNA, quando o Microsoft SNA Server o produto SNA em uso. Qualquer publicao do DB2 UDB que indicar que existe esse suporte est incorreta. necess rio o IBM Communications Server para Windows NT Verso 5.02 ou posterior. Nota: Aplicativos que acessam servidores de bancos de dados do host e do AS/400 utilizando o DB2 UDB para Windows podem usar o commit de duas fases SNA atravs do Microsoft SNA Server Verso 4 Service Pack 3 ou posterior. ------------------------------------------------------------------------ 4.10 Definir o ID do Usu rio e a Senha no IBM Communications Server para Windows NT (CS/NT) Se voc estiver utilizando o APPC como o protocolo de comunicao para que os clientes do DB2 remoto possam se conectar ao servidor do DB2, e estiver utilizando o CS/NT como o produto SNA, verifique se as palavras-chave a seguir foram definidas corretamente no arquivo de configurao CS/NT. Este arquivo comumente encontrado no diretrio x:\ibmcs\private. 4.10.1 Definio do N TG_SECURITY_BEHAVIOR Este parmetro permite ao usu rio determinar como o n deve manipular as informaes de segurana presentes no ATTACH se o TP no estiver configurado para segurana. IGNORE_IF_NOT_DEFINED Este parmetro permite ao usu rio determinar se os parmetros de segurana esto presentes no ATTACH e ignor -los se o TP no estiver configurado para segurana. Caso utilize IGNORE_IF_NOT_DEFINED, voc no precisa definir um ID do Usu rio e senha no CS/NT. VERIFY_EVEN_IF_NOT_DEFINED Esse parmetro permite ao usu rio determinar se os parmetros de segurana esto presentes no ATTACH e verific -los mesmo que o TP no esteja configurado para segurana. Esse o padro. Se voc usa VERIFY_EVEN_IF_NOT_DEFINED, deve definir o ID do Usu rio e senha no CS/NT. Para definir o ID do Usu rio e senha CS/NT, execute as seguintes etapas: 1. Iniciar --> Programas --> Servidor de Comunicaes IBM --> Configurao de n SNA. A janela Bem-vindo para a Configurao do Servidor de Comunicaes aberta. 2. Escolha o arquivo de configurao que deseja alterar. Clique em Prximo. A janela Escolher um Cen rio de Configurao aberta. 3. Destaque CPI-C, APPC ou Emulao 5250. D um clique em Concluir.A Janela N SNA do Servidor de Comunicaes aberta. 4. Clique no [+] junto ao CPI-C e APPC. 5. Clique no [+] junto ao LU6.2 Security. 6. Clique com o boto direito do mouse em Senhas de Usu rios e selecione Criar. A janela Definir uma Senha de ID do Usu rio aberta. 7. Preencha o ID do usu rio e a senha. Clique em OK. Clique em Concluir para aceitar as alteraes. ------------------------------------------------------------------------ 4.11 A Instalao do DB2 Pode ser Interrompida se uma Unidade Removvel no Estiver Conectada Durante a instalao do DB2, a instalao pode travar aps a seleo do tipo de instalao ao utilizar um computador com uma unidade removvel no conectada. Para resolver este problema, execute a configurao, especificando a opo -a: setup.exe -a ------------------------------------------------------------------------ 4.12 Erro SQL1035N ao Utilizar CLP no Windows 2000 Se o DB2 estiver instalado em um diretrio ao qual alguns usu rios (por exemplo, administradores) tm acesso de gravao, o usu rio comum pode receber o erro SQL1035N ao tentar utilizar o DB2 Command Line Processor. Para resolver esse problema, o DB2 deve ser instalado em um diretrio ao qual todos os usu rios tm acesso de gravao. ------------------------------------------------------------------------ 4.13 Problema de Migrao com Respeito s Exibies Definidas com os Registros Especiais As exibies tornam-se no-utiliz veis aps a migrao do banco de dados se o registrador especial USER ou CURRENT SCHEMA for utilizado para definir uma coluna de exibio. Por exemplo: create view v1 (c1) as values user Na Verso 5, USER e CURRENT SCHEMA eram do tipo de dados CHAR(8), mas a partir da Verso 6, eles foram definidos como VARCHAR(128). Neste exemplo, o tipo de dados para a coluna c1 CHAR se a exibio for criada na Verso 5, ele ir permanecer como CHAR aps a migrao do banco de dados. Quando a exibio for usada aps a migrao, ela ir compilar em run-time, porm falhar devido no coincidncia do tipo de dados. A soluo eliminar e em seguida criar novamente a exibio. Antes de eliminar a exibio, capture a sintaxe utilizada para cri -la consultando a exibio de cat logo SYSCAT.VIEWS. Por exemplo: select text from syscat.views where viewname='<>' ------------------------------------------------------------------------ 4.14 Suporte ao Protocolo IPX/SPX no Windows 2000 Estas informaes se referem ao captulo Planejando para Instalao na publicao Quick Beginnings, na seo chamada "Possveis Cen rios de Conectividade Cliente para Servidor." O gr fico de suportes de protocolo publicado no est completamente correto. Um cliente Windows 2000 conectado a qualquer servidor baseado em OS/2 ou UNIX utilizando IPX/SPX no suportado. O mesmo ocorre para qualquer cliente baseado em OS/2 ou UNIX conectado a um servidor Windows utilizando IPX/SPX. ------------------------------------------------------------------------ 4.15 Parando Processos do DB2 antes de Atualizar uma Verso Anterior do DB2 Estas informaes se refem s informaes de migrao na publicao Quick Beginnings do DB2 para Windows. Se estiver atualizando uma verso anterior do DB2 em execuo na m quina Windows, o programa de instalao fornecer um aviso contendo uma lista de processos que esto mantendo DLLs do DB2 na memria. Nesse ponto, voc tem a opo de parar manualmente os processos que aparecem na lista ou permitir que o programa de instalao os encerre automaticamente. recomendado que voc pare todos os processos do DB2 manualmente antes da instalao para evitar perda de dados. A melhor maneira de garantir que os processos do DB2 no estejam em execuo exibir os processos do sistema atravs do painel Servios do Windows. Nesse painel, certifique-se de que no haja nenhum servio do DB2, do OLAP ou do Data warehouse em execuo. Nota: Voc s pode ter uma verso do DB2 executando por vez nas plataformas Windows. Por exemplo, voc no pode ter o DB2 Verso 7 e DB2 Verso 6 sendo executados na mesma m quina Windows. Se voc instalar o DB2 Verso 7 em uma m quina que tem o DB2 Verso 6 instalado, o programa de instalao excluir o DB2 Verso 6 durante a instalao. Consulte a publicao Iniciao R pida adequado para obter maiores informaes sobre a migrao a partir de verses anteriores do DB2. ------------------------------------------------------------------------ 4.16 Execuo do db2iupdt aps a Instalao do DB2 se outro Produto do DB2 j Estiver Instalado As informaes a seguir devem ser disponibilizadas na documentao da instalao do Quick Beginnings. Ao instalar o DB2 UDB Verso 7 em sistemas baseados em UNIX e um produto DB2 j instalado, voc precisar executar o comando db2iupdt para atualizar essas instncias com as quais pretende utilizar os novos recursos desse produto. Alguns recursos no estaro disponveis at esse comando ser executado. ------------------------------------------------------------------------ 4.17 Configurando o Ambiente Linux para Executar o Centro de Controle do DB2 Estas informaes devem ser includas com o captulo "Instalando o Centro de Controle do DB2" na publicao Quick Beginnings. Aps sair do desinstalador do DB2 no Linux e retornar janela do terminal, digite os seguintes comandos para definir o ambiente correto para executar o DB2 Control Center: su -l export JAVA_HOME=/usr/jdk118 export DISPLAY=:0 Em seguida, abra outra janela do terminal e digite: su root xhost + Feche a janela do terminal e retorne ao terminal onde est conectado como o ID de propriet rio da instncia e digite o comando: db2cc para iniciar o Centro de Controle. ------------------------------------------------------------------------ 4.18 DB2 Universal Database Enterprise Edition e DB2 Connect Enterprise Edition para Linux no S/390 O DB2 Universal Database Enterprise Edition e o DB2 Connect Enterprise Edition agora esto disponveis para o Linux no S/390. Antes de instalar o Linux em uma m quina S/390, saiba dos requisitos de software e hardware: Hardware S/390 9672 Gerao 5 ou posterior, Multiprise 3000. Software * SuSE Linux v7.0 para S/390 ou Turbolinux Server 6 para zSeries e S/390 * kernel nvel 2.2.16, com correes para S/390 (veja a seguir) * glibc 2.1.3 * libstdc++ 6.1 As seguintes correes sero necess rias para o Linux no S/390: * nenhuma correo necess ria neste momento. Para atualizaes posteriores, v para o site web http://www.software.ibm.com/data/db2/linux. Notas: 1. Somente o Linux de 32 bits baseado em Intel e o Linux no S/390 so suportados. 2. Os itens a seguir no esto disponveis para Linux/390 no DB2 Verso 7: o |DB2 UDB Enterprise - Extended Edition o |DB2 Extenders o |Data Links Manager o |DB2 Administrative Client o |Suporte de Alterao da Senha o |Suporte LDAP o |TSM o |Utilizao de dispositivos simples ------------------------------------------------------------------------ |4.19 Possvel Perda de Dados no Linux para S/390 |Quando utilizar o DB2 no Linux para S/390 com um kernel srie 2.2, a |quantidade de RAM disponvel na m quina Linux deve ser limitada a menos de 1 |GB. Limitando a RAM a 1 GB evitar possveis perdas de dados no DB2 |devido a um bug do kernel do Linux. |Isso afeta apenas o DB2 no Linux para S/390 e no Linux no Intel. |Uma correo de kernel estar disponvel no site IBM |devloperworks, depois da qual ser possvel utilizar mais de um 1 GB de |RAM. ------------------------------------------------------------------------ |4.20 Integrao do Desktop Gnome e KDE para DB2 no Linux |O DB2 inclui um conjunto de utilit rios para a criao de pastas e cones |do desktop DB2, para lanar as ferramentas do DB2 mais comumente utilizadas |nos desktops Gnome e KDE para distribuies Linux baseadas em Intel |suportadas. Esses utilit rios so instalados, por padro, pelo DB2 |Verso 7.2 e podem ser utilizados aps a instalao para criar e |remover cones do desktop de um ou mais usu rios selecionados. |Para incluir um conjunto de cones do desktop para um ou mais usu rios, |utilize o seguinte comando: |db2icons [ ...] |Nota: Observe que se os cones forem gerados enquanto um ambiente de desktop Gnome |ou KDE estiver sendo executado, o usu rio poder precisar forar uma |atualizao do desktop manual para ver os novos cones. | |Para remover um conjunto de cones do desktop para um ou mais usu rios, |utilize o seguinte comando: |db2rmicons [ ...] |Nota: Voc deve ter autoridade suficiente para gerar ou remover cones de outros |usu rios. Tipicamente, db2icons e db2rmicons |podem ser utilizados para criar ou remover cones para voc mesmo se for um |usu rio normal e para terceiros apenas se for usu rio root ou outro usu rio |com autoridade para gravar nos diretrios principais de usu rios |especificados. | ------------------------------------------------------------------------ |4.21 Parmetros de Configurao do Kernel do Solaris (Valores Recomendados) |A seo Antes de Voc Comear no captulo Solaris do DB2 para UNIX - |Iniciao R pida e DB2 Enterprise - Extended Edition - Iniciao |R pida para UNIX fornece parmetros recomendados de configurao do |kernel do Solaris. A seguinte tabela fornece recomendaes adicionais |de parmetro de configurao do kernel para sistemas com mais de 512 MB de |memria real. | |Tabela 1. Parmetros de Configurao do Kernel do Solaris (Valores Recomendados) Parmetro do Kernel 512 MB-1 GB 1 GB-4 GB 4 GB+ msgsys:msginfo_msgmax 65.535 65.535 65.535 msgsys:msginfo_msgmnb 65.535 65.535 65.535 msgsys:msginfo_msgmap 514 1.026 2.050 msgsys:msginfo_msgmni 512 1.024 2.048 msgsys:msginfo_msgssz 16 32 64 msgsys:msginfo_msgtql 1.024 2.048 4.096 msgsys:msginfo_msgseg 32.767 32.767 32.767 shmsys:shminfo_shmmax 483.183.820 - 966.367.641 - 3.865.470.566 - 966.367.641 3.865.470.566 4.294.967.296 shmsys:shminfo_shmseg 50 100 200 shmsys:shminfo_shmmni 300 1.024 2.048 semsys:seminfo_semmni 1.024 2.048 4.198 semsys:seminfo_semmap 1.026 2.050 4.096 semsys:seminfo_semmns 2.048 4.096 8.192 semsys:seminfo_semmnu 2.048 4.096 8.192 semsys:seminfo_semume 50 50 50 |Notas: 1. |O limite do parmetro shmsys:shminfo_shmmax de 4 GB para sistemas |de 32 bits. 2. |Os parmetros msgsys:msginfo_msgmnb e msgsys:msginfo_msgmax |devem ser definidos para 65.535 ou mais. 3. |O parmetro msgsys:msginfo_msgseg no deve ser definido com valor |superior a 32.767. 4. |Os parmetros shmsys:shminfo_shmmax devem ser definidos com o valor |sugerido na tabela acima ou com valor igual a 90% da memria fsica (em |bytes), o que for mais alto. Por exemplo, se voc tiver 196 MB de |memria fsica em seu sistema, defina o parmetro shmsys:shminfo_shmmax |para 184.968.806 (196*1024*1024*0,9). | ------------------------------------------------------------------------ |4.22 DB2 Universal Database Enterprise - Extended Edition para UNIX - Iniciao R pida |Captulo 5. Instalando e Configurando o DB2 Universal Database no |Linux deve indicar que cada n fsico em um cluster do Linux EEE deve ter os |mesmos nveis de kernel, glibc e libstdc++. |Pode ser feito download de uma verso experimental do DB2 EEE para Linux do |seguinte site na Web: http://www6.software.ibm.com/dl/db2udbdl/db2udbdl-p ------------------------------------------------------------------------ 4.23 Parmetro do kernel shmseg para HP-UX As informaes sobre a atualizao dos parmetros de configurao do kernel do HP-UX fornecidas na publicao Quick Beginnings esto incorretas. O valor recomendado para o parmetro de kernel shmseg para HP-UX deve ser ignorado. Em vez dele, o valor pado do HP-UX (120) deve ser utilizado. ------------------------------------------------------------------------ 4.24 Migrando Bancos de Dados de Controle do IBM Visual Warehouse A publicao, DB2 Universal Database Quick Beginnings for Windows fornece informaes sobre como o banco de dados de controle de warehouse ativo migrado durante uma instalao tpica do DB2 Universal Database Verso 7 no Windows NT e Windows 2000. Se voc tiver de fazer a migrao de mais de um banco de dados de controle do warehouse, dever usar a janela Gerenciamento do Banco de Dados de Controle do Warehouse para fazer a migrao dos bancos de dados adicionais. Somente um banco de dados de controle do warehouse pode ficar ativo por vez. Se o ltimo banco de dados que foi migrado no for aquele que voc pretende usar quando efetuar o prximo logon no Data Warehouse Center , utilize a janela Gerenciamento do Banco de Dados de Controle do Warehouse para registrar o banco de dados que pretende usar. ------------------------------------------------------------------------ |4.25 Migrando ndices Exclusivos Utilizando o Comando db2uiddl |No captulo Tarefas de Migrao de Ps-Instalao do DB2 das publicaes de |Iniciao R pida do DB2, em Tarefas Opcionais de Ps-Migrao, encontra-se a |afirmao de que necess rio utilizar o comando db2uiddl para |migrar ndices exclusivos do DB2 verso 5.x e DB2 verso 6. Isso |no est correto. A migrao de ndices exclusivos utilizando o comando |db2uiddl requerida apenas se voc estiver migrando de uma verso |de DB2 anterior verso 5. ------------------------------------------------------------------------ |4.26 Erro de Instalao da Verso AIX de 64 Bits | | | |Ao utilizar db2setup para instalar uma imagem do DB2 no AIX de |64 bits em um sistema operacional AIX existente, assegure que voc esteja |utilizando verses compatveis do AIX ou a instalao falhar . Imagens |do DB2 no AIX Verso 5 no podem ser instaladas em um sistema operacional AIX |Verso 4 existente. De forma semelhante, a instalao de uma imagem do |DB2 no AIX Verso 4 de 64 bits em um sistema operacional AIX Verso 5 |existente tambm resultar em um erro de instalao. |Durante a tentativa de instalar verses incompatveis do AIX de 64 bits, o |utilit rio db2setup encontrar a incompatibilidade de verses em uma |verificao de pr-requisitos, resultando em uma mensagem de erro como a |seguinte: |DBI1009E Incompatibilidade entre a mdia de instalao e a verso do AIX. |Para evitar esse erro, assegure que esteja instalando a verso correta do |AIX de 64 bits. |4.26.1 Utilizando o SMIT |Se voc utilizar o SMIT, receber um erro de que o DB2 do AIX Verso 4 est |sendo substitudo pelo DB2 do AIX Verso 5, entretanto, o inverso no |ocorrer . Portanto, os usu rios do AIX Verso 5 de 64 bits devem |assegurar que estejam instalando a verso correta. Se o db2setup puder |ser lanado sem uma mensagem de erro, a verificao de compatibilidade da |verso do AIX foi bem-sucedida. | |Nota: Esse erro de incompatibilidade no se aplica a verses do AIX de 32 |bits. | ------------------------------------------------------------------------ 4.27 Erros que Ocorreram Durante a Migrao Durante a migrao, entradas de erros no arquivo db2diag.log (banco de dados no migrado) aparecem mesmo quando a migrao tem xito e podem ser ignoradas. |Ao utilizar Warehouse Control, os erros do Gerenciamento de Banco de |Dados so registrados no diretrio SQLLIB\LOGGING. Os |arquivos IWH2RGn.LOG contm todas as informaes sobre |erros. Se ocorrer um erro, corrija o erro, exclua o banco de dados de |controle e inicie novamente. No caso de um banco de dados de controle |existente, significa que voc precisa utilizar a cpia de backup. ------------------------------------------------------------------------ |4.28 Ativao da Licena do IBM(R) DB2(R) Connect |Os programas de instalao para o DB2 Connect Enterprise Edition, DB2 |Connect Unlimited Edition e DB2 Connect Web Starter Kit no instalam as |licenas do produto. Aps a instalao, estes produtos operaro no Modo |de Avaliao por um perodo de 90 dias, j que eles no possuem os arquivos de |licena. Aps o perodo de 90 dias, o produto que voc instalou parar |de funcionar a menos que voc ative a licena adequada. |Para ativar a licena para o seu produto voc pode utilizar o Centro de |Licenas do DB2 ou o comando db2licm. |4.28.1 Instalando sua Chave de Licena e Definindo o Tipo de Licena Utilizando o Centro de Licenas | 1. |Inicie o Centro de Controle do DB2 e selecione Centro de |Licenas no menu Ferramentas. 2. |Selecione o sistema para o qual voc est instalando uma licena. O |campo Produtos Instalados exibir o nome do produto que voc |instalou. 3. |Selecione Incluir no menu Licena . 4. |Na janela Incluir Licena, selecione o boto de opo A partir de um |arquivo e selecione um arquivo de licena: | o |Em servidores Windows: |x:\db2\license\connect\license_filename em que |x: representa a unidade de CD-ROM contendo o CD do produto DB2 |Connect. o |Em servidores UNIX: |/db2/license/connect/license_filename | em que o license_filename para DB2 Connect Enterprise Edition e |DB2 Connect Unlimited Edition db2conee.lic e para o DB2 |Connect Web Starter Kit db2consk.lic. 5. |Clique em Aplicar para incluir a chave de licena. 6. |Definindo o tipo de licena. | o |Para o DB2 Connect Unlimited Edition e o DB2 Connect Web Starter |Kit: |No Centro de Licenas, selecione Alterar no menu |Licena. Na janela Alterar Licena, selecione a caixa de |opes Utilizao controlada. Clique em OK para |fechar a janela Alterar Licena e retornar para o Centro de Licenas. |Nota: Para o DB2 Connect Web Starter Kit, assegure que a data de expirao esteja |definida para 270 dias a partir do dia em que voc instalou o produto. | o |Para o DB2 Connect Enterprise Edition: |No Centro de Licenas, selecione Alterar no menu |Licena .Na janela Alterar Licena, selecione o tipo de |licena que voc comprou. | + |Se voc comprou uma licena de Usu rios Simultneos, selecione |Usu rios simultneos do DB2 Connect e digite o nmero de licenas |de usu rio que voc comprou. |Nota: O DB2 Connect Enterprise Edition fornece uma licena para um usu rio. |Licenas adicionais do DB2 Connect User devem ser compradas |separadamente. | | | + |Se voc comprou uma licena de Usu rios Registrados, selecione |Usu rios registrados do DB2 Connect e clique em OK para |fechar a janela Alterar Licena e retornar para o Centro de Licenas. |Clique na guia Usu rios e inclua todos os IDs de usu rio para os |quais voc comprou uma licena. | | | |4.28.2 Instalando sua Chave de Licena e Definindo o Tipo de Licena Utilizando o Comando db2licm |Voc pode utilizar o comando db2licm para incluir a chave de |licena ao invs de utilizar o Centro de Licenas. Para incluir sua |chave de licena utilizando o comando db2licm : | 1. |Em servidoresWindows, digite o comando a seguir: | db2licm -a x:\db2\license\connect\license_filename | em que x: representa a unidade de CD-ROM que contm o CD do |produto DB2 Connect. |Em servidores UNIX, digite o comando a seguir: | db2licm -a db2/license/connect/license_filename |em que o license_filename para o DB2 Connect Enterprise Edition e |o DB2 Connect Unlimited Edition db2conee.lic e para o DB2 |Connect Web Starter Kit db2consk.lic. |Nota: Para o DB2 Connect Web Starter Kit, assegure que a data de expirao esteja |definida para 270 dias a partir do dia em que voc instalou o produto. | 2. |Definindo o tipo de licena: | o |Para o DB2 Connect Unlimited Edition e o DB2 Connect Web Starter |Kit: |Digite o seguinte comando: | db2licm -p db2conee measured o |Para o DB2 Connect Enterprise Edition: |Se voc comprou licenas de Usu rio Simultneo, digite os comandos a |seguir: | db2licm -p db2conee concurrent | db2licm -u N |em que N representa o nmero de licenas de usu rio simultneo |que voc comprou. |Se voc comprou licenas de Usu rio Registrado, digite o comando a |seguir: | db2licm -p db2conee registered | | |4.28.3 Consideraes Sobre Licena para Instalaes Distribudas |Se estiver criando uma imagem para uma instalao distribuda, voc |precisar fazer disposies especiais para instalar a licena aps a |instalao. Inclua os comandos db2licm descritos acima em |seus scripts de instalao distribuda. ------------------------------------------------------------------------ 4.29 Acessando Bancos de Ddados de Controle do Warehouse Em uma instalao tpica do DB2 Verso 7 no Windows NT, um banco de dados de controle do warehouse do DB2 Verso 7 criado juntamente com o servidor do warehouse. Se voc tiver um banco de dados de controle do warehouse do Visual Warehouse, dever atualizar o servidor do DB2 que contm o banco de dados de controle do warehouse para o DB2 Verso 7 antes que os metadados do banco de dados de controle do warehouse possam ser migrados para uso pelo Data Warehouse Center do DB2 Verso 7.1. Voc deve migrar quaisquer bancos de dados de controle de warehouse que deseja continuar utilizando para a Verso 7. Os metadados do banco de dados de controle do warehouse ativo so migrados para a Verso 7 durante o processo de instalao do DB2 Verso 7. Para migrar os metadados de todos os bancos de dados adicionais de controle do warehouse, utilize o utilit rio Migrao do Banco de Dados de Controle do Warehouse, que voc inicia com a seleo de Iniciar --> Programas --> DB2 IBM --> Gerenciamento do Banco de Dados de Controle do Warehouse no Windows NT. Para obter informaes sobre a migrao dos bancos de dados de controle do warehouse, consulte a publicao DB2 Universal Database for Windows Quick Beginnings. ------------------------------------------------------------------------ 4.30 Produtos para Teste em CD-ROMs UNIX Enterprise Edition Os CD-ROMs do DB2 Universal Database (UDB) Enterprise Edition (EE) para plataformas UNIX Verso 6 e 7 contm uma verso de teste do DB2 Connect Enterprise Edition (CEE), para 90 dias. Como a funcionalidade do DB2 Connect interna ao produto DB2 UDB EE, no necess rio instalar o produto DB2 CEE em sistemas nos quais o DB2 UDB EE esteja instalado a fim de utilizar a funcionalidade do DB2 Connect. Se voc instalar a verso de teste de 90 dias do DB2 CEE e decidir atualizar para uma verso licenciada, compre o produto DB2 CEE e instale sua chave de licena. No necess rio reinstalar o produto. As instrues para instalar a chave de licena so fornecidas na publicao DB2 EE ou DB2 CEE for UNIX Quick Beginnings. Se voc tiver instalado o produto CEE para teste juntamente com a instalao do EE e no deseja instalar o CEE permanentemente, pode remover a verso de teste do CEE seguindo estas instrues. Se a verso de teste do Connect EE for removida, voc ainda ter a funcionalidade do DB2 Connect disponvel com o DB2 EE. Para remover o DB2 Connect Verso 7, remova a instalao dos seguintes conjuntos de arquivos das respectivas plataformas: * No AIX, remova a instalao do conjunto de arquivos db2_07_01.clic. * No NUMA-Q e no ambiente operacional Solaris, remova a instalao do pacote db2clic71. * No Linux, remova a instalao do RPM db2clic71-7.1.0-x. * No HP-UX, remova a instalao do conjunto de arquivos DB2V7CONN.clic. Para remover o DB2 Connect Verso 6, remova a instalao dos seguintes conjuntos de arquivos das respectivas plataformas: * No AIX, remova a instalao do conjunto de arquivos db2_06_01.clic. * No NUMA-Q e no ambiente operacional Solaris, remova a instalao do pacote db2cplic61. * No Linux, remova a instalao do RPM db2cplic61-6.1.0-x. * No HP-UX, remova a instalao do conjunto de arquivos DB2V6CONN.clic. ------------------------------------------------------------------------ 4.31 Produtos para Teste em CD-ROMs UNIX do DB2 Connect Enterprise Edition Os CD-ROMs do DB2 Connect Enterprise Edition (EE) para plataformas UNIX Verso 6 e 7 contm uma verso de teste do DB2 Universal Database (UDB) Enterprise Edition (EE), para 90 dias. A verso de teste do DB2 UDB EE para 90 dias fornecida para avaliao, mas no obrigatria para o funcionamento do DB2 Connect. Se voc instalar a verso de teste de 90 dias do DB2 UDB EE e decidir atualizar para uma verso licenciada, compre o produto DB2 UDB EE e instale sua chave de licena. No necess rio reinstalar o produto. As instrues para instalar a chave de licena so fornecidas na publicao de Introduo do DB2 EE ou do DB2 CEE para UNIX. Se voc tiver instalado o produto UDB EE para teste juntamente com a instalao do Connect EE e no deseja instalar o UDB EE permanentemente, pode remover a verso de teste do EE seguindo estas instrues. A remoo da verso de teste do DB2 UDB EE no afeta a funcionalidade do DB2 Connect EE. Para remover o DB2 UDB EE Verso 7, remova a instalao dos seguintes conjuntos de arquivos das respectivas plataformas: * No AIX, remova a instalao do conjunto de arquivos db2_07_01.elic. * No NUMA-Q e no ambiente operacional Solaris, remova a instalao do pacote db2elic71. * No Linux, remova a instalao do RPM db2elic71-7.1.0-x. * No HP-UX, remova a instalao do conjunto de arquivos DB2V7ENTP.elic. Para remover o DB2 UDB EE Verso 6, remova a instalao dos seguintes conjuntos de arquivos das respectivas plataformas: * No AIX, remova a instalao do conjunto de arquivos db2_06_01.elic. * No NUMA-Q e no ambiente operacional Solaris, remova a instalao do pacote db2elic61. * No Linux, remova a instalao do RPM db2elic61-6.1.0-x. * No HP-UX, remova a instalao do conjunto de arquivos DB2V6ENTP.elic. ------------------------------------------------------------------------ |4.32 Configurao Adicional Necess ria Antes da Instalao do Centro de Cat logos de Informaes para a Web |Antes de instalar o Centro de Cat logos de Informaes para a Web, voc |deve copiar o arquivo dg_strings.hti para o idioma que est |sendo instalado no diretrio /sqllib/icuweb/macro. Voc pode |encontrar o arquivo dg_strings.hti no diretrio do idioma |correspondente. Uma lista de cdigos de idiomas pode ser encontrada no |apndice NLS dos Manuais de Iniciao R pida e na maioria das demais |documentaes do DB2. ------------------------------------------------------------------------ |4.33 Informaes de Suporte a P gina de Cdigos e Idioma - Correo |A tabela de Suporte a P gina de Cdigos e Idioma no apndice NLS (National |Language Support) dos manuais de Iniciao R pida contm os seguintes |erros: | * |O ttulo da coluna, "Cdigo de Pas", deve ser "Cdigo de Pas/Regio" * |O ttulo da coluna, "Idioma", deve ser "Idioma/Script" * |O cdigo para Eslovnia "sl" e no "si", conforme indicado na tabela | ------------------------------------------------------------------------ Iniciao R pida do Data Links Manager ------------------------------------------------------------------------ |5.1 Suporte no AIX 5.1 |Os componentes Data Links File Manager e File Filter agora so totalmente |suportados no AIX 5.1. Todas as ferramentas e instrues |associadas ao Data Links e anteriormente suportadas em releases anteriores do |AIX agora so totalmente suportadas e aplic veis no AIX |5.1. ------------------------------------------------------------------------ 5.2 Dlfm Start Falha com a Mensagem: "Erro ao obter o afsfid para o prefixo" Para um Data Links Manager em execuo no ambiente DCE-DFS, entre em contato com o Servio da IBM se o dlfm start falhar com o seguinte erro: Erro ao obter o afsfid para o prefixo O erro pode ocorrer quando um conjunto de arquivos DFS registrado no Data Links Manager com "dlfm add_prefix" for excludo. ------------------------------------------------------------------------ 5.3 Definindo a Classe do Gerenciador de Armazenamento do Tivoli para Arquivos de Archive Para especificar qual a classe de gerenciamento TSM usar para arquivos archive, defina a entrada de registro DB2 DLFM_TSM_MGMTCLASS DB2 para o nome de classe de gerenciamento apropriada. ------------------------------------------------------------------------ 5.4 Requisitos de Espao em Disco para DFS Client Enabler O DFS Client Enabler um componente opcional que voc pode selecionar durante a instalao do DB2 Universal Database cliente ou servidor. Voc no pode instalar um DFS Client Enabler sem instalar o produto cliente ou servidor do DB2 Universal Database, ainda que o DFS Client Enabler execute por ele mesmo sem precisar de um cliente ou servidor do DB2 UDB. Alm disso, o espao em disco de 2 MB de espao obrigatrio para o cdigo do DFS Client Enabler, voc deve definir parte um adicional de 40 MB se estiver instalando o DFS Client Enabler como parte de uma instalao do Cliente de Run-Time do DB2. Voc ir precisar de mais espao em disco se instalar o DFS Client Enabler como parte de uma instalao do Cliente de Administrao do DB2 ou servidor do DB2. Para obter maiores informaes sobre os requisitos de espao em disco para os produtos DB2 Universal Database, consulte a publicao DB2 for UNIX Iniciao R pida. ------------------------------------------------------------------------ 5.5 Monitorando o Processo de Backend do Gerenciador do Data Links no AIX Existe uma alterao feita sada do comando dlfm see. Quando este comando emitido para monitorar os processos de back-end do Gerenciador de Arquivo do Data Links no AIX, a sada que retornada ser similar ao seguinte: PID PPID PGID RUNAME UNAME ETIME DAEMON NAME 17500 60182 40838 dlfm root 12:18 dlfm_copyd_(dlfm) 41228 60182 40838 dlfm root 12:18 dlfm_chownd_(dlfm) 49006 60182 40838 dlfm root 12:18 dlfm_upcalld_(dlfm) 51972 60182 40838 dlfm root 12:18 dlfm_gcd_(dlfm) 66850 60182 40838 dlfm root 12:18 dlfm_retrieved_(dlfm) 67216 60182 40838 dlfm dlfm 12:18 dlfm_delgrpd_(dlfm) 60182 1 40838 dlfm dlfm 12:18 dlfmd_(dlfm) DLFM SEE a solicitao teve sucesso. O nome que est fechado entre parnteses o nome da instncia dlfm, neste caso "dlfm". ------------------------------------------------------------------------ 5.6 Instalando e Configurando o DB2 Data Links Manager para AIX: Consideraes Adicionais sobre a Instalao em Ambientes DCE-DFS Na seo chamada "Pr-requisitos da Instalao", existe uma nova informao que deve ser includa: Voc deve instalar tambm um e-fix para DFS 3.1, ou um PTF set 1 (quando ele se tornar disponvel). O e-fix pode ser encontrado em: http://www.transarc.com/Support/dfs/datalinks/efix_dfs31_main_page.html Tambm: O cliente dfs deve ser executado antes de voc instalar o Gerenciador de Data Links . Use db2setup ou smitty. Na seo chamada "arquivo Keytab", h um erro que deve ser corrigido da seguinte maneira: O arquivo keytab, que contm o usu rio principal e as informaes de senha, deve se chamado datalink.ktb e .... O nome correto: datalink.ktb utilizado no exemplo a seguir. A seo "Arquivo Keytab" deve ser transferida para ficar sob a "Tarefa de Ps-Instalao de DCE-DFS", j que a criao desse arquivo s pode ocorrer depois da criao da instncia DLMADMIN. Na seo chamada "Servidores e clientes do Gerenciador de Arquivo de Data Links", deve ser observado que o servidor do Gerenciador de Data Links precisa ser instalado antes de qualquer clientes do Gerenciador de Data Links. Deve ser includa uma nova seo, "Diretrio de backup": Se o mtodo de backup destinar-se para um sistema de arquivos local, este sistema dever ser um diretrio do sistema de arquivos DFS. Confira se esse conjunto de arquivos DFS foi criado por um administrador DFS. Ele no deve ser um conjunto de arquivos DMLFS. ------------------------------------------------------------------------ 5.7 Falha do Comando "dlfm add_prefix" Para um Data Links Manager em execuo em um ambiente DCE/DFS, o comando dlfm add_prefix poder falhar com um cdigo de retorno -2061 (falha do backup). se isto ocorrer, faa o seguinte: 1. Pare os processos de daemon do Data Links Manager, emitindo o comando dlfm stop. 2. Pare os processos do DB2, emitindo o comando dlfm stopdbm. 3. Obtenha as credenciais de raiz dce atravs do comando dce_login root. 4. Inicie os processos do DB2 emitindo o comando dlfm startdbm. 5. Registre o conjunto de arquivos no Data Links Manager atravs do comando dlfm add_prefix. 6. Inicie os processos de daemon do Data Links Manager emitindo o comando dlfm start. ------------------------------------------------------------------------ 5.8 No Evento de Pouca Freqncia que Copia o Daemon e que No Para com dlfm stop Isto poderia ocorrer em situaes muito raras em que o dlfm_copyd (o comando para copiar daemon) no parasse quando um usu rio emitisse um dlfm ou existisse um encerramento anormal do sistema. Se isto ocorrer, emita o encerramento dlfm antes de tentar reiniciar o dlfm. ------------------------------------------------------------------------ 5.9 Instalando e Configurando o DB2 Data Links Manager para AIX: Instalando o DB2 Data Links Manager no AIX Utilizando o Utilit rio db2setup Na seo "Banco de dados do DB2 DLFM_DB criado", o DLFM_DB no criado no ambiente DCE_DFS. Isto deve ser feito como uma etapa ps-instalao. Na seo "Registro de pr-incio no DCE-DFS para DMAPP", a etapa 2 deve ser alterada assim: 2. Comandos so includos para /opt/dcelocal/tcl/user_cmd.tcl, para garantir que o DMAPP iniciado quando o DFS inicializado. ------------------------------------------------------------------------ 5.10 Instalando e Configurando DB2 Data Links Manager para AIX: Tarefa de Ps-Instalao no DCE-DFS Deve ser includa esta nova seo, "Complete a Instalao do Gerenciador de Data Links": No servidor do Gerenciador de Data Links, preciso efetuar as seguintes etapas para completar a instalao: 1. Crie o arquivo keytab conforme destacado no "Arquivo Keytab" na seo "Consideraes Adicionais sobre a Instalao no Ambiente DCE-DFS", no captulo "Instalando e Configurando o DB2 Data Links Manager para AIX". 2. Como raiz, digite os seguintes comandos para iniciar o DMAPP: stop.dfs all start.dfs all 3. Execute "dlfm setup" utilizando credenciais raiz do dce: a. Efetue o login como administrador do Gerenciador de Data Links, DLMADMIN. b. Como raiz, emita dce_login. c. Digite o comando: dlfm setup. No cliente Data Links Manager, para completar a instalao preciso fazer o seguinte: 1. Crie o arquivo keytab conforme destacado no "Arquivo Keytab" na seo "Consideraes Adicionais sobre a Instalao no Ambiente DCE-DFS", no captulo "Instalando e Configurando o DB2 Data Links Manager para AIX". 2. Como raiz, digite os seguintes comandos para iniciar o DMAPP: stop.dfs all start.dfs all ------------------------------------------------------------------------ 5.11 Instalando e Configurando o DB2 Data Links Manager para AIX: Instalando Manualmente o DB2 Data Links Manager Utilizando o Smit Sob a seo, "Tarefas de Ps-Instalao do SMIT", modifique a etapa 7 para indicar que o comando "dce_login root" deve ser emitido antes do "dlfm setup". A etapa 11 no necess ria. Esta etapa executada automaticamente quando a Etapa 6 (dlfm server_conf) ou Etapa 8 (dlfm client_conf) feita. Remova tambm a etapa 12 (dlfm start). Para concluir a instalao, faa o seguinte: 1. Crie o arquivo keytab conforme destacado no "Arquivo Keytab" na seo "Consideraes Adicionais sobre a Instalao no Ambiente DCE-DFS", no captulo "Instalando e Configurando o DB2 Data Links Manager para AIX". 2. Como raiz, digite os seguintes comandos para iniciar o DMAPP: stop.dfs all start.dfs all ------------------------------------------------------------------------ 5.12 Instalando e Configurando o DB2 Data Links DFS Client Enabler Na seo "Configurando o DFS Client Enaber", inclua a seguinte informao na etapa 2: Executar o comando "secval" dever normalmente completar a configurao. Contudo, pode ser necess rio reinicializar tambm a m quina. Se forem encontrados problemas durante o acesso aos arquivos de PERMISSO DE LEITURA DB, reinicialize a m quina onde o DB2 DFS Client Enabler acabou de ser instalado. ------------------------------------------------------------------------ 5.13 Instalando e Configurando o DB2 Data Links Manager para Solaris: As seguintes aes devem ser executadas aps a instalao do DB2 Data Links Manager para Solaris: 1. Inclua as trs linhas a seguir no arquivo /etc/system: set dlfsdrv:glob_mod_pri=0x100800 set dlfsdrv:glob_mesg_pri=0xff set dlfsdrv:ConfigDlfsUid=UID em que UID representa o ID do usu rio do id dlfm. 2. Reinicialize a m quina para ativar as alteraes. ------------------------------------------------------------------------ |5.14 Privilgios do Grupo de Administradores do Data Links no Windows NT |No Windows NT, o usu rio dlmadmin possui os mesmos privilgios com relao |aos arquivos ligados utilizando DataLinks, que um usu rio root no UNIX para a |maioria das funes. A seguinte tabela compara ambos. | Operao Unix (root) Windows NT (dlmadmin) Renomear Sim Sim Acessar arquivo sem tokenSim Sim Excluir Sim No (veja nota a seguir) Atualizar Sim No (veja nota a seguir) |Nota: O NTFS no permite essas operaes para um arquivo somente para |leitura. O usu rio dlmadmin pode tornar essas operaes bem-sucedidas |ativando a permisso de gravao para o arquivo. | ------------------------------------------------------------------------ 5.15 Minimizar o Log para Instalao do DLFF (Data Links File System Filter) Voc pode minimizar o log para a Instalao do DLFF (Data Links File System Filter) alterando o arquivo dlfs_cfg . O arquivo dlfs_cfg passado para a rotina strload para carregar os parmetros do driver e da configurao. Ele est localizado no diretrio /usr/lpp/db2_07_01/cfg/. Atravs de um link simblico, o arquivo tambm pode ser encontrado no diretrio /etc. O arquivo dlfs_cfg tem o seguinte formato: d - 0 1 onde: d O parmetro d especifica que o driver deve ser carregado. driver-name o caminho completo do driver a ser carregado. Por exemplo, o caminho completo para a Verso 7 do DB2 /usr/lpp/db2_07_01/bin/dlfsdrv. O nome da unidade dlfsdrv. vfs number a entrada vfs para o DLFS no/etc/vfs. dlfm id Este o ID do usu rio do administrador do DataLinks Manager. global message priority |Este um parmetro configur vel no driver DLFS. Ele define a |lista das categorias de mensagens que sero registradas no arquivo de log do |sistema. global module priority |Este um parmetro configur vel no driver DLFS. Ele define a |lista de rotinas do driver, operaes VFS e operaes Vnode que sero |registradas no arquivo de log do sistema. 0 1 0 1 so os menores nmeros para a criao de ns no clonados para esse driver. Os nomes de ns so criados anexando-se o menor nmero ao nome do n do driver clonado. Podem ser fornecidos no m ximo cinco nmeros menores (0-4). Um exemplo real seria este: d /usr/lpp/db2_07_01/bin/dlfsdrv 14,208,255,-1 - 0 1 As mensagens que so registradas dependem das definies para a prioridade de mensagem global e prioridade de mdulo global. Para minimizar os registros, voc pode alterar o valor para prioridade de mensagem global. Existem quatro valores de prioridade de mensagem para ser usados: #define LOG_EMERGENCY 0x01 #define LOG_TRACING 0x02 #define LOG_ERROR 0x04 #define LOG_TROUBLESHOOT 0x08 A maioria das mensagens no DLFF tem LOG_TROUBLESHOOT como a prioridade de mensagem. A seguir esto alguns exemplos de configurao alternativa: Se precisar de mensagens de emergncia e mensagens de erro, defina a prioridade de mensagem global para 5 (1+4) no arquivo de configurao dlfs_cfg: d /usr/lpp/db2_07_01/bin/dlfsdrv 14,208,5,-1 - 0 1 Se precisar somente de mensagens de erro, defina a prioridade de mensagem global para 4: d /usr/lpp/db2_07_01/bin/dlfsdrv 14,208,4,-1 - 0 1 Se no precisar de registros para o DLFS, ento defina a prioridade de mensagem global para 0: d /usr/lpp/db2_07_01/bin/dlfsdrv 14,208,0,-1 - 0 1 5.15.1 Registrando Mensagens aps a Instalao Se precisar registrar mensagens de emergncia, de erro e de deteco de problemas aps a instalao, modifique o arquivo dlfs_cfg file. O arquivo dlfs_cfg est localizado no diretrio/usr/lpp/db2_07_01/cfg. A prioridade de mensagem global deve ser definida para 255 (prioridade m xima) ou 13 (8+4+1). A definio da prioridade para 13 (8+4+1) registrar informaes de emergncia, de erro e de deteco de problemas. Aps definir a prioridade de mensagem global, desmonte o sistema de arquivos do filtro DLFS e recarregue o driver dlfsdrv para que os novos valores de prioridade sejam definidos no tempo de carregamento. Aps recarregar o driver dlfsdrv, o sistema de arquivos do filtro DLFS dever ser remontado. Nota: As definies do dlfs_cfg permanecero para qualquer carregamento subseqente do driver dlfsdrv, at que o arquivo dlfs_cfg seja alterado novamente. |5.15.2 Minimizando o Registro em Sistemas Sun Solaris |O arquivo dlfs_cfg no existe em sistemas Sun(TM) Solaris(TM). Em |vez disso, o arquivo de sistema /etc/syslog.conf contm as |informaes utilizadas pelo daemon de registro no sistema (syslogd) para |enviar uma mensagem de sistema aos arquivos de registro apropriados. |Voc pode minimizar o registro Instalao do DLFF desabilitando as entradas |para kern.notice e kern.debug em |/etc/syslog.conf. Voc deve, ento, parar e iniciar |syslogd para fazer com que suas alteraes terem efeito. |Para reativar o registro de todos os avisos e erros do kernel, voc deve |reabilitar as entradas para kern.notice e kern.debug em |/etc/syslog.conf e, ento, parar e iniciar syslogd |novamente. ------------------------------------------------------------------------ 5.16 Restaurar DATALINK A restaurao de qualquer backup offline que foi tomado aps uma restaurao de banco de dados, com ou sem rollforward, no envolver o processamento de reconciliao r pida. Em tais casos, todas as tabelas com colunas DATALINK sob o controle de ligao do arquivo sero colocadas no estado pendente de reconciliao do datalink (DRP). ------------------------------------------------------------------------ 5.17 Eliminar o Data Links Manager Agora possvel eliminar um DB2 Data Links Manager de um determinado banco de dados. O processamento de alguns pedidos SQL relacionados ao Data Links, alm de utilit rios, tais como backup/restaurao, envolvem a comunicao com todos os DLMs configurados para um banco de dados. Anteriormente, o DB2 no tinha a capacidade de eliminar um DLM configurado, mesmo que no estivesse operacional. Isso resultava em excesso no processamento do SQL e dos utilit rios. Quando um DLM era includo, o mecanismo comunicava-se com ele no processamento de pedidos, o que podia resultar na falha de alguns pedidos SQL (por exemplo, eliminar tabela/tablespace/banco de dados). ------------------------------------------------------------------------ 5.18 Desinstalando os Componentes do DLFM Utilizando o SMIT pode Remover Conjuntos de Arquivos Adicionais Antes de desinstalar o DB2 (Verses 5, 6 ou 7) a partir de uma m quina AIX na qual o Data Links Manager est instalado, siga estas etapas: 1. Como raiz, faa uma cpia de /etc/vfs utilizando o comando: cp -p /etc/vfs /etc/vfs.bak 2. Desinstale o DB2. 3. Como raiz, substitua /etc/vfs pela cpia de backup feita na etapa 1: cp -p /etc/vfs.bak /etc/vfs ------------------------------------------------------------------------ 5.19 Antes de Iniciar/Determinar o Nome do Host Determine os nomes de cada um dos servidores do DB2 e servidores Data Links. necess rio saber esses nomes de host para verificar a instalao. Ao fazer conexo com um Data Links File Manager do DB2, o servidor UDB do DB2 envia internamente as seguintes informaes para o DLFM: * Nome do banco de dados * Nome da instncia * Nome do host Em seguida, o DLFM compara essas informaes com suas tabelas internas para determinar se a conexo deve ser permitida. Ele permite a conexo somente se essa combinao de nome do banco de dados, nome da instncia e nome do host tiver sido registrada com ele, utilizando o comando dlfm add_db. O nome do host utilizado no comando dlfm add_db deve corresponder exatamente ao nome do host enviado internamente pelo servidor IDB do DB2. Utilize o nome de host exato, obtido da seguinte forma: 1. Digite o comando de nome do host no servidor do DB2. Por exemplo, esse comando pode retornar db2server. 2. Dependendo da sua plataforma execute uma das seguintes aes: o No AIX, digite o comando db2server, onde db2server o nome obtido na etapa anterior. Esse comando deve retornar sada semelhante seguinte: db2server.services.com is 9.11.302.341, Aliases: db2server o No Windows NT, digite o comando nslookup db2server, onde db2server o nome obtido na etapa anterior. Esse comando deve retornar sada semelhante seguinte: Servidor: dnsserv.services.com Endereo: 9.21.14.135 Nome: db2server.services.com Endereo: 9.21.51.178 o No Solaris, digite cat /etc/hosts | grep 'hostname'. Essa ao deve retornar sada semelhante seguinte, se o nome do host for especificado sem o nome de domnio em /etc/hosts: 9.112.98.167 db2server loghost Se o nome do host for especificado com nome de domnio, o comando retorna sada semelhante seguinte: 9.112.98.167 db2server.services.com loghost Utilize db2server.services.com como nome do host ao registrar um banco de dados UDB do DB2 utilizando o comando dlfm add_db. As conexes internas do servidor do DB2 com o DLFM falham se algum outro alias for utilizado no comando dlfm add_db. O servidor Data Links registrado com um banco de dados do DB2, utilizando o comando "add datalinks manager for database database_alias using node hostname port port_number" do DB2. O nome do host o nome do servidor Data Links. Todos os alias v lidos do servidor Data Links podem ser utilizados neste comando. Os valores de DATALINK que so referncias para este servidor Data Links devem especificar o nome do host no valor da URL, isto , o nome exato utilizado no comando "add datalinks manager" deve ser utilizado ao atribuir valores de URL a colunas DATALINK. O uso de um alias diferente faz com que a instruo SQL falhe. ------------------------------------------------------------------------ 5.20 Trabalhando com o Data Links File Manager: fazendo a limpeza aps eliminar um DB2 Data Links Manager de um banco de dados DB2 Quando o DB2 Data Links Manager eliminado de um banco de dados utilizando o comando DROP DATALINKS MANAGER, o prprio comando no limpa as informaes correspondentes no DB2 Data Links Manager. Os usu rios podem iniciar explicitamente a ao de desfazer links dos arquivos ligados ao banco de dados e a coleta de lixo de informaes de backup. Isto pode ser feito utilizando o comando dlfm drop_dlm. Esse comando inicia a excluso assncrona de todas as informaes de um determinado banco de dados. O DB2 Data Links Manager deve estar sendo executando para que esse comando seja bem sucedido. extremamente importante que esse comando seja utilizado somente aps eliminar um DB2 Data Links Manager; caso contr rio, informaes importantes sobre o DB2 Data Links Manager sero perdidas e no podero ser recuperadas. Para iniciar o processo de desfazer os links e de coleta de lixo das informaes de backup em um determinado banco de dados: 1. Inicie sesso no sistema como administrador do DB2 Data Links Manager. 2. Emita o seguinte comando: dlfm drop_dlm banco de dados instncia nome do host onde: banco de dados o nome do banco de dados UDB DB2 remoto; instncia a instncia na qual o banco de dados reside e nome do host o nome do host do servidor UDB DB2 no qual o banco de dados reside. 3. Encerre a sesso. Para obter uma situao de uso completa que mostra o contedo no qual esse comando deve ser utilizado, consulte a publicao Referncia de Comandos. Foi criado um novo cdigo de erro para esse comando (consulte a seo 5.22, DLFM1001E (Nova mensagem de erro)). ------------------------------------------------------------------------ 5.21 Ao do Usu rio para a Falha do dlfm Client_conf Se, em um cliente DLFM, dlfm client_conf falhar por alguma razo, entradas "antigas" nos cat logos do DB2 podem ser o motivo. A soluo emitir os seguintes comandos: db2 uncatalog db db2 uncatalog node db2 terminate Em seguida tente o dlfm client_conf novamente. ------------------------------------------------------------------------ 5.22 DLFM1001E (Nova mensagem de erro) DLFM1001E: Erro no processamento de drop_dlm. Motivo: O Data Links Manager no pde iniciar o processo de desfazer links e de coleta de lixo para o banco de dados especificado. Isto pode ocorrer devido a um dos seguintes motivos: * O Data Links Manager no est executando. * Uma combinao inv lida de banco de dados, instncia e nome do host foi especificada no comando. * Ocorreu uma falha em um dos servios de componentes no Data Links Manager. Ao: Execute as seguintes etapas: 1. Verifique se o Data Links Manager est executando. Inicie o Data Links Manager, se ele no estiver executando. 2. Verifique se a combinao de banco de dados, instncia e nome do host identifica um banco de dados registrado. Isto pode ser feito utilizando o comando "dlfm list registered databases" no Data Links Manager. 3. Se ainda ocorrer um erro, consulte as informaes no arquivo db2diag.log para verificar se algum servio de componente (por exemplo, o Connection Management Service o Transaction Management Service, etc.) falhou. Observe o cdigo de erro em db2diag.log e execute as aes apropriadas sugeridas nesse cdigo de erro. ------------------------------------------------------------------------ 5.23 Opo do Arquivo de Configurao DLFM A opo dlfm.cfg da configurao dlfm foi removida. As referncias a ela na documentao devem ser ignoradas. | | ------------------------------------------------------------------------ |5.24 Problema Potencial ao Restaurar Arquivos |Problema: Quando diferentes verses do mesmo arquivo esto |ligadas a um banco de dados em momentos diferentes, o daemon Retrieve do DLFM |(Data Links File Manager) no recupera a verso correta do arquivo de um |archive quando o banco de dados restaurado. |Background: Quando um banco de dados restaurado de uma |imagem de backup, os arquivos que estavam ligados quela imagem de backup |tambm so restaurados no sistema de arquivos DLFS (Data Links Manager) a |partir do archive. Eis como funciona o processo de recuperao e |restaurao do Data Links Manager. | * |Se os atributos de hor rio e de tamanho da ltima modificao e de tamanho |da verso atual de um arquivo em disco so diferentes dos atributos |do arquivo a ser restaurado do archive, o arquivo atual em disco tratado |como uma verso diferente do arquivo. O arquivo atual em disco salvo |como nomedoarquivo.MOD e a verso original do arquivo a |partir do archive DLFM restaurada. Por exemplo, se o nome do arquivo |atual for abc, ento, abc copiado para |abc.MOD. * |Se os atributos de hor rio e de tamanho da ltima modificao do arquivo |atual em disco forem iguais queles do arquivo a ser restaurado do |archive, o daemon Retrieve do Data Links assume que o arquivo no foi |modificado e no restaurar a verso do arquivo a partir do archive. | |Importante: possvel modificar um arquivo e no alterar |os atributos de hor rio e de tamanho da ltima modificao. Essas |"modificaes ocultas" so feitas ao se fazer uma alterao que no afete o |tamanho do arquivo e, ento, redefini-se o atributo de hor rio da ltima |modificao para aquele do arquivo original. |Exemplo: Suponha que voc tenha um banco de dados chamado |DBTEST e ele contenha uma tabela com uma coluna DATALINK. Voc, ento, |executar as seguintes tarefas, na ordem listada: | 1. |Crie um arquivo chamado fileA em um volume montado em |DLFS. Essa a primeira verso do arquivo. 2. |Insira a referncia fileA (uma URL) no banco de dados DBTEST. 3. |Faa um backup do banco de dados DBTEST. 4. |Exclua a referncia fileA do banco de dados DBTEST. 5. |Exclua fileA do volume montado em DLFS. 6. |Crie outro arquivo chamado fileA no volume montado em |DLFS. Essa a segunda verso do arquivo. 7. |Insira a referncia fileA (uma URL) no banco de dados DBTEST. 8. |Restaure o banco de dados DBTEST a partir da imagem de backup. | |O Daemon Retrieve do DLFM copia a segunda verso de fileA para |fileA.MOD, em seguida, copia a primeira verso de |fileA do archive sobre o volume montado em DLFS como a verso em |funcionamento de fileA. |No entanto, se ambas as verses de fileA tiverem os mesmos |atributos de hor rio e de tamanho da ltima modificao, o Daemon Retrieve do |DLFM no faz nada, porque ele assume que os arquivos tm, na verdade, a mesma |verso. |O resultado que a segunda verso do arquivo -- em vez da primeira verso |-- permanece no volume montado em DLFS. Voc no restaurou |verdadeiramente o sistema de arquivos no mesmo estado em que estava no momento |do backup. |Soluo: Assegure-se de que seu aplicativo no substitua |um arquivo por uma nova verso daquele arquivo com os mesmo atributos (hor rio |e tamanho da ltima modificao). ------------------------------------------------------------------------ 5.25 Erro ao executar o script dmapp_prestart de Data Links/DFS no AIX Se o comando /usr/sbin/cfgdmepi -a "/usr/lib/drivers/dmlfs.ext" falhar com o cdigo de retorno 1 quando voc executar o script Data Links/DFS dmapp_prestart, instale o DFS 3.1 ptfset1 para corrigir o cfgdmepi. ------------------------------------------------------------------------ |5.26 Integrao do Tivoli Space Manager com o Data Links |O DB2 Data Links Manager conseguir agora aproveitar a |funcionalidade do Tivoli Space Manager. O programa cliente do |Hierarchical Storage Manager (HSM) do Tivoli Space Manager migra |automaticamente arquivos apropriados para armazenamento, para manter os nveis |especficos de espao livre em sistemas de arquivos locais. Ele efetua |automaticamente nova chamada de arquivos migrados quando eles so acessados e |permite que usu rios migrem e chamem de volta arquivos |especficos. |O pr-requisito para essa funcionalidade o Tivoli Space Manager |Verso 4.2. |Esse novo recurso beneficia clientes que tm sistemas de arquivos |com arquivos grandes que so requeridos a serem movidos para armazenamento |terci rio periodicamente, no qual o espao do sistema de arquivos precisa ser |gerenciado em uma base regular. Para muitos clientes, o Tivoli Space |Manager atualmente fornece o meio de gerenciar seu armazenamento |terci rio. O novo suporte do DB2 Data Links Manager do Tivoli Space |Manager fornece flexibilidade maior no gerenciamento do espao de arquivos |DATALINK. Em vez de pr-alocar armazenamento suficiente no sistema de |arquivos do Data Links Manager para todos os arquivos que podem ser |armazenados l , o Tivoli Space Manager permite alocaes do sistema de |arquivos gerenciado pelo Data Links a ser ajustado em um perodo de tempo sem |o risco de preencher inadvertidamente o sistema de arquivos durante o uso |normal. | |Incluindo suporte Data Links e HSM para um sistema de arquivos |Quando registrar um sistema de arquivos com o HSM (Hierarchical Storage |Management), registre-o com HSM primeiro e, em seguida, com o |DataLinks File Manager. | 1. |Registre com o HSM, utilizando o comando "dsmmigfs add |/fs". 2. |Registre com o DLM, utilizando o comando "dlfmfsmd /fs". | |O suporte ao Data Links para um sistema de arquivos refletido na |sub-rotina em /etc/filesystems para um sistema de arquivos HSM |atravs das seguintes entradas: | vfs = dlfs | mount = false | options = rw,Basefs=fsm | nodename = - |Incluindo suporte Data Links em um sistema de arquivos HSM existente |Registre com o DLM, utilizando o comando "dlfmfsmd /fs". |Incluindo suporte HSM em um sistema de arquivos do Data Links existente | 1. |Registre com o HSM, utilizando o comando "dsmmigfs add |/fs". 2. |Registre com o DLM, utilizando o comando "dlfmfsmd /fs". | |Removendo o suporte Data Links de um sistema de arquivos HSM do Data Links |Remova o suporte Data Links, utilizando o comando "dlfmfsmd -j |/fs". |Removendo o suporte HSM de um sistema de arquivos HSM do Data Links | 1. |Remova o suporte HSM, utilizando o comando "dsmmigfs remove |/fs". 2. |Remova o suporte Data Links, "dlfmfsmd -j /fs". 3. |Registre com o DLM, utilizando o comando "dlfmfsmd /fs". | |Removendo o suporte Data Links e HSM de um sistema de arquivos HSM do Data |Links | 1. |Remova o suporte HSM, utilizando o comando "dsmmigfs remove |/fs". 2. |Remova o suporte Data Links, utilizando o comando "dlfmfsmd -j |/fs". | |5.26.1 Restries e Limitaes | |Essa funo atualmente suportada apenas no AIX. | |A migrao seletiva (dsmmigrate) e a chamada de volta de um arquivo ligado |ao FC (DB com permisso de leitura) devem ser feitas apenas por um usu rio |root. |A migrao seletiva pode ser executada apenas pelo propriet rio do arquivo |que no caso de arquivos DB de Permisso de Leitura o DataLink Manager |Administrator (dlfm). Para acessar tais arquivos, um token requerido |do lado do banco de dados do host. O nico usu rio que no requer um |token o usu rio "root". Ser mais f cil para um usu rio "root" |executar a migrao seletiva e a chamada de volta em arquivos DB de Permisso |de Leitura. O usu rio dlfm pode migrar um arquivo FC utilizando um |token v lido apenas a primeira vez. A segunda migrao tentada (aps |uma chamada de volta), a operao falhar com a mensagem de erro "ANS1028S |Erro de programa interno. Consulte seu representante de |servio". No ser bem-sucedido executar o dsmmigrate em um |arquivo FC atravs de um usu rio no-root. Essa limitao secund ria, | medida que os administradores acessaro tipicamente os arquivos no servidor |de arquivos. |chamadas do sistema stat e statfs mostraro o tipo Vfs como fsm em vez de |dlfs, embora dlfs esteja montado em fsm. |O procedimento acima para a funcionalidade normal de daemons |dsmrecalld, que executam statfs no sistema de arquivos para |verificar se seu tipo Vfs fsm ou no. |O comando "dsmls" no mostrar nenhuma sada, se um arquivo que tem o |nmero mnimo de inode for FC (DB de permisso de leitura) ligado |O comando dsmls semelhante ao comando ls e lista |os arquivos que esto sendo administrados pelo TSM. Nenhuma ao do |usu rio requerida. | ------------------------------------------------------------------------ 5.27 Captulo 4. Instalando e configurando o DB2 Data Links Manager para AIX 5.27.1 Consideraes comuns de instalao 5.27.1.1 Migrando do DB2 File Manager Verso 5.2 para o DB2 Data Links Manager Verso 7 As informaes da etapa 3 esto incorretas. A etapa 3 deve mostrar o seguinte: "3. Como o administrador DLFM, execute o comando /usr/lpp/db2_07_01/adm/db2dlmmg. ------------------------------------------------------------------------ |5.28 Captulo 6. Verificando a Instalao no AIX |5.28.1 Solues Alternativas em Ambientes NFS |Esta seo descreve as solues alternativas para problemas conhecidos ao |executar o DB2 Data Links Manager para AIX em ambientes NFS que no aparecem |na documentao atual. Esses problemas so especficos do NFS e no |esto relacionados ao DB2 Data Links Manager ou DB2 Universal Database. | |Problemas adicionais de armazenamento em cache do NFS |Duas caches diferentes so mantidas no cliente NFS para AIX. O |cliente NFS mantm uma cache com atributos de arquivos e diretrios |recentemente acessados. O cliente tambm suporta, opcionalmente, uma |cache de dados para armazenar em cache o contedo dos arquivos no |cliente. |O processo de armazenamento de atributos em cache produz, s vezes, uma |condio incomum em um cliente NFS depois que um arquivo de PERMISSO DE |LEITURA DB ligado. s vezes, os usu rios podem acessar um arquivo de |PERMISSO DE LEITURA DB sem um token de controle de acesso se esses usu rios |estavam conectados m quina antes do arquivo ter sido ligado. Utilize |um destes mtodos para reduzir a probabilidade de acesso no autorizado a |arquivo: | o |Utilize o comando touch no arquivo antes de executar a |instruo SQL INSERT para definir o link. o |Utilize o comando touch no diretrio que contm o |arquivo. o |Utilize o comando mount com um dos cinco parmetros de |configurao da cache de atributos (actimeo, acregmin, acregmax, |acdirmin, acdirmax) para minimizar o tempo que os atributos em cache |ficam retidos aps a modificao de um arquivo ou diretrio. | | mais prov vel que voc perceba o acesso no autorizado de arquivos de |PERMISSO DE LEITURA DB durante o teste da funo Data Links, pois somente um |arquivo est ligado e h pouca atividade do NFS. menos prov vel que |voc encontre esse cen rio em um ambiente de produo, pois h atividade |intensa do NFS e a cache de atributos do NFS geralmente no retm os atributos |de todos os arquivos ligados. | ------------------------------------------------------------------------ Suplemento da Instalao e Configurao ------------------------------------------------------------------------ 6.1 Captulo 5. Instalando os Clientes DB2 em Sistemas Operacionais UNIX |6.1.1 Parmetros de Configurao do Kernel do HP-UX |A recomendao para definio de parmetros do kernel do HP-UX declara |incorretamente que msgmbn e msgmax devem ser definidos |como 65535 ou superior. Ambos os parmetros devem ser definidos |exatamente como 65535. ------------------------------------------------------------------------ 6.2 Captulo 12. Executando Seus Prprios Aplicativos 6.2.1 Efetuando a Vinculao dos Utilit rios de Banco de Dados Utilizando o Cliente de Run-Time O Cliente Run-Time no pode ser utilizado para fazer a vinculao dos utilit rios de banco de dados (importar, exportar, reorganizar, o processador da linha de comandos) e o DB2 CLI faz a vinculao dos arquivos para cada banco de dados antes que possam ser utilizados com aquele banco de dados. Voc deve usar o Cliente de Administrao do DB2 ou o Cliente de Desenvolvimento de aplicativo do DB2 preferivelmente. Voc deve fazer a vinculao destes utilit rios de banco de dados e dos arquivos de vinculao do DB2 CLI para cada banco de dados antes que estes possam ser utilizados com aquele banco de dados. Em um ambiente de rede, se voc estiver utilizando mltiplos clientes que executam em diferentes sistemas operacionais, em diferentes verses ou nveis de servio do Db2, voc deve fazer a vinculao dos utilit rios uma vez para cada sistema operacional e para a combinao da verso do DB2. 6.2.2 Acesso de Clientes UNIX ao DB2 Utilizando ODBC O captulo 12 ("Running Your Own Applications") especifica que voc precisar atualizar odbcinst.ini se instalar um Gerenciador do Driver ODBC com o aplicativo cliente ODBC ou o ODBC SDLK. Isto est parcialmente incorreto. Voc no precisar atualizar o odbcinst.ini se instalar um produto Merant ODBC Driver Manager. ------------------------------------------------------------------------ |6.3 Captulo 24. Configurando um Sistema Federado para Acessar V rias Fontes de Dados |6.3.1 Sistemas Federados | | | |Um sistema federado do DB2 um tipo especial de DBMS (Distributed Database |Management System). Um sistema federado permite que voc consulte e |recupere os dados localizados em outros DBMSs. Uma nica instruo SQL |pode referir-se a v rios DBMSs ou banco de dados individuais. Por |exemplo, voc pode unir os dados localizados em uma tabela do DB2 Universal |Database, em uma tabela do Oracle e em uma exibio do Sybase. |Um sistema federado DB2 consiste em um servidor com instncia do DB2, um |banco de dados que servir como banco de dados federado e uma ou mais origens |de dados. O banco de dados federado contm entradas de cat logos que |identificam as origens de dados e suas caractersticas. Uma origem |de dados consiste em um DBMS e em dados. As origens de dados |suportadas incluem: | * |Oracle * |Sybase * |Microsoft SQL Server * |Informix * |Membros da famlia do DB2 Universal Database (como DB2 para OS/390, DB2 |para AS/4000 e DB2 para Windows) | |Os servidores federados DB2 Universal Database comunicam-se e recuperam |dados das origens de dados utilizando protocolos chamados |wrappers. O wrapper que voc utiliza depende do sistema |operacional no qual a instncia do DB2 est sendo executada. |Pseudnimos so utilizados para identificar as tabelas e exibies |localizadas nas origens de dados. Os aplicativos podem conectar-se ao |banco de dados federado exatamente como qualquer outro banco de dados DB2 e |consultar as origens de dados utilizando pseudnimos como se fossem tabelas ou |exibies no banco de dados federado. |Aps a configurao de um sistema federado, as informaes nas origens de |dados podem ser acessadas como se os dados estivessem em um nico banco de |dados local. Os usu rios e aplicativos enviam consultas para o banco de |dados federado, que recupera dados das origens de dados. |Um sistema federado do DB2 opera em algumas restries. Os pedidos |distribudos so limitados s operaes somente leitura no DB2 Verso |7. Alm disso, voc no pode executar operaes do utilit rio (LOAD, |REORG, REORGCHK, IMPORT, RUNSTATS e assim por diante) contra |pseudnimos. Entretanto, voc pode utilizar um recurso de acesso |direito para submeter as instrues DDL e DML diretamente aos DBMSs, |utilizando o dialeto do SQL associado a essa origem de dados. |6.3.2 Restrio |Os novos wrappers na Verso 7.2 (como Informix no AIX, HP e |Solaris; Oracle no Linux, HP e Solaris; Sybase no AIX e |Solaris; e Microsoft SQL Server no AIX e NT) no esto disponveis neste |FixPak ; voc deve comprar o DB2 Relational Connect Verso |7.2. |6.3.3 Instalando o DB2 Relational Connect | | |Esta seo fornece instrues para instalao do DB2 Relational Connect no |servidor que voc utilizar como o servidor do sistema federado. O |Relational Connect obrigatrio para acessar as origens de dados do Oracle, |Sybase, Microsoft SQL Server e Informix. O DB2 Relational Connect no |obrigatrio para acessar membros da famlia do DB2 Universal Database. |Antes de Instalar o DB2 Relational Connect: | * |Certifique-se de ter o DB2 Universal Database Enterprise Edition ou o DB2 |Universal Database Enterprise -- Extended Edition instalado no servidor |federado. | |No DB2 para servidores UNIX: |Se voc pretende incluir os bancos de dados da famlia do DB2 nos pedidos |distribudos, dever selecionar a opo de origens de dados Unio |Distribuda para DB2, quando voc instalou o DB2 Universal |Database. Para verificar se esta opo foi implementada, verifique se o |parmetro FEDERATED est definido como YES. Voc |pode verificar essa definio emitindo o comando GET DATABASE MANAGER |CONFIGURATION, que exibe todos os parmetros e suas definies |atuais. | * |Certifique-se de que o software cliente da origem de dados esteja |instalado no servidor federado. | |6.3.3.1 Instalando o DB2 Relational Connect em Servidores Windows NT | 1. |Efetue logon no servidor federado com a conta do usu rio criada para |executar a instalao do DB2 Universal Database. 2. |Encerre quaisquer outros programas que esto sendo executados, para que o |programa de configurao possa atualizar os arquivos conforme |solicitado. 3. |Chame o programa de configurao. Voc pode invocar o programa de |configurao autom tica ou manualmente. Se o programa de configurao |falhar ao iniciar automaticamente ou se voc desejar executar a configurao |em um idioma diferente, invoque o programa de configurao manualmente. | o |Para chamar automaticamente o programa de configurao: | a. |Insira o CD do DB2 Relational Connect na unidade. b. |O recurso de execuo autom tica inicia o programa de configurao. |O idioma do sistema determinado e o programa de configurao para esse |idioma lanado. | o |Para invocar manualmente o programa de configurao: | a. |Clique em Iniciar e selecione a opo |Executar. b. |No campo Abrir, digite o seguinte comando: |x:\setup /i language |em que: | |x |Representa sua unidade de CD-ROM. |language |Representa o cdigo de pas/regio de seu idioma (por exemplo, EN para |ingls). | c. |D um clique em OK. | | |A barra de lanamento da instalao aberta. 4. |Clique em Instalar para comear o processo de |instalao. 5. |Siga os prompts no programa de configurao. |Quando a instalao estiver concluda, o DB2 Relational Connect ser |instalado no diretrio juntamente com os outros produtos do DB2.Por |exemplo, a biblioteca wrapper para o software cliente Oracle NET8 |(net8.dll) ser instalada no diretrio c:\Program |Files\SQLLIB\bin. | |6.3.3.2 Instalando o DB2 Relational Connect em Servidores UNIX |Para instalar o DB2 Relational Connect no servidor federado UNIX, utilize o |utilit rio db2setup. |Nota: As telas que aparecem quando voc usa o |utilit rio db2setup dependem do que j est instalado no servidor |federado. Estas etapas pressupem que o Relational Connect no esteja |instalado. | 1. |Efetue login como um usu rio com autoridade root. 2. |Insira e instale o CD-ROM do produto do DB2. Para obter informaes |sobre como montar um CD-ROM, consulte a publicao DB2 for UNIX Quick |Beginnings. 3. |Mude para o diretrio onde o CD-ROM est montado, digitando o comando |cd /cdrom, onde cdrom o ponto de |montagem do CD-ROM do produto. 4. |Digite o comando ./db2setup. Aps alguns |instantes, a janela Instalar DB2 V7 aberta. Esta janela lista os |itens atualmente instalados e os itens que esto disponveis para |instalao. 5. |Navegue at a juno distribuda que voc deseja instalar, como |Juno Distribuda para Origens de Dados Informix e pressione a |barra de espao para selecion -la. Aparece um asterisco perto da opo, |quando ela for selecionada. 6. |Selecione OK.A janela Criar o DB2 Services |aberta. 7. |Como o servidor federado j contm uma instncia do DB2, escolha a opo |No criar uma instncia do DB2 e selecione OK. 8. |Aparecer um aviso se voc tiver escolhido no criar um Servidor de |Administrao. Selecione OK.A janela Utilit rio de |Configurao do DB2 exibe um Relatrio de Resumo do que ser instalado. |Como voc no instalou o Relational Connect antes, dever haver dois itens |listados: | o |a assinatura do produto para o DB2 Relational Connect o |a juno distribuda para a origem de dados selecionada | 9. |Escolha Continuar. Aparece uma janela para indicar isso, | a sua chance final para parar a configurao do Relational Connect. |Escolha OK para continuar com a configurao. A concluso da |configurao pode levar alguns segundos. 10. |A janela Utilit rio de Configurao do DB2 exibe um Relatrio de Status |que indica quais componentes foram instalados com xito. Escolha |OK. A janela Utilit rio de Configurao do DB2 |aberta. Escolha Fechar e, em seguida, OK para |sair do utilit rio. |Quando a instalao estiver concluda, o DB2 Relational Connect ser |instalado no diretrio juntamente com os outros produtos do DB2. | o |No DB2 para servidores AIX, o diretrio |/usr/lpp/db2_07_01. o |No DB2 para servidores Solaris Operating Environment, o diretrio |/opt/IBMdb2/V7.1. o |No DB2 para servidores HP-UX, o diretrio |/opt/IBMdb2/V7.1. o |No DB2 para servidores Linux, o diretrio |/usr/IBMdb2/V7.1. | | |6.3.4 Captulo 24. Configurando o Sistema Federado para Acessar V rias Fontes de Dados |6.3.4.1 Compreendendo o Esquema Utilizado com Pseudnimos |O parmetro do pseudnimo em uma instruo CREATE NICKNAME um nome |duplo--o esquema e o pseudnimo. Se voc omitir o esquema ao criar |o pseudnimo, o esquema do pseudnimo ser authid do usu rio que estiver |criando o pseudnimo. Depois da criao de um pseudnimo, as |informaes sobre o pseudnimo so armazenadas nas exibies de cat logo |SYSCAT.TABLES, SYSCAT.TABOPTIONS, SYSCAT.COLUMNS, |SYSCAT.COLOPTIONS e SYSCAT.INDEXES. |6.3.4.2 Problemas ao Restaurar um Banco de Dados Federado em um Servidor Federado Diferente |Ao restaurar o backup de um banco de dados federado em um servidor federado |diferente, a imagem do banco de dados no contm as informaes do novo banco |de dados e do diretrio d n necess rias para acessar as origens de dados da |famlia do DB2. Voc deve catalogar essas informaes ao executar a |restaurao. ------------------------------------------------------------------------ |6.4 Captulo 26. Acessando Origens de Dados do Oracle | | | |Alm de suportar os wrappers no AIX e no Windows NT, o DB2 Universal |Database agora suporta o wrapper do Oracle no Linux, no Solaris Operating |Environment e no HP-UX. Este suporte limitado ao Oracle Verso |8. Para acessar os wrappers nessas plataformas, voc precisa inserir o |CD V7.2 DB2 Relational Connect e selecionar as origens de dados |Distributed Join for Oracle. |Quando voc tiver instalado o DB2 Relational Connect, poder incluir uma |origem de dados do Oracle em um servidor federado: | 1. |Instale e configure o software do cliente Oracle no servidor federado do |DB2. 2. |Para servidores federados do DB2 em UNIX, execute o script djxlink para |ligar e editar bibliotecas Oracle SQL*Net ou Net8 em seu servidor federado DB2 |e criar a biblioteca wrapper federada do DB2 para utilizao com o |Oracle. 3. |Crie (ou atualize) o arquivo db2dj.ini para incluir vari veis de |ambiente para o Oracle. Esse arquivo deve conter uma definio para a |vari vel de ambiente ORACLE_HOME. 4. |(Opcional) Defina as vari veis de registro de perfil DB2_DJ_INI e |DB2_DJ_COMM. 5. |Verifique a localizao e o contedo dos arquivos Oracle |tnsnames.ora no servidor federado DB2 e teste as conexes ao servidor |Oracle utilizando Oracle sqlplus. 6. |Reciclar a instncia do DB2. 7. |Crie o wrapper. 8. |Crie uma definio de servidor. 9. |Crie um mapeamento do usu rio. 10. |Teste a configurao utilizando Set Passthru. 11. |Crie pseudnimos para tabelas e exibies. |As instrues detalhadas para estas etapas, incluindo a definio das |vari veis de ambiente, esto no Captulo 26. Configurando um Sistema |Federado para Acessar as Fontes de Dados Oracle no Suplemento de |Instalao e |Configurao do DB2. Essas informaes tambm esto disponveis |online em |http://www.ibm.com/software/data/db2/relconnect/. |6.4.1 Erros da Documentao |A seo "Incluindo origens de dados Oracle em um Sistema |federado" tem os seguintes erros: | * |Uma etapa adicional necess ria entre as etapas 2 e 3 na |publicao. As trs primeiras etapas devem ser as seguintes: | 1. |Instale e configure o software do cliente Oracle no servidor federado do |DB2 utilizando a documentao fornecida pela Oracle. 2. |Defina a vari vel de ambiente ORACLE_HOME: |export ORACLE_HOME=. 3. |Para servidores federados do DB2 em execuo nas plataformas UNIX, |execute o script djxlink para link-edit as bibliotecas Oracle SQL*Net ou Net8 |para o servidor federado do DB2. Dependendo de sua plataforma, o script |djxlink est localizado em: | | /usr/lpp/db2_07_01/bin no AIX | /opt/IBMdb2/V7.1/bin Solaris Operating Environment | |/opt/IBMdb2/V7.1/bin HP-UX | /usr/IBMdb2/V7.1/bin Linux | |Execute o script djxlink apenas aps instalar o software do cliente do |Oracle no servidor federado do DB2. 4. |Defina vari veis de ambiente da origem de dados modificando o arquivo |db2dj.ini e emitindo o comando db2set. O |comando db2set atualiza o registro de perfil do DB2 com suas |definies. |O Captulo 26 contm instrues detalhadas para as vari veis de |ambiente. Configurando um Sistema Federado para Acessar Origens de |Dados Oracle DB2 Installation and Configuration Supplement. 5. |Continue as etapas a partir da etapa 3, conforme escrito na |publicao. | * |A documentao indica para definir: |DB2_DJ_INI = sqllib/cfg/db2dj.ini |Isso est incorreto e deve ser definido para o seguinte: |DB2_DJ_INI = $INSTHOME/sqllib/cfg/db2dj.ini ------------------------------------------------------------------------ |6.5 Evitando Problemas ao Trabalhar com LOBs Remotos |Ao trabalhar com colunas LOB remotas, pode ser encontrado um problema de |falta de memria. Por exemplo, suponhamos que seja executada uma |consulta que selecione dados LONG em uma coluna Oracle e insira os dados em |uma tabela DB2 como um CLOB. Se voc no tiver aumentado o tamanho de |heap do aplicativo de banco de dados, voc receber um erro SQL indicando |"memria insuficiente". Para resolver esse erro: | 1. |Desconecte todos os aplicativos da instncia do DB2. 2. |Atualize o tamanho de heap do aplicativo utilizando este comando: |db2 udpate db cfg for dbname using APPLHEAPSZ 1024 em que dbname o nome do banco de dados federado e |1024 o tamanho de heap recomendado. 3. |Reinicialize o banco de dados. | |Para prevenir contra a ocorrncia desse problema, aumente o tamanho de heap |de seu aplicativo de banco de dados. Para que essa alterao tenha |efeito, reinicialize o banco de dados. Por exemplo: | 1. |Atualize o tamanho de heap do aplicativo utilizando este comando: |db2 udpate db cfg for dbname using APPLHEAPSZ 1024 |em que dbname o nome do banco de dados federado e 1024 | o tamanho de heap recomendado. 2. |Desconecte todos os aplicativos da instncia do DB2. 3. |Reinicialize o banco de dados. | ------------------------------------------------------------------------ |6.6 Acessando Origens de Dados do Sybase | | ||Antes de incluir as origens de dados do Sybase em um servidor |federado, preciso instalar e configurar o software Sybase Open Client no |servidor federado do DB2. Consulte os procedimentos de instalao na |documentao que fornecida com o software do banco de dados Sybase para |obter detalhes especficos sobre como instalar o software Open Client. |Como parte da instalao, certifique-se de que os procedimentos armazenados do |cat logo Sybase sejam instalados no servidor Sybase e as bibliotecas Sybase |Open Client sejam instaladas no servidor federado DB2. |Depois de configurar a conexo do software cliente ao servidor |Sybase, teste a conexo utilizando uma das ferramentas Sybase. Utilize |a ferramenta isql para UNIX e a ferramenta SQL Advantage para |Windows. |Para configurar o servidor federado para acessar os dados armazenados nas |origens de dados do Sybase, voc precisa: | 1. |Instale o DB2 Relational Connect Verso 7.2. Consulte a |seo 6.3.3, Instalando o DB2 Relational Connect. 2. |Incluir as origens de dados do Sybase em seu servidor federado. 3. |Especificar as p ginas de cdigos do Sybase. | |Este captulo discute as etapas 2 e 3. |As instrues neste captulo aplicam-se ao Windows NT, AIX e Solaris |Operating Environment. As diferenas especficas da plataforma so |observadas onde elas ocorrem. |6.6.1 Incluindo Origens de Dados do Sybase em um Servidor Federado | |Para incluir uma origem de dados do Sybase em um servidor federado, voc |precisa: | 1. |Definir as Vari veis de Ambiente e Atualizar o Registro do Perfil (Apenas |AIX e Solaris). 2. |Ligar o DB2 ao Software Cliente do Sybase (Apenas AIX e Solaris). 3. |Reciclar a Instncia do DB2 (Apenas AIX e Solaris). 4. |Criar e Configurar um Arquivo de Interfaces. 5. |Criar o Wrapper. 6. |Opcional: Definir a Vari vel de Ambiente DB2_DJ_COMM. 7. |Criar o Servidor. 8. |Opcional: Definir a Opo de Servidor CONNECTSTRING. 9. |Criar um Mapeamento do Usu rio. 10. |Criar Pseudnimos para Tabelas e Exibies. |Estas etapas so explicadas com detalhes nesta seo. |6.6.1.1 Etapa 1: Definir as Vari veis de Ambiente e Atualizar o Registro do Perfil (Apenas AIX e Solaris) |Defina vari veis de ambiente da origem de dados modificando o arquivo |db2dj.ini e emitindo o comando db2set. O |arquivo db2dj.ini contm informaes de configurao sobre o |software do cliente Sybase instalado no servidor federado. O comando |db2set atualiza o registro de perfil do DB2 com suas |definies. |Em um sistema do banco de dados particionado, voc pode utilizar um nico |arquivo db2dj.ini para todos os ns em uma instncia |especfica ou voc pode utilizar um nico arquivo db2dj.ini |para um ou mais ns em uma instncia especfica. Um sistema de banco de |dados no-particionado pode ter apenas um arquivo db2dj.ini |por instncia. |Para definir as vari veis de ambiente: | 1. |Edite o arquivo db2dj.ini localizado em |sqllib/cfg e defina a seguinte vari vel de ambiente: | SYBASE="" | |onde o diretrio onde o cliente |Sybase est instalado. 2. |Emita o comando db2set para atualizar o registro do perfil do |DB2 com suas mudanas. A sintaxe desse comando, db2set, |dependente da estrutura do sistema do banco de dados. Essa etapa ser |necess ria apenas, se voc estiver utilizando o arquivo |db2dj.ini em qualquer uma das seguintes estruturas do |sistema do banco de dados: |Se voc estiver utilizando o arquivo db2dj.ini em um |sistema de banco de dados no-particionado ou se voc quiser que o arquivo |db2dj.ini se aplique ao n atual somente, emita: |db2set DB2_DJ_INI=$HOME/sqllib/cfg/db2dj.ini |Se voc estiver utilizando o arquivo db2dj.ini em um |sistema do banco de dados particionado e se quiser que os valores no arquivo |db2dj.ini se apliquem a todos os ns dentro dessa instncia, |emita: |db2set -g DB2_DJ_INI=$HOME/sqllib/cfg/db2dj.ini |Se voc estiver utilizando o arquivo db2dj.ini em um |sistema do banco de dados particionado e se quiser que os valores no arquivo |db2dj.ini se aplique a um n especfico, emita: |db2set -i INSTANCEX 3 DB2_DJ_INI=$HOME/sqllib/cfg/node3.ini |onde: | |INSTANCEX | o nome da instncia. |3 | o nmero do n conforme listado no arquivo |db2nodes.cfg. |node3.ini | a verso modificada e renomeada do arquivo |db2dj.ini. | | |6.6.1.2 Etapa 2: Ligar o DB2 ao Software do Cliente Sybase (Apenas AIX e Solaris) | |Para permitir acesso s origens de dados do Sybase, o servidor federado do |DB2 deve ser link-edited s bibliotecas do cliente. O processo de |link-edit cria um wrapper para cada origem de dados com a qual o servidor |federado ir se comunicar. Quando voc executar o script |djxlink, crie a biblioteca de wrappers. Para emitir o script |djxlink, digite: |djxlink |6.6.1.3 Etapa 3: Reciclar a Instncia do DB2 (Apenas AIX e Solaris) |Para assegurar-se de que as vari veis de ambiente estejam definidas no |programa, recicle a instncia do DB2. Quando voc reciclar a instncia, |atualize a instncia do DB2 para aceitar as alteraes feitas. |Emita os comandos a seguir, para reciclar a instncia do DB2: | |No DB2 para servidores Windows NT: |NET STOP instance_name |NET START instance_name |No DB2 para servidores AIX e Solaris: |db2stop |db2start | |6.6.1.4 Etapa 4: Criar e Configurar um Arquivo de Interfaces |Para criar e configurar um arquivo de interfaces, voc deve criar o arquivo |e torn -lo acessvel. | 1. |Use o utilit rio fornecido pelo Sybase para criar um arquivo de interfaces |que inclui os dados para todos os Sybase Open Servers que voc deseja |acessar. Consulte a documentao da instalao do Sybase para obter |mais informaes sobre o uso desse utilit rio. |Tipicamente, o Windows NT nomeia esse arquivo |sql.ini. Renomeie o arquivo que acabou de criar de |sql.ini para interfaces, para nomear o arquivo |universalmente atravs de todas as plataformas. Se voc optar por no |renomear sql.ini para interfaces, ser necess rio |utilizar o parmetro IFILE ou a opo CONNECTSTRING que explicada na etapa |8. |Em sistemas AIX e Solaris, esse arquivo nomeado /sqllib/interfaces. 2. |Torne o arquivo de interfaces acessvel para DB2. | |No DB2 para servidores Windows NT: |Coloque o arquivo no diretrio %DB2PATH% da instncia do |DB2. |No DB2 para servidores AIX e Solaris: |Coloque o arquivo no diretrio $HOME/sqllib da instncia do |DB2. Utilize o comando ln para ligar-se ao arquivo do |diretrio $HOME/sqllib da instncia do DB2. Por |exemplo: |ln -s -f /home/sybase/interfaces /home/db2djinst1/sqllib | | |6.6.1.5 Etapa 5: Criar o Wrapper |Use a instruo CREATE WRAPPER para especificar o wrapper que ser |utilizado para acessar as origens de dados do Sybase. Wrappers so |mecanismos que os servidores federados utilizam para comunicar-se com e |recuperar dados das origens de dados. O DB2 inclui dois wrappers para |Sybase, CTLIB e DBLIB. O exemplo a seguir mostra uma instruo CREATE |WRAPPER: |CREATE WRAPPER CTLIB |onde CTLIB o nome do wrapper padro utilizado com o software Open Client |do Sysbase. O wrapper CTLIB pode ser utilizado em servidores Windows |NT, AIX e Solaris. |Voc pode substituir o nome do wrapper padro por um nome de sua |escolha. Entretanto, se isso acontecer, ser necess rio tambm incluir |o parmetro LIBRARY e o nome da biblioteca wrapper para seu servidor federado |na instruo CREATE WRAPPER. Consulte a instruo CREATE WRAPPER na |publicao DB2 SQL Reference para obter mais informaes sobre os |nomes de bibliotecas do wrapper. |6.6.1.6 Etapa 6: Opcional: Definir a Vari vel de Ambiente DB2_DJ_COMM | |Para melhorar o desempenho quando a origem de dados do Sybase acessada, |defina a vari vel de ambiente DB2_DJ_COMM. Essa vari vel determina se |um wrapper carregado quando o servidor federado inicializado. |Defina a vari vel de ambiente DB2_DJ_COMM para incluir a biblioteca wrapper |que corresponde ao wrapper especificado na etapa anterior; por |exemplo: | |No DB2 para servidores AIX: |db2set DB2_DJ_COMM='libctlib.a' |No DB2 para servidores Solaris: |db2set DB2_DJ_COMM='libctlib.so' | |Assegure-se de que no haja nenhum espao em nenhum lado do sinal de igual |(=). |Consulte a publicao DB2 SQL Reference para obter mais |informaes sobre os nomes de bibliotecas do wrapper. Consulte a |publicao Manual do Administrador para obter informaes sobre a |vari vel de ambiente DB2_DJ_COMM. |6.6.1.7 Etapa 7: Criar o Servidor |Utilize a instruo CREATE SERVER para definir cada servidor Sybase cujas |origens de dados voc deseja acessar; por exemplo: |CREATE SERVER SYBSERVER TYPE SYBASE VERSION 12.0 WRAPPER CTLIB |OPTIONS (NODE 'sybnode', DBNAME'sybdb') |onde: | |SYBSERVER | um nome atribudo ao servidor Sybase. Este nome deve ser |nico. |SYBASE | o tipo de origem de dados para o qual voc est configurando |acesso. Sybase a nica origem de dados que suportada. |12.0 | a verso do Sybase que voc est acessando. As verses suportadas |so 10.0, 11.0, 11.1, 11.5, 11.9 e |12.0. |CTLIB | o nome do wrapper especificado na instruo CREATE WRAPPER. |'sybnode' | o nome do n onde SYBSERVER reside. Obtenha o valor do |n do arquivo de interfaces. Esse valor sensvel a maisculas e |minsculas. |Embora o nome do n seja especificado como uma opo, ele requerido para |as origens de dados do Sybase. Consulte a publicao DB2 SQL |Reference para obter informaes sobre as opes adicionais. |'sybdb' | o nome do banco de dados do Sybase que voc deseja acessar. |Obtenha esse nome do servidor Sybase | |6.6.1.8 Etapa 8: Opcional: Definir a Opo do Servidor CONNECTSTRING |Especifique os limites de timeout, o caminho e o nome do arquivo de |interfaces e o tamanho do pacote do arquivo de interfaces. O Sybase |Open Client utiliza os limites de timeout para interromper as consultas e as |respostas que so executadas por um longo perodo de tempo. Voc pode |definir esses limites no DB2, utilizando a opo CONNECTSTRING da instruo |CREATE SERVER OPTION DDL . Utilize a opo CONNECTSTRING para |especificar: | * |Durao de timeout para consultas SQL. * |Durao de timeout para resposta de incio de sesso. * |Caminho e nome do arquivo de interfaces. * |Tamanho do pacote. | | .-;-------------------------------. | V | |>>---+-----------------------------+-+------------------------->< | +-TIMEOUT-- = --seconds-------+ | +-LOGIN_TIMEOUT-- = --seconds-+ | +-IFILE-- = --"string"--------+ | +-PACKET_SIZE-- = --bytes-----+ | '-;---------------------------' | | | |TIMEOUT |Especifica o nmero de segundos para o DB2 Universal Database aguardar uma |resposta do Sybase Open Client para qualquer instruo SQL. O valor de |segundos um nmero inteiro positivo no intervalo de inteiros do DB2 |Universal Database. O valor de timeout especificado depende de qual |wrapper voc est utilizando. Os servidores Windows NT, AIX e Solaris |todos conseguem utilizar o wrapper DBLIB. O valor padro para o |servidor DBLIB 0. Em servidores Windows NT, AIX e Solaris, o valor |padro para o DBLIB faz com que o DB2 Universal Database aguarde |indefinidamente uma resposta. |LOGIN_TIMEOUT |Especifica o nmero de segundos para o DB2 Universal Database aguardar uma |resposta do Sybase Open Client para o pedido de incio de sesso. Os |valores padro so os mesmos que para TIMEOUT. |IFILE |Especifica o caminho e o nome do arquivo de interfaces do Sybase Open |Client. O caminho que identificado na cadeia deve ser |colocado entre aspas duplas ("). Em servidores Windows NT, o padro |%DB2PATH%. Em servidores AIX e Solaris, o valor padro |sqllib/interfaces no diretrio pessoal da instncia do DB2 |Universal Database. |PACKET_SIZE |Especifica o tamanho do pacote do arquivo de interfaces em bytes. |Se a origem de dados no suportar o tamanho do pacote especificado, a conexo |falhar . Aumentar o tamanho do pacote quando cada registro muito |grande (por exemplo, quando inserir linhas em tabelas grandes), aumenta |significantemente o desempenho. O tamanho do byte um valor |numrico. Consulte as publicaes de referncia do Sybase, para obter |mais informaes. | |Exemplos: |Em servidores Windows NT, para definir o valor de timeout como 60 segundos |e o arquivo de interfaces como C:\etc\interfaces, |utilize: |CREATE SERVER OPTION connectstring FOR SERVER sybase1 |SETTING 'TIMEOUT=60;LOGIN_TIMEOUT=5;IFILE="C:\etc\interfaces"' | |Em servidores AIX e Solaris, defina o valor do timeout como 60 segundos e o |arquivo de interfaces como/etc/interfaces, utilize: |CREATE SERVER OPTION connectstring FOR SERVER sybase1 |SETTING 'TIMEOUT=60;PACKET_SIZE=4096;IFILE="/etc/interfaces"' | |6.6.1.9 Etapa 9: Criar um Mapeamento do Usu rio |Se um ID do usu rio ou uma senha no servidor federado for diferente de um |ID do usu rio ou senha da origem de dados do Sybase, utilize a instruo |CREATE USER MAPPING para mapear o ID do usu rio local para o ID do usu rio e a |senha definidos na origem de dados do Sybase; por exemplo: |CREATE USER MAPPING FOR DB2USER SERVER SYBSERVER |OPTIONS ( REMOTE_AUTHID 'sybuser', REMOTE_PASSWORD 'day2night') |onde: | |DB2USER | o ID do usu rio local que voc est mapeando para um ID do usu rio |definido em uma origem de dados do Sybase. |SYBSERVER | o nome da origem de dados do Sybase definido na instruo CREATE |SERVER. |'sybuser' | o ID do usu rio na origem de dados do Sybase para o qual voc est |mapeando DB2USER. Este valor faz distino entre letras |maisculas e minsculas. |'day2night' | a senha associada ao 'sybuser'. Este valor faz |distino entre letras maisculas e minsculas. | |Consulte a publicao DB2 SQL Reference para obter mais |informaes sobre opes adicionais. |6.6.1.10 Etapa 10: Criar Pseudnimos para Tabelas e Exibies |Atribua um pseudnimo para cada exibio ou tabela localizadas em sua |origem de dados do Sybase. Voc utilizar esses pseudnimos quando |consultar a origem de dados do Sybase. Os pseudnimos do Sybase tm |distino entre maisculas e minsculas. Coloque o esquema e os nomes |de tabelas entre aspas duplas ("). O exemplo a seguir mostra uma |instruo CREATE NICKNAME: |CREATE NICKNAME SYBSALES FOR SYBSERVER."salesdata"."europe" |onde: | |SYBSALES | um pseudnimo nico para a tabela ou a exibio Sybase. | | |SYBSERVER."salesdata"."europe" | um identificador de trs partes que segue este formato: |data_source_name."remote_schema_name"."remote_table_name" | |Repita essa etapa para cada tabela ou exibio, para a qual voc deseja |criar pseudnimos. Quando voc cria o pseudnimo, o DB2 utilizar a |conexo para consultar o cat logo de origens de dados. Essa consulta |testa sua conexo origem de dados. Se a conexo no funcionar, voc |receber uma mensagem de erro. |Consulte a publicao DB2 SQL Reference para obter mais |informaes sobre a instruo CREATE NICKNAME. Para obter mais |informaes sobre os pseudnimos em geral e para verificar os mapeamentos de |tipos de dados, consulte a publicao Manual de Administrao do |DB2. |6.6.2 Especificando as P ginas de Cdigos do Sybase | |Esta etapa necess ria apenas quando o servidor federado do DB2 e o |servidor Sybase esto executando diferentes p ginas de cdigos. As |origens de dados que esto utilizando o mesmo conjunto de cdigos que o DB2, |no requerem converso. A tabela a seguir fornece opes equivalentes |do Sybase para p ginas de cdigos do NLS (National Language Support). |As origens de dados do Sybase devem ser configuradas para corresponder a esses |equivalentes ou o cdigo do cliente deve conseguir detectar a inconsistncia e |sinaliz -la como um erro ou mapear os dados utilizando suas prprias |semnticas. Se nenhuma tabela de converso puder ser encontrada da |p gina de cdigos de origem para a p gina de cdigos de destino, o DB2 emitir |uma mensagem de erro. Consulte a documentao do Sybase, para obter |mais informaes. | |Tabela 2. Opes da P gina de Cdigos Sybase P gina de Opo Sybase equivalente cdigo 850 cp850 897 sjis 819 iso_1 912 iso_2 1089 iso_6 813 iso_7 916 iso_8 920 iso_9 ------------------------------------------------------------------------ |6.7 Acessando as Origens de Dados do Microsoft SQL Server Utilizando ODBC (Novo Captulo) | | |Antes de incluir as origens de dados do servidor Microsoft SQL em um |servidor federado do DB2, preciso instalar e configurar o driver ODBC no |servidor federado. Consulte os procedimentos de instalao na |documentao que fornecida com o driver ODBS, para obter detalhes |especficos sobre como instalar o driver ODBC. |Para configurar o servidor federado para acessar os dados armazenados nas |origens de dados do servidor Microsoft SQL, voc precisa: | 1. |Instale e configure o driver ODBC no servidor federado. Consulte os |procedimentos de instalao na documentao que fornecida com o driver ODBS, |para obter detalhes especficos sobre como instalar o driver ODBC. | |No DB2 para servidores Windows NT: |Configure um DSN do sistema, utilizando o gerenciador de dispositivo |ODBC. No Windows ODBC Data Administrator, especifique o driver do |servidor SQL e prossiga atravs do di logo para incluir um novo DSN de |Sistema. Especifique "Autenticao de SQL Server utilizando ID de Login |e senha fornecidos pelo usu rio." |No DB2 para servidores AIX: |Instale a verso encadeada das bibliotecas fornecidas pelo MERANT, |especifique o diretrio da biblioteca MERANT como a primeira entrada no |LIBPATH e configure o arquivo .odbc.ini. | 2. |Instale o DB2 Relational Connect Verso 7.2. Consulte a |seo 6.3.3, Instalando o DB2 Relational Connect. 3. |Inclua as origens de dados do Microsoft SQL Server em seu servidor |federado. 4. |Especifique as p ginas de cdigos do Microsoft SQL Server. (Windows |NT somente) | |Este captulo discute as etapas 3 e 4. |As instrues neste captulo aplicam-se s plataformas Windows NT e |AIX. As diferenas especficas da plataforma so observadas onde elas |ocorrem. |6.7.1 Incluindo Origens de Dados do Microsoft SQL Server em um Servidor Federado |Aps voc instalar o driver ODBC e o DB2 Relational Connect, inclua as |origens de dados do Microsoft SQL Server em seu servidor federado utilizando |estas etapas: | 1. |Defina as vari veis de ambiente (apenas AIX). 2. |Execute o script de shell (apenas AIX). 3. |Opcional: Defina a vari vel de ambiente DB2_DJ_COMM. (AIX |somente) 4. |Recicle a instncia do DB2 (apenas AIX). 5. |Crie o wrapper. 6. |Crie o servidor. 7. |Crie um mapeamento do usu rio. 8. |Crie pseudnimos para tabelas e exibies. 9. |Opcional: Obtenha os rastreios do ODBC. | |Estas etapas so explicadas com detalhes nas sees a seguir. |6.7.1.1 Etapa 1: Definir as Vari veis de Ambiente (Apenas AIX) | |Defina vari veis de ambiente da origem de dados modificando o arquivo |db2dj.ini e emitindo o comando db2set. O |arquivo db2dj.ini contm informaes de configurao para |conectar-se s origens de dados do Microsoft SQL Server. O comando |db2set atualiza o registro de perfil do DB2 com suas |definies. |Em um sistema do banco de dados particionado, voc pode utilizar um nico |arquivo db2dj.ini para todos os ns em uma instncia |especfica ou voc pode utilizar um nico arquivo db2dj.ini |para um ou mais ns em uma instncia especfica. Um sistema de banco de |dados no-particionado pode ter apenas um arquivo db2dj.ini |por instncia. |Para definir as vari veis de ambiente: | 1. |Edite o arquivo db2dj.ini localizado em |$HOME/sqllib/cfg/ e defina as seguintes vari veis de |ambiente: |ODBCINI=$HOME/.odbc.ini |DJX_ODBC_LIBRARY_PATH=/lib |DB2ENVLIST=LIBPATH | | |Emita o comando db2set para atualizar o registro do perfil do |DB2 com suas mudanas. A sintaxe de db2set dependente da |estrutura do sistema do banco de dados: | * |Se voc estiver utilizando o arquivo db2dj.ini em um |sistema de banco de dados no-particionado ou se voc estiver utilizando o |arquivo db2dj.ini em um sistema de banco de dados |particionado e quiser que os valores no arquivo db2dj.ini |apliquem-se ao n atual somente, emita este comando: |db2set DB2_DJ_INI=/db2dj.ini | | * |Se voc estiver utilizando o arquivo db2dj.ini em um |sistema do banco de dados particionado e se quiser que os valores no arquivo |db2dj.ini se apliquem a todos os ns dentro dessa instncia, |emita este comando: |db2set -g DB2_DJ_INI=/db2dj.ini | | * |Se voc estiver utilizando o arquivo db2dj.ini em um |sistema do banco de dados particionado e se quiser que os valores no arquivo |db2dj.ini se aplique a um n especfico, emita este |comando: |db2set -i INSTANCEX 3 DB2_DJ_INI=$HOME/sqllib/cfg/node3.ini |onde: | |INSTANCEX | o nome da instncia. |3 | o nmero do n conforme listado no arquivo |db2nodes.cfg. |node3.ini | a verso modificada e renomeada do arquivo |db2dj.ini. | | |Para definir o caminho biblioteca cliente, emita estes comandos: |db2set DB2LIBPATH= |db2set DB2ENVLIST=LIBPATH |6.7.1.2 Etapa 2: Executar o Script de Shell (Apenas AIX) | |O script de shell djxlink.sh liga as bibliotecas do |cliente s bibliotecas do wrapper. Para executar o script de |shell: |djxlink |6.7.1.3 Etapa 3: Opcional: Definir a Vari vel de Ambiente DB2_DJ_COMM (Apenas AIX) | |Se voc achar que ela obtm um perodo de tempo irregular para acessar a |origem de dados do Microsoft SQL Server, poder melhorar o desempenho |definindo a vari vel de ambiente DB2_DJ_COMM para carregar o wrapper quando o |servidor federado inicializado, em vez de quando voc tenta acessar a origem |de dados. Defina a vari vel de ambiente DB2_DJ_COMM para incluir a |biblioteca wrapper que corresponde ao wrapper especificado na Etapa 5. |Por exemplo: | |No DB2 para servidores Windows NT: |db2set DB2_DJ_COMM=djxmssql3.dll |No DB2 para servidores AIX: |db2set DB2_DJ_COMM=libmssql3.a | |Assegure-se de que no haja nenhum espao em nenhum lado do sinal de igual |(=). |Consulte a publicao DB2 SQL Reference para obter mais |informaes sobre os nomes da biblioteca wrapper. |6.7.1.4 Etapa 4: Reciclar a Instncia do DB2 (Apenas AIX) |Para assegurar-se de que as vari veis de ambiente estejam definidas no |programa, recicle a instncia do DB2. Quando voc reciclar a instncia, |atualize a instncia do DB2 para aceitar as alteraes feitas. Recicle |a instncia do DB2, emitindo os seguintes comandos: |db2stop |db2start |6.7.1.5 Etapa 5: Criar o Wrapper | |O DB2 Universal Database possui dois protocolos diferentes, chamados |wrappers, que voc pode utilizar para acessar as origens de dados do Microsoft |SQL Server. Wrappers so mecanismos que os servidores federados |utilizam para comunicar-se com as origens de dados e recuperar dados destas |fontes. O wrapper que voc utiliza depende da platarfoma na qual o DB2 |Universal Database est sendo executado. Utilize Tabela 3 como um guia, para selecionar o wrapper apropriado. | |Tabela 3. Drivers ODBC Drivers ODBC Plataforma Nome do Wrapper Driver ODBC 3.0 (ou superior) Windows NT DJXMSSQL3 Driver MERANT DataDirect Connect AIX MSSQLODBC3 ODBC 3.6 |Utilize a instruo CREATE WRAPPER para especificar o wrapper que |ser utilizado para acessar as origens de dados do Microsoft SQL |Server. O exemplo a seguir mostra uma instruo CREATE WRAPPER: |CREATE WRAPPER DJXMSSQL3 |onde DJXMSSQL3 o nome do wrapper padro utilizado em um |servidor DB2 para Windows NT (utilizando o driver ODBC 3.0). Se |voc tiver um servidor DB2 para AIX, especificar o nome do wrapper |MSSQLODBC3. |Voc pode substituir o nome do wrapper padro por um nome de sua |escolha. Entretanto, se isso acontecer, voc dever incluir o parmetro |LIBRARY e o nome da biblioteca wrapper para seu servidor federado na instruo |CREATE WRAPPER. Por exemplo: | |No DB2 para servidores Windows NT: |CREATE WRAPPER wrapper_name LIBRARY 'djxmssql3.dll' |onde wrapper_name o nome que voc deseja fornecer ao wrapper |e 'djxmssql3.dll' o nome da biblioteca. |No DB2 para servidores AIX: |CREATE WRAPPER wrapper_name LIBRARY 'libmssql3.a' |onde wrapper_name o nome que voc deseja fornecer ao wrapper |e 'libdjxmssql.a' o nome da biblioteca. | |Consulte a instruo CREATE WRAPPER na publicao DB2 SQL |Reference para obter mais informaes sobre os nomes de bibliotecas do |wrapper. |6.7.1.6 Etapa 6: Criar o Servidor | |Utilize a instruo CREATE SERVER para definir cada origem de dados do |Microsoft SQL Server ao qual voc deseja conectar-se. Por |exemplo: |CREATE SERVER sqlserver TYPE MSSQLSERVER VERSION 7.0 WRAPPER djxmssql3 |OPTIONS (NODE 'sqlnode', DBNAME 'database_name') |onde: | |sqlserver | o nome atribudo ao servidor do Microsoft SQL Server. Este nome |deve ser nico. |MSSQLSERVER | o tipo de origem de dados para o qual voc est configurando |acesso. |7.0 | a verso do Microsoft SQL Server que voc est acessando. O DB2 |Universal Database suporta as verses 6.5 e 7.0 do Microsoft SQL |Server. |DJXMSSQL3 | o nome do wrapper definido na instruo CREATE WRAPPER. |'sqlnode' |O nome DSN do sistema que faz referncia verso do Microsoft SQL Server |que voc est acessando. Este valor faz distino entre letras |maisculas e minsculas. O DB2 Universal Database suporta as verses |6.5 e 7.0 do Microsoft SQL Server. |Embora o nome do n (nome do DSN do Sistema) esteja especificado |como uma opo na instruo CREATE SERVER, ele requerido para as origens de |dados do Microsoft SQL Server. No Windows, obtenha o DSN na guia DSN do |Sistema da ferramenta Windows ODBC Data Administrator. No AIX, obtenha |o DSN do arquivo .odbc.ini no diretrio inicial de propriet rios |de instncia do DB2. |Consulte DB2 SQL Reference para opes adicionais que voc pode |utilizar com a instruo CREATE WRAPPER. |'database_name' | o nome do banco de dados ao qual voc est se conectando. |Embora o nome do banco de dados esteja especificado como uma opo na |instruo CREATE SERVER, ele requerido para as origens de dados do Microsoft |SQL Server. | |6.7.1.7 Etapa 7: Criar um Mapeamento do Usu rio |Se um ID do usu rio ou uma senha no servidor federado for diferente de um |ID do usu rio ou senha de uma origem de dados do Microsoft SQL Server, utilize |a instruo CREATE USER MAPPING para mapear o ID do usu rio local para o ID do |usu rio e para a senha definidos na origem de dados do Microsoft SQL |Server; por exemplo: |CREATE USER MAPPING FOR db2user SERVER server_name |OPTIONS (REMOTE_AUTHID 'mssqluser', REMOTE_PASSWORD 'day2night') |onde: | |db2user | o ID do usu rio local que voc est mapeando para um ID do usu rio |definido na origem de dados do Microsoft SQL Server. |server_name | o nome do servidor definido na instruo CREATE SERVER. |'mssqluser' | o ID de login na origem de dados do Microsoft SQL Server para o |qual voc est mapeando db2user. Este valor faz distino |entre letras maisculas e minsculas. |'day2night' | a senha associada ao 'mssqluser'. Este valor |faz distino entre letras maisculas e minsculas. | |Consulte a publicao DB2 SQL Reference para obter as opes |adicionais que voc pode utilizar com a instruo CREATE USER MAPPING. |6.7.1.8 Etapa 8: Criar Pseudnimos para Tabelas e Exibies |Atribua um pseudnimo para cada exibio ou tabela localizadas em sua |origem de dados do Microsoft SQL Server que voc deseja acessar. Voc |utilizar esses pseudnimos, quando consultar a origem de dados do Microsoft |SQL Server. Utilize a instruo CREATE NICKNAME para atribuir um |pseudnimo. Os pseudnimos tm distino entre maisculas e |minsculas. O exemplo a seguir mostra uma instruo CREATE |NICKNAME: |CREATE NICKNAME mssqlsales FOR server_name.salesdata.europe |onde: | |mssqlsales | um pseudnimo nico para a tabela ou a exibio do Microsoft SQL |Server. |server_name.salesdata.europe | um identificador de trs partes que segue este formato: |data_source_server_name.remote_schema_name.remote_table_name |As aspas duplas so recomendadas para as partes |remote_schema_name e remote_table_name do |pseudnimo. | |Quando voc cria um pseudnimo, o DB2 tenta acessar as tabelas do cat logo |de origens de dados (o Microsoft SQL Server refere-se a estas como tabelas do |sistema). Isso testa a conexo origem de dados. Se a conexo |falhar, voc receber uma mensagem de erro. |Repita esta etapa para todas as tabelas e exibies do banco de dados para |o qual voc deseja criar pseudnimos. |Para obter mais informaes sobre a instruo CREATE NICKNAME, consulte a |publicao DB2 SQL Reference. Para obter mais informaes |sobre os pseudnimos em geral e para verificar os mapeamentos dos tipos de |dados, consulte a publicao Manual de Administrao do DB2. |6.7.1.9 Etapa 9: Opcional: Obter Rastreios do ODBC | |Se voc estiver tendo problemas quando acessar a origem de dados, poder |obter as informaes de rastreio do ODBC para analisar e resolver esses |problemas. Para garantir que o rastreio do ODBC funciona corretamente, |utilize a ferramenta de rastreio fornecida pelo ODBC Data Source |Administrator. Ativar o rastreio impacta o desempenho do sistema, |portanto, voc deve desligar o rastreio quando tiver resolvido os |problemas. |6.7.2 Revendo P ginas de Cdigo do Microsoft SQL Server (Apenas Windows NT) | |O Microsoft SQL Server suporta muitas opes comuns da p gina de cdigos do |NLS (National Language Support) que o UDB do DB2 suporta. As origens de |dados que esto utilizando o mesmo conjunto de cdigos que o DB2, no requerem |converso. A tabela 3 lista as p ginas de cdigos que so suportadas |pelo DB2 Universal Database e Microsoft SQL Server. | |Tabela 4. Opes da P gina de Cdigos do DB2 UDB e do Microsoft SQL Server P gina de Idioma suportado cdigos 1252 Conjunto de caracteres ISO 850 Multilnge 437 Ingls Americano 874 Tai 932 Japons 936 Chins (simplificado) 949 Coreano 950 Chins (tradicional) 1250 Europa Central 1251 Cirlico 1253 Grego 1254 Turco 1255 Hebraico 1256 rabe |Quando o servidor federado do DB2 e o Microsoft SQL Server estiverem |executando diferentes p ginas de cdigos do NLS (National Language Support), |as origens de dados do servidor Microsoft SQL devem ser configuradas para |corresponderem a estes equivalentes ou o cdigo cliente deve conseguir |detectar a inconsistncia e sinaliz -la como um erro ou mapear os dados |utilizando sua prpria semntica. Se nenhuma tabela de converso puder |ser encontrada da p gina de cdigos de origem para a p gina de cdigos de |destino, o DB2 emitir uma mensagem de erro. Consulte a documentao do |Microsoft SQL Server, para obter mais informaes. ------------------------------------------------------------------------ 6.8 Acessando Origens de Dados do Informix (Novo Captulo) Antes de incluir origens de dados do Informix em um servidor federado DB2, voc precisa instalar e configurar o software Informix Client SDK no servidor federado. Consulte os procedimentos de instalao na documentao fornecida com o software de banco de dados Informix para obter detalhes especficos sobre como instalar o software Client SDK. Como parte da instalao, certifique-se de incluir as bibliotecas do Informix Client SDK. Para configurar o servidor federado para acessar os dados armazenados nas origens de dados do Informix, voc precisa: 1. Instalar o DB2 Relational Connect. Consulte a seo 6.3.3, Instalando o DB2 Relational Connect. 2. Aplicar o FixPak mais recente do DB2. 3. Incluir origens de dados do Informix no servidor federado. Este captulo descreve a etapa 3. As instrues neste captulo aplicam-se aos sistemas operacionais AIX, Solaris Operating Environment e HP-UX. Diferenas especficas dos sistemas operacionais sero indicadas quando ocorrerem. 6.8.1 Incluindo Origens de Dados do Informix em um Servidor Federado Para incluir uma origem de dados do Informix em um servidor federado, voc precisa: 1. Definir as vari veis de ambiente e atualizar o registro do perfil. 2. Ligar o DB2 ao software Informix Client. 3. Reciclar a instncia do DB2. 4. Criar o arquivo sqlhosts do Informix. 5. Crie o wrapper. 6. Opcional: Defina a vari vel de ambiente DB2_DJ_COMM. 7. Criar um servidor. 8. Crie um mapeamento do usu rio. 9. Criar pseudnimos para tabelas, exibies e sinnimos do Informix. Estas etapas so explicadas com detalhes nesta seo. 6.8.1.1 Etapa 1: Definir as Vari veis de Ambiente e Atualizar o Registro do Perfil Defina vari veis de ambiente da origem de dados modificando o arquivo db2dj.ini e emitindo o comando db2set. O arquivo db2dj.ini contm informaes de configurao sobre o software Informix Client instalado no servidor federado. O comando db2set atualiza o registro de perfil do DB2 com suas definies. Em um sistema do banco de dados particionado, voc pode utilizar um nico arquivo db2dj.ini para todos os ns em uma instncia especfica ou voc pode utilizar um nico arquivo db2dj.ini para um ou mais ns em uma instncia especfica. Um sistema de banco de dados no-particionado pode ter apenas um arquivo db2dj.ini por instncia. Para definir as vari veis de ambiente: 1. Edite o arquivo db2dj.ini localizado no diretrio sqllib/cfg e defina as seguintes vari veis de ambiente: Nota: |Voc mesmo pode criar esse arquivo se ele ainda no estiver no |sistema. | INFORMIXDIR Defina a vari vel de ambiente INFORMIXDIR para o caminho do diretrio no qual o software Informix Client SDK est instalado; por exemplo: |INFORMIXDIR=/informix/csdk INFORMIXSERVER Esta vari vel identifica o nome do servidor padro Informix. |INFORMIXSERVER=inf93 | Nota: Embora o wrapper do Informix no utilize o valor desta vari vel, o Informix Client requer a definio desta vari vel. O wrapper utiliza o valor da opo de servidor node, que especifica o servidor de banco de dados Informix que voc deseja acessar. INFORMIXSQLHOSTS Se voc estiver utilizando o caminho padro para o arquivo sqlhosts do Informix ($INFORMIXDIR/etc/sqlhosts), no ser necess rio definir esta vari vel. No entanto, se voc estiver utilizando um caminho para o arquivo sqlhosts do Informix que seja diferente do padro, ser necess rio definir esta vari vel para o nome completo do caminho do arquivo sqlhosts do Informix. Por exemplo: |INFORMIXSQLHOSTS=/informix/csdk/etc/my_sqlhosts | 2. Atualize o arquivo .profile da instncia do DB2 com as vari veis de ambiente do Informix. Voc pode fazer isso emitindo os seguintes comandos para definir e exportar cada vari vel: PATH=$INFORMIXDIR/bin:$PATH export PATH INFORMIXDIR= export INFORMIXDIR em que informix_client_path o caminho no servidor federado para o diretrio no qual o Informix Client est instalado. Utilize aspas duplas (") em torno do caminho se um nome no caminho tiver um espao em branco. 3. Execute a instncia do DB2 .profile digitando: . .profile 4. Emita o comando db2set para atualizar o registro do perfil do DB2 com suas mudanas. A sintaxe desse comando, db2set, dependente da estrutura do sistema do banco de dados. Essa etapa ser necess ria apenas, se voc estiver utilizando o arquivo db2dj.ini em qualquer uma das seguintes estruturas do sistema do banco de dados: Se voc estiver utilizando o arquivo db2dj.ini em um sistema de banco de dados no-particionado ou se voc quiser que o arquivo db2dj.ini se aplique ao n atual somente, emita: db2set DB2_DJ_INI=sqllib/cfg/db2dj.ini Nota: |Os nomes dos caminhos desta seo devem ser completos. Por |exemplo, my_home/my_instance/sqllib/cfg/db2dj.ini | Se voc estiver utilizando o arquivo db2dj.ini em um sistema do banco de dados particionado e se quiser que os valores no arquivo db2dj.ini se apliquem a todos os ns dentro dessa instncia, emita: db2set -g DB2_DJ_INI = sqllib/cfg/db2dj.ini Se voc estiver utilizando o arquivo db2dj.ini em um sistema do banco de dados particionado e se quiser que os valores no arquivo db2dj.ini se aplique a um n especfico, emita: db2set -i INSTANCEX 3 DB2_DJ_INI=sqllib/cfg/node3.ini onde: INSTANCEX o nome da instncia. 3 o nmero do n conforme listado no arquivo db2nodes.cfg. node3.ini a verso modificada e renomeada do arquivo db2dj.ini. 6.8.1.2 Etapa 2: Ligar o DB2 ao Software Informix Client Para permitir acesso s origens de dados do Informix, o servidor federado DB2 dever ser editado por link para as bibliotecas do cliente. O processo de edio por link cria uma biblioteca de wrapper para cada origem de dados com a qual o servidor federado se comunicar . Ao executar o script djxlinkInformix, voc cria a biblioteca de wrapper do Informix. Para emitir o script djxlinkInformix, digite: djxlinkInformix Nota: |O script djxlinkInformix cria somente a biblioteca wrapper do |Informix. H um outro script, o script djxlink que tenta criar uma |biblioteca wrapper para cada origem de dados que o DB2 Universal Database |suporta (Oracle, Microsoft SQL Server, etc.). Se voc tiver |somente o software cliente para algumas das origens de dados instaladas, voc |receber uma mensagem de erro para cada uma das origens de dados que estiverem |faltando, quando emitir o script djxlink. |Voc precisa de autorizao do UNIX Systems Administrator (raiz) para |executar os scripts djxlinkInformix e djxlink. |Os scripts djxlinkInformix e djxlink gravam mensagens de aviso e de erro |detalhadas em um arquivo especfico, dependendo do sistema operacional. |Por exemplo, no AIX, o script djxlinkInformix grava em |/usr/lpp/db2_07_01/lib/djxlinkInformix.out e o script |djxlink grava em /usr/lpp/db2_07_01/lib/djxlink.out. |Os scripts djxlinkInformix e djxlink criam a biblioteca wrapper em um |diretrio especfico, dependendo do sistema operacional. Por exemplo, |no AIX, a biblioteca wrappers libinformix.a criada no diretrio |/usr/lpp/db2_07_01/lib. |Verifique as permisses na biblioteca wrappers libinformix.a depois |que ela for criada para certificar-se de que ela pode ser lida e executada por |propriet rios de instncia de DB2. Se os propriet rios de instncia no |estiverem no grupo do Sistema, permisses na biblioteca wrapper |libinformix.a precisaro ser -rwxr-xr-x root |system...libinformix.a. | 6.8.1.3 Etapa 3: Reciclar a instncia do DB2 Para assegurar-se de que as vari veis de ambiente estejam definidas no programa, recicle a instncia do DB2. Quando voc reciclar a instncia, atualize a instncia do DB2 para aceitar as alteraes feitas. Emita os comandos a seguir, para reciclar a instncia do DB2: No DB2 para servidores AIX, Solaris Operating Environment e HP-UX: db2stop db2start |6.8.1.4 Etapa 4: Criar o Arquivo sqlhosts do Informix |O arquivo especifica a localizao de cada servidor de banco de dados |Informix e o tipo de conexo (protocolo) para o servidor de banco de |dados. H v rias formas de criar esse arquivo. Voc pode |copi -lo de outro sistema que tenha Informix Connect ou Informix Client SDK |conectado a um servidor Informix. Voc pode tambm configurar o |Informix Client SDK no servidor do DB2 para conectar a um servidor Informix, |que cria o arquivo sqlhosts. |Depois que o arquivo sqlhosts for copiado ou criado, o propriet rio de |instncia do DB2 deve utilizar Informix dbaccess (se ele estiver no servidor |DB2) para conectar e consultar o servidor Informix. Isso estabelecer |que o Informix Client SDK capaz de conectar-se ao servidor Informix, antes |que voc tente configurar o DB2 Relational Connect para trabalhar com o |Informix Client SDK. |Para maiores informaes sobre como configurar esse arquivo, consulte o |manual do Informix Administrators Guide for Informix Dynamic Server. Aviso: Se voc no definir o nome do servidor de banco de dados Informix no arquivo sqlhosts, receber um erro quando executar uma operao que exija conexo com o servidor de banco de dados Informix. 6.8.1.5 Etapa 5: Criar o Wrapper Utilize a instruo CREATE WRAPPER para especificar o wrapper que ser utilizado para acessar origens de dados do Informix. Wrappers so mecanismos que os servidores federados utilizam para comunicar-se com e recuperar dados das origens de dados. O exemplo a seguir mostra uma instruo CREATE WRAPPER: CREATE WRAPPER informix em que informix o wrapper_name; informix o nome padro do wrapper utilizado com o software Informix Client SDK. Voc pode substituir o nome do wrapper padro por um nome de sua escolha. Entretanto, se isso acontecer, ser necess rio tambm incluir o parmetro LIBRARY e o nome da biblioteca wrapper para seu servidor federado na instruo CREATE WRAPPER. Consulte a instruo CREATE WRAPPER na publicao DB2 SOL Reference para obter mais informaes sobre os nomes de biblioteca do wrapper. Os nomes de biblioteca do wrapper para o Informix so: * libinformix.a (AIX) * libinformix.so (Solaris Operating Environment) * libinformix.sl (HP-UX) 6.8.1.6 Etapa 6: Opcional: Defina a Vari vel de Ambiente DB2_DJ_COMM Para melhorar o desempenho quando a origem de dados do Informix for acessada, defina a vari vel de ambiente DB2_DJ_COMM no servidor federado. Esta vari vel determina se um wrapper carregado quando o servidor federado inicializado. Defina a vari vel de ambiente DB2_DJ_COMM para incluir a biblioteca do wrapper que corresponde ao wrapper especificado na etapa anterior. Se voc estiver utilizando as interfaces de linha de comandos Korn shell ou Bourne shell, utilize estes comandos de exportao: No DB2 para servidores AIX: DB2_DJ_COMM='libinformix.a' export DB2_DJ_COMM No DB2 para servidores Solaris Operating Environment: DB2_DJ_COMM='libinformix.so' export DB2_DJ_COMM No DB2 para servidores HP-UX: DB2_DJ_COMM='libinformix.sl' export DB2_DJ_COMM Assegure-se de que no haja nenhum espao em nenhum lado do sinal de igual (=). Se voc estiver utilizando a interface de linha de comandos da shell C, defina as vari veis de ambiente utilizando estes comandos: setenv DB2_DJ_COMM 'libinformix.a' (servidores DB2 para AIX) setenv DB2_DJ_COMM 'libinformix.so' (DB2 para servidores Solaris Environment) setenv DB2_DJ_COMM 'libinformix.sl' (servidores DB2 para HP--UX) Consulte a publicao DB2 SQL Reference para obter mais informaes sobre os nomes de biblioteca do wrapper e a vari vel de ambiente DB2_DJ_COMM. 6.8.1.7 Etapa 7: Criar o Servidor Utilize a instruo CREATE SERVER para definir cada servidor Informix cujas origens de dados voc deseja acessar. A sintaxe para essa instruo : CREATE SERVER server_name TYPE server_type VERSION server_version WRAPPER wrapper_name OPTIONS (NODE 'node_name', DBNAME 'database_name') onde: |server_name | um nome que voc atribui ao servidor de banco de dados Informix. |Esse nome deve ser nico e no duplicar nenhum outro server_name definido no |banco de dados federado. O server_name no pode ser igual ao de |qualquer espao de tabela no banco de dados federado. TYPE server_type Especifica o tipo de origem de dados para o qual voc est configurando o acesso. Nota: |Para o wrapper do Informix, o server_type deve ser informix. | VERSION server_version a verso do servidor de banco de dados Informix que voc deseja acessar. As verses do Informix suportadas so 5, 7, 8 e 9. WRAPPER wrapper_name o nome especificado na instruo CREATE WRAPPER. NODE 'node_name' o nome do n no qual o server_name reside. O node_name deve ser definido no arquivo sqlhosts do Informix (consulte a etapa 4). Embora o node_name esteja especificado como uma opo na instruo CREATE SERVER SQL, ele obrigatrio para origens de dados do Informix. Esse valor sensvel a maisculas e minsculas. Consulte a publicao DB2 SQL Reference para obter informaes sobre as opes adicionais. DBNAME 'database_name' o nome do banco de dados Informix que voc deseja acessar. Segue um exemplo da instruo CREATE SERVER: CREATE SERVER asia TYPE informix VERSION 9 WRAPPER informix OPTIONS (NODE 'abc', DBNAME 'sales') As opes FOLD_ID e FOLD_PW do servidor afetam se o wrapper dever transformar o ID de usu rio e a senha em letras maisculas ou minsculas antes de envi -los para o Informix. Um exemplo da instruo CREATE SERVER com as opes FOLD_ID e FOLD_PW do servidor : CREATE SERVER asia TYPE informix VERSION 9 WRAPPER informix OPTIONS (NODE 'abc', DBNAME 'sales', FOLD_ID 'U', FOLD_PW 'U') 6.8.1.8 Etapa 8: Criar um Mapeamento do Usu rio Se um ID de usu rio ou senha no servidor federado DB2 for diferente de um ID de usu rio ou senha em uma origem de dados do Informix, utilize a instruo CREATE USER MAPPING para mapear o ID de usu rio local para o ID de usu rio e senha definidos na origem de dados do Informix; por exemplo: CREATE USER MAPPING FOR local_userid SERVER server_name OPTIONS (REMOTE_AUTHID 'remode_userid', REMOTE_PASSWORD 'remote_password') onde: local_userid o ID de usu rio local que voc est mapeamento para um ID de usu rio definido em uma origem de dados do Informix. SERVER server_name o nome da origem de dados do Informix que voc definiu na instruo CREATE SERVER. REMOTE_AUTHID 'remote_userid' o ID de usu rio no servidor de banco de dados Informix para o qual voc est mapeando o local_userid. Este valor diferencia maisculas e minsculas, a menos que voc defina a opo FOLD_ID do servidor para 'U' ou 'L' na instruo CREATE SERVER. REMOTE_PASSWORD 'remote_password' | a senha associada ao remote_userid. Este valor |diferencia maisculas e minsculas, a menos que voc defina a opo FOLD_PW do |servidor para 'U' ou 'L' na instruo CREATE |SERVER. Segue um exemplo da instruo CREATE USER MAPPING: CREATE USER MAPPING FOR robert SERVER asia OPTIONS (REMOTE_AUTHID 'bob', REMOTE_PASSWORD 'day2night') Voc pode utilizar o registro especial USER do DB2 para mapear o ID de autorizao da pessoa que est emitindo a instruo CREATE USER MAPPING para o ID de autorizao da origem de dados especificado na opo REMOTE_AUTHID do usu rio. Segue um exemplo da instruo CREATE USER MAPPING que inclui o registro especial USER: CREATE USER MAPPING FOR USER SERVER asia OPTIONS (REMOTE_AUTHID 'bob', REMOTE_PASSWORD 'day2night') Consulte a publicao DB2 SQL Reference para obter mais informaes sobre opes adicionais. 6.8.1.9 Etapa 9: Criar Pseudnimos para Tabelas, Exibies e Sinnimos do Informix Atribua um pseudnimo para cada tabela, exibio ou sinnimo do Informix localizado na origem de dados do Informix. Os pseudnimos podem conter 128 caracteres. Voc utilizar esses pseudnimos quando consultar a origem de dados do Informix. O DB2 transformar os nomes de servidor, esquema e tabela em letras maisculas, a menos que voc os coloque entre aspas duplas ("). O exemplo a seguir mostra uma instruo CREATE NICKNAME: CREATE NICKNAME nickname FOR server_name."remote_schema_name"."remote_table_name" onde: nickname um pseudnimo exclusivo utilizado para identificar a tabela, exibio ou sinnimo do Informix. server_name."remote_schema_name"."remote_table_name" um identificador de trs partes do objeto remoto. o server_name o nome atribudo ao servidor de banco de dados Informix na instruo CREATE SERVER. o remote_schema_name o nome do esquema remoto ao qual a tabela, exibio ou sinnimo pertence. o remote_table_name o nome da tabela, exibio ou sinnimo remoto que voc deseja acessar. Segue um exemplo da instruo CREATE NICKNAME: CREATE NICKNAME salesjapan FOR asia."salesdata"."japan" Repita essa etapa para cada tabela ou exibio para a qual voc deseja criar um pseudnimo. Quando voc cria o pseudnimo, o DB2 utilizar a conexo para consultar o cat logo de origens de dados. Essa consulta testa sua conexo origem de dados. Se a conexo no funcionar, voc receber uma mensagem de erro. Consulte a publicao DB2 SQL Reference para obter mais informaes sobre a instruo CREATE NICKNAME. Para obter mais informaes sobre os pseudnimos em geral e para verificar os mapeamentos de tipos de dados, consulte a publicao Manual de Administrao do DB2. ------------------------------------------------------------------------ Administrao ndice Parcial * Manual de Administrao o |7.1 Atualizao Disponvel * Manual de Administrao: Planejamento o |8.1 Captulo 8. Design do Banco de Dados Fsico + |8.1.1 Consideraes Sobre o Design da rea de Tabela + |8.1.1.1 Otimizando o Desempenho da rea de Tabela Quando os Dados So Colocados no Raid + |8.1.2 Chaves de Partio o 8.2 Apndice D. Incompatibilidade Entre Releases + |8.2.1 Erro SQL30081N No Retornado Quando Perda de Conexo Detectada o 8.3 Apndice E. NLS (National Language Support) + |8.3.1 Suporte ao Cdigo de Pas/Regio e P gina de Cdigos + |8.3.2 Consideraes sobre Importao/Exportao/Carregamento -- Restries para as P ginas de Cdigos 1394 e 5488 + |8.3.3 Valores de Data e Hora + |8.3.3.1 Representaes de Cadeia de Valores de Data e Hora + |8.3.3.2 Cadeias de Data + |8.3.3.3 Cadeias de Hora + |8.3.3.4 Cadeias de Marca de Hora + |8.3.3.5 Consideraes do Conjunto de Caracteres + |8.3.3.6 Formatos de Data e Hora * |Manual de Administrao: Implementao o |9.1 Captulo 8. Recuperando um Banco de Dados + |9.1.1 Como Utilizar E/S Suspensas o |9.2 Novo Mtodo para Especificar Contineres DMS no Windows 2000 e em Sistemas Posteriores o |9.3 Exemplo para Estender o Centro de Controle * |Manual de Administrao: Desempenho o |10.1 Esquemas de Tabelas Tempor rias do Sistema o |10.2 Captulo 8. Desempenho Operacional + |10.2.1 Conjunto de Buffers com Base em Bloco + |10.2.1.1 Exemplos de Conjuntos de Buffers Com Base em Blocos o |10.3 Captulo 10. Ajustando a Escala de Configurao Atravs da Incluso de Processadores + |10.3.1 Problemas Ao Incluir Ns em um Banco de Dados Particionado o |10.4 Captulo 13. Configurando o DB2 + |10.4.1 Concluso do Archive de Log Agora Verificada Mais Freqentemente o |10.5 Vari veis de Ambiente e Registro do DB2 + |10.5.1 Correes de Vari veis de Desempenho + |10.5.2 Correes e Incluses nas Vari veis de Registro Diversas + |10.5.3 Correes e Adies s Vari veis de Registro Gerais * |Manual e Referncia de Administrao de Satlites o |11.1 Configurando o DB2 Personal Edition Verso 7.2 e o DB2 Workgroup Edition como Satlites + |11.1.1 Pr-requisitos + |11.1.1.1 Consideraes de Instalao + |11.1.2 Configurando o Sistema Verso 7.2 para Sincronizao + |11.1.3 Instalando o FixPak 2 ou Superior em um Sistema Enterprise Edition Verso 6 + |11.1.3.1 Atualizando o DB2 Enterprise Edition Verso 6 para Uso como o DB2 Control Server + |11.1.4 Atualizando uma Verso 6 do Centro de Controle e do Centro de Administrao do Satlite * |Referncia de Comandos o |12.1 Atualizao Disponvel o |12.2 db2updv7 - Atualizar o Banco de Dados para o Nvel de Correo Atual da Verso 7 o |12.3 REBIND + |Missing value o |12.4 db2inidb - Inicializar um Banco de Dados Espelhado + |12.4.1 Informaes de Utilizao o |12.5 Opo Adicional no Comando GET ROUTINE + |GET ROUTINE o |12.6 CREATE DATABASE * |Recuperao de Dados e Guia e Referncia de Alta Disponibilidade o |13.1 Recuperao de Dados e Guia e Referncia de Alta Disponibilidade Disponvel Online o |13.2 Novo Backup e Comportamento de Restaurao quando LOGRETAIN=CAPTURE o |13.3 NEWLOGPATH2 Agora Chamado de DB2_NEWLOGPATH2 o |13.4 Escolhendo um Mtodo de Backup para o DB2 Data Links Manager no AIX ou Solaris o |13.5 Tivoli Storage Manager -- LAN Free Data Transfer * Guia e Referncia dos Utilit rios de Movimento dos Dados o |14.1 Alterao de Tratamento de Arquivo LOB por Exportar, Importar e Carregar + |14.1.1 Consideraes de IXF o |14.2 Suporte P gina de Cdigos para Utilit rios de Importao, Exportao e Carregamento o |14.3 db2relocatedb (Novo Comando) + |db2relocatedb - Realocar Banco de Dados o |14.4 db2move -- Novas Opes Disponveis + |Movendo Dados Usando a Ferramenta db2move o 14.5 Captulo 2. Importar + 14.5.1 Utilizando importao com inseres em buffer o 14.6 Captulo 3. Carregar + 14.6.1 Estados Pendentes Aps uma Operao de Carregamento + 14.6.2 Restries e Limitaes de Carregamento + 14.6.3 Modificador de tipo do arquivo totalfreespace o 14.7 Captulo 4. Carregador Autom tico + 14.7.1 rexecd Obrigatrio para Executar o AutoLoader Quando a Autenticao Estiver Definida como YES o 14.8 O Carregador Autom tico Pode Travar Durante uma Bifurcao o 14.9 Apndice C. Formatos de Arquivo do Utilit rio de Exportao/Importao/Carregamento * Manual de Referncia e Replicao o 15.1 Replicao e Servidores No-IBM o 15.2 Replicando no Windows 2000 o |15.3 Erro Conhecido Ao Salvar os Arquivos SQL o |15.4 Manuteno do DB2 o |15.5 Utilit rio de Diferena de Dados na Web o 15.6 Captulo 3. Cen rio de Replicao de Dados + 15.6.1 Cen rios de Replicao o 15.7 Captulo 5. Planejando a Replicao + 15.7.1 Nomes de Tabelas e Colunas + 15.7.2 Replicando o DATALINK + 15.7.3 Restries LOB + 15.7.4 Planejando a Replicao o 15.8 Captulo 6. Configurando o Ambiente de Replicao + 15.8.1 Pr-requisito Update-anywhere + 15.8.2 Configurando Seu Ambiente de Replicao o 15.9 Captulo 8. Determinao de Problemas o 15.10 Captulo 9. Capture e Apply para AS/400 o 15.11 Captulo 10. Capture e Apply para OS/390 + |15.11.1 Pr-requisitos para DB2 DataPropagator para OS/390 + |15.11.2 Esquemas de Codificao do UNICODE e ASCII no OS/390 + |15.11.2.1 Escolhendo um Esquema de Codificao + |15.11.2.2 Definindo Esquemas de Codificao o 15.12 Captulo 11. Capture e Apply para plataformas UNIX + |15.12.1 Definindo Vari veis de Ambiente para Capture e Apply no UNIX e Windows o 15.13 Captulo 14. Estruturas de Tabelas o 15.14 Captulo 15. Mensagens de Capture e Apply o 15.15 Apndice A. Iniciando os Programas Capture e Apply de um Aplicativo * Manual e Referncia do System Monitor o 16.1 db2ConvMonStream * Manual da Soluo de Problemas o 17.1 Iniciando o DB2 no Windows 95, Windows 98 e Windows ME quando o usu rio no iniciou sesso o |17.2 Captulo 1. Pr ticas Recomend veis para Deteco de Problemas + |17.2.1 Ferramenta de An lise de Problemas e Coleta de Ambiente + |17.2.1.1 Sadas de Coleta + |17.2.1.2 Exibindo o detailed_system_info.html + |17.2.1.3 Exibindo a Sintaxe da Ferramenta de Suporte ao DB2, Uma P gina por Vez o |17.3 Captulo 2. Detectando Problemas no DB2 Universal Database Server o |17.4 Captulo 8. Detectando Problemas no DB2 Data Links Manager * Utilizando o DB2 Universal Database em Plataformas de 64 bits o 18.1 Captulo 5. Configurao + 18.1.1 LOCKLIST + 18.1.2 shmsys:shminfo_shmmax o 18.2 Captulo 6. Restries * Administrao e Programao do XML Extender * |MQSeries o |20.1 Instalao e Configurao das Funes do DB2 MQSeries + |20.1.1 Instalar o MQSeries + |20.1.2 Instalar o MQSeries AMI + |20.1.3 Ativar as Funes do DB2 MQSeries o |20.2 Estilos de Mensagens do MQSeries o |20.3 Estrutura da Mensagem o |20.4 Viso Geral Funcional do MQSeries + |20.4.1 Limitaes + |20.4.2 Cdigos de Erros o |20.5 Cen rios de Utilizao + |20.5.1 Mensagens B sicas + |20.5.2 Enviando Mensagens + |20.5.3 Recuperando Mensagens + |20.5.4 Conectividade de Aplicativo a Aplicativo + |20.5.4.1 Comunicaes de Pedido/Resposta + |20.5.4.2 Publicar/Associar o |20.6 enable_MQFunctions + |enable_MQFunctions o |20.7 disable_MQFunctions + |disable_MQFunctions ------------------------------------------------------------------------ Manual de Administrao ------------------------------------------------------------------------ |7.1 Atualizao Disponvel |O Manual de Administrao foi atualizado como parte do FixPak 4. O |PDF mais recente est disponvel para download online em http://www.ibm.com/software/data/db2/udb/winos2unix/support. |As informaes nestas notas esto inclusas na referncia de |atualizao. Toda a documentao de atualizao est tambm disponvel |em CD. Este CD pode ser solicitado atravs do servio do DB2 utilizando |o PTF nmero U478862. Informaes sobre o contato com o Servio do DB2 |esto disponveis no endereo http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/help.d2w/report. ------------------------------------------------------------------------ Manual de Administrao: Planejamento ------------------------------------------------------------------------ |8.1 Captulo 8. Design do Banco de Dados Fsico |8.1.1 Consideraes Sobre o Design da rea de Tabela |8.1.1.1 Otimizando o Desempenho da rea de Tabela Quando os Dados So Colocados no Raid | | | | |DB2_PARALLEL_IO |O DB2_PARALLEL_IO tambm afeta reas de tabela com mais de um |continer definido. Se voc no definir a vari vel de registro, o |paralelismo de E/S ser igual ao nmero de contineres na rea de |tabela. Se voc definir a vari vel de registro, o paralelismo de E/S |ser igual ao resultado do tamanho da pr-busca dividido pelo tamanho da |extenso. Voc pode optar por definir a vari vel de registro se os |contineres individuais na rea de tabela forem demarcados em v rios discos |fsicos. |Por exemplo, uma rea de tabela tem dois contineres e o tamanho da |pr-busca quatro vezes o tamanho da extenso. Se a vari vel de |registro no for definida, um pedido de pr-busca para essa rea de tabela |ser dividido em dois pedidos (cada um ser para duas extenses). |Contanto que os pr-buscadores estejam disponveis para trabalhar, dois |pr-buscadores podero estar trabalhando nesses pedidos em paralelo. No |caso da vari vel de registro estar definida, um pedido de pr-busca para essa | rea de tabela ser dividido em quatro pedidos (uma extenso por pedido) com |uma possibilidade de quatro pr-buscadores atendendo os pedidos em |paralelo. |Neste exemplo, se cada um dos dois contineres tinha um nico disco |dedicado a ele, definir a vari vel de registro para essa rea de tabela poder |resultar na conteno nesses discos, uma vez que dois pr-buscadores estaro |acessando cada um dos dois discos de uma vez. Entretanto, se cada um |dos dois contineres tivesse sido demarcado em v rios discos, definir a |vari vel de registro permitiria potencialmente o acesso a quatro discos |diferentes de uma vez. |8.1.2 Chaves de Partio |Na subseo "Consideraes de Design do Grupo de Ns" da seo |"Projetando Grupos de Ns", o texto a seguir da sub subseo "Chaves de |Partio" que indica os pontos a serem considerados para definir as chaves |de partio devem ser excludos apenas se DB2_UPDATE_PART_KEY=ON: |Nota: Se DB2_UPDATE_PART_KEY=OFF, ento, as restries ainda se aplicam. | |Nota: No FixPak 3 e posterior, o valor padro ser OFF. | | * |No possvel atualizar o valor da colune-chave de partio para uma |linha da tabela. * |S possvel excluir ou inserir valores na coluna-chave de |partio. | ------------------------------------------------------------------------ 8.2 Apndice D. Incompatibilidade Entre Releases |8.2.1 Erro SQL30081N No Retornado Quando Perda de Conexo Detectada |Os aplicativos que detectam uma perda de conexo com o servidor de banco de |dados verificando o erro SQL30081N no mais detectaro perdas de conexes na |migrao do DB2 Universal Database Verso 6 ou acima. ------------------------------------------------------------------------ 8.3 Apndice E. NLS (National Language Support) |8.3.1 Suporte ao Cdigo de Pas/Regio e P gina de Cdigos |Na tabela de Idiomas Suportados e Conjuntos de Cdigos, a p gina de cdigos |5488 tambm conhecida como GB 18030 e a p gina de cdigos 1394 tambm |conhecida como ShiftJIS X0213. |8.3.2 Consideraes sobre Importao/Exportao/Carregamento -- Restries para as P ginas de Cdigos 1394 e 5488 |Os dados das p ginas de cdigos 1394 (ShiftJIS X0213) e 5488 (GB 18030) |podem ser movidos para um banco de dados Unicode atravs dos utilit rios de |carregamento ou de importao. O utilit rio de exportao pode ser |utilizado para mover dados de um banco de dados Unicode para um arquivo de |dados nas p ginas de cdigos 1394 e 5488. |Somente conexes entre um cliente Unicode e um servidor Unicode so |suportadas, portanto, necess rio utilizar um cliente Unicode ou definir a |vari vel de registro do DB2 DB2CODEPAGE para 1208 antes de usar os utilit rios |de carregamento, importao ou exportao. |A converso da p gina de cdigos 1394 ou 5488 para o Unicode pode resultar |em expanso. Por exemplo, um caractere de 2 bytes pode ser armazenado |como dois caracteres Unicode de 16 bits nas colunas GRAPHIC. |necess rio assegurar-se de que as colunas de destino no banco de dados Unicode |sejam grandes o suficiente para conter qualquer byte Unicode |expandido. |8.3.3 Valores de Data e Hora |8.3.3.1 Representaes de Cadeia de Valores de Data e Hora | |Valores cujos tipos de dados so DATE, TIME ou TIMESTAMP so representados |em um formato interno que transparente para o usu rio de SQL. Datas, |horas e datas e horas podem tambm, no entanto, ser representadas por cadeias |e essas representaes envolvem diretamente o usu rio de SQL, porque no h |constantes ou vari veis cujos tipos de dados so DATE, TIME ou |TIMESTAMP. Assim, para ser recuperado, um valor de data e hora deve ser |atribudo a uma vari vel de cadeia. A representao da cedia |geralmente o formato padro dos valores de data e hora associados ao cdigo do |pas/regio do cliente, a no ser que substitudo por especificao da opo |do formato DATETIME quando o programa pr-compilado ou ligado ao banco de |dados. |Quando uma representao de cadeia v lida de um valor de data e hora for |utilizado em uma operao com um valor de data e hora interno, a representao |da cadeia convertida para o formato interno da data, da hora ou da data e |hora antes da operao ser executada. Representaes de cadeia v lidas |de valores de data e hora so definidas nas sees a seguir. |Nota: Representaes de cadeia gr fica de valores de data e hora so suportadas |apenas em bancos de dados Unicode. | |8.3.3.2 Cadeias de Data | |Uma representao de cadeia de uma data uma cadeia que comea com um |dgito e tem um comprimento de pelo menos 8 caracteres. Espaos em |branco finais podem ser includos; zeros esquerda podem ser omitidos da |parte do ms e da parte do dia da data. |A tabela "Formatos para Representaes de Cadeias de Datas" permanece |inalterada. |8.3.3.3 Cadeias de Hora | |Uma representao de cadeia de uma hora uma cadeia que comea com um |dgito e tem um comprimento de pelo menos 4 caracteres. Espaos em |branco finais podem ser includos; um zero esquerda pode ser omitido da |parte da hora e os segundos podem ser completamente omitidos. Se voc |optar por omitir os segundos, uma especificao implcita de 0 segundos |assumida. Assim, 13:30 equivalente a |13:30:00. |A tabela "Formatos para Representaes de Cadeias de Horas" permanece |inalterada. |8.3.3.4 Cadeias de Marca de Hora | |Uma representao de cadeia de uma data e hora uma cadeia que comea com |um dgito e tem um comprimento de pelo menos 16 caracteres. A |representao de cadeia completa de uma data e hora tem o formato |aaaa-mm-dd-hh.mm.ss.nnnnnn. Espaos em |branco finais podem ser includos; zeros esquerda podem ser omitidos da |parte do ms, do dia ou da hora da data e hora e os microssegundos podem ser |truncados ou completamente omitidos. Se voc optar por omitir qualquer |dgito da parte de microssegundos, uma especificao implcita de 0 segundos |assumida. Assim, 1991-3-2-8.30.00 |equivalente a |1991-03-02-08.30.00.000000. |8.3.3.5 Consideraes do Conjunto de Caracteres |Cadeias de data e de marca de hora devem conter apenas caracteres e |dgitos. |8.3.3.6 Formatos de Data e Hora |A representao de cadeia dos formatos de data e hora o formato padro |dos valores de data e hora associado ao cdigo do pas/regio do |aplicativo. Esse formato padro pode ser substitudo especificando-se a |opo do formato DATETIME quando o programa pr-compilado ou ligado ao banco |de dados. ------------------------------------------------------------------------ |Manual de Administrao: Implementao ------------------------------------------------------------------------ |9.1 Captulo 8. Recuperando um Banco de Dados |9.1.1 Como Utilizar E/S Suspensas | | | | | |No Captulo 8."Recuperando um Banco de Dados", a seguinte seo |sobre a utilizao da funo E/S suspensas foi includa e atualizada: |Nota: As informaes abaixo sobre o utilit rio db2inidb substituem as informaes |do manual O Que H de Novo na Verso 7.2. | |db2inidb uma nova ferramenta enviada com o DB2 que pode fazer a |recuperao de falha e pr um banco de dados em estado de avano |pendente. |E/S Suspensas suporta disponibilidade contnua de sistema por proporcionar |implementao integral para tratamento de espelhamento dividido online, ou |seja, dividir um espelhamento sem desligar o banco de dados. Se um |cliente no tem condies de fazer backups online ou offline em um grande |banco de dados, backups ou cpias de sistema podem ser feitas a partir de um |espelhamento utilizando-se E/S suspensas e espelhamento dividido. |E/S suspensas evita que o disco grave para assegurar que o espelhamento |dividido de um banco de dados seja consistente. Todas as operaes de |bancos de dados, alm de restaurarem e fazerem backup online, devem funcionar |normalmente enquanto o banco de dados est suspenso. Entretanto, |algumas operaes podem interromper-se durante a tentativa de apagar p ginas |sujas do conjunto de buffers ou acrescentar buffers ao registro. Essas |operaes devem reiniciar normalmente assim que as E/S do banco de dados forem |reiniciadas. importante que as E/S do banco de dados sejam |reiniciadas a partir da mesma conexo de que elas foram originalmente |suspensas. Caso contr rio, uma tentativa subseqente de conexo pode |interromper-se se exigir a limpeza de p ginas sujas do conjunto de buffers |para o disco. |O espelhamento de um banco de dados envolve principalmente copiar o |contedo integral do diretrio do banco de dados. tambm necess rio |copiar o diretrio de registro e quaisquer contineres de rea de tabela, se |no estiverem localizados no diretrio do banco de dados. Como o banco |de dados espelhado dependente desses caminhos de diretrio, os caminhos para |os quais esses diretrios so copiados devem ser idnticos aos do sistema |principal. Isso implica que a instncia deve tambm ser a mesma. |Como resultado dessa dependncia, no possvel espelhar um banco de dados no |mesmo sistema que o principal, a no ser que a nova opo "relocate" da |ferramenta db2inidb seja utilizada. |O propsito da opo "relocate" realocar um banco de dados em um |determinado sistema, utilizando a arquivo de configurao especificado. |Isso pode envolver alterar o diretrio interno do banco de dados, nomes do |diretrio de continer e do diretrio de registro, alterar o nome da instncia |e alterar o nome do banco de dados. Assumindo-se que o diretrio do |banco de dados, diretrios de continer e diretrio de registro foram |espelhados com sucesso nos diferentes caminhos de diretrio no mesmo sistema |que o banco de dados principal, a ferramenta db2inidb pode ser utilizada |juntamente com a opo "relocate" para atualizar os caminhos internos do |banco de dados espelhado. Um cen rio de utilizao com essa opo pode |ser encontrado abaixo. |Dependendo de como os dispositivos de armazenamento esto sendo espelhados, |as utilizaes de db2inidb iro variar. As seguintes utilizaes |assumem que todo o banco de dados est espelhado, consistentemente atravs do |sistema de armazenamento. |Em um ambiente com v rios ns, a ferramenta db2inidb deve ser |executada em cada partio antes que a imagem dividida possa ser utilizada a |partir de qualquer uma das parties. A ferramenta db2inidb pode ser |executada em todas as parties simultaneamente. | | 1. |Clonando um Banco de Dados |O objetivo aqui ter um clone do banco de dados principal para ser |utilizado somente para leitura. O seguinte procedimento descreve como |um banco de dados clone pode ser feito: | a. |Suspenda gravaes de E/S no banco de dados principal, digitando o |seguinte comando: | db2 set write suspend for database b. |Utilize comandos de nvel de sistema operacional para dividir o |espelhamento do banco de dados principal. c. |Reinicie gravaes de E/S no banco de dados principal, digitando o |seguinte comando: | db2 set write resume for database |Aps executar o comando, o banco de dados principal deve voltar ao estado |normal. d. |Monte o espelhamento dividido do banco de dados a partir de outro |sistema. e. |Inicie a instncia do banco de dados digitando o seguinte comando: | db2start f. |Inicie a recuperao de falha do DB2 digitando o seguinte comando: |db2inidb database_name AS SNAPSHOT |Nota: Esse comando remover o estado de gravao suspensa e retomar as alteraes |feitas por transaes que estavam em ao no momento da diviso. | | |Voc tambm pode utilizar esse processo para fazer um backup offline, mas |se restaurado no banco de dados principal, esse backup no pode ser utilizado |para avanar, porque a cadeia de registros no ser igual. | 2. |Utilizando o Espelhamento Dividido como Banco de Dados de Espera |Como o banco de dados espelhado (em espera) est continuamente avanando |atravs dos registros, novos registros que estejam sendo criados pelo banco de |dados principal esto constantemente sendo recuperados do sistema |principal. O seguinte procedimento descreve como um espelhamento |dividido pode ser utilizado como um banco de dados de espera: | a. |Suspenda gravaes de E/S no banco de dados principal. | db2 set write suspend for database b. |Utilize comandos de nvel de sistema operacional para dividir o |espelhamento a partir do banco de dados principal. c. |Reinicie as gravaes de E/S no banco de dados principal de modo que ele |retorne ao processamento normal. | db2 set write resume for database d. |Monte o espelhamento dividido do banco de dados para outro sistema. e. |Posicione o espelhamento em avano pendente e avance o |espelhamento. | db2inidb database_name AS STANDBY | |Nota: Esse comando remover o estado de gravao suspensa e posicionar o banco de |dados espelhado em estado de avano pendente. | f. |Copie os logs configurando um programa de sada de usu rio para recuperar |arquivos de registro a partir de um sistema principal para assegurar que os |registros mais recentes estejam disponveis para esse banco de dados |espelhado. g. |Avance o banco de dados para o final dos logs. h. |Retorne etapa f e repita esse processo at que o banco de dados |principal esteja inativo. | | 3. |Utilizando o Espelhamento Dividido Como uma Imagem de Backup |O seguinte procedimento descreve como utilizar o banco de dados espelhado |como uma imagem de backup para restaurar no banco de dados principal: | a. |Utilize comandos de sistema operacional para copiar os dados espelhados e |registros sobre o banco de dados principal. b. |Inicie a instncia do banco de dados digitando o seguinte comando: | db2start c. |Execute o seguinte comando para posicionar o banco de dados espelhado em |um estado de avano pendente e remover o estado de gravao suspensa. |db2inidb database_name AS MIRROR d. |Avance o banco de dados para o final dos logs. | | 4. |Dividindo um Espelhamento no Mesmo Sistema que o Banco de Dados Principal |O seguinte procedimento descreve como utilizar a opo "relocate" da |ferramenta db2inidb para espelhar um banco de dados no mesmo sistema que um |banco de dados principal. O exemplo assume que o banco de dados ser |utilizado sob uma nova instncia. | a. |Crie uma nova instncia no sistema atual. b. |Suspenda gravaes de E/S no banco de dados principal. | db2 set write suspend for database c. |Utilize comandos de nvel de sistema operacional para dividir o |espelhamento a partir do banco de dados principal. |Nota: O diretrio de banco de dados, os diretrios de continer e o diretrio de |registro devem ser copiados para diferentes diretrios. Se os |diretrios de continer ou o diretrio de registro existirem sob o diretrio |de banco de dados, somente o diretrio de banco de dados precisa ser |copiado. | d. |Reinicie gravaes de E/S no banco de dados principal de modo que ele |retorne ao processamento normal. | db2 set write resume for database e. |Crie um arquivo de configurao com as seguintes informaes: | DB_NAME=, | DB_PATH=, | INSTANCE=, | LOG_DIR=, | CONT_PATH=, | ... | CONT_PATH=, | | NODENUM= | |Nota: Os campos LOG_DIR e CONT_PATH so obrigatrios somente se o diretrio de |registro e os diretrios de continer existirem fora do diretrio do banco de |dados. Todos os outros campos so obrigatrios, com exceo de NODENUM |que assumir o valor de zero como padro se nada for especificado. | f. |Inicie o banco de dados a partir da instncia recm-criada. | db2start g. |Realoque o banco de dados espelhado, remova o estado suspenso e posicione |o espelhamento em estado de avano pendente: | db2inidb database_name as STANDBY relocate using config_file h. |Copie os logs configurando um programa de sada de usu rio para recuperar |arquivos de registro a partir de um sistema principal, assegurando que os logs |mais recentes estaro disponveis para esse banco de dados espelhado. i. |Avance o banco de dados para o final dos logs. j. |Retorne etapa h e repita esse processo at que o banco de dados |principal esteja inativo. | | ------------------------------------------------------------------------ |9.2 Novo Mtodo para Especificar Contineres DMS no Windows 2000 e em Sistemas Posteriores |O DB2 agora utiliza um novo mtodo para especificar contineres DMS de rea |de tabela simples no Windows 2000 e em sistemas posteriores. Cada |partio de disco b sica ou volume dinmico atribudo um GUID (globally |unique identifier, identificador globalmente exclusivo) na hora da |criao. Esse GUID pode ser utilizado como um identificador de |dispositivo ao especificar contineres em uma definio de rea de |tabela. Como os GUIDs so exclusivos em todo o sistema, uma |configurao para v rios ns tem GUID exclusivo para cada n, mesmo se as |definies de partio de disco forem as mesmas. |Uma ferramenta chamada db2listvolumes.exe foi fornecida |para ajudar a exibir os GUIDs de todos os volumes de disco definidos em um |sistema Windows. A ferramenta cria dois arquivos no diretrio atual no |qual ela executada. Um arquivo, volumes.xml, contm |as informaes sobre cada volume de disco. Ele foi desenvolvido para |ser exibido facilmente em um navegador com XML ativado. O outro |arquivo, tablespace.ddl, contm a sintaxe requerida para |especificar os contineres da rea de tabela. Antes de utilizar |tablespace.ddl, voc deve atualiz -lo para incluir as demais |informaes necess rias para uma definio de rea de tabela. |A ferramenta db2listvolumes no requer nenhum argumento de linha de |comandos. ------------------------------------------------------------------------ |9.3 Exemplo para Estender o Centro de Controle |O exemplo mostrado no apndice Estendendo o Centro de Controle no est |correto e no funcionar . Utilize as informaes a seguir para |trabalhar com o exemplo Java: |O programa de exemplo PluginEx.java est localizado no subdiretrio |samples/java. PluginEx.java instalado com o DB2 |Application Development Client. Para compilar o PluginEx.java, o |seguinte deve ser includo em seu classpath: | * |Em plataformas Windows utilize: | o |DRIVE: |\sqllib\java\swingall.jar o |DRIVE: \sqllib\cc | em que DRIVE representa a unidade na qual o DB2 est |instalado. * |Em plataformas UNIX utilize: | o |/u/db2inst1/sqllib/java/swingall.jar o |/u/db2inst1/sqllib/cc/com.jar o |/u/db2inst1/sqllib/cc | em que /u/db2inst1 representa o diretrio no qual |o DB2 est instalado. | |Crie o db2plug.zip para incluir todas as classes geradas da |compilao do PluginEx.java. O arquivo no deve ser |compactado. Por exemplo, emita o seguinte: | zip -r0 db2plug.zip PluginEx*.class |Esse comando coloca todos os arquivos de classe no arquivo |db2plug.zip e preserva as informaes do caminho relativo. |Siga as instrues do arquivo PluginEx.java para compilar e executar |o exemplo. |A interface CCObject inclui mais constantes est ticas do que as que esto |listadas no apndice Estendendo o Centro de Controle do Manual de |Administrao. Abaixo esto as interfaces Java para estender o Centro |de Controle (CCExtension, CCObject, CCM enuAction, CCToolBarAction). |Essas interfaces esto listadas aqui apenas para referncia. |CCExtension: |// Licensed Materials -- Property of IBM |// |// (c) Copyright International Business Machines Corporation, 1999. |// All Rights Reserved. |// |// US Government Users Restricted Rights - |// Use, duplication or disclosure restricted by |// GSA ADP Schedule Contract with IBM Corp. |// | |package com.ibm.db2.tools.cc.navigator; | |/** | * The CCExtension interface allows users to extend the Control Center user | * interface by adding new toolbar buttons, new menu items and | * remove some predefined set of existing menu actions. | * | * To do so, create a java file which imports the | * com.ibm.db2.tools.cc.navigator package and implements this interface. | * The new file provides the implementation of the getObjects() and | * getToolbarActions() function. | * | * The getObjects() function returns an array of CCObjects which defines | * the existing | * objects which the user would like to add new menu actions or remove | * the alter or configure menu actions. | * | * The getToolbarActions() function returns an array of CCToolbarActions | * which is added to the Control Center main toolbar. | * | * A single CCExtension subclass file or multiple CCExtension subclass | * files can be used to define the Control Center extensions. In order | * for the Control Center to make use of these extensions, use the | * following setup procedures: | * (1) Create a "db2plug.zip" file which contains all the CCExtension | * subclass files. The files should not be compressed. For example, | * if the CCExtension files are in the plugin package and they are | * located in the plugin directory, issue | * zip -r0 db2plug.zip plugin\*.class | * This command will put all the plugin package class files into the | * db2plug.zip file and preserve their relative path information. | * (2) To run WEBCC as an applet, put the db2plug.zip file in where the | * tag points to in the WEBCC html file. | * To run the Control Center as an application, put | * the db2plug.zip in a directory pointed to by the CLASSPATH | * envirnoment variable and where the Control Center is run. | * | * For browsers that support multiple archives, just add "db2plug.zip" | * to the archive list of the WEBCC html page. Otherwise, all the | * CCExtension, CCObject, CCToolbarAction, CCMenuAction subclass files | * will have to be in their relative path depending on which package | * they belong to. | */ | |public interface CCExtension |{ | /** | * Get an array of CCObject subclass objects which define | * a list of objects to be overrided in the | * Control Center | * @return CCObject[] CCObject subclass objects array | */ | public CCObject[] getObjects(); | | /** | * Get an array of CCToolbarAction subclass objects which represent | * a list of buttons to be added to the Control Center | * main toolbar. | * @return CCToolbarAction[] CCToolbarAction subclass objects array | */ | public CCToolbarAction[] getToolbarActions(); |} | | |CCObject |CCObject: |// |// Licensed Materials -- Property of IBM |// |// (c) Copyright International Business Machines Corporation, 1999. |// All Rights Reserved. |// |// US Government Users Restricted Rights - |// Use, duplication or disclosure restricted by |// GSA ADP Schedule Contract with IBM Corp. |// | |package com.ibm.db2.tools.cc.navigator; | |/** | * The CCObject interface allows users to define a new object to be | * inserted into the Control Center tree or changing the behavior of the | * menu actions of an existing object. | */ |public interface CCObject |{ | /** | * The following static constants defines a list of object type | * available to be added to the Control Center tree. | */ | public static final int UDB_SYSTEMS_FOLDER = 0; | public static final int UDB_SYSTEM = 1; | public static final int UDB_INSTANCES_FOLDER = 2; | public static final int UDB_INSTANCE = 3; | public static final int UDB_DATABASES_FOLDER = 4; | public static final int UDB_DATABASE = 5; | public static final int UDB_TABLES_FOLDER = 6; | public static final int UDB_TABLE = 7; | public static final int UDB_TABLESPACES_FOLDER = 8; | public static final int UDB_TABLESPACE = 9; | public static final int UDB_VIEWS_FOLDER = 10; | public static final int UDB_VIEW = 11; | public static final int UDB_ALIASES_FOLDER = 12; | public static final int UDB_ALIAS = 13; | public static final int UDB_TRIGGERS_FOLDER = 14; | public static final int UDB_TRIGGER = 15; | public static final int UDB_SCHEMAS_FOLDER = 16; | public static final int UDB_SCHEMA = 17; | public static final int UDB_INDEXES_FOLDER = 18; | public static final int UDB_INDEX = 19; | public static final int UDB_CONNECTIONS_FOLDER = 20; | public static final int UDB_CONNECTION = 21; | public static final int UDB_REPLICATION_SOURCES_FOLDER = 22; | public static final int UDB_REPLICATION_SOURCE = 23; | public static final int UDB_REPLICATION_SUBSCRIPTIONS_FOLDER = 24; | public static final int UDB_REPLICATION_SUBSCRIPTION = 25; | public static final int UDB_BUFFERPOOLS_FOLDER = 26; | public static final int UDB_BUFFERPOOL = 27; | public static final int UDB_APPLICATION_OBJECTS_FOLDER = 28; | public static final int UDB_USER_DEFINED_DISTINCT_DATATYPES_FOLDER = 29; | public static final int UDB_USER_DEFINED_DISTINCT_DATATYPE = 30; | public static final int UDB_USER_DEFINED_DISTINCT_FUNCTIONS_FOLDER = 31; | public static final int UDB_USER_DEFINED_DISTINCT_FUNCTION = 32; | public static final int UDB_PACKAGES_FOLDER = 33; | public static final int UDB_PACKAGE = 34; | public static final int UDB_STORE_PROCEDURES_FOLDER = 35; | public static final int UDB_STORE_PROCEDURE = 36; | public static final int UDB_USER_AND_GROUP_OBJECTS_FOLDER = 37; | public static final int UDB_DB_USERS_FOLDER = 38; | public static final int UDB_DB_USER = 39; | public static final int UDB_DB_GROUPS_FOLDER = 40; | public static final int UDB_DB_GROUP = 41; | public static final int UDB_DRDA_TABLES_FOLDER = 42; | public static final int UDB_DRDA_TABLE = 43; | public static final int UDB_NODEGROUPS_FOLDER = 44; | public static final int UDB_NODEGROUP = 45; | | public static final int S390_SUBSYSTEMS_FOLDER = 46; | public static final int S390_SUBSYSTEM = 47; | public static final int S390_BUFFERPOOLS_FOLDER = 48; | public static final int S390_BUFFERPOOL = 49; | public static final int S390_VIEWS_FOLDER = 50; | public static final int S390_VIEW = 51; | public static final int S390_DATABASES_FOLDER = 52; | public static final int S390_DATABASE = 53; | public static final int S390_TABLESPACES_FOLDER = 54; | public static final int S390_TABLESPACE = 55; | public static final int S390_TABLES_FOLDER = 56; | public static final int S390_TABLE = 57; | public static final int S390_INDEXS_FOLDER = 58; | public static final int S390_INDEX = 59; | public static final int S390_STORAGE_GROUPS_FOLDER = 60; | public static final int S390_STORAGE_GROUP = 61; | public static final int S390_ALIASES_FOLDER = 62; | public static final int S390_ALIAS = 63; | public static final int S390_SYNONYMS_FOLDER = 64; | public static final int S390_SYNONYM = 65; | public static final int S390_APPLICATION_OBJECTS_FOLDER = 66; | public static final int S390_COLLECTIONS_FOLDER = 67; | public static final int S390_COLLECTION = 68; | public static final int S390_PACKAGES_FOLDER = 69; | public static final int S390_PACKAGE = 70; | public static final int S390_PLANS_FOLDER = 71; | public static final int S390_PLAN = 72; | public static final int S390_PROCEDURES_FOLDER = 73; | public static final int S390_PROCEDURE = 74; | public static final int S390_DB_USERS_FOLDER = 75; | public static final int S390_DB_USER = 76; | public static final int S390_LOCATIONS_FOLDER = 77; | public static final int S390_LOCATION = 78; | public static final int S390_DISTINCT_TYPES_FOLDER = 79; | public static final int S390_DISTINCT_TYPE = 80; | public static final int S390_USER_DEFINED_FUNCTIONS_FOLDER = 81; | public static final int S390_USER_DEFINED_FUNCTION = 82; | public static final int S390_TRIGGERS_FOLDER = 83; | public static final int S390_TRIGGER = 84; | public static final int S390_SCHEMAS_FOLDER = 85; | public static final int S390_SCHEMA = 86; | public static final int S390_CATALOG_TABLES_FOLDER = 87; | public static final int S390_CATALOG_TABLE = 88; | public static final int DCS_GATEWAY_CONNECTIONS_FOLDER = 89; | public static final int DCS_GATEWAY_CONNECTION = 90; | public static final int S390_UTILITY_OBJECTS_FOLDER = 91; | public static final int S390_DATASET_TEMPLATES_FOLDER = 92; | public static final int S390_DATASET_TEMPLATE = 93; | public static final int S390_UTILITY_LISTS_FOLDER = 94; | public static final int S390_UTILITY_LIST = 95; | public static final int S390_UTILITY_PROCEDURES_FOLDER = 96; | public static final int S390_UTILITY_PROCEDURE = 97; | /** | * Total number of object types | */ | public static final int NUM_OBJECT_TYPES = 98; | | /** | * Get the name of these object | * | * The function returns the name of this object. This name | * can be of three types: | * (1) Fully qualified name | * Syntax: xxxxx-yyyyy-zzzzz | * where xxxxx-yyyyy is the fully quality name of the parent | * object and zzzzz is the name of the new object. | * Note: Parent and child object name is separated by '-' character. | * If a schema name is required to identify object, the fully | * qualified name is represented by xxxxx-yyyyy-wwwww.zzzzz | * where wwwww is the schema name. | * Only the behavior of the object that match this fully | * quality name will be affected. | * (2) Parent fully qualified name | * Syntax: xxxxx-yyyyy | * where xxxxx-yyyyy is the fully qualified name of the | * parent object. | * When the object type is folder (ie. DATABASES_FOLDER), the | * getName() should only return the fully qualified name of the | * folder's parent. | * Only the behavior of the object that match this name | * and the specific type return by the getType() function will be | * affected. | * (3) null | * Syntax: null | * If null is return, the CCMenuActions returns by the | * getMenuActions() call will be applied to all objects of type | * returns by the getType() call. | * @return String object name | */ | public String getName(); | | /** | * Get the type of this object | * @return int return one of the static type constants defined in this | * interface | */ | public int getType(); | | /** | * Get the CCMenu Action array which defines the list of menu actions | * to be created for object | * return CCMenuAction[] CCMenuAction array | */ | public CCMenuAction[] getMenuActions(); | | /** | * Check if this object is editable. If not, the Alter related menu | * items will be removed from the object's popup menu | * return boolean If false, the Alter menu item will be remove from the | * object's popup menu. | * Return true if you do not wish to modify current Alter menu item | * behaviour. | */ | public boolean isEditable(); | | /** | * Check if this object is configurable. If not, the configuration | * related menu items will be removed from the object's popup menu | * return boolean If false, the Configuration related menu item will be | * removed from the object's popup menu. | * Return true if you do not wish to modify current Configuration | * behaviour. | */ | public boolean isConfigurable(); |} | | | |CCMenuAction: |// |// Licensed Materials -- Property of IBM |// |// (c) Copyright International Business Machines Corporation, 1999. |// All Rights Reserved. |// |// US Government Users Restricted Rights - |// Use, duplication or disclosure restricted by |// GSA ADP Schedule Contract with IBM Corp. |// | |package com.ibm.db2.tools.cc.navigator; |import java.awt.event.*; |import javax.swing.*; | |/** | * The CCMenuAction class allows users to define a new menu item to be added | * to a Control Center object. The new menu item will be added at the end of | * an object's popup menu. | * | * Note: If the object has a Control Center Refresh and/or | * Filter menu item, the new menu item will be inserted before the Refresh | * and Filter menu. The Control Center Refresh and Filter menu items are | * always at the end of the popup menu. | */ |public interface CCMenuAction |{ | /** | * Get the name of this action | * @return String Name text on the menu item | */ | public String getMenuText(); | | /** | * Invoked when an action occurs. | * @param e Action event | */ | public void actionPerformed(ActionEvent e); |} | | | |CCToolBarAction |// Licensed Materials -- Property of IBM |// |// (c) Copyright International Business Machines Corporation, 1999. |// All Rights Reserved. |// |// US Government Users Restricted Rights - |// Use, duplication or disclosure restricted by |// GSA ADP Schedule Contract with IBM Corp. |// | |package com.ibm.db2.tools.cc.navigator; |import java.awt.event.*; |import javax.swing.*; | |/** | * The CCToolbarAction interface class allows users to define a new action | * to be added to the Control Center toolbar. | */ |public interface CCToolbarAction |{ | /** | * Get the name of this action | * @return String Name text on the menu item, or toolbar button hover help | */ | public String getHoverHelpText(); | | /** | * Get the icon for the toolbar button | * Any toolbar CCAction should override this function and return | * a valid ImageIcon object. Otherwise, the button will have no icon. | * @return ImageIcon Icon to be displayed | */ | public ImageIcon getIcon(); | | /** | * Invoked when an action occurs. | * @param e Action event | */ | public void actionPerformed(ActionEvent e); |} | ------------------------------------------------------------------------ |Manual de Administrao: Desempenho ------------------------------------------------------------------------ |10.1 Esquemas de Tabelas Tempor rias do Sistema |O esquema para uma tabela tempor ria do sistema determinado pelo ID do |aplicativo e ID de autorizao que o criou. Quando esses dados ficam |disponveis, o esquema no qual a tabela criada |. Sob algumas circunstncias, as tabelas |so criadas utilizando somente um desses IDs para determinar o esquema e, s |vezes, nenhum. Isso pode resultar em tabelas tais como |AUTHID.TEMPTABLENAME ou .TEMPTABLENAME. Voc pode exibir |as informaes de esquema dessas tabelas utilizando o comando GET |SNAPSHOT. Para obter informaes sobre esse comando, consulte a seo |Referncia de Comandos ------------------------------------------------------------------------ |10.2 Captulo 8. Desempenho Operacional |10.2.1 Conjunto de Buffers com Base em Bloco | | | | | |Esse recurso suportado somente no Ambiente Operacional Sun |Solaris. |Devido sobrecarga de E/S, a pr-busca de p ginas no disco uma |operao cara. A pr-busca do DB2 melhora significativamente o |rendimento quando o processamento pode ser sobreposto com E/S. A |maioria das plataformas fornece primitivas de alto desempenho para ler p ginas |contguas do disco em partes no-contguas de memria. Essas primitivas |so chamadas geralmente de "leitura dispersa" ou "E/S em |vetor". Em algumas plataformas, o desempenho dessas primitivas no |pode competir com a execuo de E/S em blocos grandes. Por |padro, os conjuntos de buffers baseiam-se em p ginas. Isto , p ginas |contguas no disco so pr-buscadas em p ginas no-contguas na |memria. Posteriormente, o desempenho da pr-busca poder ser |aperfeioado nessas plataformas se as p ginas puderem ser lidas do disco em |p ginas contguas em um conjunto de buffers. Uma vari vel de registro, |DB2_BLOCK_BASED_BP, permite a criao de uma seo no conjunto de buffers que |contenha conjuntos de p ginas contguas. Esses conjuntos de p ginas |contguas so chamados de "blocos". Definindo essa vari vel de |registro, uma pr-busca seqencial ler as p ginas do disco diretamente nesses |blocos, em vez de ler cada uma individualmente. Isso melhorar o |desempenho de E/S. Para obter mais informaes sobre essa |vari vel de registro, consulte a seo 'Vari veis de Registro e de |Ambiente' do Manual de Administrao. | |V rias reas de tabela com tamanhos de extenso diferentes podem ser |ligados a um conjunto de buffers com o mesmo tamanho de bloco. H uma |relao muito prxima entre tamanhos de extenso e tamanhos de bloco apesar de |lidarem com conceitos distintos. Uma extenso a granularidade na qual |as reas de tabela so demarcados em v rios contineres. Um bloco a |nica granularidade em que servidores de E/S executando pedidos de |pr-busca em seqncia consideraro a realizao de E/S baseada em |bloco. |Os pedidos de pr-busca em seqncia individuais utilizam p ginas do |tamanho da extenso. Quando esse pedido de pr-busca recebido, o |servidor de E/S determina o custo e benefcio de se fazer cada pedido |como uma E/S baseada em bloco (se houver uma rea baseada em bloco no |conjunto de buffers) em vez da E/S baseada em p gina utilizando o mtodo |de leitura dispersa. O benefcio de se fazer qualquer E/S como |E/S baseada em bloco o benefcio de desempenho da leitura do disco |contguo na memria contgua. O custo a quantidade de memria |desperdiada no conjunto de buffers que pode resultar da utilizao desse |mtodo. |A memria do conjunto de buffers pode ser desperdiada por dois motivos ao |executar E/S baseada em bloco: | * |O nmero de p ginas no pedido de pr-busca contm menos p ginas do que o |nmero de p ginas de um bloco. Isto , o tamanho da extenso menor |que o tamanho do bloco. * |Algumas das p ginas solicitadas como parte do pedido de pr-busca j esto |na rea de p ginas do conjunto de buffers. | |Nota: Cada bloco na rea baseada em bloco de um conjunto de buffers no pode ser |subdividido. As p ginas no bloco devem ser todas contguas. Como |resultado, h uma possibilidade de desperdcio de espao. | |O servidor de E/S permite algumas p ginas desperdiadas em cada bloco |para obter o benefcio de execuo de E/S baseada em bloco. |Entretanto, quando houver muito desperdcio de um bloco, o servidor de |E/S reverter para a utilizao de pr-busca baseada em p gina na rea |de p ginas do conjunto de buffers. Como resultado, alguma E/S |feita durante a pr-busca no ser baseada em bloco. Essa condio no | a ideal. |Para obter um timo desempenho, necess rio ter v rias reas de tabela com |o mesmo tamanho de extenso ligados a um conjunto de buffers com o mesmo |tamanho de bloco. Ainda ser possvel obter um bom desempenho se o |tamanho de extenso de algumas reas de tabela for maior do que o tamanho do |bloco do conjunto de buffers ao qual estiverem ligados. No |aconselh vel efetuar vinculao de reas de tabela a um conjunto de buffers |quando o tamanho da extenso menor do que o tamanho do bloco. |Nota: A rea de blocos de um conjunto de buffers utilizada somente para pr-busca |em seqncia. Se houver pouca ou nenhuma pr-busca em seqncia |envolvida no sistema, a rea de blocos ser uma parte desperdiada do conjunto |de buffers. |Ambos os suportes, ao AWE e com base em bloco, no podem ser configurados |para um conjunto de buffers ao mesmo tempo. Se as vari veis de registro |DB2_AWE e DB2_BLOCK_BASED_BP referirem-se ao mesmo conjunto de buffers, o AWE |obter precedncia. O suporte com base em bloco ser desativado nesse |caso e ser reativado somente quando o AWE estiver desativado. |Um conjunto de buffers que estiver utilizando armazenamento estendido no |suporta E/S baseada em bloco. | |10.2.1.1 Exemplos de Conjuntos de Buffers Com Base em Blocos | | |Antes de trabalhar com qualquer um dos exemplos, ser necess rio que voc |conhea os identificadores dos conjuntos de buffers em seu sistema. O |ID do conjunto de buffers pode ser visto na coluna BUFFERPOOLID ou na exibio |do cat logo de sistema SYSCAT.BUFFERPOOLS. |Cen rio 1 |Voc tem um conjunto de buffers com um ID 4 que tem 1000 p ginas. |Voc deseja criar uma rea de blocos composta de 700 p ginas nas quais cada |bloco contm 32 p ginas. necess rio executar o seguinte: | db2set DB2_BLOCK_BASED_BP=4,700,32 |Quando o banco de dados for iniciado, o conjunto de buffers com ID 4 ser |criado com uma rea de blocos de 672 p ginas e uma rea de p ginas de 328 |p ginas. Neste exemplo, 32 no pode ser dividido igualmente em |700. Isso significa que o tamanho da rea de blocos especificado teve |que ser reduzido para o limite de tamanho de bloco mais prximo utilizando a |seguinte frmula: | ((tamanho da rea de blocos)) | FLOOR(-----------------) X tamanho do bloco | ( (tamanho do bloco) ) | ( 700 ) | = FLOOR(-----------------) X 32 | ( 32 ) | = 21 x 32 | = 672 |Cen rio 2 |Voc tem um conjunto de buffers com um ID 11 que tem 3000 p ginas. |Voc deseja criar uma rea de blocos composta de 2700 p ginas. |necess rio executar o seguinte: | db2set DB2_BLOCK_BASED_BP=11,2700 |Quando o banco de dados for iniciado, o conjunto de buffers com ID 11 ser |criado com uma rea de blocos de 2688 p ginas e uma rea de p ginas de 312 |p ginas. Sem um valor fornecido explicitamente para o tamanho do bloco, |ser utilizado o valor padro de 32. Neste exemplo, 32 no pode ser |dividido igualmente em 2700. Isso significa que o tamanho da rea de |blocos especificado teve que ser reduzido para o limite de tamanho de bloco |mais prximo utilizando a seguinte frmula: | ((tamanho da rea de blocos)) | FLOOR(-----------------) X tamanho do bloco | ( (tamanho do bloco) ) | ( 2700 ) | = FLOOR(-----------------) X 32 | ( 32 ) | = 84 x 32 | = 2688 ------------------------------------------------------------------------ |10.3 Captulo 10. Ajustando a Escala de Configurao Atravs da Incluso de Processadores |10.3.1 Problemas Ao Incluir Ns em um Banco de Dados Particionado | | |Ao incluir ns em um banco de dados particionado que possui um ou mais | reas de tabela de tipo tempor rio no sistema com um tamanho de p gina que |diferente do tamanho de p gina padro (4 KB), voc pode receber a mensagem de |erro: "SQL6073N Falhou a operao Incluir N" e um SQLCODE. |Isto ocorre porque apenas o pool de buffer IBMDEFAULTBP existe com um tamanho |de p gina de 4 KB quando o n criado. |Por exemplo, voc pode usar o comando db2start para incluir um |n em um banco de dados particionado atual: | DB2START NODENUM 2 ADDNODE HOSTNAME newhost PORT 2 |Se o banco de dados particionado possui reas de tabela tempor rias do |sistema com o tamanho de p gina padro, a seguinte mensagem retornada: | SQL6075W A operao Iniciar Gerenciador de Banco de Dados incluiu o n | com sucesso. O n no est ativo at que todos os ns sejam | interrompidos e inicializados novamente. |De qualquer modo, se o banco de dados particionado possuir reas de tabela |tempor rias do sistema que no tenham o tamanho de p gina padro, a seguinte |mensagem ser retornada: | SQL6073N Falhou a incluso do N. SQLCODE = "<-902>" |Em um exemplo similar, voc pode usar o comando ADD NODE aps atualizar |manualmente o arquivo db2nodes.cfg com a nova descrio do |n. Aps a edio do arquivo e da execuo do comando ADD NODE com um |banco de dados particionado que possui tables spaces tempor rios do sistema |com tamanho de p gina padro, a seguinte mensagem retornada: | DB20000I O comando ADD NODE foi concludo com sucesso. |De qualquer modo, se o banco de dados particionado possuir reas de tabela |tempor rias do sistema que no tenham o tamanho de p gina padro, a seguinte |mensagem ser retornada: | SQL6073N Falhou a incluso do N. SQLCODE = "<-902>" |Uma maneira de impedir os problemas delineados acima executar: | DB2SET DB2_HIDDENBP=16 |antes de emitir o comando db2start ou ADD NODE. Esta |vari vel de registro ativa o DB2 para alocar pools de buffer ocultos de 16 |p ginas cada utilizando um tamanho de p gina diferente do padro. Isto |ativa a operao ADD NODE para o sucesso completo. |Outra maneira de impedir estes problemas especificar a cl usula WITHOUT |TABLESPACES no comando ADD NODE ou db2start. Feito isto, |voc ter de criar os pools de buffer utilizando a instruo CREATE |BUFFERPOOL, e associar os tables spaces tempor rios do sistema para os pools |de buffer usarem a instruo ALTER TABLESPACE. |Ao incluir ns em um grupo de n existente que possui uma ou mais reas de |tabela com um tamanho de p gina que diferente do tamanho de p gina padro (4 |KB), voc pode encontrar a mensagem de erro: "SQL0647N Bufferpool "" |no est ativo atualmente.". Isto ocorre porque o tamanho da |p gina do pool de buffer no padro criada no novo n no foi ativada para as | reas de tabela. |Por exemplo, voc pode usar a instruo ALTER NODEGROUP para incluir um n |em um grupo de ns: | DB2START | CONNECT TO mpp1 | ALTER NODEGROUP ng1 ADD NODE (2) |Se o grupo de ns possui reas de tabela com tamanho de p gina padro, a |seguinte mensagem retornada: | SQL1759W A redistribuio do grupo de ns requerida para alterar o | posicionamento de dados para objetos no grupo de ns "" para | incluir alguns ns acrescentados ou excluir alguns ns eliminados. |De qualquer modo, se o grupo de n possui reas de tabela que no tenham o |tamanho de p gina padro, a mensagem retornada : | SQL0647N Bufferpool "" no est ativo atualmente. |Uma maneira de impedir este problema e criar pools de buffer para cada |tamanho de p gina e depois se conectar novamente ao banco de dados antes de |emitir a instruo ALTER NODEGROUP. | DB2START | CONNECT TO mpp1 | CREATE BUFFERPOOL bp1 SIZE 1000 PAGESIZE 8192 | CONNECT RESET | CONNECT TO mpp1 | ALTER NODEGROUP ng1 ADD NODE (2) |Uma segunda maneira para impedir o problema executar: | DB2SET DB2_HIDDENBP=16 |antes de emitir o comando db2start, e as instrues CONNECT e |ALTER NODEGROUP. |Outro problema pode ocorrer quando a instruo ALTER TABLESPACE utilizada |para incluir uma rea de tabela em um n. Por exemplo: | DB2START | CONNECT TO mpp1 | ALTER NODEGROUP ng1 ADD NODE (2) WITHOUT TABLESPACES | ALTER TABLESPACE ts1 ADD ('ts1') ON NODE (2) |Esta srie de comandos e instrues gera a mensagem de erro SQL0647N (e no |a mensagem esperada SQL1759W). |Para concluir esta alterao corretamente, voc deve se reconectar ao banco |de dados aps a instruo ALTER NODEGROUP... WITHOUT |TABLESPACES. | DB2START | CONNECT TO mpp1 | ALTER NODEGROUP ng1 ADD NODE (2) WITHOUT TABLESPACES | CONNECT RESET | CONNECT TO mpp1 | ALTER TABLESPACE ts1 ADD ('ts1') ON NODE (2) |Outra maneira para impedir o problema executar: | DB2SET DB2_HIDDENBP=16 |antes de emitir o comando db2start e as instrues CONNECT, |ALTER NODEGROUP e ALTER TABLESPACE. ------------------------------------------------------------------------ |10.4 Captulo 13. Configurando o DB2 |10.4.1 Concluso do Archive de Log Agora Verificada Mais Freqentemente |Para melhorar o tempo de recuperao evitando pedidos de archive de log |desnecess rios, o servidor do banco de dados agora verifica a concluso do |archive de log quando um novo arquivo de log criado e quando o primeiro log |ativo alterado. ------------------------------------------------------------------------ |10.5 Vari veis de Ambiente e Registro do DB2 |10.5.1 Correes de Vari veis de Desempenho | |Tabela 5. Vari veis de Desempenho Nome da Vari vel Sistema Valores Operacional Descrio DB2_BINSORT Todos Default=NO Valores: YES ou NO Permite um novo algoritmo de ordenao que reduz o tempo da CPU e o tempo decorrido de ordenaes. Esse novo algoritmo estende a tcnica de ordenao de nmeros inteiros extremamente eficiente do DB2 UDB para todas ordenaes de tipos de dados, como BIGINT, CHAR, VARCHAR, FLOAT e DECIMAL, assim como combinaes destes tipos de dados. Para ativar esse novo algoritmo, utilize o seguinte comando: db2set DB2_BINSORT = yes DB2_BLOCK_BASED_BP Solaris Default=None Valores: dependente de parmetros Especifica os valores necess rios para criar uma rea de blocos em um conjunto de buffers. O ID do conjunto de buffers necess rio e pode ser visto na coluna BUFFERPOOLID da exibio de cat logo do sistema SYSCAT.BUFFERPOOLS. O nmero de p ginas a serem alocadas no conjunto de buffers para a E/S baseada em bloco deve ser fornecido. O nmero de p ginas a serem includas em um bloco opcional, com um valor padro de 32. O formato para a utilizao dessa vari vel de registro : DB2_BLOCK_BASED_BP=BUFFER POOL ID,BLOCK AREA SIZE,[BLOCK SIZE];... V rios conjuntos de buffers podem ser definidos para "com base em bloco" utilizando-se a mesma vari vel com ponto-e-vrgula separando as entradas. O valor para BLOCK SIZE pode variar de 2 a 256. Se o BLOCK SIZE no for fornecido, o padro utilizado 32. Se o BLOCK AREA SIZE especificado for maior que 98% do tamanho total do conjunto de buffers, o conjunto de buffers no se basear em bloco. interessante que sempre se tenha alguma parte do conjunto de buffers na rea baseada em p gina do conjunto de buffers porque h a possibilidade de que p ginas individuais sejam requeridas mesmo se a maior parte da E/S no sistema for de pr-busca em seqncia. Se o valor especificado para BLOCK AREA SIZE no for um mltiplo de BLOCK SIZE, ele ser reduzido para o limite mais prximo do tamanho do bloco. Para obter mais informaes sobre E/S baseada em bloco, consulte a seo 10.2.1, Conjunto de Buffers com Base em Bloco. DB2_NO_FORK_CHECK UNIX Default=OFF Valores: ON ou OFF Quando essa vari vel est "ON", o processo cliente no se proteger contra um aplicativo que faa cpia do processo a ser executado (chamado bifurcao). Quando a bifurcao ocorre, os resultados so imprevisveis. Os resultados podem variar de nenhum efeito a alguns maus resultados, a algum cdigo de erro sendo retornado, a um trap no aplicativo. Se voc est certo de que seu aplicativo no bifurca e quer desempenho melhor, voc deve mudar o valor dessa vari vel para "ON". DB2_MINIMIZE_LIST_PREFETCH Todos Default=NO Valores: YES ou NO Pr-captura da lista um mtodo especial de acesso tabela que envolve recuperar os RIDS qualificados do ndice, ordenando-os por nmero de p gina e, em seguida, fazendo uma pr-captura das p ginas de dados. s vezes o otimizador no tem informaes precisas para determinar se a pr-captura da lista um bom mtodo de acesso. Isso pode ocorrer quando seletividades de predicados contm marcadores de parmetros ou de vari veis de host que impedem o otimizador de utilizar estatsticas de cat logo para determinar a seletividade. Essa vari vel de registro impedir que o otimizador considere pr-captura de lista nessas situaes. DB2_INLIST_TO_NLJN Todos Default=NO Valores: YES ou NO Em algumas situaes, o compilador de SQL pode reescrever um predicado de lista IN para uma juno. Por exemplo, a seguinte consulta: SELECT * FROM EMPLOYEE WHERE DEPTNO IN ('D11', 'D21', 'E21') pode ser escrita como: SELECT * FROM EMPLOYEE, (VALUES 'D11', 'D21', 'E21) AS V(DNO) WHERE DEPTNO = V.DNO Essa verso pode fornecer melhor desempenho se houver um ndice em DEPTNO. A lista de valores seria acessada primeiro e juntada a EMPLOYEE com um loop aninhado, utilizando o ndice para aplicar o predicado de juno. s vezes o otimizador no tem informaes precisas para determinar o melhor mtodo de juno para a verso reescrita da consulta. Isso pode ocorrer se a lista IN contiver marcadores de parmetros ou vari veis do host, que impeam o otimizador de utilizar estatsticas para determinar a seletividade. Essa vari vel de registro far com que o otimizador favorea junes de loop aninhado para juntar a lista de valores, utilizando a tabela que contribui com a lista IN como a tabela interna da juno. | | | |10.5.2 Correes e Incluses nas Vari veis de Registro Diversas |A vari vel de registro DB2_NEWLOGPATH2 est disponvel para |todos os sistemas operacionais. Uma nova vari vel, |DB2_ROLLFORWARD_NORETRIEVE, foi introduzida. As informaes corretas |para as duas vari veis aparece abaixo. | |Tabela 6. Vari veis Diversas Nome da Vari vel Sistema Valores Operacional Descrio DB2_NEWLOGPATH2 ALL Default=NO Valores: YES ou NO Esse parmetro permite que voc especifique se um caminho secund rio deve ser utilizado para implementar o registro duplo. O caminho utilizado gerado anexando-se um "2" ao valor atual do parmetro de configurao de banco de dados logpath. DB2_ROLLFORWARD_NORETRIEVE ALL Default=(not set) Valores: YES ou NO Se o parmetro de configurao de banco de dados USEREXIT for ativado, arquivos de registro so automaticamente recuperados do archive durante as operaes de avano. A vari vel DB2_ROLLFORWARD_NORETRIEVE permite que voc especifique se as operaes de avano no devem recuperar arquivos de registro do archive. Essa vari vel desativada por padro. Defina essa vari vel como YES se voc no deseja que o avano recupere arquivos de registro automaticamente. Por exemplo, defina a vari vel como YES em uma configurao hot-standby quando desejar evitar que arquivos de registro criados por um aplicativo ruim corrompam o sistema de backup. | | |10.5.3 Correes e Adies s Vari veis de Registro Gerais |Uma nova vari vel, DB2_REDUCED_OPTIMIZATION, foi introduzida. | |Tabela 7. Vari vel de Registro Geral Nome da Vari vel Sistema Valores Operacional Descrio DB2_REDUCED_OPTIMIZATION ALL Default=NO Valores: YES, NO ou qualquer nmero inteiro Essa vari vel de registro permite que voc desative algumas das tcnicas de otimizao utilizadas em nveis de otimizao especficos. Se voc reduzir o nmero de tcnicas de otimizao utilizadas, reduzem-se tempo e recursos utilizados durante a otimizao. Nota: Embora o uso de recursos e tempo de otimizao possa ser reduzido, o risco de produzir um plano de acesso de dados abaixo do ideal aumenta. * Se definido como NO O otimizador no altera suas tcnicas de otimizao. * Se definido como YES Se o nvel de otimizao for 5 (o padro) ou inferior, o otimizador desativa algumas tcnicas de otimizao que podem consumir tempo de preparo e recursos significantes, mas que geralmente no produzem um melhor plano de acesso. Se o nvel de otimizao for exatamente 5, o otimizador recua ou desativa algumas tcnicas adicionais, o que pode mais adiante reduzir a utilizao de recursos e tempo de otimizao, mas tambm aumentar o risco de um plano de acesso abaixo do ideal. Para nveis de otimizao inferiores a 5, algumas dessas tcnicas podem no estar em efeito de qualquer modo. Se estiverem, porm, elas permanecem em efeito. * Se definido como qualquer nmero inteiro O efeito o mesmo de quando o valor definido como YES, com o seguinte comportamento adicional para consultas dinamicamente otimizadas no nvel 5: se o nmero total de junes em qualquer bloco de consultas exceder o definido, ento, o otimizador vai para enumerao "greedy join" em vez de desativar tcnicas de otimizao adicionais como descrito acima para o nvel de otimizao 5, o que implica que a consulta ser otimizada em um nvel similar ao nvel de otimizao 2. Para obter mais informaes sobre enumeraes "greedy" e "dynamic join", veja "SearchStrategies for Selecting Optimal Join" em Manual de Administrao: Performance. Observe que a reduo de otimizao dinmica no nvel de otimizao 5, como descrito em "Adjusting the Optimization Class", em Administration Guide: Performance, tem precedncia sobre o comportamento descrito para o nvel de otimizao de exatamente 5 quando DB2_REDUCED_OPTIMIZATION definido como YES, bem como sobre o comportamento descrito para a definio como inteiro. ------------------------------------------------------------------------ |Manual e Referncia de Administrao de Satlites ------------------------------------------------------------------------ |11.1 Configurando o DB2 Personal Edition Verso 7.2 e o DB2 Workgroup Edition como Satlites | | | | | | |As sees que seguem descrevem como configurar os sistemas DB2 Personal |Edition Verso 7.2 e DB2 Workgroup Edition baseados no Windows, para |que eles possam ser utilizados como satlites completamente funcionais em um |ambiente de satlite. Para obter mais informaes sobre os termos e os |conceitos utilizados nas informaes que seguem, consulte a publicao Manual e Referncia de Administrao de Satlites -. Voc pode |encontrar esse manual na seguinte URL: |http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/v6pubs.d2w/en_main |Para obter as Technotes que suplementam as informaes do Manual e Referncia de Administrao de Satlites -, consulte a |seguinte URL: |http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/ |11.1.1 Pr-requisitos | | | | |Para configurar o DB2 Personal Edition ou o DB2 Workgroup Edition como |satlites, voc requer o seguinte: | 1. |Um DB2 control server |O DB2 control server um sistema DB2 Enterprise Edition que executado no |Windows NT ou AIX e possui o componente Control Server instalado. O |sistema DB2 Enterprise Edition que voc pode utilizar deve estar na Verso 6 |com FixPak 2 ou superior, ou Verso 7 em qualquer nvel de FixPak. | o |Se voc tiver um sistema Enterprise Edition Verso 6 que deseja utilizar |como o DB2 control server, consulte a seo 11.1.3, Instalando o FixPak 2 ou Superior em um Sistema Enterprise Edition Verso 6. o |Se voc estiver utilizando a Verso 7 e no tiver o componente Control |Server instalado, instale esse componente, reinstale todos os FixPaks que voc |j tiver instalado, em seguida, crie a instncia do DB2 control server e o |banco de dados de controle do satlite. Consulte a publicao Manual e Referncia de Administrao de Satlites - para obter |instrues sobre a criao desses objetos. | | | |Nota: Se voc estiver instalando um sistema Enterprise Edition Verso 7.2 no |Windows NT para uso como o DB2 control server e se desejar executar uma |instalao do arquivo de resposta, consulte o Technote intitulado |Palavras-chave do Arquivo de Resposta do DB2 control server para |obter informaes sobre as palavras-chave, para especificar no arquivo de |resposta. | 2. |A instncia do DB2 control server e o banco de dados de controle do |satlite |A instncia do DB2 control server tipicamente chamada DB2CTLSV e o banco |de dados de controle do satlite chamado SATCTLDB. A instncia do DB2 |control server e o banco de dados de controle do satlite esto no sistema |Enterprise Edition e, no Windows NT, so criados automaticamente quando voc |instala o DB2 com o componente Control Server. Se voc instalar o DB2 |no AIX, consulte a publicao Manual e Referncia de Administrao de Satlites - para obter |informaes sobre a criao da instncia do DB2 control server e o banco de |dados de controle do satlite. 3. |O Centro de Administrao do Satlite |O Centro de Administrao do Satlite o conjunto de ferramentas da GUI |que voc pode utilizar para configurar e administrar o ambiente do |satlite. Voc acessa esse conjunto de ferramentas do Centro de |Controle. Para obter mais informaes sobre o Centro de Administrao |do Satlite e o ambiente de satlite, consulte a publicao Manual e Referncia de Administrao de Satlites - e o auxlio online |que est disponvel do Centro de Administrao do Satlite. Se voc |estiver executando um Centro de Controle Verso 6, consulte a seo 11.1.4, Atualizando uma Verso 6 do Centro de Controle e do Centro de Administrao do Satlite. |Se voc ainda no tiver utilizado o Centro de Administrao do Satlite |para configurar o ambiente de satlite e para criar o objeto que representa o |novo satlite no Centro de Administrao do Satlite, dever fazer isso antes |de instalar o satlite. Para obter mais informaes,consulte a |descrio de como configurar e testar um ambiente de satlite na publicao |Manual e Referncia de Administrao de Satlites -. 4. |Um sistema Personal Edition ou Workgroup Edition Verso 7.2 que |voc deseja utilizar como um satlite. | |11.1.1.1 Consideraes de Instalao | | |Quando voc instala o DB2 Personal Edition ou o DB2 Workgroup Edition, no | preciso selecionar nenhum componente especial para ativar o sistema a ser |sincronizado. Se voc pretender executar uma instalao do arquivo de |resposta, consulte a seoExecutando uma Instalao do Arquivo de Resposta para obter as palavras-chave que precisa especificar quando |instalar o sistema Verso 7.2. Se estiver executando uma |instalao interativa de seu sistema Verso 7.2, consulte a seo 11.1.2, Configurando o Sistema Verso 7.2 para Sincronizao aps terminar de instalar o DB2 para os valores que voc |deve definir no sistema Verso 7.2 para ativ -lo para |sincronizao. |Executando uma Instalao do Arquivo de Resposta | | | |Se voc estiver executando uma instalao do arquivo de resposta do DB2 |Personal Edition ou DB2 Workgroup Edition Verso 7.2, poder definir as |palavras-chave a seguir no arquivo de resposta. |Se voc decidir no especificar uma ou mais palavras-chave durante a |instalao do arquivo de resposta, consulte a seo 11.1.2, Configurando o Sistema Verso 7.2 para Sincronizao para obter as etapas adicionais que voc deve executar aps |a instalao do DB2, para ativar o sistema Verso 7.2 para |sincronizao. Voc tambm poder utilizar as instrues nesta seo, |se desejar alterar quaisquer valores que foram especificados durante a |instalao do arquivo de resposta. | |db2.db2satelliteid |Define o ID do satlite no sistema. |Nota: Se voc no especificar essa palavra-chave, o ID do satlite ser |automaticamente definido para o ID do usu rio que foi utilizado para instalar |o DB2. Se voc desejar utilizar esse ID do usu rio como o ID do |satlite, no precisar especificar um valor para essa palavra-chave. | |db2.db2satelliteappver |Define a verso do aplicativo no sistema. |Nota: Se voc no especificar essa palavra-chave, a verso do aplicativo no |satlite ser automaticamente definida como V1R0M00. Se desejar |utilizar esse valor como a verso do aplicativo, no precisar especificar um |valor para essa palavra-chave. | |db2.satctldb_username |Define o nome do usu rio para o sistema, para conectar-se ao banco de |dados de controle do satlite. |db2.satctldb_password |Define a senha que o nome do usu rio transite para o DB2 control server, |quando o nome do usu rio conecta-se ao banco de dados de controle do |satlite. | |Aps concluir a instalao do arquivo de resposta, o sistema Verso |7.2 est pronto para ser sincronizado. Voc deve emitir o |comando db2sync -t no satlite, para verificar se os valores |especificados no satlite esto corretos e se o satlite pode conectar-se ao |banco de dados de controle do satlite. |Para obter informaes adicionais sobre a execuo de uma instalao do |arquivo de resposta, consulte a publicao Manual e Referncia de Administrao de Satlites -. |Notas: 1. |Na Verso 7, os IDs de usu rios e as senha so requeridos para a criao |de todos os servios no Windows NT e no Windows 2000. Esses IDs de |usu rios e senhas so especificados no arquivo de resposta por pares de |palavras-chave. O primeiro par de palavras-chave encontrado no arquivo |de resposta torna-se o ID do usu rio e a senha padro para todos os servios, |a no ser que voc fornea uma substituio para um servio especificando o |par de palavras-chave especfico para esse servio. |Na Verso 6, as palavras-chave admin.userid e |admin.password no puderam ser especificadas durante uma |instalao do arquivo de resposta do DB2 Satellite Edition para especificarem |o ID do usu rio e a senha que seriam utilizados pelo Servio de Comando |Remoto. Para Personal Edition e Workgroup Edition Verso 7.2, se |voc especificar essas palavras-chave, elas sero utilizadas para a instncia |DB2DAS00 no sistema Verso 7.2. Para um sistema DB2 Verso |7.2, o Servio de Comando Remoto utilizar o ID do usu rio e a senha |que so utilizados pela instncia do DB2 no sistema. Se voc no |especificar esses valores para db2.userid e |db2.password, a regra padro descrita acima se |aplicar . 2. |Na Verso 6, voc pode criar um banco de dados ao instalar o DB2 Satellite |Edition utilizando uma instalao do arquivo de resposta. Voc no pode |criar um banco de dados durante uma instalao do arquivo de resposta no |sistema Personal Edition ou Workgroup Edition Verso 7.2 que pretende |utilizar como um satlite. As palavras-chave a seguir (que esto |descritas na publicao Manual e Referncia de Administrao de Satlites -), no so |suportadas: | o |db2.userdb_name o |db2.userdb_recoverable o |db2.userdb_rep_src | | |11.1.2 Configurando o Sistema Verso 7.2 para Sincronizao | | |Se voc instalar o sistema Verso 7.2 interativamente, v rios |valores devero ser definidos no sistema DB2 Personal Edition ou DB2 Workgroup |Edition aps a instalao do DB2 antes do sistema ser sincronizado. |Nota: Voc pode executar um script do sistema operacional no sistema para definir |todos os valores no satlite, exceto para o ID do usu rio e a senha que o |satlite utiliza para conectar-se ao banco de dados de controle do satlite |(consulte a etapa 4). | | 1. |Defina o ID do satlite utilizando o comando db2set. |Se voc instalar o DB2 Personal Edition ou DB2 Workgroup Edition |interativamente, o ID do satlite ser automaticamente definido para o ID do |usu rio que foi utilizado para instalar o DB2. Se desejar utilizar esse |ID do usu rio como o ID do satlite, no precisar executar esta etapa. |Para obter informaes sobre a definio do ID do satlite, consulte a |publicao Manual e Referncia de Administrao de Satlites -. 2. |Defina a verso do aplicativo no satlite, utilizando o comando |db2sync -s. |Se voc instalar o DB2 Personal Edition ou DB2 Workgroup Edition |interativamente, a verso do aplicativo no satlite ser automaticamente |definida como V1R0M00. Se desejar utilizar esse valor como a verso do |aplicativo, no precisar executar esta etapa. |Voc pode utilizar o comando db2sync -g no satlite, para exibir |a definio atual da verso do aplicativo. Se desejar alterar esse |valor, emita o comando db2sync -s. solicitado que voc |fornea um novo valor para a verso do aplicativo. Para obter mais |informaes sobre a definio da verso do aplicativo, consulte a publicao |Manual e Referncia de Administrao de Satlites -. 3. |Emita os comandos catalog node e catalog database no |satlite, para catalogar a instncia do DB2 control server e o banco de dados |de controle do satlite, SATCTLDB, no satlite. |Voc tambm pode utilizar o comando db2sync -t no satlite, para |abrir o aplicativo DB2 Synchronizer no modo de teste. Se o banco de |dados SATCTLDB no estiver catalogado no satlite quando voc emite o comando, |a janela Catalogar Banco de Dados de Controle aberta. Voc pode |utilizar o recurso de descoberta do DB2 que est disponvel a partir da janela |Catalogar Banco de Dados de Controle, para catalogar o DB2 control server e o |banco de dados SATCTLDB ou pode digitar o nome do host e o nome do servidor |nesta janela. Voc tambm ser solicitado a especificar o ID do usu rio |e a senha que o satlite utilizaro para conectar-se ao banco de dados de |controle do satlite, conforme descrito na etapa 4. |Nota: Aps instalar o DB2 Personal Edition ou DB2 Workgroup Edition Verso |7.2 interativamente, o DB2 Synchronizer no iniciado automaticamente |no modo de teste (como foi o caso do DB2 Satellite Edition Verso 6). | 4. |Emita o comando db2sync -t no satlite para: | o |Especificar o ID do usu rio e a senha que o satlite utiliza para |conectar-se ao banco de dados de controle do satlite |Se as credenciais de sincronizao ainda no estiverem armazenadas no |satlite, a janela Conectar-se ao Banco de Dados de Controle ser |aberta. Voc deve utilizar essa janela para especificar o ID do usu rio |e a senha que o satlite utilizar para conectar-se ao banco de dados de |controle do satlite. o |Verificar se os valores que esto definidos no satlite esto corretos o |Verificar se o satlite pode conectar-se ao banco de dados de controle do |satlite | | |Aps concluir essas tarefas de configurao, o sistema Verso 7.2 |est pronto para ser sincronizado. |11.1.3 Instalando o FixPak 2 ou Superior em um Sistema Enterprise Edition Verso 6 |Para que um sistema Enterprise Edition Verso 6 seja utilizado como |um DB2 control server, o sistema dever ter o FixPak 2 ou |superior. |As sees que seguem descrevem as tarefas que voc deve executar para |atualizar um sistema Enterprise Edition Verso 6 no Windows NT ou AIX para uso |como um DB2 control server. Se voc estiver utilizando um Centro de |Controle Verso 6, executar tambm as etapas em 11.1.4, Atualizando uma Verso 6 do Centro de Controle e do Centro de Administrao do Satlite para verificar se voc possui o nvel correto do Centro de |Controle e do Centro de Administrao do Satlite para administrar o ambiente |do satlite. |11.1.3.1 Atualizando o DB2 Enterprise Edition Verso 6 para Uso como o DB2 Control Server | | |Para um sistema DB2 Enterprise Edition Verso 6 a ser utilizado como o DB2 |control server, ele deve ser instalado com o componente Control Server e o DB2 |Enterprise Edition deve estar no nvel de servio FixPak ou superior. |Dependendo do componente do DB2 Control Server instalado e do nvel de servio |do DB2 Enterprise Edition, voc ter que executar as seguintes tarefas: | * |Instale o componente do DB2 control server em um sistema DB2 Enterprise |Edition V6.1 existente e instale o FixPak 2 ou superior. Em |seguida, atualize o banco de dados de controle do satlite (SATCTLDB) no |sistema. * |Atualize um DB2 control server j instalado para o nvel FixPak 2 ou |superior. | |Utilize as informaes que seguem para identificar quais das duas tarefas |anteriores precisam ser executadas e as etapas que se aplicam a sua |situao. A seguir encontra-se um resumo das etapas que voc ir |executar. | 1. |Primeiro, avalie o estado atual de instalao do DB2 Enterprise |Edition. Voc determinar se o componente Control Server est instalado |e o nvel de servio do DB2. 2. |Segundo, com base nas informaes de estado obtidas, voc determinar o |que preciso ser executado. 3. |Terceiro, voc ir executar as etapas necess rias para atualizar o DB2 |Enterprise Edition. | |O DB2 control server pode executar somente no DB2 Enterprise Edition para |Windows NT e AIX. Continue com as instrues que so apropriadas para |sua plataforma: | * |Atualizando o DB2 Enterprise Edition no Windows NT * |Atualizando o DB2 Enterprise Edition no AIX | |Atualizando o DB2 Enterprise Edition no Windows NT |Utilize as informaes nas sees que seguem, para determinar o nvel de |servio atual de seu sistema DB2 Enterprise Edition Verso 6 e as etapas que |voc precisa executar para atualizar o sistema para o nvel de servio do |FixPak 2 ou superior. Voc precisar executar as etapas de uma ou mais |das seguintes sees: | * |Avaliando o DB2 Enterprise Edition no Windows NT * |Determinando O Que Preciso Ser Executado * |Instalando o Componente Control Server no Windows NT * |Instalando o FixPak 2 ou Superior no Windows NT * |Atualizando o SATCTLDB no Windows NT | |Avaliando o DB2 Enterprise Edition no Windows NT |Se voc tiver o DB2 Enterprise Edition instalado no Windows NT, execute as |seguintes etapas: | 1. |Verifique se o componente Control Server est instalado. Utilize o |Editor de Registro para exibir a lista de componentes instalados: | a. |Digite regedit em um prompt de comandos. b. |Na chave de registro HKEY_LOCAL_MACHINE\SOFTWARE\IBM\DB2\Components, |verifique se o Control Server est listado. Se ele no estiver listado, |o control server no ser instalado. | 2. |Determine o nvel de servio do DB2 Enterprise Edition. Emita o |comando db2level a partir de um prompt de comandos. Utilize |a tabela que segue, para interpretar a sada: | Valores de Campos Chaves na sada db2level Seu sistema DB2 Release Nvel Tokens Informativos encontra-se em: SQL06010 01010104 db2_v6, n990616 Verso 6.1 base SQL06010 01020104 DB2 V6.1.0.1, n990824, Verso 6.1 mais WR21136 FixPak 1 SQL06010 01030104 DB2 V6.1.0.6, s991030, Verso 6.1 mais WR21163 or DB2 FixPak 2 V6.1.0.9, s000101, WR21173 |Nota: Se o nvel for maior que 01030104, seu sistema estar em um FixPak superior |do que FixPak 2. | 3. |Grave as informaes que encontrar e continue em Determinando O Que Preciso Ser Executado. | |Determinando O Que Preciso Ser Executado |Utilizando as informaes que voc obteve, procure a linha na tabela a |seguir que se aplica a sua situao e siga as etapas que so requeridas para |preparar o sistema DB2 Enterprise Edition para suportar o DB2 control server |no nvel FixPak ou superior. |As sees que seguem a tabela fornecem instrues para execuo das etapas |requeridas. Considere verificar cada etapa conforme a executa. |Execute apenas as etapas que se aplicam a sua situao. | Componente do Control Nvel de Servio do Etapas requeridas para Server Instalado Sistema DB2 Enterprise preparar o sistema DB2 Edition Enterprise Edition No Verso 6.1 base, Verso Execute as seguintes 6.1 mais FixPak 1 ou etapas: Verso 6.1 mais FixPak 2 ou superior 1. Instalando o Componente Control Server no Windows NT 2. Instalando o FixPak 2 ou Superior no Windows NT 3. Atualizando o SATCTLDB no Windows NT Sim Verso 6.1 base ou Execute as seguintes Verso 6.1 mais FixPak 1 etapas: 1. Instalando o FixPak 2 ou Superior no Windows NT 2. Atualizando o SATCTLDB no Windows NT Sim Verso 6.1 mais FixPak 2 Execute as seguintes ou superior etapas: 1. Atualizando o SATCTLDB no Windows NT |Instalando o Componente Control Server no Windows NT |Para instalar o componente Control Server no Windows NT: | 1. |Assegure-se de que toda atividade do banco de dados no sistema esteja |concluda antes continuar. 2. |Insira o CD DB2 Universal Database Enterprise Edition Verso 6.1 na |unidade de CD. |Se o programa de instalao no iniciar automaticamente, execute o comando |setup na raiz do CD para iniciar o processo de instalao. 3. |Quando solicitado, encerre todos os processos que esto utilizando o |DB2. 4. |Na janela Boas-Vindas, selecione Avanar. 5. |Na janela Selecionar Produtos, assegure-se de que o DB2 Enterprise Edition |est selecionado. 6. |No painel Selecionar Tipo de Instalao, clique em |Personalizar. 7. |No painel Selecionar Componentes, assegure-se de que o componente Control |Server esteja selecionado e clique em Avanar. |Nota: Se voc selecionar outros componentes que ainda no esto instalados em seu |sistema, esses componentes tambm sero instalados. Voc no pode |alterar a unidade ou o diretrio no qual o DB2 est instalado. | 8. |No painel Configurar o DB2 Services, voc pode modificar os valores de |protocolos e as opes de inicializao para a instncia do Control Server ou |obter os valores padro. Modifique os padres e clique em |Avanar ou clique em Avanar para utilizar os |padres. 9. |Clique em Avanar na janela Iniciar Cpia de Arquivos, para |comear o processo de instalao. 10. |Quando o processo de cpia de arquivo est concludo, voc tem a opo de |reinicializar o sistema. Voc deve reinicializar agora. As |alteraes feitas no sistema para o Control Server, no so efetivadas at que |o sistema reinicializado. | |Quando o processo de instalao concludo e voc reinicializou o sistema, |o banco de dados de controle do satlite (SATCTLDB) que foi criado como parte |da instalao do Control Server dever ser catalogado na instncia do DB2, se |desejar utilizar o Centro de Controle e o Centro de Administrao do Satlite |localmente no sistema. Para catalogar o banco de dados SATCTLDB: | 1. |Abra uma Janela de Comando do DB2 selecionando |Iniciar>Programas>DB2 para Windows NT>Janela de Comando 2. |Assegure-se de que voc esteja na instncia do db2. |Emita o comando set e verifique o valor de db2instance. |Se o valor no for db2, emita o seguinte comando: | set db2instance=db2 3. |Catalogue a instncia db2ctlsv digitando o seguinte comando: | db2 catalog local node db2ctlsv instance db2ctlsv 4. |Catalogue o banco de dados SATCTLDB digitando o seguinte comando | db2 catalog database satctldb at node db2ctlsv 5. |Consolide as aes de cat logo digitando o seguinte comando: | db2 terminate 6. |Feche a Janela de Comando do DB2. | |Instalando o FixPak 2 ou Superior no Windows NT |Para atualizar um sistema DB2 Enterprise Edition Verso 6 existente no |Windows NT para FixPak 2 ou superior: | * |Faa download do ltimo FixPak para DB2 Enterprise Edition para Windows NT |V6.1 da Web, junto com o readme de acompanhamento. Pode ser |feito download do FixPak, seguindo as instrues na URL: |http://www.ibm.com/software/data/db2/db2tech/version61.html |Instale o FixPak seguindo as instrues no arquivo |readme.txt. * |Utilize um DB2 Universal Database, o CD FixPak para Windows NT Verso |6.1 que est no nvel FixPak 2 ou superior e siga as instrues no |arquivo readme.txt no diretrio WINNT95 no CD, para concluir a |instalao. | |Atualizando o SATCTLDB no Windows NT |Para atualizar o banco de dados SATCTLDB no Windows NT | 1. |Determine o nvel do banco de dados SATCTLDB: | a. |Inicie sesso com um ID do usu rio que possui autoridade administrativa |local no sistema Windows NT. b. |Abra uma Janela de Comando do DB2, selecionando |Iniciar>Programas>DB2 para Windows NT>Janela de |Comando. c. |Conecte-se ao SATCTLDB, digitando o seguinte comando | db2 connect to satctldb d. |Determine se o disparo I_BATCHSTEP_TRGSCR existe no banco de |dados, emitindo a seguinte consulta: | db2 select name from sysibm.systriggers | where name='I_BATCHSTEP_TRGSCR' |Grave o nmero de linhas que so retornadas. e. |Digite o comando a seguir para fechar a conexo ao banco de dados: | db2 connect reset |Se a etapa 1d retornou uma linha, o banco de dados estar no nvel |correto. Nesta situao, pule a etapa 2 e continue na etapa 3. Se zero (0) linhas forem |retornadas, o banco de dados no estar no nvel correto e dever ser |atualizado, conforme descrito na etapa 2, antes de voc executar a etapa 3. | 2. |Para atualizar o banco de dados SATCTLDB, execute as etapas a |seguir. Digite todos os comandos na Janela de Comando do DB2: | a. |V para o diretrio \misc, onde a unidade |e o caminho de instalao, por exemplo c:\sqllib. b. |Assegure-se de que voc esteja na instncia db2ctlsv. |Emita o comando set e verifique o valor de db2instance. |Se o valor no for db2ctlsv, emita o seguinte comando: | set db2instance=db2ctlsv c. |Elimine o banco de dados SATCTLDB, digitando o seguinte comando: | db2 drop database satctldb d. |Crie o novo banco de dados SATCTLDB, digitando o seguinte comando: | db2 -tf satctldb.ddl -z satctldb.log e. |Emita o seguinte comando: | db2 |terminate | 3. |Efetuar a vinculao do procedimento armazenado |db2satcs.dll no banco de dados SATCTLDB. Execute as seguintes |etapas: | a. |Conecte-se ao banco de dados SATCTLDB, digitando o seguinte comando | db2 connect to satctldb b. |V para o diretrio \bnd, onde a unidade |e o caminho de instalao, por exemplo c:\sqllib. c. |Emita o comando de ligao, como segue: | db2 bind db2satcs.bnd | 4. |Digite o comando a seguir para fechar a conexo ao banco de dados: | db2 connect reset 5. |Feche a Janela de Comando do DB2. | |Atualizando o DB2 Enterprise Edition no AIX |Utilize as informaes nas sees que seguem, para determinar o nvel de |servio atual de seu sistema DB2 Enterprise Edition Verso 6 e as etapas que |voc precisa executar para atualizar o sistema para o nvel de servio do |FixPak 2 ou superior. Voc precisar executar as etapas de uma ou mais |das seguintes sees: | * |Avaliando o DB2 Enterprise Edition no AIX * |Determinando O Que Preciso Ser Executado * |Instalando o Componente Control Server no AIX * |Instalando o FixPak 2 ou Superior no AIX * |Atualizando o Banco de Dados SATCTLDB no AIX | |Avaliando o DB2 Enterprise Edition no AIX |Se voc tiver o DB2 Enterprise Edition Verso 6 instalado no AIX, execute |as seguintes etapas: | 1. |Verifique se o componente Control Server est instalado. Digite o |seguinte comando: | lslpp -l | grep db2_06_01.ctsr |Se nenhum dado for retornado, o componente Control Server no ser |instalado. 2. |Determine o nvel de servio do DB2 Enterprise Edition. Inicie |sesso como um propriet rio da instncia do DB2 e emita o comando |db2level. Utilize a tabela que segue, para interpretar a |sada: | Valores de Campos Chaves na sada db2level Seu sistema DB2 Release Nvel Tokens Informativos encontra-se em: SQL06010 01010104 db2_v6, n990616 Verso 6.1 base SQL06010 01020104 DB2 V6.1.0.1, n990824, Verso 6.1 mais U465423 FixPak 1 SQL06010 01030104 DB2 V6.1.0.6, s991030, Verso 6.1 mais U468276 or DB2 FixPak 2 V6.1.0.9, s000101, U469453 |Nota: Se o nvel for maior que 01030104, seu sistema estar em um FixPak superior |do que FixPak 2. | 3. |Grave as informaes que encontrar e continue em Determinando O Que Preciso Ser Executado. | |Determinando O Que Preciso Ser Executado |Utilizando as informaes que voc obteve, procure a linha na tabela a |seguir que se aplica a sua situao e siga as etapas que so requeridas para |preparar o sistema DB2 Enterprise Edition Verso 6 para suportar o DB2 control |server no nvel FixPak 2. |As sees que seguem a tabela fornecem instrues para execuo das etapas |requeridas. Considere verificar cada etapa conforme a executa. |Execute apenas as etapas que se aplicam a sua situao. | Componente do Control Nvel de Servio do Etapas requeridas para Server Instalado Sistema DB2 Enterprise preparar o sistema DB2 Edition Enterprise Edition No Verso 6.1 base, Verso Execute as seguintes 6.1 mais FixPak 1 ou etapas: Verso 6.1 mais FixPak 2 ou superior 1. Instalando o Componente Control Server no AIX 2. Instalando o FixPak 2 ou Superior no AIX 3. Atualizando o Banco de Dados SATCTLDB no AIX Sim Verso 6.1 base ou Execute as seguintes Verso 6.1 mais FixPak 1 etapas: 1. Instalando o FixPak 2 ou Superior no AIX 2. Atualizando o Banco de Dados SATCTLDB no AIX Sim Verso 6.1 mais FixPak 2 Execute as seguintes ou superior etapas: 1. Atualizando o Banco de Dados SATCTLDB no AIX |Instalando o Componente Control Server no AIX |Para instalar o componente Control Server no AIX | 1. |Efetue logon como um usu rio com autoridade root. 2. |Insira o CD DB2 Universal Database Enterprise Edition Verso 6.1 na |unidade de CD. 3. |Mude para o diretrio onde o CD est montado, por exemplo, cd |/cdrom. 4. |Digite o comando a seguir para iniciar o DB2 installer: | ./db2setup 5. |Quando a janela DB2 Installer aberta, utilize a tecla tab para |selecionar a opo Instalar e pressione Enter. 6. |Localize a linha do Enterprise Edition e utilize a tecla tab para |selecionar a opo Personalizar ao lado dela. Pressione |Enter. 7. |Selecione o componente DB2 Control Server, com a tecla tab v at OK e |pressione Enter. 8. |Siga as instrues nas janelas restantes, para concluir a instalao do |componente DB2 Control Server. | |Quando o processo de instalao concludo, crie a instncia DB2CTLSV e o |banco de dados SATCTLDB. Para executar essas tarefas, siga as |instrues detalhadas em "Configurando o DB2 Control Server no AIX" no |Captulo 13 do Manual e Referncia de Administrao de Satlites -. |Instalando o FixPak 2 ou Superior no AIX |Para atualizar um sistema AIX DB2 Enterprise Edition existente para FixPak |2 ou superior: | * |Faa download do ltimo FixPak do DB2 Enterprise Edition para AIX |V6.1 na Web, juntamente com o "Readme" fornecido com ele. Pode |ser feito download do FixPak, seguindo as instrues na URL: |http://www.ibm.com/software/data/db2/db2tech/version61.html |Instale o FixPak seguindo as instrues no arquivo Readme. * |Utilize um DB2 Universal Database, o CD FixPak para AIX Verso 6.1 |que est no nvel FixPak 2 ou superior e siga as instrues no arquivo readme |no CD, para concluir a instalao. | |Assegure-se de que tenha atualizado a instncia DB2CTLSV executando o |comando db2iupdt, conforme instrudo no arquivo Readme do |FixPak. |Atualizando o Banco de Dados SATCTLDB no AIX |Para atualizar o banco de dados SATCTLDB no AIX: | 1. |Determine o nvel do banco de dados SATCTLDB: | a. |Inicie sesso como db2ctlsv. b. |Assegure-se de que o servidor do banco de dados foi iniciado. Se o |servidor no estiver iniciado, emita o comando db2start. c. |Conecte-se ao banco de dados SATCTLDB, digitando o seguinte comando: | db2 connect to satctldb d. |Determine se o disparo I_BATCHSTEP_TRGSCR existe no banco de |dados, emitindo a seguinte consulta: | db2 "select name from sysibm.systriggers | where name='I_BATCHSTEP_TRGSCR'" |Grave o nmero de linhas que so retornadas. e. |Digite o comando a seguir para fechar a conexo ao banco de dados: | db2 connect reset |Se a etapa 1d retornou uma linha, o banco de dados estar no nvel |correto. Nesta situao, pule a etapa 2 e continue na etapa 3. Se zero (0) linhas forem |retornadas, o banco de dados no estar no nvel correto e dever ser |atualizado, conforme descrito na etapa 2, antes de voc executar a etapa 3. | 2. |Para atualizar o banco de dados SATCTLDB para o nvel FixPak |2, execute as etapas a seguir. Digite todos os comandos na Janela de |Comando do DB2: | a. |V para o diretrio $HOME/sqllib/misc. b. |Elimine o banco de dados SATCTLDB, digitando o seguinte comando: | db2 drop database satctldb c. |Crie o novo banco de dados SATCTLDB, digitando o seguinte comando: | db2 -tf satctldb.ddl -z $HOME/satctldb.log d. |Emita o seguinte comando: | db2 |terminate | 3. |Efetuar a vinculao do procedimento armazenado |db2satcs.dll no banco de dados SATCTLDB. Execute as seguintes |etapas: | a. |Conecte-se ao banco de dados SATCTLDB, digitando o seguinte comando | db2 connect to satctldb b. |V para o diretrio $HOME/sqllib/bnd. c. |Emita o comando de ligao, como segue: | db2 bind db2satcs.bnd | 4. |Digite o comando a seguir para fechar a conexo ao banco de dados: | db2 connect reset | |11.1.4 Atualizando uma Verso 6 do Centro de Controle e do Centro de Administrao do Satlite | | | |Para utilizar uma Verso 6 Centro de Controle e Centro de Administrao do |Satlite com um DB2 control server Verso 6 e o banco de dados de controle do |satlite (SATCTLDB) que foram atualizados para FixPak 2 ou superior, as |ferramentas tambm devem ser atualizadas para FixPak 2 ou superior. |Se o Centro de Controle e o Centro de Administrao do Satlite estiverem |sendo executados no mesmo sistema que o DB2 control server, eles foram |atualizados quando o sistema DB2 Enterprise Edition foi atualizado para FixPak |2. Entretanto, se voc executar essas ferramentas em outro sistema, |dever atualizar esse sistema para o nvel FixPak 2 ou superior. |Para atualizar esse sistema para FixPak 2 ou superior: | * |Faa download do ltimo FixPak para seu produto no nvel V6.1 da |Web, junto com seu readme de acompanhamento. Pode ser feito download |dos FixPaks seguindo as instrues na URL: | http://www.ibm.com/software/data/db2/db2tech/version61.html |Instale o FixPak seguindo as instrues no arquivo readme. * |Utilize um DB2 Universal Database, o CD FixPak Verso 6.1 para o |sistema operacional que voc est executando que encontra-se no nvel FixPak 2 |ou superior e siga as instrues no readme para concluir a instalao. | ------------------------------------------------------------------------ |Referncia de Comandos ------------------------------------------------------------------------ |12.1 Atualizao Disponvel |O Referncia de Comandos foi atualizado como parte do FixPak 4. O |PDF mais recente est disponvel para download online em http://www.ibm.com/software/data/db2/udb/winos2unix/support. |As informaes nestas notas esto inclusas na referncia de |atualizao. Toda a documentao de atualizao est tambm disponvel |em CD. Este CD pode ser solicitado atravs do servio do DB2 utilizando |o PTF nmero U478862. Informaes sobre o contato com o Servio do DB2 |esto disponveis no endereo http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/help.d2w/report. ------------------------------------------------------------------------ |12.2 db2updv7 - Atualizar o Banco de Dados para o Nvel de Correo Atual da Verso 7 |Esse comando atualiza os cat logos do sistema em um banco de dados para |suportar o FixPak atual das seguintes maneiras: | * |Permite a utilizao das novas funes incorporadas: ABS, |DECRYPT_BIN, DECRYPT_CHAR, ENCRYPT, GETHINT, MULTIPLY_ALT e ROUND. * |Permite a utilizao das novas funes incorporadas para bancos de dados |Unicode: DATE(vargraphic), TIME(vargraphic), TIMESTAMP(vargraphic), |GRAPHIC(datetime-expression), GRAPHIC(date-expression), |GRAPHIC(time-expression) e VARGRAPHIC(datetime-expression). * |Permite o uso dos novos procedimentos incorporados (GET_ROUTINE_SAR e |PUT_ROUTINE_SAR). * |Inclui ou aplica correes s funes WEEK_ISO e DAYOFWEEK_ISO nos bancos |de dados do Windows e do OS/2. * |Aplica uma correo aos descritores de tabela compactados para tabelas |migradas da Verso 2 para a Verso 6. * |Cria a exibio SYSCAT.SEQUENCES. | | |Autorizao |sysadm |Conexo Requerida |Banco de Dados. Esse comando estabelece automaticamente uma conexo |ao banco de dados especificado. |Sintaxe do Comando |>>-db2updv7---d--database_name--+--------------------------+----> | '--u--userid---p--password-' | |>--+----+------------------------------------------------------>< | '--h-' | | |Parmetros do Comando | |-d database-name |Especifica o nome do banco de dados a ser atualizado. |-u userid |Especifica o ID do usu rio. |-p password |Especifica a senha para o usu rio. |-h |Exibe as informao de ajuda. Quando esta opo especificada, |todas as outras opes so ignoradas e somente as informaes de ajuda so |exibidas. | |Exemplo |Aps instalar o FixPak, atualize o cat logo do sistema no banco de dados |de amostra emitindo o seguinte comando: |db2updv7 -d sample |Notas de Uso |Essa ferramenta s pode ser utilizada em um banco de dados que executa o |DB2 Verso 7.1 ou verso 7.2 com pelo menos o FixPak 2 |instalado. Se o comando for emitido mais de uma vez, nenhum erro ser |reportado e cada atualizao do cat logo ser aplicada somente uma vez. |Para ativar as novas funes incorporadas, todos os aplicativos devem ser |desconectadas desse banco de dados e o banco de dados deve ser desativado, |caso esteja ativado. | ------------------------------------------------------------------------ |12.3 REBIND |O diagrama de sintaxe para o comando REBIND deve aparecer assim: |Missing value |Sintaxe do Comando |>>-REBIND--+---------+--package-name----------------------------> | '-PACKAGE-' | | .-ANY----------. |>--RESOLVE--+-CONSERVATIVE-+----------------------------------->< | | ------------------------------------------------------------------------ |12.4 db2inidb - Inicializar um Banco de Dados Espelhado |A descrio do parmetro RELOCATE USING configfile deve aparecer |assim: |Especifica que os arquivos de banco de dados devem ser realocados nas |informaes listadas no arquivo de configurao antes da inicializao do |banco de dados como um instantneo, espera ou espelho. |Nota: Para informaes sobre o formato do arquivo de configurao, consulte a |publicao Data Movement Utilities Guide and Reference. | |12.4.1 Informaes de Utilizao |Se o parmetro RELOCATE USING configfile estiver especificado e o |banco de dados for realocado com xito, o arquivo de configurao copiado no |diretrio do banco de dados e renomeado db2path.cfg. |Durante quaisquer recuperaes de falha ou de avano subseqentes, esse |arquivo de configurao utilizado para renomear dinamicamente os caminhos de |continer durante o processamento do arquivo de registro. |Se voc inicializar um banco de dados instantneo ou espelhado, o arquivo |de configurao removido automaticamente depois que a recuperao for |concluda. Se voc inicializar um banco de dados de espera, o arquivo |de configurao no apenas removido depois que a recuperao for concluda, |como tambm removido se voc cancelar o processo de recuperao. |Se voc estiver trabalhando com um banco de dados de espera que voc est |mantendo em estado pendente para que possa avan -lo continuamente e voc |incluir novos contineres no banco de dados original, voc pode atualizar |manualmente o arquivo db2path.cfg para indicar onde os |contineres devem ser armazenados para o banco de dados de espera. Se |voc no especificar uma localizao para os novos contineres, o DB2 tentar |armazen -los na mesma localizao dos originais. ------------------------------------------------------------------------ |12.5 Opo Adicional no Comando GET ROUTINE |Esse comando agora suporta o parmetro HIDE BODY, que especifica que o |corpo da rotina deve ser substitudo por um corpo vazio quando o texto da |rotina extrado dos cat logos. |Isso no afeta o cdigo compilado; afeta somente o texto. |GET ROUTINE | |Sintaxe do Comando |>>-GET ROUTINE--INTO--file_name--FROM--+----------+-------------> | '-SPECIFIC-' | |>----PROCEDURE----routine_name--+-----------+------------------>< | '-HIDE BODY-' | | ------------------------------------------------------------------------ |12.6 CREATE DATABASE | | |O DB2 agora suporta novas palavras-chave de intercalao, IDENTITY_16BIT e |SQL_CS_IDENTITY_16BIT, para bancos de dados Unicode. Quando |IDENTITY_16BIT for especificado para o comando CLP CREATE DATABASE ou |SQLEDBDESC.SQLDBCSS for definido para SQL_CS_IDENTITY_16BIT em |sqlecrea() -- Criar API do Banco de Dados, todos os dados do banco de |dados Unicode sero intercalados utilizando a ordem do CESU-8. CESU-8 |significa Esquema de Codificao de Compatibilidade para UTF-16: 8 |Bits e at o momento desta publicao, sua especificao est contida no |Draft Unicode Technical Report #26 disponvel no site na Web Unicode Technical |Consortium (www.unicode.org). CESU-8 bin rio, como o |UTF-8, exceto pelos caracteres suplementares Unicode, ou seja, os caracteres |definidos fora do 16-bit Basic Multilingual Plane (BMP ou Plane 0). Na |codificao UTF-8, um caractere suplementar representado por uma seqncia |de 4 bytes, mas o mesmo caractere em CESU-8 requer duas seqncias de 3 |bytes. |Em um banco de dados Unicode, dados CHAR, VARCHAR, LONG VARCHAR e CLOB so |armazenados em UTF-8 e dados GRAPHIC, VARGRAPHIC, LONG VARGRAPHIC e DBCLOB so |armazenados em UCS-2. Para a intercalao IDENTITY or SQL_CS_NONE, |caracteres no suplementares em UTF-8 e UCS-2 tm intercalao bin ria |idntica, mas caracteres suplementares em UTF-8 intercalam de forma diferente |que os mesmos caracteres em UCS-2. IDENTITY_16BIT ou |SQL_CS_IDENTITY_16BIT asseguram que todos os caracteres, suplementares ou no, |em bancos de dados DB2 Unicode tm a mesma intercalao bin ria. ------------------------------------------------------------------------ |Recuperao de Dados e Guia e Referncia de Alta Disponibilidade ------------------------------------------------------------------------ |13.1 Recuperao de Dados e Guia e Referncia de Alta Disponibilidade Disponvel Online |A nova publicao Recuperao de Dados e Guia e Referncia de Alta |Disponibilidadeagora est disponvel online tanto no formato HTML quanto PDF |em http://www.ibm.com/software/data/db2/udb/winos2unix/support. |As informaes nestas notas esto inclusas na referncia de |atualizao. Toda a documentao de atualizao est tambm disponvel |em CD. Este CD pode ser solicitado atravs do servio do DB2 utilizando |o PTF nmero U478862. Informaes sobre o contato com o Servio do DB2 |esto disponveis no endereo http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/help.d2w/report. ------------------------------------------------------------------------ |13.2 Novo Backup e Comportamento de Restaurao quando LOGRETAIN=CAPTURE | | | |Se um banco de dados estiver configurado com LOGRETAIN definido para |CAPTURE, as seguintes operaes no podero ser executadas: | * |Backup de banco de dados online * |Backup de nvel de espao de tabela Online ou offline * |Restaurao de nvel de espao de tabela online ou offline | |Ao seguir a operao de restaurao de banco de dados utilizando uma |imagem de backup offline obtida enquanto o LOGRETAIN est definido para |CAPTURE, o banco de dados no colocado em estado pendente |avanado. Uma operao de restaurao de banco de dados utilizando uma |imagem online de backup de banco de dados obtida enquanto o |LOGRETAIN est definido para CAPTURE (Verso 7.2 anterior ao FixPak 4) | suportada. ------------------------------------------------------------------------ |13.3 NEWLOGPATH2 Agora Chamado de DB2_NEWLOGPATH2 | | |Referncias ao registro vari vel do NEWLOGPATH2 foram alteradas para o |DB2_NEWLOGPATH2. ------------------------------------------------------------------------ |13.4 Escolhendo um Mtodo de Backup para o DB2 Data Links Manager no AIX ou Solaris | | |Antes de definir a opo PASSWORDACCESS no arquivo de opes do |sistema Tivoli Storage Manager, voc deve garantir que a /usr/lib |contenha um link simblico com o arquivo biblioteca |libApiDS.a ------------------------------------------------------------------------ |13.5 Tivoli Storage Manager -- LAN Free Data Transfer |DB2 Universal Database agora permite que usu rios utilizem a tecnologia do |LAN Free Data Transfer da Tivoli para backups e restauraes a um servidor |TSM. Se voc estiver utilizando uma das seguintes verses de DB2 |Universal Database juntamente com clientes ADSM 3.1.x da Tivoli, |voc poder enfrentar problemas ao fazer backup ou restaurar em um servidor |TSM: | * |DB2 para AIX (32 bits) * |DB2 for Ambiente Operacional Solaris (32 bits) * |DB2 para HP-UX (32 bits). | |Se voc enfrentar esses problemas, siga as seguintes etapas para |corrigi-los: | 1. |Emita um comando db2stop. 2. |Localize o diretrio sqllib/adsm no servidor DB2 UDB. 3. |Crie uma cpia de backup de libtadsm.a. Fazer uma |cpia dele chamada de libtadsm.a.bak |suficiente. 4. |Copie libadsm.a para |libtasdm.a. 5. |Emita um comando db2start. 6. |Emita o comando failed backup ou restore novamente. | ------------------------------------------------------------------------ Guia e Referncia dos Utilit rios de Movimento dos Dados ------------------------------------------------------------------------ |14.1 Alterao de Tratamento de Arquivo LOB por Exportar, Importar e Carregar |DB2 UDB agora faz uso de LLS (LOB Location Specifiers - Especificadores de |Localizao de LOB) ao importar, exportar e carregar informaes de |LOB. Isso permite que v rios LOBs sejam armazenados em um nico |arquivo. |Um LLS uma cadeia que indica onde dados de LOB podem ser encontrados |dentro de um arquivo. O formato do LLS |filename.ext:nnn:mmm/, em que |filename.ext o nome do arquivo que contm o LOB, |nnn o deslocamento do LOB dentro do arquivo (medido em bytes) e |mmm o comprimento do LOB (em bytes). Por exemplo, um LLS |igual a db2exp.001.123.456/ indica que o lob |est localizado no arquivo db2exp.001, comea em um deslocamento de 123 |bytes no arquivo e tem 456 bytes de comprimento. Se o tamanho indicado |no LLS for 0, considera-se que o LOB tenha um comprimento igual a 0. Se |o comprimento for --1, considera-se que o LOB seja NULO e o nome de |arquivo e o deslocamento no importam. |Ao exportar dados usando o modificador lobsinfile, os LOBs nem |sempre sero colocados em arquivos separados. Pode haver v rios lobs em |cada arquivo de lob e v rios arquivos de lob por caminho de lob. O |arquivo de dados conter agora registros de LLS em vez de somente nomes de |arquivos. |Importar e Carregar tambm foram alterados para refletir as mudanas na |funo Exportar. Ao carregar ou importar dados com a opo |modificado por lobsinfile especificada, sero esperados LLSs para |cada uma das colunas LOB correspondentes. Se algo diferente de um LLS |for encontrado para uma coluna LOB, o banco de dados o tratar como um arquivo |LOB e carregar o arquivo inteiro como o LOB. |14.1.1 Consideraes de IXF |H trs novos tipos de dados IXF. Esses trs tipos correspondem a |CLOBs, BLOBs e DBCLOBs quando representados por LLSs. Os valores desses |tipos de dados so 964, 960 e 968, respectivamente. |Arquivos IXF agora exigem que cada coluna LOB tenha seu prprio registro |D. Ele criado automaticamente pela ferramenta de exportao, mas deve |ser criado manualmente se voc estiver utilizando um utilit rio de terceiros |para criar os arquivos IXF. Alm disso, um LLS obrigatrio para cada |LOB na tabela e no apenas para os LOBs no-nulos. Se uma coluna LOB |for nula, voc deve escrever um LLS representando um LOB nulo. ------------------------------------------------------------------------ |14.2 Suporte P gina de Cdigos para Utilit rios de Importao, Exportao e Carregamento |Os utilit rios de importao, exportao e carregamento agora podem ser |utilizados para transferir dados da p gina de cdigos em chins GB 18030 |(identificador da p gina de cdigos 5488) e a nova p gina de cdigos em |japons ShiftJIS X0213 (identificador da p gina de cdigos 1394) para bancos |de dados Unicode DB2 UDB. Alm disso, o utilit rio de exportao pode |ser utilizado para transferir dados dos bancos de dados DB2 UDB Unicode para |dados da p gina de cdigos GB 18030 ou ShiftJIS X0213. |Por exemplo, o seguinte comando carregar o arquivo de dados Shift_JISX0213 |u/jp/user/x0213/data.del que reside em um cliente conectado |remotamente para MYTABLE: | db2 load client from /u/jp/user/x0213/data.del | of del modified by codepage=1394 insert into mytable |em que MYTABLE est localizada em um banco de dados DB2 UDB |Unicode. ------------------------------------------------------------------------ |14.3 db2relocatedb (Novo Comando) |db2relocatedb - Realocar Banco de Dados |Renomeia um banco de dados ou realoca um banco de dados ou parte dele (por |ex., continer, diretrio de log) conforme especificado no arquivo de |configurao fornecido pelo usu rio. Esta ferramenta faz as alteraes |necess rias na instncia do DB2 e nos arquivos de suporte do banco de |dados. |Autorizao |Nenhum |Conexo Requerida |Nenhum |Sintaxe do Comando |>>-db2relocatedb---f--configFilename--------------------------->< | | |Parmetros do Comando | |-f configFilename |Especifica o nome do arquivo que contm as informaes de configurao |necess rias para realocar o banco de dados. Esse nome de arquivo pode |ser relativo ou absoluto. O formato do arquivo de configurao : | DB_NAME=oldName,newName | DB_PATH=oldPath,newPath | INSTANCE=oldInst,newInst | NODENUM=nodeNumber | LOG_DIR=oldDirPath,newDirPath | CONT_PATH=oldContPath1,newContPath1 | CONT_PATH=oldContPath2,newContPath2 | ... |Em que: | |DB_NAME |Especifica o nome do banco de dados que est sendo realocado. Se o |nome do banco de dados estiver sendo alterado, tanto o nome antigo quanto o |novo nome devero ser especificados. Este campo obrigatrio. |DB_PATH |Especifica o caminho do banco de dados que est sendo realocado. |Este o caminho no qual o banco de dados foi originalmente criado. Se |o caminho do banco de dados estiver sendo alterado, tanto o caminho antigo |quanto o caminho novo devero ser especificados. Este campo |obrigatrio. |INSTANCE |Especifica a instncia na qual o banco de dados existe. Se o banco |de dados estiver sendo movido para uma nova instncia, tanto a instncia |antiga quanto a instncia nova devero ser especificadas. Este campo |obrigatrio. |NODENUM |Especifica o nmero do n para o n do banco de dados que est sendo |alterado. O padro 0. |LOG_DIR |Especifica uma alterao na localizao do caminho do log. Se o |caminho do registro estiver sendo mudado, tanto o caminho antigo quanto o novo |devem ser especificados. Essa especificao opcional se caminho do |registro residir sob o caminho do banco de dados, caso em que o caminho |atualizado automaticamente. |CONT_PATH |Especifica uma alterao na localizao dos contineres de reas de |tabela. Os caminhos antigo e novo do continer devero ser |especificados. V rias linhas CONT_PATH podero ser fornecidas se |houver v rias alteraes no caminho do continer a serem feitas. Essa |especificao opcional se os caminhos de continer residirem sob o caminho |do banco de dados, caso em que os caminhos sero atualizados |automaticamente. | |Nota: Linhas em branco ou linhas que iniciem com um caractere que indique |coment rio (#) sero ignoradas. | | |Exemplos |Exemplo 1 |Para alterar o nome do banco de dados TESTDB para PRODDB na instncia |DB2INST1 que reside no caminho /home/db2inst1, crie o seguinte |arquivo de configurao: | DB_NAME=TESTDB,PRODDB | DB_PATH=/home/db2inst1 | INSTANCE=db2inst1 | NODENUM=0 |Salve o arquivo de configurao como relocate.cfg e |utilize o seguinte comando para fazer as alteraes nos arquivos de banco de |dados: |db2relocatedb -f relocate.cfg |Exemplo 2 |Para mover o banco de dados DATAB1 da instncia JSMITH no caminho |/dbpath para a instncia PRODINST, proceda da seguinte |maneira: | 1. |Mova os arquivos do diretrio /dbpath/jsmith para |/dbpath/prodinst. 2. |Utilize o seguinte arquivo de configurao com o comando |db2relocatedb para fazer as alteraes nos arquivos de banco de |dados: | DB_NAME=DATAB1 | DB_PATH=/dbpath | INSTANCE=jsmith,prodinst | NODENUM=0 | |Exemplo 3 |O banco de dados PRODDB existe na instncia INST1 no caminho |/databases/PRODDB. A localizao de dois contineres de |tablespace precisa ser alterada da seguinte forma: | * |O continer do SMS /data/SMS1 precisa ser movido para |/DATA/NewSMS1. * |O continer do DMS /data/DMS1 precisa ser movido para |/DATA/DMS1. | |Depois que os diretrios e arquivos fsicos forem movidos para as novas |localizaes, o seguinte arquivo de configurao poder ser utilizado com o |comando db2relocatedb para fazer alteraes nos arquivos de banco |de dados para que eles reconheam as novas localizaes: | DB_NAME=PRODDB | DB_PATH=/databases/PRODDB | INSTANCE=inst1 | NODENUM=0 | CONT_PATH=/data/SMS1,/DATA/NewSMS1 | CONT_PATH=/data/DMS1,/DATA/DMS1 |Exemplo 4 |O banco de dados TESTDB existe na instncia DB2INST1 e foi criado no |caminho /databases/TESTDB. reas de Tabelas foram criadas |com os seguintes contineres: | TS1 | TS2_Cont0 | TS2_Cont1 | /databases/TESTDB/TS3_Cont0 | /databases/TESTDB/TS4/Cont0 | /Data/TS5_Cont0 | /dev/rTS5_Cont1 |TESTDB ser movido para um novo sistema. A instncia no novo sistema |ser NEWINST e a localizao do banco de dados ser /DB2. |Quando o banco de dados for movido, todos os arquivos existentes no |diretrio /databases/TESTDB/db2inst1 devero ser movidos para o |diretrio /DB2/newinst. Isso significa que os 5 primeiros |contineres sero realocados como parte dessa movimentao. (Os 3 |primeiros so relativos ao diretrio do banco de dados e os 2 seguintes so |relativos ao caminho do banco de dados.) Como esses contineres |esto localizados dentro do diretrio do banco de dados ou caminho do banco de |dados, eles no precisam ser listados no arquivo de configurao. Se os |2 contineres restantes tiverem que ser movidos para localizaes diferentes |no novo sistema, eles devero ser listados no arquivo de configurao. |Depois que os diretrios e arquivos fsicos forem movidos para as novas |localizaes, o seguinte arquivo de configurao poder ser utilizado com |db2relocatedb para fazer alteraes nos arquivos de banco de dados |para que eles reconheam as novas localizaes: | DB_NAME=TESTDB | DB_PATH=/databases/TESTDB,/DB2 | INSTANCE=db2inst1,newinst | NODENUM=0 | CONT_PATH=/Data/TS5_Cont0,/DB2/TESTDB/TS5_Cont0 | CONT_PATH=/dev/rTS5_Cont1,/dev/rTESTDB_TS5_Cont1 |Exemplo 5 |O banco de dados TESTDB possui 2 parties nos ns 10 e 20. A |instncia SERVINST e o caminho do banco de dados /home/servinst |em ambos os ns. O nome do banco de dados est sendo alterado para |SERVDB e o caminho do banco de dados est sendo alterado para |/databases em ambos os ns. Alm disso, o diretrio de log |est sendo alterado no n 20 de /testdb_logdir para |/servdb_logdir. |Como as alteraes esto sendo feitas em ambos os ns, um arquivo de |configurao dever ser criado para cada n e db2relocatedb dever |ser executado em cada n com o arquivo de configurao correspondente. |No n 10, o seguinte arquivo de configurao ser utilizado: | DB_NAME=TESTDB,SERVDB | DB_PATH=/home/servinst,/databases | INSTANCE=servinst | NODE_NUM=10 |No n 20, o seguinte arquivo de configurao ser utilizado: | DB_NAME=TESTDB,SERVDB | DB_PATH=/home/servinst,/databases | INSTANCE=servinst | NODE_NUM=20 | LOG_DIR=/testdb_logdir,/servdb_logdir |Notas de Uso |Se a instncia qual um banco de dados pertence estiver sendo alterada, |proceda da seguinte maneira antes de executar este comando para assegurar que |as alteraes nos arquivos de suporte do banco de dados e da instncia sejam |feitas: | * |Se um banco de dados estiver sendo movido para uma outra instncia, crie a |nova instncia. * |Copie os arquivos/dispositivos pertencentes aos bancos de dados que esto |sendo copiados para o sistema no qual reside a nova instncia. Os nomes |de caminhos devem ser alterados conforme necess rio. * |Altere a permisso dos arquivos/dispositivos que foram copiados para que |pertenam ao propriet rio da instncia. | |Se a instncia estiver sendo alterada, a ferramenta dever ser executada |pelo novo propriet rio da instncia. |Em um ambiente EEE, essa ferramenta deve ser executada em cada n que |requeira alteraes. Um arquivo de configurao separado dever ser |fornecido para cada n, incluindo o valor NODENUM do n que estiver sendo |alterado. Por exemplo, se o nome de um banco de dados estiver sendo |alterado, todos os ns sero afetados e o comando db2relocatedb |dever ser executado com um arquivo de configurao separado em cada |n. Se estiverem sendo movidos contineres pertencentes a um nico n, |o comando db2relocatedb precisar ser executado somente uma vez |nesse n. |Consulte tambm |Para obter mais informaes, consulte o comando db2inidb - Initialize |a Mirrored Database na seo Referncia de Comando. ------------------------------------------------------------------------ |14.4 db2move -- Novas Opes Disponveis |A ferramenta db2move agora tem duas opes adicionais, --aw |e --sn. A documentao integral para essa ferramenta |a seguinte: |Movendo Dados Usando a Ferramenta db2move | | |Essa ferramenta facilita a movimentao de grandes quantidades de tabelas |entre bancos de dados DB2 localizados em estaes de trabalho. A |ferramenta consulta as tabelas de cat logo de sistema para um banco de dados |especfico e compila uma lista de todas as tabelas de usu rios. Ento, |ela exporta essas tabelas em formato PC/IXF. Os arquivos PC/IXF podem |ser importados ou carregados em outro banco de dados DB2 local no mesmo |sistema ou podem ser transferidos para outra plataforma de estao de trabalho |e importados ou carregados em um banco de dados DB2 naquela plataforma. |Nota: Tabelas com colunas de tipo estruturado no so movidas quando essa |ferramenta utilizada. | |Autorizao |Essa ferramenta chama as APIs de exportar, importar e carregar do DB2, |dependendo da ao solicitada pelo usu rio. Portanto, o ID de usu rio |solicitante deve ter a autorizao correta exigida por essas APIs ou a |solicitao falhar . |Sintaxe do Comando | .-------------------------. | V | |>>-db2move--dbname--action----+---------------------+-+-------->< | +--tc--table-creators-+ | +--tn--table-names----+ | +--sn--schema names---+ | +--io--import-option--+ | +--lo--load-option----+ | +--l--lobpaths--------+ | +--u--userid----------+ | +--p--password--------+ | '--aw-----------------' | | |Parmetros do Comando | |dbname |Nome do banco de dados. |action |Deve ser uma das seguintes: EXPORT, IMPORT, ou LOAD. |-tc |table-creators. O padro all creators. |Essa uma ao EXPORT somente. Se especificada, somente aquelas |tabelas criadas pelos criadores listados com essa opo sero |exportadas. Se no especificada, o padro utilizar todos os |criadores. Ao especificar v rios criadores, cada um deve ser separado |por vrgulas; no so permitidos espaos em branco entre IDs de |criadores. O nmero m ximo de criadores que pode ser especificado |10. Essa opo pode ser utilizada com as opes "-tn" e "-sn" |para selecionar as tabelas para exportao. |Um asterisco (*) pode ser utilizado como caractere curinga que |pode ser colocado em qualquer lugar na cadeia. |-tn |table-names. O padro all user tables. |Essa uma ao EXPORT somente. Se especificado, somente as tabelas |cujos nomes sejam exatamente iguais queles na cadeia especfica so |exportadas. Se no especificado, o padro utilizar todas as tabelas |de usu rios. Ao especificar v rios nomes de tabelas, cada um deve ser |separado por vrgulas; no so permitidos espaos em branco entre nomes |de tabela. O nmero m ximo de nomes de tabela que pode ser especificado | 10. Essa opo pode ser utilizada com as opes "-tc" e |"-sn" para selecionar as tabelas para exportao. |db2move somente exportar as tabelas cujos nomes sejam idnticos |aos nomes de tabela especificados e cujos criadores combinem com as tabelas de |criadores especificadas. |Um asterisco (*) pode ser utilizado como caractere curinga que |pode ser colocado em qualquer lugar na cadeia. |-sn |schema names. O padro ALL SCHEMAS. |Essa uma ao EXPORT somente. Se especificado, somente as tabelas |cujos esquemas sejam idnticos queles na cadeia especificada so |exportadas. Se no especificado, o padro utilizar todos os |esquemas. Ao especificar v rios nomes de esquema, cada um deve ser |separado por vrgulas; no so permitidos espaos em branco entre nomes |de esquema. O nmero m ximo de nomes de esquema que pode ser |especificado 10. Essa opo pode ser utilizada com as opes |"-tc" e "-tn" para selecionar as tabelas para exportao. |db2move somente exportar as tabelas cujos nomes sejam idnticos |aos nomes de tabela especificados, cujos esquemas sejam idnticos aos esquemas |de tabela especificados e cujos criadores combinem com os criadores de tabela |especificados. |Um asterisco (*) pode ser utilizado como caractere curinga que |pode ser colocado em qualquer lugar na cadeia. |Nota: Nomes de esquema com menos de 8 caracteres tero caracteres adicionados at |chegarem a 8 caracteres. Por exemplo, se voc quiser incluir os |esquemas "AUSER" e "BUSER" e usar o caractere curinga, voc deve |especificar -sn *USER*. | |-io |import-option. O padro REPLACE_CREATE. |Opes v lidas so INSERT, INSERT_UPDATE, REPLACE, CREATE e |REPLACE_CREATE. |-lo |load-option. O padro INSERT. |Opes v lidas so INSERT e REPLACE. |-l |lobpaths. O padro o diretrio atual. |Essa opo especifica os nomes de caminho absoluto onde arquivos LOB so |criados (como parte de EXPORT) ou procurados (como parte de IMPORT ou |LOAD). Ao especificar v rios caminhos de LOB, cada um deve ser separado |por vrgulas; no so permitidos espaos em branco entre caminhos de |LOB. Se faltar espao para o primeiro caminho (durante EXPORT) ou os |arquivos no forem encontrados no caminho (durante IMPORT ou LOAD), o segundo |caminho ser utilizado e assim por diante. |Se a ao EXPORT e os caminhos de LOB forem especificados, todos os |arquivos nos diretrios de caminho de LOB so excludos, os diretrios so |removidos e novos diretrios so criados. Se no especificado, o |diretrio atual usado para o caminho de LOB. |-u |userid. O padro o ID de usu rio registrado. |Tanto o ID do usu rio quanto a senha so opcionais. Entretanto, se |um for especificado, o outro deve ser especificado. Se o comando for |executado em um cliente conectando a um servidor remoto, o ID do usu rio e a |senha devem ser especificados. |-p |password. O padro a senha registrada. |Tanto o ID do usu rio quanto a senha so opcionais. Entretanto, se |um for especificado, o outro deve ser especificado. Se o comando for |executado em um cliente conectando a um servidor remoto, o ID do usu rio e a |senha devem ser especificados. |-aw |allow warnings. |Utilizado para a ao EXPORT somente. Se essa opo for |especificada, quaisquer tabelas que recebam avisos durante a exportao sero |includas no arquivo db2move.lst. Se essa opo for omitida, |quaisquer tabelas que causem avisos durante a exportao no sero includas |no arquivo db2move.lst. Os arquivos .ixp e .msg de |uma tabela sero gerados independentemente dessa opo ser ou no |utilizada. | |Exemplos | * |db2move sample export |Isso exportar todas as tabelas no banco de dados SAMPLE; valores |padro so utilizados para todas as opes. * |db2move sample export -tc userid1,us*rid2 -tn tbname1,*tbname2 |Isso exportar todas as tabelas criadas por "userid1" ou IDs de |usu rio COMO "us%rid2" e com o nome "tbname1" ou nomes de |tabela COMO "%tbname2". * |db2move sample import -l D:\LOBPATH1,C:\LOBPATH2 |Esse exemplo aplic vel ao OS/2 ou ao sistema operacional Windows |somente. O comando importar todas as tabelas no banco de dados |SAMPLE; os caminhos LOB "D:\LOBPATH1" e |"C:\LOBPATH2" devem ser pesquisados para arquivos LOB. * |db2move sample load -l /home/userid/lobpath,/tmp |Esse exemplo aplic vel somente a sistemas baseados em UNIX. O |comando carregar todas as tabelas no banco de dados SAMPLE; tanto o |subdiretrio /home/userid/lobpath quanto o subdiretrio |tmp devem ser pesquisados para arquivos LOB. * |db2move sample import -io replace -u userid -p password |Isso importar todas as tabelas no banco de dados SAMPLE em modo |REPLACE; o ID de usu rio e a senha especificados podero ser |utilizados. | |Notas de Uso |Essa ferramenta exporta, importa ou carrega tabelas criadas pelo |usu rio. Se um banco de dados deve ser duplicado de um sistema |operacional para outro sistema operacional, db2move facilita a |movimentao das tabelas. tambm necess rio mover todos os outros |objetos associados s tabelas, tais como, nomes alternativos, exibies, |disparos, funes definidas pelo usu rio e outros. db2look |(Estatsticas de DB2 e Ferramentas de Extrao de DDL; consulte Referncia de Comandos) pode facilitar a movimentao de |alguns desses objetos, extraindo a instruo DDL (data definition language) do |banco de dados. |Quando as APIs de exportar, importar ou carregar so chamadas por |db2move, o parmetro FileTypeMod definido como |lobsinfile. Ou seja, dados de LOB so mantidos em arquivos |separados dos arquivos PC/IXF. H 26 000 nomes de arquivos |disponveis para arquivos LOB. |A ao LOAD deve ser executada localmente na m quina onde o banco de dados |e o arquivo de dados residem. Quando a API de carregar for chamada por |db2move, o parmetro CopyTargetList definido como |NULO; ou seja, nenhuma cpia feita. Se logretain |estiver ativo, a operao de carga no poder ser avanada mais tarde. |A rea de tabela onde as tabelas carregadas residem colocada em estado de |backup pendente e no fica acessvel. Um backup integral de banco de |dados ou um backup de rea de tabela obrigatrio para retirar a rea de |tabela do estado de backup pendente. |Quando emitida em um cliente Verso 5.2 contra um banco de dados |Verso 6, essa ferramenta no suporta nomes de tabela e de coluna que tenham |mais do que 18 caracteres. |Arquivos Exigidos/Gerados ao Utilizar EXPORT: | * |Entrada: Nenhuma. * |Sada: | |EXPORT.out |O resultado resumido da ao EXPORT. |db2move.lst |A lista de nomes de tabela originais, seus nomes de arquivo PC/IXF |correspondentes (tabnnn.ixf) e nomes de arquivos de mensagem |(tabnnn.msg). Essa lista, os arquivos PC/IXF exportados e os |arquivos LOB (tabnnnc.yyy) so utilizados como entrada para a ao |db2move IMPORT ou LOAD. |tabnnn.ixf |O arquivo exportado PC/IXF de uma tabela especfica. |tabnnn.msg |O arquivo de mensagem exportado da tabela correspondente. |tabnnnc.yyy |Os arquivos LOB exportados de uma tabela especfica. |"nnn" o nmero da tabela, "c" uma letra do alfabeto, |"yyy" um nmero variando de 001 a 999. |Esses arquivos sero criados somente se a tabela sendo exportada contiver |dados de LOB. Se criados, esses arquivos LOB so colocados nos |diretrios de caminho de lob. H um total de 26 000 possveis |nomes para arquivos LOB. |system.msg |O arquivo de mensagem contendo mensagens de sistema para criar ou excluir |arquivos ou comandos de diretrio. Isso somente utilizado se a ao |for EXPORT e um caminho de LOB for especificado. | | |Arquivos Exigidos/Gerados ao Utilizar IMPORT: | * |Entrada: | |db2move.lst |Um arquivo de sada da ao EXPORT. |tabnnn.ixf |Um arquivo de sada da ao EXPORT. |tabnnnc.yyy |Um arquivo de sada da ao EXPORT. | * |Sada: | |IMPORT.out |O resultado resumido da ao IMPORT. |tabnnn.msg |O arquivo de mensagem importado da tabela correspondente. | | |Arquivos Exigidos/Gerados ao Utilizar LOAD: | * |Entrada: | |db2move.lst |Um arquivo de sada da ao EXPORT. |tabnnn.ixf |Um arquivo de sada da ao EXPORT. |tabnnnc.yyy |Um arquivo de sada da ao EXPORT. | * |Sada: | |LOAD.out |O resultado resumido da ao LOAD. |tabnnn.msg |O arquivo de mensagem LOAD da tabela correspondente. | | ------------------------------------------------------------------------ 14.5 Captulo 2. Importar 14.5.1 Utilizando importao com inseres em buffer A nota no fim desta seo deve ser: Nota: Em todos os ambientes, exceto EEE, o recurso de inseres em buffer desativado durante operaes de importao nas quais o parmetro INSERT_UPDATE especificado. ------------------------------------------------------------------------ 14.6 Captulo 3. Carregar 14.6.1 Estados Pendentes Aps uma Operao de Carregamento As primeiras duas sentenas no ltimo par grafo nesta seo foram alteradas para o seguinte: O quarto estado possvel associado ao processo de carregamento (verificar estado pendente) pertence a limitaes referenciais e de verificao, limitaes de DATALINKS, limitaes de AST ou limitaes de colunas geradas. Por exemplo, se uma tabela existente for uma tabela principal contendo uma chave principal referenciada por uma chave externa em uma tabela dependente, substituir dados na tabela principal deixa as duas tabelas (no a rea de tabela) no estado pendente. 14.6.2 Restries e Limitaes de Carregamento As seguintes restries se aplicam s colunas geradas e ao utilit rio de carregamento: * No possvel carregar uma tabela tendo uma coluna gerada em um ndice nico, a menos que a coluna gerada seja uma "coluna de incluso" do ndice ou o modificador de tipo de arquivo generatedoverride seja usado. Se este modificador usado, ele aguardado por todos os valores para a coluna que ser fornecidos no arquivo de dados de entrada. * No possvel carregar uma tabela tendo uma coluna gerada no particionamento da chave a menos que o modificador de tipo de arquivo generatedoverride seja usado. Se este modificador usado, ele aguardado por todos os valores para a coluna que ser fornecidos no arquivo de dados de entrada. 14.6.3 Modificador de tipo do arquivo totalfreespace O modificador de tipo de arquivo totalfreespace (LOAD) foi modificado para aceitar um valor entre 0 e 2 147 483 647. ------------------------------------------------------------------------ 14.7 Captulo 4. Carregador Autom tico 14.7.1 rexecd Obrigatrio para Executar o AutoLoader Quando a Autenticao Estiver Definida como YES Na seo Opes do AutoLoader, a seguinte nota ser includa na descrio dos parmetros AUTHENTICATION e PASSWORD: Em um ambiente Linux, se voc estiver executando o AutoLoader com a opo de autenticao definida como YES, rexecd dever ser ativado em todas as m quinas. Se o rexecd no for ativado, ser gerada a seguinte mensagem de erro: openbreeze.torolab.ibm.com: Conexo recusada SQL6554N Ocorreu um erro ao tentar executar um processo remotamente. As seguintes mensagens de erro sero geradas no arquivo db2diag.log: 2000-10-11-13.04.16.832852 Ocorrncia:svtdbm N:000 PID:19612(db2atld) Appid: oper_system_services sqloRemoteExec Probe:31 ------------------------------------------------------------------------ 14.8 O Carregador Autom tico Pode Travar Durante uma Bifurcao O AIX 4.3.3 contm uma correo para um problema libc que pode causar o travamento do Carregador Autom tico durante uma bifurcao. O Carregador Autom tico um programa de multithread. Uma das threads surgiram da bifurcao de outro processo. A bifurcao de um processo filho provoca a criao de uma imagem de memria pai a ser criada na imagem filho. possvel que o bloqueio utilizado pelo libc.a gerencie mltiplas threads alocando a memria da pilha dentro do mesmo processo que foi mantido por uma thread sem bifurcao. Se uma thread sem bifurcao no ocorrer no processo filho, o bloqueio nunca ser liberado no filho, cautilizando algumas vezes, interrupes no processo pai. ------------------------------------------------------------------------ 14.9 Apndice C. Formatos de Arquivo do Utilit rio de Exportao/Importao/Carregamento A seguinte atualizao foi includa nesse Apndice: Os utilit rios de exportao, importao e carregamento no so suportados quando utilizados com um cliente Unicode conectado a um banco de dados no-Unicode. Arquivos de cliente Unicode so suportados somente quando o cliente Unicode est conectado a um banco de dados Unicode. ------------------------------------------------------------------------ Manual de Referncia e Replicao ------------------------------------------------------------------------ 15.1 Replicao e Servidores No-IBM Voc deve usar o DataJoiner Verso 2 ou superior para replicar dados para ou partir de servidores no-IBM como Informix, Microsoft SQL Server, Oracle, Sybase e Sybase SQL Anywhere. Voc no pode utilizar a funo de conexo relacional para este tipo de replicao porque o DB2 Relational Connect Verso 7 no tem capacidade de atualizao. Alm disso, voc deve usar o DJRA (DataJoiner Replication Administration) para administrar replicaes heterogneas em todas as plataformas (AS/400, OS/2, OS/390, UNIX, e Windows) para todas as verses existentes do DB2 e DataJoiner. ------------------------------------------------------------------------ 15.2 Replicando no Windows 2000 O DB2 DataPropagator Verso 7 compatvel com o sistema operacional Windows 2000. ------------------------------------------------------------------------ |15.3 Erro Conhecido Ao Salvar os Arquivos SQL |Se voc utilizar o Control Center no DB2 Connect Personal Edition, no |poder salvar os arquivos SQL. Se voc tentar salvar os arquivos SQL, |obter uma mensagem de erro que o DAS (Database Administration Server) no |est ativo, quando de fato o DAS no est disponvel porque ele no enviado |com o DB2 Connect PE. ------------------------------------------------------------------------ |15.4 Manuteno do DB2 |Recomenda-se instalar a ltima manuteno do DB2 para v rios produtos do |DB2 que voc utiliza em seu ambiente de replicao. ------------------------------------------------------------------------ |15.5 Utilit rio de Diferena de Dados na Web |Voc pode fazer download do DDU (Data Difference utility) da Web no |endereo |ftp://ftp.software.ibm.com/ps/products/datapropagator/fixes/. |O DDU um utilit rio de amostra que voc pode utilizar para comparar duas |verses do mesmo arquivo e produzir um arquivo de sada que mostra as |diferenas. Consulte o arquivo README que acompanha o utilit rio de |amostra, para obter detalhes. ------------------------------------------------------------------------ 15.6 Captulo 3. Cen rio de Replicao de Dados 15.6.1 Cen rios de Replicao Consulte a p gina Biblioteca do site Web DataPropagator (http://www.ibm.com/software/data/dpropr/) para obter um novo cen rio de replicao de dados heterogneos. Siga as etapas nesse cen rio para copiar as alteraes de um tabela-fonte de replicao em um banco de dados Oracle no AIX para uma tabela de destino no DB2 para Windows NT. Esse cen rio usa a ferramenta do DB2 DJRA (DataJoiner Replication Administration), Disparadores de captura, o programa Apply e o DB2 DataJoiner. Na p gina 44 da publicao, as instrues na etapa 6 para criao de um arquivo de senha devem ser as seguintes: Etapa 6: Criar um arquivo de senha Como o programa Apply precisa se conectar ao servidor de origem, voc dever criar um arquivo de senha para a autenticao do usu rio. Certifique-se de que o ID de usu rio que executar o programa Apply possa ler o arquivo de senha. Para criar um arquivo de senha: 1. A partir de uma janela do prompt de comandos do Windows NT, siga para o diretrio C:\scripts. 2. Crie um novo arquivo neste diretrio chamado DEPTQUAL.PWD. Voc pode criar este arquivo utilizando qualquer editor de texto, como o Bloco de notas. A conveno de nomenclatura do arquivo de senha applyqual.pwd; em que applyqual uma cadeia que considera minsculas/maisculas que deve corresponder s letras e ao valor do qualificador Apply utilizado na criao do conjunto de assinaturas.Para este cen rio, o qualificador Apply DEPTQUAL. Nota: A conveno de nomenclatura do arquivo da Verso 5 do DB2 DataPropagator tambm suportada. 3. O contedo do arquivo de senha possui o seguinte formato: SERVER=servidor USER=id do usu rio PWD=senha Em que: servidor O nome do servidor de origem, destino ou controle, exatamente como aparece na tabela do conjunto de assinaturas. Para este cen rio, estes nomes so SAMPLE e COPYDB. id_do_usu rio O ID do usu rio que voc pretende usar para administrar esse banco de dados em particular. Este valor considera maisculas e minsculas nos sistemas operacionais Windows NT e UNIX. senha A senha associada ao ID de usu rio. Este valor considera maisculas e minsculas nos sistemas operacionais Windows NT e UNIX. No coloque linhas em branco ou de coment rio neste arquivo. Inclua somente o nome do servidor, o ID de usu rio e a informao de senha. 4. O contedo do arquivo de senha semelhante : SERVER=SAMPLE USER=subina PWD=subpw SERVER=COPYDB USER=subina PWD=subpw Para obter maiores informaes sobre a autenticao e a segurana do DB2, consulte a publicao Manual de Administrao do IBM DB2. ------------------------------------------------------------------------ 15.7 Captulo 5. Planejando a Replicao 15.7.1 Nomes de Tabelas e Colunas A replicao no suporta espaos em branco em nomes de tabelas e colunas. 15.7.2 Replicando o DATALINK A replicao de LINK de DADOS est disponvel como parte da Verso 7.1, FixPak 1. Ela requer um daemon FTP que seja executado no sistema de arquivos DATALINK de origem e destino e suporte o comando MDTM (modtime), que exibe a hora da ltima modificao de um determinado arquivo. Se voc estiver utilizando a Verso 2.6 do sistema operacional Solaris ou qualquer outra verso que no inclua o suporte FTP para MDTM, ser necess rio outro software, como o WU-FTPD. Voc no pode replicar colunas DATALINK entre banco de dados do DB2 no AS/400 e banco de dados do DB2 em outras plataformas. Na plataforma AS/400, no existe suporte para a replicao do atributo "comment" de valores DATALINK. Se voc est executando o AIX 4.2, antes de executar o programa de sada padro do usu rio (ASNDLCOPY) voc deve instalar a PTF da APAR IY03101 (AIX 4210-06 MANUTENÖO RECOMENDADA PARA AIX 4.2.1). Esta PTF contm uma correo do ano 2000 para o comando "modtime/MDTM" no daemon do FTP. Para verificar a correo, confira o ltimo hor rio de modificao retornado pelo comando "modtime ", onde um arquivo que foi modificado depois de 1 de Janeiro de 2000. Se a tabela de destino uma tabela CCD externa, o DB2 DataPropagator chama a rotina ASNDLCOPY para replicar arquivos DATALINK. Para as ltimas informaes sobre como usar os programas ASNDLCOPY e ASNDLCOPYD, consulte a seo do prlogo do cdigo de origem de cada programa. As seguintes restries se aplicam: * Tabelas do CCD Interno podem conter indicadores DATALINK, mas no valores DATALINK. * Tabelas do CCD condensado externo podem conter valores DATALINK. * Tabelas de destino do CCD no condensado no podem conter nenhuma coluna DATALINK. * Quando os servidores de origem e destino so o mesmos, o conjunto de subscrio no deve conter nenhum membro com colunas DATALINK. 15.7.3 Restries LOB Tabelas do CCD interno condensado no podem conter referncias a colunas LOB ou indicadores LOB. 15.7.4 Planejando a Replicao Na p gina 65, "Connectivity" deve incluir o seguinte fato: Se o programa Apply no pode se conectar ao control server, o programa Apply termina. Ao usar bloqueio de dados para o AS/400, voc deve garantir que a quantidade total de dados a ser replicada durante o intervalo no exceda "4 milhes de linhas", no "4 MB" como declarado na p gina 69 do manual. ------------------------------------------------------------------------ 15.8 Captulo 6. Configurando o Ambiente de Replicao 15.8.1 Pr-requisito Update-anywhere Se voc quer configurar a replicao update-anywhere com deteco de conflitos e com mais de 150 membros do conjunto de subscrio em um conjunto de subscrio, voc deve executar a seguinte DDL para criar a tabela ASN.IBMSNAP_COMPENSATE no control server: CREATE TABLE ASN.IBMSNAP_COMPENSATE ( APPLY_QUAL char(18) NOT NULL, MEMBER SMALLINT, INTENTSEQ CHAR(10) FOR BIT DATA, OPERATION CHAR(1)); 15.8.2 Configurando Seu Ambiente de Replicao A p gina 95, "Personalizando tabela CD, ndice e nomes da rea da tabela" informa que o arquivo DPREPL.DFT est no diretrio \sqllib\bin ou no diretrio \sqllib\java. Isso est incorreto,DPREPL.DFT est no diretrio \sqllib\cc. |Na p gina 128, a descrio do limite de reteno deve declarar que o |limite de reteno utilizado para retirar linhas apenas quando a partida |quente de Capture for iniciada ou quando voc utilizar o comando de retirada |Capture. Se voc iniciou o Capture com a opo de retirada autom tica, |ele no utilizar o limite de reteno para retirar linhas. ------------------------------------------------------------------------ 15.9 Captulo 8. Determinao de Problemas O Analisador de Replicao executa em sistemas Windows de 32 bits e no AIX. Para executar o Analisador no AIX, garanta que o diretrio sqllib/bin aparece antes de /usr/local/bin na sua vari vel de ambiente PATH para evitar conflitos com /usr/local/bin/analyze. O Analisador de Replicao possui duas palavras-chave opcionais adicionais: CT e AT. CT=n Mostra apenas as entradas da tabela de rastreio de Capture que so mais novas que n dias. Esta palavra-chave opcional. Se voc no especificar esta palavra-chave, o padro 7 dias. AT=n Mostra apenas as entradas da tabela de rastreio de Apply que so mais novas que n dias. Esta palavra-chave opcional. Se voc no especificar esta palavra-chave, o padro 7 dias. Exemplo: analyze mydb1 mydb2 f=meu-diretrio ct=4 at=2 deepcheck q=applyqual1 Para o Analisador de Replicao, as seguintes informaes sobre palavras-chave esto atualizadas: deepcheck Especifica que o Analisador realiza uma an lise mais completa, incluindo as seguintes informaes: informaes de eliminao das tabelas CD e UOW, detalhes de compresso e particionamento das reas da tabela do DB2 para OS/390, an lise de ndices de destino com respeito s chaves de subscrio, timelines de subscrio, e erros de instrues SQL do conjunto de subscries. A an lise inclui todos os servidores. Esta palavra-chave opcional. lightcheck Especifica que as seguintes informaes esto excludas do relatrio: todos os detalhes de colunas da tabela ASN.IBMSNAP_SUBS_COLS, erros de subscrio ou anomalias ou omisses, e ndices incorretos ou ineficientes. Esta reduo de informaes economiza recursos e produz um arquivo de sada HTML menor. Esta palavra-chave opcional e mutuamente exclusiva palavra-chave deepcheck. As ferramentas do analisador esto disponveis em PTFs de replicao em plataformas AS/300. Estas ferramentas coletam informaes sobre seu ambiente de replicao e produzem um arquivo HTML que pode ser enviado para seu Representante de Servios IBM para ajudar na determinao do problema. Para obter as ferramentas do AS/400, faa o download da PTF apropriada (por exemplo, para o produto 5769DP2, voc precisa obter a PTF SF61798 ou sua substituio mais recente). Inclua o seguinte problema/soluo seo "Soluo de Problemas": Problema: O programa Apply entra em loop sem replicar as alteraes; a tabela de rastreio Apply mostra STATUS=2. A conjunto de assinaturas inclui v rias tabelas de origem. Para melhorar os pontos de acesso de uma tabela de origem do conjunto, uma tabela CCD interna definida para a tabela de origem, mas em um conjunto de assinatura diferente. So feitas atualizaes na tabela de origem, mas o processo Apply que ocupa a tabela CCD interna executado de forma assncrona (por exemplo, o programa Apply pode no ser iniciado ou um evento pode no ser disparado, e assim por diante). O programa Apply que replica atualizaes da tabela de origem para a tabela de destino entra em loop porque est aguardando que a tabela CCD interna seja atualizada. Para parar o loop, inicie o programa Apply (ou dispare o evento que causa a replicao) para a tabela CCD interna. O programa Apply ocupar a tabela CCD interna e permitir que o programa Apply em loop processe as alteraes a partir de todas as tabelas de origem. Uma situao similar pode ocorrer para um conjunto de assinaturas que contm tabelas de origem com tabelas CCD internas que esto ocupadas por v rios programas Apply. ------------------------------------------------------------------------ 15.10 Captulo 9. Capture e Apply para AS/400 Na p gina 178, "A note on work management" deve ser lida da seguinte maneira: Voc pode alterar as definies padro ou fornecer suas prprias definies. Se voc criar sua prpria descrio de subsistema, voc deve nomear o subsistema QZSNDPR e cri -lo em uma biblioteca diferente de QDPR. Consulte "OS/400 Work Management V4R3", SC41-5306 para mais informaes sobre a alterao destas definies. Inclua o seguinte na p gina 178, "Verifying and customizing your installation of DB2 DataPropagator for AS/400": Se ocorrerem problemas com a conteno de bloqueio devido ao alto volume de transaes, voc pode aumentar o valor do tempo limite de espera padro de 30 para 120. Voc pode alterar o job sempre que o job Capture iniciar ou pode utilizar o seguinte procedimento para alterar o valor do tempo limite de espera padro para todos os jobs que estiverem sendo executados em seu subsistema: 1. Emita o seguinte comando para criar um novo objeto de classe, duplicando QGPL/QBATCH: CRTDUPOBJ OBJ(QBATCH) FROMLIB(QGPL) OBJTYPE(*CLS) TOLIB(QDPR) NEWOBJ(QZSNDPR 2. Altera o valor do tempo limite de espera para a nova classe criada (por exemplo, para 300 segundos): CHGCLS CLS(QDPR/QZSNDPR) DFTWAIT(300) 3. Atualize a entrada de roteamento na descrio QDPR/QZSNDPR do subsistema para utilizar a nova classe criada: CHGRTGE SBSD(QDPR/QZSNDPR) SEQNBR(9999) CLS(QDPR/QZSNDPR |Na p gina 194, "Utilizando a rotina de sada do receptor de di rio |de excluso" incluir esta sentena: Se voc remover o registro da |rotina de sada do receptor de di rio de excluso, certifique-se de que todos |os di rios utilizados para as tabelas de origem tenham |DLTRCV(*NO). Na p gina 195, os parmetros do comando ADDEXITPGM deveriam ser: ADDEXITPGM EXITPNT(QIBM_QJO_DLT_JRNRCV) FORMAT(DRCV0100) PGM(QDPR/QZSNDREP) PGMNBR(*LOW) CRTEXITPNT(*NO) PGMDTA(65535 10 QSYS) ------------------------------------------------------------------------ 15.11 Captulo 10. Capture e Apply para OS/390 No Captulo 10, os seguintes par grafos so atualizados: |15.11.1 Pr-requisitos para DB2 DataPropagator para OS/390 |Voc deve ter o DB2 para OS/390 Verso 5, o DB2 para OS/390 Verso 6 ou o |DB2 para OS/390 Verso 7 para executar o DB2 DataPropagator para OS/390 Verso |7 (V7). |15.11.2 Esquemas de Codificao do UNICODE e ASCII no OS/390 |O DB2 DataPropagator para OS/390 V7 suporta esquemas de codificao UNICODE |e ASCII. Para explorar os novos esquemas de codificao, voc deve ter |o DB2 para OS/390 V7 e deve criar ou converter manualmente as tabelas de |origem, de destino e de controle do DB2 DataPropagator conforme descrito nas |sees a seguir. Entretanto, o ambiente de replicao existente |funcionar com o DB2 DataPropagator para OS/390 V7 mesmo se voc no modificar |quaisquer esquemas de codificao. |15.11.2.1 Escolhendo um Esquema de Codificao |Se as tabelas de origem, de CD e de destino utilizarem o mesmo esquema de |codificao, voc poder minimizar a necessidade para converses de dados em |seu ambiente de replicao. Quando voc escolher os esquemas de |codificao para as tabelas, siga a nica regra do CCSID: Os dados de |caracteres em uma rea de tabela podem ser codificados em ASCII, UNICODE ou |EBCDIC. Todas as tabelas dentro de uma rea de tabela devem utilizar o |mesmo esquema de codificao. O esquema de codificao de todas as |tabelas em uma instruo SQL deve ser o mesmo. Alm disso, todas as |tabelas que voc utiliza em exibies e junes devem utilizar o mesmo esquema |de codificao. |Se voc no seguir a nica regra do CCSID, o DB2 detectar a violao e |retornar o SQLCODE -873 durante a ligao ou a execuo. Quaisquer |tabelas que devem ser ASCII ou UNICODE dependem da configurao do |cliente/servidor. Especificamente, siga essas regras quando voc optar |por codificar os esquemas para as tabelas: | * |As tabelas de origem e de destino no DB2 para OS/390 podem ser EBCDIC, |ASCII ou UNICODE. Elas podem ser copiadas de ou para as tabelas que tm |o mesmo ou diferente esquema de codificao em qualquer DBMS suportado |(famlia do DB2 ou no-DB2 com DataJoiner). * |Em um servidor de origem DB2 para OS/390, todas as tabelas de controle do |CD, do UOW, de registro e de retirada no mesmo servidor devem utilizar o mesmo |esquema de codificao. Para garantir essa consistncia, especifique |sempre explicitamente o esquema de codificao. * |Todas as tabelas de controle (ASN.IBMSNAP_SUBS_xxxx) no mesmo |control server devem utilizar o mesmo esquema de codificao. * |Outras tabelas de controle podem utilizar qualquer esquema de |codificao; entretanto, recomenda-se que a tabela |ASN.IBMSNAP_CRITSEC permanea EBCDIC. | |15.11.2.2 Definindo Esquemas de Codificao |Para especificar o esquema de codificao correto para as tabelas, |modifique o SQL que utilizado para gerar as tabelas: | * |Crie novas tabelas de origem e de destino com o esquema de codificao |correto ou altere os esquemas de codificao das tabelas de destino e de |origem existentes. Recomenda-se que voc p re os programas Capture e |Apply antes de alterar o esquema de codificao de tabelas existentes e, |posteriormente, que voc inicialize a frio o programa Capture e reinicie o |programa Apply. para alterar o esquema de codificao de tabelas |existentes: | 1. |Use o utilit rio Reorg para copiar a tabela existente. 2. |Elimine a tabela existente. 3. |Recrie a tabela especificando o novo esquema de codificao. 4. |Use o utilit rio Load para carregar os dados antigos na nova |tabela. | |Consulte a publicao DB2 Universal Database |for OS/390 Utility Guide and Reference para obter mais informaes sobre |os utilit rios Load e Reorg. * |Crie novas tabelas de controle com o esquema de codificao correto ou |modifique o esquema de codificao para aqueles existentes. |DPCNTL.MVS enviado com o DB2 para OS/390 no |sqllib\samples\repl e ele contm v rias instrues CREATE TABLE que |criam as tabelas de controle. Para aquelas tabelas que precisam ser |ASCII ou UNICODE (por exemplo, ASN.IBMSNAP_REGISTER e |ASN.IBMSNAP_PRUNCNTL), inclua a palavra-chave CCSID ASCII ou CCSID |UNICODE, conforme mostrado no exemplo a seguir. |CREATE TABLE ASN.IBMSNAP_PRUNCNTL ( | TARGET_SERVER CHAR( 18) NOT NULL, | TARGET_OWNER CHAR( 18) NOT NULL, | TARGET_TABLE CHAR( 18) NOT NULL, | SYNCHTIME TIMESTAMP, | SYNCHPOINT CHAR( 10) FOR BIT DATA, | SOURCE_OWNER CHAR( 18) NOT NULL, | SOURCE_TABLE CHAR( 18) NOT NULL, | SOURCE_VIEW_QUAL SMALLINT NOT NULL, | APPLY_QUAL CHAR( 18) NOT NULL, | SET_NAME CHAR( 18) NOT NULL, | CNTL_SERVER CHAR( 18) NOT NULL, | TARGET_STRUCTURE SMALLINT NOT NULL, | CNTL_ALIAS CHAR( 8) | ) CCSID UNICODE |DATA CAPTURE CHANGES IN TSSNAP02; |Para modificar as tabelas de controle e do CD existentes, utilize os |utilit rios Reorg e Load. * |Quando voc cria novas origens de replicao ou conjuntos de assinatura, |modifique o arquivo SQL gerado pela ferramenta de administrao para |especificar o esquema de codificao correto. O SQL possui v rias |instrues CREATE TABLE que so utilizadas para criar as tabelas de CD e de |destino para origem de replicao e conjunto de assinatura, |respectivamente. Inclua a palavra-chave CCSID ASCII ou CCSID UNICODE |onde apropriado. Por exemplo: |CREATE TABLE user1.cdtable1 ( | employee_name varchar, | employee_age decimal | ) CCSID UNICODE; |A publicao DB2 UDB for OS/390 SQL Reference contm mais |informaes sobre o CCSID. | ------------------------------------------------------------------------ 15.12 Captulo 11. Capture e Apply para plataformas UNIX |15.12.1 Definindo Vari veis de Ambiente para Capture e Apply no UNIX e Windows |Se voc criou o banco de dados de origem com uma p gina de cdigos |diferente do valor da p gina de cdigos padro, defina a vari vel de ambiente |DB2CODEPAGE para essa p gina de cdigos. Consulte a publicao |Manual de Administrao do DB2 para obter informaes sobre a |derivao de valores da p gina de cdigos antes de definir o |DB2CODEPAGE. Capture deve ser executado na mesma p gina de cdigos que |o banco de dados para o qual ele est capturando dados. O DB2 deriva a |p gina de cdigos Capture do ambiente ativo, onde Capture est sendo |executado. Se DB2CODEPAGE no estiver definido, o DB2 derivar o valor |da p gina de cdigos do sistema operacional. O valor derivado do |sistema operacional estar correto para Capture, se voc utilizou a p gina de |cdigos padro ao criar o banco de dados. ------------------------------------------------------------------------ 15.13 Captulo 14. Estruturas de Tabelas Na p gina 339, inclua a seguinte sentena descrio da coluna STATUS para o valor "2": Se voc utilizar tabelas CCD internas e obter repetidamente um valor igual a "2" na coluna de status da tabela de rastreio Apply, v para o "Captulo 8: Determinao de Problemas" e consulte "Problema: O programa Apply entra em loop sem replicar alteraes, a tabela de rastreio Apply mostra STATUS=2". ------------------------------------------------------------------------ 15.14 Captulo 15. Mensagens de Capture e Apply |A mensagem ASN0017E deve ser lida: |ASN0017E |O programa Capture encontrou um erro interno grave e no pde emitir |a mensagem de erro correta. O nome da rotina "rotina". O |cdigo de retorno "cdigo de _retorno". A mensagem ASN1027S deve ser includa: ASN1027S Existem muitas colunas de LOB (large object) especificadas. O cdigo de erro "". Explicao: Muitas colunas de objetos grande (BLOB, CLOB ou DBCLOB) so especificadas para um membro do conjunto de assinaturas. O nmero m ximo de colunas permitido 10. Resposta do usu rio: Remova as colunas de objetos grandes em excesso do membro do conjunto de assinaturas. A mensagem ASN1048E deve ser lida da seguinte maneira: ASN1048E A execuo de um ciclo Apply falhou. Consulte a tabela de trilha Apply para obter os detalhes completos: "" Explicao: Um ciclo Apply falhou. Na mensagem, "" identifica "", "" e "". Resposta do usu rio: Verifique os campos APPERRM na tabela da trilha de auditoria, para determinar por que o ciclo Apply falhou. ------------------------------------------------------------------------ 15.15 Apndice A. Iniciando os Programas Capture e Apply de um Aplicativo Na p gina 399 da publicao, alguns erros aparecem nos coment rios da rotina Sample que inicia os programas Capture e Apply; no entanto, o cdigo da amostra est correto. A ltima parte da amostra pertence aos parmetros de Apply, apesar dos coment rios indicar que ela pertence aos parmetros de Capture. Voc pode obter amostras da API de Apply e Capture, e seus respectivos arquivos "make", nos seguintes diretrios: Para NT - sqllib\samples\repl Para UNIX - sqllib/samples/repl ------------------------------------------------------------------------ Manual e Referncia do System Monitor ------------------------------------------------------------------------ 16.1 db2ConvMonStream Nas Notas de Uso, a estrutura do tipo de fluxo de dados da vari vel de captura instantnea SQLM_ELM_SUBSECTION deve ser qlm_subsection. ------------------------------------------------------------------------ Manual da Soluo de Problemas ------------------------------------------------------------------------ 17.1 Iniciando o DB2 no Windows 95, Windows 98 e Windows ME quando o usu rio no iniciou sesso Para que um comando db2start seja bem sucedido em um ambiente Windows 95, Windows 98, ou Windows Millennium Edition (ME), necess rio: * Efetuar o logon utilizando a janela de logon do Windows ou a janela de logon da Rede do Windows * Emitir o comando db2logon (consulte a nota (NOTE_1) para obter informaes sobre o comando db2logon). E mais, o ID do usu rio que especificada durante o logon ou para o comando db2logon deve corresponder s exigncias do DB2 (veja a nota (NOTE2)). Quando o comando db2start inicia, ele primeiro verifica se um usu rio que efetou o logon. Se um usu rio efetuou o logon, o comando db2start usa esse ID do usu rio. Se um usu rio no efetuou o logon, o comando db2start verifica se um comando db2logon foi executado, e, se foi, o comando db2start usa o ID do usu rio que foi especificada para o comando db2logon. Se o comando db2start no puder encontrar um ID do usu rio v lida, o comando termina. Durante a instalao do DB2 Universal Database Verso 7 no Windows 95, Windows 98 e Windows ME, o software de instalao, por padro, inclui um atalho para a pasta Iniciar que executa o comando db2start quando o sistema inicializado (consulte a nota (NOTE_1) para obter maiores informaes). Se o usu rio do sistema no tiver efetuado logon nem emitido o comando db2logon, o comando db2start encerrar . Se voc ou seus usu rios no efetuam logon normalmente no Windows ou em uma rede, voc pode ocultar a exigncia de emitir o comando db2logon antes de um comando db2start executando comandos em um arquivo de lote, como a seguir: 1. Crie um arquivo em lote que emita o comando db2logon seguido pela comando db2start.exe.Por exemplo: @echo off db2logon db2local /p:password db2start cls exit 2. Nomeie o arquivo batch db2start.bat, e armazene-o no diretrio /bin que est sob a unidade e caminho onde voc instalou o DB2.Voc armazena o arquivo batch neste local para garantir que o sistema operacional pode encontrar o caminho para o arquivo batch. A unidade e o caminho onde o DB2 est instalado so armazenados na vari vel de registro do DB2, DB2PATH. Para encontrar a unidade e o caminho onde voc instalou o DB2, emita o seguinte comando: db2set -g db2path Assuma que o comando db2set retorne o valor c:\sqllib. Nesta situao, voc iria armazenar o arquivo batch da seguinte maneira: c:\sqllib\bin\db2start.bat 3. Para iniciar o DB2 quando o sistema inicializado, voc deveria executar o arquivo batch a partir de um atalho na pasta Iniciar. Voc tem duas opes: o Modifique o atalho que criado pelo programa de instalao do DB2 para executar o arquivo batch ao invs de db2start.exe. No exemplo anterior, o atalho deveria agora executar o arquivo batch db2start.bat. O atalho que criado pelo programa de instalao do DB2 chamado DB2 - DB2.lnk, e est localizado em c:\WINDOWS\Menu Iniciar\Programas\Iniciar\DB2 - DB2.lnk na maioria dos sistemas. o Inclua seu prprio atalho para executar o arquivo batch e exclua o atalho que includo pelo programa de instalao do DB2. Use o seguinte comando para excluir o atalho do DB2: del "C:\WINDOWS\Start Menu\Programs\Startup\DB2 - DB2.lnk" Se voc decidir usar seu prprio atalho, voc deve definir o atributo fechar ao sair para o atalho. Se voc no definir este atributo, o prompt de comando do DOS deixado na barra de tarefas mesmo depois que o comando db2start foi concludo com sucesso. Para evitar que a janela do DOS permanea aberta durante o processo de db2start, voc pode criar este atalho (e a janela do DOS em que ele executado) definido para ser executado minimizado. Nota: Como uma alternativa para iniciar o DB2 durante a inicializao do sistema, o DB2 pode ser iniciado antes da execuo de qualquer aplicativo que utiliza o DB2. Consulte a nota (NOTE5) para detalhes. Se voc usar um arquivo batch para emitir o comando db2logon antes do comando db2start ser executado, e seus usu rios ocasionalmente efetuam logon, o comando db2start continuar trabalhando, a nica diferena que o DB2 usar o ID de usu rio do usu rio logado. Consulte a nota (NOTE_1) para detalhes adicionais. Notas: 1. O comando db2logon simula um logon de usu rio.O formato do comando db2logon : db2logon userid /p:password O ID do usu rio especificada no comando deve satisfazer as exigncias de nomeao do DB2 (consulte a nota (NOTE2) para mais informaes). Se o comando for emitido sem um ID do usu rio e senha, uma janela aberta para solicitar ao usu rio a fornecer o ID do usu rio e senha. Se o nico parmetro fornecido for um ID do usu rio, o usu rio no ser perguntado por uma senha; sob certas condies, uma senha ser exigida, como descrito abaixo. Os valores do ID do usu rio de da senha que so definidos pelo comando db2logon s so utilizados se a o usu rio no efetuar logon atravs da janela de logon do Windows ou da janela de logon da Rede do Windows. Se o usu rio efetuou o logon, e um comando db2logon foi emitido, o ID do usu rio do comando db2logon ser utilizado para todas as aes do DB2, mas a senha especificada no comando db2logon ser ignorada. Quando o usu rio no tiver efetuado logon na janela de logon do Windows ou na janela de logon da Rede do Windows, o ID do usu rio e a senha fornecidas atravs do comando db2logon so usadas da seguinte maneira: o O comando db2start usa o ID do usu rio ao ser iniciado e no requer uma senha. o Na ausncia de um qualificador de alto nvel para aes como a criao de uma tabela, o ID do usu rio utilizado como o qualificador de alto nvel. Por exemplo: 1. Se voc emitir o seguinte: db2logon db2local 2. E depois emitir o seguinte: create table tab1 A tabela criada com um qualificador de alto nvel db2local.tab1. Voc deve usar um ID do usu rio que seja igual ao nome do esquema das suas tabelas e outros objetos. o Quando o sistema age como um cliente de um servidor, e o usu rio emite uma instruo CONNECT sem um ID do usu rio e uma senha (por exemplo, CONNECT TO TEST) e a autenticao est definida como servidor, o ID do usu rio e a senha do comando db2logon so usadas para validar o usu rio no servidor remoto. Se o usu rio se conecta com um ID do usu rio e uma senha explcitas (por exemplo, CONNECT TO TEST USER ID do usu rio USING senha), os valores que so especificados para a instruo CONNECT so usados. 2. Na Verso 7, o ID do usu rio usado para efetuar o logon ou especificado para o comando db2logon deve atender aos seguintes requisitos do DB2: o No pode ser qualquer das seguintes: USERS, ADMINS, GUESTS, PUBLIC, LOCAL, ou qualquer palavra reservada do SQL que esteja listada na SQL Reference. o No pode comear com: SQL, SYS ou IBM o Os caracteres podem incluir: + A a Z (Windows 95, Windows 98 e Windows ME suportam IDs do usu rio com distino entre maisculas e minsculas) + 0 a 9 + @, #, ou $ 3. Voc pode prevenir a criao do atalho db2start na pasta Iniciar durante uma instalao interativa personalizada, ou se voc estiver realizando uma instalao de arquivo de respostas e especificar a opo DB2.AUTOSTART=NO.Se voc usar estas opes, no haver um atalho db2start na pasta Iniciar, e voc dever incluir seu prprio atalho para executar o arquivo db2start.bat. 4. No Windows 98 e no Windows ME est disponvel uma opo que voc pode utilizar para especificar um ID do usu rio que sempre inicia sesso quando o Windows 98 ou o Windows ME iniciado. Nesta situao, a janela de logon do Windows no aparecer . Se voc usar esta opo, o usu rio inicia sesso e o comando db2start ser bem-sucedido se o ID do usu rio corresponder s exigncias do DB2 (consulte a nota (NOTE2) para obter detalhes). Se voc no usar esta opo, o usu rio ser sempre solicitado com uma janela de logon. Se o usu rio cancelar esta janela sem efetuar logon, o comando db2start ir falhar a no ser que o comando db2logon tenha sido previamente emitido, ou chamado pelo arquivo batch, como descrito acima. 5. Se voc no iniciar o DB2 durante uma inicializao do sistema, o DB2 pode ser iniciado por um aplicativo. Voc pode executar o arquivo db2start.bat como parte da inicializao de aplicativos que utilizam o DB2.Utilizando este mtodo, o DB2 somente ser iniciado quando o aplicativo que ir utiliz -lo for iniciado. Quando o usu rio sai do aplicativo, um comando db2stop pode ser emitido para interromper o DB2.Seus aplicativos de negcios podem iniciar o DB2 desta maneira, se o DB2 no for iniciado durante a inicializao do sistema. Para utilizar o aplicativo DB2 Synchronizer ou chamar as APIs de sincronizao a partir de seu aplicativo, o DB2 deve ser iniciado se os scripts que so baixados para execuo contm comandos que operam contra uma instncia local ou um banco de dados local. Estes comandos podem estar em scripts de banco de dados, scripts de instncia, ou embutidos em scripts do sistema operacional (SO). Se um script do SO no contm comandos do Processador da Linha de Comandos ou APIs do DB2 que usam uma instncia ou um banco de dados, ele pode ser executado sem o DB2 estar iniciado. Como pode ser difcil dizer antecipadamente que comandos sero executados a partir de seus scripts durante o processo de sincronizao, o DB2 deve normalmente ser iniciado antes da sincronizao comear. Se voc estiver chamando o comando db2sync ou as APIs de sincronizao a partir de seus aplicativos, voc deve iniciar o DB2 durante a inicializao do seu aplicativo.Se seus usu rios forem estar utilizando o atalho do DB2 Synchronizer na pasta DB2 para Windows para iniciar a sincronizao, o atalho do DB2 Synchronization deve ser modificado para executar um arquivo db2sync.bat. O arquivo batch deve conter os seguintes comandos para garantir que o DB2 esteja sendo executado antes da sincronizao comear: @echo off db2start.bat db2sync.exe db2stop.exe cls exit Neste exemplo, assume-se que o arquivo db2start.bat chama os comandos db2logon e db2start como descrito acima. Se voc decidir iniciar o DB2 quando o aplicativo iniciar, garanta que a instalao do DB2 no inclua um atalho na pasta Iniciar para iniciar o DB2. Consulte a nota (NOTE3) para detalhes. ------------------------------------------------------------------------ |17.2 Captulo 1. Pr ticas Recomend veis para Deteco de Problemas |17.2.1 Ferramenta de An lise de Problemas e Coleta de Ambiente |H um utilit rio que ajudar voc a identificar algumas das informaes |associadas ao problema e coletar outras informaes relevantes para ajudar o |DB2 Customer Support a compreender o ambiente e seu problema. Muitas |das informaes coletadas com este utilit rio so descritas no restante deste |captulo. O utilit rio db2support. |Detalhes sobre a sintaxe e opes de linha de comandos podem ser |encontrados na publicao Referncia de |Comandos. |A finalidade do utilit rio coletar dados de ambiente sobre a m quina |cliente ou servidor que est executando o DB2 e, em seguida, coletar e |empacotar uma grande parte da sada como XML, HTML ou um archive de arquivo |compactado naveg vel. O utilit rio tambm possui uma opo que permite |a coleta de alguns dados sobre a natureza do problema, utilizando um processo |interativo de pergunta e resposta. Esse processo ajudar a esclarecer o |problema e tambm fornecer informaes para o DB2 Customer Support quando |voc entrar em contato com eles para relatar o problema. |Nota: Um cliente fino ou de run-time no pode usar este utilit rio. O |utilit rio requer que o cliente tenha as bibliotecas de mecanismo do DB2 |instaladas. | |17.2.1.1 Sadas de Coleta |O utilit rio produz uma coleta compactada (archive de arquivo simples) de |informaes importantes do sistema de banco de dados. Esse archive |contm um relatrio HTML das informaes mais essenciais, que voc pode |utilizar para exibir as informaes. |Por padro, db2support no coletar dados de tabela, esquema (DDL) ou logs |para proteger a segurana e sensibilidade dos dados do cliente. Com |algumas opes, o usu rio pode optar por incluir aspectos de seu esquema e |dados (como incluir logs arquivados). Opes que exponham o esquema ou |dados do banco de dados devem ser utilizadas cautelosamente. Quando |db2support for chamado, ser exibida uma mensagem indicando como os dados |sensveis so tratados. |A seguir so mostrados os arquivos a serem coletados e compactados em um |nico archive: |Coletados sob todas as condies | 1. |db2diag.log 2. |Todos os arquivos de trap 3. |Arquivos de lista de travas (com -d) 4. |Arquivos de dump 5. |Sada de usu rio (com -d) 6. |Arquivos de controle do conjunto de buffers e da rea de tabela (SPCS) |(com -d) 7. |V rios arquivos relacionados ao sistema 8. |Sada dos v rios comandos do sistema 9. |Config do db (com -d) 10. |Arquivos de config dbm 11. |Arquivo de Cabealho do Arquivo de Log (com -d) 12. |Arquivo de Histrico de Recuperao 13. |db2cli.ini | |Coletados opcionalmente | 1. |Arquivos de log ativos 2. |Contedo do diretrio db2dump (isto , o que no foi coletado acima) 3. |Arquivos de ncleo (-a para todos os arquivos de ncleo, -r somente para o |arquivo de ncleo mais recente) 4. |Informaes estendidas do sistema (-s) | |Os arquivos a seguir constituem o contedo do relatrio HTML: |Coletados sob todas as condies | 1. |Nmero de PMR, se algum existir (se -n tiver sido especificado). 2. |Sistema operacional e nvel (por ex., AIX |4.2.1). 3. |Informaes sobre o release do DB2. 4. |Informaes sobre o cabealho da biblioteca do mecanismo. 5. |Deteco de 32 ou 64 bits 6. |Informaes sobre o caminho de instalao do DB2. 7. |Para contedo de relatrio EEE do db2nodes.cfg 8. |Quantas CPUs, discos e quantidade de memria. 9. |Lista de bancos de dados nesta instncia. 10. |Informaes de registro e ambiente, incluindo caminho & |libpath. 11. |Espao livre em disco para o sistema de arquivos atual e inodes para |Unix. 12. |Nvel de JDK. 13. |Config do dbm. 14. |Listagem do arquivo de histrico de recuperao do banco de dados. 15. |'ls -lR' (ou equivalente no Windows) do diretrio sqllib. 16. |LISTAR DIRETRIO DE N 17. |LISTAR DIRETRIO DE N ADMIN 18. |LISTAR DIRETRIO DCS 19. |LISTAR APLICATIVOS DCS ESTENDIDOS 20. |Lista de todos os softwares instalados. | |Coletados se '-s' for especificado | 1. |Informaes detalhadas sobre o disco (layout da partio, tipo, |informaes sobre LVM, etc.) 2. |Informaes detalhadas de rede 3. |Estatsticas de kernel 4. |Verses de firmware 5. |Outros comandos especficos da plataforma | |Coletados se o DB2 tiver sido iniciado | 1. |Estado de conexo do cliente 2. |Config do db/dbm (db cfg requer a opo -d) 3. |Config da CLI 4. |Informaes do conjunto de memria (tamanho e consumo). Dados |completos se a opo -d for utilizada. 5. |LISTAR BANCOS DE DADOS ATIVOS 6. |LISTAR GERENCIADORES DE DATALINKS 7. |LISTAR APLICATIVOS DCS | |Coletados se -c tiver sido especificado e uma conexo com o |banco de dados puder ser feita | 1. |Nmero de tabelas do usu rio 2. |Tamanho aproximado dos dados do DB 3. |Instantneo do banco de dados 4. |Instantneo do aplicativo 5. |Informaes sobre o conjunto de buffers 6. |LISTAR APLICATIVOS 7. |LISTAR OPÞES DE COMANDO 8. |LISTAR DIRETRIO DE BANCO DE DADOS 9. |LISTAR TRANSAÞES DUVIDOSAS 10. |LISTAR GRUPOS DE NS 11. |LISTAR NS 12. |LISTAR ORIGENS DE DADOS DO ODBC 13. |LISTAR PACOTES/TABELAS 14. |LISTAR CONTINERES DE TABLESPACE 15. |LISTAR TABLESPACES 16. |LISTAR DRDA EM TRANSAÞES DUVIDOSAS | |Se '-q' for especificado, coletar o seguinte |O modo interativo de pergunta e resposta iniciado. Com exceo de |uma pergunta "descreva seu problema" opcional e um pequeno nmero de pedidos |de informaes do cliente, todas as perguntas tero respostas de mltipla |escolha a partir das quais possvel fazer uma seleo. Todas as |perguntas, incluindo perguntas de acompanhamento, e as respostas sero |coletadas. Em alguns casos, o utilit rio solicitar que voc execute |uma tarefa e coloque os resultados dessa tarefa em um diretrio |adicional. Uma pequena rvore de deciso utilizada durante o modo |interativo para determinar as perguntas a serem feitas. Essas perguntas |interativas ajudam a determinar a categoria do problema e, com base na |categoria, outras perguntas relevantes podero ser feitas e dados adicionais |podero ser coletados. No final das perguntas, quaisquer dados que |tenham sido coletados no modo autom tico tambm sero coletados. As |respostas a todas as perguntas so armazenadas em preparao para serem |enviadas para servio, juntamente com os dados coletados no modo |autom tico. |17.2.1.2 Exibindo o detailed_system_info.html |Se voc estiver executando o db2support em uma instalao no-ingls e |estiver tendo dificuldades em exibir corretamente o |detailed_system_info.html, poder ser necess rio utilizar o Internet |Explorer verso 5 ou posterior com a codificao do DOS. Para alterar a |codificao, selecione Exibir --> Codificao --> Europa |Central (DOS). Se voc ainda no tiver o suporte codificao |obrigatrio, o Internet Explorer solicitar que voc faa download dos |arquivos necess rios no site de Atualizaes da Microsoft na Web. Essas |informaes no aplicam-se aos idiomas de byte duplo (Chins Simplificado, |Chins Tradicional, Japons e Coreano). |17.2.1.3 Exibindo a Sintaxe da Ferramenta de Suporte ao DB2, Uma P gina por Vez |Para exibir a sintaxe da Ferramenta de Suporte ao DB2, uma p gina por vez, |execute o seguinte comando: |db2support | more ------------------------------------------------------------------------ |17.3 Captulo 2. Detectando Problemas no DB2 Universal Database Server | | | |Na seo "Bloqueio de Interbloqueios", na subseo "Aplicativos |Lentos ou que Parecem Interrompidos", altere a descrio em "Esperas de |bloqueios ou interbloqueios no so causados pelo prximo bloqueio da |chave" para : |Prximo bloqueio da chave garante o nvel de isolamento de |Leitura Repetida (RR) bloqueando automaticamente a prxima chave para todas as |instrues INSERT e DELETE e o prximo valor chave superior acima do resultado |definido para as instrues SELECT. Para as instrues UPDATE que |alteram as partes da chave de um ndice, a chave do ndice original excluda |e o novo valor da chave inserido. O prximo bloqueio da chave feito |na insero e na excluso da chave. requerido garantir o ANSI e o |SQL92 padro RR e o DB2 padro. |Examine as informaes instantneas para o aplicativo. Se parecer |que o problema com o prximo bloqueio da chave, voc poder ativar a opo |DB2_RR_TO_RS, se nenhum de seus aplicativos contarem com a Leitura Repetida |(RR) e se for aceit vel para varreduras saltarem excluses |no-consolidadas. |Quando o DB2_RR_TO_RS est ativado, o procedimento do RR no pode ser |garantido para varreduras em tabelas do usu rio porque o bloqueio da chave no | feito durante a insero e a excluso da chave do ndice. As tabelas |de cat logos no so afetadas por esta opo. |A outra alterao no procedimento que com o DB2_RR_TO_RS ativado, as |varreduras saltaro linhas que foram excludas mas no consolidadas, embora a |linha pode ter sido qualificada para a varredura. |Por exemplo, considere o cen rio onde a transao A exclui a linha com |coluna1=10 e a transao B executa uma varredura onde coluna1>8 e |coluna1<12. |Com DB2_RR_TO_RS desligado, a transao B aguardar a transao A |consolidar ou retroceder. Se ela retroceder, a linha com a coluna1=10 |ser includa no conjunto de resultados da consulta da transao B. |Com DB2_RR_TO_RS ativado, a transao B no aguardar a transao A |consolidar ou retroceder. Ela receber imediatamente resultados da |consulta que no incluem a linha excluda. |No utilize esta opo se voc requer o ANSI e SQL92 padro RR ou se voc |no quiser varreduras para saltar as excluses no-consolidadas. ------------------------------------------------------------------------ |17.4 Captulo 8. Detectando Problemas no DB2 Data Links Manager |No FixPak 2 da Verso 7, uma mensagem de aviso SQL1179W gerada pelo |servidor durante a pr-compilao de um arquivo de origem ou vinculao de um |arquivo de ligao sem especificar um valor para a opo FEDERATED. A |mesma mensagem gerada quando o arquivo de origem ou arquivo de ligao |inclui referncias da SQL est tica para um pseudnimo. Existem duas |excees: | * |Para clientes com uma verso de FixPak anterior Verso 7 do FixPak 2 ou |para clientes de nvel inferior, a API sqlaprep() no relatar esse aviso |SQL1179W no arquivo de mensagem. O comando PRECOMPILE do Processador de |Linha de Comandos tambm no exibir o aviso nesse caso. * |Para clientes com uma verso de FixPak anterior Verso 7 do FixPak 2 ou |para clientes de nvel inferior, a API sqlabndx no relatar esse aviso |SQL1179W no arquivo de mensagem. No entanto, o arquivo de mensagem |tambm inclui incorretamente uma mensagem SQL0092N que indica que nenhum |pacote foi criado. Isso no est correto, pois o pacote foi |criado. O comando BIND do Processador de Linha de Comandos retorna o |mesmo aviso incorreto. | ------------------------------------------------------------------------ Utilizando o DB2 Universal Database em Plataformas de 64 bits ------------------------------------------------------------------------ 18.1 Captulo 5. Configurao 18.1.1 LOCKLIST As informaes a seguir devem ser includas na Tabela 2. Parmetro Limite superior anterior Limite superior atual LOCKLIST 60000 524288 18.1.2 shmsys:shminfo_shmmax Os usu rios do DB2 no sistema operacional Solaris de 64 bits devem aumentar o valor de "shmsys:shminfo_shmmax" em /etc/system, se necess rio, para ser possvel alocar um conjunto de memria compartilhada grande do banco de dados. A publicao DB2 for UNIX Iniciao R pida recomenda a definio desse parmetro em "90% da memria fsica RAM na m quina, em bytes".Esta recomendao tambm v lida para implementaes de 64 bits. Contudo, existe um problema com a seguinte recomendao na publicao DB2 for UNIX Iniciao R pida: Para sistemas de 32 bits com mais de 4 GB de RAM (at 64 GB no total possvel no sistema operacional Solaris), se um usu rio definir o valor shmmax com um nmero maior que 4 GB e estiver utilizando um kernel de 32 bits, o kernel enxergar somente os 32 bits mais baixos do nmero, resultando, s vezes, por vezes, em um valor muito pequeno para shmmax. ------------------------------------------------------------------------ 18.2 Captulo 6. Restries No existe atualmente suporte de LDAP para sistemas operacionais de 64 bits. No possvel criar bancos de dados de 32 e 64 bits no mesmo caminho. Por exemplo, se um banco de dados de 32 bits existir em , ento: db2 create db em Se emitido de uma instncia de 64 bits, falhar com "SQL10004C Ocorreu um erro de E/S durante o acesso ao diretrio do banco de dados." ------------------------------------------------------------------------ Administrao e Programao do XML Extender As Notas de Release para o IBM DB2 XML Extender podem ser encontradas no site na Web DB2 XML: http://www.ibm.com/software/data/db2/extenders/xmlext/library.html ------------------------------------------------------------------------ |MQSeries |Esta seo descreve como o DB2 e o MQSeries podem ser utilizados para |construir aplicativos que combinam acesso a mensagens e ao banco de |dados. O foco nesta seo ser um conjunto de funes, semelhantes s |UDFs (User-Defined Functions), que podem ser opcionalmente ativadas no DB2 |Universal Database, Verso 7.2. Utilizar estas funes b sicas, | possvel para suportar um grande intervalo de aplicativos, da simples |notificao de eventos para armazenamento de dados. |Para obter mais informaes sobre os aplicativos de armazenamento, consulte |a atualizao mais recente da publicao Data Warehouse Center Administration |Guide, que pode ser obtida em http://www.ibm.com/software/data/db2/udb/winos2unix/support. ------------------------------------------------------------------------ |20.1 Instalao e Configurao das Funes do DB2 MQSeries |Esta seo descreve como configurar um ambiente DB2 para utilizar as |Funes do DB2 MQSeries. Na concluso bem-sucedida do procedimento a |seguir, voc conseguir utilizar as Funes do DB2 MQSeries do SQL. Uma |descrio dessas funes podem ser encontradas na seo Referncia de SQL das |Notas sobre o Release. |O procedimento b sico para configurao e ativao das Funes do DB2 |MQSeries : | 1. |Instale o MQSeries. 2. |Instale o MQSeries AMI. 3. |Ative e configure as Funes do DB2 MQSeries. | |Alm disso, para utilizar as capacidades publicar/associar fornecidas pelas |Funes do DB2 MQSeries, voc tambm deve instalar o MQSeries Integrator ou o |MQSeries Publish/Subscribe Functions. As informaes sobre o MQSeries |Integrator podem ser encontradas em http://www.ibm.com/software/ts/mqseries/integrator. |As informaes sobre o recurso do MQSeries Publish/Subscribe podem ser |encontradas em http://www.ibm.com/software/ts/mqseries/txppacs |na categoria 3. |20.1.1 Instalar o MQSeries |A primeira etapa assegurar que, no mnimo, a Verso 5.1 do |MQSeries com o FixPak mais recente esteja instalado no seu servidor |DB2. Se essa verso do MQSeries j estiver instalada, passe para a |prxima etapa, "Instalar o MQSeries AMI." O DB2 Verso 7.2 |inclui uma cpia do servidor MQSeries a ser utilizada com o DB2. As |instrues especficas da plataforma para instalao do MQSeries ou para |atualizao de uma instalao existente do MQSeries podem ser encontradas na |publicao Quick Beginnings especfico da plataforma em http://www.ibm.com/software/ts/mqseries/library/manuals. |Certifique-se de configurar um gerenciador de filas padro medida que voc |efetua o processo de instalao. |20.1.2 Instalar o MQSeries AMI |A prxima etapa instalar o MQSeries AMI (Application Messaging |Interface). Essa uma extenso para as interfaces de programao do |MQSeries que fornece uma separao limpa de tarefas administrativas e de |programao. As Funes do DB2 MQSeries requerem a instalao dessa |interface. Se o MQSeries AMI j estiver instalado em seu servidor DB2, |passe para a prxima etapa, "Ativar as Funes do DB2 MQSeries". Se o |MQSeries AMI no estiver instalado, voc poder fazer isso do pacote de |instalao fornecido com o DB2 7.2 ou fazendo download de uma cpia da |AMI do site MQSeries Support Pacs da web em |http://www.ibm.com/software/ts/mqseries/txppacs. A |AMI pode ser encontrada na "Categoria 3 - Extenses do Produto". |Para convenincia, fornecemos uma cpia do MQSeries AMI com o DB2. Esse |arquivo est localizado no diretrio sqllib/cfg. O nome do |arquivo dependente do sistema operacional: | AIX Verso 4.3 e superior ma0f_ax.tar.Z HP-UX ma0f_hp.tar.Z Ambiente Operacional Solaris ma0f_sol7.tar.Z Windows de 32 bits ma0f_nt.zip |Siga o processo de instalao normal da AMI conforme destacado no arquivo |readme da AMI contida na imagem de instalao compactada. |20.1.3 Ativar as Funes do DB2 MQSeries |Durante esta etapa, voc configurar e ativar um banco de dados para as |Funes do DB2 MQSeries. O enable_MQFunctions utility um |comando flexvel que primeiro verifica se o ambiente correto do MQSeries foi |configurado em seguida instale e crie uma configurao padro para as funes |do DB2 MQSeries, ative o banco de dados especificado com estas funes e |confirme se a configurao funciona. | 1. |Para Windows NT ou Windows 2000, v para a etapa 5. 2. |Definindo Grupos no UNIX: Se voc estiver ativando estas funes no |UNIX, dever primeiro incluir o propriet rio da instncia do DB2 |(freqentemente db2inst1) e o ID do usu rio associado aos UDFs limitados |(freqentemente db2fenc1) no grupo mqm do MQSeries. Isso necess rio |para as funes do DB2 para acessar o MQSeries. 3. |Definir as Vari veis de Ambiente do DB2 no UNIX: Inclua a vari vel |de ambiente AMT_DATA_PATH na lista entendida pelo DB2. Voc pode editar |o arquivo $INSTHOME/sqllib/profile.env, inclua AMT_DATA_PATH |em DB2ENVLIST. O comando db2set tambm pode ser |utilizado. 4. |Em UNIX, reinicie a instncia do banco de dados: Para as alteraes |da vari vel de ambiente se efetivarem, a instncia do banco de dados deve ser |reiniciada. 5. |Altere o diretrio para $INSTHOME/sqllib/cfg para UNIX ou |%DB2PATH%/cfg no Windows. 6. |Execute o comando enable_MQFunctions para configurar e ativar |um banco de dados para as Funes do DB2 MQSeries. Consulte 20.6, enable_MQFunctions para obter uma descrio completa desse comando. |Alguns exemplos comuns so determinados abaixo. Aps a concluso |bem-sucedida, o banco de dados especificado ter que ser ativado e a |configurao testada. 7. |Para testar estas funes utilizando o Processador da Linha de Comandos, |emita os comandos a seguir aps ter conectado-se ao banco de dados |ativado: |values DB2MQ.MQSEND('a test') |values DB2MQ.MQRECEIVE() A primeira instruo enviar a mensagem "a test" para a fila |DB2MQ_DEFAULT_Q e a segunda a receber novamente. | |Nota: Como resultado da execuo do enable_MQFunctions, um ambiente |MQSeries padro ser estabelecido. O gerenciador de filas do MQSeries |DB2MQ_DEFAULT_MQM e a fila padro DB2MQ_DEFAULT_Q ser criada. Os |arquivos amt.xml, amthost.xml e |amt.dtd sero criados, se ainda existirem no diretrio |indicado pelo AMT_DATA_PATH. Se um arquivo |amthost.xml no existir e no contiver uma definio para |connectionDB2MQ, uma linha ser includa no arquivo com as informaes |apropriadas. Uma cpia do arquivo original ser salva como |DB2MQSAVE.amthost.xml. | ------------------------------------------------------------------------ |20.2 Estilos de Mensagens do MQSeries |As funes do DB2 MQSeries suportam trs modelos de mensagens: |datagramas, publicar/associar (p/s) e pedido/resposta (p/r). |As mensagens enviadas como datagramas so enviadas para um nico destino |sem resposta esperada. No modelo p/s, um ou mais publicadores enviam |uma mensagem para um servio de publicao que distribui a mensagem para um ou |mais assinantes. O pedido/resposta semelhante ao datagrama, mas o |emissor espera receber uma resposta. ------------------------------------------------------------------------ |20.3 Estrutura da Mensagem |O prprio MQSeries no administra ou suporta nenhuma estrutura especfica |da mensagem que ele transporta. |Outros produtos, tal como MQSeries Integrator (MQSI) oferecem suporte para |mensagens formadas como cadeias C ou Cobol ou como XML. As mensagens |estruturadas no MQSI so definidas por um repositrio de mensagens. |Tipicamente, as mensagens XML tm uma estrutura de mensagens de auto-descrio |e tambm podem ser gerenciadas atravs do repositrio. As mensagens |tambm podem ser desestruturadas, requerendo o cdigo do usu rio para analisar |ou construir o contedo da mensagem. Tais mensagens, muitas vezes, so |semi-estruturadas, isto , elas utilizam posies de byte ou delimitadores |fixos para separar os campos dentro de uma mensagem. O suporte para |tais mensagens semi-estruturadas fornecido pelo Assistente Assist do |MQSeries. O suporte para mensagens XML fornecido atravs de alguns |novos recursos para o DB2 XML Extender. ------------------------------------------------------------------------ |20.4 Viso Geral Funcional do MQSeries |Um conjunto de funes do MQSeries fornecido com o DB2 UDB Verso |7.2, para permitir que instrues SQL inclua operaes de |mensagens. Isso significa que esse suporte est disponvel para |aplicativos gravados em qualquer linguagem suportada, por exemplo, C, Java, |SQL utilizando qualquer uma das interfaces do banco de dados. Todos os |exemplos mostrados abaixo so em SQL. Esse SQL pode ser utilizado de |outras linguagens de programao em todas as maneiras padro. Todos os |estilos de mensagens do MQSeries descritos acima so suportados. Para |obter mais informaes sobre as funes do MQSeries, consulte a seo |Referncia de SQL das Notas sobre o Release. |Em uma configurao b sica, um servidor MQSeries localizado na m quina |servidora do banco de dados junto com o DB2. As funes do MQSeries |esto instaladas no DB2 e fornecem acesso ao servidor MQSeries. Os |clientes do DB2 podem ser localizados em qualquer m quina acessvel para o |servidor do DB2. V rios clientes podem concorrentemente acessar as |funes do MQSeries atravs do banco de dados. Atravs das funes |fornecidas, os clientes do DB2 podem executar operaes de mensagens dentro de |instrues SQL. Essas operaes de mensagens permitem que aplicativos |do DB2 se comuniquem entre eles ou com outros aplicativos do MQSeries. |O comando enable_MQFunctions utilizado para ativar um banco de |dados DB2 para as funes do MQSeries.Ele estabelecer automaticamente |uma configurao padro simples que os aplicativos do cliente podem utilizar |sem ao administrativa adicional. Para obter uma descrio, consulte |as sees 20.6, enable_MQFunctions e 20.7, disable_MQFunctions. A configurao padro permite aos |programadores de aplicativos uma maneira r pida para introduo e uma |interface mais simples para desenvolvimento. A funcionalidade adicional |pode ser configurada incrementalmente conforme necess rio. |Exemplo 1: Para enviar uma mensagem simples utilizando a configurao |padro, a instruo SQL seria: |VALUES DB2MQ.MQSEND('mensagem simples') |Isso enviar a mensagem mensagem simples para o gerenciador de |filas e para a fila do MQSeries especificados pela configurao padro. |A AMI (Application Messaging Interface) do MQSeries fornece uma separao |limpa entre as aes de mensagens e as definies que ditam como essas aes |devem ser transportadas. Essas definies so mantidas em um arquivo de |repositrio externo e gerenciadas utilizando a ferramenta AMI |Administration. Isso torna os aplicativos da AMI simples para |desenvolver e manter. As funes do MQSeries fornecidas com o DB2 so |baseadas na interface MQSeries da AMI. A AMI suporta o uso de um |arquivo de configurao externo, chamado o Repositrio da AMI, para armazenar |as informaes de configurao. A configurao padro inclui um |Repositrio da AMI do MQSeries configurado para uso com o DB2. |Os dois conceitos de chave na AMI do MQSeries, os pontos e as polticas de |servio, so transportados nas funes do DB2 MQSeries. Um ponto de |servio um n de extremidade lgico a partir do qual uma mensagem enviada |ou recebida. No repositrio da AMI, cada ponto de servio definido |com um nome de fila e gerenciador de filas do MQSeries. As polticas |definem a qualidade de opes de servio que deve ser utilizada para uma |determinada operao de mensagens. As qualidades da chave de servio |incluem a prioridade e a persistncia da mensagem. Os pontos de servio |padro e as definies de poltica so fornecidos e podem ser utilizados pelos |desenvolvedores, para simplificar mais tarde seus aplicativos. O |exemplo 1 pode ser regravado como segue para especificar explicitamente o |ponto de servio e o nome de poltica padro: |Exemplo 2: |VALUES DB2MQ.MQSEND('DB2.DEFAULT.SERVICE', 'DB2.DEFAULT.POLICY', | 'mensagem simples') |As filas podem ser atendidas por um ou mais aplicativos no servidor, no |qual as filas e os aplicativos residem. Em muitas configuraes, v rias |filas sero definidas para suportarem aplicativos e objetivos |diferentes. Por esse motivo, muitas vezes importante definir os |pontos de servios diferentes quando criar pedidos do MQSeries. Esse |demonstrado no seguinte exemplo: |Exemplo 3: |VALUES DB2MQ.MQSEND('ODS_Input', 'mensagem simples') | |Nota: Nesse exemplo, a poltica no especificada e, dessa maneira, a poltica |padro ser utilizada. | |20.4.1 Limitaes |O MQSeries fornece a capacidade para operaes de mensagens e de bancos de |dados serem combinadas em uma nica unidade de trabalho como uma transao |atmica. Esse recurso no inicialmente suportado pelas Funes do |MQSeries no Unix e Windows. |Ao utilizar as funes de envio ou de recebimento, o comprimento m ximo de |uma mensagem do tipo VARCHAR de 4000 caracteres. O comprimento m ximo |ao enviar ou receber uma mensagem do tipo CLOB 1 MB. Esses tambm so |os tamanhos m ximos de mensagens para publicao de uma mensagem utilizando o |MQPublish. |s vezes, so necess rias funes diferentes ao se trabalhar com mensagens |CLOB e VARCHAR. Geralmente, a verso CLOB de uma funo MQ utiliza a |sintaxe idntica como seu correlativo. A nica diferena que seu nome |tem os caracteres CLOB no final. Por exemplo, o equivalente CLOB de |MQREAD MQREADCLOB. Para obter uma lista detalhada dessas funes, |consulte a seo 42.5.3, Dados CLOB Agora So Suportados nas Funes do MQSeries. |20.4.2 Cdigos de Erros |Os cdigos de retorno retornados pelas Funes do MQSeries podem ser |encontrados no Apndice B da Publicao MQSeries Application Messaging |Interface. ------------------------------------------------------------------------ |20.5 Cen rios de Utilizao |As Funes do MQSeries podem ser utilizadas em uma grande variedade de |cen rios. Essa seo reexibir alguns dos cen rios mais comuns, |incluindo as Mensagens B sicas, a Conectividade do Aplicativo e a Publicao |de Dados. |20.5.1 Mensagens B sicas |A forma mais b sica de mensagens com as Funes do MQSeries DB2 ocorre |quando todos os aplicativos do banco de dados conectam-se ao mesmo servidor do |DB2. Os cientes podem ser locais para o servidor do banco de dados ou |distribudos em um ambiente de rede. |Em um cen rio simples, o Cliente A invoca a funo MQSEND para enviar uma |cadeia definida pelo usu rio para a localizao de servio padro. As |funes do MQSeries so executadas dentro do DB2 no servidor do banco de |dados. Em algum momento posterior, o Cliente B invoca a funo |MQRECEIVE para remover a mensagem na cabea da fila definida pelo servio |padro e retorna-a para o cliente. Novamente, as funes do MQSeries |para executar esse trabalho so executadas pelo DB2. |Os clientes do banco de dados podem utilizar mensagens simples de v rias |maneiras. Alguns usos comuns para as mensagens so: | * |Coleo de dados -- As informaes so recebidas na forma de mensagens, |possivelmente, de uma ou mais diversas origens de informaes. As |origens das informaes podem ser aplicativos comerciais tais como SAP ou |aplicativos desenvolvidos na empresa. Tais dados podem ser recebidos |das filas e armazenados em tabelas do banco de dados, para processamento ou |an lise posterior. * |Distribuio da carga de trabalho -- Os pedidos de trabalho so enviados |para uma fila compartilhada por v rias instncias do mesmo aplicativo. |Quando uma instncia est pronta para executar algum trabalho, ela recebe uma |mensagem da parte superior da fila que contm um pedido de trabalho para ser |executado. Utilizando essa tcnica, v rias instncias podem |compartilhar a carga de trabalho representada por uma nica fila de pedidos |agrupados. * |Sinalizao de aplicativo -- Em uma situao onde v rios processos |colaboram, as mensagens so freqentemente utilizadas para coordenarem seus |esforos. Essas mensagens podem conter comandos ou pedidos para o |trabalho ser executado. Tipicamente, esse tipo de sinalizao |unidirecional; isto , a pessoa que inicia a mensagem no espera uma |resposta. Consulte a seo 20.5.4.1, Comunicaes de Pedido/Resposta para obter mais informaes. * |Notificao de aplicativo -- A notificao semelhante sinalizao em |que os dados so enviados de um iniciador sem expectativa de uma |resposta. Entretanto, tipicamente, a notificao contm dados sobre os |eventos de negcios que aconteceram.20.5.4.2, Publicar/Associar uma forma mais avanada de notificao. | |O cen rio a seguir estende o cen rio simples descrito acima, para |incorporar mensagens remotas. Isto , uma mensagem enviada entre a |M quina A e a M quina B. A seqncia de etapas a seguinte: | 1. |O Cliente do DB2 executa uma chamada MQSEND, especificando um servio de |destino que foi definido para representar uma fila remota na M quina B. 2. |As funes do MQSeries DB2 executam o trabalho atual do MQSeries de enviar |a mensagem. O servidor do MQSeries em uma M quina A aceita a mensagem e |garante que ela a entregar para o destino definido pela definio de ponto de |servio e pela configurao atual do MQSeries da M quina A. O servidor |determina que esta uma fila na M quina B. Ele tenta entregar a |mensagem para o servidor do MQSeries na M quina B, transparentemente, |repetindo conforme necess rio. 3. |O servidor do MQSeries na M quina B aceita a mensagem do servidor na |M quina A e a coloca na fila de destino da M quina B. 4. |Um cliente do MQSeries na M quina B solicita a mensagem na cabea da |fila. | |20.5.2 Enviando Mensagens |Utilizando MQSEND, um usu rio ou um desenvolvedor do DB2 escolhe quais |dados enviar, para onde envi -los e quando ele ser enviado. Na |indstria, este comumentemente chamado "Enviar e Esquecer," significando que |o emissor apenas envia uma mensagem, confiando nos protocolos de entrega |garantidos do MQSeries para assegurar-se de que a mensagem atinge seu |destino. Os exemplos a seguir ilustram isso. |Exemplo 4: Para enviar uma cadeia definida pelo usu rio para o ponto |de servio myPlace com a poltica highPriority: |VALUES DB2MQ.MQSEND('myplace','highPriority','test') |Aqui, a poltica highPriority refere-se a uma poltica definida no |Repositrio da AMI que define a prioridade do MQSeries para o nvel mais alto |e talvez ajusta melhor outras qualidades de servio, tal como |persistncia. |O contedo da mensagem pode ser composto de qualquer combinao legal de |dados do SQL e especificados pelo usu rio. Isso inclui funes |aninhadas, operadores e coletas. Por exemplo, determinado uma tabela |EMPLOYEE, com VARCHAR colunas LASTNAME, FIRSTNAME e DEPARTMENT, para enviar |uma mensagem que contm essas informaes para cada empregado no DEPARTMENT |5LGA voc far o seguinte: |Exemplo 5: |SELECT DB2MQ.MQSEND(LASTNAME || ' ' || FIRSTNAME || ' ' || DEPARTMENT) | FROM EMPLOYEE | WHERE DEPARTMENT = '5LGA' |Se esta tabela tambm tiver uma coluna AGE inteira, ela poder ser includa |como segue: |Exemplo 6: |SELECT DB2MQ.MQSEND | (LASTNAME || ' ' || FIRSTNAME || ' ' || DEPARTMENT|| ' ' || char(AGE)) | FROM EMPLOYEE | WHERE DEPARTMENT = '5LGA' |Se a tabela EMPLOYEE tivesse uma coluna RESUME do tipo CLOB em vez de uma |coluna AGE, uma mensagem contendo as informaes de cada funcion rio no |DEPARTMENT 5LGA poderia ser emitida com o seguinte: |Exemplo 7: | SELECT DB2MQ.MQSEND | (clob(LASTNAME) || ' ' || clob(FIRSTNAME) || ' ' || | clob(DEPARTMENT) || ' ' || RESUME)) | FROM EMPLOYEE | WHERE DEPARTMENT = '5LGA' |Exemplo 8: |Finalmente, o exemplo a seguir mostra como o contedo da mensagem pode ser |derivado utilizando qualquer expresso de SQL v lida. Dada uma segunda |tabela DEPT com as colunas VARCHAR DEPT_NO e DEPT_NAME, possvel enviar |mensagens contendo o LASTNAME e o DEPT_NAME do funcion rio: |Exemplo 8: |SELECT DB2MQ.MQSEND(e.LASTNAME || ' ' || d.DEPTNAME) FROM EMPLOYEE e, DEPT d | WHERE e.DEPARTMENT = d.DEPTNAME |20.5.3 Recuperando Mensagens |As Funes do MQSeries DB2 permitem que as mensagens sejam recebidas ou |lidas. A diferena entre a leitura e o recebimento que a leitura |retorna a mensagem na cabea de uma fila sem remov-la da fila, enquanto que |as operaes de recebimento fazem com que a mensagem seja removida da |fila. Uma mensagem recuperada utilizando uma operao de recebimento |pode apenas ser recuperada uma vez, enquanto que uma mensagem recuperada |utilizando a operao de leitura permite que a mesma mensagem seja recuperada |muitas vezes. Os exemplos a seguir demonstram isto: |Exemplo 8: |VALUES DB2MQ.MQREAD() |Esse exemplo retorna uma cadeia VARCHAR contendo a mensagem na cabea da |fila definida pelo servio padro que utiliza a qualidade de poltica de |servio padro. importante observar que se nenhuma mensagem estiver |disponvel para ser lida, um valor nulo ser retornado. A fila no |alterada por esta operao. |Exemplo 9: |VALUES DB2MQ.MQRECEIVE('Employee_Changes') |O exemplo acima mostra como uma mensagem pode ser removida da cabea da |fila definida pelo servio Employee_Changes que utiliza a poltica |padro. |Um recurso muito poderoso do DB2 a capacidade de gerar uma tabela de uma |funo definida pelo usu rio (ou fornecida pelo DB2-). Voc pode |explorar esse recurso de funo da tabela para permitir que o contedo de uma |fila seja materializado como uma tabela do DB2. O exemplo a seguir |demonstra a forma mais simples disso: |Exemplo 10: |SELECT t.* FROM tabela ( DB2MQ.MQREADALL()) t |Essa consulta retorna uma tabela que consiste em todas as mensagens na fila |definidas pelo servio padro e os metadados sobre estas mensagens. |Enquanto o destino completo da estrutura da tabela retornada definido no |Apndice, a primeira coluna reflete o contedo da mensagem e as colunas |restantes contm os metadados. Para retornar apenas as mensagens, o |exemplo pode ser regravado: |Exemplo 11: |SELECT t.MSG FROM tabela (DB2MQ.MQREADALL()) t |A tabela retornada por uma funo da tabela no diferente de uma tabela |recuperada diretamente do banco de dados. Isso significa que voc pode |utilizar essa tabela em uma grande variedade de maneiras. Por exemplo, |voc pode unir o contedo da tabela com outra tabela ou contar o nmero de |mensagens em uma fila: |Exemplo 12: |SELECT t.MSG, e.LASTNAME | FROM tabela (DB2MQ.MQREADALL() ) t, EMPLOYEE e | WHERE t.MSG = e.LASTNAME |Exemplo 13: |SELECT COUNT(*) FROM tabela (DB2MQ.MQREADALL()) t |Voc tambm pode ocultar o fato de que a origem da tabela uma fila, |atravs da criao de uma exibio em uma funo da tabela. Por |exemplo, o exemplo a seguir cria uma exibio chamada NEW_EMP na fila referida |pelo servio nomeado NEW_EMPLOYEES: |Exemplo 14: |CREATE VIEW NEW_EMP (msg) AS | SELECT t.msg FROM tabela (DB2MQ.MQREADALL()) t |Nesse caso, a exibio definida apenas com uma nica coluna que contm |uma mensagem inteira. Se as mensagens so apenas estruturadas, para a |instncia que contm dois campos de comprimento fixo, correto utilizar as |funes incorporadas do DB2 para analisar a mensagem nas duas colunas. |Por exemplo, se voc souber que as mensagens enviadas para uma fila especfica |sempre contm um sobrenome de 18 caracteres seguido de um primeiro nome de 18 |caracteres, voc poder definir uma exibio que contm cada campo como uma |coluna separada como segue: |Exemplo 15: |CREATE VIEW NEW_EMP2 AS | SELECT left(t.msg,18) AS LNAME, right(t.msg,18) AS FNAME | FROM tabela(DB2MQ.MQREADALL()) t |Um novo recurso do DB2 Stored Procedure Builder, o Assistente Assist do |MQSeries, pode ser utilizado para criar novas funes e exibies da tabela do |DB2 que iro mapear estruturas de mensagens delimitadas para as |colunas. |Finalmente desej vel armazenar o contedo de uma ou mais mensagens no |banco de dados. Isso pode ser feito utilizando a energia completa do |SQL para manipular e armazenar o contedo da mensagem. Talvez o exemplo |mais simples disso : |Exemplo 16: |INSERT INTO MESSAGES | SELECT t.msg FROM tabela (DB2MQ.MQRECEIVEALL()) t |Determinado uma tabela MESSAGES, com uma nica coluna VARCHAR(2000), a |instruo acima ir inserir as mensagens da fila de servios padro na |tabela. Essa tcnica pode ser aprimorada para abranger uma grande |variedade de circunstncias. |20.5.4 Conectividade de Aplicativo a Aplicativo |A integrao de aplicativos um elemento comum em muitas solues. |Se integrar um aplicativo comprado em uma infra-estrutura existente ou apenas |integrar um aplicativo recentemente desenvolvido em um ambiente existente, |muitas vezes, estaremos voltados com a tarefa de unir uma coleta heterognea |de subsistemas juntos para formar todo um trabalho. O MQSeries |comumentemente exibido como uma ferramenta essencial de integrar |aplicativos. Acessvel na maioria dos ambientes de hardware, software e |de linguagem, o MQSeries fornece o meio de interconectar uma coleo muito |heterognea de aplicativos. |Essa seo discutir alguns cen rios de integrao do aplicativo e como |eles podem ser utilizados com o DB2. Como o tpico muito abrangente, |um tratamento compreensivo de Integrao do Aplicativo vai alm do escopo |desse trabalho. Entretanto, o foco est exatamente em dois tpicos |simples: comunicao de Pedido/Resposta e MQSeries Integrator e |Publish/Subscribe. |20.5.4.1 Comunicaes de Pedido/Resposta |O mtodo de comunicaes de Pedido/Resposta (P/R) uma tcnica muito comum |para um ID de aplicativo solicitar os servios de outro. Uma maneira de |fazer isso para o solicitador enviar uma mensagem para o provedor de servio |solicitando o mesmo trabalho a ser executado. Quando o trabalho foi |concludo, o provedor pode decidir enviar os resultados (ou apenas uma |confirmao de concluso) de volta para o solicitador. Mas utilizar as |tcnicas de mensagens b sicas descritas acima, no h nada que conecta o |pedido do emissor resposta do provedor de servio. A menos que o |solicitador aguarde uma resposta antes de continuar, algum mecanismo deve ser |utilizado para associar cada resposta a seu pedido. Em vez de forar o |desenvolvedor a criar esse mecanismo, o MQSeries fornece um identificador de |correlao que permite a correlao de mensagens em uma troca. |Enquanto existe um nmero de maneiras no qual esse mecanismo pode ser |utilizado, o mais simples para o solicitador marcar uma mensagem com um |identificador de correlao conhecido utilizando, por exemplo, o |seguinte: |Exemplo 17: |DB2MQ.MQSEND ('myRequester','myPolicy','SendStatus:cust1','Req1') |Essa instruo inclui um parmetro final Req1 na instruo MQSEND acima, |para indicar o identificador de correlao do pedido. |Para receber uma resposta a esse pedido especfico, utilize a instruo |MQRECEIVE correspondente para recuperar seletivamente a primeira mensagem |definida pelo servio indicado que corresponda a esse identificador de |correlao, como a seguir: |Exemplo 18: |DB2MQ.MQRECEIVE('myReceiver','myPolicy','Req1') |Se o aplicativo que atende o pedido estiver ocupado e o solicitador emitir |o MQRECEIVE acima antes da resposta ser enviada, nenhuma mensagem que |corresponda a esse identificador de correlao ser encontrada. |Para receber o pedido de servio e o identificador de correlao, uma |instruo como a seguinte utilizada: |Exemplo 19: |SELECT msg, correlid FROM | table (DB2MQ.MQRECEIVEALL('aServiceProvider','myPolicy',1)) t |Isso retorna a mensagem e o identificador de correlao do primeiro pedido |do aServiceProvider de servio. |Quando o servio foi executado, ele envia a mensagem de resposta para a |fila descrita pelo aRequester. Entretanto, o solicitador de servio |pode ter realizado outro trabalho. De fato, no existe nenhuma garantia |que o pedido de servio inicial ser respondido dentro do tempo |definido. Os tempos limites do nvel de aplicativo tais como este, |devem ser gerenciado pelo desenvolvedor; o solicitador deve ser |controlado para detectar a presena da resposta. |A vantagem de tal processamento assncrono independente de tempo que o |solicitador e o provedor de servio so executados completamente independentes |um do outro. Estes podem ser utilizados para acomodar os ambientes nos |quais os aplicativos so conectados apenas intermitentemente e mais ambientes |orientados em batch nos quais v rios pedidos ou respostas so agregados antes |do processamento. Esse tipo de agregao freqentemente utilizado em |ambientes de warehouse de dados, para atualizar periodicamente um warehouse de |dados ou armazenamento de dados operacional. |20.5.4.2 Publicar/Associar |Publicao de Dados Simples |Outro cen rio comum na integrao de aplicativos para um aplicativo |notificar outros aplicativos sobre os eventos de interesse. Isso |facilmente feito enviando uma mensagem para uma fila monitorada por outro |aplicativo. O contedo da mensagem pode ser uma cadeia definida pelo |usu rio ou pode ser composto de colunas do banco de dados. Muitas |vezes, uma mensagem simples tudo o que precisa para ser enviada utilizando a |funo MQSEND. Quando tais mensagens precisam ser enviadas |concorrentemente para v rios destinat rios, o recurso da Lista de Distribuio |da MQSeries AMI pode ser utilizado. |Uma lista de distribuio definida utilizando a ferramenta AMI |Administration. Uma lista de distribuio abrange uma lista de servios |individuais. Uma mensagem enviada para uma lista de distribuio |encaminhada para cada servio definido dentro da lista. Isso , |especialmente, til quando sabe-se que poucos servios sempre estaro |interessados em toda mensagem. O exemplo a seguir mostra o envio de uma |mensagem para a lista de distribuio interestedParties: |Exemplo 20: |DB2MQ.MQSEND('interestedParties','informaes de interesse geral'); |Quando requerido mais controle sobre as mensagens que os servios |especficos devem receber, uma capacidade de Publicar/Associar |necess ria. Os sistemas de publicao/associao fornecem, tipicamente, |um ambiente escal vel e seguro no qual muitos assinantes podem ser registrados |para receberem mensagens de v rios publicadores. Para suportar essa |capacidade da interface MQPublish poder ser utilizada, em conjunto com o |recurso MQSeries Integrator ou MQSeries Publish/Subscribe. |O MQPublish permite que os usu rios especifiquem, opcionalmente, um tpico |a ser associado a uma mensagem. Os tpicos permitem um assinante para |especificar mais claramente as mensagens a serem aceitas. A seqncia |de etapas a seguinte: | 1. |Um administrador do MQSeries configura as capacidades do MQSeries |Integrator publish/subscribe. 2. |Os aplicativos interessados associam os pontos de assinatura definidos |pela configurao do MQSI, especificando, opcionalmente, os tpicos de |interesse deles. Cada assinante seleciona os tpicos relevantes e |tambm pode utilizar as tcnicas de assinatura baseadas no contedo do |MQSeries Integrator V2. importante observar que as filas, conforme |representadas por nomes de servios, definem o assinante. 3. |Um aplicativo do DB2 publica uma mensagem para o ponto de servio |Tempo. As mensagens indicam se o tempo est Nevando com um tpico de |Austin, notificando, assim, os assinantes interessados que o tempo em Austin |est Nevando. 4. |Os mecanismos de publicao da mensagem atual so manipulados pelas |funes do MQSeries fornecidas pelo DB2. A mensagem enviada para o |MQSeries Integrator utilizando o servio nomeado Tempo. 5. |O MQSI aceita a mensagem do servio de Tempo, executa qualquer |processamento definido pela configurao do MQSI e determina quais assinaturas |ele satisfaz. Em seguida, ele envia a mensagem para as filas do |assinante cujos critrios atende. 6. |Os aplicativos que so associados ao servio e Tempo e que registraram um |interesse em Austin, recebero a mensagem Nevando em seu servio de |recebimento. | |Para publicar esses dados utilizando todos os padres e um tpico nulo, |voc utilizar a seguinte instruo: |Exemplo 21: |SELECT DB2MQ.MQPUBLISH | (LASTNAME || ' ' || FIRSTNAME || ' ' || | DEPARTMENT|| ' ' ||char(AGE)) | FROM EMPLOYEE | WHERE DEPARTMENT = '5LGA' |Especificar completamente todos os parmetros e simplificar a mensagem para |conter apenas o LASTNAME, a instruo se parecer : |Exemplo 22: |SELECT DB2MQ.MQPUBLISH('HR_INFO_PUB', 'SPECIAL_POLICY', LASTNAME, | 'ALL_EMP:5LGA', 'MANAGER') | FROM EMPLOYEE | WHERE DEPARTMENT = '5LGA' |Essa instruo publica mensagens para o servio de publicao HR_INFO_PUB, |utilizando o servio SPECIAL_POLICY. As mensagens indicam que o emissor | o tpico MANAGER. A cadeia de tpicos demonstra que v rios tpicos, |concatenados utilizando um ':' podem ser especificados. |Nesse exemplo, o uso de dois tpicos permite que os assinantes sejam |registrados para ALL_EMP ou apenas 5LGA para receber essas mensagens. |Para receber mensagens publicadas, primeiro voc deve registrar seu |interesse em mensagens que contm um determinado tpico e indicar o nome do |servio do assinante para o qual as mensagens devem ser enviadas. |importante observar que um servio do assinantes da AMI define um servio |intermedi rio e um servio do receptor. O servio intermedi rio como |o assinante que se comunica com o intermedi rio de publicar/associar e o |servio do receptor est onde as mensagens que correspondem ao pedido de |assinatura sero enviadas. A instruo a seguir registra um interesse |no tpico ALL_EMP. |Exemplo 23: |DB2MQ.MQSUBSCRIBE('aSubscriber', 'ALL_EMP') |Quando um aplicativo associado, as mensagens publicadas com o tpico |ALL_EMP sero enviadas para o servio do receptor definido pelo servio do |assinante. Um aplicativo pode ter v rias assinaturas |concorrentes. Para obter as mensagens que atendem sua assinatura, |qualquer uma das funes de recuperao de mensagem padro podem ser |utilizadas. Por exemplo, se o aSubscriber de servio do assinante |definir o servio do receptor para ser aSubscriberReceiver, a instruo a |seguir ler no-destrutivamente a primeira mensagem: |Exemplo 24: |DB2MQ.MQREAD('aSubscriberReceiver') |Para determinar as mensagens e os tpicos em que eles foram publicados, |voc utilizar uma das funes da tabela. A instruo a seguir receber |as cinco primeiras mensagens do aSubscriberReceiver e exibir a mensagem e o |tpico: |Exemplo 25: |SELECT t.msg, t.topic | FROM table (DB2MQ.MQRECEIVEALL('aSubscriberReceiver',5)) t |Para ler todas as mensagens com o tpico ALL_EMP, voc pode atuar sobre a |energia do SQL para emitir: |Exemplo 26: |SELECT t.msg FROM tabela (DB2MQ.MQREADALL('aSubscriberReceiver')) t | WHERE t.topic = 'ALL_EMP' |Nota: importante perceber que se o MQRECEIVEALL utilizado com uma limitao, em |seguida toda a fila ser consumida, no apenas essas mensagens publicadas com |o tpico ALL_EMP. Isso acontece porque a funo da tabela executada |antes da limitao ser aplicada. | |Quando voc no estiver mais interessado em associar um tpico especfico, | necess rio desassociar explicitamente utilizando uma instruo tal |como: |Exemplo 27: |DB2MQ.MQUNSUBSCRIBE('aSubscriber', 'ALL_EMP') |Quando essa instruo emitida o intermedi rio de publicao/associao |no entregar mais as mensagens correspondentes a essa assinatura. |Publicao Autom tica |Outra tcnica importante no sistema de mensagens do banco de dados a |publicao automatizada. Utilizando o recurso de disparo dentro do DB2, |voc pode, opcionalmente, publicar mensagens como parte de uma invocao de |disparo. Enquanto existem outras tcnicas para publicao de dados |automatizada, a abordagem baseada em disparo permite aos administradores ou |aos desenvolvedores grande liberdade na construo do contedo e da |flexibilidade da mensagem na definio das aes de disparo. Como com |qualquer uso de disparos, deve ser prestar ateno na freqncia e no custo da |execuo. Os exemplos a seguir demonstram como os disparos podem ser |utilizados com as Funes do MQSeries DB2. |O exemplo abaixo mostra como f cil publicar uma mensagem todas vez que um |novo empregado contratado. Todos os usu rios e aplicativos associados |ao servio HR_INFO_PUB comum interesse registrado em NEW_EMP, recebero uma |mensagem contendo a data, o nome e o departamento de cada novo |empregado. |Exemplo 28: |CREATE TRIGGER new_employee AFTER INSERT ON employee REFERENCING NEW AS n | FOR EACH ROW MODE DB2SQL | VALUES DB2MQ.MQPUBLISH('HR_INFO_PUB&', 'NEW_EMP', | current date || ' ' || LASTNAME || ' ' || DEPARTMENT) ------------------------------------------------------------------------ |20.6 enable_MQFunctions |enable_MQFunctions | | |Ativa as funes do DB2 MQSeries para o banco de dados especificado e |confirma se as funes do DB2 podem ser executadas corretamente. O |comando falhar , se o MQSeries e o MQSeries AMI no tiver sido instalado e |configurado. |Autorizao |Um dos seguintes: | * |sysadm * |dbadm * |IMPLICIT_SCHEMA no banco de dados, se o nome do esquema implcito ou |explcito da funo no existir. * |Privilgio CREATEIN no esquema, se o nome do esquema, DB2MQ, existir | |Sintaxe do Comando |>>-enable_MQFunctions---n--database---u--userid---p--password---> | |>--+-------+--+------------+----------------------------------->< | '-force-' '-noValidate-' | | |Parmetros do Comando | |-n database |Especifica o nome do banco de dados a ser ativado. |-u userid |Especifica o ID do usu rio para conectar-se ao banco de dados. |-p password |Especifica a senha para o ID do usu rio. |-force |Especifica que os avisos encontrados durante a reinstalao devem ser |ignorados. |-noValidate |Especifica que a validao das funes do DB2 MQSeries no sero |executadas. | |Exemplos |No exemplo a seguir, as funes do DB2MQ esto sendo criadas. O |usu rio conecta-se ao banco de dados SAMPLE. O esquema padro DB2MQ |est sendo utilizado. | enable_MQFunctions -n sample -u user1 -p password1 |Notas de Uso |As funes do DB2 MQ executadas no esquema DB2MQ que so automaticamente |criadas por esse comando. |Antes de executar esse comando: | * |Assegure-se de que o MQ e a AMI estejam instalados e de que a verso do |MQSeries seja 5.1 ou superior. * |Assegure-se de que a vari vel de ambiente $AMT_DATA_PATH esteja |definida. * |Mude o diretrio para o subdiretrio cfg do DB2PATH | |No UNIX: | * |Utilize db2set para incluir AMT_DATA_PATH no DB2ENVLIST. * |Assegure-se de que a conta do usu rio associada execuo do UDF seja um |membro do grupo mqm. * |Assegure-se de que o usu rio que estar chamando esse comando seja um |membro, se for o grupo mqm. | |Nota: O AIX 4.2 no suportado pelo MQSeries 5.2. | ------------------------------------------------------------------------ |20.7 disable_MQFunctions |disable_MQFunctions | | |Desativa o uso de funes do DB2 MQSeries para o banco de dados |especificado. |Autorizao |Um dos seguintes: | * |sysadm * |dbadm * |IMPLICIT_SCHEMA no banco de dados, se o nome do esquema implcito ou |explcito da funo no existir. * |Privilgio CREATEIN no esquema, se o nome do esquema, DB2MQ, existir | |Sintaxe do Comando |>>-disable_MQFunctions---n--database---u--userid----------------> | |>---p--password------------------------------------------------>< | | |Parmetros do Comando | |-n database |Especifica o nome do banco de dados. |-u userid |Especifica o ID do usu rio utilizado para conectar-se ao banco de |dados. |-p password |Especifica a senha para o ID do usu rio. | |Exemplos |No exemplo a seguir, as funes do DB2MQ esto desativadas para o banco de |dados SAMPLE. | disable_MQFunctions -n sample -u user1 -p password1 ------------------------------------------------------------------------ Ferramentas Administrativas ndice Parcial * |Configurao Adicional Antes de Executar Ferramentas o |21.1 Desativando a Pilha de Ponto Flutuante no Linux o |21.2 Nvel de Java Especfico Requerido em um Ambiente Linux em Japons * Centro de Controle o 22.1 Capacidade de Administrar o Servidor do DB2 para Servidores VSE e VM o 22.2 Suporte a Java 1.2 para o Centro de Controle o 22.3 Erro "Atalho inv lido" ao Usar a Ajuda Online no Sistema Operacional Windows o 22.4 Atalhos do Teclado Que No Funcionam o 22.5 Centro de Controle Java no OS/2 o 22.6 Erro "Acesso negado ao arquivo" ao Tentar Exibir um Job Concludo no Di rio no Sistema Operacional Windows o 22.7 Teste de Conexo de Atualizao Multisites o 22.8 DB2 Control Center para OS/390 o 22.9 Correo Exigida do Centro de Controle para OS/390 o 22.10 Alterao no Di logo Criar Camada Espacial o 22.11 Informaes de Deteco de Problemas para o DB2 Control Center o 22.12 Resolvendo Problemas do Centro de Controle em Sistemas Baseados em UNIX o 22.13 Possveis Problemas Com Infopops no OS/2 o 22.14 Ajuda do Parmetro de Configurao jdk11_path o 22.15 Erro do Sistema Solaris (SQL10012N) na Utilizao do Centro de Scripts ou do Di rio o 22.16 Ajuda ao Arquivo DPREPL.DFT o 22.17 Lanando Mais de Um Applet do Centro de Controle o 22.18 Ajuda Online do Centro de Controle em Execuo como um Applet o 22.19 Executando o Centro de Controle no Modo Applet (Windows 95) o |22.20 Trabalhando com Resultados de Consulta Grande * Centro de Comandos o |23.1 P gina Interativa do Centro de Comandos Agora Reconhece o Finalizador de Instruo * Centro de Informaes o |24.1 Correes do Documento de Exemplos Java o 24.2 Erro "Atalho Inv lido" no Sistema Operacional Windows o 24.3 Abrindo links da Web externos no Netscape Navigator quando o Netscape j est aberto (Sistemas baseados em UNIX) o 24.4 Problemas ao Iniciar o Centro de Informaes * Assistentes o 25.1 Definindo o Tamanho Estendido no Assistente Criar Banco de Dados o |25.2 Assistente de Ajuda do MQSeries o |25.3 Assistente de Ajuda do OLE DB o |25.4 Construindo Procedimentos Java Armazenados para OS/390 Utilizando o Stored Procedure Builder ------------------------------------------------------------------------ |Configurao Adicional Antes de Executar Ferramentas | | | ------------------------------------------------------------------------ |21.1 Desativando a Pilha de Ponto Flutuante no Linux |Em um ambiente Linux com glibc 2.2.x, voc precisa desativar |a pilha de ponto flutuante antes de executar as ferramentas DB2 Java GUI, tais |como o Centro de Controle. Para desativar a pilha de ponto flutuante, |defina a vari vel de ambiente LD_ASSUME_KERNEL como 2.2.5 como |segue: |bash$ export LD_ASSUME_KERNEL=2.2.5 ------------------------------------------------------------------------ |21.2 Nvel de Java Especfico Requerido em um Ambiente Linux em Japons |Usu rios do Linux precisam de um nvel de JDK especfico ao executar as |ferramentas de GUI Java do DB2, como o Centro de Controle, em um ambiente em |japons. Por exemplo, usu rios do Red Hat Linux |6.2J/7J/7.1/7.2 devem utilizar o nvel |IBMJava118-SDK-1.1.8-2.0.i386.rpm. ------------------------------------------------------------------------ Centro de Controle ------------------------------------------------------------------------ 22.1 Capacidade de Administrar o Servidor do DB2 para Servidores VSE e VM O Centro de Controle do DB2 Universal Database Verso 7 melhorou seu suporte do DB2 Server para bancos de dados VSE e VM. Todos os objetos de banco de dados do Servidor do DB2 para VSE e VM podem ser exibidos com o Centro de Controle. Existe tambm suporte para as instrues CREATE INDEX, REORGANIZE INDEX, e UPDATE STATISTICS, e para o comando REBIND. REORGANIZE INDEX e REBIND exigem um procedimento armazenado em execuo no Servidor do DB2 para hosts VSE e VM. Este procedimento armazenado fornecido pelo recurso do Centro de Controle para VSE e VM do Servidor do DB2 para VSE e VM. O Centro de Controle totalmente integrado permite ao usu rio gerenciar o DB2, independentemente da plataforma na qual o Servidor do DB2 for executado. Os objetos do Servidor do DB2 para VSE e VM so exibidos na janela principal do Centro de Controle, junto aos objetos do DB2 Universal Database. As aes correspondentes e utilit rios para gerenciar estes objetos so chamados selecionando o objeto. Por exemplo, um usu rio pode listar os ndices de um banco de dados em particular, selecionar um dos ndices, e reorganiz -lo. O usu rio pode tambm listar as tabelas de um banco de dados e rodar atualizaes de estatsticas, ou definir uma tabela como uma fonte de replicao. Para informaes sobre a configurao do Centro de Controle para realizar tarefas administrativas em objetos do Servidor do DB2 para VSE e VM, consulte a publicao DB2 Connect User's Guide ou Suplemento de Instalao e Configurao. ------------------------------------------------------------------------ 22.2 Suporte a Java 1.2 para o Centro de Controle O Centro de Controle suporta idiomas bidirecionais, como o rabe e o Hebreu, utilizando o suporte bidirecional do Java 1.2. Este suporte fornecido apenas para a plataforma Windows NT. O Java 1.2 deve estar instalado para que o Centro de Controle o reconhea e o use: 1. O JDK 1.2.2 est disponvel no CD do DB2 UDB sob o diretrio DB2\bidi\NT. ibm-inst-n122p-win32-x86.exe o programa instalador, e ibm-jdk-n122p-win32-x86.exe a distribuio do JDK. Copie ambos os arquivos para um diretrio tempor rio em seu disco rgido, e execute o programa instalador a partir da. 2. Instale-o sob \java\Java12, onde o caminho de instalao do DB2. 3. No selecione JDK/JRE como MV do Sistema quando solicitado pela instalao do JDK/JRE. Depois que o Java 1.2 estiver instalado, iniciar o Centro de Controle da maneira normal usar o Java 1.2. Para parar o uso do Java 1.2, voc pode desinstalar o JDK/JRE de \java\Java12 ou simplesmente renomear o subdiretrio \java\Java12 para algo diferente. Nota: No confunda \java\Java12 com \Java12.\Java12 parte da instalao do DB2, e inclui o suporte a JDBC para Java 1.2. ------------------------------------------------------------------------ 22.3 Erro "Atalho inv lido" ao Usar a Ajuda Online no Sistema Operacional Windows Ao usar a ajuda online do Centro de Controle, voc pode encontrar um erro como: "Atalho inv lido". Se voc instalou recentemente um novo navegador Web ou uma nova verso de um navegador Web, garanta que os documentos HTML e HTM esto associados ao navegador correto. Consulte o tpico da ajuda do Windows "Para alterar qual programa iniciado quando voc abre um arquivo". ------------------------------------------------------------------------ 22.4 Atalhos do Teclado Que No Funcionam Em alguns idiomas, para o Centro de Controle em sistemas baseados no UNIX e no OS/2, alguns atalhos (teclas de acesso r pido) do teclado no funcionam. Use o mouse para selecionar opes. ------------------------------------------------------------------------ 22.5 Centro de Controle Java no OS/2 O Centro de Controle deve ser instalado em uma unidade no formato HPFS. ------------------------------------------------------------------------ 22.6 Erro "Acesso negado ao arquivo" ao Tentar Exibir um Job Concludo no Di rio no Sistema Operacional Windows No DB2 Universal Database para Windows NT, um erro "Acesso negado ao arquivo" ocorre ao tentar abrir o Di rio para exibir os detalhes de um job criado no Centro de Script. O status do job indica concludo. Este comportamento ocorre quando um job criado no Centro de Script contm o comando START. Para evitar este comportamento, utilize START/WAIT ao invs de START em ambos o arquivo batch e o prprio job. ------------------------------------------------------------------------ 22.7 Teste de Conexo de Atualizao Multisites A funcionalidade do Teste de Conexo de Atualizao Multisite no Centro de Controle da Verso 7 limitado pela verso da instncia de destino. A instncia de destino deve ser, no mnimo, Verso 7 para que a funcionalidade de teste de conexo "remota" seja executada. Para executar a funcionalidade de Teste de Conexo de Atualizao Multisite na Verso 6, voc deve abrir o Centro de Controle localmente na instncia de destino e execut -lo l . ------------------------------------------------------------------------ 22.8 DB2 Control Center para OS/390 O DB2 UDB Control Center para OS/390 permite que voc gerencie o uso de seus utilit rios licenciados do IBM DB2. As funes do utilit rio que so elementos de recursos adquirveis separadamente do DB2 UDB para OS/390 devem estar licenciados e instalados no seu ambiente antes de serem gerenciados pelo DB2 Control Center. O banco de dados "CC390", definido com o Centro de Controle quando voc configura um subsistema do DB2 para OS/390, utilizado para o suporte interno do Centro de Controle. No modifique este banco de dados. Embora o DB2 para OS/390 Verso 7.1 no seja mencionado especificamente no ndice do Centro de Controle, ou nas Informaes de Tarefas do Centro de Informaes, a documentao suporta as funes do DB2 para OS/390 Verso 7.1. V rias das funes especficas do DB2 para OS/390 Verso 6 tambm se referem ao DB2 para OS/390 Verso 7.1 e algumas funes especficas do DB2 para OS/390 Verso 7.1 no ndice no possuem designao de verso. Se voc configurou um subsistema do DB2 para OS/390 Verso 7.1 em seu Centro de Controle, voc tem acesso a toda a documentao dessa verso. Para acessar e usar a funo Gerar DDL a partir do DB2 Control Center para OS/390, voc deve possuir a funo Gerar DDL instalada: * Na Verso 5, instale DB2Admin 2.0 com o DB2 para OS/390 Verso 5. * Na Verso 6, instale a pequena melhora de programao que estar disponvel como uma PTF para o recurso DB2 Admin do DB2 para OS/390 Verso 6. * Na Verso 7.1, a funo Gerar DDL parte do recurso DB2 Admin para OS/390 Verso 7.1 com preo diferenciado. Voc pode acessar o Construtor de Procedimento Armazenado a partir do Centro de Controle, mas voc j deve t-lo instalado no momento que voc iniciar o DB2 Control Center UDB. Ele parte do Cliente de Desenvolvimento de Aplicativos do DB2. Para catalogar um subsistema do DB2 para OS/390 diretamente na estao de trabalho, selecione para usar a ferramenta Assistente de Configurao do Cliente. 1. Na p gina Origem, especifique o boto de opo Configurar uma conexo a um banco de dados manualmente. 2. Na p gina Protocolo, informe as informaes apropriadas de comunicao. 3. Na p gina Banco de Dados, especifique o nome do subsistema no campo Nome do banco de dados. 4. Na p gina Opes do N, marque a caixa de seleo Configurar opes do n (Opcional). 5. Selecione MVS/ESA, OS/390 na lista no campo Sistema operacional. 6. Clique em Concluir para completar a configurao. Para catalogar um subsistema do DB2 para OS/390 atravs de uma m quina de gateway, siga as etapas 1-6 anteriores na m quina de gateway e: 1. Na m quina cliente, inicie o Centro de Controle. 2. Clique com o boto direito do mouse na pasta Sistemas e selecione Incluir. 3. No di logo Incluir Sistema, digite o nome da m quina de gateway no campo Nome do sistema. 4. Digite DB2DAS00 no campo Instncia remota. 5. Para o protocolo TCP/IP, nos parmetros do Protocolo, especifique o nome do host da m quina de gateway no campo Nome do host. 6. Digite 523 no campo Nome do servio. 7. Clique em OK para incluir o sistema. A m quina de gateway dever aparecer includa sob a pasta Sistemas. 8. Expanda o nome da m quina gateway. 9. Clique com o boto direito do mouse na pasta Instncias e selecione Incluir. 10. No di logo Incluir Instncia, clique no boto Atualizar para listar as instncias disponveis na m quina de gateway. Se a m quina gateway um sistema Windows NT, o subsistema DB2 para OS/390 foi catalogado provavelmente sob a instncia do DB2. 11. Selecione a instncia. Os parmetros do protocolo so preenchidos automaticamente para esta instncia. 12. Clique em OK para incluir a instncia. 13. Abra a pasta Instncias para ver a instncia que voc acabou de incluir. 14. Expanda a instncia. 15. Clique com o boto direito do mouse na pasta Bancos de Dados e selecione Incluir. 16. Clique no boto Atualizar para exibir os bancos de dados locais na m quina de gateway. Se voc estiver incluindo um subsistema do DB2 no di logo Incluir Banco de Dados, digite o nome do subsistema no campo Nome do banco de dados. Opo: Digite um nome de alias local para o subsistema (ou o banco de dados). 17. Clique em OK. Agora voc incluiu com sucesso o subsistema no Centro de Controle. Quando voc abrir o banco de dados, voc dever ver o subsistema DB2 para OS/390 exibido. O primeiro par grafo na seo "Centro de Controle 390" estabelece o seguinte: O DB2 UDB Control Center para OS/390 permite que voc gerencie o uso de seus utilit rios licenciados do IBM DB2. As funes do utilit rio que so elementos de recursos adquirveis separadamente do DB2 UDB para OS/390 devem estar licenciados e instalados no seu ambiente antes de serem gerenciados pelo DB2 Control Center. Essa seo agora informa: O Centro de Controle do DB2 para OS/390 permite gerenciar a utilizao de seus utilit rios IBM DB2 licenciados. As funes de utilit rios que so elementos de produtos pedidos separadamente devem ser licenciados e instalados em seu ambiente para que sejam gerenciados pelo Centro de Controle do DB2. ------------------------------------------------------------------------ 22.9 Correo Exigida do Centro de Controle para OS/390 Voc deve aplicar APAR PQ36382 no recurso de Habilitao 390 do DB2 para OS/390 Verso 5 e DB2 para OS/390 Verso 6 para gerenciar estes subsistemas utilizando o Centro de Controle do DB2 UDB para Verso 7. Sem esta correo, voc no pode utilizar o DB2 UDB Control Center para Verso 7 para executar utilit rios para esses subsistemas. O APAR deve ser aplicado aos seguintes FMIDs: Habilitao 390 do DB2 para OS/390 Verso 5: FMID JDB551D Habilitao 390 do DB2 para OS/390 Verso 6: FMID JDB661D ------------------------------------------------------------------------ 22.10 Alterao no Di logo Criar Camada Espacial Os botes "<<" e ">>" foram removidos do di logo Criar Camada Espacial. ------------------------------------------------------------------------ 22.11 Informaes de Deteco de Problemas para o DB2 Control Center No captulo "Configurao e Instalao do Centro de Controle" do manual Iniciao R pida, a seo intitulada "Informaes de Deteco de Problemas" informa para no configurar seu CLASSPATH do navegador do cliente a partir da janela de comando se voc tiver problemas de execuo do Centro de controle como um applet. Esta seo tambm solicita que o navegador seja iniciado pela mesma janela de comandos. No entanto, o comando para iniciar o navegador no fornecido. Para lanar o Internet Explorer, digite start iexplore e pressione Enter. Para lanar o Netscape, digite o start netscape e pressione Enter. Esses comandos pressupe que o navegador esteja no PATH. Se no estiver, coloque-o ou mude para o diretrio de instalao do navegador e d novamente o comando start. ------------------------------------------------------------------------ 22.12 Resolvendo Problemas do Centro de Controle em Sistemas Baseados em UNIX Se voc no est habilitado para iniciar o Centro de Controle em um sistema baseado em UNIX, defina a vari vel de ambiente JAVA_HOME para indicar a distribuio do Java: * Se o java foi instalado sob /usr/jdk118, defina JAVA_HOME como /usr/jdk118. * Para os shells sh, ksh ou bash: export JAVA_HOME=/usr/jdk118. * Para os shells csh ou tcsh: setenv JAVA_HOME /usr/jdk118 ------------------------------------------------------------------------ 22.13 Possveis Problemas Com Infopops no OS/2 Se voc est executando o Centro de Controle no OS/2, utilizando uma resoluo de tela de 1024x768 com 256 cores, com Workplace Shell Palette Awareness habilitado, os infopops que se estendem alm da borda da janela atual podem ser exibidos em texto preto sobre um fundo preto. Para corrigir este problema, altere as definies da tela para mais de 256 cores ou desabilite o Workplace Shell Palette Awareness. ------------------------------------------------------------------------ 22.14 Ajuda do Parmetro de Configurao jdk11_path Na ajuda do Centro de Controle, a descrio do parmetro de configurao do Caminho de Instalao do Java Development Kit 1.1 (jdk11_path) est faltando uma linha sob o sub-cabealho Aplica-se A. A lista completa sob Aplica-se A : * Servidor de bancos de dados com clientes remotos e locais * Cliente * Servidor de Banco de Dados com clientes locais * Servidor de banco de dados particionado com clientes locais e remotos * Servidor de banco de dados satlite com clientes locais ------------------------------------------------------------------------ 22.15 Erro do Sistema Solaris (SQL10012N) na Utilizao do Centro de Scripts ou do Di rio Quando o sistema Solaris for selecionado no Centro de Scripts ou no Di rio, poder ser encontrado o seguinte erro: SQL10012N - Foi recebido um erro inesperado no sistema operacional durante o carregamento da biblioteca especificada "/udbprod/db2as/sqllib/function/unfenced/ db2scdar!ScheduleInfoOpenScan". SQLSTATE=42724. Ele foi causado por um erro de programao no vinculador de run-time do Solaris. Para corrigir esse problema, aplique a seguinte correo: 105490-06 (o 107733 torna o 105490 obsoleto) para o Solaris 2.6 ------------------------------------------------------------------------ 22.16 Ajuda ao Arquivo DPREPL.DFT No Centro de Controle, na ajuda da p gina Replicao do bloco de notas Definies da Ferramenta, a etapa 5d afirma: Salve o arquivo no diretrio de trabalho do Centro de Controle (por exemplo: SQLLIB\BIN) para que o sistema possa us -lo como o arquivo padro. Mas, a etapa 5d deve afirmar o seguinte: Salve o arquivo no diretrio de trabalho do Centro de Controle (SQLLIB\CC) para que o sistema possa us -lo como o arquivo padro. ------------------------------------------------------------------------ 22.17 Lanando Mais de Um Applet do Centro de Controle Voc no pode lanar mais de um applet do Centro de Controle simultaneamente na mesma m quina. Esta restrio se aplica aos applets do Centro de Controle em execuo em todos os navegadores suportados. ------------------------------------------------------------------------ 22.18 Ajuda Online do Centro de Controle em Execuo como um Applet Quando o Centro de Controle estiver sendo executado como um applet, a tecla F1 s funcionar em janelas e blocos de notas que tm infopops. Voc pode pressionar a tecla F1 para tornar os infopops visveis nos seguintes componentes: * DB2 Universal Database para OS/390 * Os assistentes No restante dos componentes do Centro de Controle, a tecla F1 no torna nenhuma ajuda visvel. Para exibir a ajuda dos outros componentes, utilize o boto de comando Ajuda ou o menu de opes Ajuda. ------------------------------------------------------------------------ 22.19 Executando o Centro de Controle no Modo Applet (Windows 95) A tentativa de abrir o Centro de Scripts poder falhar se forem especificadas um ID de usu rio e uma senha inv lida. Confira se foram digitadas um ID de usu rio e uma senha v lidas quando for efetuado o incio de sesso no Centro de Controle. ------------------------------------------------------------------------ |22.20 Trabalhando com Resultados de Consulta Grande | | | f cil para um usu rio produzir uma consulta que retorna um grande nmero |de linhas. No to f cil para um usu rio, prognosticar quantas linhas |podem atualmente ser retornadas. Com uma consulta que pode retornar |potencialmente milhares (ou milhes) de linhas, existem dois problemas: | 1. |Ela pode demorar para recuperar o resultado. 2. |Uma grande quantidade de memria do cliente pode ser requerida para manter |o resultado. | |Para facilitar esse processo, o DB2 fragmenta os conjuntos de resultados |grandes em partes. Ele recuperar e exibir os resultados de uma |consulta, uma parte de cada vez. |Como resultado: | 1. |O tempo de exibio ser reduzido como a primeira parte de uma consulta |disponvel para exibio, enquanto as partes restantes esto sendo |recuperadas. 2. |Os requisitos de memria no cliente ser reduzido apenas como uma parte de |uma consulta, o resultado ser armazenado no cliente em um determinado |perodo. | |Para controlar o nmero de linhas de resultados de consultas na |memria: | 1. |Abra a p gina Geral do bloco de notas Definies da Ferramenta. 2. |Na seo Tamanho m ximo, selecione: | o |Contedo da Amostra para limitar o nmero de linhas de |resultado exibido na janela Contedo da Amostra. Especifique o tamanho |da parte do conjunto de resultados (nmero de linhas) no campo de |entrada. o |Centro de Comando para limitar o nmero de linhas de resultado |exibido na p gina Resultados da Consulta do Centro de Comando. |Especifique o tamanho da parte do conjunto de resultados (nmero de linhas) no |campo de entrada. | | |Ao trabalhar com os resultados de uma consulta na janela Contedo da |Amostra ou an p gina Resultados da Consulta do Centro de Comando, o campo |Linhas na memria indica o nmero de linhas sendo retido na memria |para a consulta. Esse nmero nunca ser maior que o conjunto de |Tamanho m ximo. Clique em Avanar para recuperar |a prxima parte do conjunto de resultados. Quando Avanar |estiver inativo, voc atingiu o final do conjunto de resultados. ------------------------------------------------------------------------ Centro de Comandos ------------------------------------------------------------------------ |23.1 P gina Interativa do Centro de Comandos Agora Reconhece o Finalizador de Instruo |A p gina interativa do Centro de Comando agora reconhece o caractere de |terminao de Instruo especificado nas Definies das Ferramentas. Se |um caractere de terminao da Instruo no for especificado, o caractere de |nova linha utilizado como padro. ------------------------------------------------------------------------ Centro de Informaes ------------------------------------------------------------------------ |24.1 Correes do Documento de Exemplos Java |O documento de Exemplos Java do centro de informaes est ligado origem |dos exemplos java. A seo PluginEx.Java dessa origem no est |atualizada. Para obter as informaes atuais sobre Estendendo o Centro |de Controle, consulte o arquivo README de Exemplos Java, o arquivo |PluginEx.java e 9.3, Exemplo para Estender o Centro de Controle. |Nas plataformas Windows, os arquivos README e PluginEx.java podem |ser encontrados em x:\sqllib\samples\java em que |x a unidade na qual o DB2 est instalado. |No UNIX, os arquivos README e PluginEx.java podem ser encontrados em |/u/db2inst1/sqllib/samples/java em que |/u/db2inst1 representa o diretrio no qual o DB2 est |instalado. ------------------------------------------------------------------------ 24.2 Erro "Atalho Inv lido" no Sistema Operacional Windows Ao usar o Centro de Informaes, voc poder encontrar erros como: "Atalho Inv lido". Se voc instalou recentemente um novo navegador Web ou uma nova verso de um navegador Web, garanta que os documentos HTML e HTM esto associados ao navegador correto. Consulte o tpico da ajuda do Windows "Para alterar qual programa iniciado quando voc abre um arquivo". ------------------------------------------------------------------------ 24.3 Abrindo links da Web externos no Netscape Navigator quando o Netscape j est aberto (Sistemas baseados em UNIX) Se o Netscape Navigator j estiver aberto e exibindo um documento DB2 HTML local ou um site web externo, a tentativa de abrir um site Web externo a partir do Centro de Informaes resultar em um erro do Netscape. O erro informar que "O Netscape no consegue localizar o arquivo ou o diretrio chamado ." Para solucionar esse problema, feche o navegador Netscape aberto antes de abrir o site Web externo. O Netscape reiniciar e trar o site Web externo. Observe que esse erro no ocorre na tentativa de abrir um documento HTML do DB2 local com o Netscape j aberto. ------------------------------------------------------------------------ 24.4 Problemas ao Iniciar o Centro de Informaes Em alguns sistemas, o Centro de Informaes pode ficar lento ao iniciar se voc o solicitar utilizando o Menu Iniciar, Primeiros Passos ou o comando db2ic. Se esse problema ocorrer, inicie o Centro de Controle e selecione Ajuda --> Centro de Informaes. ------------------------------------------------------------------------ Assistentes ------------------------------------------------------------------------ 25.1 Definindo o Tamanho Estendido no Assistente Criar Banco de Dados Utilizando o Assistente Criar Banco de Dados, possvel definir os parmetros Extent Size e Prefetch Size do User Table Space (mas no aqueles do Catalog ou Temporary Tables) do novo banco de dados. Esse recurso ser ativado somente se pelo menos um container foi especificado para o User Table Space da p gina "User Tables" do Assistente. ------------------------------------------------------------------------ |25.2 Assistente de Ajuda do MQSeries | | |O DB2 Verso 7.2 fornece um novo assistente MQSeries Assist. |Esse assistente cria uma funo de tabela que l a partir de uma fila do |MQSeries que utiliza as Funes do DB2 MQSeries, que tambm so novas na |Verso 7.2. O assistente pode tratar cada mensagem do MQSeries |como uma cadeia delimitada ou uma cadeia de coluna de comprimento fixo |dependendo de sua especificao. A funo da tabela criada analisa a |cadeia de acordo com suas especificaes e retorna cada mensagem do MQSeries |como uma linha da funo da tabela. O assistente tambm permite que |voc crie uma exibio na parte superior da funo da tabela e pr-visualize |uma mensagem do MQSeries e o resultado da funo da tabela. Esse |assistente pode ser lanado do Stored Procedure Builder ou do Data Warehouse |Center. |Os requisitos para esse assistente so: | * |MQSeries verso 5.2 * |MQSeries Application Messaging Interface (AMI) * |Funes do DB2 MQSeries | |Para obter detalhes sobre esses requisitos, consulte a seo MQSeries. |Para amostras e tutoriais do assistente MQSeries Assist, v para a seo de |tutoriais em http://www.ibm.com/software/data/db2/udb/ide ------------------------------------------------------------------------ |25.3 Assistente de Ajuda do OLE DB | | |Esse assistente o ajuda a criar uma funo da tabela que l dados de outro |provedor do banco de dados que suporta o Microsoft OLE DB padro. |Opcionalmente, voc pode criar uma tabela do DB2 com os dados que so lidos |pela funo da tabela do OLE DB e pode criar uma exibio para a funo da |tabela do OLE DB. Esse assistente pode ser lanado do Stored Procedure |Builder ou do Data Warehouse Center. |Os requisitos para esse assistente so: | * |Um provedor OLE DB (tal como Oracle, Microsoft SQL Server) * |Funes de suporte OLE DB | |Para obter amostras e tutoriais do assistente OLE DB Assist, v para a |seo de tutoriais em http://www.ibm.com/software/data/db2/udb/ide ------------------------------------------------------------------------ |25.4 Construindo Procedimentos Java Armazenados para OS/390 Utilizando o Stored Procedure Builder |O DB2 Stored Procedure Builder agora suporta construir procedimentos Java |armazenados para o DB2 para OS/390 Verso 6 e Verso 7. |Requisitos: | * |Antes de comear, voc precisa executar uma srie de tarefas de |configurao em DB2 para OS/390. V para |http://www.ibm.com/software/data/db2/os390/sqlproc para |obter informaes. * |Se voc pretende utilizar o depurador distribudo, seu espao de endereo |WLM em OS/390 deve especificar RUNOPTS parar TEST e seu endereo |TCP/IP. * |O ID de Coleo deve ser idntico ao utilizado ao ligar o driver JDBC em |OS/390. * |Modifique o arquivo DB2SPB.ini para incluir as seguintes |entradas: |SPOPTION_WLM_JAVA_ENVIRONMENT = WLMENVJ |SPOPTION_JAVAPROC_BUILDER = SYSPROC.DSNTJSPP |SPOPTION_BIND_OPTIONS_JAVA = ACT(REP) |SPOPTION_COLLIDJ = DSNJDBC |SPOPTION_HPJ_COMPILE_OPTIONS_DEBUG = -g |SPOPTION_HPJ_COMPILE_OPTIONS = -nog -O * |Para obter informaes sobre privilgios requeridos, consulte 40.6.6.1, Privilgios para Construir e Depurar Procedimentos SQL e Java Armazenados. | |Para criar um procedimento armazenado de Java para OS/390 utilizando o |Stored Procedure Builder: | 1. |Abra o assistente para Inserir Procedimento Armazenado de Java: | a. |Em uma conexo de banco de dados de OS/390, na rvore de projetos, clique |com o boto direito do mouse na pasta de procedimentos armazenados. b. |Selecione Inserir -> Procedimento Armazenado Java Utilizando o |Assistente. O assistente se abre. | 2. |Complete o assistente, especificando as opes de OS/390: | o |O ID de Coleo deve ser idntico ao que estava especificado no BIND |PACKAGE(collid) quando os drivers de JDBC foram ligados ao OS/390. o |O Pacote Java deve ser nico. O padro para o Pacote Java o nome |do procedimento, mas voc pode modificar isso utilizando um nome exclusivo |para cada procedimento Java armazenado criado no servidor. | 3. |Clique em OK. O procedimento armazenado criado e |listado na rvore de projetos. 4. |Clique com o boto direito do mouse no procedimento armazenado e selecione |Construir. | ------------------------------------------------------------------------ Inteligncia de Negcios ndice Parcial * Tutorial Business Intelligence o 26.1 Tutorial Revisado do Business Intelligence * Apresentao do DB2 Universal Database * |Data Warehouse Center Manual de Administrao o |28.1 Atualizao Disponvel o |28.2 Melhorias do Servidor Warehouse o |28.3 Utilizando o Agente do OS/390 para Executar um Trillium Batch System JCL o |28.4 Dois Novos Programas de Exemplo no Data Warehouse Center o |28.5 Managing ETI.Extract(R) Conversion Programs with DB2 Warehouse Manager Atualizado o |28.6 Importando e Exportando Metadados Utilizando a CWMI (Common Warehouse Metadata Interchange) + |28.6.1 Introduo + |28.6.2 Importando metadados + |28.6.3 Atualizando os metadados Aps Executar o Utilit rio de Importao + |28.6.4 Exportando metadados o |28.7 Utilit rio de Importao/Exportao de Metadados da Linguagem de Marcao + |28.7.1 Definies de Chaves + |28.7.2 Planejamentos de Etapas e Processos o |28.8 Informaes da Etapa SAP + |28.8.1 Possibilidade de Criar Tabela Logicamente Inconsistente o |28.9 Informaes do Conector SAP + |28.9.1 Restries Instalao do Conector SAP + |28.9.2 Desempenho de GetDetail BAPI * DB2 OLAP Starter Kit o |29.1 Site da Web do OLAP Server o |29.2 Nveis de Servios do Sistema Operacional Suportados o 29.3 Concluindo a Configurao do DB2 OLAP Starter Kit no UNIX o |29.4 Configurao Adicional para o Ambiente Operacional Solaris o |29.5 Configurao Adicional para Todos os Sistemas Operacionais o |29.6 Configurando o ODBC para o OLAP Starter Kit + |29.6.1 Configurando Origens de Dados em Sistemas UNIX + |29.6.1.1 Configurando as Vari veis de Ambiente ODBC + |29.6.1.2 Editando o Arquivo odbc.ini + |29.6.1.3 Incluindo uma Origem de Dados em um Arquivo odbc.ini + |29.6.1.4 Exemplo de Definies ODBC para DB2 + |29.6.1.5 Exemplo de Definies ODBC para Oracle + |29.6.2 Configurando o OLAP Metadata Catalog em Sistemas UNIX + |29.6.3 Configurando as Origens de Dados em Sistemas Windows + |29.6.4 Configurando o OLAP Metadata Catalog em Sistemas Windows + |29.6.5 Aps Voc Configurar uma Origem de Dados o 29.7 Iniciando sesso do OLAP Starter Kit Desktop + 29.7.1 Exemplo de Login do Starter Kit o 29.8 Criando e Configurando Manualmente os Bancos de Dados de Amostra para OLAP Starter Kit o |29.9 Migrando Aplicativos para OLAP Starter Kit Verso 7.2 o |29.10 Problemas e Limitaes Conhecidos o 29.11 Arquivos EQD do Complemento da Planilha OLAP Faltando * Manual de Administrao do Information Catalog Manager o 30.1 Utilit rio de Inicializao do Gerenciador do Cat logo de Informaes + 30.1.1 + 30.1.2 Questes de licenciamento + 30.1.3 Questes de instalao o |30.2 Melhorias para o Information Catalog Manager o |30.3 Incompatibilidade entre o Information Catalog Manager e o Sybase no Ambiente Windows o 30.4 Acessando os Cat logos de Informaes do DB2 Verso 5 com o Information Catalog Manager do DB2 Verso 7 o 30.5 Configurando um Cat logo de Informaes o 30.6 Trocando Metadados com Outros Produtos o 30.7 Trocando metadados utilizando o comando flgnxoln o 30.8 Trocando metadados utilizando o comando MDISDGC o 30.9 Invocando programas * Manual de Referncia do Information Catalog Manager Programming o 31.1 Cdigos de Razo do Gerenciador do Cat logo de Informaes * Manual do Usu rio do Information Catalog Manager * Information Catalog Manager: Menssagens Online o 33.1 Correes nas Mensagens FLG + 33.1.1 Mensagem FLG0260E + 33.1.2 Mensagem FLG0051E + 33.1.3 Mensagem FLG0003E + 33.1.4 Mensagem FLG0372E + 33.1.5 Mensagem FLG0615E * Information Catalog Manager: Ajuda Online o 34.1 Gerenciador do Cat logo de Informaes para a Web * DB2 Warehouse Manager Installation Guide o |35.1 Atualizao disponvel da Publicao DB2 Warehouse Manager Installation Guide Disponvel o |35.2 Requisitos de software para transformadores do warehouse o |35.3 Consideraes Ps-instalao para o Agente iSeries o |35.4 Antes de Utilizar Transformadores com o Agente do Warehouse do iSeries * Manual de Administrao do Query Patroller o 36.1 O Cliente do DB2 Query Patroller um Componente Separado o |36.2 Alterando o Status do N o 36.3 Migrando da Verso 6 do DB2 Query Patroller Utilizando dqpmigrate o 36.4 Ativando o Query Management o |36.5 Localizao da rea de Tabela para Tabelas de Controle o |36.6 Novos Parmetros para o Comando dqpstart o |36.7 Novo Parmetro para o Comando iwm_cmd o |36.8 Nova Vari vel de Registro: DQP_RECOVERY_INTERVAL o 36.9 Iniciando o Query Administrator o 36.10 Administrao do Usu rio o |36.11 Administrao da Origem de Dados o 36.12 Criando uma Fila de Jobs o |36.13 Tabela de Contabilizao do Job o 36.14 Utilizando a Interface da Linha de Comandos o 36.15 Notas do Query Enabler o 36.16 O rastreador do DB2 Query Patroller pode retornar uma p gina de coluna em branco o |36.17 Informaes Adicionais para a Ferramenta da GUI do Tracker do DB2 Query Patroller o |36.18 Query Patroller e Ferramentas de Replicao o |36.19 Melhorando o Desempenho do Query Patroller o 36.20 O Privilgio EXECUTE para Usu rios do Query Patroller Criados na Verso 6 no est Implementado o 36.21 Restries do Query Patroller o 36.22 Apndice B. Detectando problemas em clientes do DB2 Query Patroller ------------------------------------------------------------------------ Tutorial Business Intelligence ------------------------------------------------------------------------ 26.1 Tutorial Revisado do Business Intelligence O FixPak 2 inclui um Tutorial do Business Intelligence e um banco de dados de amostra do Data Warehouse Center revisados que corrigem v rios problemas existentes na Verso 7.1. Para aplicar o banco de dados de amostra revisado do Data Warehouse Center, faa o seguinte: Se voc ainda no tiver instalado os bancos de dados de amostra, crie um novo banco de dados de amostra utilizando a barra de lanamento Primeiros Passos. Clique em Iniciar e selecione Programas --> IBM DB2 --> Primeiros Passos. Se tiver instalado bancos de dados de amostra anteriormente, elimine os bancos de dados de amostra DWCTBC, TBC_MD e TBC. Se tiver includo quaisquer dados que deseja manter no bancos de dados de amostra, faa backup deles antes de elimin -los. Para eliminar os trs bancos de dados de amostra: 1. Para abrir a Janela de Comando do DB2, clique em Iniciar e selecione Programas --> IBM DB2 --> Janela de Comando. 2. Na Janela de Comando do DB2, digite cada um dos trs comandos a seguir, pressionando Enter aps digitar cada um: db2 drop database dwctbc db2 drop database tbc_md db2 drop database tbc 3. Feche a Janela de Comando do DB2. 4. Crie um novo banco de dados de amostra utilizando a barra de lanamento Primeiros Passos. Clique em Iniciar e selecione Programas --> IBM DB2 --> Primeiros Passos. ------------------------------------------------------------------------ Apresentao do DB2 Universal Database A Apresentao no est disponvel no DB2 para Linux ou Linux/390. A Apresentao otimizada para a execuo com fontes pequenas do sistema. Talvez voc precise ajustar o tamanho de fonte do navegador Web para exibir corretamente a Apresentao no OS/2. Consulte a ajuda do navegador Web para obter informaes sobre o ajuste do tamanho da fonte. Para exibir a Apresentao corretamente (SBCS somente), recomendado que voc utilize uma fonte Helv de 8 pontos. Para clientes no Japo e na Coria, o uso de uma fonte Mincho com 8 pontos recomendado. Ao definir as preferncias de fonte, certifique-se de selecionar a opo "Usar fontes padro, substituindo fontes especificadas do documento" na p gina Fontes da janela Preferncias. Em alguns casos, a Apresentao pode lanar uma janela secund ria do navegador em segundo plano. Para corrigir esse problema, feche a Apresentao e siga as etapas em 3.4, Mensagens de Erro na Tentativa de Lanar o Netscape. Ao lanar a Apresentao, voc poder receber um erro de JavaScript similar ao seguinte: arquivo:/C/Arquivos de Programas/SQLLIB/doc/html/db2qt/index4e.htm, linha 65: A janela no est definida. Esse erro do JavaScript impede que a Apresentao lance a p gina, index4e.htm, fechando automaticamente aps a Apresentao ser lanada. Voc pode fechar a p gina de lanamento da Apresentao, fechando a janela do navegador na qual o index4e.htm exibido. A seo "Novidades", sob o tpico Gerenciamento de Dados, est descrito que o "suporte do arquivo acumulativo de log por pedido" suportado na Verso 7.1. Isto no est correto. Ela afirma tambm que: O tamanho dos arquivos de log aumentou de 4 GB para 32 GB. Esta sentena deveria ser: O espao total do log ativo aumentou de 4 GB para 32 GB. A seo que descreve o DB2 Data Links Manager contm a seguinte frase: Alm disso, suporta o uso da interface Veritas XBSA para o backup e a restaurao atravs do NetBackup. Esta sentena deveria ser: Alm disso, agora suporta a interface XBSA para gravao e restaurao de arquivos. Os gerenciadores de armazenamento que suportam a interface XBSA incluem Legato NetWorker e Veritas NetBackup. ------------------------------------------------------------------------ |Data Warehouse Center Manual de Administrao ------------------------------------------------------------------------ |28.1 Atualizao Disponvel |O Data Warehouse Center Manual de Administrao foi atualizado como parte |do FixPak 4. O PDF mais recente est disponvel para download online em |http://www.ibm.com/software/data/db2/udb/winos2unix/support.As |informaes nessas notas so complementares referncia atualizada. |Toda a documentao atualizada tambm est disponvel no CD. Esse CD |pode ser solicitado atravs do servio DB2 utilizando a PTF nmero |U478862. Informaes sobre como entrar em contato com o Servio DB2 |esto disponveis no endereo http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/help.d2w/report. ------------------------------------------------------------------------ |28.2 Melhorias do Servidor Warehouse | |As seguintes melhorias foram feitas no servidor warehouse do FixPak |5: | |Atualizando parmetros de configurao |O servidor no mais atualizar parmetros de configurao crtica, tais |como nomes de servio para uma cadeia vazia. |Mensagem DWC7906 atualizada |Mensagem DWC7906 agora contm nomes de etapas predecessoras quando |reportando problemas de dependncia. | |As seguintes melhorias foram feitas no servidor warehouse do FixPak |4: | |Erro no encerramento do agente (rc = 7170), rc secund rio = 6106. |Esse erro ocorreu quando o agente foi encerrado antes do servidor enviar |um pedido de encerramento. Esse erro foi relatado desnecessariamente e |no ser mais relatado. |Mensagem do sistema e coment rio gravados no arquivo de log |Quando um programa definido pelo usu rio tiver terminado a execuo, a |Mensagem do Sistema e o Coment rio sero gravados no arquivo de log do |armazm. Agora, essas mensagens so visveis na janela de exibio |Trabalho em Andamento. |A consolidao incremental funciona corretamente agora |Se ocorrer um erro quando uma etapa estiver ocupando um banco de dados de |destino e o valor da consolidao Incremental for maior que 0, todos os |resultados que tiverem sido consolidados antes do erro aparecero no banco de |dados de destino. Antes do FixPak 4, resultados parciais eram |excludos. |Impossvel executar o servidor warehouse depois de alterar o erro de nvel |de rastreio corrigido |O servidor de armazenamento recupera o nome do diretrio de registro de |log da vari vel de ambiente de sistema, VWS_LOGGING. Se VWS_LOGGING |estiver faltando, ou se apontar para um nome de diretrio inv lido, a vari vel |de ambiente de sistema TEMP ser utilizada no lugar. Se TEMP estiver |faltando, ou se apontar para um nome de diretrio inv lido, os arquivos de |rastreio do logger so gravados em c:\. Isso corrige um erro em |verses anteriores ao FixPak 4 que era causado pela recuperao de um nome de |diretrio de registro inv lido do registro. |Suporte adicional para comandos de consolidao em procedimentos |armazenados |O servidor de armazenamento envia um comando de consolidao para o agente |depois que os procedimentos armazenados definidos pelo usu rio foram |executados. |Contedo de Amostra aperfeioado |O servidor de armazenamento no tem mais que aguardar uma mensagem de |encerramento do agente, para que o Contedo de Amostra seja executado com mais |eficincia. |O tamanho dos arquivos de log de rastreio podem ser controlados agora |O tamanho de um arquivo de log de rastreio pode ser controlado utilizando |a nova vari vel de ambiente do sistema, VWS_SERVER_LOG_MAX. Se voc |definir o valor de VWS_SERVER_LOG_MAX para maior que 0, o servidor de |armazenamento parar de aumentar o arquivo de log quando atingir um tamanho |aproximadamente igual ao nmero de bytes indicado pelo valor de |VWS_SERVER_LOG_MAX. Quando o arquivo de log atinge o tamanho m ximo, as |entradas de log de rastreio mais recentes so retidas e as mais antigas so |sobrepostas. Ao executar o rastreio extensivo, |VWS_SERVER_LOG_MAX=150000000 (150M) um tamanho razo vel. | ------------------------------------------------------------------------ |28.3 Utilizando o Agente do OS/390 para Executar um Trillium Batch System JCL |O agente do OS/390 agora suporta o programa definido pelo usu rio Trillium |Batch System que criado pelo bloco de notas Importar Metadados do Data |Warehouse. Anteriormente, para executar um arquivo Trillium Batch |System JCL, voc tinha que utilizar o agente do Windows, AIX ou Solaris |Operating Environment para executar o JCL remotamente. Com essa |atualizao, voc pode iniciar o JCL com o agente OS/390. |Quando voc criar a etapa de programa definido pelo usu rio Trillium Batch |System utilizando o bloco de notas Importar Metadados para o Trillium Batch |System, voc deve selecionar Host remoto como sua conexo ao agente OS/390, |mesmo quando o JCL estiver no mesmo sistema que o agente. Todos os |parmetros para a conexo Hist remoto host devem ser digitados. |Depois que voc criar a etapa do programa definido pelo usu rio Trillium |Batch System, utilize o bloco de notas Propriedades do Trillium Batch System |para mudar o site do agente para o site do agente do OS/390 que voc deseja |utilizar. |Se o nome do arquivo JCL ou do arquivo de erros de sada contiver quaisquer |espaos em branco ou parnteses, voc deve coloc -los entre aspas quando |inseri-los nos campos de arquivo de erros Script, JCL ou |Sada. ------------------------------------------------------------------------ |28.4 Dois Novos Programas de Exemplo no Data Warehouse Center |Dois novos programas de exemplo esto includos com o Data Warehouse |Center: EEE_Load e File_Wait. Voc pode utilizar o programa |EEE_Load para criar etapas para executar o programa autocarregador DB2 UDB EEE |em seus processos de armazenamento. Utilize o programa File_Wait para |criar etapas que aguardaro por um arquivo, em seguida, execute a prxima |etapa em seu processo, quando o arquivo tornar-se disponvel. Para |obter mais informaes sobre esses programas, consulte o arquivo |README.UDP que est localizado no diretrio |..\SQLLIB\TEMPLATES\SAMPLES do sistema onde o servidor do Data |Warehouse Center est instalado. ------------------------------------------------------------------------ |28.5 Managing ETI.Extract(R) Conversion Programs with DB2 Warehouse Manager Atualizado |O Managing ETI.Extract(R) Conversion Programs with DB2 Warehouse |Manager foi atualizado e seu download pode ser efetuado online no endereo http://www.ibm.com/software/data/db2/udb/winos2unix/support. ------------------------------------------------------------------------ |28.6 Importando e Exportando Metadados Utilizando a CWMI (Common Warehouse Metadata Interchange) |28.6.1 Introduo |Alm do suporte existente para arquivos de linguagem de tag, o Data |Warehouse Center pode agora importar e exportar metadados para e de arquivos |XML que esto em conformidade com o padro Common Warehouse Metamodel |(CWM). A importao e a exportao desses arquivos XML em conformidade |com o CWM referida como Common Warehouse Metadata Interchange |(CWMI). |Voc pode importar e exportar metadados a partir dos seguintes objetos do |Data Warehouse Center: | * |Origens do Warehouse * |Destinos do Warehouse * |reas de assunto, incluindo relaes de processos, origens, destinos, |etapas e cascatas. * |Programas definidos pelo usu rio | |O utilit rio de importao e exportao CWMI no suporta atualmente |determinados tipos de metadados, incluindo: planejamentos, esquemas de |armazenamento, usu rios e grupos. |O Data Warehouse Center cria um arquivo de log que contm os resultados dos |processos de importao e exportao. Tipicamente, o arquivo de log |criado no diretrio x:\arquivos de programas\sqllib\logging |(em que x: a unidade onde o DB2 foi instalado) ou o |diretrio que voc especificou como a vari vel de ambiente VWS_LOGGING. |O arquivo de log texto simples, voc pode exibi-lo com qualquer editor de |textos. |28.6.2 Importando metadados |Voc pode importar metadados a partir do Data Warehouse Center ou da linha |de comandos. |Os novos objetos que so criados atravs do processo de importao so |atribudos ao grupo de segurana padro do Data Warehouse Center. Para |obter maiores informaes, consulte a seo "Atualizando a segurana aps a |importao" nesta Notas de Release. |Se estiver importando metadados sobre uma etapa, v rios arquivos podero |estar associados etapa. Os metadados sobre a etapa so armazenados em |um arquivo XML, mas s vezes uma etapa tem dados associados armazenados como |BLOBs. Os metadados BLOB tm o mesmo nome de arquivo do arquivo XML, |mas fica em arquivos separados que tm extenses numeradas. Todos os |arquivos de etapas relacionadas devem ficar no mesmo diretrio na |importao. |Atualizando etapas quando esto no modo de teste ou de produo |Um etapa deve estar no modo de desenvolvimento antes do Data Warehouse |Center poder atualizar seus metadados. Se ela estiver no modo de teste |ou de produo, rebaixe a etapa para o modo de desenvolvimento antes de |importar os metadados: | 1. |Efetue logon para o Data Warehouse Center. 2. |D um clique com o boto direito do mouse na etapa que deseja rebaixar e |clique em Modo. 3. |Clique em Desenvolvimento. | |Agora a etapa est no modo de desenvolvimento. Altere a etapa de |volta para o modo de teste ou de produo aps importar os metadados. |Importando dados a partir do Data Warehouse Center |Voc pode importar metadados a partir do Data Warehouse Center: | 1. |Efetue logon para o Data Warehouse Center. 2. |No painel esquerdo, clique em Warehouse. 3. |Clique em Selecionado --> Importar metadados |--> Arquivo de Intercmbio... 4. |Na janela Importar metadados, especifique o nome do arquivo que contm os |metadados que deseja importar. Voc pode digitar o nome do arquivo ou |procurar o arquivo. | o |Se souber a localizao, digite o caminho e o nome do arquivo completos |que deseja importar. Certifique-se de incluir a extenso de arquivo |.xml para especificar que deseja importar metadados no |formato XML ou o arquivo no ser processado corretamente. o |Para procurar os arquivos: | a. |Clique no boto de comando reticncias (...). b. |Na janela Arquivo, altere Arquivos do tipo para XML. c. |V para o diretrio correto e selecione o arquivo que deseja |importar. |Nota: O arquivo deve ter uma extenso .xml. | d. |Clique em OK. | | 5. |Na janela Importar metadados, clique em OK para |finalizar. A janela Progresso exibida enquanto o Data |Warehouse Center importar o arquivo. | |Utilizando a linha de comandos para importar metadados |Voc tambm pode usar a linha de comandos para importar metadados. A |seguir est a sintaxe do comando de importao: |CWMImport XML_file dwcControlDB |dwcUserId dwcPW [PREFIX = DWCtbschema] | XML_file O caminho e o nome do arquivo completos (incluindo a unidade e o diretrio) do arquivo XML que deseja importar. Esse parmetro obrigatrio. dwcControlDB O nome do warehouse control database para o qual deseja importar os metadados. Este parmetro necess rio. dwcUserId O ID do usu rio utilizado para se conectar ao banco de dados de controle do armazm. Esse parmetro obrigatrio. dwcPW A senha de usu rio utilizada para se conectar ao banco de dados de controle do armazm. Este parmetro necess rio. [PREFIX=DWCtbschema] O nome do esquema de banco de dados para as tabelas de sistema do Data Warehouse Center. Se nenhum valor for especificado para PREFIX=, o nome do esquema padro ser IWH. Esse parmetro opcional. |28.6.3 Atualizando os metadados Aps Executar o Utilit rio de Importao |Atualizando a segurana aps a importao |Como uma medida de segurana, o Data Warehouse Center no importa ou |exporta senhas. Voc precisa atualizar as senhas nos novos objetos, |conforme necess rio. Para obter maiores detalhes sobre consideraes de |importao, consulte a publicao Data Warehouse Center Administration |Guide, Captulo 12, "Exportando e importando metadados do Data Warehouse |Center." |Ao importar metadados, todos os objetos sero atribudos ao grupo de |segurana padro. Voc pode alterar os grupos que tm acesso ao |objeto: | 1. |Efetue logon para o Data Warehouse Center. 2. |D um clique com o boto direito do mouse na pasta que contm o objeto que |deseja alterar. 3. |Clique em Propriedades e, em seguida, na guia |Segurana. 4. |Remova grupos da lista Grupos de warehouse selecionados ou |inclua grupos da lista Grupos de warehouse disponveis. 5. |Clique em OK. | |28.6.4 Exportando metadados |Voc pode exportar metadados a partir do Data Warehouse Center ou da linha |de comandos. |Algumas etapas tm metadados que esto armazenados como BLOB. Um |metadados BLOB exportado para um arquivo separados que tem o mesmo nome de |arquivo do arquivo XML da etapa, mas com uma extenso numerada |(.1, .2 e assim por diante). |Exportando dados a partir do Data Warehouse Center |Voc pode exportar metadados a partir do Data Warehouse Center: | 1. |Efetue logon para o Data Warehouse Center. 2. |No painel esquerdo, clique em Warehouse. 3. |Clique em Selecionado --> Exportar |metadados--> Arquivo de intercmbio. 4. |Na janela Exportar metadados, especifique o nome do arquivo que conter os |metadados exportados. Voc pode digitar o nome do arquivo ou procurar o |arquivo: | o |Se souber o caminho e o nome do arquivo completos que deseja usar, |digite-o no campo de entrada Nome do arquivo. Certifique-se |de incluir a extenso de arquivo .xml para especificar que |deseja exportar metadados no formato XML. o |Para procurar os arquivos: | a. |Clique no boto de comando reticncias (...). b. |Na janela Arquivo, altere Arquivos do tipo para |XML. c. |V para o diretrio correto e selecione o arquivo que deseja que contenha |os metadados exportados. |Nota: Qualquer arquivo existente selecionado ser sobreposto pelo metadados |exportado. | d. |Clique em OK. | | 5. |Quando a janela Exportar metadados exibir o nome do arquivo correto, |clique no objeto na lista Objetos disponveis cujos metadados |deseja exportar. 6. |Clique no sinal > para mover o objeto selecionado da lista |Objetos disponveis para a lista Objetos |selecionados. Repita esse processo at todos os objetos que |deseja exportar constarem na lista Objetos selecionados. 7. |Clique em OK. | |O Data Warehouse Center cria um arquivo de entrada, que contm |informaes sobre os objetos do Data Warehouse Center selecionados para |exportao e, ento, exporta os metadados sobre esses objetos. A janela |Progresso exibida enquanto o Data Warehouse Center est exportando os |metadados. |Utilizando a linha de comandos para exportar metadados |Antes de exportar metadados a partir da linha de comandos, crie primeiro um |arquivo de entrada. O arquivo de entrada um arquivo de |texto com uma extenso .INP e lista todos os objetos pelo |tipo de objeto que deseja exportar. Quando voc exporta a partir do |Data Warehouse Center, o arquivo de entrada criado automaticamente, mas para |exportar a partir da linha de comandos necess rio primeiro criar o arquivo |de entrada. Voc pode criar o arquivo de entrada com qualquer editor de |texto. Digite todos os nomes de objetos conforme aparecem no Data |Warehouse Center. Verifique se criou o arquivo em um diretrio de |leitura/gravao. Quando voc executar o utilit rio de exportao, o |Data Warehouse Center gravar os arquivos XML no mesmo diretrio onde est |localizado o arquivo de entrada. |A seguir h um arquivo de entrada de amostra: | |Tutorial Fact Table Process | |Tutorial file source |Tutorial target | |New Program group |Na seo (processos), liste todos os processos que |deseja exportar. Na seo (recursos de informao), |liste todas as origens e destinos do warehouse que deseja exportar. O |Data Warehouse Center inclui automaticamente as tabelas e colunas que esto |associadas a essas origens e destinos. Na seo |(programas definidos pelo usu rio), liste todos os grupos de programas que |deseja exportar. |Para exportar metadados, digite o seguinte comando em um prompt de comandos |do DOS: |CWMExport INPcontrol_file dwcControlDB |dwcUserID dwcPW [PREFIX=DWCtbschema] | INPcontrol_file O caminho e o nome do arquivo completos (incluindo a unidade e o diretrio) do arquivo .INP que contm os objetos que deseja exportar. Esse parmetro obrigatrio. dwcControlDB O nome do warehouse control database a partir do qual deseja exportar. Esse parmetro obrigatrio. dwcUserID O ID do usu rio utilizado para se conectar ao banco de dados de controle do armazm. Esse parmetro obrigatrio. dwcPW A senha utilizada para se conectar ao banco de dados de controle do armazm. Esse parmetro obrigatrio. [PREFIX=DWCtbschema] O nome do esquema de banco de dados para as tabelas de sistema do Data Warehouse Center. Se nenhum valor for especificado para PREFIX=, o valor padro ser IWH. Esse parmetro opcional. ------------------------------------------------------------------------ |28.7 Utilit rio de Importao/Exportao de Metadados da Linguagem de Marcao | | | | |28.7.1 Definies de Chaves |As chaves principal e externa definidas em arquivos de linguagem de |marcao sero ignoradas se forem as mesmas daquelas j definidas no banco de |dados de controle. Ocorrer um erro se as chaves forem diferentes das |que j foram definidas. |28.7.2 Planejamentos de Etapas e Processos | | | | | |Os planejamentos de etapas e processos no so mais excludos pelo |utilit rio de importao. Os planejamentos definidos em um arquivo de |marcao so includos na lista atual de planejamentos. Isso pode fazer |com que apaream planejamentos duplicados. Os planejamentos duplicados |devem ser excludos pelo usu rio antes da promoo de etapas para o modo de |produo. ------------------------------------------------------------------------ |28.8 Informaes da Etapa SAP |28.8.1 Possibilidade de Criar Tabela Logicamente Inconsistente |Se todas as condies a seguir foram atendidas, a tabela de destino |resultante pode no ser logicamente consistente. | 1. |O BO tem parmetros de exportao GetList e GetDetail e voc mapeou todos |os campos chave. 2. |Na p gina Parmetros de Sada do bloco de notas propriedades da etapa SAP, |selecione um parmetro de exportao GetList cujo nome de parmetro SAP seja |diferente do utilizado para o mapeamento do parmetro. |Nota: O nome do parmetro SAP refere-se parte do parmetro que aparece antes do |ponto no nome completo. Por exemplo, para o parmetro |DocList.DOCNUMBER, "DocList" o nome do parmetro SAP. | 3. |Na p gina Parmetros de Sada do bloco de notas Propriedades da etapa SAP, |selecione o parmetro de exportao GetDetail. | |Exemplo: |DocumentNumber um campo chave. DocList.DOCNUMBER e |DocNumberSelection.OPTION so parmetros de exportao GetList. |DocData.USERNAME um parmetro de exportao GetDetail. |Voc mapeia DocumentNumber para DocList.DOCNUMBER. (Condio |1) |Voc seleciona DocNumberSelection.OPTION como um parmetro de |sada. (Condio 2, j que DocNumberSelection e DocList so nomes de |parmetros SAP diferentes.) |Voc seleciona DocData.USERNAME como um parmetro de sada. |(Condio 3, j que um parmetro de exportao GetDetail.) |Essas condies resultam em uma tabela de destino cujas origens de colunas |so parmetros GetList e GetDetail. A consistncia lgica da relao |entre as colunas, no entanto, no est assegurada. ------------------------------------------------------------------------ |28.9 Informaes do Conector SAP | | | |28.9.1 Restries Instalao do Conector SAP |O Conector SAP suporta apenas instalaes no idioma ingls do sistema SAP |R/3. |28.9.2 Desempenho de GetDetail BAPI |Se GetDetail tiver um grande nmero de parmetros de entrada, o desempenho |de GetDetail BAPI ser lento. ------------------------------------------------------------------------ DB2 OLAP Starter Kit |O IBM DB2 OLAP Starter Kit 7.2 inclui suporte aos sistemas de |gerenciamento do banco de dados relacionais (RDBMSs) Oracle, MS-SQL, Sybase e |Informix en determinadas plataformas do sistema operacional. A Verso |7.2 contm scripts e ferramentas para todos os RDBMSs suportados, |incluindo DB2. Existem algumas restries; consulte a seo29.10, Problemas e Limitaes Conhecidos para obter mais informaes. |O nvel de servio do DB2 OLAP Starter Kit para DB2 Universal |Database Verso 7.2 o equivalente de correo 2 para Hyperion Essbase |6.1, alm da correo 2 para Hyperion Integration Server |2.0. ------------------------------------------------------------------------ |29.1 Site da Web do OLAP Server |Para obter as dicas mais recentes sobre instalao e uso do DB2 OLAP |Starter Kit, verifique a p gina Library do site da Web do DB2 OLAP |Server: |http://www.ibm.com/software/data/db2/db2olap/library.html ------------------------------------------------------------------------ |29.2 Nveis de Servios do Sistema Operacional Suportados |Os componentes do servidor do OLAP Starter Kit para Verso 7.2 |suportam os seguintes sistemas operacionais e nveis de servio: | * |Servidores Windows NT 4.0 com SP 5 e Windows 2000 * |AIX verso 4.3.3 ou superior * |Verso 2.6, 7 e 8 do Sistema Operacional Solaris (Sun OS |5.6, 5.7 ou 5.8) | |Os componentes do cliente so executados no Windows 95, Windows 98, Windows |NT 4.0 SP5 e Windows 2000. ------------------------------------------------------------------------ 29.3 Concluindo a Configurao do DB2 OLAP Starter Kit no UNIX A instalao do DB2 OLAP Starter Kit segue os procedimentos b sicos da instalao do DB2 Universal Database para UNIX. Os arquivos de produtos so colocados pelo programa de instalao em um diretrio do sistema: (para AIX: /usr/lpp/db2_07_01; para Solaris: /opt/IBMdb2/V7.1). Durante a fase de criao da instncia, dois diretrios DB2 OLAP so criados (essbase e is) dentro do diretrio pessoal do usu rio da instncia em sqllib. Somente uma instncia do OLAP Server pode ser executada por vez em uma m quina. Para completar a configurao, o usu rio deve definir manualmente o diretrio is/bin para que ele no seja um link para o diretrio is/bin no sistema. Ele dever fazer um link com um diretrio que pode ser gravado dentro do diretrio pessoal da instncia. Para completar a configurao do Solaris, efetue um logon utilizando o ID da instncia, mude para o diretrio sqllib/is e digite: rm bin mkdir bin cd bin ln -s /opt/IBMdb2/V7.1/is/bin/ismesg.mdb ismesg.mdb ln -s /opt/IBMdb2/V7.1/is/bin/olapicmd olapicmd ln -s /opt/IBMdb2/V7.1/is/bin/olapisvr olapisvr ln -s /opt/IBMdb2/V7.1/is/bin/essbase.mdb essbase.mdb ln -s /opt/IBMdb2/V7.1/is/bin/libolapams.so libolapams.so ------------------------------------------------------------------------ |29.4 Configurao Adicional para o Ambiente Operacional Solaris |No Ambiente Operacional Solaris, voc poder encontrar erros se o OLAP |Starter Kit no estiver ligado ao driver ODBC apropriado. Para evitar |esses erros, execute o comando a seguir, que cria um link em |$ARBORPATH/bin para apontar para o driver OLAP |sqllib/lib/libdb2.so: | ln -s $HOME/sqllib/lib/libdb2.so libodbcinst.so | ------------------------------------------------------------------------ |29.5 Configurao Adicional para Todos os Sistemas Operacionais |Iniciando no FixPak 3 do DB2 Universal Database Verso 7, o DB2 OLAP |Starter Kit inclui funes que requerem Java. Depois de instalar o |FixPak 3 ou posterior, voc poder ver a seguinte mensagem de erro no console |do OLAP Server: |Impossvel encontrar [diretrio] [/export/home/arbor7sk/sqllib/essbase/java/], |obrigatrio para carregar a JVM. | |Para corrigir esse erro, execute as seguintes etapas: | 1. |Efetue logon como o propriet rio da instncia do DB2. 2. |Procure o diretrio no qual o DB2 OLAP Starter Kit foi instalado. O |nome padro desse diretrio essbase. 3. |No diretrio essbase, crie um subdiretrio chamado java. 4. |No subdiretrio java, crie os seguintes arquivos vazios: | o |essbase.jar o |essdefs.dtd o |jaxp.jar o |parser.jar o |udf.policy | | ------------------------------------------------------------------------ |29.6 Configurando o ODBC para o OLAP Starter Kit |O IBM DB2 OLAP Starer Kit 7.2 requer um arquivo ODBC.ini para |operao de conexes ao Open Database Connectivity (ODBC) do OLAP Integration |Server para a origem de dados relacionais e para o OLAP Metadata |Catalog. | * |Em sistemas Windows, este arquivo encontra-se no Registro em |HKEY_LOCAL_MACHINE/SOFTWARE/ODBC. Utilize o ODBC Data Source |Administrator para armazenar informaes sobre como conectar-se a uma origem |de dados relacional. * |Em sistemas UNIX, o programa de instalao cria um arquivo |odbc.ini de modelo. Para armazenar informaes sobre |como conectar-se a uma origem de dados relacional, edite o arquivo utilizando |seu editor preferido. | |O aquivo ODBC.ini est disponvel em pacotes de software ODBC e est |includo com o software Microsoft Office. Informaes adicionais sobre |os aplicativos que instalam os drivers ODBC ou o ODBC Administrator esto |disponveis no seguinte site na Web: |http://support.microsoft.com/. |Para usu rios Oracle em m quinas AIX: Para configurar o ODBC para |Oracle, voc deve atualizar o arquivo ODBC.ini para indicar |os drivers MERANT 3.6. |Na Verso 7.2, o OLAP Starter Kit gerencia conexes ODBC origem de |dados relacional e ao OLAP Metadata Catalog. Para acomodar essas |conexes ODBC, o OLAP Starter Kit utiliza os drivers ODBC no Windows NT |4.0, Windows 2000, AIX e Solaris. | * |Cliente do Banco de Dados DB2 Universal Database Verso 6: Drivers |ODBC do DB2 Verso 6 no Sistema Operacional Windows NT 4.0 SP5 ou |Windows 2000, AIX 4.3.3 e Solaris 2.6, 7 ou 8 (Sun OS |5.6, 5.7 ou 5.8). * |Cliente do Banco de Dados DB2 Universal Database 7.1: Drivers |ODBC do DB2 Verso 7 no Sistema Operacional Windows NT 4.0 SP5 ou |Windows 2000, AIX 4.3.3 e Solaris 2.6, 7 ou 8 (Sun OS |5.6, 5.7 ou 5.8). * |Cliente do Banco de Dados Oracle 8.04 e 8i SQL*Net |8.0: Drivers ODBC MERANT 3.6 no Sistema Operacional |Windows NT 4.0 SP5 ou Windows 2000, AIX 4.3.3, Solaris |2.6, 7 ou 8 (Sun OS 5.6, 5.7 ou 5.8). * |MS SQL Server 6.5.201 (nenhum Cliente do Banco de Dados |requerido): Drivers ODBC MS SQL Server 6.5 no Windows NT |4.0 SP5 ou Windows 2000. * |MS SQL Server 7.0 (nenhum Cliente do Banco de Dados |requerido): Drivers ODBC MS SQL Server 7.0 no Windows NT |4.0 SP5 ou Windows 2000. | |29.6.1 Configurando Origens de Dados em Sistemas UNIX |No AIX e Solaris, voc deve definir manualmente as vari veis de ambiente |para ODBC e editar o arquivo odbc.ini para configurar a |origem de dados relacional e o OLAP Metadata Catalog. Certifique-se de |editar o arquivo odbc.ini, se voc incluir um novo driver ou |origem de dados ou se voc alterar o driver ou a origem de dados. |Se voc for utilizar o DB2 OLAP Starter Kit no AIX ou Solaris para acessar |origens Merant ODBC e bancos de dados DB2, altere o valor do atributo |"Driver=" na seo de origem do DB2 do arquivo |.odbc.ini como a seguir: |AIX: O nome do driver /usr/lpp/db2_07_01/lib/db2_36.o |Amostra de entrada de origem ODBC para AIX: |[SAMPLE] Driver=/usr/lpp/db2_07_01/lib/db2_36.o |Description=DB2 ODBC Database |Banco de Dados=SAMPLE |Ambiente Operacional Solaris: O nome do Driver |/opt/IBMdb2/V7.1/lib/libdb2_36.so |Amostra de entrada de origem ODBC para Solaris: |[SAMPLE] Driver=/opt/IBMdb2/V7.1/lib/libdb2_36.so |Description=DB2 ODBC Database |Banco de Dados=SAMPLE |29.6.1.1 Configurando as Vari veis de Ambiente ODBC |Em sistemas UNIX, voc deve definir as vari veis de ambiente para ativar o |acesso aos componentes de ncleo do ODBC. Os scripts de shell |is.sh e is.csh que definem as vari veis |requeridas so fornecidos no diretrio pessoal do Starter Kit. Voc |deve executar um desses scripts antes de utilizar o ODBC para conectar-se s |origens de dados. Voc deve incluir esses scripts no script de incio |de sesso para o nome do usu rio utilizado para executar o OLAP Starter |Kit. |29.6.1.2 Editando o Arquivo odbc.ini |Para configurar uma origem de dados em um arquivo odbc.ini, voc |deve incluir um nome e uma descrio para a origem de dados ODBC e fornecer o |caminho do driver ODBC, o nome do arquivo e outras definies do driver em uma |seo separada que voc cria para o nome da origem de dados. O programa |de instalao instala um arquivo odbc.ini de amostra no |diretrio ISHOME. O arquivo contm conexes ODBC genricas e |informaes de configurao para drivers ODBCs suportados. Utilize o |arquivo como um ponto de partida para mapear os drivers ODBCs que voc utiliza |para a origem de dados relacional e OLAP Metadata Catalog. |Se voc utilizar um arquivo diferente do arquivo |odbc.ini, certifique-se de definir a vari vel de ambiente |ODBCINI para o nome do arquivo utilizado. |29.6.1.3 Incluindo uma Origem de Dados em um Arquivo odbc.ini | 1. |No sistema que est executando os servidores OLAP Starter Kit, abra o |arquivo odbc.ini utilizando um editor de texto tal como |vi. 2. |Procure a seo que comea com [ODBC Data Sources] e inclua uma nova linha |com o nome e a descrio da origem de dados, tal como: mydata=data |source for analysis. Para minimizar a confuso, o nome da origem |de dados deve corresponder ao nome do banco de dados no RDBMS. 3. |Inclua uma nova seo no arquivo, criando uma nova linha com o nome da |nova origem de dados colocada entre colchetes, tal como: |[mydata]. 4. |Nas linhas que seguem o nome da origem de dados, inclua o nome do caminho |e do arquivo completo para o driver ODBC requerido para essa origem de dados e |quaisquer outras informaes do driver ODBC requeridas. Utilize os |exemplos mostrados nas sees a seguir como uma instruo para mapear a origem |de dados em seu RDBMS. Certifique-se de que o arquivo de driver ODBC |exista atualmente na localizao especificada para a definio |Driver=. 5. |Quando tiver terminado de editar o odbc.ini, salve o |arquivo e saia do editor de texto. | |29.6.1.4 Exemplo de Definies ODBC para DB2 |O exemplo a seguir mostra como voc pode editar o |odbc.ini para conectar-se a uma origem de dados relacional, |db2data, no DB2 Universal Database Verso 6.1 no AIX, |utilizando um driver ODBC IBM DB2 nativo. No editor vi, |utilize o comando $ODBCINI para editar o odbc.ini |e insira as seguintes instrues: | [ODBC Data Sources] | db2data=DB2 Source Data no AIX | ... | [db2data] | Driver=/home/db2inst1/sqllib/lib/db2.o | Description=DB2 Data Source - AIX, native |29.6.1.5 Exemplo de Definies ODBC para Oracle |Aqui encontra-se um exemplo de como voc pode editar o |odbc.ini para conectar-se a uma origem de dados relacional, |oradata, no Oracle Verso 8 (no Solaris), utilizando um driver ODBC |MERANT Verso 3.6. Nesse exemplo, o ID de Incio de |Sesso e a Senha so substitudos por valores atuais |utilizados no nome do usu rio e na senha do OLAP Starter Kit. | [ODBC Data Sources] | oradata=Oracle8 Source Data no Solaris | ... | [myoracle] Driver= | /export/home/users/dkendric/is200/odbclib/ARor815.so | Description=my oracle source |29.6.2 Configurando o OLAP Metadata Catalog em Sistemas UNIX |Configurar um OLAP Metadata Catalog no AIX e Solaris semelhante a |configurar uma origem de dados. Para o banco de dados OLAP Metadata |Catalog, inclua um nome de origem de dados e uma seo no arquivo |odbc.ini, conforme descrito na seo 29.6.1.2, Editando o Arquivo odbc.ini. Nenhuma outra alterao |requerida. |Voc deve criar um banco de dados OLAP Metadata Catalog em um RDBMS |suportado, antes de configur -lo como uma origem de dados ODBC. |Aqui encontra-se um exemplo de como voc pode editar o |odbc.ini para conectar-se ao OLAP Metadata Catalog, TBC_MD, |no DB2 Verso 6.1 (no Solaris), utilizando um driver ODBC nativo: | [ODBC Data Sources] | ocd6a5a=db2 v6 | ... | [ocd6a5a] | Driver=/home/db2instl/sqllib/lib/db2.0 | Description=db2 |29.6.3 Configurando as Origens de Dados em Sistemas Windows |Para configurar uma origem de dados relacional em sistemas Windows NT ou |Windows 2000, voc deve iniciar o ODBC Administrator e criar uma conexo com a |origem de dados que voc utilizar para criar modelos e metacontornos do |OLAP. Execute o utilit rio ODBC Administrator do Painel de Controle do |Windows. O exemplo a seguir cria uma origem de dados DB2; as |caixas de di logo para outros RDBMSs iro diferir. |Para configurar uma origem de dados relacional com o ODBC Administrator, |complete as seguintes etapas: | 1. |No desktop do Windows, abra a janela Painel de Controle. 2. |Na janela Painel de Controle, execute uma das seguintes etapas: | a. |No Windows NT, d um clique duplo no cone ODBC para abrir a |caixa de di logo ODBC Data Source Administrator. b. |No Windows 2000, d um clique duplo no cone Ferramentas |Administrativas e d um clique duplo no cone Origens de Dados |(ODBC) para abrir a caixa de di logo ODBC Data Source |Administrator. | 3. |Na caixa de di logo ODBC Data Source Administrator, clique na guia |DSN do Sistema. 4. |Clique em Incluir para abrir a caixa de di logo Criar Nova |Origem de Dados. 5. |No quadro de listagem do driver da caixa de di logo Criar Nova Origem de |Dados do ODBC Administrator, selecione um driver apropriado, tal como IBM |DB2 ODBC Driver e clique em Concluir para abrir a caixa de |di logo Driver ODBC IBMDB2 - Incluir. 6. |Na caixa de di logo Driver ODBC IBM DB2 - Incluir, na lista drop down |Alias do banco de dados, selecione o nome do banco de dados para |seus dados de origem relacionais (por exemplo, TBC no aplicativo de |amostra). 7. |Na caixa de texto Descrio, digite uma descrio opcional que |indica como utilizar esse driver e clique em Incluir. Por |exemplo, digite as palavras a seguir para descrever o banco de dados Meus |Negcios: |Clientes, produtos, mercados |Voc pode digitar as palavras a seguir para descrever o banco de dados do |aplicativo de amostra: |Origem de dados relacional de amostra |As descries ajudam identificar as origens de dados disponveis para sua |seleo, quando voc conectar-se do OLAP Starter Kit Desktop. 8. |Clique em OK para retornar caixa de di logo ODBC Data Source |Administrator. O nome da origem de dados digitado e o driver mapeado |para ele, so exibidos no quadro de listagem Origens de Dados do |Sistema na guia DSN do Sistema. | |Para editar as informaes de configurao para uma origem de dados: | 1. |Selecione o nome da origem de dados e clique em Configurar para |abrir a caixa de di logo ODBC IBM DB2 - Incluir. 2. |Corrija quaisquer informaes que deseja alterar. 3. |Clique em OK duas vezes para sair. | |29.6.4 Configurando o OLAP Metadata Catalog em Sistemas Windows |Para configurar um OLAP Metadata Catalog no Windows NT ou Windows 2000, |inicie o ODBC Administrator e crie uma conexo com a origem de dados que |contm o banco de dados OLAP Metadata Catalog. |O exemplo a seguir cria uma origem de dados DB2; as caixas de di logo |para outros RDBMSs iro diferir. Para criar uma origem de dados para o |OLAP Metadata Catalog, complete as seguintes etapas: | 1. |No desktop, abra a janela Painel de Controle. 2. |Na janela Painel de Controle, execute uma das seguintes etapas: | a. |No Windows NT, d um clique duplo no cone ODBC para abrir a |caixa de di logo ODBC Data Source Administrator. b. |No Windows 2000, d um clique duplo no cone Ferramentas |Administrativas e d um clique duplo no cone Origens de Dados |(ODBC) para abrir a caixa de di logo ODBC Data Source |Administrator. | 3. |Na caixa de di logo ODBC Data Source Administrator, clique na guia |DSN do Sistema. 4. |Clique em Incluir para abrir a caixa de di logo Criar Nova |Origem de Dados. 5. |No quadro de listagem do driver da caixa de di logo Criar Nova Origem de |Dados do ODBC Administrator, selecione um driver apropriado, tal como IBM |DB2 ODBC Driver e clique em Concluir para abrir a caixa de |di logo Driver ODBC IBMDB2 - Incluir. 6. |Na caixa de di logo Driver ODBC IBM DB2 - Incluir, na lista drop down |Alias do banco de dados, selecione o nome do banco de dados para |seu OLAP Metadata Catalog (por exemplo, TBC_MD no aplicativo de |amostra). O nome do banco de dados selecionado automaticamente |exibido na caixa de texto Nome de Origem de Dados. 7. |Se desejar alterar o nome da origem de dados, selecione o nome exibido na |caixa de texto Nome da Origem de Dados, digite um novo nome para |indicar como utilizar esse driver e clique em Incluir. Por |exemplo, voc pode digitar o nome a seguir para indicar que est utilizando o |driver para conectar-se ao primeiro OLAP Metadata Catalog: |Primeiro OLAP Catalog |Voc digitar o nome a seguir para indicar que est conectando-se ao banco |de dados OLAP Metadata Catalog do aplicativo de amostra: | TBC_MD 8. |Na caixa de texto Descrio, digite uma descrio que indica |como utilizar esse driver. Por exemplo, voc pode digitar as palavras a |seguir para descrever o OLAP Metadata Catalog: |Meus primeiros modelos e metacontornos |Voc pode digitar as palavras a seguir para descrever o banco de dados |OLAP Metadata Catalog do aplicativo de amostra: |Modelos e metacontornos de amostra |O auxlio de descries o ajudam a identificar o cat logo que deseja |selecionar quando conectar-se ao OLAP Metadata Catalog do OLAP Starter Kit |Desktop. 9. |Clique em OK para retornar caixa de di logo ODBC Data Source |Administrator. O nome da origem de dados digitado e o driver mapeado |para ele, so exibidos no quadro de listagem Origens de Dados do |Sistema na guia DSN do Sistema. | |Para editar as informaes de configurao para uma origem de dados: | 1. |Selecione o nome da origem de dados e clique em Configurar para |abrir a caixa de di logo ODBC IBM DB2 - Incluir. 2. |Corrija quaisquer informaes que deseja alterar. 3. |Clique em OK duas vezes para sair. | |29.6.5 Aps Voc Configurar uma Origem de Dados |Aps voc configurar a origem de dados relacional e o OLAP Metadata |Catalog, poder conectar-se a eles do OLAP Starter Kit. Voc pode |criar, modificar e salvar modelos e metacontornos OLAP. |O driver ODBC do SQL Server pode esgotar o timeout durante uma chamada para |um banco de dados SQL Server. Tente novamente quando o banco de dados |no estiver ocupado. Aumentar o perodo do timeout do driver pode |evitar esse problema. Para obter mais informaes, consulte a |documentao ODBC para obter o driver que est utilizando. |Para obter mais informaes sobre os problemas e as solues da conexo |ODBC, consulte a publicao OLAP Integration Server System |Administrator's |Guide. ------------------------------------------------------------------------ 29.7 Iniciando sesso do OLAP Starter Kit Desktop Para utilizar o OLAP Starter Kit Desktop para criar os modelos e metacontornos OLAP, voc deve conectar-se ao software do cliente para os dois componentes do servidor: DB2 OLAP Integration Server e DB2 OLAP Server. O di logo de login solicita as informaes necess rias do Desktop para a conexo com esses dois servidores. No lado esquerdo do di logo, digite as informaes sobre o DB2 OLAP Integration Server. No lado direito, digite as informaes sobre o DB2 OLAP Server. Para se conectar com o DB2 OLAP Integration Server: * Servidor: Digite o nome do host ou o endereo IP do Integration Server. Se tiver instalado o Integration Server na mesma estao de trabalho do desktop, os valores tpicos sero "localhost" ou "127.0.0.1". * Cat logo de metadados OLAP: Quando se conectar com o OLAP Integration Server, voc tambm dever especificar um Cat logo de metadados. O OLAP Integration Server armazena informaes sobre os modelos e metaoutlines OLAP que voc criou em um banco de dados relacional conhecido como Cat logo de metadados. Esse banco de dados relacional dever ser registrado pelo ODBC. O banco de dados do cat logo contm um conjunto especial de tabelas relacionais que o OLAP Integration Server reconhece. No di logo de login, voc pode especificar um Integration Server e depois expandir o menu sobreposto do campo OLAP Metadata Catalog para ver uma lista dos nomes das origens de dados ODBC conhecidos do OLAP Integration Server. Escolha um banco de dados ODBC que contm as tabelas de cat logo dos metadados. * Nome de Usu rio e Senha: O OLAP Integration Server ser conectado com o Cat logo de metadados utilizando o Nome de usu rio e senha que voc especificou neste painel. Essa uma conta de login que existe no servidor (no no cliente, a menos que o servidor e o cliente estejam sendo executados na mesma m quina). O nome do usu rio dever ser o do usu rio que criou o Cat logo de metadados OLAP. Caso contr rio, o OLAP Integration Server no encontrar as tabelas relacionais no banco de dados do cat logo porque os nomes dos esquemas das tabelas so diferentes. As informaes do DB2 OLAP Server so opcionais, portanto os campos de entrada do lado direito do di logo Login podero ser deixados em branco. Contudo, algumas operaes feitas no Desktop e no Administration Manager exigem que voc se conecte com um DB2 OLAP Server. Se voc deixar esses campos em branco, o Desktop exibir o di logo Login novamente se o Integration Server precisar se conectar com o DB2 OLAP Server a fim de completar uma operao que voc solicitou. Recomenda-se que voc sempre preencha os campos do DB2 OLAP Server no di logo Login. Para se conectar com o DB2 OLAP Server: * Servidor: Digite o nome do host ou o endereo IP do DB2 OLAP Server. Se estiver executando o OLAP Starter Kit, o OLAP Server e o Integration Server sero os mesmos. Se o Integration Server e o OLAP Server forem instalados em hosts diferentes, digite o nome do host ou um endereo de IP definido no OLAP Integration Server. * Nome de Usu rio e Senha: O OLAP Integration Server ser conectado com o DB2 OLAP Server utilizando o nome de usu rio e a senha que voc especificou neste painel. Esse nome de usu rio e essa senha devem j ter sido definidos no DB2 OLAP Server. O OLAP Server gerencia seus prprios nomes de usu rios e senhas separadamente a partir do sistema operacional do host. 29.7.1 Exemplo de Login do Starter Kit O exemplo a seguir supe que voc criou o OLAP Sample e selecionou db2admin como seu ID de usu rio do administrador e password como a senha do administrador durante a instalao do OLAP Starter Kit. * Para o OLAP Integration Server: o Server ser localhost, o OLAP Metadata Catalog ser TBC_MD, o User Name ser db2admin e a Password ser password * Para o DB2 OLAP Server: o Server ser localhost e o User Name ser db2admin ------------------------------------------------------------------------ 29.8 Criando e Configurando Manualmente os Bancos de Dados de Amostra para OLAP Starter Kit Os bancos de dados de amostra so criados automaticamente quando voc instala o OLAP Starter Kit. As instrues a seguir explicam como configurar os bancos de dados Catalog e Sample manualmente, se necess rio. 1. No Windows, abra a janela Centro de Comando com um clique em Iniciar -->Programas-->DB2 para Windows NT--> Janela de Comandos. 2. Crie o banco de dados do cat logo de produo: a. Digite db2 create db OLAP_CAT b. Digite db2 connect to OLAP_CAT 3. Crie as tabelas no banco de dados: a. Navegue para \SQLLIB\IS\ocscript\ocdb2.sql b. Digite db2 -tf ocdb2.sql 4. Crie o banco de dados de origem de amostra: a. Digite db2 connect reset b. Digite db2 create db TBC c. Digite db2 connect to TBC 5. Crie as tabelas no banco de dados: a. Navegue para \SQLLIB\IS\samples\ b. Copie tbcdb2.sql para \SQLLIB\samples\db2sampl\tbc c. Copie lddb2.sql para \SQLLIB\samples\db2sampl\tbc d. Navegue para \SQLLIB\samples\db2sampl\tbc e. Digite db2 -tf tbcdb2.sql f. Digite db2 - vf lddb2.sql para carregar os dados de origem de amostra nas tabelas. 6. Crie o banco de dados do cat logo de amostra: a. Digite db2 connect reset b. Digite db2 create db TBC_MD c. Digite db2 connect to TBC_MD 7. Crie as tabelas no banco de dados: a. Navegue para \SQLLIB\IS\samples\tbc_md b. Copie ocdb2.sql para \SQLLIB\samples\db2sampl\tbcmd c. Copie lcdb2.sql para \SQLLIB\samples\db2sampl\tbcmd d. Navegue para \SQLLIB\samples\db2sampl\tbcmd e. Digite db2 -tf ocdb2.sql f. Digite db2 -vf lcdb2.sql para carregar os metadados de amostra nas tabelas. 8. Configure ODBC para TBC_MD, TBC, AND OLAP_CAT: a. Abra o painel de controle do NT com um clique em Iniciar-->Configuraes-->Painel de Controle b. Selecione ODBC (ou origens de dados ODBC) a partir da lista. c. Selecione a guia System DSM. d. D um clique em Incluir. A janela Criar Nova Origem de Dados aberta. e. Selecione IBM DB2 ODBC DRIVER na lista. f. D um clique em Encerrar. A janela Driver ODBC IBM D2 - Incluir aberta. g. Digite o nome da origem de dados (OLAP_CAT) no campo Nome da origem de dados. h. Digite o nome do alias no campo Alias do banco de dados ou d um clique na seta voltada para baixo e selecione OLAP_CAT. i. D um clique em OK. j. Repita essas etapas para os bancos de dados TBC_MD e TBC. ------------------------------------------------------------------------ |29.9 Migrando Aplicativos para OLAP Starter Kit Verso 7.2 |O programa de instalao no reinstala os aplicativos de amostra, os bancos |de dados e os arquivos de dados do OLAP Starter Kit. Os aplicativos e |bancos de dados existentes no so afetados de nenhuma maneira. |Entretanto, sempre uma boa idia fazer backup de seus aplicativos e bancos |de dados antes de uma instalao. |Seus aplicativos so automaticamente migrados para a Verso 7.2 |quando voc os abre. ------------------------------------------------------------------------ |29.10 Problemas e Limitaes Conhecidos |Esta seo lista as limitaes conhecidas para o DB2 OLAP Starter |Kit. | |Compatibilidade do Informix RDBMS com Drivers Merant para Plataformas |Windows |Para que os drivers Merant para plataformas Windows funcionem com o |Informix RDBMS, as duas entradas a seguir devem ser includas na instruo |PATH: | o |C:\Informix o |C:\Informix\bin | |Ambas as entradas devem estar no incio do PATH. |Possvel Inconsistncia Entre Dimenses em Modelos OLAP e Metacontornos |Associados |Em determinadas condies, voc pode criar uma dimenso em um metacontorno |que no possui nenhuma dimenso correspondente no modelo do OLAP. Isso |pode ocorrer no seguinte cen rio: | 1. |Crie um novo modelo do OLAP e salve-o. 2. |Crie um metacontorno baseado no modelo, mas no salve o |metacontorno. 3. |Retorne para o modelo do OLAP e exclua uma dimenso na qual uma das |dimenses de metacontorno baseada. 4. |Retorne para o metacontorno, salve-o, feche-o e reabra-o. O |metacontorno conter uma dimenso que no possui uma dimenso correspondente |no modelo do OLAP. | |O OLAP Starter Kit no pode distinguir entre uma dimenso inconsistente |criada dessa meaneira e uma dimenso definida pelo usu rio em um |metacontorno. Conseqentemente, a dimenso inconsistente ser exibida |no metacontorno, mas o metacontorno a considera como uma dimenso definida |pelo usu rio, visto que nenhuma dimenso correspondente existe no modelo do |OLAP. |Em Plataformas Windows 2000, a Definio da Vari vel de Ambiente para o |TMP Faz Com Que o Membro e as Cargas de Dados Falhem |Devido a uma diferena nas definies do sistema padro e da vari vel de |ambiente para o TMP entre o Windows 2000 e o Windows NT, o membro e as cargas |de dados falham quando o OLAP Starter Kit est sendo executado em sistemas |Windows 2000. A mensagem de erro resultante informa os usu rios que o |arquivo tempor rio no pde ser criado. Voc pode solucionar essa |limitao no Windows 2000, considerando as seguintes etapas: | 1. |Crie um diretrio nomeado C:\TEMP 2. |Defina o TMP da vari vel de ambiente para o sistema e o usu rio como |TMP=C:\TEMP | |Instalao do ODBC No Substitui Driver Merant Existente |Os drivers ODBC Merant 3.6 existentes no sero atualizados com |esta instalao. Se voc estiver atualizando o OLAP Starter Kit Verso |7.1, fixpack 2 ou anterior, dever continuar utilizando os drivers ODBC |instalados anteriormente |Utilizando Drivers ODBC Merant Informix em Plataformas UNIX |Para utilizar os drivers ODBC Merant em plataformas UNIX, voc deve |executar um dos seguintes itens: | o |Antes de iniciar o Starter Kit, defina a vari vel de ambiente LANG como |"en_US". Por exemplo, para a shell korn, digite: |export LANG='en_US' |Defina essa vari vel toda vez que iniciar o OLAP Starter Kit. o |Se sua vari vel de ambiente LANG j estiver definida como um valor |diferente, efetue o seguinte link simblico aps a instalao: |ln -s $ISHOME/locale/en_US $ISHOME/locale/$LANG | |Misturando nveis de servios de clientes e servidores OLAP |A IBM recomenda que voc mantenha os componentes do cliente e do servidor |do DB2 OLAP Starter Kit na mesma verso e nvel de fixpack. Mas em |algumas situaes, voc pode conseguir misturar nveis de servios diferentes |de componentes de clientes e servidores: | |Utilizando clientes e servidores em nveis de servios diferentes dentro |de uma verso |A IBM no suporta o uso de clientes mais recentes com servidores mais |antigos, e recomenda o contr rio. Entretanto, voc pode conseguir |utilizar os clientes mais antigos com os servidores mais recentes, embora a |IBM no suporte isso. Voc pode ter alguns problemas. Por |exemplo: | + |As mensagens do servidor podem estar incorretas. Voc pode |solucionar esse problema, atualizando o arquivo message.MDB no cliente |para corresponder ao nvel no servidor. + |Os novos recursos do servidor no funcionam. O cliente, o servidor |ou ambos podem falhar quando voc tentar utilizar um novo recurso. + |O cliente no pode conectar-se corretamente ao servidor. | |Utilizando v rios servidores com um nico cliente dentro de uma verso |Se voc precisar conectar um cliente a v rios servidores OLAP em |diferentes m quinas ou sistemas operacionais, a IBM recomendar que voc os |deixe todos na mesma verso e nvel de servio. Seu cliente deve, no |mnimo, ser estar no mesmo que o servidor de nvel inferior. Se voc |tiver problemas, poder precisar utilizar m quinas clientes diferentes para |corresponderem ao host apropriado ou atualizar todos os clientes e servidores |para o mesmo nvel de servio. |Misturando clientes e servidores de diferentes verses |A IBM no suporta utilizar clientes e servidores OLAP Starter Kit da |Verso 7.1 com clientes e servidores da Verso 7.2. |Quando os produtos IBM OLAP so atualizados para um novo nvel de verso, |muitas vezes, existem atualizaes de redes e alteraes de formato de dados |que requerem que o cliente e o servidor estejam no mesmo nvel verso. |Misturando produtos IBM (DB2 OLAP Starter Kit) com produtos Hyperion |(Hyperion Essbase e Hyperion Integration Server) |A IBM no suporta a mistura de clientes e servidores OLAP da IBM com |clientes e servidores OLAP da Hyperion Solutions. Existem algumas |diferenas no recurso que podem causar problemas, embora a mistura desses |componentes pode funcionar em algumas situaes. | | ------------------------------------------------------------------------ 29.11 Arquivos EQD do Complemento da Planilha OLAP Faltando No DB2 OLAP Starter Kit, o complemento da planilha tem um componente chamado Query Designer (EQD). O menu da ajuda online do EQD contm um boto chamado Tutorial que no exibe nada.O material que deveria ser exibido nos tutoriais do EQD so um subconjunto do captulo dois do Guia do Usu rio OLAP Spreadsheet Add-in para Excel e do Guia do Usu rio OLAP Spreadsheet Add-in para 1-2-3.Todas as informaes do tutorial EQD esto disponveis em verses HTML desses manuais no Centro de Informaes e nas verses PDF. ------------------------------------------------------------------------ Manual de Administrao do Information Catalog Manager ------------------------------------------------------------------------ 30.1 Utilit rio de Inicializao do Gerenciador do Cat logo de Informaes 30.1.1 Com o utilit rio Initialize ICM (Information Catalog Manager), voc pode anexar uma instruo SQL ao fim da instruo CREATE TABLE utilizando o seguinte comando: CREATEIC \DBTYPE dbtype \DGNAME dgname \USERID userid \PASSWORD password \KA1 userid \TABOPT "directory:\tabopt.file" Voc pode especificar a palavra-chave TABOPT no utilit rio CREATEIC a partir do diretrio no qual o DB2 est instalado. O valor aps a palavra-chave TABOPT o nome do arquivo tabopt.arquivo com o caminho completo. Se o nome do diretrio tiver espaos em branco, coloque o nome entre aspas. O contedo do arquivo tabopt.arquivo deve conter informaes a serem anexadas instruo CREATE TABLE Voc pode utilizar qualquer uma das instrues SQL abaixo para gravar neste arquivo tabopt.file. O utilit rio ICM l esse arquivo e depois o anexa na instruo CREATE TABLE. Tabela 8. instrues SQL IN MYTABLESPACE Cria uma tabela com seus dados em MYTABLESPACE DATA CAPTURE CHANGES Cria uma tabela e registra alteraes no SQL no formato estendido IN ACCOUNTING INDEX IN Cria uma tabela com seus dados em ACCOUNTING ACCOUNT_IDX e seu ndice em ACCOUNT_IDX O tamanho m ximo do arquivo de contedo 1000 caracteres de byte simples. Esse novo recurso est disponvel somente em sistemas Windows e UNIX. 30.1.2 Questes de licenciamento Se voc receber a seguinte mensagem: FLG0083E: Voc no tem uma licena v lida para a IBM utilit rio de Inicializao do Gerenciador do Cat logo de Informaes. Entre em contato com seu revendedor local de software ou com o representante de vendas da IBM. Voc dever adquirir o DB2 Warehouse Manager ou o IBM DB2 OLAP Server e instalar o componente Gerenciador do Cat logo de Informaes, que inclui o utilit rio Inicializao do Cat logo de Informaes. 30.1.3 Questes de instalao Se tiver instalado o Gerenciador de Warehouse do DB2 ou o IBM DB2 OLAP Server e depois instalar um outro componente do Administrador do Gerenciador do Cat logo de Informaes (utilizando o CD-ROM do DB2 Universal Database) na mesma estao de trabalho, voc poder ter substitudo o utilit rio de Inicializao do Cat logo de Informaes. Nesse caso, do diretrio \sqllib\bin, localize os arquivos createic.bak e flgnmwcr.bak e renomeie-os como createic.exe e flgnmwcr.exe, respectivamente. Se voc instalar outros componentes do Gerenciador do Cat logo de Informaes a partir do DB2 Universal Database, os componentes devero ficar em uma estao de trabalho separada daquela em que voc instalou o Gerenciador de Data Warehouse. Para obter mais informaes, consulte o Captulo 3, Instalando os componentes do Gerenciador do Cat logo de Informao, da Publicao DB2 Warehouse Manager Installation Guide. ------------------------------------------------------------------------ |30.2 Melhorias para o Information Catalog Manager |O Information Catalog Manager inclui as seguintes melhorias: |O ICM suporta agora a importao de informaes do filtro ETI para o banco |de dados, tabela ou coluna de origem ou de destino. No Registro no |Armazm, um novo tipo de objeto ICM de Dados de Converso ETI utilizado para |armazenar as informaes do filtro. Esses objetos so ento ligados ao |banco de dados, tabela ou coluna de origem ou de destino para o qual tenham |sido definidos. |O ICM tem a capacidade de ligar um determinado banco de dados, tabela ou |coluna de origem ou de destino com v rios objetos de Dados de Converso ETI |como resultado do registro de diferentes Converses ETI no mesmo cat logo |ICM. |A mesma capacidade aplica-se a Transformaes em que uma determinada coluna |de destino pode agora conter v rias Transformaes como resultado do registro |de diferentes Converses ETI no mesmo cat logo ICM. Para isso, o ICM |fez alteraes na chave de Transformao ao importar um mapeamento |ETI*Extract. |Para ativar esses recursos, utilize o ETI*Extract 4.2.1 com o |MetaScheduler 4.1.0 para registrar-se no Gerenciador de Data |Warehouse. Mais informaes sobre como ativar esses recursos esto |disponveis na seo Dicas e Sugestes do DB2 Warehouse Manager em http://www.ibm.com/software/data/db2/datawarehouse/support.html. |Procure as palavras-chave "ETI" ou "Dados do Aplicativo". ------------------------------------------------------------------------ |30.3 Incompatibilidade entre o Information Catalog Manager e o Sybase no Ambiente Windows | | |A instalao do ICM (Information Catalog Manager) Verso 7 na mesma m quina |Windows NT ou Windows 2000 com Sybase Open Client resulta em um erro e o |Sybase Utilities p ra de funcionar. Uma mensagem de erro similar a esta | exibida: | Falha ao inicializar o LIBTCL.DLL. Verifique se a vari vel de ambiente |SYBASE est definida corretamente. |Evite esse cen rio removendo o parmetro de ambiente LC_ALL dos parmetros |do Ambiente Windows. LC_ALL um parmetro de categoria do |locale. As categorias de locale so constantes visveis utilizadas |pelas rotinas de localizao para especificar qual parte das informaes do |locale um programa deve usar. O locale refere-se |localidade (pas/regio) para a qual determinados aspectos do programa podem |ser personalizados. As reas dependentes do locale incluem, por |exemplo, a formatao de datas ou o formato de exibio para valores |monet rios. LC_ALL afeta todo o comportamento especfico do locale |(todas as categorias). |Se voc remover o parmetro de ambiente LC_ALL para que o ICM possa |coexistir com o Sybase na plataforma Windows NT, os seguintes recursos no |funcionaro mais: | * |Usu rio do Cat logo de Informaes * |Administrador do Cat logo de Informaes * |Gerenciador do Cat logo de Informaes | |A remoo do parmetro LC_ALL no afetar nada alm do ICM. ------------------------------------------------------------------------ 30.4 Acessando os Cat logos de Informaes do DB2 Verso 5 com o Information Catalog Manager do DB2 Verso 7 Os subcomponentes do Information Catalog Manager do DB2 Verso 7, conforme configurado pelo processo de instalao do DB2 Verso 7, suporta o acesso aos cat logos de informaes armazenados nos bancos de dados do DB2 Verso 6 e DB2 Verso 7. Voc pode modificar a configurao dos subcomponentes para ter acesso aos cat logos de informaes que foram armazenados nos bancos de dados do DB2 Verso 5. Os subcomponentes do Gerenciador do Cat logo de Informaes do DB2 Verso 7 no suportam o acesso aos dados do DB2 Verso 2 ou quaisquer outras verses anteriores. Para configurar o Administrador do Cat logo de Informaes, o Usu rio do Cat logo de Informaes, e o Utilit rio de Inicializao do Cat logo de Informaes para que tenham acesso aos cat logos de informaes armazenados nos bancos de dados do DB2 Verso 5: 1. Instale o DB2 Connect Enterprise Edition Verso 6 em uma estao de trabalho diferente daquela em que o Gerenciador do Cat logo de Informaes do DB2 Verso 7 foi instalado. O DB2 Connect Enterprise Edition faz parte do DB2 Universal Database Enterprise Edition e do DB2 Universal Database Enterprise - Extended Edition. Se a verso 6 de um destes produtos DB2 estiver instalada, voc no precisar instalar o DB2 Connect separadamente. Restrio: Voc no pode instalar v rias verses do DB2 na mesma estao de trabalho do Windows NT ou OS/2. Pode instalar o DB2 Connect em uma outra estao de trabalho do Windows NT ou em uma estao de trabalho do OS/2 ou do UNIX. 2. Configure o Gerenciador do Cat logo de Informaes e o DB2 Connect Verso 6 para o acesso aos dados do DB2 Verso 5. Para obter maiores informaes, consulte a publicao DB2 Connect User's Guide. Estas etapas constituem uma viso geral das etapas necess rias: a. No sistema do DB2 Verso 5, utilize o Processador da Linha de Comandos do DB2 para catalogar o banco de dados da Verso 5 a que o Gerenciador do Cat logo de Informaes dever ter acesso. b. No sistema do DB2 Connect, utilize o Processador da Linha de Comandos do DB2 para catalogar: + O n TCP/IP do sistema do DB2 Verso 5. + O banco de dados do sistema do DB2 Verso 5. + A entrada DCS do sistema do DB2 Verso 5. c. Na estao de trabalho com o Gerenciador do Cat logo de Informaes, utilize o Processador da Linha de Comandos do DB2 para catalogar: + O n TCP/IP do sistema do DB2 Connect. + O banco de dados do sistema do DB2 Connect. Para obter informaes sobre a catalogao dos bancos de dados, consulte a publicao DB2 Universal Database Installation and Configuration Suplement. 3. No warehouse com o Gerenciador do Cat logo de Informaes, efetue a vinculao do pacote DB2 CLI a cada banco de dados que dever ser acessado atravs do DB2 Connect. Os comandos do DB2 a seguir fornece um exemplo da vinculao com o v5database, um banco de dados hipottico do DB2 verso 5. Use o Processador da Linha de Comandos do DB2 para emitir os seguintes comandos. O db2cli.lst e o db2ajgrt esto localizados no diretrio \sqllib\bnd. db2 connect to v5database user userid using password db2 bind db2ajgrt.bnd db2 bind @db2cli.lst blocking all grant public no qual userid o ID do usu rio do v5database, e password a senha do ID do usu rio. Ocorre um erro quando o db2cli.list efetuou um bind no banco de dados do DB2 Verso 5. Esse erro ocorre porque os LOBs (large objects - objetos grandes) no so suportados nesta configurao. Ele no afetar o acesso do agente de warehouse ao banco de dados do DB2 Verso 5. O FixPak 14 do DB2 Universal Database Verso 5, que estar disponvel em junho de 2000, obrigatrio para o acesso aos dados do DB2 Verso 5 atravs do DB2 Connect. Consulte o APAR nmero JR14507 desse FixPak. ------------------------------------------------------------------------ 30.5 Configurando um Cat logo de Informaes A etapa 2 na primeira seo do Captulo 1, "Setting up an information catalog", informa: Quando voc instalar o DB2 Warehouse Manager ou o DB2 OLAP Server, ser criado um cat logo de informaes padro no DB2 Universal Database para Windows NT. A afirmao est incorreta. preciso definir um novo cat logo de informaes. Consulte a seo "Creating the Information Catalog" para obter mais informaes. ------------------------------------------------------------------------ 30.6 Trocando Metadados com Outros Produtos No captulo 6, "Exchanging metadata with other products", na seo "Identifying OLAP objects to publish", existe uma instruo no segundo par grafo afirmando que: Quando se publicam os metadados do DB2 OLAP Integration Server, cria-se um relacionamento com links entre as "dimenses dentro do objeto de uma tabela e multidimensional" do cat logo de informaes e o objeto de uma tabela do OLAP Integration Server. A declarao deveria ser: Quando se publicam os metadados do DB2 OLAP Integration Server, cria-se um relacionamento com links entre as "dimenses dentro do objeto de uma tabela e o objeto de um banco de dados multidimensional". Esta instruo tambm aparece no Apndice C, "Metadata mappings", na seo "Metadata mappings between the Information Catalog Manager and OLAP Server". ------------------------------------------------------------------------ 30.7 Trocando metadados utilizando o comando flgnxoln No captulo 6, "Exchanging Metadata", existe uma seo chamada "Identifying OLAP objects to publish". No final desta seo h um exemplo de como usar o comando flgnxoln para publicar o metadados do OLAP server num cat logo de informaes. O exemplo mostra incorretamente o diretrio dos arquivos db2olap.ctl e db2olap.ff como x:\Arquivos de Programas\sqllib\logging. O nome do diretrio deveria ser x:\Arquivos de Programas\sqllib\exchange conforme descrio feita na p gina 87. ------------------------------------------------------------------------ 30.8 Trocando metadados utilizando o comando MDISDGC Captulo 6. Exchanging metadata with other products: "Converting MDIS-conforming metadata into a tag language file", p gina 97. Voc no pode emitir o comando MDISDGC a partir do prompt de comandos do MS-DOS. Ele deve ser emitido a partir de uma janela de comandos do DB2. A primeira sentena da seo "Convertendo um arquivo de linguagem de tags em metadados compatveis com MDIS" tambm afirma que voc deve emitir o comando DGMDISC a partir do prompt de comandos do MS-DOS. Voc deve emitir o comando DGMDISC a partir de uma janela de comandos do DB2. ------------------------------------------------------------------------ 30.9 Invocando programas Alguns exemplos no Information Catalog Administration Guide mostram os comandos que contm o nome do diretrio Arquivos de Programa. Ao chamar um programa que contm Arquivos de Programa como parte de seu nome de caminho, voc deve colocar a chamada do programa entre aspas duplas. Por exemplo, o Apndice B, "Predefined Information Catalog Manafer object types", contm um exemplo na seo chamada "Initializing your information catalog with the predefined object types". Se voc usar este exemplo nesta seo, receber um erro ao execut -lo a partir do prompt do DOS. O exemplo seguinte est correto: "X:Arquivos de Programas\SQLLIB\SAMPLES\SAMPDATA\DGWDEMO" /T userid password dgname ------------------------------------------------------------------------ Manual de Referncia do Information Catalog Manager Programming ------------------------------------------------------------------------ 31.1 Cdigos de Razo do Gerenciador do Cat logo de Informaes No Apndice D: Cdigos de Razo do Information Catalog Manager, uma parte do texto poder ter sido truncada na coluna mais direita dos seguintes cdigos de motivos: 31014, 32727, 32728, 32729, 32730, 32735, 32736, 32737, 33000, 37507, 37511 e 39206. Se o texto estiver truncado, consulte a verso HTML do manual para exibir a coluna completa. ------------------------------------------------------------------------ Manual do Usu rio do Information Catalog Manager No captulo 2, h uma seo chamada "Registrando um n de servidor e o cat logo de informaes remota." A seo relaciona as etapas que podem ser concludas a partir do DB2 Control Center antes que um cat logo de informaes remoto seja registrado, atravs do Gerenciador do Cat logo de Informaes. O ltimo par grafo da seo descreve que aps concluir um conjunto de etapas do DB2 Control Center (incluir um sistema, uma instncia e um banco de dados), voc deve encerr -lo antes de abrir O Gerenciador do Cat logo de Informaes. Essa informaes est incorreta. No necess rio encerrar o Centro de Controle antes de se abrir o Gerenciador do Cat logo de Informaes. A mesma correo se aplica tambm tarefa da ajuda online "Registrando um n de servidor e o cat logo de informaes remoto" e da ajuda online da janela Registrar N do Servidor e Cat logo de Informaes. ------------------------------------------------------------------------ Information Catalog Manager: Menssagens Online ------------------------------------------------------------------------ 33.1 Correes nas Mensagens FLG 33.1.1 Mensagem FLG0260E A segunda sentena da explicao da mensagem deveria ser: O erro causou um retrocesso do cat logo de informaes, que falhou. O cat logo de informaes no se encontra em condio est vel, mas nenhuma alterao foi feita. 33.1.2 Mensagem FLG0051E O segundo item da explicao da mensagem deveria ser: O cat logo de informaes contm muitos objetos ou tipos de objetos. A resposta do administrador deveria ser: Exclua alguns objetos ou tipos de objetos do cat logo de informaes atual utilizando a funo de importao. 33.1.3 Mensagem FLG0003E A explicao da mensagem deveria ser: O cat logo de informaes deve ser registrado antes que seja usado. O cat logo de informaes pode no ter sido registrado corretamente. 33.1.4 Mensagem FLG0372E A primeira sentena da explicao da mensagem deveria ser: O valor de ATTACHMENT-IND foi ignorado por um objeto porque esse objeto um objeto Attachment. 33.1.5 Mensagem FLG0615E A segunda sentena da mensagem deveria ser: O Gerenciador do Cat logo de Informaes encontrou um erro inesperado do banco de dados ou no consegue conectar o arquivo ao diretrio ou caminho atual. ------------------------------------------------------------------------ Information Catalog Manager: Ajuda Online Janela do Cat logo de Informaes: A ajuda online do item Abrir do menu Selecionado afirma incorretamente "Abre o objeto selecionado". Ele deveria afirmar "Abre a janela Definir Pesquisa". ------------------------------------------------------------------------ 34.1 Gerenciador do Cat logo de Informaes para a Web Quando for utilizado um cat logo de informaes localizado em um sistema DB2 UDB para OS/390, a pesquisa que no considera letras maisculas e minsculas no estar disponvel. Isso acontece em uma pesquisa simples e em uma pesquisa avanada. A ajuda online no explica que todas as pesquisas em um cat logo de informaes do DB2 UDB para OS/390 consideram letras maisculas e minsculas em uma pesquisa simples. Alm do mais, todos os objetos de categorias de agrupamento so explic veis, mesmo quando no h objetos subjacentes. ------------------------------------------------------------------------ DB2 Warehouse Manager Installation Guide ------------------------------------------------------------------------ |35.1 Atualizao disponvel da Publicao DB2 Warehouse Manager Installation Guide Disponvel |A publicao DB2 Warehouse Manager Installation Guide foi atualizado e o |.pdf mais recente est disponvel para download online no endereo http://www.ibm.com/software/data/db2/udb/winos2unix/support. |Toda a documentao atualizada tambm est disponvel no CD. Esse CD |pode ser solicitado atravs de servio utilizando a PTF nmero U478862. |As informaes nessas notas so complementares referncia |atualizada. ------------------------------------------------------------------------ |35.2 Requisitos de software para transformadores do warehouse |O JDK (Java Developer's Kit) Verso 1.1.8 ou posterior |deve ser instalado no banco de dados onde voc planeja utilizar os |transformadores do warehouse. | ------------------------------------------------------------------------ |35.3 Consideraes Ps-instalao para o Agente iSeries | |No Captulo 4, na seo "Instalando o Agente de Warehouse do AS/400 |(iSeries)", na subseo "Consideraes Ps-instalao", altere o primeiro |par grafo para: | |O agente do warehouse executa todas as funes da etapa em uma nica unidade |de trabalho. Antes da V4R5, o DB2 Universal Database para iSeries |limitava o nmero de linhas que podiam ser inseridas em um nico escopo de |comprometimento para 4 milhes. Essa limitao foi aumentada para 500 |milhes de linhas na V4R5. Se estiver utilizando um sistema V4R4 (ou |anterior) e tiver consultas que excedam esse tamanho, subdivida as consultas |ou utilize os programas de FTP fornecidos com o warehouse para mover |dados. | ------------------------------------------------------------------------ |35.4 Antes de Utilizar Transformadores com o Agente do Warehouse do iSeries | |No Captulo 4, remova a seo "Antes de Utilizar Transformadores com o |Agente iSeries" e todas suas subsees. ------------------------------------------------------------------------ Manual de Administrao do Query Patroller ------------------------------------------------------------------------ 36.1 O Cliente do DB2 Query Patroller um Componente Separado O cliente do DB2 Query Patroller um componente separado que no faz parte do cliente do DB2 Administration. Isso significa que ele no foi instalado durante a instalao do Cliente do DB2 Administration, conforme indicao do Query Patroller Installation Guide. Ao invs disso, o cliente Query Patroller deve ser instalado separadamente. |A verso e o nvel do cliente Query Patroller e do servidor Query |Patroller devem ser os mesmos. ------------------------------------------------------------------------ |36.2 Alterando o Status do N |A seguir, uma atualizao da seo Administrao do N do Query Patroller |Administration Guide. | |Utilize o seguinte procedimento para alterar o status do n: | 1. |Na p gina Administrao do N, selecione um n. 2. |Clique em Exibir / Editar. |A janela Informaes Detalhadas do N se abrir . 3. |Selecione o novo status no campo Status Solicitado. |Nota: Status Solicitado o nico campo na janela Informaes |Detalhadas do N que pode ser mudado; todos os outros campos exibem |valores que foram fornecidos por DB2 Query Patroller . | 4. |Clique em OK. | |A seguinte lista fornece informaes para cada parmetro de n: | |ID do N |Fornece o ID para o n. |Status do N |Contm o status atual do n: | o |Ativo indica que o n est apto a executar jobs. o |Inativo indica que o componente DB2 Query Patroller do n est |desligado. O n no est disponvel para DB2 Query Patroller . |Para reativar o n, utilize a conta de usu rio administrativo iwm |para emitir o comando dqpstart. o |Efetuando Quiesce indica que o n est em transio para o |estado de quiesce. Jobs em execuo sero concludos, mas nenhum novo |trabalho ser planejado no n. o |Quiesce Efetuado indica que o n est em quiesce. O n |est disponvel para DB2 Query Patroller , mas nenhum novo job est sendo |planejado no n. | |Status Solicitado |Indica que o status do n pode ser alterado para: | o |Ativo indica que o n ser ativado. o |Inativo indica que o n ficar inativo. Jobs em execuo |sero concludos e nenhum novo job ser planejado. o |Forar indica que o n ficar inativo imediatamente. |Jobs em execuo sero terminados imediatamente e nenhum novo job ser |planejado. o |Quiesce Efetuado indica que o n ficar em quiesce. Jobs |em execuo sero concludos. | |Data/Hora do ltimo Status |Indica a data e a hora em que o status do n foi alterado pela ltima |vez. |Jobs Planejados |Fornece o nmero de jobs planejados a executar mais o nmero de jobs em |execuo neste n. |Utilizao de CPU |Fornece a utilizao de CPU do n como uma percentagem (0 - |100). Se a informao de utilizao de CPU no estiver sendo |colhida, o valor -1. |Disco Disponvel |Indica os bytes disponveis no sistema de arquivos onde os resultados so |criados. Se a utilizao de disco no estiver sendo monitorada, o valor | -1. |PID do Gerenciador de N |Indica o ID de processo do processo gerenciador do n. | ------------------------------------------------------------------------ 36.3 Migrando da Verso 6 do DB2 Query Patroller Utilizando dqpmigrate O comando dqpmigrate dever ser utilizado se a Verso 7 do Query Patroller Server foi instalada sobre a Verso 6. Para o FixPak 2 ou posterior, voc no precisa executar o comando dqpmigrate manualmente, porque a instalao do FixPak executa esse comando. Sem usar esse comando, os usu rios definidos existentes na v6 no tero nenhum privilgio EXECUTE nos v rios procedimentos armazenados novos includos na Verso 7. Nota: O dqpmigrate.bnd encontrado no diretrio sqllib/bnd e o dqpmigrate.exe no diretrio sqllib/bin. Para usar o dqpmigrate manualmente a fim de conceder os privilgios EXECUTE, execute o seguinte aps instalar o FixPak: 1. Vincule o arquivo de pacote /sqllib/bnd/dqpmigrate.bnd ao banco de dados onde o Query Patroller server foi instalado, digitando o seguinte comando: db2 bind dqpmigrate.bnd 2. Execute o dqpmigrate digitando o seguinte: dqpmigrate dbalias userid passwd ------------------------------------------------------------------------ 36.4 Ativando o Query Management No captulo "Getting Started" do "Ativando o Query Management", o texto dever ser: Voc deve ser o propriet rio do banco de dados, ou deve ter a autoridade SYSADM, SYSCTRL ou SYSMAINT para definir os parmetros de configurao do banco de dados. ------------------------------------------------------------------------ |36.5 Localizao da rea de Tabela para Tabelas de Controle |No Captulo 1, Viso Geral do Sistema, em Tabelas de Controle do DB2 Query |Patroller, o texto a seguir deve ser includo no final do primeiro par grafo |da seo: |A rea de tabela para as tabelas de controle do DB2 Query Patroller deve |residir em um grupo de ns de nico n ou o DB2 Query Patroller no funcionar |corretamente. ------------------------------------------------------------------------ |36.6 Novos Parmetros para o Comando dqpstart |No Captulo 2, Introduo, em Iniciando e Encerrando o DB2 Query Patroller, |o texto a seguir deve ser includo seguindo o ltimo par grafo: |Novos Parmetros para o comando dqpstart: | |Parmetro RESTART: |Permite que o usu rio substitua o nome do host e/ou o tipo de n do n |especificado no arquivo dqpnodes.cfg. O DB2 Query |Patroller ser iniciado neste n. |Nota: Antes de executar o comando DQPSTART com o parmetro RESTART, assegure-se de |que: | 1. |O DB2 Query Patroller j esteja encerrado no host que vai ser |substitudo. 2. |O DB2 Query Patroller ainda no esteja sendo executado no novo |host. | | A sintaxe a seguinte: |dqpstart nodenum node_num restart hostname server | agent | none |Parmetro ADDNODE: |Permite que o usu rio inclua um novo n no arquivo |dqpnodes.cfg. O DB2 Query Patroller ser iniciado |nesse n aps a nova entrada de n ser includa no arquivo |dqpnodes.cfg. A sintaxe a seguinte: |dqpstart nodenum node_num addnode hostname server | agent | none |Parmetro DROPNODE: |Permite que o usu rio elimine um n do arquivo |dqnodes.cfg. O DB2 Query Patroller ser encerrado |nesse n[o antes da entrada do n ser eliminada do arquivo |dqpnodes.cfg. A sintaxe a seguinte: |dqpstop nodenum node_num dropnode | ------------------------------------------------------------------------ |36.7 Novo Parmetro para o Comando iwm_cmd |Um novo parmetro -v foi includo no comando iwm_cmd |para permitir que o usu rio recupere o status dos jobs que esto sendo |executados no n especificado. Apenas os jobs em um n interativo so |permitidos serem recuperados. Esse comando deve ser emitido quando |existe uma falha do n e existem alguns jobs sendo executados nesse n ou |sendo cancelado no momento. Os jobs que estavam no estado "Em |Execuo", sero resubmetidos e definidos novamente para o estado |"Enfileirado". Os jobs que estavam no estado "Cancelando" sero |definidos para o estado "Cancelado". |A sintaxe parcial a seguinte: |>>-iwm_cmd--+-------------------------------+-------------------> | '--u--user_id--+--------------+-' | '--p--password-' | |>---v--node_id_to_recover-------------------------------------->< | | | |node_id_to_recover |Especifica o n no qual os jobs devem ser recuperados. | ------------------------------------------------------------------------ |36.8 Nova Vari vel de Registro: DQP_RECOVERY_INTERVAL |Existe uma nova vari vel de registro chamada DQP_RECOVERY_INTERVAL que |utilizada para definir o intervalo de tempo em minutos que o iwm_scheduler |procura para arquivos de recuperao. O padro 60 |minutos. ------------------------------------------------------------------------ 36.9 Iniciando o Query Administrator No captulo "Using QueryAdministrator to Administer DB2 Query Patroller", so fornecidas as instrues para a iniciao do QueryAdministrator a partir do menu Iniciar do Windows. A primeira etapa fornece o seguinte texto: Se voc estiver utilizando o Windows, poder selecionar o DB2 Query Patroller --> QueryAdministrator a partir do grupo de programas IBM DB2. O texto deveria ser: DB2 Query Patroller --> QueryAdmin. ------------------------------------------------------------------------ 36.10 Administrao do Usu rio Na seo "Administrao do Usu rio" do captulo "Using QueryAdministrator to Administer DB2 Query Patroller", a definio do parmetro Maximum Elapsed Time indica que se o valor for definido como 0 ou -1, a consulta ser sempre executada at sua concluso. Esse parmetro no pode ser definido como um valor negativo. O texto dever indicar que se o valor for definido como 0, a consulta ser sempre executada at sua concluso. O parmetro Max Queries especifica o nmero m ximo de jobs que o DB2 Query Patroller executar simultaneamente. O parmetro Max Queries deve ser um nmero inteiro entre 0 e 32767. ------------------------------------------------------------------------ |36.11 Administrao da Origem de Dados |No Captulo 3, Utilizando o Administrador de Consulta para Administrar o |DB2 Query Patroller, h alguma descries novas e alteradas para os parmetros |da origem de dados. |Custo est tico o custo estimado do DB2 para a consulta em |timerons. Esse custo armazenado na entrada de cada job. Voc |poder v-lo como o Custo Estimado ao utilizar o Monitor de Consultas para ver |os detalhes de um job. |Consulta com Custo Zero a consulta com um custo est tico, ou custo |estimado, igual a zero. Nenhuma consulta, na verdade, tem um custo |estimado igual a zero (mesmo as mais simples tm um custo de aproximadamente |5). Na verdade, isso ocorre se um job for enviado com a opo para no |fazer an lise de custo. Voc pode escolher apenas essa opo se tiver |configurado o perfil de usu rio para permiti-la. Na maioria dos casos, |voc no ter seus perfis de usu rios configurados dessa maneira. |Mantenha essa opo para superusu rios, como outros administradores, usu rios |especiais selecionados ou para voc mesmo. Esses usu rios podero, |ento, executar qualquer consulta que quiserem. O sistema trata |consultas desses usu rios como de custo zero para que as consultas sejam |tratadas como de alta prioridade. |Custo de Tempo Zero, Curva de Custo de Tempo, Intervalo de Custo de Tempo e |Custo de Tempo Mn no so mais utilizados. |O Fator Custo o multiplicador para converter o Custo Est tico em |timerons, no o custo da tabela de contabilizao. O custo da tabela |de contabilizao igual ao Custo Est tico multiplicado pelo Fator |Custo. ------------------------------------------------------------------------ 36.12 Criando uma Fila de Jobs Na seo "Administrao de Fila de Jobs" do captulo "Using QueryAdministrator to Administer DB2 Query Patroller", a captura de tela nas etapas de "Criando uma Fila de Jobs" dever ser exibida depois da segunda etapa. A janela Information about new Job Queue aberta quando voc clica em New na p gina Administrao de Fila de Jobs da ferramenta QueryAdministrator. As referncias p gina Fila de Jobs ou guia Fila de Jobs devero ficar como a p gina Administrao de Fila de Jobs e a guia Fila de Jobs Administration, respectivamente. ------------------------------------------------------------------------ |36.13 Tabela de Contabilizao do Job |No Captulo 11, Monitorando o Sistema do DB2 Query Patroller, a seo sobre |Contabilizao do Job descreve as colunas da tabela Contabilizao do |Job. O nome da tabela IWM.IWM003_JOB_ACCT. ------------------------------------------------------------------------ 36.14 Utilizando a Interface da Linha de Comandos Para que um usu rio com autoridade de Usu rio no sistema DB2 Query Patroller submeta uma consulta e crie uma tabela de resultados, o usu rio pode requerer a autoridade CREATETAB no banco de dados. O usu rio no requer a autoridade CREATETAB no banco de dados se a vari vel do perfil DQP_RES_TBLSPC for deixada sem definio, ou se a vari vel do perfil DQP_RES_TBLSPC for definida com o nome da rea da tabela padro. A criao das tabelas de resultados tero sucesso neste caso porque os usu rios tm a autoridade de criar tabelas na rea da tabela padro. ------------------------------------------------------------------------ 36.15 Notas do Query Enabler * Quando forem usadas ferramentas de consulta de terceiros que utilizem o cursor de um conjunto de teclas, as consultas no sero interceptadas. Para que o Query Enabler intercepte essas consultas, voc precisa modificar o arquivo db2cli.ini para que ele inclua: [common] DisableKeySetCursor=1 * Para clientes AIX, confira se a vari vel de ambiente LIBPATH no foi definida. A biblioteca libXext.a, enviada com o JDK, no compatvel com a biblioteca do subdiretrio /usr/lib/X11. Esse fato causar problemas com a GUI do Query Enabler. ------------------------------------------------------------------------ 36.16 O rastreador do DB2 Query Patroller pode retornar uma p gina de coluna em branco O FixPak 3 inclui uma correo para o rastreador do DB2 Query Patroller. Agora o rastreador relata corretamente as consultas que no atingem colunas. Um exemplo dessa consulta "SELECT COUNT(*) FROM ...". Como esse tipo de consulta no atinge colunas da tabela, o Rastreador apresenta uma p gina em branco como p gina da coluna. Essa p gina de coluna em branco no um defeito. ------------------------------------------------------------------------ |36.17 Informaes Adicionais para a Ferramenta da GUI do Tracker do DB2 Query Patroller |A tabela de contabilizao utilizada pela ferramenta Tracker quando |utilizada para exibir ou analisar dados histricos do job. Para |utilizar o Tracker, o administrador deve primeiro utilizar o Administrador de |Consultas para alterar o Status da Contabilizao no painel Administrador do |Sistema para Gravar na Tabela. Em seguida, sempre que um job for |concludo, informaes extras so salvas em uma tabela de contabilizao do |job. |Depois, o administrador deve efetuar logon no servidor do Query Patroller |como usu rio iwm e executar a ferramenta iwm_tracker (backend do |Tracker). Essa ferramenta deve ser executada periodicamente quando a |carga do sistema est baixa ou logo antes da ferramenta Tracker ser |utilizada. |Por fim, quando essas duas tarefas forem concludas, voc poder executar a |ferramenta da GUI do Tracker para exibir ou analisar os dados do job. |Se o fator custo for igual a um, que o padro, ento, o custo exibido |para cada job utilizando o Tracker ser igual ao valor do custo exibido |utilizando o Monitor de Consultas. Nos dois casos, o tempo est em |timerons. |No entanto, voc pode querer utilizar outras unidades de valor. |Suponhamos que voc queira cobrar cada usu rio pela utilizao do |sistema. Se, por exemplo, o custo for de um real para 10.000 |timerons de trabalho, o fator custo a ser digitado de ser 0,0001. Isso |faz com que o Tracker converta, armazene e exiba o custo em reais de cada |job. |O Query Patroller Administration Guide discute reais por |megabytes, o que incorreto e deve ser substitudo por reais por |timeron. ------------------------------------------------------------------------ |36.18 Query Patroller e Ferramentas de Replicao |O Query Patroller Verso 7 interceptar as consultas das ferramentas de |replicao (asnapply, asnccp, djra e analyze) e causar malfuncionamento a |essas ferramentas. Uma alternativa desativar o gerenciamento de |consulta dinmica, quando executar essas ferramentas. ------------------------------------------------------------------------ |36.19 Melhorando o Desempenho do Query Patroller |O texto a seguir deve aparecer no final do Captulo 6, Ajuste de |Desempenho: |Utilizando a Opo BIND, INSERT BUF para Melhorar o Desempenho do DB2 Query |Patroller. |Por padro, o DB2 Query Patroller cria tabelas de resultados para armazenar |os resultados das consultas gerenciadas por ele. Para aumentar o |desempenho de inseres nessas tabelas de resultados, inclua a opo INSERT |BUF ao efetuar vinculao de um dos arquivos de ligao do DB2 Query |Patroller. |Efetue vinculao dos arquivos de ligao do DB2 Query Patroller no banco |de dados como a seguir: |No diretrio DB2_RUNTIME\bnd no Windows, ou no caminho DB2_RUNTIME/bnd no |UNIX, digite os seguintes comandos: |db2 connect to database user iwm using password |db2 bind @db2qp.lst blocking all grant public |db2 bind iwmsx001.bnd insert buf |db2 bind @db2qp_sp.lst |db2 commit |em que database o banco de dados de substituio que ser |gerenciado pelo DB2 Query Patroller, e password a senha da conta |do usu rio administrativo, iwm. ------------------------------------------------------------------------ 36.20 O Privilgio EXECUTE para Usu rios do Query Patroller Criados na Verso 6 no est Implementado Devido a alguns procedimentos armazenados novos (IWM.DQPGROUP, IWM.DQPVALUR, IWM.DQPCALCT e IWM.DQPINJOB) includos no Query Patroller Verso 7, os usu rios existentes criados no Query Patroller Verso 6 no contm o privilgio EXECUTE nesses pacotes. Foi includo um aplicativo para corrigir automaticamente este problema no FixPak 1. Ao tentar usar o DQP Query Admin para modificar as informaes do usu rio DQP, no tente remover os usu rios existentes da lista de usu rios. ------------------------------------------------------------------------ 36.21 Restries do Query Patroller Por causa das restries da plataforma JVM (Java Virtual Machine), o Query Enabler no suportado no HP-UX and NUMA-Q. Alm disso, o Query Patroller Tracker no suportado no NUMA-Q. Se todas as ferramentas do cliente Query Patroller forem exigidas, ns recomendamos que se utilize uma plataforma diferente (tal como Windows NT) para executar essas ferramentas, ao invs do servidor HP-UX ou NUMA-Q. ------------------------------------------------------------------------ 36.22 Apndice B. Detectando problemas em clientes do DB2 Query Patroller No Apndice B, Detectando problemas em clientes do DB2 Query Patroller, seo: Problemas comuns no Query Enabler, problema 2, o texto do primeiro marcador substitudo por: Verifique se a definio do caminho inclui jre. ------------------------------------------------------------------------ Desenvolvimento de Aplicativos ndice Parcial * Administrative API Reference o 37.1 db2ArchiveLog (nova API) + db2ArchiveLog o 37.2 db2ConvMonStream o 37.3 db2DatabasePing (nova API) + db2DatabasePing - Banco de Dados para Execuo de Ping o 37.4 db2HistData o 37.5 db2HistoryOpenScan o 37.6 db2XaGetInfo (nova API) + db2XaGetInfo - Obter Informaes para o Gerenciador de Recursos o 37.7 db2XaListIndTrans (nova API que sobrepe sqlxphqr) + db2XaListIndTrans - Lista Transaes Duvidosas o 37.8 db2GetSnapshot - Obter instantneo o |37.9 Registro de Log Esquecido o 37.10 sqlaintp - Obter mensagem de erro o 37.11 sqlbctcq - Fechar consulta do continer da rea da tabela o |37.12 sqleseti - Definir Informaes do Cliente o 37.13 sqlubkp - Backup do banco de dados o 37.14 sqlureot - Reorganizar tabela o 37.15 sqlurestore - Restaurar banco de dados o 37.16 Erro na Documentao com Relao ao Suporte de Memria Compartilhada Estendida (EXTSHM) do AIX o 37.17 SQLFUPD + 37.17.1 locklist o 37.18 SQLEDBDESC * Application Building Guide o |38.1 Atualizao Disponvel o |38.2 Notas Adicionais para Distribuio de Procedimentos SQL Compilados * |Application Development Guide o |39.1 Atualizao Disponvel o |39.2 Novos Requisitos para executeQuery e executeUpdate o |39.3 Suporte ao Driver JDBC para Mtodos Adicionais o |39.4 o |39.5 Provedor IBM OLE DB para DB2 UDB * Manual de Referncia ao CLI o 40.1 Efetuando a vinculao dos Utilit rios de Banco de Dados Utilizando o Cliente de Run-Time o 40.2 Utilizando SQL Est tico em Aplicativos CLI o 40.3 Limitaes do Perfilamento Est tico JDBC/ODBC/CLI o 40.4 Transformaes ADT o |40.5 Captulo 1. Introduo CLI + |40.5.1 Diferenas entre a CLI do DB2 e a SQL Incorporada o 40.6 Captulo 3. Utilizando Recursos Avanados + |40.6.1 Gravando Aplicativos de Multi-Encadeamento + 40.6.2 Escrevendo um Aplicativo Unicode do DB2 CLI + 40.6.2.1 Funes Unicode + 40.6.2.2 Novos Tipos de Dados e Converses V lidas + 40.6.2.3 Palavra-Chave Obsoleta/Valor de Correo + 40.6.2.4 Literais em Bancos de Dados Unicode + 40.6.2.5 Configurao das Palavras-chave CLI Nova + |40.6.3 MTS (Microsoft Transaction Server) como Transaction Monitor + 40.6.4 Scrollable Cursors + 40.6.4.1 Suporte ao cursor desloc vel no lado do servidor para OS/390 + 40.6.5 Utilizando o SQL Composto + 40.6.6 Utilizando os Procedimentos Armazenados + |40.6.6.1 Privilgios para Construir e Depurar Procedimentos SQL e Java Armazenados + 40.6.6.2 Gravando um Procedimento Armazenado em CLI + 40.6.6.3 Procedimentos Armazenados e Vinculao Autom tico da CLI o 40.7 Captulo 4. Configurando CLI/ODBC e executando amostras de aplicativos + |40.7.1 Palavras-chave de configurao + |40.7.1.1 CURRENTFUNCTIONPATH + |40.7.1.2 SKIPTRACE o 40.8 Captulo 5. Funes da CLI do DB2 + 40.8.1 SQLBindFileToParam - Ligar Referncia do Arquivo do LOB ao Parmetro do LOB + |40.8.2 SQLColAttribute -- Retornar um Atributo de Coluna + |40.8.3 SQLGetData - Obter Dados de uma Coluna + |40.8.4 SQLGetInfo - Obter Informaes Gerais + |40.8.5 SQLGetLength - Recuperar Comprimento de um Valor de Cadeia + 40.8.6 SQLNextResult - Associar o Prximo Conjunto de Resultados a Outra Manipulao de Instruo + 40.8.6.1 Objetivo + 40.8.6.2 Sintaxe + 40.8.6.3 Argumentos de Funo + 40.8.6.4 Uso + 40.8.6.5 Cdigos de Retorno + 40.8.6.6 Diagnsticos + 40.8.6.7 Restries + 40.8.6.8 Referncias + |40.8.7 SQLSetEnvAttr - Definir Atributo de Ambiente + |40.8.8 SQLSetStmtAttr -- Definir Opes Relacionadas a uma Instruo o |40.9 Apndice C. DB2 CLI e ODBC + |40.9.1 Aplicativos Unicode do ODBC + |40.9.1.1 Aplicativos Unicode Versus No-Unicode do ODBC o 40.10 Apndice D. Funes Escalares Estendidas + 40.10.1 Funes de Data e Hora o 40.11 Apndice K. Utilizando a Funcionalidade de Rastreamento do DB2 CLI/ODBC/JDBC * |Referncia de Mensagens o |41.1 Atualizao Disponvel o |41.2 Atualizaes de Mensagens o |41.3 Lendo Texto de Mensagens Online * Referncia a SQL o |42.1 Atualizao Disponvel da SQL Reference o |42.2 Ativando as Novas Funes e Procedimentos o |42.3 SET SERVER OPTION - Erro da Documentao o |42.4 GRANT (Privilgios de Tabela, Exibio ou Pseudnimo) - Erro da Documentao o 42.5 Informaes do MQSeries + 42.5.1 Funes Escalares + |42.5.1.1 MQPUBLISH + |42.5.1.2 MQREADCLOB + |42.5.1.3 MQRECEIVECLOB + |42.5.1.4 MQSEND + 42.5.2 Funes da Tabela + |42.5.2.1 MQREADALLCLOB + |42.5.2.2 MQRECEIVEALLCLOB + |42.5.3 Dados CLOB Agora So Suportados nas Funes do MQSeries o 42.6 Informaes de Tipos de Dados + 42.6.1 Promoo de Tipos de Dados + 42.6.2 Converso Entre Tipos de Dados + 42.6.3 Atribuies e Comparaes + 42.6.3.1 Atribuies de Cadeia + 42.6.3.2 Comparaes de Cadeias + 42.6.4 Regras para Tipos de Dados de Resultado + 42.6.4.1 Cadeias de Caracteres e Gr ficas em um Banco de Dados Unicode + 42.6.5 Regras para Converses de Cadeias + 42.6.6 Expresses + 42.6.6.1 Com o Operador de Concatenao + 42.6.7 Predicados o |42.7 Informaes de Unicode + |42.7.1 Funes Escalares e Unicode o |42.8 Tipo de GRAPHIC e Compatibilidade de DATE/TIME/TIMESTAMP + |42.8.1 Representaes de Cadeia de Valores de Data e Hora + |42.8.1.1 Cadeias de Data, Cadeias de Hora e Cadeias de Data e Hora + |42.8.2 Convertendo entre Tipos de Dados + |42.8.3 Atribuies e Comparaes + |42.8.4 Atribuies de Data e Hora + |42.8.5 DATE + |42.8.6 GRAPHIC + |42.8.7 TIME + |42.8.8 TIMESTAMP + |42.8.9 VARGRAPHIC o 42.9 Chaves de ndice maiores para bancos de dados Unicode + 42.9.1 ALTER TABLE + 42.9.2 CREATE INDEX + 42.9.3 CREATE TABLE o |42.10 Seo Notas da Instruo ALLOCATE CURSOR Incorreta o |42.11 Opes Adicionais na Instruo GET DIAGNOSTICS + |Instruo GET DIAGNOSTICS o |42.12 ORDER BY em Sub-selees + |42.12.1 seleo completa + |42.12.2 subselect + |42.12.3 order-by-clause + |42.12.4 select-statement + |Instruo SELECT INTO + |42.12.5 Funes OLAP (window-order-clause) * |Novo Argumento de Entrada para o Procedimento GET_ROUTINE_SAR * |Autorizao Obrigatria para a Instruo SET INTEGRITY * |Apndice N. Tabelas de Exceo * Atualizaes do Unicode o 46.1 Introduo + 46.1.1 Bancos de Dados e Aplicativos do DB2 Unicode + 46.1.2 Atualizaes de Documentao ------------------------------------------------------------------------ Administrative API Reference ------------------------------------------------------------------------ 37.1 db2ArchiveLog (nova API) db2ArchiveLog Fecha e trunca o arquivo de log ativo de um banco de dados recuper vel. Se a sada do usu rio estiver ativada, emite um pedido de archive. Autorizao Um dos seguintes: * sysadm * sysctrl * sysmaint * dbadm Conexo Requerida Essa API estabelece automaticamente uma conexo com o banco de dados especificado. Se j existir uma conexo com o banco de dados especificado, a API retorna um erro. Arquivo de Incluso da API db2ApiDf.h Sintaxe da API C /* Arquivo: db2ApiDf.h */ /* API: Archive Active Log */ SQL_API_RC SQL_API_FN db2ArchiveLog ( db2Uint32 version, void *pDB2ArchiveLogStruct, struct sqlca * pSqlca); typedef struct { char *piDatabaseAlias; char *piUserName; char *piPassword; db2Uint16 iAllNodeFlag; db2Uint16 iNumNodes; SQL_PDB_NODE_TYPE *piNodeList; db2Uint32 iOptions; } db2ArchiveLogStruct Sintaxe da API Genrica /* Arquivo: db2ApiDf.h */ /* API: Archive Active Log */ SQL_API_RC SQL_API_FN db2gArchiveLog ( db2Uint32 version, void *pDB2ArchiveLogStruct, struct sqlca * pSqlca); typedef struct { db2Uint32 iAliasLen; db2Uint32 iUserNameLen; db2Uint32 iPasswordLen; char *piDatabaseAlias; char *piUserName; char *piPassword; db2Uint16 iAllNodeFlag; db2Uint16 iNumNodes; SQL_PDB_NODE_TYPE *piNodeList; db2Uint32 iOptions; } db2ArchiveLogStruct Parmetros da API verso Entrada. Especifica a verso e o nvel do release da vari vel transmitida como segundo parmetro, pDB2ArchiveLogStruct. pDB2ArchiveLogStruct Entrada. Um indicador para a estrutura db2ArchiveLogStruct. pSqlca Sada. Um indicador para a estrutura sqlca. iAliasLen Entrada. Um nmero inteiro de 4 bytes no sinalizado, representando o comprimento em bytes do alias do banco de dados. iUserNameLen Um nmero inteiro de 4 bytes no sinalizado, representando o comprimento em bytes do nome do usu rio. Definido como zero se no for utilizado um nome do usu rio. iPasswordLen Entrada. Um nmero inteiro de 4 bytes no sinalizado, representando o comprimento em bytes da senha. Definido como zero se no for utilizada senha. piDatabaseAlias Entrada. Uma cadeia contendo o alias do banco de dados (conforme catalogado no diretrio do banco de dados do sistema) para o qual o log ativo deve ser arquivado. piUserName Entrada. Uma cadeia contendo o nome do usu rio a ser utilizado ao tentar uma conexo. piPassword Entrada. Uma cadeia que contm a senha a ser utilizada durante uma tentativa de conexo. iAllNodeFlag Somente MPP. Entrada. Sinalizador indicando se a operao deve se aplicar a todos os ns listados no arquivo db2nodes.cfg. Os valores v lidos so: DB2ARCHIVELOG_NODE_LIST Aplica-se aos ns em uma lista de ns que transmitida em piNodeList. DB2ARCHIVELOG_ALL_NODES Aplicado em todos os ns. piNodeList deve ser NULO. Esse o valor padro. DB2ARCHIVELOG_ALL_EXCEPT Aplica-se a todos os ns, exceto na lista de ns passada em piNodeList. iNumNodes Somente MPP. Entrada. Especifica o nmero de ns na matriz piNodeList. piNodeList Somente MPP. Entrada. Um ponteiro para uma matriz de nmeros de ns contra o qual aplica-se a operao de log do archive. iOptions Entrada. Reservado para uso futuro. ------------------------------------------------------------------------ 37.2 db2ConvMonStream Nas Notas de Uso, a estrutura do tipo de fluxo de dados da vari vel de captura instantnea SQLM_ELM_SUBSECTION deve ser qlm_subsection. ------------------------------------------------------------------------ 37.3 db2DatabasePing (nova API) db2DatabasePing - Banco de Dados para Execuo de Ping Testa o tempo de resposta da rede de conectividade subjacente entre um cliente e um servidor do bancos de dados. Esta API pode ser utilizada por um aplicativo quando um servidor do bancos de dados do host acessado atravs do DB2 Connect, diretamente ou atravs de um gateway. Autorizao Nenhum Conexo Requerida Banco de Dados Arquivo de Incluso da API db2ApiDf.h Sintaxe da API C /* Arquivo: db2ApiDf.h */ /* API: Ping Database */ /* ... */ SQL_API_RC SQL_API_FN db2DatabasePing ( db2Uint32 versionNumber, void *pParmStruct, struct sqlca * pSqlca); /* ... */ typedef SQL_STRUCTURE db2DatabasePingStruct { char iDbAlias[SQL_ALIAS_SZ + 1]; db2Uint16 iNumIterations; db2Uint32 *poElapsedTime; } Sintaxe da API Genrica /* Arquivo: db2ApiDf.h */ /* API: Ping Database */ /* ... */ SQL_API_RC SQL_API_FN db2gDatabasePing ( db2Uint32 versionNumber, void *pParmStruct, struct sqlca * pSqlca); /* ... */ typedef SQL_STRUCTURE db2gDatabasePingStruct { db2Uint16 iDbAliasLength; char iDbAlias[SQL_ALIAS_SZ]; db2Uint16 iNumIterations; db2Uint32 *poElapsedTime; } Parmetros da API versionNumber Entrada. Verso e release do produto DB2 Universal Database ou DB2 Connect que o aplicativo est utilizando. Nota: A constante db2Version710 ou superior deve ser usada para o DB2 Verso 7.1 ou superior. |pParmStruct Entrada. Um ponteiro para a Estrutura db2DatabasePingStruct. iDbAliasLength Entrada. Comprimento do nome de alias do banco de dados. Nota: Este parmetro no utilizado atualmente. Ele est reservado para uso futuro. iDbAlias Entrada. Nome de alias do banco de dados. Nota: Este parmetro no utilizado atualmente. Ele est reservado para uso futuro. iNumIterations Entrada. Nmero de iteraes de solicitao de teste. O valor deve estar entre 1 e 32767, inclusive. poElapsedTime Sada. Um indicador para uma matriz de inteiros de 32 bits em que o nmero de elementos seja igual a iNumIterations. Cada elemento na matriz conter o tempo decorrido em microssegundos para uma iterao de solicitao de teste. Nota: O aplicativo respons vel pela alocao da memria para esta matriz antes de chamar esta API. pSqlca Sada. Um indicador para a estrutura sqlca. Para obter maiores informaes sobre esta estrutura, consulte a publicao Administrative API Reference. Notas de Uso Deve existir uma conexo do banco de dados antes da chamada desta API, do contr rio, ocorrer um erro. Esta funo tambm pode ser chamada atravs do comando PING. Para obter uma descrio deste comando, consulte a publicao Referncia de Comandos. ------------------------------------------------------------------------ 37.4 db2HistData As entradas a seguir devem ser includas na Tabela 11. Campos na Estrutura db2HistData: Nome do campo Tipo de Dados Descrio oOperation char Consulte a tabela 12. oOptype char Consulte a tabela 13. A tabela a seguir ser includa aps a Tabela 11. Tabela 12. Valores de eventos v lidos para oOperation na Estrutura db2HistData Valor Descrio Definio C Definio COBOL/FORTRAN A incluir rea DB2HISTORY_OP_ADD_ DB2HIST_OP_ADD_ da tabela TABLESPACE TABLESPACE B backup DB2HISTORY_OP_BACKUP DB2HIST_OP_BACKUP C cpia de DB2HISTORY_OP_LOAD_COPY DB2HIST_OP_LOAD_COPY carregamento D tabela DB2HISTORY_OP_DROPPED_ DB2HIST_OP_DROPPED_TABLE eliminada TABLE F avanar DB2HISTORY_OP_ROLLFWD DB2HIST_OP_ROLLFWD G reorganizar DB2HISTORY_OP_REORG DB2HIST_OP_REORG tabela L carregar DB2HISTORY_OP_LOAD DB2HIST_OP_LOAD N renomear rea DB2HISTORY_OP_REN_ DB2HIST_OP_REN_TABLESPACE da tabela TABLESPACE O eliminar rea DB2HISTORY_OP_DROP_ DB2HIST_OP_DROP_ da tabela TABLESPACE TABLESPACE Q quiesce DB2HISTORY_OP_QUIESCE DB2HIST_OP_QUIESCE R restaurar DB2HISTORY_OP_RESTORE DB2HIST_OP_RESTORE S executar DB2HISTORY_OP_RUNSTATS DB2HIST_OP_RUNSTATS estatstica T alterar rea DB2HISTORY_OP_ALT_ DB2HIST_OP_ALT_TBS da tabela TABLESPACE U descarregar DB2HISTORY_OP_UNLOAD DB2HIST_OP_UNLOAD A tabela a seguir tambm ser includa. Tabela 13. Valores de oOptype v lidos na Estrutura db2HistData oOperationoOptype Descrio C/COBOL/FORTRAN Definition B F Offline DB2HISTORY_OPTYPE_OFFLINE N Online DB2HISTORY_OPTYPE_ONLINE I Offline incremental DB2HISTORY_OPTYPE_INCR_OFFLINE O Online incremental DB2HISTORY_OPTYPE_INCR_ONLINE D Offline delta DB2HISTORY_OPTYPE_DELTA_OFFLINE E Online delta DB2HISTORY_OPTYPE_DELTA_ONLIN F E Fim do log DB2HISTORY_OPTYPE_EOL P Ponto no tempo DB2HISTORY_OPTYPE_PIT L I Inserir DB2HISTORY_OPTYPE_INSERT R Substituir DB2HISTORY_OPTYPE_REPLACE Q S Compartilhar quiesce DB2HISTORY_OPTYPE_SHARE U Atualizar quiesce DB2HISTORY_OPTYPE_UPDATE X Quiesce exclusivo DB2HISTORY_OPTYPE_EXCL Z Redefinir quiesce DB2HISTORY_OPTYPE_RESET R F Offline DB2HISTORY_OPTYPE_OFFLINE N Online DB2HISTORY_OPTYPE_ONLINE I Offline incremental DB2HISTORY_OPTYPE_INCR_OFFLINE O Online incremental DB2HISTORY_OPTYPE_INCR_ONLINE T C Incluir contineres DB2HISTORY_OPTYPE_ADD_CONT R Reequilibrar DB2HISTORY_OPTYPE_REB ------------------------------------------------------------------------ 37.5 db2HistoryOpenScan O valor a seguir ser includo no parmetro iCallerAction. DB2HISTORY_LIST_CRT_TABLESPACE Selecione somente os registros CREATE TABLESPACE e DROP TABLESPACE que passarem nos outros filtros. ------------------------------------------------------------------------ 37.6 db2XaGetInfo (nova API) db2XaGetInfo - Obter Informaes para o Gerenciador de Recursos Extrai informaes para um gerenciador de recurso particular uma vez feito um xa_open. Autorizao Nenhuma Conexo Requerida Banco de Dados Arquivo de Incluso da API sqlxa.h Sintaxe da API C /* Arquivo: sqlxa.h */ /* API: Obter Informaes para o Gerenciador de Recursos */ /* ... */ SQL_API_RC SQL_API_FN db2XaGetInfo ( db2Uint32 versionNumber, void * pParmStruct, struct sqlca * pSqlca); typedef SQL_STRUCTURE db2XaGetInfoStruct { db2int32 iRmid; struct sqlca oLastSqlca; } db2XaGetInfoStruct; Parmetros da API versionNumber Entrada. Especifica a verso e o nvel da estrutura passada como o segundo parmetro, pParmStruct. pParmStruct Entrada. Um indicador para a estrutura db2XaGetInfoStruct. pSqlca Sada. Um indicador para a estrutura sqlca. Para obter maiores informaes sobre esta estrutura, consulte a publicao Administrative API Reference. iRmid Entrada. Especifica o gerenciador de recursos para o qual a informao requerida. oLastSqlca Sada. Contm a sqlca para a ltima chamada XA API. Nota: Apenas a sqlca resultante da ltima falha XA API pode ser recuperada. ------------------------------------------------------------------------ 37.7 db2XaListIndTrans (nova API que sobrepe sqlxphqr) db2XaListIndTrans - Lista Transaes Duvidosas Fornece uma lista de todas as transaes duvidosas para os bancos de dados atualmente conectados. Escopo Esta API afeta apenas o n no qual ela emitida. Autorizao Um dos seguintes: * sysadm * dbadm Conexo Requerida Banco de Dados Arquivo de Incluso da API db2ApiDf.h Sintaxe da API C /* Arquivo: db2ApiDf.h */ /* API: Listar Transaes Duvidosas */ /* ... */ SQL_API_RC SQL_API_FN db2XaListIndTrans ( db2Uint32 versionNumber, void * pParmStruct, struct sqlca * pSqlca); typedef SQL_STRUCTURE db2XaListIndTransStruct { db2XaRecoverStruct * piIndoubtData; db2Uint32 iIndoubtDataLen; db2Uint32 oNumIndoubtsReturned; db2Uint32 oNumIndoubtsTotal; db2Uint32 oReqBufferLen; } db2XaListIndTransStruct; typedef SQL_STRUCTURE db2XaRecoverStruct { sqluint32 timestamp; SQLXA_XID xid; char dbalias[SQLXA_DBNAME_SZ]; char applid[SQLXA_APPLID_SZ]; char sequence_no[SQLXA_SEQ_SZ]; char auth_id[SQL_USERID_SZ]; char log_full; char connected; char indoubt_status; char originator; char reserved[8]; } db2XaRecoverStruct; Parmetros da API versionNumber Entrada. Especifica a verso e o nvel da estrutura passada como o segundo parmetro, pParmStruct. pParmStruct Entrada. Um indicador para a estrutura db2XaListIndTransStruct. pSqlca Sada. Um indicador para a estrutura sqlca. Para obter maiores informaes sobre esta estrutura, consulte a publicao Administrative API Reference. piIndoubtData Entrada. Um indicador para o buffer fornecido no aplicativo de onde o dado duvidoso ser retornado. O dado duvidoso est no formato db2XaRecoverStruct. O aplicativo pode atravessar a lista de transaes duvidosas utilizando o tamanho da estrutura db2XaRecoverStruct, iniciando no endereo fornecido por este parmetro. Se o valor for NULL, o DB2 ir calcular o tamanho do buffer requerido e retornar esse valor no oReqBufferLen. oNumIndoubtsTotal conter o nmero total de transaes duvidosas. O aplicativo pode alocar o tamanho de buffer requerido e emitir a API novamente. oNumIndoubtsReturned Sada. O nmero de registros de transaes duvidosas retornado no buffer especificado pelo pIndoubtData. oNumIndoubtsTotal Sada. O nmero Total de registros de transaes duvidosas disponvel na hora da chamada da API. Se o buffer piIndoubtData for muito pequeno para conter todos os registros, o oNumIndoubtsTotal ser maior que o total para o oNumIndoubtsReturned. O aplicativo deve emitir novamente a API para obter todos os registros. Nota: Este nmero deve alterar o meio das chamadas de API como um resultado da nova sincronizao de transao duvidosa autom tica ou heurstica, ou como um resultado de outras transaes entrando no estado duvidoso. oReqBufferLen Sada. Tamanho de buffer requerido para manter todas os registros de transaes duvidosas na hora da chamada da API. O aplicativo pode utilizar este valor para determinar o tamanho de buffer requerido chamando a API com pIndoubtData definido como NULL. Este valor pode ento ser utilizado para alocar o buffer requerido e a API pode ser emitida com pIndoubtData definida para o endereo do buffer alocado. Nota: O tamanho de buffer requerido pode se alterar entre as chamadas de API como um resultado da nova sincronizao de transao duvidosa autom tica ou heurstica, ou como um resultado de outras transaes entrando no estado duvidoso. Por isso, o aplicativo pode alocar um buffer maior para contabilizar. timestamp Sada. Especifica o tempo quando a transao entrou no estado incerto. xid Sada. Especifica o identificador XA assinalado pelo gerenciador de transao para identificar unicamente uma transao global. dbalias Sada. Especifica o alias do banco de dados onde a transao incerta se encontra. applid Sada. Especifica o identificador de aplicativos assinalado pelo gerenciador de banco de dados para esta transao. sequence_no Sada. Especifica o nmero de seqncia designado pelo gerenciador de banco de dados como uma extenso para a applid. auth_id Sada. Especifica o Id de autorizao do usu rio que executou a transao. log_full Sada. Indica se esta transao causou ou no uma condio de estouro de log. Os valores v lidos so: SQLXA_TRUE Esta transao incerta causou uma condio de estouro de log. SQLXA_FALSE Esta transao incerta no causa uma condio de estouro de log. connected Sada. Indica se o aplicativo est ou no conectado. Os valores v lidos so: SQLXA_TRUE A transao est sofrendo um processamento normal do ponto de sincronismo e est aguardando a segunda fase do commit de duas fases. SQLXA_FALSE A transao tornou-se incerta por uma falha anterior, e est agora aguardando por uma nova sincronizao do gerenciador de transao. indoubt_status Sada. Indica o status desta transao incerta. Os valores v lidos so: SQLXA_TS_PREP A transao est preparada. O parmetro conectado pode ser utilizado para determinar se a transao est aguardando uma segunda fase do processamento normal de commit ou se ocorreu um erro e ser necess rio uma nova sincronizao com o gerenciador de transao. SQLXA_TS_HCOM A transao efetuou o commit heuristicamente. SQLXA_TS_HROL A transao sofreu rollback heuristicamente. SQLXA_TS_MACK Falta na transao o reconhecimento do commit de um n em um banco de dados particionado. SQLXA_TS_END A transao foi encerrada neste banco de dados. Esta transao deve ser ativada novamente, efetuar o commit ou sofrer o rollback em um momento posterior. Tambm possvel que o gerenciador de transaes encontre um erro e a transao no seja concluda. Se o caso for esse, esta transao vai precisar de aes heursticas, porque deve suspender os bloqueios impedindo o acesso aos dados de outros aplicativos. Notas de Uso Um aplicativo tpico executar as seguintes etapas aps a definio da conexo atual do banco de dados ou do n coordenador do banco de dados particionado: 1. Chame db2XaListIndTrans com piIndoubtData definida como NULL. Isto ir retornar valores em oReqBufferLen e em oNumIndoubtsTotal. 2. Use o valor retornado no oReqBufferLen para alocar um buffer. Esse buffer pode no ser suficientemente grande se existirem transaes incertas adicionais devido chamada inicial desta API para obter o oReqBufferLen. O aplicativo pode fornecer um buffer maior que o oReqBufferLen. 3. Determine se todos os registros duvidosos da transao foram obtidos. Isto pode ser feito comparando-se oNumIndoubtsReturned com oNumIndoubtTotal. Se o oNumIndoubtsTotal for maior que o oNumIndoubtsReturned, o aplicativo poder repetir as etapas anteriores. Consulte tambm "sqlxhfrg - Esquecer Status da Transao", "sqlxphcm - Fazer Commit de uma Transao Incerta" e "sqlxphrl - Fazer Roll Back de uma Transao Incerta" na seo Administrative API Reference. ------------------------------------------------------------------------ 37.8 db2GetSnapshot - Obter instantneo A sintaxe da API db2GetSnapshot deve ser a seguinte: int db2GetSnapshot( unsigned char version; db2GetSnapshotData *data, struct sqlca *sqlca); Os parmetros descritos nos dados so: typedef struct db2GetSnapshotData{ sqlma *piSqlmaData; sqlm_collected *poCollectedData void *poBuffer; db2uint32 iVersion; db2int32 iBufferSize; db2uint8 iStoreResult; db2uint16 iNodeNumber; db2uint32 *poOutputFormat; }db2GetSnapshotData; ------------------------------------------------------------------------ |37.9 Registro de Log Esquecido |As informaes a seguir sero includas no Apndice F seguindo a seo |Preparo do Subordinador MPP. |Esse registro de log gravado aps um avano de transaes duvidosas ou |aps uma consolidao da consolidao de duas fases. O registro do log | gravado para marcar o fim da transao e libera quaisquer recursos do log |retidos. Para que a transao seja esquecida, ela deve estar em um |estado heuristicamente concludo. | |Tabela 9. Estrutura de Registro do Log Esquecido Descrio Tipo Deslocamento (Bytes) Cabealho do log LogManagerLogRecordHeader 0(20) hora sqluint64 20(8) Comprimento Total: 28 bytes ------------------------------------------------------------------------ 37.10 sqlaintp - Obter mensagem de erro A seguinte nota de uso deve ser includa para a descrio desta API: Em um aplicativo multithread, sqlaintp deve estar conectada a um contexto v lido; caso contr rio, o texto da mensagem para SQLCODE -1445 no poder ser obtido. ------------------------------------------------------------------------ 37.11 sqlbctcq - Fechar consulta do continer da rea da tabela O carregamento no um nvel de autorizao v lido para esta API. ------------------------------------------------------------------------ |37.12 sqleseti - Definir Informaes do Cliente |Os valores de dados fornecidos com a API tambm podem ser acessados pelo |registro especial de SQL. Os valores nesses registros so armazenados |na p gina de cdigos do banco de dados. Os valores de dados fornecidos |com esta API so convertidos para a p gina de cdigos do banco de dados antes |de serem armazenados nos registros especiais. Qualquer valor de dados |que exceder o tamanho m ximo suportado aps a converso para a p gina de |cdigos do banco de dados ser truncado antes de ser armazenado no |servidor. Esses valores truncados sero retornados pelos registros |especiais. Os valores de dados originais tambm sero armazenados no |servidor e no sero convertidos para a p gina de cdigos do banco de |dados. Os valores no convertidos podem ser retornados chamando a API |sqleqryi. ------------------------------------------------------------------------ 37.13 sqlubkp - Backup do banco de dados Para o parmetro BackupType, o valor SQLUB_FULL ser substitudo por SQLUB_DB. Ser feito backup de todas as tablespaces do banco de dados. Para oferecer suporte nova funcionalidade de backup incremental, os parmetros SQLUB_INCREMENTAL e SQLUB_DELTA tambm so includos. Uma imagem de backup incremental uma cpia de todos os dados do banco de dados alterados desde o ltimo backup completo bem sucedido. Uma imagem de backup delta uma cpia de todos os dados do banco de dados alterados desde o ltimo backup bem sucedido de qualquer tipo. ------------------------------------------------------------------------ 37.14 sqlureot - Reorganizar tabela A frase a seguir ser includa nas Notas de utilizao: REORGANIZE TABLE no pode utilizar um ndice baseado em uma extenso do ndice. ------------------------------------------------------------------------ 37.15 sqlurestore - Restaurar banco de dados Para o parmetro RestoreType, o valor SQLUD_FULL ser substitudo por SQLUD_DB. Ser feita uma restaurao de todos os tablespaces no banco de dados. Isto ser executado offline. Para oferecer suporte nova funcionalidade de restaurao incremental, o parmetro SQLUD_INCREMENTAL tambm includo. Uma imagem de backup incremental uma cpia de todos os dados do banco de dados alterados desde o ltimo backup completo bem sucedido. ------------------------------------------------------------------------ 37.16 Erro na Documentao com Relao ao Suporte de Memria Compartilhada Estendida (EXTSHM) do AIX No "Apndice E. Aplicativos de thread com acesso simultneo", a Nota 2 deveria ser: |2. Por padro, o AIX no permite que aplicativos de 32 bits |anexem mais de 11 segmentos de memria compartilhada por processo, dos quais |no m ximo 10 podem ser utilizados para conexes do DB2 local. |Para utilizar o EXTSHM com o DB2, faa o seguinte: |Em sesses do cliente: |export EXTSHM=ON |Quando iniciar o servidor DB2: |export EXTSHM=ON |db2set DB2ENVLIST=EXTSHM |db2start |No EEE, inclua tambm as linhas a seguir em sqllib/db2profile: |EXTSHM=ON |export EXTSHM ------------------------------------------------------------------------ 37.17 SQLFUPD 37.17.1 locklist O nome do token foi alterado de SQLF_DBTN_LOCKLIST para SQLF_DBTN_LOCK_LIST. O parmetro locklist foi alterado de SMALLINT para um INTEGER no sinalizado de 64 bits. A adio a seguir deve ser efetuada na tabela de Parmetros de configurao do banco de dados atualiz vel. Nome do parmetro Token Valor do token Tipo de Dados locklist SQLF_DBTN_LOCK 704 Uint64 _LIST O novo m ximo para esse parmetro 524 288. |Alm disso, no "Captulo 3. Estruturas de Dados", a |Tabela 53. Parmetros de Configurao de Banco de Dados Atualiz veis |lista incorretamente o valor de token do dbheap como |701. O valor correto 58. ------------------------------------------------------------------------ 37.18 SQLEDBDESC Sero includos dois valores na lista de valores v lidos para SQLDBCSS (definido no sqlenv). Eles so: SQL_CS_SYSTEM_NLSCHAR Seqncia de intercalao do sistema utilizando a verso NLS de rotinas de comparao para tipos de caracteres. SQL_CS_USER_NLSCHAR Seqncia de intercalao do usu rio utilizando a verso NLS de rotinas de comparao para tipos de caracteres. ------------------------------------------------------------------------ Application Building Guide ------------------------------------------------------------------------ |38.1 Atualizao Disponvel |O Application Building Guide foi atualizado como parte do FixPak 4. |O PDF mais recente est disponvel para download online em http://www.ibm.com/software/data/db2/udb/winos2unix/support. |Toda a documentao de atualizao est tambm disponvel em CD. Este |CD pode ser solicitado atravs do servio do DB2 utilizando o PTF nmero |U478862. Informaes sobre o contato com o Servio do DB2 esto |disponveis no endereo http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/help.d2w/report. ------------------------------------------------------------------------ |38.2 Notas Adicionais para Distribuio de Procedimentos SQL Compilados |Em sistema UNIX, certifique-se de que o propriet rio da instncia (ou seja, |o usu rio sob o qual o mecanismo do DB2 executado) e o propriet rio do |arquivo $DB2PATH/adm/.fenced pertenam ao mesmo grupo |principal. Como alternativa, cada um desses dois usu rios deve |pertencer ao grupo principal do outro. |Se uma operao GET ROUTINE ou PUT ROUTINE (ou seus procedimentos |correspondentes) falharem na execuo, um erro sempre ser retornado (SQLSTATE |38000), junto com texto diagnstico, fornecendo informaes sobre a causa da |falha. Por exemplo, se o nome do procedimento fornecido para GET |ROUTINE no identificar um procedimento SQL, o texto de diagnstico "100, |02000" ser retornado, em que "100" e "02000" so SQLCODE e SQLSTATE, |respectivamente, que identificam a causa do problema. SQLCODE e |SQLSTATE desse exemplo indicam que a linha especificada para o nome do |procedimento fornecido no foi encontrada nas tabelas de |cat logos. ------------------------------------------------------------------------ |Application Development Guide ------------------------------------------------------------------------ |39.1 Atualizao Disponvel |O Application Development Guide foi atualizado como parte do FixPak |4. O PDF mais recente est disponvel para download online em http://www.ibm.com/software/data/db2/udb/winos2unix/support. |As informaes nestas notas esto inclusas na referncia de |atualizao. Toda a documentao de atualizao est tambm disponvel |em CD. Este CD pode ser solicitado atravs do servio do DB2 utilizando |o PTF nmero U478862. Informaes sobre o contato com o Servio do DB2 |esto disponveis no endereo http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/help.d2w/report. ------------------------------------------------------------------------ |39.2 Novos Requisitos para executeQuery e executeUpdate | |Para estar de acordo com o padro J2EE 1.3, o driver DB2 JDB, desde |o FixPak 5, no permite mais a utilizao de uma instruo sem consulta com |executeQuery, nem de uma instruo de consulta com executeUpdate. A |tentativa de fazer isso resultar em uma das seguintes excees: | * |CLI0637E QUERY no pode ser encontrado. * |CLI0637E UPDATE no pode ser encontrado. | |Se o tipo de instruo for desconhecido, utilize execute(). ------------------------------------------------------------------------ |39.3 Suporte ao Driver JDBC para Mtodos Adicionais |CallableStatement.getBlob() e |CallableStatement.getClob() |O Driver JDBC agora suporta os mtodos CallableStatement.getBlob() e |CallableStatement.getClob(). Como o DB2 no suporta |localizadores LOB em parmetros de procedimentos armazenados, voc deve alocar |memria suficiente no sistema para manter o tamanho m ximo possvel de seus |dados LOB, o valor especificado em CREATE PROCEDURE. Uma exceo de sem |memria resultar se no houver memria suficiente. |Esse suporte no est disponvel para procedimentos armazenados no |catalogados. |Statement.setFetchSize(int rows) e |ResultSet.setFetchSize(int rows) |O driver JDBC agora suporta Statement.setFetchSize(int rows) e |ResultSet.setFetchSize(int rows). Esses mtodos agora podem ser |utilizados para melhorar o desempenho de ResultSet com o driver Type-3 (ou |"net"). ------------------------------------------------------------------------ |39.4 ------------------------------------------------------------------------ |39.5 Provedor IBM OLE DB para DB2 UDB |Para informaes sobre a utilizao do Provedor IBM OLE DB para DB2, |consulte o endereo http://www.ibm.com/software/data/db2/udb/ad/v71/oledb.html. ------------------------------------------------------------------------ Manual de Referncia ao CLI ------------------------------------------------------------------------ 40.1 Efetuando a vinculao dos Utilit rios de Banco de Dados Utilizando o Cliente de Run-Time O Cliente Run-Time no pode ser utilizado para efetuar a vinculao dos utilit rios de banco de dados (importar, exportar, reorganizar, o processador da linha de comandos) e o DB2 CLI efetua a vinculao dos arquivos para cada banco de dados antes que possam ser utilizados com aquele banco de dados. Voc deve utilizar o Cliente de Administrao do DB2 ou o Cliente de Desenvolvimento de aplicativo do DB2 preferivelmente. Voc deve efetuar a vinculao destes utilit rios de banco de dados e dos arquivos de vinculao do DB2 CLI para cada banco de dados antes que estes possam ser utilizados com aquele banco de dados. Em um ambiente de rede, se voc estiver utilizando mltiplos clientes que executam em diferentes sistemas operacionais, em diferentes verses ou nveis de servio do DB2, voc deve efetuar a vinculao dos utilit rios uma vez para cada sistema operacional e para a combinao da verso do DB2. ------------------------------------------------------------------------ 40.2 Utilizando SQL Est tico em Aplicativos CLI Para mais informaes sobre o uso de SQL est tico em aplicativos CLI, consulte a p gina Web em: http://www.ibm.com/software/data/db2/udb/staticcli/ ------------------------------------------------------------------------ 40.3 Limitaes do Perfilamento Est tico JDBC/ODBC/CLI O perfilamento est tico JDBC/ODBC/CLI atualmente objetiva aplicativos de avano direto. Isto no o significado para aplicativos complexos com muitos componentes funcionais e lgica de programa complexa durante a execuo. Uma instruo SQL deve ser executada com sucesso para que ela possa ser capturada em uma seo de perfilamento. Em uma sesso de coincidncia de instrues, as instrues no coincidentes dinmicas continuam a ser executadas como chamadas JDBC/ODBC/CLI dinmicas. Uma instruo SQL deve ser idntica caractere-por-caractere para uma que tenha sido capturada e ligada a um candidato v lido para a coincidncia da instruo. Os espaos so significativos: por exemplo, "COL = 1" considerado diferente de "COL=1". Use marcadores de parmetros no lugar de literais para aumentar a que correspondentes. Ao executar um aplicativo com instrues SQL est ticas pr-ligadas os registradores dinmicos que controlam o comportamento de instruo dinmico no ter efeito sobre as instrues que so convertidas para est tico. Se um aplicativo emite instrues DDL para objetos que so referenciados em instrues subseqentes, voc encontrar todas estas instrues no arquivo de captura. A Ferramenta de Vinculao de Perfilamento Est tico JDBC/ODBC/CLI tentar efetuar a vinculao. A tentativa de efetuar a vinculao ser bem sucedida com DBMSs que suportam a opo de vinculao VALIDATE(RUN), mas isto ir falhar com um que no efetuar. Neste caso o aplicativo no deve usar o Perfilamento Est tico. O Administrador de Banco de Dados pode editar o arquivo de captura para incluir, alterar ou remover instrues SQL, baseado nos requisitos especficos do aplicativo. ------------------------------------------------------------------------ 40.4 Transformaes ADT A seguintes informaes complementam as contidas na publicao. * Existe um novo tipo de descritor (smallint) SQL_DESC_USER_DEFINED_TYPE_CODE, com valores: SQL_TYPE_BASE 0 (esse no um USER_DEFINED_TYPE) SQL_TYPE_DISTINCT 1 SQL_TYPE_STRUCTURED 2 Esse valor pode ser consultado com SQLColAttribute ou SQLGetDescField (somente IRD). Os seguintes atributos so includos para obter os nomes de tipos reais: SQL_DESC_REFERENCE_TYPE SQL_DESC_STRUCTURED_TYPE SQL_DESC_USER_TYPE Os valores acima podem ser consultados por meio de SQLColAttribute ou SQLGetDescField (somente IRD). * Inclua SQL_DESC_BASE_TYPE caso o aplicativo precise dela. Por exemplo, o aplicativo no pode reconhecer o tipo estruturado, mas pretende busc -lo ou inseri-lo e deixar que outro cdigo se encarregue dos detalhes. * Inclua o novo atributo de conexo chamado SQL_ATTR_TRANSFORM_GROUP para permitir que o aplicativo defina o grupo de transformao (em vez de utilizar a instruo SQL "SET CURRENT DEFAULT TRANSFORM GROUP"). * Inclua um novo atributo de instruo/conexo chamado SQL_ATTR_RETURN_USER_DEFINED_TYPES que possa ser definido ou consultado por meio do SQLSetConnectAttr, que faz com que o CLI retorne o valor SQL_DESC_USER_DEFINED_TYPE_CODE como tipo SQL v lido. Este atributo obrigatrio antes de se usar qualquer transformao. o Por padro, o atributo desligado e faz com que a informao de tipo b sico seja retornada como tipo SQL. o Quando ativado, SQL_DESC_USER_DEFINED_TYPE_CODE ser retornado como SQL_TYPE. O aplicativo presume que voc verificou SQL_DESC_USER_DEFINED_TYPE_CODE, e, ento, recuperou o nome do tipo apropriado. O sistema estar disponvel para SQLColAttribute, SQLDescribeCol e SQLGetDescField. * O SQLBindParameter no fornece o erro quando voc efetua a vinculao do SQL_C_DEFAULT, porque no existe cdigo que permita o SQLBindParameter especificar o tipo SQL_USER_DEFINED_TYPE. Sero utilizados os tipos C originais padro com base no tipo SQL b sico transferido para o servidor. Por exemplo: sqlrc = SQLBindParameter (hstmt, 2, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_VARCHAR, 30, 0, &c2, 30, NULL); ------------------------------------------------------------------------ |40.5 Captulo 1. Introduo CLI | | |40.5.1 Diferenas entre a CLI do DB2 e a SQL Incorporada |Desconsidere o terceiro item no final da lista na seo "Vantagens de |Utilizar a CLI do DB2". As informaes corretas so as seguintes: |A CLI do DB2 permite recuperar v rias linhas e conjuntos de resultados |gerados a partir de um procedimento armazenado que reside em um servidor DB2 |Universal Database, um servidor DB2 para MVS/ESA (Verso 5 ou posterior) ou um |servidor OS/400 (Verso 5 ou posterior). O suporte recuperao de |v rios conjuntos de resultados no OS/400 requer que a PTF (Program Temporary |Fix) SI01761 seja aplicada ao servidor. Entre em contato com o |administrador do sistema OS/400 para assegurar que essa PTF tenha sido |aplicada. ------------------------------------------------------------------------ 40.6 Captulo 3. Utilizando Recursos Avanados |40.6.1 Gravando Aplicativos de Multi-Encadeamento |Os seguintes devem ser adicionados no final da seo"Aplicativos Mistos |Multi-Threaded": |Nota: recomendado que voc no utilize o tamanho da pilha padro, mas em vez |disso, aumente o tamanho da pilha para, no mnimo, 256 000. O DB2 |requer um tamanho de pilha mnimo de 256 000 ao chamar uma funo do |DB2. Portanto, voc deve assegurar-se de alocar um tamanho de pilha |total que seja grande o suficiente para seu aplicativo e os requisitos mnimos |para uma chamada da funo do DB2. | 40.6.2 Escrevendo um Aplicativo Unicode do DB2 CLI Esta uma nova seo para esse captulo. Existem duas reas principais de suporte para Aplicativos Unicode do DB2 CLI: 1. A incluso de um conjunto de funes que podem aceitar argumentos de cadeia Unicode no lugar de argumentos de cadeia ANSI. 2. A incluso de novos tipos de dados C e SQL para descrever dados Unicode. As seguintes sees fornecem mais informaes para essas duas reas. Para ser considerado um aplicativo Unicode, o aplicativo deve definir o atributo de conexo SQL_ATTR_ANSI_APP para SQL_AA_FALSE, antes de uma conexo ser feita. Isso ir assegurar que a CLI utilizar Unicode com o mtodo de preferncia de comunicao entre ela e o banco de dados. 40.6.2.1 Funes Unicode Funes ODBC API tm sufixos para indicar o formato de seus argumentos de cadeia: os que aceitam unicode terminam em W; os que aceitam ANSI no tm sufixo. Nota: ODBC inclui funes equivalentes com nomes terminados em A, mas elas no so utilizadas pelo DB2 CLI. Segue uma listas dessas funes que esto disponveis no DB2 CLI, que tem Verses ANSI e Unicode. SQLBrowseConnect SQLForeignKeys SQLPrimaryKeys SQLColAttribute SQLGetConnectAttr SQLProcedureColumns SQLColAttributes SQLGetConnectOption SQLProcedures SQLColumnPrivileges SQLGetCursorName SQLSetConnectAttr SQLColumns SQLGetDescField SQLSetConnectOption SQLConnect SQLGetDescRec SQLSetCursorName SQLDataSources SQLGetDiagField SQLSetDescField SQLDescribeCol SQLGetDiagRec SQLSetStmtAttr SQLDriverConnect SQLGetInfo SQLSpecialColumns SQLGetStmtAttr SQLStatistics SQLError SQLNativeSQL SQLTablePrivileges SQLExecDirect SQLPrepare SQLTables As funes Unicode cujos argumentos tm sempre o comprimento de cadeias interpretam estes argumentos como contagem de caracteres. As funes que retornam informaes de comprimento para dados do servidor tambm descrevem o tamanho da exibio e so precisas em termos de caracteres. Quando o comprimento (tamanho de transferncia de dados) puder fazer referncia a dados de cadeia ou no de cadeia, o comprimento ser interpretado como uma contagem de bytes. Por exemplo, SQLGetInfoW ainda usa o comprimento como contagem de bytes, mas SQLExecDirectW usar contagem de caracteres. A CLI retornar dados de conjuntos de resultados em Unicode ou ANSI, dependendo da ligao do aplicativo. Se um aplicativo vincular-se ao SQL_C_CHAR, o driver converter os dados SQL_WCHAR para SQL_CHAR. Um gerenciador de drivers ODBC, se utilizado, mapeia SQL_C_WCHAR para SQL_C_CHAR para drivers ANSI, mas no faz nenhum mapeamento para drivers Unicode. 40.6.2.2 Novos Tipos de Dados e Converses V lidas |Tipos de dados Addotopmal ODBC e CLI definidos foram includos para |acomodar bancos de dados Unicode. Esses tipos suplementam o conjunto de |tipos C e SQL j existentes. O novo tipo C, SQL_C_WCHAR, indica que o |buffer C contm dados UCS-2 em formato nativo endian. Os novos tipos |SQL, SQL_WCHAR, SQL_WVARCHAR e SQL_WLONGVARCHAR, indicam que um marcador de |coluna ou parmetro especfico contm dados Unicode. Para bancos de |dados DB2 Unicode, colunas gr ficas sero descritas atravs dos novos |tipos. Tabela 10. Converses de Dados Suportadas S S Q Q L S S L _ Q Q _ C L L C S S _ _ _ _ Q Q T C C D S L L Y _ _ B S Q S _ _ P S S C B C S Q S S L S Q C C E Q Q L L L Q L S Q S Q _ Q L _ _ _ L L O O O L _ Q L Q L C L _ T T T _ S _ B B B _ C L _ L _ _ _ C Y Y I C Q C _ _ _ C _ _ C _ C T C _ P P M _ L _ L L L _ N C _ C _ I _ D E E E B _ D O O O B U _ W _ S N F O _ _ S I C B C C C I M Tipo de Dados C C L H Y L U D T T N _ C A A A G E H H O O I O B A I A A B H T T T I R A A N R N A L T M M R I A O O O N I SQL R R G T T T E E E P S T R R R R T C BLOB X X D X CHAR D X X X X X X X X X X X X X CLOB D X X X DATE X X D X DBCLOB X X D X DECIMAL D X X X X X X X X X X DOUBLE X X X X X X D X X X FLOAT X X X X X X D X X X GRAPHIC X X D (No-Unicode) GRAPHIC X X X X X X X X X X X X D X (Unicode) INTEGER X X D X X X X X X X LONG D X X VARCHAR LONG X X X D VARGRAPHIC (No-Unicode) LONG X X X D VARGRAPHIC (Unicode) NUMERIC D X X X X X X X X REAL X X X X X D X X X SMALLINT X X X D X X X X X X BIGINT X X X X X X X X X D X TIME X X D X TIMESTAMP X X X X D VARCHAR D X X X X X X X X X X X X X VARGRAPHIC X X D (No-Unicode) VARGRAPHIC X X X X X X X X X X X X D X (Unicode) Nota: D A converso suportada. Essa a converso padro para o tipo de dados SQL. X Todos os IBM DBMSs suportam a converso. espao branco Nenhum IBM DBMS suporta a converso. o Os dados no so convertidos para os tipos de Localizadores LOB, pois os localizadores representam um valor de dados, consulte a seo Utilizando Objetos Grandes para obter maiores informaes. o SQL_C_NUMERIC est disponvel somente em sistemas operacionais Windows de 32 bits. 40.6.2.3 Palavra-Chave Obsoleta/Valor de Correo Antes dos aplicativos Unicode serem suportados, os aplicativos que eram escritos para trabalhar com dados de caracteres de byte nico podiam trabalhar com dados gr ficos de byte duplo atravs de uma srie de palavras-chave do arquivo cli ini, como GRAPHIC=1,2 ou 3, Patch2=7. Essa alternativa apresentava os dados gr ficos como dados de caracteres e tambm afetavam o comprimento relatado dos dados. |Essas palavras-chave no so mais necess rias para aplicativos |Unicode, e no devem ser utilizadas por causa do risco de efeitos colaterais |potenciais. Se voc no souber se um aplicativo especfico um |aplicativo Unicode, sugerimos que tente sem quaisquer palavras-chave que |afetem a manipulao de dados gr ficos. 40.6.2.4 Literais em Bancos de Dados Unicode Em bancos de dados no-unicode, os dados nas colunas LONG VARGRAPHIC e LONG VARCHAR no podem ser comparados. Os dados no GRAPHIC/VARGRAPHIC e as colunas CHAR/VARCHAR podem ser apenas comparadas ou atribudas para cada um, utilizando as funes explcitas cast desde que a p gina de cdigos implcita seja suportada. Isto inclui os literais GRAPHIC/VARGRAPHIC e CHAR/VARCHAR onde o literal GRAPHIC/VARGRAPHIC diferente do literal CHAR/VARCHAR por um prefixo G. Para os bancos de dados Unicode, a converso entre os literais GRAPHIC/VARGRAPHIC e CHAR/VARCHAR no so requeridos. Um prefixo G, tambm ser requerido no incio do literal GRAPHIC/VARGRAPHIC. Contanto que pelo menos um dos argumentos seja um literal, as converses implcitas ocorrero. Isso permite que literais com ou sem o prefixo G sejam utilizados em instrues que usam SQLPrepareW() ou SQLExecDirect().Os literais para LONG VARGRAPHICs j possuem um prefixo G. Para obter mais informaes, consulte a publicao "Converso entre Tipos de Dados" no "Captulo 3. Elementos de Linguagem" da publicao SQL Reference. 40.6.2.5 Configurao das Palavras-chave CLI Nova As trs palavras-chave foram includas para evitar que qualquer suplemento extra seja conectado aos aplicativos Unicode para um banco de dados. 1. DisableUnicode Descrio da Palavra-chave Desativa o suporte sublinhado para o Unicode. Sintaxe da Palavra-chave db2cli.ini: DisableUnicode = 0 | 1 Definio Padro: 0 (falso) Manual de Definies do DB2 CLI/ODBC: Esta palavra-chave no pode ser definida utilizando o bloco de notas de Definies CLI/ODBC. O arquivo db2cli.ini deve ser modificado diretamente para que a palavra-chave possa ser utilizada. Notas de Uso: Com o suporte Unicode ativado, e quando chamada por um aplicativo Unicode, a CLI tentar conectar-se ao banco de dados utilizando a melhor p gina de cdigos possvel do cliente para assegurar que no haja perda de dados desnecess ria por causa da converso de p gina de cdigos. Isso pode aumentar o tempo de conexo quando as p ginas de cdigos so trocadas ou pode causar converses de p ginas de cdigos no cliente que no ocorriam antes da incluso desse suporte. A definio dessa palavra-chave para True (1) far com que todos os dados Unicode sejam convertidos, primeiro, para a p gina de cdigos local do aplicativo, antes dos dados serem enviados para o servidor. Isso pode causar a perda dos dados que no possam ser representados na p gina de cdigos local. 2. ConnectCodepage Descrio da Palavra-chave Especifica uma determinada p gina de cdigos para ser utilizada na conexo com a origem de dados, para evitar sobrecarga extra de conexo. Sintaxe da Palavra-chave db2cli.ini: ConnectCodepage = 0 | 1 | Definio Padro: 0 Manual de Definies do DB2 CLI/ODBC: Esta palavra-chave no pode ser definida utilizando o bloco de notas de Definies CLI/ODBC. O arquivo db2cli.ini deve ser modificado diretamente para ser utilizado por esta palavra-chave. Notas de Uso: Aplicativos no-Unicode sempre conectam-se ao banco de dados utilizando a p gina de cdigos local do aplicativo ou a definio de ambiente DB2Codepage. Por padro, a CLI assegurar que os aplicativos Unicode sejam conectados aos bancos de dados Unicode, utilizando as p ginas de cdigos UTF-8 e UCS-2. O padro para conectar a banco de dados no-unicode utilizar a p gina de cdigos dos bancos de dados do servidor de banco de dados que estiver executando o DB2 para Windows, o DB2 para Unix ou o DB2 para OS/2. Isso assegura que no haja perda de dados desnecess ria devido converso da p gina de cdigos. Esta palavra-chave permite que o usu rio especifique a p gina de cdigos do banco de dados ao conectar-se a um banco de dados no-Unicode, para evitar sobrecarga extra na conexo. Especificar um valor igual a 1 faz com que SQLDriverConnect() retorne o valor correto na cadeia de conexo de sada, para que o valor possa ser utilizado em chamadas de SQLDriverConnect() futuras. 3. UnicodeServer Descrio da Palavra-chave Indica que a origem de dados um servidor unicode. Equivalente para definir ConnectCodepage=1208. Sintaxe da Palavra-chave db2cli.ini: UnicodeServer = 0 | 1 Definio Padro: 0 Manual de Definies do DB2 CLI/ODBC: Esta palavra-chave no pode ser definida utilizando o bloco de notas de Definies CLI/ODBC. O arquivo db2cli.ini deve ser modificado diretamente para que a palavra-chave possa ser utilizada. Notas de Uso: Esta palavra-chave equivalente para ConnectCodepage=1208 e includa apenas por convenincia. Defina esta palavra-chave para evitar conexes suplementares extra quando for conectar o DB2 para OS/390 Verso 7 ou superior. No existe a necessidade de definir esta palavra-chave para os banco de dados do DB2 para Windows, DB2 para Unix ou DB2 para OS/2, desde que no exista solicitao de uma processamento extra. |40.6.3 MTS (Microsoft Transaction Server) como Transaction Monitor |A informao a seguir corrige o valor padro para a palavra-chave de |configurao DISABLEMULTITHREAD na subseo "Instalao e Configurao": | * |Palavra-chave DISABLEMULTITHREAD (padro 0) | 40.6.4 Scrollable Cursors A seguinte informao deve ser includa na seo "Cursores desloc veis": 40.6.4.1 Suporte ao cursor desloc vel no lado do servidor para OS/390 O cliente UDB para as plataformas Unix, Windows e OS/2 suporta cursores desloc veis atualiz veis no lado do servidor ao executar em bancos de dados OS/390 Verso 7. Para acessar um cursor desloc vel do OS/390 em um ambiente em trs camadas, o cliente e o gateway devem estar executando o DB2 UDB Verso 7.1, FixPak 3 ou posterior. Existem duas interfaces de ativao de aplicativos que podem acessar cursores desloc veis: ODBC e JDBC. A interface JDBC pode acessar somente cursores desloc veis est ticos, enquanto a interface ODBC pode acessar somente cursores desloc veis est ticos e guiados por teclas no lado do servidor. Atributos do cursor A tabela abaixo lista os atributos padro para cursores do OS/390 Verso 7 no ODBC. Tabela 11. Atributos padro para cursores do OS/390 no ODBC Tipo de Sensibilidade Cursor Concorrncia Cursor cursor do cursor atualiz vel do cursor desloc vel somente no no concorrncia no desloc vel avanoa especificado atualiz vel somente leitura est tico insensvel no concorrncia desloc vel atualiz vel somente leitura guiado por sensvel atualiz vel concorrncia desloc vel conjunto de de valores teclas a Somente avano o comportamento padro de um cursor desloc vel sem a cl usula FOR UPDATE. Especificar FOR UPDATE em um cursor somente avano cria um cursor atualiz vel, com concorrncia de bloqueio, no desloc vel. Orientaes de busca suportadas Todas as orientaes de busca ODBC so suportadas atravs das interfaces SQLFetchScroll ou SQLExtendedFetch. Atualizao do cursor guiado por conjunto de teclas Um cursor guiado por conjunto de teclas atualiz vel. O driver CLI anexa a cl usula FOR UPDATE na consulta, exceto quando a consulta emitida como SELECT ... FOR READ ONLY, ou se a cl usula FOR UPDATE j existir. O cursor guiado por conjunto de teclas implementado no DB2 para OS/390 um cursor de concorrncia de valores. O cursor de concorrncia de valores resulta em bloqueio otimista, nos quais os bloqueios no so retidos at que seja tentada uma atualizao ou excluso. Quando for tentada uma atualizao ou excluso, o servidor do banco de dados compara os valores anteriores do aplicativo recuperado com os valores atuais da tabela fundamental. Se os valores corresponderem, a atualizao ou excluso ocorre. Se no corresponderem, a operao falha. Caso ocorra uma falha, o aplicativo deve consultar os valores novamente e reemitir a atualizao ou a excluso, se ainda for aplic vel. O aplicativo pode atualizar o cursor guiado por teclas de suas formas: * Emitir UPDATE WHERE CURRENT OF "" ou DELETE WHERE CURRENT OF "" utilizando SQLPrepare() com SQLExecute() ou SQLExecDirect(). * Utilizar SQLSetPos() ou SQLBulkOperations() para atualizar, excluir ou incluir uma linha no conjunto de resultados. Nota: As linhas includas em um conjunto de resultados atravs de SQLSetPos() ou SQLBulkOperations() so inseridas na tabela no servidor, mas no no conjunto de resultados do servidor. Portanto, essas linhas no so atualiz veis e no so sensveis a alteraes efetuadas por outras transaes. Entretanto, as linhas inseridas parecem parte do conjunto de resultados, j que so armazenadas em cache no cliente. Todos os disparos aplicados nas linhas inseridas parecem ao aplicativo como se no tivessem sido aplicadas. Para tornar as linhas inseridas atualiz veis, sensveis e para ver os resultados dos disparos aplicados, o aplicativo deve emitir a consulta novamente para gerar o conjunto de resultados. Detectando problemas em aplicativos criados antes do suporte ao cursor desloc vel Como o suporte ao cursor desloc vel novo, alguns aplicativos ODBC que trabalhavam com releases anteriores do UDB para OS/390 ou UDB para Unix, Windows, e OS/2 podem encontrar mudanas no comportamento ou no desempenho. Isso ocorre porque antes do suporte aos cursores desloc veis, os aplicativos que solicitavam um cursor desloc vel recebiam um cursor somente de avano. Para restaurar o comportamento anterior do aplicativo, antes do suporte ao cursor desloc vel, defina as seguintes palavras-chave de configurao no arquivo db2cli.ini: Tabela 12. Valores de palavra-chave de configurao para restaurar o comportamento do aplicativo antes do suporte ao cursor desloc vel Definio da palavra-chave de Descrio configurao PATCH2=6 Retorna uma mensagem indicando que os cursores desloc veis (guiados por conjunto de teclas e est ticos) no so suportados. O CLI automaticamente rebaixa qualquer pedido de um cursor desloc vel para um cursor somente de avano. DisableKeysetCursor=1 Desativa os cursores desloc veis guiados por teclas no lado do servidor e no lado do cliente. Pode ser utilizado para forar o driver do CLI a fornecer ao aplicativo um cursor est tico quando o cursor guiado por teclas for solicitado. UseServerKeysetCursor=0 Desativa o cursor guiado por teclas no lado do servidor para aplicativos que utilizam a biblioteca do cursor guiado por teclas no lado do cliente para simular um cursor guiado por teclas. Utilize essa opo somente quando ocorrerem problemas com o cursor guiado por teclas no lado do servidor, j que o cursor no lado do cliente resulta em muita sobra e geralmente tem desempenho mais baixo que o cursor no lado do servidor. 40.6.5 Utilizando o SQL Composto A seguinte nota est faltando na publicao: Qualquer instruo SQL que pode ser preparada dinamicamente, diferentemente de uma consulta, que pode ser executada como uma instruo dentro de uma instruo composta. Nota: Dentro do SQL Composto Atmico, instrues savepoint, savepoint de liberao e rollback para savepoint SQL so tambm desabilitadas. Do contr rio, o SQL Composto Atmico desabilitado no savepoint. 40.6.6 Utilizando os Procedimentos Armazenados |40.6.6.1 Privilgios para Construir e Depurar Procedimentos SQL e Java Armazenados |Os privilgios a seguir devem ser concedidos aos usu rios que querem |construir, depurar e executar procedimentos SQL armazenados: | * |db2 grant CONNECT on database to userid * |db2 grant IMPLICIT_SCHEMA on database to userid * |db2 grant BINDADD on database to userid * |db2 grant SELECT on SYSIBM.SYSDUMMY1 to userid * |db2 grant SELECT on SYSCAT.PROCEDURES to userid * |db2 grant UPDATE on DB2DBG.ROUTINE_DEBUG to userid | |Os privilgios a seguir devem ser concedidos aos usu rios que queiram |construir, depurar e executar procedimentos Java armazenados: | * |db2 grant CONNECT on database to userid * |db2 grant IMPLICIT_SCHEMA on database to userid * |db2 grant BINDADD on database to userid(necess rio apenas se |voc construir procedimentos Java armazenados com SQL est tico utilizando |SQLJ) * |db2 grant SELECT on SYSIBM.SYSDUMMY1 to userid * |db2 grant SELECT on SYSCAT.PROCEDURES to userid * |db2 grant UPDATE on DB2DBG.ROUTINE_DEBUG to userid | |Para criar a tabela DB2DBG.ROUTINE_DEBUG, emita o seguinte |comando: |db2 -tf sqllib/misc/db2debug.ddl |Para obter mais informaes sobre depurao de procedimentos Java |armazenados, consulte Application Development Guide. 40.6.6.2 Gravando um Procedimento Armazenado em CLI A seguir uma limitao no documentada nos procedimentos armazenados CLI: Se estiver fazendo chamadas aos procedimentos armazenados CLI mltiplos, o aplicativo fecha os cursores abertos de um procedimento armazenado antes de chamar o prximo procedimento armazenado. Mais especificamente, o primeiro conjunto de cursores abertos devem ser fechados antes do prximo procedimento armazenado tentar abrir um cursor. 40.6.6.3 Procedimentos Armazenados e Vinculao Autom tico da CLI O item a seguir suplementa as informaes na publicao: O driver CLI/ODBC normalmente ir fazer a vinculao autom tica dos pacotes da CLI na primeira vez que um aplicativo CLI/ODBC executar a SQL no banco de dados, contanto que o usu rio tenha o privilgio ou a autorizao adequada. A vinculao autom tica dos pacotes da CLI no pode ser executada de dentro de um procedimento armazenado e, portanto, no ocorrer se a primeira coisa que um aplicativo fizer for chamar um procedimento armazenado da CLI. Antes de executar um aplicativo da CLI que chama um procedimento armazenado da CLI em um novo banco de dados do DB2, voc deve conectar os pacotes da CLI uma vez com este comando: UNIX db2 bind /@db2cli.lst blocking all Windows e OS/2 db2bind "%DB2PATH%\bnd\@db2cli.lst" blocking A abordagem recomendada sempre conectar estes pacotes ao mesmo tempo em que o banco de dados criado para evitar a vinculao autom tica no run-time. A vinculao autom tica poder falhar se o usu rio no tiver privilgio ou se outro aplicativo tentar fazer a vinculao autom tica ao mesmo tempo. ------------------------------------------------------------------------ 40.7 Captulo 4. Configurando CLI/ODBC e executando amostras de aplicativos |40.7.1 Palavras-chave de configurao |40.7.1.1 CURRENTFUNCTIONPATH | |Ignore o ltimo par grafo da palavra-chave CURRENTFUNCTIONPATH. As |informaes corretas so as seguintes: |Esta palavra-chave utilizada como parte do processo de resoluo de |referncia de funo no qualificada e procedimento armazenado que pode ter |sido definido com um nome de esquema diferente do esquema do usu rio |atual. A ordem dos nomes de esquemas determina a ordem na qual os nomes |das funes e procedimentos so resolvidos. Para obter mais informaes |sobre a resoluo de funes e procedimentos, consulte a seo a seo AQL |Reference. |40.7.1.2 SKIPTRACE | |A seguir, descreve-se essa nova palavra-chave de configurao: | |Descrio de Palavra-Chave: |Permite que aplicativos CLI sejam excludos da funo de rastreio. |Sintaxe da Palavra-Chave db2cli.ini: |SKIPTRACE = 0 | 1 |Definio Padro: |No ignore a funo de rastreio. |Guia Definies do DB2 CLI/ODBC: |Esta palavra-chave no pode ser definida utilizando o bloco de notas de |Definies CLI/ODBC. O arquivo db2cli.ini deve ser modificado |diretamente para ser utilizado por esta palavra-chave. |Notas de Uso: |Essa palavra-chave pode melhorar o desempenho por permitir que a funo de |rastreio desvie-se de aplicativos CLI. Portanto, se o recurso de |rastreio db2trc do DB2 estiver ativo e essa palavra-chave for definida como 1, |o rastreio no conter informaes da execuo do aplicativo CLI. |Ativar SKIPTRACE recomendado para ambientes de produo na plataforma |UNIX onde as informaes de rastreio no so exigidas. Os ambientes de |teste podem, porm, beneficiar-se de ter uma sada de rastreio; assim, |essa palavra-chave pode ser desativada (ou deixada em sua definio padro) |quando se deseja informaes de execuo detalhadas. |SKIPTRACE deve ser definido na seo [COMMON] do arquivo de |configurao db2cli.ini | ------------------------------------------------------------------------ 40.8 Captulo 5. Funes da CLI do DB2 40.8.1 SQLBindFileToParam - Ligar Referncia do Arquivo do LOB ao Parmetro do LOB O ltimo parmetro - IndicatorValue - na funo CLI SQLBindFileToParam() est documentado atualmente como "sada (adiada)". Ele deve ser "entrada (adiada)". |40.8.2 SQLColAttribute -- Retornar um Atributo de Coluna | | | |As seguintes atualizaes so incluses na coluna "Descrio" para os |argumentos SQL_DESC_AUTO_UNIQUE_VALUE e SQL_DESC_UPDATABLE: | |SQL_DESC_AUTO_UNIQUE_VALUE |SQL_FALSE retornado em NumericAttributePtr para todos os |tipos de dados SQL do DB2. Atualmente, a CLI do DB2 no pode determinar |se uma coluna uma coluna de identidade, portanto, SQL_FALSE sempre ser |retornado. Essa limitao no est totalmente em conformidade com as |especificaes do ODBC. Verses futuras da CLI do DB2 para servidores |Unix e Windows fornecero suporte auto-exclusivo. |SQL_DESC_UPDATABLE |Indica se o tipo de dados da coluna um tipo de dados atualiz vel: | o |SQL_ATTR_READWRITE_UNKNOWN retornado em NumericAttributePtr |para todos os tipos de dados SQL do DB2. Ele retornado porque a CLI |do DB2 no pode determinar atualmente se uma coluna atualiz vel. |Verses futuras da CLI do DB2 para servidores Unix e Windows podero |determinar se uma coluna atualiz vel. | | |40.8.3 SQLGetData - Obter Dados de uma Coluna | |O texto a seguir substitui a sentena atual que aparece na colune |Explicao para SQLSTATE 22007 da tabela SQLSTATEs para SQLGetData: |A converso de uma cadeia para um formato de data e hora foi indicada, mas |uma representao ou valor de cadeia inv lido foi especificado, ou o valor era |uma data inv lida. |40.8.4 SQLGetInfo - Obter Informaes Gerais | | |A informao a seguir corrige as informaes na seo "Uso" sob |"Informaes Retornadas pelo SQLGetInfo": | |SQL_DATABASE_NAME (string) |O nome do banco de dados atual sendo utilizado. |Nota: Esta cadeia a mesma daquela retornada pela instruo SELECT CURRENT SERVER |em sistemas no-host. Para bancos de dados do host, como o DB2 para |OS/390 ou DB2 para OS/400, a cadeia retornada o nome do banco de dados DCS |que foi fornecido quando o comando CATALOG DCS DATABASE DIRECTORY foi emitido |no gateway DB2 Connect. | | |40.8.5 SQLGetLength - Recuperar Comprimento de um Valor de Cadeia | | |A informao a seguir corrige a nota de rodap na "Tabela 113. |Argumentos de SQLGetLength" : |Nota: a Isso est em caracteres para dados |DBCLOB. 40.8.6 SQLNextResult - Associar o Prximo Conjunto de Resultados a Outra Manipulao de Instruo O seguinte texto deve ser includo no Captulo 5, "Funes do DB2 CLI": 40.8.6.1 Objetivo Especificao: DB2 CLI 7.x 40.8.6.2 Sintaxe SQLRETURN SQLNextResult (SQLHSTMT StatementHandle1 SQLHSTMT StatementHandle2); 40.8.6.3 Argumentos de Funo Tabela 13. Argumentos SQLNextResult Tipo de DadosArgumento Uso Descrio SQLHSTMT StatementHandle entrada Manipulao de instruo. SQLHSTMT StatementHandle entrada Manipulao de instruo. 40.8.6.4 Uso Um procedimento armazenado retorna v rios conjuntos de resultados deixando um ou mais cursores abertos aps a sada. O primeiro conjunto de resultados sempre acessado atravs da manipulao de instruo chamada pelo procedimento armazenado. Se v rios conjuntos de resultados forem retornados, o SQLMoreResults() ou o SQLNextResult() podero ser utilizados para descrever e buscar o conjunto de resultados. SQLMoreResults() utilizado para fechar o cursor do primeiro conjunto de resultados e permitir que o prximo seja processado, contanto que SQLNextResult() mova o prximo conjunto de resultados paraStatementHandle2, sem fechar o cursor em StatementHandle1. Ambas as funes retornaro SQL_NO_DATA_FOUND, se no houver nenhum conjunto de resultados para ser buscado. O uso de SQLNextResult() permite que os conjuntos de resultados sejam processados em qualquer ordem depois de terem sido transferidos para outras manipulaes de instruo. Chamadas mistas a SQLMoreResults() e a SQLNextResult() so permitidas at que no haja mais cursores (conjuntos de resultados abertos) em StatementHandle1. Quando SQLNextResult() retorna SQL_SUCCESS, o prximo conjunto de resultados no mais associado a StatementHandle1. Ao invs disso, o prximo conjunto de resultados associado a StatementHandle2, como se uma chamada a SQLExecDirect() tivesse executado com sucesso uma consulta em StatementHandle2. O cursor, portanto, pode ser descrito utilizando SQLNumResultSets(), SQLDescribeCol() ou SQLColAttribute(). Aps SQLNextResult() ter sido chamado, o conjunto de resultados agora associado a StatementHandle2 ser removido da cadeia de conjuntos de resultados restantes e no poder ser utilizado novamente em SQLNextResult() ou SQLMoreResults(). Isso significa que para 'n' conjuntos de resultados, SQLNextResult() pode ser chamado com sucesso no m ximo 'n-1' vezes. Se SQLFreeStmt() for chamado com a opo SQL_CLOSE ou SQLFreeHandle() for chamado com HandleType definido para SQL_HANDLE_STMT, todos os conjuntos de resultados pendentes nessa manipulao de instruo sero descartados. SQLNextResult() retorna SQL_ERROR se StatementHandle2 tiver um cursor aberto ou StatementHandle1 e StatementHandle2 no estiverem na mesma conexo. Se forem retornados quaisquer erros ou avisos, SQLError() dever sempre ser chamado em StatementHandle1. Nota: SQLMoreResults() tambm trabalha com uma consulta de parmetros com uma matriz de valores de parmetros especificada com SQLParamOptions() e SQLBindParameter(). SQLNextResult(), no entanto, no suporta isso. 40.8.6.5 Cdigos de Retorno * SQL_SUCCESS * SQL_SUCCESS_WITH_INFO * SQL_STILL_EXECUTING * SQL_ERROR * SQL_INVALID_HANDLE * SQL_NO_DATA_FOUND 40.8.6.6 Diagnsticos Tabela 14. SQLNextResult SQLSTATEs SQLSTATE Descrio Explicao 40003 Falha no link de O link de comunicao entre o aplicativo 08S01 comunicao. e a origem de dados falhou antes da concluso da funo. 58004 Queda do sistema Erro do sistema irrecuper vel. inesperada. HY001 Falha na alocao de O DB2 CLI no consegue alocar a memria memria. requerida para suportar a execuo ou a concluso da funo. HY010 Erro de seqncia da A funo foi chamada durante uma operao funo. de dados na execuo (SQLParamData(), SQLPutData()). StatementHandle2 tem um cursor aberto associado a ele. A funo foi chamada durante uma operao BEGIN COMPOUND e END COMPOUND SQL. HY013 Erro inesperado de O DB2 CLI no consegue acessar a memria manipulao de requerida para suportar a execuo ou a memria. concluso da funo. HYT00 Tempo limite O perodo de timeout expirou antes da expirado. origem de dados retornar o conjunto de resultados. Os tempos limite so suportados somente em sistemas de multitarefas, como o Windows 3.1 e o Macintosh System 7. O perodo de timeout pode ser definido utilizando-se o atributo SQL_ATTR_QUERY_TIMEOUT para SQLSetConnectAttr(). 40.8.6.7 Restries Somente SQLMoreResults() pode ser utilizado para consultas de parmetros. 40.8.6.8 Referncias * "SQLMoreResults - Determina se H Mais Conjuntos de Resultados" na p gina 535 * "Retornando Conjuntos de Resultados de Procedimentos Armazenados" na p gina 120 |40.8.7 SQLSetEnvAttr - Definir Atributo de Ambiente | |O seguinte um atributo de ambiente adicional que pertence seo |"Atributos de Ambiente", em "Uso": | |SQL_ATTR_KEEPCTX |Um valor inteiro de 32 bits que especifica se o contexto deve ser mantido |quando o identificador de ambiente liberado. Esse atributo deve ser |definido no nvel de ambiente. Pode ser utilizado por aplicativos com |v rios threads para gerenciar contextos associados a conexes, recursos de |banco de dados e transmisso de dados de cada thread. Os valores |possveis so: | o |SQL_FALSE: O aplicativo disponibilizar o contexto quando |o identificador de ambiente do thread for liberado. Esse o valor |padro. o |SQL_TRUE: O contexto permanecer v lido quando o identificador de |ambiente do thread for liberado, disponibilizando o contexto a outros threads |existentes na mesma conexo. Definir SQL_ATTR_KEEPCTX como SQL_TRUE |pode resolver alguns problemas associados aos contextos conflitantes em |aplicativos com v rios threads. | | |Nota: uma extenso IBM. | | |40.8.8 SQLSetStmtAttr -- Definir Opes Relacionadas a uma Instruo | | |As informaes a seguir substituem as informaes existentes para o |atributo de instruo SQL_ATTR_QUERY_TIMEOUT: | |SQL_ATTR_QUERY_TIMEOUT (DB2 CLI v2) |Um valor inteiro de 32 bits que o nmero de segundos que ser aguardado |para que uma instruo SQL seja executada entre o retorno para o |aplicativo. Essa opo pode ser definida e utilizada para finalizar |longas consultas em execuo. O valor 0 significa que no h |timeout. A CLI do DB2 suporta valores no-zero para todas as |plataformas que suportem mltiplos threads. | ------------------------------------------------------------------------ |40.9 Apndice C. DB2 CLI e ODBC |Esta uma nova seo includa nesse apndice. |40.9.1 Aplicativos Unicode do ODBC | | |Um aplicativo Unicode do ODBC envia e recupera dados de caractere |primeiramente no UCS-2. Isso feito chamando as verses Unicode das |funes ODBC (aquelas com um sufixo 'W') e indicando tipos de dados |Unicode. O aplicativo no especifica explicitamente uma p gina de |cdigos local. Ela ainda pode chamar as funes ANSI e passar as |cadeias da p gina de cdigos local. |Por exemplo, o aplicativo pode chamar SQLConnectW() e passar o DSN, o ID do |Usu rio e a Senha como argumentos do Unicode. Ento, ela pode chamar |SQLExecDirectW() e passar uma cadeia de instruo SQL do Unicode e vincular |uma combinao de buffers da p gina de cdigos local ANSI (SQL_C_CHAR) e de |buffers Unicode (SQL_C_WCHAR). Os tipos de dados do banco de dados |podem ser ou no Unicode. |Se um aplicativo CLI chamar SQLSetConnectAttr com SQL_ATTR_ANSI_APP |definido para SQL_AA_FALSE ou chamar SQLConnectW sem definir o valor de |SQL_ATTR_ANSI_APP, ento, o aplicativo considerado um aplicativo |Unicode. Isso significa que todos os dados CHAR so enviados e |recebidos de um banco de dados Unicode no formato UTF-8. O aplicativo |poder ento buscar os dados CHAR nos buffers SQL_C_CHAR na p gina de cdigos |local (com possvel perda de dados) ou nos buffers SQL_C_WCHAR no UCS-2 sem |perda de dados. |Se o aplicativo no fizer nenhuma das duas chamadas anteriores, os dados |CHAR sero convertidos para a p gina de cdigos local dos aplicativos no |servidor. Isso significa que os dados CHAR buscados em SQL_C_WCHAR |podero sofrer perda de dados. |Se a vari vel de instncia DB2CODEPAGE for definida (utilizando db2set) |para a p gina de cdigos 1208 (UTF-8), o aplicativo receber todos os dados |CHAR em UTF-8, porque essa agora a p gina de cdigos local. O |aplicativo tambm deve assegurar que todos os dados de entrada CHAR tambm |estejam em UTF-8. O ODBC tambm assume que todos os dados SQL_C_WCHAR |esto no formato endian nativo. A CLI executar toda a reverso de |bytes requerida para SQL_C_WCHAR. |40.9.1.1 Aplicativos Unicode Versus No-Unicode do ODBC |Este release do DB2 Universal Database contm a APISQLConnectW(). Um |driver Unicode deve exportar SQLConnectW para ser reconhecido como um driver |Unicode pelo gerenciador de driver. importante observar que muitos |aplicativos ODBC (como o Microsoft Access e o Visual Basic) chamam |SQLConnectW(). Em releases anteriores do DB2 Universal Database, o DB2 |CLI no suportava essa API e, portanto, no era reconhecido como um driver |Unicode pelo gerenciador de driver ODBC. Isso fazia com que o |gerenciador de driver ODBC convertesse todos os dados Unicode para a p gina de |cdigos local do aplicativo. Com o suporte includo da funo |SQLConnectW(), esses aplicativos agora sero conectados como aplicativos |Unicode e o DB2 CLI cuidar de todas as converses de dados |necess rias. |O DB2 CLI agora aceita APIs Unicode (com um sufixo "W") e APIs ANSI |comuns. O ODBC define um conjunto de funes com um sufixo "A", mas o |gerenciador de driver no passa funes ANSI com o sufixo "A" para o |driver. Ao invs disso, ele converte essas funes para chamadas de |funo ANSI sem o sufixo e, ento, as passa ao driver. |Um aplicativo ODBC que chama a API SQLConnectW() considerado um |aplicativo Unicode. Como o gerenciador de driver ODBC sempre chamar a |API SQLConnectW() independente da verso do aplicativo chamado, o ODBC |introduziu o atributo de conexo SQL_ATTR_ANSI_APP para notificar a unidade, |se o aplicativo precisar ser considerado um aplicativo ANSI ou UNICODE. |Se SQL_ATTR_ANSI_APP for definido para SQL_AA_TRUE, o DB2 CLI converter todos |dados Unicode para a p gina de cdigos local antes de envi -lo ao |servidor. ------------------------------------------------------------------------ 40.10 Apndice D. Funes Escalares Estendidas 40.10.1 Funes de Data e Hora As funes a seguir esto incompletas a partir da seo Funes de Data e Hora do Apndice D "Funes Escalares Estendidas": DAYOFWEEK_ISO( date_exp ) Retorna o dia da semana em date_exp como um valor inteiro no intervalo de 1 a 7, em que 1 representa segunda-feira. Observe a diferena entre esta funo e a funo DAYOFWEEK(), em que 1 representa domingo. WEEK_ISO( date_exp ) Retorna a semana do ano em date_exp como sendo um valor inteiro no intervalo de 1 a 53. A semana 1 definida como a primeira do ano a conter uma quinta-feira. Portanto, Semana 1 equivalente primeira semana a conter 4 de Janeiro, visto que considera-se a Segunda-Feira o primeiro dia da semana. Observe que WEEK_ISO() diferente da definio atual de WEEK(), que retorna um valor de at 54. Para a funo WEEK(), a Semana 1 indica a semana que contm o primeiro S bado. Isto equivalente semana que contm primeiro de Janeiro, mesmo que a semana contenha somente um dia. DAYOFWEEK_ISO() e WEEK_ISO() esto automaticamente disponveis em um banco de dados criado na Verso 7. Se um banco de dados foi criado antes da Verso 7, essas funes podem no estar disponveis. Para tornar as funes DAYOFWEEK_ISO() e WEEK_ISO() disponveis em tal banco de dados, utilize o comando de sistema db2updb. Para obter maiores informaes sobre db2updb, consulte a seo "Referncia e Comando" nestas Notas de Release. ------------------------------------------------------------------------ 40.11 Apndice K. Utilizando a Funcionalidade de Rastreamento do DB2 CLI/ODBC/JDBC As sees dentro deste apndice foram atualizadas. Consulte o captulo "Rastreamentos" no Troubleshooting Guide para obter as informaes mais atualizadas sobre esta funcionalidade de rastreamento. ------------------------------------------------------------------------ |Referncia de Mensagens ------------------------------------------------------------------------ |41.1 Atualizao Disponvel |O Referncia de Mensagens foi atualizado como parte do FixPak 4. O |PDF mais recente est disponvel para download online em http://www.ibm.com/software/data/db2/udb/winos2unix/support.Toda |a documentao de atualizao est tambm disponvel em CD. Este CD |pode ser solicitado atravs do servio do DB2 utilizando o PTF nmero |U478862. Informaes sobre o contato com o Servio do DB2 esto |disponveis no endereo http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/help.d2w/report. ------------------------------------------------------------------------ |41.2 Atualizaes de Mensagens |A tabela a seguir indica as mensagens que foram alteradas desde a ltima |publicao da Referncia de Mensagens. Instrues para exibir o texto |das mensagens online esto includas nessas notas. | |Tabela 15. Mensagens Novas e Alteradas Cdigo da Mensagem Natureza da Alterao SQL2554N Novo Cdigo de Razo SQL0490N Nova Mensagem SQL20214N Nova Mensagem SQL20211N Nova Mensagem |A tabela a seguir indica os estados de SQL que foram alterados desde a |ltima publicao da Referncia de Mensagens. Instrues para exibir o |texto das mensagens online esto includas nessas notas. | |Tabela 16. Novas Mensagens SQLSTATE Valor de SQLSTATE Significado 428B7 Um nmero especificado em uma instruo SQL est fora da faixa v lida. 428FI ORDER OF foi especificada, mas o table-designator no contm uma cl usula ORDER BY. 428FJ ORDER BY no permitida na seleo completa exterior de uma exibio ou tabela de resumo. ------------------------------------------------------------------------ |41.3 Lendo Texto de Mensagens Online | | | |Supem-se que voc esteja familiarizado com as funes do sistema |operacional onde o DB2 est instalado. |As mensagens do DB2 a seguir podem ser acessadas a partir da linha de |comandos do sistema operacional: | |Prefixo |Descrio |ASN |mensagens geradas pela replicao do DB2 |CCA |mensagens geradas pelo Assistente de Configurao de Cliente |CLI |mensagens geradas pela Interface de Nvel de Chamada |DBA |mensagens geradas pelo Centro de Controle e pelo Utilit rio de |Administrao do Banco de Dados |DBI |mensagens geradas pela instalao e pela configurao |DB2 |mensagens geradas pelo processador de linha de comando |DWC |mensagens geradas pelo Data Warehouse Center |FLG |mensagens e cdigos de razo gerados pelo Gerenciados do Cat logo de |Informaes |GSE |mensagens geradas pelo DB2 Spatial Extender |SAT |mensagens geradas pelo DB2 Satellite |SPM |mensagens geradas pelo gerenciador sync point |SQJ |mensagens geradas por SQLJ (Embedded SQL in Java) |SQL |mensagens geradas pelo gerenciador de banco de dados quando um aviso ou |uma condio de erro detectada. | |Tambm o texto da mensagem associado aos valores SQLSTATE esto disponveis |online. |Identificadores de mensagens consistem em um prefixo de mensagem de trs |caracteres (veja a lista acima), seguido por um nmero de mensagem de quatro |ou cinco dgitos. A letra de dgito nico no final que descreve a |gravidade da mensagem de erro opcional. |Para acessar a ajuda dessas mensagens de erro, digite o seguinte no prompt |de comandos do sistema operacional: |db2 "? XXXnnnnn" | |em que XXX representa o prefixo da mensagem |e nnnnn representa o nmero da mensagem. |Nota: O identificador de mensagem aceito como um parmetro do comando |db2 no diferencia maisculas e minsculas e a letra final no |obrigatria. | |Portanto, os seguintes comandos produziro o mesmo resultado: | * |db2 "? SQL0000N" * |db2 "? sql0000" * |db2 "? SQL0000n" | |Se o texto da mensagem for muito longo para sua tela, utilize o seguinte |comando (em sistemas baseados em unix e outros que suportam |'more'): |db2 "? XXXnnnnn" | more | |A Ajuda tambm pode ser chamada no modo de entrada interativo. Para |digitar o modo de entrada interativo, digite o seguinte no prompt de comandos |do sistema operacional: |db2 | |Uma vez no modo de entrada interativo, voc poder digitar comandos no |seguinte prompt de comandos: |db2 => | |Para obter ajuda para as mensagens do DB2 nesse modo, digite o seguinte no |prompt de comandos: |? XXXnnnnn | |Nota: Se o texto da mensagem exceder o comprimento da tela, os usu rios com |estaes de trabalho no gr ficas podem canalizar a sada para o programa |'more' (em sistema baseados no unix) ou redirecionar a sada para um |arquivo que poder , ento, ser navegado. | |O texto da mensagem associado a um determinado valor SQLSTATE pode ser |recuperado atravs de: |db2 "? nnnnn" | | ou | |db2 "? nn" | |em que nnnnn um SQLSTATE (alfanumrico) de cinco dgitos e |nn o cdigo de classe SQLSTATE de dois dgitos (primeiros dois |dgitos do valor SQLSTATE). ------------------------------------------------------------------------ Referncia a SQL ------------------------------------------------------------------------ |42.1 Atualizao Disponvel da SQL Reference |A SQL Reference foi atualizada e o .pdf mais recente est disponvel |para download online em http://www.ibm.com/software/data/db2/udb/winos2unix/support. |As informaes nessas notas so complementares referncia atualizada. |Toda a documentao atualizada tambm est disponvel no CD. Esse CD |pode ser solicitado atravs do servio DB2 utilizando a PTF nmero |U478862. Informaes sobre como entrar em contato com o Servio DB2 |esto disponveis no endereo http://www.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/help.d2w/report. ------------------------------------------------------------------------ |42.2 Ativando as Novas Funes e Procedimentos A Verso 7 do FixPaks entrega novas funes escalares incorporadas ao SQL. Consulte as atualizaes da SQL Reference para obter uma descrio dessas novas funes. As novas funes no so automaticamente ativadas em cada banco de dados quando o cdigo de servidor do banco de dados atualizado para o novo nvel de servio. Para ativar essas novas funes, o administrador do sistema deve emitir o comando db2updv7, especificando cada banco de dados no servidor. Esse comando faz uma entrada no banco de dados que assegura que os objetos do banco de dados criando antes da execuo desse comando utilizam assinaturas de funo existentes que podem corresponder s novas assinaturas de funo. |Para obter informaes sobre como ativar as funes do MQSeries |(aquelas definidas no esquema DB2MQ), consulte a seo MQSeries. ------------------------------------------------------------------------ |42.3 SET SERVER OPTION - Erro da Documentao |A seo Notas para a instruo SET SERVER OPTION contm informaes |destorcidas. A nota atual a seguinte: | * |SET SERVER OPTION atualmente suporta apenas as opes password, fold_id e |fold_pw do servidor. | |Essa instruo no verdadeira. SET SERVER OPTION suporta todas as |opes do servidor, inclusive as opes do servidor para wrappers no |fornecidos pela IBM. A nota deve ser ignorada. ------------------------------------------------------------------------ |42.4 GRANT (Privilgios de Tabela, Exibio ou Pseudnimo) - Erro da Documentao |A seo Notas para a instruo GRANT (Privilgios de Tabela, Exibio ou |Pseudnimo) contm um item destorcido. A nota atual a seguinte: | * |Os privilgios DELETE, INSERT, SELECT e UPDATE no foram definidos para |pseudnimos, j que as operaes em pseudnimos dependem de privilgios do ID |de autorizao utilizado na origem de dados quando a instruo que faz |referncia ao pseudnimo processada. | |Esse texto deve ser ignorado. O texto restante da seo est |preciso sem ele. ------------------------------------------------------------------------ 42.5 Informaes do MQSeries 42.5.1 Funes Escalares |42.5.1.1 MQPUBLISH | | | |>>-MQPUBLISH--(-------------------------------------------------> | |>--+---------------------------------------------+--msg-data----> | '-publisher-service--,--+-------------------+-' | '-service-policy--,-' | |>--+---------------------------------+--)---------------------->< | '-,--topic--+-------------------+-' | | (1) | | '-,--correl-id------' | | |Notas: 1. |O correl-id no pode ser especificado a menos que um |service e um policy sejam definidos anteriormente. | |O esquema DB2MQ. |A funo MQPUBLISH publica dados para o MQSeries. Essa funo requer |a instalao do MQSeries Publish/Subscribe ou do MQSeries Integrator. |Consulte www.ibm.com/software/MQSeries para obter |detalhes adicionais. |A funo MQPUBLISH publica os dados contidos em msg-data para o |MQSeries publisher especificado em publisher-service e utilizando a |qualidade de poltica de servio definida pelo service-policy. |Pode ser especificado um tpico opcional para a mensagem e tambm pode ser |especificado o identificador de correlao de mensagem definido pelo |usu rio. A funo retorna um valor '1' se bem-sucedida ou um |valor '0' se malsucedida. | |publisher-service |Uma cadeia que contm o destino lgico do MQSeries, onde a mensagem deve |ser enviada. Se especificado, o publisher-service deve se |referir a um publisher Service Point definido no arquivo de repositrio |AMT.XML. Um ponto de servio um n de extremidade lgico a |partir do qual uma mensagem enviada ou recebida. As definies do |ponto de servio incluem o nome do MQSeries Queue Manager e da Fila. |Consulte o MQSeries Application Messaging Interface para obter detalhes |adicionais. Se o publisher-service no for especificado, o |DB2.DEFAULT.PUBLISHER no ser utilizado. O tamanho |m ximo de publisher-service de 48 bytes. |service-policy |Uma cadeia que contm o MQSeries AMI Service Policy a ser utilizado no |tratamento dessa mensagem. Se especificado, o service-policy |deve se referir a um Policy definido no arquivo de repositrio |AMT.XML. Um Service Policy define um conjunto de qualidade de |opes de servio que deve ser aplicado a essa operao de mensagem. |Essas opes incluem a prioridade e a persistncia da mensagem. |Consulte a publicao MQSeries Application Messaging Interface para obter |detalhes adicionais. Se service-policy no for especificado, o |DB2.DEFAULT.POLICY padro ser utilizado. O tamanho |m ximo de service-policy de 48 bytes. |msg-data |Uma expresso de cadeia que contm os dados a serem enviados atravs do |MQSeries. O tamanho m ximo se a cadeia do tipo VARCHAR for de 4000 |bytes. Se a cadeia for um CLOB, ela poder ter at 1MB de |tamanho. |topic |Uma expresso de cadeia que contm o tpico para a publicao da |mensagem. Se nenhum tpico for especificado, ningum ser associado |mensagem. O tamanho m ximo de topic de 40 bytes. |V rios tpicos podem ser especificados em uma cadeia (at 40 |caracteres). Cada tpico deve ser separado por uma dois pontos. |Por exemplo, "t1:t2:o terceiro tpico" indica que a mensagem est |associada a todos os trs tpicos: t1, t2 e "o terceiro tpico". |correl-id |Uma expresso de cadeia opcional que contm um identificador de correlao |a ser associado a esta mensagem. O correl-id freqentemente |especificado em cen rios do pedido e da resposta para associar os pedidos s |respostas. Se nenhum for especificado, nenhum ID de correlao ser |includo na mensagem. O tamanho m ximo de correl-id de 24 |bytes. | |Exemplos |Exemplo 1: Este exemplo publica a cadeia "Testando 123" para o |publisher service padro (DB2.DEFAULT.PUBLISHER) que utiliza a |poltica padro (DB2.DEFAULT.POLICY). Nenhum |identificador de correlao ou tpico est especificado para a |mensagem. |VALUES MQPUBLISH('Testando 123') |Exemplo 2: Este exemplo publica a cadeia "Testando 345" para o |publisher service "MYPUBLISHER" no tpico "TESTS". A poltica padro |utilizada e nenhum identificador de correlao especificado. |VALUES MQPUBLISH('MYPUBLISHER','Testando 345', 'TESTS') |Exemplo 3: Este exemplo publica a cadeia "Testando 678" para o |publisher service "MYPUBLISHER" que utiliza a poltica "MYPOLICY" com um |identificador de correlao "TEST1". A mensagem publicada com o |tpico "TESTS". |VALUES MQPUBLISH('MYPUBLISHER','MYPOLICY','Testando 678','TESTS','TEST1') |Exemplo 4: Este exemplo publica a cadeia "Testando 901" para o |publisher service "MYPUBLISHER" no tpico "TESTS" que utiliza a poltica |padro (DB2.DEFAULT.POLICY) e nenhum identificador de |correlao. |VALUES MQPUBLISH('Testando 901','TESTS') |Todos os exemplos retornam o valor '1' se |bem-sucedidos. |42.5.1.2 MQREADCLOB | | | |>>-MQREADCLOB--(--+----------------------------------------+----> | '-receive-service--+-------------------+-' | '-,--service-policy-' | |>--)----------------------------------------------------------->< | | |O esquema DB2MQ. |A funo MQREADCLOB retorna uma mensagem da localizao do MQSeries |especificada pelo receive-service, utilizando a qualidade de poltica |de servio definida em service-policy. Executar esta operao |no remove a mensagem da fila associada ao receive-service, mas em |vez disso retorna a mensagem na cabea da fila. O valor de retorno um |CLOB com comprimento m ximo de 1MB contendo a mensagem. Se nenhuma |mensagem estiver disponvel para ser executada, um NULL ser retornado. | |receive-service |Uma cadeia que contm o destino lgico do MQSeries de onde a mensagem deve |ser recebida. Se especificado, o receive-service deve se |referir a um Service Point definido no arquivo de repositrio |AMT.XML. Um ponto de servio um n de extremidade lgico de |onde uma mensagem enviada ou recebida. As definies de pontos de |servios incluem o nome do MQSeries Queue Manager e da Fila. Consulte o |MQSeries Application Messaging Interface para obter detalhes |adicionais. Se receive-service no for especificado, o |DB2.DEFAULT.SERVICE ser utilizado. O tamanho m ximo de |receive-service de 48 bytes. |service-policy |Uma cadeia que contm o MQSeries AMI Service Policy utilizado no |tratamento dessa mensagem. Se especificado, o service-policy |deve se referir a um Policy definido no arquivo de repositrio |AMT.XML. Um Service Policy define um conjunto de qualidade de |opes de servio que deve ser aplicado a essa operao de mensagem. |Essas opes incluem a prioridade e a persistncia da mensagem. |Consulte a publicao MQSeries Application Messaging Interface para obter |detalhes adicionais. Se service-policy no for especificado, o |DB2.DEFAULT.POLICY padro ser utilizado. O tamanho |m ximo de service-policy de 48 bytes. | |Exemplos: |Exemplo 1: Este exemplo l a mensagem na cabea da fila especificada |pelo servio padro (DB2.DEFAULT.SERVICE), utilizando a poltica |padro (DB2.DEFAULT.POLICY). |VALUES MQREADCLOB() |Exemplo 2: Este exemplo l a mensagem na cabea da fila especificada |pelo servio "MYSERVICE" utilizando a poltica padro |(DB2.DEFAULT.POLICY). |VALUES MQREADCLOB('MYSERVICE') |Exemplo 3: Este exemplo l a mensagem na cabea da fila especificada |pelo servio "MYSERVICE" e utilizando a poltica "MYPOLICY". |VALUES MQREADCLOB('MYSERVICE','MYPOLICY') |Todos esses exemplos retornam o contedo da mensagem como um CLOB com um |tamanho m ximo de 1MB, se bem-sucedido. Se nenhuma mensagem estiver |disponvel, um NULL ser retornado. |42.5.1.3 MQRECEIVECLOB | | | |>>-MQRECEIVECLOB------------------------------------------------> | |>--(--+----------------------------------------------------------+--)->< | '-receive-service--+-------------------------------------+-' | '-,--service-policy--+--------------+-' | '-,--correl-id-' | | |O esquema DB2MQ. |A funo MQRECEIVECLOB retorna uma mensagem da localizao do MQSeries |especificada por receive-service, utilizando a qualidade de poltica |de servio service-policy. Executar essa operao remove a |mensagem da fila associada ao receive-service. Se o |correl-id for especificado, a primeira mensagem com um identificador |de correlao correspondente ser retornada. Se correl-id no |for especificado, a mensagem na cabea da fila ser retornada. O valor |de retorno um CLOB com comprimento m ximo de 1MB contendo a mensagem. |Se nenhuma mensagem estiver disponvel para ser executada, um NULL ser |retornado. | |receive-service |Uma cadeia que contm o destino lgico do MQSeries do qual a mensagem deve |ser recebida. Se especificado, o receive-service deve se |referir a um Service Point definido no arquivo de repositrio |AMT.XML. Um ponto de servio um n de extremidade lgico a |partir do qual uma mensagem enviada ou recebida. As definies de |pontos de servios incluem o nome do MQSeries Queue Manager e da Fila. |Consulte o MQSeries Application Messaging Interface para obter detalhes |adicionais. Se receive-service no for especificado, o |DB2.DEFAULT.SERVICE ser utilizado. O tamanho m ximo de |receive-service de 48 bytes. |service-policy |Uma cadeia que contm o MQSeries AMI Service Policy a ser utilizado no |tratamento dessa mensagem. Se especificado, o service-policy |dever se referir a um Policy definido no arquivo de repositrio |AMT.XML |1 |. Se service-policy no for |especificado, o DB2.DEFAULT.POLICY padro ser utilizado. |O tamanho m ximo de service-policy de 48 bytes. |correl-id |Uma cadeia que contm um identificador de correlao opcional a ser |associado a esta mensagem. O correl-id freqentemente |especificado em cen rios do pedido e da resposta para associar os pedidos s |respostas. Se no for especificado, nenhum ID de correlao ser |utilizado. O tamanho m ximo de correl-id de 24 bytes. | |Exemplos: |Exemplo 1: Este exemplo recebe a mensagem na cabea da fila |especificada pelo servio padro (DB2.DEFAULT.SERVICE), |utilizando a poltica padro (DB2.DEFAULT.POLICY). |VALUES MQRECEIVECLOB() |Exemplo 2: Este exemplo recebe a mensagem na cabea da fila |especificada pelo servio "MYSERVICE" utilizando a poltica padro |(DB2.DEFAULT.POLICY). |VALUES MQRECEIVECLOB('MYSERVICE') |Exemplo 3: Este exemplo recebe a mensagem na cabea da fila |especificada pelo servio "MYSERVICE" e utilizando a poltica |"MYPOLICY". |VALUES MQRECEIVECLOB('MYSERVICE','MYPOLICY') |Exemplo 4: Este exemplo recebe a primeira mensagem com um ID de |correlao que corresponde '1234' da cabea da fila especificada |pelo servio "MYSERVICE" utilizando a poltica "MYPOLICY". |VALUES MQRECEIVECLOB('MYSERVICE',MYPOLICY','1234') |Todos esses exemplos retornam o contedo da mensagem como um CLOB com um |tamanho m ximo de 1MB, se bem-sucedido. Se nenhuma mensagem estiver |disponvel, um NULL ser retornado. |42.5.1.4 MQSEND | | | |>>-MQSEND--(--+----------------------------------------+--------> | '-send-service--,--+-------------------+-' | '-service-policy--,-' | |>--msg-data--+-------------------+--)-------------------------->< | | (1) | | '-,--correl-id------' | | |Notas: 1. |O correl-id no pode ser especificado a menos que um |service e um policy sejam definidos anteriormente. | |O esquema DB2MQ. |A funo MQSEND envia os dados contidos em msg-data para a |localizao do MQSeries especificada em send-service e utilizando a |qualidade de poltica de servio definida pelo service-policy. |Um identificador de correlao de mensagem definido pelo usu rio opcional pode |ser especificado pelo correl-id. A funo retorna um valor |'1' se bem-sucedida ou um valor '0' se malsucedida. | |msg-data |Uma expresso de cadeia que contm os dados a serem enviados atravs do |MQSeries. O tamanho m ximo ser de 4000 bytes se os dados forem do tipo |VARCHAR e de 1MB se os dados forem do tipo CLOB. |send-service |Uma cadeia que contm o destino lgico do MQSeries, onde a mensagem deve |ser enviada. Se especificado, o send-service refere-se a um |ponto de servio definido no arquivo de repositrio AMT.XML. Um |ponto de servio um n de extremidade lgico a partir do qual uma mensagem |enviada ou recebida. As definies do ponto de servio incluem o nome |do MQSeries Queue Manager e da Fila. Consulte a publicao MQSeries |Application Messaging Interface para obter detalhes adicionais. Se |send-service no for especificado, o valor |DB2.DEFAULT.SERVICE ser utilizado. O tamanho m ximo de |send-service de 48 bytes. |service-policy |Uma cadeia que contm o MQSeries AMI Service Policy utilizado no |tratamento dessa mensagem. Se especificado, o service-policy |deve se referir a uma poltica de servio definida no arquivo de repositrio |AMT XML. Um Service Policy define um conjunto de qualidade de opes de |servio que deve ser aplicado a essa operao de mensagem. Essas opes |incluem a prioridade e a persistncia da mensagem. Consulte a |publicao MQSeries Application Messaging Interface para obter detalhes |adicionais. Se service-policy no for especificado, um valor |padro de DB2.DEFAULT.POLICY ser utilizado. O tamanho |m ximo de service-policy de 48 bytes. |correl-id |Uma cadeia opcional que contm um identificador de correlao associado a |esta mensagem. O correl-id freqentemente especificado em |cen rios do pedido e da resposta para associar os pedidos s respostas. |Se no for especificado, nenhum ID de correlao ser especificado. O |tamanho m ximo de correl-id de 24 bytes. | |Exemplos: |Exemplo 1: Este exemplo envia a cadeia "Testando 123" para o servio |padro (DB2.DEFAULT.SERVICE), utilizando a poltica padro |(DB2.DEFAULT.POLICY), sem nenhum identificador de |correlao. |VALUES MQSEND('Testando 123') |Exemplo 2: Este exemplo envia a cadeia "Testando 345" para o servio |"MYSERVICE", utilizando a poltica "MYPOLICY", sem nenhum identificador de |correlao. |VALUES MQSEND('MYSERVICE','MYPOLICY','Testando 345') |Exemplo 3: Este exemplo envia a cadeia "Testando 678" para o servio |"MYSERVICE", utilizando a poltica "MYPOLICY", com o identificador de |correlao "TEST3". |VALUES MQSEND('MYSERVICE','MYPOLICY','Testando 678','TEST3') |Exemplo 4: Este exemplo envia a cadeia "Testando 901" para o servio |"MYSERVICE" utilizando a poltica padro (DB2.DEFAULT.POLICY) e |nenhum identificador de correlao. |VALUES MQSEND('MYSERVICE','Testando 901') |Todos os exemplos retornam um valor escalar '1' se |bem-sucedidos. 42.5.2 Funes da Tabela |42.5.2.1 MQREADALLCLOB | | | |>>-MQREADALLCLOB--(---------------------------------------------> | |>--+----------------------------------------+--+----------+-----> | '-receive-service--+-------------------+-' '-num-rows-' | '-,--service-policy-' | |>--)----------------------------------------------------------->< | | |O esquema DB2MQ. |A funo MQREADALLCLOB retorna uma tabela contendo as mensagens e os |metadados de mensagens da localizao do MQSeries especificada por |receive-service, utilizando a qualidade da poltica de servio |service-policy. Executar esta operao no remove as mensagens |da fila associadas ao receive-service. |Se num-rows for especificado, um m ximo de num-rows |mensagens ser retornado. Se num-rows no for especificado, |todas as mensagens disponveis sero retornadas. A tabela retornada |contm as seguintes colunas: | * |MSG - uma coluna CLOB que contm o contedo da mensagem do |MQSeries. * |CORRELID - uma coluna VARCHAR(24) que mantm um ID de correlao utilizado |para relacionar mensagens. * |TOPIC - uma coluna VARCHAR(40) que mantm o tpico com que a mensagem foi |publicada, se disponvel. * |QNAME - uma coluna VARCHAR(48) que mantm o nome da fila onde a mensagem |foi recebida. * |MSGID - uma coluna CHAR(24) que mantm o identificador exclusivo do |MQSeries para esta mensagem. * |MSGFORMAT - uma coluna VARCHAR(8) que mantm o formato da mensagem, |conforme definido pelo MQSeries. As cadeias tpicas tm um formato |MQSTR. | | |receive-service |Uma cadeia que contm o destino lgico do MQSeries a partir do qual a |mensagem lida. Se especificada, o receive-service dever se |referir a um ponto de servio definido no arquivo de repositrio |AMT.XML. Um ponto de servio um n de extremidade lgico a |partir do qual uma mensagem enviada ou recebida. As definies do |ponto de servio incluem o nome do MQSeries Queue Manager e da Fila. |Consulte o MQSeries Application Messaging Interface para obter detalhes |adicionais. Se receive-service no for especificado, o |DB2.DEFAULT.SERVICE ser utilizado. O tamanho m ximo de |receive-service de 48 bytes. |service-policy |Uma cadeia que contm o MQSeries AMI Service Policy utilizado no |tratamento dessa mensagem. Se especificado, o service-policy |refere-se a um Policy definido no arquivo de repositrio AMT XML. Um |service policy define um conjunto de qualidade de opes de servio que deve |ser aplicado a essa operao de mensagem. Essas opes incluem a |prioridade e a persistncia da mensagem. Consulte a publicao MQSeries |Application Messaging Interface para obter detalhes adicionais. Se |service-policy no for especificado, o |DB2.DEFAULT.POLICY padro ser utilizado. O tamanho |m ximo de service-policy de 48 bytes. |num-rows |Um inteiro positivo que contm o nmero m ximo de mensagens a ser |retornado pela funo. | |Exemplos: |Exemplo 1: Este exemplo recebe todas as mensagens da fila |especificadas pelo servio padro (DB2.DEFAULT.SERVICE), |utilizando a poltica padro (DB2.DEFAULT.POLICY). As |mensagens e todos os metadados so retornados como uma tabela. |SELECT * | Tabela FROM (MQREADALLCLOB()) T |Exemplo 2: Este exemplo recebe todas as mensagens da cabea da fila |especificada pelo servio MYSERVICE, utilizando a poltica padro |(DB2.DEFAULT.POLICY). Apenas as colunas MSG e CORRELID |so retornadas. |SELECT T.MSG, T.CORRELID | Tabela FROM (MQREADALLCLOB('MYSERVICE')) T |Exemplo 3: Este exemplo l a cabea da fila especificada pelo servio |padro (DB2.DEFAULT.SERVICE), utilizando a poltica padro |(DB2.DEFAULT.POLICY). Apenas as mensagens com um CORRELID |de '1234' so retornadas. Todas as colunas so |retornadas. |SELECT * | Tabela FROM (MQREADALLCLOB()) T | WHERE T.CORRELID = '1234' |Exemplo 4: Este exemplo recebe as 10 primeiras mensagens da cabea da |fila especificada pelo servio padro (DB2.DEFAULT.SERVICE), |utilizando a poltica padro (DB2.DEFAULT.POLICY). Todas |as colunas so retornadas. |SELECT * | Tabela FROM (MQREADALLCLOB(10)) T |42.5.2.2 MQRECEIVEALLCLOB | | | |>>-MQRECEIVEALLCLOB--(------------------------------------------> | |>--+----------------------------------------------------------+--> | '-receive-service--+-------------------------------------+-' | '-,--service-policy--+--------------+-' | '-,--correl-id-' | |>--+-----------------+--)-------------------------------------->< | '-+---+--num-rows-' | '-,-' | | |O esquema DB2MQ. |A funo MQRECEIVEALLCLOB retorna uma tabela contendo as mensagens e os |metadados de mensagens da localizao do MQSeries especificada por |receive-service, utilizando a qualidade da poltica de servio |service-policy. Executar esta operao remove as mensagens da |fila associadas ao receive-service. |Se um correl-id for especificado, apenas estas mensagens com um |identificador de correlao correspondente sero retornadas. Se |correl-id no for especificado, a mensagem na cabea da fila ser |retornada. |Se num-rows for especificado, um m ximo de num-rows |mensagens ser retornado. Se num-rows no for especificado, |todas as mensagens disponveis sero retornadas. A tabela retornada |contm as seguintes colunas: | * |MSG - uma coluna CLOB que contm o contedo da mensagem do |MQSeries. * |CORRELID - uma coluna VARCHAR(24) que mantm um ID de correlao utilizado |para relacionar mensagens. * |TOPIC - uma coluna VARCHAR(40) que mantm o tpico com que a mensagem foi |publicada, se disponvel. * |QNAME - uma coluna VARCHAR(48) que mantm o nome da fila onde a mensagem |foi recebida. * |MSGID - uma coluna CHAR(24) que mantm o identificador exclusivo do |MQSeries para esta mensagem. * |MSGFORMAT - uma coluna VARCHAR(8) que mantm o formato da mensagem, |conforme definido pelo MQSeries. As cadeias tpicas tm um formato |MQSTR. | | |receive-service |Uma cadeia que contm o destino lgico do MQSeries do qual a mensagem deve |ser recebida. Se especificada, o receive-service dever se |referir a um ponto de servio definido no arquivo de repositrio |AMT.XML. Um ponto de servio um n de extremidade lgico a |partir do qual uma mensagem enviada ou recebida. As definies do |ponto de servio incluem o nome do MQSeries Queue Manager e da Fila. |Consulte a publicao MQSeries Application Messaging Interface para obter |detalhes adicionais. Se receive-service no for especificado, |o DB2.DEFAULT.SERVICE ser utilizado. O tamanho m ximo de |receive-service de 48 bytes. |service-policy |Uma cadeia que contm o MQSeries AMI Service Policy utilizado no |tratamento dessa mensagem. Se especificado, o service-policy |refere-se a um Policy definido no arquivo de repositrio AMT XML. Um |service policy define um conjunto de qualidade de opes de servio que deve |ser aplicado a essa operao de mensagem. Essas opes incluem a |prioridade e a persistncia da mensagem. Consulte a publicao MQSeries |Application Messaging Interface para obter detalhes adicionais. Se |service-policy no for especificado, o |DB2.DEFAULT.POLICY padro ser utilizado. O tamanho |m ximo de service-policy de 48 bytes. |correl-id |Uma cadeia opcional que contm um identificador de correlao associado a |esta mensagem. O correl-id freqentemente especificado em |cen rios do pedido e da resposta para associar os pedidos s respostas. |Se no for especificado, nenhum ID de correlao ser especificado. O |tamanho m ximo de correl-id de 24 bytes. |num-rows |Um inteiro positivo que contm o nmero m ximo de mensagens a ser |retornado pela funo. | |Exemplos: |Exemplo 1: Este exemplo recebe todas as mensagens da fila |especificadas pelo servio padro (DB2.DEFAULT.SERVICE), |utilizando a poltica padro (DB2.DEFAULT.POLICY). As |mensagens e todos os metadados so retornados como uma tabela. |SELECT * | Tabela FROM (MQRECEIVEALLCLOB()) T |Exemplo 2: Este exemplo recebe todas as mensagens da cabea da fila |especificada pelo servio MYSERVICE, utilizando a poltica padro |(DB2.DEFAULT.POLICY). Apenas as colunas MSG e CORRELID |so retornadas. |SELECT T.MSG, T.CORRELID | Tabela FROM (MQRECEIVEALLCLOB('MYSERVICE')) T |Exemplo 3: Este exemplo recebe todas as mensagens na cabea da fila |especificada pelo servio "MYSERVICE", utilizando a poltica |"MYPOLICY". Apenas as mensagens com um CORRELID de '1234' so |retornadas. Apenas as colunas MSG e CORRELID so retornadas. |SELECT T.MSG, T.CORRELID | Tabela FROM (MQRECEIVEALLCLOB('MYSERVICE','MYPOLICY','1234')) T | |Exemplo 4: Este exemplo recebe as 10 primeiras mensagens da cabea da |fila especificada pelo servio padro (DB2.DEFAULT.SERVICE), |utilizando a poltica padro (DB2.DEFAULT.POLICY). Todas |as colunas so retornadas. |SELECT * | Tabela FROM (MQRECEIVEALLCLOB(10)) T | | |42.5.3 Dados CLOB Agora So Suportados nas Funes do MQSeries |As funes do MQSeries (as definidas no esquema DB2MQ) incluem agora a |funcionalidade que permite que elas sejam utilizadas com dados CLOB alm dos |dados VARCHAR. Em alguns casos, existe uma nova funo para tratar do |tipo de dados CLOB, em outros, a funo j existente trata dos dados CLOB e |dados VARCHAR. Independente do caso, a sintaxe da funo CLOB |idntica de sua VARCHAR equivalente. As funes que suportam a |utilizao de dados CLOB e de suas funes VARCHAR equivalentes so listadas |na seguinte tabela: | |Tabela 17. Funes do MQSeries que suportam o tipo de dados CLOB Funo a ser utilizada para dados Funo a ser utilizada para dados VARCHAR CLOB MQPUBLISH MQPUBLISH MQREAD MQREADCLOB MQRECEIVE MQRECEIVECLOB MQSEND MQSEND MQREADALL MQREADALLCLOB MQRECEIVEALL MQRECEIVEALLCLOB |Para obter informaes sobre como ativar as funes do MQSeries |(aquelas definidas no esquema DB2MQ), consulte a seo MQSeries. ------------------------------------------------------------------------ 42.6 Informaes de Tipos de Dados 42.6.1 Promoo de Tipos de Dados Nesta seo a tabela 5 mostra a lista de precedncia para cada tipo de dados. Observe que: 1. Para um banco de dados Unicode, os seguintes tipos de dados so considerados equivalentes: o CHAR e GRAPHIC o VARCHAR e VARGRAPHIC o LONG VARCHAR e LONG VARGRAPHIC o CLOB e DBCLOB 2. Em um banco de dados Unicode, possvel criar funes nas quais a nica diferena na assinatura da funo est entre os tipos de dados CHAR e GRAPHIC equivalente, por exemplo foo(CHAR(8)) e foo(GRAPHIC(8)). Recomendamos que voc no defina tais funes duplicadas, porque a migrao para um release futuro precisar que uma delas seja eliminada antes que a migrao continue. Se essas funes duplicadas existirem, a opo de qual ser chamada determinada por um algoritmo de duas passagens. A primeira passagem tenta localizar uma correspondncia utilizando o mesmo algoritmo que utilizado para resolver funes em um banco de dados no-Unicode. Se nenhuma correspondncia for encontrada, ento uma segunda passagem ser feita levando-se em conta a seguinte precedncia de promoo para as cadeias CHAR e GRAPHIC: GRAPHIC-->CHAR-->VARGRAPHIC-->VARCHAR-->LONG VARGRAPHIC-->LONG VARCHAR--> -->DBCLOB-->CLOB 42.6.2 Converso Entre Tipos de Dados A seguinte entrada foi includa na lista introduzida como: "As seguintes converses que envolvem tipos distintos so suportadas": * Para um banco de dados Unicode, converta de VARCHAR ou VARGRAPHIC em um tipo DT distinto com um tipo de dados de origem CHAR ou GRAPHIC. A seguir, atualizaes para a "Tabela 6. Converses Suportadas Entre Tipos de Dados Internos". Somente as linhas afetadas da tabela so includas. Tabela 18. Converses suportadas entre Tipos de Dados Internos L O Tipo de Dados de N L G O V V Destino > N A A G R R V V G G G A A R R R D R R A A A B C C C C P P P C H H H L H H H L Tipo de Dados Fonte A A A O I I I O V R R R B C C C B CHAR S S S S S1 S1 - - VARCHAR S S S S S1 S1 - - LONGVARCHAR S S S S - - S1 S1 CLOB S S S S - - - S1 GRAPHIC S1 S1 - - S S S S VARGRAPHIC S1 S1 - - S S S S LONGVARGRAPHIC - - S1 S1 S S S S DBCLOB - - - S1 S S S S 1 A converso suportada somente para bancos de dados Unicode. 42.6.3 Atribuies e Comparaes Atribuies e comparaes que envolvem dados de caractere e dados gr ficos so somente suportadas quando uma das cadeias um literal. Para a resoluo da funo, os literais gr ficos e de caractere correspondero aos parmetros da funo de caractere e gr fica. A seguir, atualizaes para a "Tabela 7. Compatibilidade de Tipos de Dados para Atribuies e Comparaes". Somente as linhas afetadas da tabela e a nova nota de rodap 6 foram includas: Regis- Inteiro Nmero Ponto Cadeia de Cadeia tro deCadeia Operandos Bin rio Decimal Flutuante Caracteres Gr fica Data Hora Tempo Bin ria UDT Cadeia de No No No Sim Sim 6 1 1 1 No 3 2 Caracteres Cadeia No No No Sim 6 Sim No No No No 2 Gr fica 6 Somente suportada para bancos de dados Unicode. 42.6.3.1 Atribuies de Cadeia Atribuio de Armazenamento O ltimo par grafo desta subseo foi modificado desta forma: Quando uma cadeia atribuda a uma coluna de comprimento fixo e o comprimento da cadeia menor que o atributo de comprimento do destino, a cadeia preenchida direita com o nmero necess rio de espaos brancos de byte simples, byte duplo ou UCS-22. O caractere de enchimento sempre um espao branco para as colunas definidas com o atributo FOR BIT DATA. Atribuio de Recuperao O terceiro par grafo desta subseo foi modificado desta forma: Quando uma cadeia de caracteres atribuda a uma vari vel de comprimento fixo e o comprimento da cadeia menor que o atributo de comprimento do destino, a cadeia preenchida direita com o nmero necess rio de espaos brancos de byte simples, byte duplo ou UCS-22. O caractere de enchimento sempre um espao branco mesmo para as cadeias definidas com o atributo FOR BIT DATA. 2 O UCS-2 define v rios caracteres SPACE com propriedades diferentes. Para um banco de dados Unicode, o gerenciador de banco de dados sempre usa ASCII SPACE na posio x'0020' como espao branco UCS-2. Para um banco de dados EUC, IDEOGRAPHIC SPACE na posio x'3000' utilizado para preencher as cadeias GRAPHIC. Regras de Converso para Atribuies de Cadeia O seguinte par grafo foi includo no final desta subseo: Para bancos de dados Unicode, cadeias de caracteres podem ser atribudas a uma coluna gr fica e cadeias gr ficas podem ser atribudas a uma coluna de caracteres. Consideraes DBCS para Atribuies de Cadeia Gr fica O primeiro par grafo desta subseo foi modificado desta forma: As atribuies de cadeia gr fica so processadas de maneira an loga quela feita para cadeias de caracteres. Para bancos de dados no-Unicode, os tipos de dados da cadeia gr fica so compatveis somente com outros tipos de dados da cadeia gr fica e nunca com tipos de dados numricos, da cadeia de caracteres ou de data/hora. Para bancos de dados Unicode, os tipos de dados da cadeia gr fica so compatveis com os tipos de dados da cadeia de caracteres. 42.6.3.2 Comparaes de Cadeias Regras de Converso para Comparao Esta subseo foi modificada desta forma: Quando duas cadeias so comparadas, uma delas convertida primeiro, se necess rio, para o esquema de codificao e p gina de cdigos da outra cadeia. Para obter detalhes, consulte a seo "Regras para Converses de Cadeias" do "Captulo 3. Elementos de Linguagem" na seo SQL Reference. 42.6.4 Regras para Tipos de Dados de Resultado 42.6.4.1 Cadeias de Caracteres e Gr ficas em um Banco de Dados Unicode Esta uma nova subseo inserida aps a subseo "Cadeias Gr ficas". Em um banco de dados Unicode, as cadeias de caracteres e as cadeias gr ficas so compatveis. Se um operando for... E o outro operando O tipo de dados do for... resultado ser ... GRAPHIC(x) CHAR(y) ou GRAPHIC(y) GRAPHIC(z) em que z = max(x,y) VARGRAPHIC(x) CHAR(y) ou VARCHAR(y) VARGRAPHIC(z) em que z = max(x,y) VARCHAR(x) GRAPHIC(y) ou VARGRAPHIC(z) em que z = VARGRAPHIC max(x,y) LONG VARGRAPHIC CHAR(y) ou VARCHAR(y) LONG VARGRAPHIC ou LONG VARCHAR LONG VARCHAR GRAPHIC(y) ou LONG VARGRAPHIC VARGRAPHIC(y) DBCLOB(x) CHAR(y) ou VARCHAR(y) DBCLOB(z) em que z = ou CLOB(y) max(x,y) DBCLOB(x) LONG VARCHAR DBCLOB(z) em que z = max(x,16350) CLOB(x) GRAPHIC(y) ou DBCLOB(z) em que z = VARGRAPHIC(y) max(x,y) CLOB(x) LONG VARGRAPHIC DBCLOB(z) em que z = max(x,16350) 42.6.5 Regras para Converses de Cadeias O terceiro ponto foi includo na seguinte lista dessa seo: Para cada par de p ginas de cdigo, o resultado determinado pelo aplicativo seqencial das seguintes regras: * Se as p ginas de cdigo forem iguais, o resultado ser aquela p gina de cdigos. * Se ambas as p ginas de cdigo forem BIT DATA (p gina de cdigos 0), a p gina de cdigos de resultado ser BIT DATA. * Em um banco de dados Unicode, se uma p gina de cdigos denotar dados em um esquema de codificao diferente da outra p gina de cdigos, o resultado ser UCS-2 sobre UTF-8 (ou seja, o tipo de dados gr ficos sobre o tipo de dados de caracteres).1 * Caso contr rio, a p gina de cdigos de resultado ser determinada pela Tabela 8 da seo "Regras para Converses de Cadeias" do "Captulo 3. Elementos de Linguagem" na seo SQL Reference. Uma entrada "primeiro" na tabela significa que a p gina de cdigos do primeiro operando est selecionada e uma entrada "segundo" significa que a p gina de cdigos do segundo operando est selecionada. 1 Em um banco de dados no-Unicode, a converso entre esquemas de codificao diferentes no suportada. 42.6.6 Expresses O seguinte foi includo: Em um banco de dados Unicode, uma expresso que aceita uma cadeia de caracteres ou gr fica aceitar todos os tipos de cadeia na quais a converso suportada. 42.6.6.1 Com o Operador de Concatenao O seguinte foi includo no final desta subseo: Em um banco de dados Unicode, a concatenao que envolve operandos da cadeia de caracteres e da cadeia gr fica convertero primeiro os operandos de caractere para operandos gr ficos. Observe que em um banco de dados Unicode, a concatenao no envolve operandos de caractere e gr ficos. 42.6.7 Predicados A seguinte entrada foi includa na lista introduzida pela sentena: "As seguintes regras aplicam-se a todos os tipos de predicados": * Em um banco de dados Unicode, todos os predicados que aceitam uma cadeia de caracteres ou gr fica aceitaro todos os tipos de cadeia na quais a converso suportada. ------------------------------------------------------------------------ |42.7 Informaes de Unicode |42.7.1 Funes Escalares e Unicode | | |No banco de dados Unicode, todas as funes escalar que aceitam um |caractere ou uma cadeia gr fica ser aceito em qualquer tipo de cadeia para |que a converso seja suportada. ------------------------------------------------------------------------ |42.8 Tipo de GRAPHIC e Compatibilidade de DATE/TIME/TIMESTAMP |Nas sees a seguir, referncias a valores de data e hora com |representaes de "cadeia de caracteres" foram alteradas para representaes |de "cadeia". O DB2 agora suporta, apenas para bancos de dados Unicode, |representaes de "cadeia gr fica" de valores de data e hora. |42.8.1 Representaes de Cadeia de Valores de Data e Hora | |Valores cujos tipos de dados so DATE, TIME ou TIMESTAMP so representados |em um formato interno que transparente para o usu rio. Os valores de |data, hora e data e hora podem, no entanto, tambm ser representados por |cadeias. Isso til, porque no h constantes ou vari veis cujos tipos |de dados so DATE, TIME ou TIMESTAMP. Antes de poder ser recuperado, um |valor de data e hora deve ser atribudo a uma vari vel de cadeia. A |funo CHAR ou a funo GRAPHIC (apenas para bancos de dados Unicode) podem |ser utilizadas para alterar um determinado valor de uma representao de |cadeia. A representao da cedia geralmente o formato padro dos |valores de data e hora associados ao cdigo do pas/regio do banco de dados, |a no ser que substitudo por especificao da opo DATETIME quando o |programa pr-compilado ou ligado ao banco de dados. |No importando seu comprimento, uma cadeia de objeto grande, um valor LONG |VARCHAR ou um valor LONG VARGRAPHIC, no pode ser utilizada para representar |um valor de data e hora (SQLSTATE 42884). |Quando uma representao de cadeia v lida de um valor de data e hora for |utilizado em uma operao com um valor de data e hora interno, a representao |da cadeia convertida para o formato interno do valor da data, da hora ou da |data e hora antes da operao ser executada. |Cadeias de data, de hora e de data e hora devem conter apenas caracteres e |dgitos. |42.8.1.1 Cadeias de Data, Cadeias de Hora e Cadeias de Data e Hora |As definies desses termos foram levemente alteradas. As |referncias s representaes de "cadeia de caracteres" foram alteradas para |representaes de "cadeia". |42.8.2 Convertendo entre Tipos de Dados |DATE, TIME e TIMESTAMP agora podem ser convertidos para GRAPHIC e |VARGRAPHIC. GRAPHIC e VARGRAPHIC agora podem ser convertidos para DATE, |TIME e TIMESTAMP. O suporte cadeia gr fica est disponvel apenas |para bancos de dados Unicode. |42.8.3 Atribuies e Comparaes |Agora h compatibilidade de tipo de dados para atribuies e comparaes |entre cadeias gr ficas e valores DATE, TIME e TIMESTAMP. O suporte |cadeia gr fica est disponvel apenas para bancos de dados Unicode. |42.8.4 Atribuies de Data e Hora | |A regra b sica para atribuies de data e hora que um valor DATE, TIME ou |TIMESTAMP pode ser atribudo apenas a uma coluna com tipo de dados |correspondente (DATE, TIME ou TIMESTAMP) ou a uma vari vel de cadeia ou coluna |de cadeia com comprimento vari vel. A atribuio no deve ser a uma |vari vel ou coluna LONG VARCHAR, CLOB, LONG VARGRAPHIC, DBCLOB ou BLOB. | | |Quando um valor de data e hora atribudo a uma vari vel de cadeia ou a |uma coluna de cadeia, a converso para uma representao de cadeia |autom tica. Zeros esquerda no so omitidos de qualquer parte da |data, hora ou data e hora. O comprimento requerido do destino variar , |dependendo do formato da representao da cadeia. Se o comprimento do |destino for maior que o requerido e o destino for uma cadeia de comprimento |fixo, ele ser preenchido direita com espaos em branco. Se o |comprimento do destino for menor que o requerido, o resultado depender do |tipo de valor de data e hora envolvido e do tipo de destino. |Quando o destino uma vari vel do host, a seguinte regra se aplica: | * |DATE: Se o comprimento da vari vel for menor do que 10 |caracteres, ocorre um erro. * |TIME: Se o formato USA for utilizado, o comprimento da |vari vel no deve ter menos do que 8 caracteres; em outros formatos, o |comprimento no deve ter menos de 5 caracteres. |Se os formatos ISO ou JIS forem utilizados e se o comprimento da vari vel |do host tiver menos de 8 caracteres, a parte de segundos da hora ser omitida |do resultado e atribuda vari vel do indicador, se fornecida. O campo |SQLWARN1 de SQLCA definido para indicar a omisso. * |TIMESTAMP: Se a vari vel do host tiver menos do que 19 |caracteres, ocorre um erro. Se o comprimento tiver menos do que 26 |caracteres, mas for maior ou igual a 19 caracteres, os dgitos seguintes |parte de microssegundos do valor sero omitidos. O campo SQLWARN1 de |SQLCA definido para indicar a omisso. | |42.8.5 DATE | | | |>>-DATE--(--expresso--)--------------------------------------->< | | |O esquema SYSIBM. |A funo DATE retorna uma data de um valor. |O argumento deve ser uma data, uma data e hora, um nmero positivo menor ou |igual a 3.652.059, uma representao de cadeia v lida de uma |data ou data e hora, ou uma cadeia de comprimento 7 que no seja LONG VARCHAR, |CLOB, LONG VARGRAPHIC, DBCLOB ou BLOB. |Apenas bancos de dados Unicode suportam um argumento que seja uma |representao de cadeia gr fica de uma data ou uma data e hora. |Se o argumento for uma cadeia de comprimento 7, ele deve representar uma |data v lida no formato aaaannn, em que aaaa so dgitos que |denotam um ano e nnn so dgitos entre 001 e 366, denotando um dia do |ano. |O resultado da funo uma data. Se o argumento puder ser nulo, o |resultado poder ser nulo; se o argumento for nulo, o resultado ser o |valor nulo. |As outras regras dependem do tipo de dados do argumento: | * |Se o argumento for uma data, uma data e hora ou uma representao de |cadeia v lida de uma data ou data e hora: | o |O resultado ser a parte da data do valor. | * |Se o argumento for um nmero: | o |O resultado ser a data que n-1 dias depois de 1 de janeiro de |0001, em que n a parte integral do nmero. | * |Se o argumento for uma cadeia com comprimento igual a 7: | o |O resultado ser a data representada pela cadeia. | | |Exemplos: |Suponha que a coluna RECEIVED (data e hora) tenha um valor de intervalo |equivalente a |'1988-12-25-17.12.30.000000'. | * |Esse exemplo resulta em uma representao interna igual a |'1988-12-25'. | DATE(RECEIVED) * |Esse exemplo resulta em uma representao interna igual a |'1988-12-25'. | DATE('1988-12-25') * |Esse exemplo resulta em uma representao interna igual a |'1988-12-25'. | DATE('25.12.1988') * |Esse exemplo resulta em uma representao interna igual a |'0001-02-04'. | DATE(35) | |42.8.6 GRAPHIC | | | |>>-GRAPHIC--(--expresso gr fica--+-------------------+--)----->< | '-,--nmero inteiro-' | | |O esquema SYSIBM. |A funo GRAPHIC retorna uma representao GRAPHIC de um tipo de cadeia |gr fica ou uma representao GRAPHIC de um tipo de data e hora. | |expresso gr fica |Uma expresso que retorna um valor que uma cadeia |gr fica. |nmero inteiro |Um valor de nmero inteiro que especifica o atributo de comprimento do |tipo de dados GRAPHIC. O valor deve estar entre 1 e 127. Se o |nmero inteiro no for especificado, o comprimento do resultado ser |igual ao comprimento do primeiro argumento. | |O resultado da funo e um GRAPHIC. Se o argumento puder ser nulo, o |resultado poder ser nulo; se o argumento for nulo, o resultado ser o |valor nulo. |Data e Hora para Gr fico: |>>-GRAPHIC--(--expresso de data e hora--+--------------+--)--->< | '-,--+-ISO---+-' | +-USA---+ | +-EUR---+ | +-JIS---+ | '-LOCAL-' | | | |Data e Hora para Gr fico | |expresso de data e hora |Uma expresso que tem um dos trs tipos de dados a seguir | |data |O resultado a representao da cadeia gr fica da data no formato |especificado pelo segundo argumento. O comprimento do resultado igual |a 10. Ocorre um erro se o segundo argumento for especificado e no for |um valor v lido (SQLSTATE 42703). |hora |O resultado a representao da cadeia gr fica da hora no formato |especificado pelo segundo argumento. O comprimento do resultado |8. Ocorre um erro se o segundo argumento for especificado e no for um |valor v lido (SQLSTATE 42703). |marca de hora |O segundo argumento no se aplica e no deve ser especificado (SQLSTATE |42815). O resultado a representao da cadeia gr fica de data e |hora. O comprimento do resultado igual a 26. | |A p gina de cdigos a p gina de cdigos do banco de dados do servidor de |aplicativos. | | |42.8.7 TIME | | | | | | |>>-TIME--(--expresso--)--------------------------------------->< | | |O esquema SYSIBM. |A funo TIME retorna uma hora de um valor. |O argumento deve ser uma hora, uma data e hora ou uma representao de |cadeia v lida de uma hora ou data e hora que no seja LONG VARCHAR, CLOB, LONG |VARGRAPHIC, DBCLOB ou BLOB. |Apenas bancos de dados Unicode suportam um argumento que seja uma |representao de cadeia gr fica de uma hora ou de uma data e hora. |O resultado da funo uma hora. Se o argumento puder ser nulo, o |resultado poder ser nulo; se o argumento for nulo, o resultado ser o |valor nulo. |As outras regras dependem do tipo de dados do argumento: | * |Se o argumento for uma hora: | o |O resultado ser a hora. | * |Se o argumento for uma data e hora: | o |O resultado ser a parte da hora da data e hora. | * |Se o argumento for uma cadeia: | o |O resultado ser a hora representada pela cadeia. | | |Exemplo: | * |Selecione todas as notas da tabela de exemplo IN_TRAY que foram |recebidas pelo menos uma hora mais tarde no dia (qualquer dia) do que a hora |atual. | SELECT * FROM IN_TRAY | WHERE TIME(RECEIVED) >= CURRENT TIME + 1 HOUR | |42.8.8 TIMESTAMP | | | | | | |>>-TIMESTAMP--(--expresso--+------------+--)------------------>< | '-,expresso-' | | |O esquema SYSIBM. |A funo TIMESTAMP retorna uma data e hora de um valor ou de um par de |valores. |Apenas bancos de dados Unicode suportam um argumento que seja uma |representao de cadeia gr fica de uma data, de uma hora ou de uma data e |hora. |As regras dos argumentos depende de se o segundo argumento |especificado. | * |Se apenas um argumento for especificado: | o |Deve ser uma data e hora, uma representao de cadeia v lida de uma data e |hora ou uma cadeia de comprimento 14 que no seja LONG VARCHAR, CLOB, LONG |VARGRAPHIC, DBCLOB ou BLOB. |Uma cadeia de comprimento 14 deve ser uma cadeia de dgitos que representa |uma data e uma hora v lidas no formato aaaaxxddhhmmss, em que |aaaa o ano, xx o ms, dd o dia, hh |a hora, mm o minuto e ss o segundo. | * |Se os dois argumentos forem especificados: | o |O primeiro argumento deve ser uma data ou uma representao de cadeia |v lida de uma data e o segundo argumento deve ser una hora ou uma |representao de cadeia v lida de uma hora. | | |O resultado da funo uma data e hora. Se qualquer um dos dois |argumentos puder ser nulo, o resultado poder ser nulo; se qualquer um |dos dois argumentos for nulo, o resultado ser o valor nulo. |As outras regras dependem de se o segundo argumento especificado: | * |Se os dois argumentos forem especificados: | o |O resultado ser uma data e hora com a data especificada pelo primeiro |argumento e a hora especificada pelo segundo argumento. A parte de |microssegundos da data e hora igual a zero. | * |Se apenas um argumento for especificado e for uma data e hora: | o |O resultado ser a data e hora. | * |Se apenas um argumento for especificado e for uma cadeia: | o |O resultado ser a data e hora representada pela cadeia. Se o |argumento for uma cadeia de comprimento 14, a data e hora ter uma parte de |microssegundos igual a zero. | | |Exemplo: | * |Suponha que a coluna START_DATE (data) tenha um valor equivalente a |1988-12-25 e a coluna START_TIME (hora) tenha uma valor equivalente a |17.12.30. | TIMESTAMP(START_DATE, START_TIME) |Retorna o valor |'1988-12-25-17.12.30.000000'. | |42.8.9 VARGRAPHIC | | | | | | | | |Caractere para Vargraphic: |>>-VARGRAPHIC--(--expresso de cadeia de caracteres--)--------->< | | |Data e Hora para Vargraphic: |>>-VARGRAPHIC--(--expresso de data e hora--)------------------>< | | |Gr fico para Vargraphic: |>>-VARGRAPHIC--(--expresso de cadeia gr fica-------------------> | |>--+-------------------+--)------------------------------------>< | '-,--nmero inteiro-' | | |O esquema SYSIBM. |A funo VARGRAPHIC retorna uma representao de cadeia gr fica de |um: | * |valor de cadeia de caracteres, convertendo caracteres de byte simples para |caracteres de byte duplo, * |valor de data e hora (suportado apenas em bancos de dados Unicode) * |valor de cadeia gr fica, se o primeiro argumento for qualquer tipo de |cadeia gr fica. | |O resultado da funo uma cadeia gr fica de comprimento vari vel (tipo de |dados VARGRAPHIC). Se o primeiro argumento puder ser nulo, o resultado |poder ser nulo; se o primeiro argumento for nulo, o resultado ser o |valor nulo. |Caractere para Vargraphic | |expresso de cadeia de caracteres |Uma expresso cujo valor deve ser de um tipo de dados de cadeia de |caracteres diferente de LONG VARCHAR ou CLOB, e cujo comprimento m ximo no |deve ser maior que 16.336 bytes. | |O atributo de comprimento do resultado igual ao atributo do comprimento |do argumento. |Deixe S denotar o valor da expresso de cadeia de |caracteres. Cada caractere de byte simples de S convertido sua |representao de byte duplo equivalente ou ao caractere de substituio de |byte duplo no resultado; cada caractere de byte duplo de S mapeado |'como se encontra'. Se o byte simples de um caractere de byte |duplo aparecer como o ltimo byte de S, ele convertido para o caractere de |substituio de byte duplo. A ordem seqencial dos caracteres em S |preservada. |Seguem consideraes adicionais para a converso. | * |Para um banco de dados Unicode, essa funo converte a cadeia de |caracteres da p gina de cdigos do operando para UCS-2. Todos os |caracteres do operando, inclusive os caracteres DBCS, so convertidos. |Se o segundo argumento fornecido, ele especifica o comprimento desejado |(nmero de caracteres UCS-2) da cadeia UCS-2 resultante. * |A converso para pontos de cdigo de byte duplo pela funo VARGRAPHIC |baseada na p gina de cdigos do operando. * |Os caracteres de byte duplo do operando no so convertidos. Todos |os outros caracteres so convertidos para sua representao correspondente em |byte duplo. Se no houver uma representao de byte duplo |correspondente, o caractere de substituio de byte duplo para a p gina de |cdigos ser utilizado. * |Nenhum aviso ou cdigo de erro gerado se um ou mais caracteres de |substituio de byte duplo forem retornados no resultado. | |Data e Hora para Vargraphic | |expresso de data e hora |Uma expresso cujo valor deve ser do tipo de dados DATE, TIME ou |TIMESTAMP. | |Gr fico para Vargraphic | |expresso de cadeia gr fica |Uma expresso que retorna um valor que uma cadeia gr fica. |nmero inteiro |O atributo de comprimento para a cadeia gr fica de comprimento vari vel |resultante. O valor deve estar entre 0 e 16.336. Se esse |argumento no for especificado, o comprimento do resultado ser o mesmo que o |comprimento do argumento. | |Se o comprimento da expresso de cadeia gr fica for maior que o |atributo de comprimento do resultado, ocorrer uma truncagem e um aviso ser |retornado (SQLSTATE 01004), a no ser que os caracteres truncados estivessem |todos em branco e a expresso de cadeia gr fica no fosse uma cadeia |longa (LONG VARGRAPHIC ou DBCLOB). ------------------------------------------------------------------------ 42.9 Chaves de ndice maiores para bancos de dados Unicode 42.9.1 ALTER TABLE O comprimento das colunas de comprimento vari vel que fazem parte de qualquer ndice, inclusive chaves prim rias e exclusivas, definidas quando a vari vel de registro DB2_INDEX_2BYTEVARLEN estava ativada, podem ser alterados para um comprimento maior que 255 bytes. O fato de uma coluna de comprimento vari vel estar envolvida em uma chave remota no impede mais que o comprimento dessa coluna seja alterado para mais de 255 bytes, independentemente da definio da vari vel de registro. Entretanto, os dados com comprimento maior que 255 no podem ser inseridos na tabela, a no ser que a coluna da chave principal correspondente tenha comprimento maior que 255 bytes, o que possvel somente se a chave prim ria tiver sido criada com a vari vel de registro definida como ON. 42.9.2 CREATE INDEX Os ndices podem ser definidos em colunas com comprimento vari vel cujo comprimento maior que 255 bytes se a vari vel de registro DB2_INDEX_2BYTEVARLEN for ON. 42.9.3 CREATE TABLE Chaves principais e exclusivas com peas vari veis podem ter mais de 255 se a vari vel de registro DB2_INDEX_2BYTEVARLEN for ON. Chaves remotas podem ser definidas em colunas de comprimento vari vel cujo comprimento maior que 255 bytes. ------------------------------------------------------------------------ |42.10 Seo Notas da Instruo ALLOCATE CURSOR Incorreta |Os dois itens da seo Notas da Instruo ALLOCATE CURSOR foram impressas |com erro. Desconsidere as informaes contidas nesses |itens. ------------------------------------------------------------------------ |42.11 Opes Adicionais na Instruo GET DIAGNOSTICS |Instruo GET DIAGNOSTICS | | | | | |A instruo GET DIAGNOSTICS utilizada para obter informaes sobre a |instruo SQL executada previamente. A sintaxe dessa instruo foi |atualizada como segue. |Sintaxe do Comando |>>-GET DIAGNOSTICS----------------------------------------------> | |>--+-SQL-variable-name--=--+-ROW_COUNT-----+-+----------------->< | | '-RETURN_STATUS-' | | '-| condition-information |---------------' | |condition-information | ||--EXCEPTION--1-------------------------------------------------> | | .-,------------------------------------------. | V | |>----SQL-variable-name--=--+-MESSAGE_TEXT-----+-+---------------| | '-DB2_TOKEN_STRING-' | | |Parmetros do Comando | |SQL-variable-name |Identifica a vari vel que o alvo da atribuio. Se ROW_COUNT ou |RETURN_STATUS forem especificadas, a vari vel deve ser uma vari vel com um |nmero inteiro. Caso contr rio, a vari vel deve ser CHAR ou |VARCHAR. Vari veis SQL podem ser definidas em uma instruo |composta. |ROW_COUNT |Identifica o nmero de filas associadas instruo SQL anterior. |Se a instruo SQL anterior uma instruo DELETE, INSERT ou UPDATE, |ROW_COUNT identifica o nmero de filas excludas, inseridas ou atualizadas |pela instruo, exceto filas afetadas por disparos ou limitaes de |integridade referencial. Se a instruo anterior uma instruo |PREPARE, ROW_COUNT identifica o nmero estimado de filas |resultantes na instruo preparada. |RETURN_STATUS |Identifica o valor de status retornado do procedimento armazenado |associado instruo SQL anteriormente executada, desde que a instruo tenha |sido uma instruo CALL chamando um procedimento que retorna um status. |Se a instruo anterior no era desse tipo, o valor retornado no tem |significado e pode ser qualquer nmero inteiro. |condition-information |Especifica que as informaes de erro ou de aviso da instruo SQL |anteriormente executada devem ser retornadas. Se as informaes sobre |um erro forem necess rias, a instruo GET DIAGNOSTICS deve ser a primeira |instruo especificada na rotina de tratamento que trata o erro. Se as |informaes sobre um aviso forem necess rias e se a rotina de tratamento |assumir o controle da condio de aviso, a instruo GET DIAGNOSTICS dever |ser a primeira instruo especificada nessa rotina de tratamento. Se a |rotina de tratamento no assumir controle da condio de aviso, a |instruo GET DIAGNOSTICS dever ser a prxima instruo executada. | |MESSAGE_TEXT |Identifica qualquer texto de mensagem de erro ou de aviso retornado de uma |instruo SQL anteriormente executada. O texto da mensagem retornado |na linguagem do servidor de banco de dados onde a instruo |processada. Se a instruo concluir com um SQLCODE igual a zero, uma |cadeia vazia ou espaos em branco so retornados. |DB2_TOKEN_STRING |Identifica quaisquer tokens de mensagem de erro e de aviso retornados da |instruo SQL anteriormente executada. Se a instruo concluir com um |SQLCODE igual a zero ou se o SQLCODE no tiver tokens, uma cadeia vazia ou |espaos em branco so retornados. | | ------------------------------------------------------------------------ |42.12 ORDER BY em Sub-selees |DB2 agora suporta ORDER BY em sub-selees e selees completas. |42.12.1 seleo completa |O que se segue um diagrama de sintaxe parcial da seleo completa |modificada, exibindo a localizao da order-by-clause. |>>-+-subselect---------+----------------------------------------> | +-(fullselect)------+ | '-| values-clause |-' | | .----------------------------------------------. | V | |>----+------------------------------------------+-+-------------> | '-+-UNION---------+--+-sub-seleo-------+-' | +-UNION ALL-----+ +-(fullselect)------+ | +-EXCEPT--------+ '-| values-clause |-' | +-EXCEPT ALL----+ | +-INTERSECT-----+ | '-INTERSECT ALL-' | |>--+-----------------+----------------------------------------->< | '-order-by-clause-' | | |Uma seleo completa que contm uma cl usula ORDER BY no pode ser |especificada em: | * |Uma tabela de resumo * |A seleo completa mais distante de uma exibio (SQLSTATE 428FJ SQLCODE |-20211) | |Uma cl usula ORDER BY em uma seleo completa no afeta a ordem das filas |retornadas por uma consulta. Uma cl usula ORDER BY somente afeta a |ordem das filas retornadas se for especificado na seleo completa mais |distante. |42.12.2 subselect |Segue o diagrama de sintaxe completo da subseleo modificada, mostrando a |localizao da order-by-clause. |>>-select-clause--from-clause--+--------------+-----------------> | '-where-clause-' | |>--+-----------------+--+---------------+-----------------------> | '-group-by-clause-' '-having-clause-' | |>--+-----------------+----------------------------------------->< | '-order-by-clause-' | | |As cl usulas de subselect so processadas na seguinte seqncia: | 1. |Cl usula FROM 2. |Cl usula WHERE 3. |Cl usula GROUP BY 4. |Cl usula HAVING 5. |Cl usula SELECT 6. |Cl usula ORDER BY | |Uma subselect que contm uma cl usula ORDER BY no pode ser |especificada: | * |Na seleo completa mais distante de uma exibio * |Em uma tabela de resumo * |A no ser que a subselect seja includa entre parnteses | |Por exemplo, o que se segue no v lido (SQLSTATE 428FJ SQLCODE |-20211): |SELECT * FROM T1 | ORDER BY C1 |UNION |SELECT * FROM T2 | ORDER BY C1 |O seguinte exemplo v lido: |(SELECT * FROM T1 | ORDER BY C1) |UNION |(SELECT * FROM T2 | ORDER BY C1) |Uma cl usula ORDER BY em uma subselect no afeta a ordem das filas |retornadas por uma consulta. Uma cl usula ORDER BY somente afeta a |ordem das filas retornadas se isso for especificado na seleo completa mais |distante. |42.12.3 order-by-clause |O que se segue um diagrama de sintaxe completa da order-by-clause |modificada. | .-,------------------------------. | V .-ASC--. | |>>-ORDER BY----+-sort-key--+------+---------+-+---------------->< | | '-DESC-' | | '-ORDER OF--table-designator-' | |sort-key | ||--+-simple-column-name--+--------------------------------------| | +-simple-integer------+ | '-sort-key-expression-' | | | |ORDER OF table-designator |Especifica que o mesmo ordenamento utilizado em table-designator |deve ser aplicado tabela de resultados da subselect. Deve haver uma |referncia de tabela idntica a table-designator na cl usula FROM da |subselect que especifica essa cl usula (SQLSTATE 42703). A subselect |(ou seleo completa) correspondente ao table-designator especificado |deve incluir uma cl usula ORDER BY que dependente dos dados (SQLSTATE 428FI |SQLCODE -20210). O ordenamento que aplicado o mesmo como se as |colunas da cl usula ORDER BY na subselect (ou seleo completa) embutida |fossem includas na subselect (ou seleo completa) exterior e essas colunas |fossem especificadas em lugar da cl usula ORDER OF. Para obter mais |informaes sobre designadores de tabela, consulte "Qualificadores de Nome de |Coluna para Evitar Ambigidade" em SQL |Reference. |Observe que essa forma no permitida em uma seleo completa (alm da |forma degenerativa de uma seleo completa). Por exemplo, o que se |segue no v lido: |(SELECT C1 FROM T1 | ORDER BY C1) |UNION |SELECT C1 FROM T2 | ORDER BY ORDER OF T1 |O seguinte exemplo v lido: |SELECT C1 FROM | (SELECT C1 FROM T1 | UNION | SELECT C1 FROM T2 | ORDER BY C1 ) AS UTABLE |ORDER BY ORDER OF UTABLE | |42.12.4 select-statement |O que se segue um diagrama de sintaxe completa da select-statement |modificada: |>>-+-----------------------------------+--fullselect------------> | | .-,-----------------------. | | | V | | | '-WITH----common-table-expression-+-' | |>--fetch-first-clause--*--+--------------------+----------------> | +-read-only-clause---+ | | (1) | | '-update-clause------' | |>--*--+---------------------+--*--+--------------+------------->< | '-optimize-for-clause-' '-WITH--+-RR-+-' | +-RS-+ | +-CS-+ | '-UR-' | | |Notas: 1. |A update-clause no pode ser especificada se a seleo completa contiver |uma order-by-clause. | |Instruo SELECT INTO |Sintaxe | .-,-------------. | V | |>>-select-clause--INTO----host-variable-+--from-clause----------> | |>--+--------------+--+-----------------+--+---------------+-----> | '-where-clause-' '-group-by-clause-' '-having-clause-' | |>--+-----------------+--+--------------+----------------------->< | '-order-by-clause-' '-WITH--+-RR-+-' | +-RS-+ | +-CS-+ | '-UR-' | | |42.12.5 Funes OLAP (window-order-clause) |O que se segue um diagrama de sintaxe parcial para as funes OLAP |exibindo a window-order-clause modificada. |window-order-clause | | .-,-------------------------------------------. | V .-| opo asc |--. | ||--ORDER BY----+-sort-key-expression--+----------------+-+-+----| | | '-| opo desc |-' | | '-ORDER OF--table-designator--------------' | |opo asc | | .-NULLS LAST--. ||--ASC--+-------------+-----------------------------------------| | '-NULLS FIRST-' | |opo desc | | .-NULLS FIRST-. ||--DESC--+-------------+----------------------------------------| | '-NULLS LAST--' | | | |ORDER BY (sort-key-expression,...) |Define o ordenamento de filas dentro de uma partio que determina o valor |da funo OLAP ou o significado dos valores ROW na |window-aggregation-group-clause (no define o ordenamento do conjunto de |resultados de consulta). |sort-key-expression |Uma expresso utilizada na definio do ordenamento das filas dentro de |uma partio de janela. Cada nome de coluna referido em uma |sort-key-expression deve claramente referir-se a uma coluna do conjunto de |resultado da subselect, incluindo a funo OLAP (SQLSTATE 42702 ou |42703). O comprimento de cada sort-key-expression no deve superar 255 |bytes (SQLSTATE 42907). Uma sort-key-expression no pode incluir uma |seleo completa scalar (SQLSTATE 42822) ou qualquer funo que no seja |determinista ou que tenha uma ao externa (SQLSTATE 42845). Essa |cl usula exigida para as funes RANK e DENSE_RANK (SQLSTATE 42601). |ASC |Utiliza os valores da sort-key-expression em ordem crescente. |DESC |Utiliza os valores da sort-key-expression em ordem decrescente. |NULLS FIRST |O ordenamento das janelas considera valores nulos antes de |todos os valores no-nulos na seqncia de ordem. |NULLS LAST |O ordenamento das janelas considera valores nulos depois de |todos os valores no-nulos na seqncia de ordem. |ORDER OF table-designator |Especifica que o mesmo ordenamento utilizado em table-designator |deve ser aplicado tabela de resultados da subselect. Deve haver uma |referncia de tabela idntica a table-designator na cl usula FROM da |subselect que especifica essa cl usula (SQLSTATE 42703). A subselect |(ou seleo completa) correspondente ao table-designator especificado |deve incluir uma cl usula ORDER BY que dependente dos dados (SQLSTATE 428FI |SQLCODE -20210). O ordenamento que aplicado o mesmo como se as |colunas da cl usula ORDER BY na subselect (ou seleo completa) embutida |fossem includas na subselect (ou seleo completa) exterior e essas colunas |fossem especificadas em lugar da cl usula ORDER OF. Para obter mais |informaes sobre designadores de tabela, consulte "Qualificadores de Nome de |Coluna para Evitar Ambigidade" em SQL |Reference. | ------------------------------------------------------------------------ |Novo Argumento de Entrada para o Procedimento GET_ROUTINE_SAR | |Esse procedimento agora suporta hide_body_flag, um argumento de |entrada do tipo INTEGER que especifica (usando um dos seguintes valores) se um |corpo de rotina deve ou no ser oculto quando o texto da rotina extrado dos |cat logos: | |0 |Deixa o texto de rotina intacto. Esse o valor padro. |1 |Substitui o corpo de rotina por um corpo vazio quando o texto de rotina |extrado dos cat logos. | |>>-GET_ROUTINE_SAR----------------------------------------------> | |>--(--sarblob--,--tipo--,--routine_name_string--+-------------------+--)->< | '-,--hide_body_flag-' | | ------------------------------------------------------------------------ |Autorizao Obrigatria para a Instruo SET INTEGRITY |Quando essa instruo utilizada para desligar a verificao de |integridade, os privilgios do ID de autorizao da instruo devem incluir no |mnimo um dos seguintes: | * |Privilgio CONTROL em: | o |As tabelas especificadas e o |As tabelas de chaves externas descendentes que tero a verificao de |integridade desligada pela instruo e o |As tabelas de resumo descendentes imediatas que tero a verificao de |integridade desligada pela instruo | * |Autoridade SYSADM ou DBADM * |Autoridade LOAD | ------------------------------------------------------------------------ |Apndice N. Tabelas de Exceo | | |Na tabela "Estrutura da Coluna de Mensagens da tabela de Exceo", nas |linhas 2 e 6, que descrevem os caracteres que indicam o tipo da primeira e das |seguintes violaes de limitao encontradas, respectivamente, est faltando |uma referncia a: | 'D' - Violao de Cascata de Excluso ------------------------------------------------------------------------ Atualizaes do Unicode ------------------------------------------------------------------------ 46.1 Introduo O padro Unicode um esquema universal de codificao de caracteres para caracteres e texto escritos. Ele define um conjunto de caracteres com muita exatido da mesma forma que o faz para um pequeno nmero de codificaes. Ele define uma forma consistente de codificar texto multilnge, o que permite a troca de dados de texto internacionalmente e cria a base para software global. Dois dos esquemas de codificao fornecidos pelo Unicode so UTF-16 e UTF-8. O esquema de codificao padro o UTF-16, um formato de codificao de 16 bits. Ele um subconjunto do UTF-16 que usa dois bytes para representar um caractere. O UCS-2 geralmente aceito como a p gina de cdigos universal capaz de representar todos os caracteres necess rios de todas as p ginas de cdigo de byte simples e duplo byte existentes. Ele est registrado na IBM como p gina de cdigos 1200. O outro formato de codificao do Unicode o UTF-8, que orientado por bytes e foi planejado para facilitar o uso com sistemas baseados em ASCII. O UTF-8 usa um nmero vari vel de bytes (normalmente 1-3, s vezes 4) para armazenar cada caractere. Os caracteres ASCII invari veis so armazenados como bytes simples. Todos os outros caracteres so armazenados utilizando mltiplos bytes. Em geral, os dados do UTF-8 podem ser tratados como dados ASCII estendidos pelo cdigo que no foi designado para p ginas de cdigo de mltiplos bytes. Ele est registrado na IBM como p gina de cdigos 1208. importante que os aplicativos levem em conta os requisitos dos dados conforme eles so convertidos entre a p gina de cdigos local, UCS-2 e UTF-8. Por exemplo, 20 caracteres precisaro de exatamente 40 bytes no UCS-2 e algo entre 20 e 60 bytes no UTF-8, dependendo da p gina de cdigos original e do caractere usado. 46.1.1 Bancos de Dados e Aplicativos do DB2 Unicode Um DB2 Universal Database para Unix, Windows ou OS/2 criado especificando um conjunto de cdigos UTF-8 pode ser utilizado para armazenar dados nos formatos UCS-2 e UTF-8. Tal banco de dados referido como um banco de dados Unicode. Os dados de caracteres SQL so codificados utilizando o UTF-8 e os dados gr ficos SQL so codificados utilizando o UCS-2. Isso significa que os caracteres MBCS, incluindo os caracteres de byte nico e de byte duplo, so armazenados em colunas de caracteres, e os caracteres DBCS so armazenados em colunas gr ficas. A p gina de cdigos de um aplicativo pode no corresponder p gina de cdigos que o DB2 usa para armazenar dados. Em um banco de dados no-Unicode, quando as p ginas de cdigo no so iguais, o gerenciador de banco de dados converte dados de caractere e gr ficos (DBCS puro) que so transferidos entre cliente e servidor. Em um banco de dados Unicode, a converso de dados de caractere entre a p gina de cdigos do cliente e o UTF-8 automaticamente executada pelo gerenciador de banco de dados, mas todos os dados gr ficos (UCS20 so passados sem qualquer converso entre o cliente e o servidor. Figura 1. Converses de P gina de Cdigos Executadas pelo Database Manager [Converses de P gina de Cdigo Executadas pelo Database Manager] Notas: 1. Ao conectar-se a Bancos de Dados Unicode, se o aplicativo definir DB2CODEPAGE=1208, a p gina de cdigos local ser UTF-8, portanto no ser necess ria nenhuma converso de p gina. 2. Quando estiver conectado a um Banco de Dados Unicode, os aplicativos CLI tambm podero receber dados de caractere como dados gr ficos e vice-versa. possvel que um aplicativo especifique uma p gina de cdigos UTF-8, indicando que enviar e receber todos os dados gr ficos em UCS-2 e dados de caractere em UTF-8. Essa p gina de cdigos de aplicativo suportada somente para bancos de dados Unicode. Outros pontos a considerar ao usar o Unicode: 1. A p gina de cdigos do banco de dados determinada no momento em que o banco de dados criado e, por padro, seu valor determinado a partir do locale do sistema operacional (ou da p gina de cdigos). As palavras-chave CODESET e TERRITORY podem ser usadas para criar explicitamente um banco de dados DB2 Unicode. Por exemplo: CREATE DATABASE unidb USING CODESET UTF-8 TERRITORY US 2. A p gina de cdigos de aplicativo tambm usa como padro a p gina de cdigos local, mas ela pode ser substituda pelo UTF-8 de duas formas: o Definindo a p gina de cdigos de aplicativo para UTF-8 (1208) com este comando: db2set DB2CODEPAGE=1208 o Para aplicativos CLI/ODBC, chamando SQLSetConnectAttr() e definindo SQL_ATTR_ANSI_APP para SQL_AA_FALSE. A definio padro SQL_AA_TRUE. 3. Os dados nas colunas GRAPHIC usaro exatamente dois bytes para cada caractere do Unicode, enquanto que os dados nas colunas CHAR usaro de 1 a 3 bytes para caractere do Unicode. Os limites de SQL em termos de caracteres para colunas GRAPHIC so geralmente metade daqueles para colunas CHAR, mas em termos de bytes, eles so iguais. Por exemplo, o comprimento m ximo de caracteres para uma coluna CHAR 254 e o comprimento m ximo de caracteres para uma coluna gr fica 127. Para obter mais informaes, consulte MAX no captulo "Funes" do SQL Reference. 4. Um literal gr fico diferenciado de um literal de caractere por um prefixo G. Por exemplo: SELECT * FROM mytable WHERE mychar = 'utf-8 data' AND mygraphic = G'ucs-2 data' Nota: O prefixo G opcional para bancos de dados Unicode. Consulte 40.6.2.4, "Literais em Bancos de Dados Unicode" para obter maiores informaes e suporte atualizado. 5. Suporte para aplicativos CLI/ODBC e JDBC difere do suporte para aplicativos incorporados. Para obter informaes especficas do suporte CLI/ODBC, consulte a seo "Manual de Referncia ao CLI". 6. A ordenao de bytes dos dados UCS-2 pode diferir entre plataformas. Internamente, o DB2 usa o formato big-endian. 46.1.2 Atualizaes de Documentao Estas notas sobre o release incluem atualizaes para as seguintes informaes sobre como utilizar o Unicode com o DB2 Verso 7.1: * SQL Reference: Captulo 3. Elementos de Linguagem Captulo 4. Funes |Captulo 6. Instrues SQL * CLI Guide and Reference: Captulo 3. Utilizando Recursos Avanados Apndice C. DB2 CLI e ODBC * Data Movement Utilities Guide and Reference, Apndice C. Formatos de Arquivo do Utilit rio de Exportao/Importao/Carregamento Para obter mais informaes sobre como utilizar o Unicode com o DB2, consulte a publicao Manual de Administrao, apndice NLS (National Language Support): "Suporte ao Unicode no DB2 UDB". ------------------------------------------------------------------------ Conectando aos Sistemas Host ndice Parcial * |Manual do Usu rio do DB2 Connect o |47.1 Aumentando Taxas de Transferncia de Dados do DB2 Connect + |47.1.1 Blocos de Consulta Extra + |47.1.2 RFC-1323 Window Scaling o |47.2 Suporte do DB2 Connect para Transaes Acopladas Soltas o |47.3 Suporte a Kerberos * Connectivity Supplement o 48.1 Configurando o Servidor de Aplicativos em um Ambiente VM o 48.2 Configurao do PATCH1 CLI/ODBC/JDBC e Definies do PATCH2 ------------------------------------------------------------------------ |Manual do Usu rio do DB2 Connect | | | ------------------------------------------------------------------------ |47.1 Aumentando Taxas de Transferncia de Dados do DB2 Connect |Embora a juno de blocos de linhas para um conjunto de resultados de |consulta no seja nada novo, o DB2 para z/OS (antigamente chamado de DB2 para |OS/390) desde que em suas Verses de release 6.1 tinha a capacidade de |retornar mltiplos blocos de consulta em resposta a uma solicitao ABERTA ou |RECUPERADA para um cliente remoto, assim como o DB2 Connect. Melhor do |que enviar repetitivamente solicitaes ao DB2 para o servidor z/OS |solicitando um bloco de dados em linha a cada vez, o cliente agora pode |opcionalmente solicitar que o servidor envie de volta um nmero adicional de |blocos de consulta. Tais blocos adicionais de consulta so chamados |blocos de consulta extra. |Este novo recurso permite que o cliente minimize o nmero de retornos de |linha de rede, que causa o principal impacto no desempenho da rede. A |diminuio no nmero de solicitaes enviadas pelo cliente ao servidor para |blocos de consulta resulta em um significante impulso de desempenho j que a |comutao entre um envio e resposta uma operao dispendiosa em termos de |desempenho. O DB2 Connect agora pode aproveitar este aumento de |desempenho atravs da solicitao de blocos de consulta extra por padro de um |DB2 para servidor z/OS. |Para obter vantagem total do retorno de blocos de consulta extra (cada um |pode ter at 32K bytes) para protocolos de rede TCP/IP, extenses Window |Scaling tambm podem ser ativadas como arquitetadas de acordo com o RFC-1323 |no DB2 Connect. Este recurso permite ao TCP/IP se ajustar dinmica e |eficientemente ao tamanho das janelas de envio e recepo para acomodar as |possveis grandes quantidades de dados retornados pelos blocos de consulta |extra. |47.1.1 Blocos de Consulta Extra |O suporte para o bloco de consulta extra nos servidores DB2 para z/OS nas |Verses 6.1 ou posteriores configurado atravs do parmetro EXTRA |BLOCKS SRV no painel de instalao do DB2 DDF. Este parmetro controla |o nmero m ximo de blocos de consulta extra que o DB2 pode retornar a um |cliente para uma solicitao e pode ser definido em um valor entre 0 e |100. A definio do valor do parmetro em 0 desativa o retorno de |blocos de consulta extra. O valor padro em 100 deve ser utilizado para |obter maior benefcio deste recurso, exceo de qualquer peculiaridade na |rede que possa tornar esta definio no ideal |No lado do cliente em que o aplicativo tem acesso ao DB2 para z/OS tanto |diretamente, atravs de uma instalao localizada no DB2 Connect ou atravs de |uma instalao do servidor DB2 Connect, existem v rios meios de ativar o |suporte correspondente do DB2 Connect em uma base de cursor ou instrues |atravs da utilizao de: | * |Um tamanho de conjunto de linhas para um cursor * |A cl usula 'OPTIMIZE for N ROWS' na instruo de seleo |associada a um cursor * |A cl usula 'FETCH FIRST N ROWS ONLY' na instruo de seleo |associada a um cursor. | |A opo 1 no coberta nesta seo pois j foi implementada como parte da |publicao DB2 for z/OS Scrollable Support no DB2 Connect Verso 7.1 |FixPak 2. Nosso foco est na utilizao das opes 2 e 3 para ativar o |suporte de bloco de consulta extra utilizando diferentes APIs SQL como a |seguir: | 1. |SQL incorporado | o |Chamada do suporte de bloco de consulta extra para uma consulta |especificando a cl usula 'OPTIMIZE for N ROWS' e/ou a cl usula |'FETCH FIRST N ROWS ONLY' na prpria instruo de seleo. o |Com a cl usula 'OPTIMIZE for N ROWS', o DB2 para z/OS tentar |agrupar o nmero desejado de linhas para retornar ao DB2 Connect, sujeito |definio do parmetro de instalao EXTRA BLOCKS SRV DDF. O aplicativo |pode escolher recuperar alm das linhas N como o DB2 para z/OS no limita o |nmero total de linhas que podem ser finalmente retornadas para um resultado |de busca definido para N. o |A cl usula 'FETCH FIRST N ROWS ONLY' funciona de maneira |similar, exceto que a definio do resultado de consulta limitado a N linhas |pelo DB2 para z/OS. Recuperar alm de N linhas pode resultar em um |cdigo SQL +100 (fim dos dados). | 2. |CLI/ODBC | o |Chamada de suporte de bloco de consulta extra para uma consulta atravs de |seu atributo de instruo SQL_MAX_ROWS. o |O DB2 Connect ir identificar a cl usula 'OPTIMIZE for N ROWS' |para um servidor DB2 para z/OS 6.x. Mesmo que o nmero de linhas |que possam ser finalmente retornadas pela definio do resultado de consulta |no sejam limitadas a N pelo DB2 para z/OS, o CLI/ODBC poder retornar a |mensagem SQL_NO_DATA_FOUND ao aplicativo se for feita uma tentativa de |recuperar alm de N linhas. o |A cl usula 'FETCH FIRST N ROWS ONLY' utilizada por um servidor |do DB2 para z/OS 7.1 ou superior. Semelhante ao caso da SQL |incorporada , a definio do resultado de consulta limitado a N linhas pelo |DB2 para z/OS. A recuperao alm de N linhas poder resultar em uma |mensagem SQL_NO_DATA_FOUND. | 3. |JDBC | o |Chamada de suporte de bloco de consulta extra para uma consulta atravs do |mtodo setMaxRows . Semelhante capacidade do CLI/ODBC, o DB2 Connect |ir identificar a cl usula 'OPTIMIZE for N ROWS' para um servidor |DB2 para z/OS server Verso 6.x , e a cl usula 'FETCH FIRST N ROWS |ONLY' para um servidor DB2 para z/OS Verso 7.1 ou |posterior. | | |47.1.2 RFC-1323 Window Scaling |O Window Scaling suportado a partir do FixPak 4 em todas as plataformas |Windows e UNIX que suportam as extenses RFC-1323 para TCP/IP. Este |recurso pode ser ativado no DB2 para Windows e UNIX atravs do registro |vari vel DB2SORCVBUF do DB2. Para ativar o Window Scaling, defina o |registro vari vel DB2SORCVBUF do DB2 para qualquer valor acima de 64K (por |exemplo, no DB2 para Windows ou UNIX, voc pode definir db2set DB2SORCVBUF |=65537). O tamanho m ximo do buffer de recebimento e envio depende do |sistema operacional especfico. Para garantir que os tamanhos de buffer |configurados foram aceitos, o usu rio pode definir o parmetro de configurao |de gerenciamento de banco de dados DIAGLEVEL para 4 (informacional) e |verificar as mensagens do arquivo db2diag.log. |Para que o Window Scaling funcione, ele deve ser ativado em ambos os finais |de uma conexo. Por exemplo, para ativar o Window Scaling entre a |estao de trabalho do DB2 Connect e o host, este recurso deve ser ativando |tanto na estao de trabalho como no host, seja diretamente atravs da pilha |TCP/IP do sistema operacional ou indiretamente atravs do produto DB2. |Por exemplo, para o DB2 para z/OS, o Window Scaling pode ser atualmente |ativado atravs do sistema operacional definindo o TCPRCVBUFRSIZE para |qualquer valor acima de 64K. |Se um cliente remoto do DB2 utilizado para acesso ao host do DB2 atravs |de uma estao de de trabalho do servidor DB2 Connect, o Window Scaling pode |ser ativado tambm no cliente. Pelo mesmo token, o Window Scaling |tambm pode ser ativado entre um cliente remoto do DB2 e uma estao de |trabalho do servidor DB2 quando nenhum host DB2 estiver envolvido. |Embora o Window Scaling seja projetado para aumentar o desempenho da rede, |a melhoria de desempenho da rede esperada nem sempre acontece. A |interao entre fatores tais como o tamanho da estrutura utilizada pela |Ethernet ou placa LAN token ring LAN, o tamanho do IP MTU, e outras definies |em roteadores atravs do link de comunicao podem resultar em queda de |desempenho uma vez que o Window Scaling tenha sido ativado. Por padro, |o Window Scaling desativado com os dois buffers finais definidos para |64K. O usu rio deve estar preparado para calcular o impacto de ao do |Window Scaling e executar qualquer ajuste necess rio rede. Para uma |introduo ao ajuste de rede para melhorar o desempenho da rede, consulte as |informaes oficiais no endereo |http://www.networking.ibm.com/per/per10.html. ------------------------------------------------------------------------ |47.2 Suporte do DB2 Connect para Transaes Acopladas Soltas |O suporte do DB2 Connect para transaes acopladas soltas deve ser |utilizado pelo usu rio que implementa aplicativos XA distribudos que acessam |o DB2 para OS/390 Verso 6 ou posterior. Esse suporte permite que |diferentes ramificaes da mesma transao glovbal compartilhe o espao de |bloqueio do DB2 para OS/390. Esse recurso reduz a janela onde uma |ramificao de uma transao distribuda encontra o tempo limite de bloqueio |ou bloqueada como um resultado de outra ramificao na mesma transao |global. O DB2 para OS/390 Verso 6 compartilha o espao de bloqueio |dessa situao, desde que o DB2 Connect envie o XID de cada conexo que est |servindo s diferentes ramificaes da mesma transao global. ------------------------------------------------------------------------ |47.3 Suporte a Kerberos |O DB2 Universal Database atualemnte suporta o protocolo de segurana |Kerberos como um meio de autenticar usu rios no ambiente no DRDA. Como |o DB2/390 V7.1 comear a suportar a segurana Kerberos, o DB2 Connect |incluir a funcionalidade DRDA AR para permitir a utilizao de autenticao |de Kerberos para conectar ao DB2/390. |A camada de autenticao Kerberos que lida com o sistema de tickets |integrada no mecanismo do Win2K Active Directory. Os lados do servidor |e do cliente de um aplicativo se comunicam com os mdulos do cliente e do |servidor Kerberos SSP (Security Support Provider), respectivamente. A |SSPI (Security Support Provider Interface) fornece uma interface de alto nvel |para o Kerberos SSP e outros protocolos de segurana |Suporte ao Protocolo de Comunicao |Para conexo SNA, voc deve utilizar SECURITY=NONE ao catlogar o n APPC |Configurao Tpica |O procedimento para configurar o DB2 para utilizar a autenticao Kerberos |envolve configurar o seguinte: | * |Uma poltica de autorizao para o DB2 (como um servio) no Active |Directory que compartilhado em uma rede e * |Uma relao de confiana entre os KDCs (Kerberos Key Distribution Centers) | |No cen rio mais simples, h pelo menos uma relao de confiana KDC para |configurar, ou seja, a que fica entre o KDC que controla a estao de trabalho |do cliente e o sistema OS/390. O OS/390 R10 fornece processamento de |tickets Kerberos que so processados atravs de seu recurso RACF quew permite |que o host aja como um UNIX KDC. |O DB2 Connect fornece, como sempre, a funcionalidade do roteador na |configurao de 3 nveis. No assume nenhuma funo em autenticao |quando a segurana Kerberos utilizada. Em vez disso, transfere |simplesmente o token de segurana do cliente para o DB2/390. Dessa |forma, no h necessidade do gateway do DB2 Connect de conectar-se a um membro |do cliente ou ao domnio Kerberos do host. |Para utilizar o Kerberos, o gateway do DB2 Connect deve catalogar sua |conexo com tipo de autenticao KERBEROS. O cliente pode catalogar com |autenticao NOT_SPEC ou Kerberos. Qualquer outra combinao de tipos |de autenticao no cliente e no gateway resulta em sqlcode -1401 |(Incompatibilidade de tipo de autenticao). |Compatibilidade de Nvel Inferior |Requisitos do DB2 para suporte a Kerberos: | |Cliente DB2 UDB: |Verso 7.1 (SO: Win2K) |DB2 Connect: |Verso 7.1 + Fix Pack 1 (SO: Qualquer um) |DB2/390: |Verso 7.1 | |O DB2/390 tambm tem uma exigncia para ser executado no OS/390 Verso 2 |Release 10 ou posterior. H requisitos adicionais implcitos em |sistemas DB2/390 de nvel inferior ao conectar aos clientes do DB2 Connect |Verso 7.1. Apesar desses sistemas DB2/390 no suportarem |Kerberos, eles no respondem corretamente a DRDA SECMECs no |suportados. Para solucionar esse problema, aplique o PTF |apropriado: | * |UQ41941 (para DB2/390 V5.1) * |UQ41942 (para DB2/390 V6.1) | ------------------------------------------------------------------------ Connectivity Supplement ------------------------------------------------------------------------ 48.1 Configurando o Servidor de Aplicativos em um Ambiente VM Inclua as seguinte sentena aps a primeira (e nica) sentena na seo "Fornecer Informaes de Rede", sub-seo "Definindo o Servidor de Aplicativos": O RDB_NAME fornecido no SQLSTART EXEC como o parmetro DBNAME. ------------------------------------------------------------------------ 48.2 Configurao do PATCH1 CLI/ODBC/JDBC e Definies do PATCH2 O driver CLI/ODBC/JDBC pode ser configurado atravs do Assistente de Configurao de Cliente ou do Gerenciador de Driver ODBC (se estiver instalado no sistema), ou manualmente editando o arquivo db2cli.ini. Para mais detalhes, consulte a publicao Suplemento de Instalao e Configurao ou o CLI Guide and Reference. O comportamento padro do driver DB2 CLI/ODBC pode ser modificado por meio da especificao de valores para ambas as palavras-chave, PATCH1 e PATCH2, atravs do arquivo db2cli.ini ou atravs da API CLI SQLDriverConnect() ou SQLBrowseConnect(). A palavra-chave PATCH1 especificada por meio da incluso de todas as palavras-chave que o usu rio quer definir juntas. Por exemplo, se forem especificados patch 1, 2 e 8, o PATCH1 teria o valor 11. Esta uma descrio do valor de cada palavra-chave e seu efeito no driver: 1 Isso faz o driver procurar por "count(exp)" e substitu-lo por "count(distinct exp)". Isso necess rio porque algumas verses do DB2 suportam a sintaxe "count(exp)" e essa sintaxe gerada por alguns aplicativos ODBC. necess rio para aplicativos Microsoft quando o servidor no suporta a sintaxe "count(exp)". 2 Alguns aplicativos ODBC so interrompidos quando SQL_NULL_DATA retornado na funo SQLGetTypeInfo() para a coluna LITERAL_PREFIX ou LITERAL_SUFFIX. Isso fora o driver a retornar uma cadeia vazia. Necess rio para o Impromptu 2.0. 4 Isso fora o driver a tratar os dados de entrada de data e hora como dados de data se a hora e a parte de frao da date e hora forem zero. Necess rio para o Microsoft Access. 8 Isso fora o driver a tratar os dados de data e hora como dados de hora se a parte de data da data e hora for 1899-12-30. Necess rio para o Microsoft Access. 16 No utilizado. 32 Isso fora o driver a no retornar informaes sobre as colunas SQL_LONGVARCHAR, SQL_LONGVARBINARY e SQL_LONGVARGRAPHIC. Para o aplicativo aparecer como se campos longos no fossem suportados. Necess rio para o Lotus 123. 64 isso fora o driver a terminar cadeias gr ficas de sada com NULL. Necess rio para o Microsoft Access em um ambiente de byte duplo. 128 Isso fora o driver a permitir que a consulta "SELECT Config, nValue FROM MSysConf" v para o servidor. Atualmente o driver retorna um erro com valor SQLSTATE associado igual a S0002 (tabela no encontrada). Necess rio se o usu rio tiver criado essa tabela de configurao no banco de dados e queira que o aplicativo a acesse. 256 Isso fora o driver a retornar primeiro as colunas-chave principais na chamada SQLStatistics(). Atualmente, o driver retorna os ndices ordenados pelo nome do ndice, que o comportamento padro do ODBC. 512 Isso fora o driver a retornar FALSE em SQLGetFunctions() para SQL_API_SQLTABLEPRIVILEGES e SQL_API_SQLCOLUMNPRIVILEGES. 1024 Isso fora o driver a retornar SQL_SUCCESS em vez de SQL_NO_DATA_FOUND em SQLExecute() ou SQLExecDirect() se a instruo UPDATE ou DELETE executada no afetar nenhuma linha. Necess rio para os aplicativos do Visual Basic. 2048 No utilizado. 4096 Isso fora o driver a no emitir um COMMIT depois de fechar um cursor quando no modo autocommit. 8192 Isso fora o driver a retornar um conjunto extra de resultados depois de chamar um procedimento armazenado. Esse conjunto de resultados um conjunto de resultados de uma linha que consiste em valores de sada do procedimento armazenado. Pode ser acessado por aplicativos Powerbuild. 32768 Isso fora o driver a fazer aplicativos Microsoft Query funcionar com sinnimos do DB2 MVS. 65536 Isso fora o driver a inserir manualmente um "G" na frente dos literais de caracteres que so na verdade literais gr ficos. Essa correo deve ser sempre fornecida quando se estiver trabalhando em um ambiente de byte duplo. 131072 Isso fora o driver a descrever uma coluna de data e hora como uma coluna CHAR(26) quando ela faz parte de um ndice exclusivo. Necess rio para os aplicativos Microsoft. 262144 Isso fora o driver a utilizar a tabela do pseudo-cat logo db2cli.procedures em vez das tabelas SYSCAT.PROCEDURES e SYSCAT.PROCPARMS. 524288 Isso fora o driver a utilizar SYSTEM_TABLE_SCHEMA em vez de TABLE_SCHEMA quando estiver fazendo uma consulta de tabela do sistema em um sistema DB2/400 V3.x. Isso resulta em melhor desempenho. 1048576 Isso fora o driver a tratar uma cadeia de comprimento zero atravs de SQLPutData() como SQL_NULL_DATA. A palavra-chave PATCH2 difere da palavra-chave PATCH1. Nesse caso, v rias correes so especificadas com a utilizao de vrgulas como separadores. Por exemplo, se forem especificadas as correes 1, 4 e 5, o PATCH2 teria o valor "1,4,5". Esta uma descrio do valor de cada palavra-chave e seu efeito no driver: 1 - Obriga o driver a converter o nome do procedimento armazenado de uma instruo CALL em maisculas. 2 - No utilizado. 3 - Isso fora o driver a converter todos os argumentos para chamadas de esquema para letras maisculas. 4 - Isso fora o driver a retornar a Verso 2.1.2 como conjunto de resultados de chamadas de esquema (ou seja, SQLColumns(), SQLProcedureColumns() e assim por diante ), em vez da Verso 5 como conjunto de resultados. 5 - Obriga o driver a no otimizar o processamento das colunas VARCHAR de entrada, em que o indicador dos dados e o indicador do comprimento so consecutivos na memria. 6 - Isso fora o driver a retornar uma mensagem que cursores desloc veis no so suportados. Isso necess rio para programas do Visual Basic se o cliente do DB2 tiver Verso 5 e o servidor for DB2 UDB Verso 5. 7 - Isso fora o driver a mapear todos os tipos de dados da colune GRAPHIC para o tipo de dados da coluna CHAR. Isso necess rio em um ambiente de byte duplo. 8 - Isso fora o driver a ignorar argumentos de pesquisa do cat logo em chamadas de esquema. 9 - No efetua o commit em Early Close de um cursor 10 - No Utilizado 11 - Relata que o nome do cat logo suportado, (procedimentos armazenados VB) 12 - Remove as aspas duplas dos argumentos da chamada do esquema, (Visual Interdev) 13 - No anexa as palavras-chave do db2cli.ini na cadeia de conexo de sada 14 - Ignora o nome do esquema em SQLProcedures() e SQLProcedureColumns() 15 - Usa sempre um ponto como separador decimal na sada do caractere 16 - Obriga a apresentao das informaes de descrio de cada abertura 17 - No apresenta os nomes de colunas na descrio 18 - Tenta substituir literais por marcadores de parmetros 19 - Atualmente, o DB2 MVS V4.1 no suporta a sintaxe do ODBC onde parnteses so permitidos na cl usula ON em uma cl usula Outer join. Ativar esse PATCH2 far com que o driver IBM DB2 ODBC tire os parnteses quando a cl usula outer join estiver em uma seqncia de escape do ODBC. Esse PATCH2 deve ser utilizado apenas quando estiver indo contra o DB2 MVS 4.1. 20 - Atualmente, o DB2 em MVS no suporta o predicado BETWEEN com marcadores de parmetros como ambos operandos (expresso ? BETWEEN ?). Ativar essa correo far o Driver IBM ODBC Driver reescrever o predicado para (expression >= ? and expression <= ?). 21 - Defina todos os parmetros apenas OUTPUT dos procedimentos armazenados para SQL_NULL_DATA 22 - Esse PATCH2 faz com que o driver IBM ODBC reporte OUTER join como no suportado. Isso para aplicativos que geram SELECT DISTINCT col1 ou ORDER BY col1 ao utilizar instrues outer join nas quais col1 tem comprimento maior que 24 caracteres e faz com que o DB2 UDB retorne um erro (j que o DB2 UDB no suporta coluna maior de 254 bytes nesse uso) 23 - No otimize a entrada dos parmetros bound com cbColDef=0 24 - Soluo de acesso para o mapeamento de valores de Tempo como Caracteres 25 - Acessa soluo alternativa para colunas decimais - remove zeros finais da representao de caracteres 26 - No retorna sqlcode 464 para o aplicativo - indica que conjuntos de resultados so retornados 27 - Fora o SQLTables a utilizar o valor palavra-chave TABLETYPE, mesmo que o aplicativo especifica um valor v lido 28 - Descreve colunas reais como colunas duplas 29 - ADO solues para colunas decimais - remove zeros iniciais de valores x, em que 1 > x > -1 (Necess rio apenas para algumas verses do MDAC) 30 - Desativa a otimizao de cache do Procedimento Armazenado 31 - Relata estatsticas para aliases na chamada SQLStatistics 32 - Sobrepe o processamento do sqlcode -727 cdigo de motivo 4 33 - Retorna a verso ISO do registro de tempo quando convertido para caractere (como oposto verso ODBC) 34 - Relata colunas CHAR FOR BIT DATA como CHAR 35 - Relata um TABLENAME inv lido quando o SQL_DESC_BASE_TABLE_NAME requisitado - otimizao apenas-leitura ADO 36 - Reservado 37 - Reservado ------------------------------------------------------------------------ Informaes Adicionais ndice Parcial * Outras Informaes o 49.1 O DB2 Everywhere Agora DB2 Everyplace o 49.2 Recursos de Acessibilidade do DB2 UDB Verso 7 + 49.2.1 Entrada de Dados e Navegao atravs do Teclado + 49.2.1.1 Entrada de Dados atravs do Teclado + 49.2.1.2 Foco do Teclado + 49.2.2 Recursos para Exibio Acessvel + 49.2.2.1 Modo Alto Contraste + 49.2.2.2 Definies das Fontes + 49.2.2.3 No dependente da Cor + 49.2.3 Janela de Mensagem de Alerta Alternativa + 49.2.4 Compatibilidade com Tecnologias de Apoio + 49.2.5 Documentao de F cil Acesso o 49.3 Exigncias de Mouse o 49.4 Tentativa para fazer a vinculao a partir dos Resultados do Cliente de Run-Time do DB2 em um Erro "Arquivos de Vinculao no encontrados" o 49.5 Pesquisa de Descoberta o 49.6 Janelas de Memria do HP-UX 11 o 49.7 Desinstalando o DB2 DFS Client Enabler o 49.8 Autenticao de Cliente no Windows NT o 49.9 Restries de Sistemas Federados o |49.10 Limitaes Federadas com Tabelas Particionadas MPP o 49.11 Restrio do DataJoiner o 49.12 Gerenciador do Cat logo de Informaes em Hebraico para Windows NT o 49.13 SNA SPM do DB2 Falhou ao Iniciar Aps a Inicializao do Windows o 49.14 Requisitos da Conta de Servio para DB2 no Windows NT e Windows 2000 o 49.15 Necess rio Fazer o Commit de Todos os Programas Definidos pelo Usu rio que sero Usados no Data Warehouse Center (DWC) o 49.16 Armazenamento em Cache do Cliente no Windows NT o |49.17 Life Sciences Data Connect + |49.17.1 Novos Wrappers + |49.17.2 Avisos- o 49.18 Melhorias no SQL Assist o |49.19 Ajuda para Comandos de Backup e de Restaurao o 49.20 O "Warehouse Manager" Deveria Ser "DB2 Warehouse Manager" ------------------------------------------------------------------------ Outras Informaes ------------------------------------------------------------------------ 49.1 O DB2 Everywhere Agora DB2 Everyplace O nome do DB2 Everywhere foi alterado para DB2 Everyplace. ------------------------------------------------------------------------ 49.2 Recursos de Acessibilidade do DB2 UDB Verso 7 Os produtos da famlia do DB2 UDB incluem um nmero de recursos que tornam os produtos mais acessveis para pessoas sem habilidades. Estes recursos incluem: * Recursos que facilitam entrada de dados e a navegao atravs do teclado * Recursos que melhoram as propriedades de exibio * Opes da janela de mensagem de alerta audiovisual * Compatibilidade com tecnologias de apoio * Compatibilidade com recursos de acessibilidade do sistema operacional * Formatos de documentao de f cil acesso 49.2.1 Entrada de Dados e Navegao atravs do Teclado 49.2.1.1 Entrada de Dados atravs do Teclado O DB2 Control Center pode ser operado utilizando-se apenas o teclado. Os itens do menu e dos controles fornecem teclas de acesso que permitem aos usu rios ativar um controle ou selecionar um item do menu diretamente a partir do teclado. Estas teclas so auto-documentadas, nas teclas de acesso que so sublinhadas no controle ou no menu onde ele aparecer. 49.2.1.2 Foco do Teclado Nos sistemas baseados em UNIX, a posio do foco do teclado destacada, indicando qual rea da janela est ativa e onde a ao do usu rio digitar atravs do teclado ter efeito. 49.2.2 Recursos para Exibio Acessvel O DB2 Control Center possui um nmero de recursos que melhora a interface do usu rio e aperfeioa a acessibilidade para usu rios com problemas de viso. Estas melhorias de acessibilidade incluem suporte para definies de alto contraste e propriedades de fontes personaliz veis. 49.2.2.1 Modo Alto Contraste A interface do Centro de Controle suporta a opo modo alto contraste fornecido pelo sistema operacional. Este recurso auxilia os usu rios que exigem um alto grau de contraste entre as cores de segundo plano e primeiro plano. 49.2.2.2 Definies das Fontes A interface do Centro de Controle permite aos usu rios selecionar a cor, tamanho e fonte para o texto nos menus e janelas de di logo. 49.2.2.3 No dependente da Cor Os usu rios no precisam distinguir cores para usar quaisquer funes neste produto. 49.2.3 Janela de Mensagem de Alerta Alternativa O usu rio pode optar para receber as mensagens de alertas atravs do udio ou da janela visual. 49.2.4 Compatibilidade com Tecnologias de Apoio A interface do DB2 Control Center compatvel com os aplicativos de leitor de tela tais como Via Voice. Quando em modo de aplicativo, a interface do Centro de Controle possui as propriedades exigidas para acessar de modo f cil os aplicativos que tornam as informaes disponveis para usu rios com srios problemas de viso. 49.2.5 Documentao de F cil Acesso A documentao para os produtos da famlia do DB2 est disponvel no formato HTML. Isto permite aos usu rios exibir a documentao de acordo com as preferncias de exibio, definidas pelos seus navegadores. Ela tambm permite o uso de leitores de telas e outras tecnologias de apoio. ------------------------------------------------------------------------ 49.3 Exigncias de Mouse Para todas as plataformas exceto Windows, um mouse obrigatrio para usar as ferramentas. ------------------------------------------------------------------------ 49.4 Tentativa para fazer a vinculao a partir dos Resultados do Cliente de Run-Time do DB2 em um Erro "Arquivos de Vinculao no encontrados" Porque o Cliente de Run-Time do DB2 no possui um conjunto completo de arquivos de vinculao, a vinculao das ferramentas GUI no pode ser feito a partir do Cliente de Run-Time do DB2, e pode apenas ser feito a partir do Cliente de Administrao do DB2. ------------------------------------------------------------------------ 49.5 Pesquisa de Descoberta A Pesquisa de Descoberta apenas suportada na mdia de distribuio. Por exemplo, a pesquisa de descoberta no funcionar atravs de um adaptador ATM. De qualquer modo, esta restrio no se aplica descoberta conhecida. ------------------------------------------------------------------------ 49.6 Janelas de Memria do HP-UX 11 As janelas de memria so destinadas aos usu rios de grandes m quinas HP de 64 bits, que podem aproveitar as vantagens de mais de 1,75 GB de memria compartilhada dos aplicativos de 32 bits. As janelas de memria no so obrigatrias se voc estiver executando a verso de 64 bits do DB2. As janelas de memria tornam disponvel a memria compartilhada separada de 1 GB por processo ou por grupo de processos. Isso permite que uma instncia possua sua prpria memria compartilhada de 1 GB, mais a memria compartilhada global de 0,75 GB. Se os usu rios quiserem aproveitar essa vantagem, eles iro poder executar diversas instncias, cada uma em sua prpria janela. Estes so os pr-requisitos e condies para o uso das janelas de memria: * Ambiente DB2 EE o Correes: Extension Software 12/98 e PHKL_17795. o A vari vel $DB2INSTANCE deve ser definida para a instncia. o Deve haver uma entrada no arquivo /etc/services.window para cada instncia do DB2 que voc deseja executar sob as janelas de memria. Por exemplo: db2instance1 50 db2instance2 60 Nota: Pode existir apenas um espao entre o nome e o ID. o Qualquer comando do DB2 que voc deseja executar no servidor e que exija mais de uma instruo individual deve ser executado utilizando um mtodo de loopback do TCP/IP. Isto acontece porque o shell ir terminar quando as janelas de memria finalizarem o processamento da primeira instruo. O Servio do DB2 sabe como realizar isso. o Qualquer comando do DB2 que voc deseja executar contra uma instncia que est em execuo nas janelas da memria deve ser utilizado inicialmente no db2win (localizado em sqllib/bin). Por exemplo: db2win db2start db2win db2stop o Qualquer comando do DB2 que seja executado fora das janelas da memria (mas quando as janelas da memria estiverem sendo executadas) dever apresentar um 1042. Por exemplo: db2win db2start <== OK db2 connect to db <==SQL1042 db2stop <==SQL1042 db2win db2stop <== OK * Ambiente DB2 EEE o Correes: Extension Software 12/98 e PHKL_17795. o A vari vel $DB2INSTANCE deve ser definida para a instncia. o A vari vel de registro DB2_ENABLE_MEM_WINDOWS deve ser definida para TRUE. o Deve haver uma entrada no arquivo /etc/services.window para cada n lgico de cada instncia que voc deseja executar sob as janelas da memria. O primeiro campo de cada entrada deve ser o nome da instncia concatenado com o nmero da porta. Por exemplo: === $HOME/sqllib/db2nodes.cfg for db2instance1 === 5 host1 0 7 host1 1 9 host2 0 === $HOME/sqllib/db2nodes.cfg for db2instance2 === 1 host1 0 2 host2 0 3 host2 1 === /etc/services.window on host1 === db2instance10 50 db2instance11 55 db2instance20 60 === /etc/services.window on host2 === db2instance10 30 db2instance20 32 db2instance21 34 o Voc no deve iniciar qualquer comando do DB2 com db2win, o qual deve ser utilizado apenas em um ambiente EE. ------------------------------------------------------------------------ 49.7 Desinstalando o DB2 DFS Client Enabler Antes do DB2 DFS Client Enabler ser desinstalado, o usu rio root deve assegurar-se de que no existe arquivo DFS em utilizao, e que nenhum usu rio tenha um shell aberto no espao de arquivo dos DFS. Como raiz, emita o comando: stop.dfs dfs_cl Verifique se o /... no est mais montado: mount | grep -i dfs Caso isto no seja feito, e o DB2 DFS Client Enabler seja desinstalado, a m quina precisar ser reinicializada. ------------------------------------------------------------------------ 49.8 Autenticao de Cliente no Windows NT Uma nova vari vel de registro DB2 DB2DOMAINLIST introduzida para complementar o mecanismo de autenticao no ambiente Windows NT. Essa vari vel emitida no servidor DB2 para Windows NT para definir um ou mais domnios do Windows NT. Apenas as solicitaes de conexo ou anexao de usu rios pertencentes ao domnio definido nesta lista sero aceitos. A vari vel de registro deve ser apenas utilizada em um ambiente de domnio do Windows NT puro com servidores e cliente do DB2 sendo executados na Verso 7 (ou superior). Para obter mais informaes sobre a definio desta vari vel de registro, consulte a seo "Vari veis do Registro e Ambiente do DB2" no Manual de Administrao: Performance. ------------------------------------------------------------------------ 49.9 Restries de Sistemas Federados A seguir esto restries que se aplicam a sistemas federados: * Os tipos de dados do Oracle NCHAR, NVARCHAR2, NCLOB e BFILE no so suportados em consultas que envolvem pseudnimos. * Os comandos Create Server Option, Alter Server Option e Drop Server Option no so suportados no Centro de Controle. Para emitir qualquer um desses comandos, utilize o processador da linha de comandos (CLP). * Para consultas que envolvem apelidos, o DB2 UDB nem sempre suporta a opo de configurao do banco de dados DFT_SQLMATHWARN. Em vez disso, ele retorna os erros aritmticos ou avisos diretamente da origem de dados remota independente da definio DFT_SQLMATHWARN. * A instruo CREATE SERVER no permite que a opo de servidor COLSEQ seja definida como 'I' para origens de dados com seqncias de intercalao que no fazem distino entre maisculas e minsculas. * A instruo ALTER NICKNAME retorna SQL0901N quando uma opo inv lida especificada. * Em origens de dados Oracle, servidor Microsoft SQL e Sybase, os tipos de dados numricos no podem ser mapeados para o tipo de dados BIGINT do DB2. Por padro, o tipo de dados nmero(p,s) da Oracle, em que 10 <= p <= 18 e s = 0, mapeia o tipo de dados DECIMAL do DB2. ------------------------------------------------------------------------ |49.10 Limitaes Federadas com Tabelas Particionadas MPP |Quando voc tentar utilizar uma instruo SQL para selecionar dados de uma |origem de dados e inserir, atualizar ou excluir os dados diretamente em uma |tabela particionada MPP no servidor federado DB2, voc receber o erro |SQL0901N. A funcionalidade federada no permite a seleo a partir de |um pseudnimo e sua insero em uma tabela particionada MPP. |Depois de aplicar o FixPak 4 (ou posterior), possvel utilizar estas |etapas para selecionar dados e inseri-los em uma tabela particionada |MPP: | 1. |No ambiente de aplicativos do cliente, exporte a vari vel de ambiente |DB2NODE para designar o n ao qual o aplicativo sempre dever ser |conectado. | EXPORT DB2NODE=x |em que x o nmero de um n. 2. |Crie um grupo de ns que contenha somente o n designado. | CREATE NODEGROUP nodegroup_name ON NODE(x) |em que x o nmero do n. 3. |Crie um tablespace no grupo de ns. |CREATE TABLESPACE tablespace_name IN NODEGROUP nodegroup_name 4. |Crie uma tabela tempor ria no tablespace. |CREATE TABLE temp_table_name IN tablespace_name 5. |Divida a operao INSERT no aplicativo em duas etapas: | o |INSERT INTO temp_table_name SELECT * FROM nickname o |INSERT INTO MPP_partitioned_table SELECT * from temp_table_name | | |A diviso da instruo INSERT em duas instrues altera a consolidao do |nvel de instruo e a semntica de reverso. Por exemplo, em vez de |reverter uma instruo, ser necess rio agora reverter duas instrues. |Alm disso, se voc alterar o nmero do n associado vari vel de ambiente |DB2NODE, ser necess rio invalidar o pacote de aplicativos e efetuar uma nova |vinculao. |Estas etapas permitem a seleo de dados das origens de dados e sua |insero em uma tabela particionada MPP. Voc ainda receber o erro |SQL0901N quando tentar utilizar uma instruo para selecionar dados de uma |origem de dados e atualiz -los ou exclu-los em uma tabela particionada |MPP. Essa restrio ser eliminada no DB2 Universal Database Verso |8. ------------------------------------------------------------------------ 49.11 Restrio do DataJoiner Solicitaes distribudas dentro de um ambiente federado so limitadas a operaes de leitura. ------------------------------------------------------------------------ 49.12 Gerenciador do Cat logo de Informaes em Hebraico para Windows NT O componente Gerenciador do Cat logo de Informaes est disponvel em hebraico e fornecido no CD do DB2 Warehouse Manager para Windows NT. A traduo em hebraico fornecida em um arquivo zip chamado IL_ICM.ZIP e est localizada no diretrio DB2\IL, no CD DB2 Warehouse Manager para Windows NT. Para instalar a traduo em hebraico do Gerenciador do Cat logo de Informaes, primeiro instale a verso em ingls do DB2 Warehouse Manager para Windows NT e todos os pr-requisitos para uma verso Ativa em hebraico do Windows NT. Aps o DB2 Warehouse Manager para Windows NT ser instalado, descompacte o arquivo IL_ICM.ZIP a partir do diretrio DB2\IL no mesmo diretrio onde o DB2 Warehouse Manager para Windows NT foi instalado. Certifique-se de que as opes corretas sejam fornecidas para o programa unzip criar a estrutura de diretrios no arquivo zip. Aps o arquivo zip ser descompactado, a vari vel de ambiente global LC_ALL deve ser alterada de En_US para Iw_IL. Para alterar a definio: 1. Abra o Painel de Controle do Windows NT e clique duas vezes no cone Sistema. 2. Na janela Propriedades do Sistema, clique na guia Ambiente e localize a vari vel LC_ALL na seo Vari veis do sistema. 3. Clique na vari vel para exibir o valor na caixa de edio Valor. Altere o valor de En_US para Iw_IL. 4. Clique no boto Definir. 5. Feche a janela Propriedades do Sistema e o Painel de Controle. A verso em hebraico do Gerenciador do Cat logo de Informaes, agora, deve ser instalada. ------------------------------------------------------------------------ 49.13 SNA SPM do DB2 Falhou ao Iniciar Aps a Inicializao do Windows Se estiver utilizando o Microsoft SNA Server Verso 4 SP3 ou posterior, verifique se o SNA SPM do DB2 iniciou adequadamente aps a inicializao. Verifique o arquivo \sqllib\\db2diag.log para obter entradas similares ao seguinte: 2000-04-20-13.18.19.958000 Instance:DB2 Node:000 PID:291(db2syscs.exe) TID:316 Appid:none common_communication sqlccspmconnmgr_APPC_init Probe:19 SPM0453C Sync point manager did not start because Microsoft SNA Server has not been started. 2000-04-20-13.18.23.033000 Instance:DB2 Node:000 PID:291(db2syscs.exe) TID:302 Appid:none common_communication sqlccsna_start_listen Probe:14 DIA3001E "SNA SPM" protocol support was not successfully started. 2000-04-20-13.18.23.603000 Instance:DB2 Node:000 PID:291(db2syscs.exe) TID:316 Appid:none common_communication sqlccspmconnmgr_listener Probe:6 DIA3103E Error encountered in APPC protocol support. APPC verb "APPC(DISPLAY 1 BYTE)". Primary rc was "F004". Secondary rc was "00000000". Se tais entradas existirem no db2diag.log, e os registros de tempo corresponderem hora de reinicializao mais recente, voc deve: 1. Solicitar o db2stop. 2. Iniciar o servio SnaServer (se ainda no o tiver feito). 3. Solicitar o db2start. Verifique o arquivo db2diag.log novamente para ver se as entradas no esto mais anexadas. ------------------------------------------------------------------------ 49.14 Requisitos da Conta de Servio para DB2 no Windows NT e Windows 2000 Durante a instalao do DB2 para Windows NT ou Windows 2000, o programa de configurao cria v rios servios do Windows e atribui uma conta de servio para cada servio. Para executar o DB2 adequadamente, o programa de configurao concede os seguintes direitos de usu rio conta de servio associada ao servio do DB2: * Agir como parte do sistema operacional * Criar um objeto token * Aumentar cotas * Efetuar o logon como um servio * Substituir um token de nvel de processo. Se deseja utilizar uma conta de servio diferente para os servios do DB2, voc dever conceder estes direitos de usu rio conta do servio. Alm destes direitos, a conta do servio tambm dever ter acesso para gravao no diretrio em que o produto DB2 estiver instalado. A conta de servio para o servio DB2 Administration Server (servio DB2DAS00) tambm deve possuir a autoridade para iniciar e encerrar outros servios do DB2 (ou seja, a conta do servio deve pertencer ao grupo Usu rios Avanados), e possuir a autoridade DB2 SYSADM para qualquer instncia do DB2 a ser administrada. ------------------------------------------------------------------------ 49.15 Necess rio Fazer o Commit de Todos os Programas Definidos pelo Usu rio que sero Usados no Data Warehouse Center (DWC) Se voc deseja usar um procedimento armazenado construdo pelo DB2 Stored Procedure Builder como um programa definido pelo usu rio no Data Warehouse Center (DWC), voc dever inserir a seguinte instruo no procedimento armazenado antes da instruo con.close();: con.commit(); Se esta instruo no for inserida, as alteraes feitas pelo procedimento armazenado retrocedero quando o procedimento armazenado for executado a partir do DWC. Para todos os programas definidos pelo usu rio no DWC, necess rio fazer o commit explicitamente de qualquer funo do DB2 includa, para que as alteraes sejam efetivadas no banco de dados, ou seja voc deve incluir as instrues do COMMIT nos programas definidos pelo usu rio. ------------------------------------------------------------------------ 49.16 Armazenamento em Cache do Cliente no Windows NT Se um usu rio tentar acessar um arquivo de PERMISSO DE LEITURA DB que est localizado em uma m quina Windows NT Server, na qual os DB2 Datalinks esto instalados atravs de uma unidade compartilhada que usa um token v lido, o arquivo abrir conforme o esperado. No entanto, aps isso, solicitaes de abertura subseqentes que usam o mesmo token no alcanaro realmente o servidor, mas recebero servio a partir do cache no cliente. Mesmo aps o token expirar, o contedo do arquivo continuar a ser visvel para o usu rio, desde que a entrada ainda esteja no cache. No entanto, esse problema no ocorrer se o arquivo estiver localizado em uma estao de trabalho Windows NT. Uma soluo seria definir a entrada de registro \\HKEY_LOCAL_MACHINE\SYSTEM \CurrentControlSet\Services\Lanmanserver\Parameters\EnableOpLocks como zero no Windows NT server.Com essa definio de registro, sempre que um arquivo localizado no servidor for acessado a partir de uma estao de trabalho do cliente atravs de uma unidade compartilhada, a solicitao alcanar o servidor, em vez de receber o servio a partir do cache do cliente. Portanto, o token ser revalidado para todas as solicitaes. O impacto negativo dessa soluo que ela afeta o desempenho global de todo o acesso aos arquivos do servidor atravs das unidades compartilhadas. Mesmo com essa definio, se o arquivo for acessado atravs de um mapeamento da unidade compartilhada no prprio servidor, em oposio a uma m quina cliente diferente, parecer que a solicitao ainda recebe servio do cache. Portanto, a expirao do token no tem efeito. Nota: Em todos os casos, se o acesso ao arquivo for um acesso local e no atravs de uma unidade compartilhada, a validao do token e da expirao subseqente do token ocorrer conforme o esperado. ------------------------------------------------------------------------ |49.17 Life Sciences Data Connect |49.17.1 Novos Wrappers |No FixPak 4, dois novos wrappers foram includos no Life Sciences Data |Connect. Um para o Documentum no AIX e um para o Excel no Windows |NT. Alm disso, o wrapper de arquivos estruturado por tabela foi |transportado do AIX para o Windows NT, Solaris, Linux e HP-UX. |Para o FixPak 5, o wrapper BLAST no AIX foi includo no DB2 Life |Sciences Data Connect. O wrapper Documentum foi transportado do AIX |para o Windows NT, o Windows 2000 e o Solaris Operating |Environment. |Para o FixPak 6, o wrapper BLAST foi transportado do AIX para o |Windows NT, o Windows 2000, o HP-UX e o Solaris Operating |Environment. |49.17.2 Avisos- |Life Sciences Data Connect inclui cdigo para The Apache Software e |ICU. O cdigo fornecido "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA |DE NENHUM TIPO, SEJA EXPRESSA OU IMPLCITA, INCLUINDO, MAS NO SE LIMITANDO S |GARANTIAS DE MERCADO, ADEQUAÖO A UM DETERMINADO PROPSITO E |NO-VIOLAÖO. Alm disso, nenhuma obrigao de indenizao se aplica |IBM. |Licena para The Apache Software, Verso 1.1 |Copyright (c) 1999-2001 The Apache Software Foundation. |ICU 1.8.1 e posterior |Copyright (c) 1995-2001 International Business Machines Corporation e |outros. Todos os direitos reservados. ------------------------------------------------------------------------ 49.18 Melhorias no SQL Assist A ferramenta SQL Assist agora permite que o usu rio especifique um operador de juno diferente de "=" para junes de tabelas. O di logo Tipo de juno, que iniciado clicando no boto Tipo de juno na p gina Junes da ferramenta SQL Assist, foi melhorado para incluir uma lista drop down de operadores de juno. Os operadores disponveis so "=", "<>", "<", ">", "<=" e ">=". O SQL Assist uma ferramenta que ajuda o usu rio a criar instrues SQL simples. Ela est disponvel no Centro de comandos (guia Interativo), no Centro de controle (di logos Criar exibio e Criar disparo), no Stored Procedure Builder (assistente "Insero de SQL Stored Procedure") e no Data Warehouse Center (etapa Processo SQL). ------------------------------------------------------------------------ |49.19 Ajuda para Comandos de Backup e de Restaurao |As informae sincorretas aparecem quando voc digita db2 ? |backup. A sada correta : |BACKUP DATABASE database-alias [USER username [USING password]] |[TABLESPACE (tblspace-name [ {,tblspace-name} ... ])] [ONLINE] |[INCREMENTAL [DELTA]] [USE TSM [OPEN num-sess SESSIONS]] | |TO dir/dev [ {,dir/dev} ... ] | LOAD lib-name [OPEN num-sess SESSIONS]] |[WITH num-buff BUFFERS] [BUFFER buffer-size] [PARALLELISM n] |[WITHOUT PROMPTING] |As informae sincorretas aparecem quando voc digita db2 ? |restore. A sada correta : |RESTORE DATABASE source-database-alias { restore-options | CONTINUE | ABORT }"; | |restore-options:"; | [USER username [USING password]] [{TABLESPACE [ONLINE] |"; | TABLESPACE (tblspace-name [ {,tblspace-name} ... ]) [ONLINE] |"; | HISTORY FILE [ONLINE]}] [INCREMENTAL [ABORT]]"; | [{USE TSM [OPEN num-sess SESSIONS] |"; | FROM dir/dev [ {,dir/dev} ... ] | LOAD shared-lib"; | [OPEN num-sess SESSIONS]}] [TAKEN AT date-time] [TO target-directory]"; | [INTO target-database-alias] [NEWLOGPATH directory]"; | [WITH num-buff BUFFERS] [BUFFER buffer-size]"; | [DLREPORT file-name] [REPLACE EXISTING] [REDIRECT] [PARALLELISM n]"; | [WITHOUT ROLLING FORWARD] [WITHOUT DATALINK] [WITHOUT PROMPTING]"; ------------------------------------------------------------------------ 49.20 O "Warehouse Manager" Deveria Ser "DB2 Warehouse Manager" Todas as instncias da frase "Warehouse Manager" nas telas do produto e na sua documentao deveriam estar como "DB2 Warehouse Manager". ------------------------------------------------------------------------ Apndices ------------------------------------------------------------------------ Apndice A. Avisos possvel que a IBM no oferea os produtos, servios ou recursos discutidos neste documento em outros pases. Consulte um representante IBM local para obter informaes sobre produtos e servios disponveis atualmente em sua rea. Qualquer referncia a produtos, programas ou servios IBM no significa que apenas produtos, programas ou servios IBM possam ser utilizados. Qualquer produto, programa ou servio funcionalmente equivalente, que no infrinja nenhum direito de propriedade intelectual da IBM ou outros direitos legalmente protegidos, poder ser utilizado em substituio a este produto, programa ou servio. Entretanto, a avaliao e verificao da operao de qualquer produto, programa ou servio no-IBM so de responsabilidade do Cliente. A IBM pode ter patentes ou solicitaes de patentes pendentes relativas a assuntos discutidos nesta publicao. O fornecimento desta publicao no garante ao Cliente nenhum direito sobre tais patentes. Pedidos de licena devem ser enviados, por escrito, para: Gerncia de Relaes Comerciais e Industriais da IBM Brasil Av. Pasteur 138/146 Botafogo Rio de Janeiro - RJ Cep: 22240-290 Para pedidos de licena relacionados a informaes de duplo byte (DBCS), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu pas ou envie seus pedidos de licena, por escrito, para: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan O par grafo a seguir no se aplica a nenhum pas em que tais disposies no estejam de acordo com a legislao local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÖO "NO ESTADO EM QUE SE ENCONTRA" SEM GARANTIAS DE NENHUM TIPO, SEJA EXPRESSA OU IMPLCITA, INCLUINDO MAS NO SE LIMITANDO AS GARANTIAS IMPLCITAS DE NO-VIOLAÖO, MERCADO OU ADEQUAÖO A UM DETERMINADO PROPSITO. Alguns pases no permitem a excluso de garantias expressas ou implcitas em certas transaes; portanto, esta disposio pode no se aplicar ao Cliente. Estas informaes podem incluir imprecises tcnicas ou erros tipogr ficos. Periodicamente, so feitas alteraes nas informaes aqui contidas; tais alteraes sero incorporadas em futuras edies desta publicao. A IBM pode, a qualquer momento, aperfeioar e/ou alterar os produtos e/ou programas descritos nesta publicao, sem aviso prvio. Referncias nestas informaes a sites no-IBM na Web so fornecidas apenas por convenincia e no representam de forma alguma um endosso a estes sites na Web. Os materiais contidos nestes sites da Web no fazem parte dos materiais deste produto IBM e a utilizao destes sites da Web de inteira responsabilidade do Cliente. A IBM pode utilizar ou distribuir as informaes fornecidas da forma que julgar apropriada sem incorrer em qualquer obrigao para com o Cliente. Licenciados deste programa que desejam obter informaes sobre este assunto com objetivo de permitir: (i) a troca de informaes entre programas criados independentemente e outros programas (incluindo este) e (ii) a utilizao mtua das informaes trocadas, devem entrar em contato com : Gerncia de Relaes Comerciais e Industriais da IBM Brasil Av. Pasteur, 138/146 Botafogo Rio de Janeiro - RJ Cep: 22240-290 Tais informaes podem estar disponveis, sujeitas a termos e condies apropriadas, incluindo em alguns casos o pagamento de uma taxa. O programa licenciado descrito neste documento e todo o material licenciado disponvel so fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, do Contrato de Licena do Programa Internacional IBM ou de qualquer outro contrato equivalente. Todos os dados de desempenho aqui contidos foram determinados em um ambiente controlado. Portanto, os resultados obtidos em outros ambientes operacionais pode variar significativamente. Algumas medidas podem ter sido feitas em sistemas em nvel de desenvolvimentos e no h garantia de que estas medidas sero as mesmas nos sistemas disponveis em geral. Os resultados reais podem variar. Os usu rios deste documento devem verificar os dados aplic veis para seu ambiente especfico. Os resultados reais podem variar. Os usu rios deste documento devem verificar os dados aplic veis para seu ambiente especfico. As informaes relativas a produtos no-IBM foram obtidas junto aos fornecedores dos respectivos produtos, de seus anncios publicados ou de outras fontes disponveis publicamente. A IBM no testou estes produtos e no pode confirmar a preciso de seu desempenho, compatibilidade nem qualquer outra reivindicao relacionada a produtos no-IBM. Dvidas sobre os recursos de produtos no-IBM devem ser encaminhadas diretamente a seus fornecedores. Todas as declaraes relacionadas aos objetivos e intenes futuras da IBM esto sujeitas a alteraes ou cancelamento sem aviso prvio, e representam apenas metas e objetivos. Estas informaes contm exemplos de dados e relatrios utilizados nas operaes di rias de negcios. Para ilustr -los da forma mais completa possvel, os exemplos podem incluir nomes de indivduos, empresas, marcas e produtos. Todos estes nomes so fictcios e qualquer semelhana com nomes e endereos utilizados por uma empresa real mera coincidncia. LICENA DE COPYRIGHT: Estas informaes contm exemplos de programas aplicativos no idioma de origem, ilustrando as tcnicas de programao em diversas plataformas operacionais. Voc pode copiar, modificar e distribuir estes exemplos de programas sem a necessidade de pagar a IBM, com objetivos de desenvolvimento, utilizao, marketing ou distribuio de programas aplicativos em conformidade com a interface de programao do aplicativo para a plataforma operacional para a qual os programas de exemplo so criados. Estes exemplos no foram testados completamente em todas as condies. Portanto, a IBM no pode garantir ou implicar a confiabilidade, manuteno ou funo destes programas. Cada cpia ou parte deste exemplo de programas ou qualquer trabalho derivado deve incluir um aviso de copyright com os dizeres: (C)(C) (nome da empresa) (ano). Partes deste cdigo so derivadas do Exemplo de Programas da IBM Corp. (C) Copyright IBM Corp. 1997, 2000. Todos os direitos reservados. ------------------------------------------------------------------------ A.1 Marcas Os termos a seguir, que podem estar indicadas com um asterisco (*), so marcas da International Business Machines Corporation nos Estados Unidos e/ou em outros pases. ACF/VTAM IBM AISPO IMS AIX IMS/ESA AIX/6000 LAN DistanceMVS AIXwindows MVS/ESA AnyNet MVS/XA APPN Net.Data AS/400 OS/2 BookManager OS/390 CICS OS/400 C Set++ PowerPC C/370 QBIC DATABASE 2 QMF DataHub RACF DataJoiner RISC System/6000 DataPropagator RS/6000 DataRefresher S/370 DB2 SP DB2 Connect SQL/DS DB2 Extenders SQL/400 DB2 OLAP Server System/370 DB2 Universal Database System/390 Distributed Relational SystemView Database Architecture VisualAge DRDA VM/ESA eNetwork VSE/ESA Extended Services VTAM FFST WebExplorer First Failure Support TechnologyWIN-OS/2 Os termos a seguir so marcas ou marcas registradas de outras empresas: Microsoft, Windows e Windows NT so marcas ou marcas registradas da Microsoft Corporation. Java ou todas as marcas e logotipos baseados em Java e Solaris so marcas da Sun Microsystems, Inc. nos Estados Unidos e/ou em outros pases. Tivoli e NetView so marcas da Tivoli Systems Inc. nos Estados Unidos e/ou em outros pases. UNIX uma marca registrada nos Estados Unidos e/ou em outros pases e licenciada exclusivamente atravs da X/Open Company Limited. Outros nomes de empresas, produtos ou servios, que podem estar indicados com dois asteriscos (**), podem ser marcas ou marcas de servios de terceiros. ------------------------------------------------------------------------ Notas de rodap: 1 Um Service Policy define um conjunto de opes de qualidade de servio que devem ser aplicadas a essa operao de mensagens. Essas opes incluem a prioridade e a persistncia da mensagem. Consulte a publicao MQSeries Application Messaging Interface para obter detalhes adicionais. ------------------------------------------------------------------------ ndice remissivo A B C D E F G H I J L M N O P Q R S T U V W X ------------------------------------------------------------------------ A * acessando a ajuda (1057) * acessibilidade o atalhos do teclado (949) * acesso ao cliente remoto o configurao do Communication Server para NT (787) * Adobe Acrobat Reader o acesso com locales diferentes do ingls (777) * AIX o erros de instalao (801) o instalao do DB2 no (783) * AIX 4.3.3 o interrupo do AutoLoader aps bifurcao (910) * Ajuda (1058) * ajuda online (1059) * alta disponibilidade (843) * ambiente de satlite o administrando com a Verso 6 Centro de Administrao do Satlite (896) o consideraes de instalao (885) o instalao do arquivo de resposta do satlite (888) o instalao interativa do satlite (891) o pr-requisitos (879) o satlite do DB2 Personal Edition (877) o satlite do DB2 Workgroup Edition (878) * ambiente operacional Solaris o pesquisa de informaes online no (771) * Analisador de replicao (921) * aplicativos Unicode ODBC (1051) * rea de tabela o no raid (834) * arquivos de linguagem de marcao o definies de chaves (979) * arquivos PDF o acesso com locales diferentes do ingls (778) * AS/400 o capture e apply para (922) * assistente Criar banco de dados o definindo a extenso no (970) * assistente MQSeries Assist (972) * assistente OLE DB Assist (974) * Assistentes o Assistente OLE DB (975) o Criar Banco de Dados (971) o MQSeries Assist (973) * atalhos do teclado o problemas com (951) * atribuio de cadeias a colunas, regras de (1084) * atribuies o cadeias, regras b sicas para (1082) o data e hora, regras para valores de (1098) o data e hora para valor de cadeia (1100) * autenticao o por domnio utilizando DB2DOMAINLIST (1150) * AutoLoader o interrupo durante bifurcao (909) B * bancos de dados clones o criando (846) * bancos de dados particionados o erros ao incluir ns (858) * blocos de conjuntos de buffers (850) o exemplos (857) * bloqueio, otimista (1028) C * cadeia de caracteres o atribuio, viso geral (1081) * cadeia de caracteres de byte duplo (double-byte character string, DBCS) o cadeia retornada (1126) * cadeias de caracteres o cadeia de caracteres de byte duplo (1123) o funo escalar VARGRAPHIC (1122) * cadeias de data o definio (838) * cadeias de hora o definio (839) * cadeias de marca de hora o definio (840) * CAPTURE (definio LOGRETAIN) o backup e comportamento de restaurao (902) * capture e' apply o iniciar a partir de um aplicativo (927) * capture e apply o mensagens de erro (926) o no AS/400 (923) * Centro de Administrao do Satlite o Verso 6, utilizando para administrar o ambiente de satlite (895) * Centro de Controle o bloco de notas Definies da ferramenta (963) o correo necess ria para OS/390 (957) o deteco de problemas (958) o deteco de problemas em plataformas UNIX (959) o erros com o Internet Explorer (764) o fora de funcionamento (766) o na plataforma OS/390 (956) o problema de exibio infopops no OS/2 (960) o problemas no centro de script no Windows 95 (965) o restries em applets simultneos (964) o suporte bidirecional + no Windows NT (945) o utilizando com Chins Simplificado (760) o utilizando com Japons (761) o utilizando para administrar bancos de dados VM e VSE (944) o Verso 6, utilizando para administrar o ambiente de satlite (894) * Chins Simplificado o definio de locale no Linux (759) * CLI o escrita de um aplicativo Unicode (1010) o palavras-chave de configurao + CURRENTFUNCTION PATH (1034) + SKIPTRACE (1035) o procedimentos armazenados + v rios conjuntos de resultados (1009) o vantagens de (1008) * CLI0637E (1003) * clientes o ambiente em trs camadas (1015) o download (779) * clientes Unicode o limitao de movimento de dados (912) * coluna o atribuio de cadeia, regras b sicas para (1083) * comando db2iupdt, execuo aps atualizar o DB2 (795) * comandos o CREATE DATABASE (898) * concatenao o operador (1091) * conector SAP o Instalao (987) * conexes o aumentando taxas de transferncia de dados (1140) * conjuntos de buffers o com base em bloco (852) o com base em p gina (851) o p ginas contguas (855) * contedo da amostra, exibindo (967) * converso de caracteres o regras para comparar cadeias (1087) o regras para operaes que combinam cadeias (1085) * converses o cadeia de caracteres de byte duplo (1125) o cadeia de caracteres para data e hora (1118) o data e hora para vari vel de cadeia (1099) o DBCS de SBCS e DBCS mistos (1124) * CREATE DATABASE (899) * cursores o atributos, padro (1019) o atualiz vel (1022) o concorrncia (1023) o concorrncia de valores (1027) o desloc vel (1024) + detectando problemas em aplicativos (1029) + est tico (1013) + guiado por conjunto de teclas (1014) + lado do servidor (1012) + OS/390 (1011) o guiado por conjunto de teclas + atualizao (1026) o sensibilidade (1021) o tipo (1020) D * dados CLOB o funes do MQSeries (1078) * daemon de cpia (804) * Data Link Manager o mtodos de backup (906) * Data Links Manager o problemas em restaurar arquivos (808) * Data Warehouse Center o arquivos de linguagem de marcao (981) o definies de chaves (980) o utilizao de procedimentos armazenados (1156) * DataJoiner o restries (1152) * DATALINK o problemas ao restaurar (805) o replicao (917) * DB2_BINSORT (861) * DB2_BLOCK_BASED_BP (863) * DB2 control server o instalao do arquivo de resposta (883) o requisitos mnimos (882) o Verso 6, atualizando (893) * DB2 Enterprise Edition o configurando como satlite (874) + pr-requisitos (881) o Verso 6, utilizando como DB2 control server (892) * DB2_INLIST_TO_NLJN (865) * DB2_NEWLOGPATH (868) * DB2_NEWLOGPATH2 (870) o antigamente chamado de NEWLOGPATH2 (904) * DB2_PARALLEL_IO (836) * DB2 Personal Edition o configurando como satlite (873) + pr-requisitos (880) * DB2_REDUCED_ OPTIMIZATION (872) * DB2 Relational Connect o instalao do Windows NT (813) o instalao no Unix (814) * DB2_ROLLFORWARD_ NORETRIEVE * DB2 Server para VM e VSE o administrando o banco de dados a partir do Centro de controle (943) * db2ArchiveLog (1002) * db2move (908) * db2start o no Windows 95, 98 e ME (928) * definies de chaves o importao/exportao de metadados (978) * desempenho o no raid (835) * DFS Client Enabler o remoo da instalao (1148) * dlfm client_conf o motivos de falhas (807) * DWC7906, mensagem atualizada (977) E * E/S em vetor (854) * efetuando a vinculao dos utilit rios do banco de dados utilizando Cliente Run-Time (1004) * enable_MQFunctions (936), (938) * erro de acesso ao arquivo negado (953) * erro de atalho inv lido (947) * erros, instalao o AIX (799) * erros de instalao o AIX (800) * espelhamento dividido o como banco de dados principal (849) o como um banco de dados de espera (847) o como uma imagem de backup (848) * esperas de travas (931) * estruturas de tabelas (924) * etapa o planejamentos (984) * exibies o indisponvel aps a migrao (790) * expresso o operador de concatenao (1089) o string (1090) F * fazer backup o quando LOGRETAIN=CAPTURE (900) * ferramenta db2inidb (841) * Ferramenta de Movimentao de Banco de Dados (907) * ferramentas o utilizando no Linux (942) * ferramentas gui o erros de ligao (1143) * Fontes de dados Oracle o vari veis de ambiente (817) o wrapper do Linux (816) o wrapper do Solaris (815) * funo DATE o descrio detalhada (1102) o valor para a converso do formato de data (1103) * funo E/S suspensas o suportando disponibilidade contnua (842) * funo escalar DAYOFWEEK_ISO (1055) * funo escalar WEEK_ISO (1056) * funo GRAPHIC o descrio detalhada (1104) o valores e argumentos (1105) * funo MQPUBLISH o descrio detalhada (1061) o valores e argumentos (1062) * funo MQREADALLCLOB o descrio detalhada (1073) o valores e argumentos (1074) * funo MQREADCLOB o descrio detalhada (1064) o valores e argumentos (1065) * funo MQRECEIVEALLCLOB o descrio detalhada (1076) o valores e argumentos (1077) * funo MQRECEIVECLOB o descrio detalhada (1067) o valores e argumentos (1068) * funo MQSEND o descrio detalhada (1070) o valores e argumentos (1071) * funo SQLBindFileToParam CLI, correo (1036) * funo SQLColAttribute o SQL_DESC_AUTO_UNIQUE _VALUE (1039) o SQL_DESC_UPDATABLE (1040) * Funo SQLGetData (1041) * funo SQLGetInfo (1043) * funo SQLGetLength o DBCLOB (1045) * funo SQLNextResult (1046) * funo SQLSetEnvAttr o atributo SQL_ATTR_KEEPCTX (1048) * funo SQLSetStmtAttr o atributo SQL_ATTR_QUERY_ TIMEOUT (1050) * funo TIME o descrio detalhada (1107) o valores e argumentos (1108) * funo TIMESTAMP o descrio detalhada (1113) o valores e argumentos (1114) * funo VARGRAPHIC o descrio detalhada (1119) o valores e argumentos (1120) * funes o escalar + DATE (1101) + GRAPHIC (1106) + MQPUBLISH (1060) + MQREADCLOB (1063) + MQRECEIVECLOB (1066) + MQSEND (1069) + TIME (1109) + TIMESTAMP (1115) + VARGRAPHIC (1121) o no banco de dados Unicode (1095) o tabela + MQREADALLCLOB (1072) + MQRECEIVEALLCLOB (1075) * funes da CLI o SQLBindFileToParam (1037) o SQLColAttribute (1038) o SQLGetInfo (1042) o SQLGetLength (1044) o SQLNextResult (1047) o SQLSetStmtAttr (1049) * Funes do MQ (937), (939) * funes do MQSeries o suporte aos dados CLOB (1079) * funes escalares o DAYOFWEEK_ISO (1053) o WEEK_ISO (1054) G * gateways o ambiente em trs camadas (1016) * Gerenciador do Cat logo de Informaes o em hebraico (1153) o programa utilit rio (990) * GET ROUTINE (897) * GET_ROUTINE_SAR (1132) H * HP-UX o sem suporte para Query Enabler (1000) * HP-UX 11 o janelas de memria (1146) I * IDs do conjunto de buffers (856) * informaes online o pesquisando + ambiente operacional no Solaris (772) * incio do DB2 o utilizando db2start no Windows 95, 98 e ME (929) * instalao o conta de servios necess ria no Windows (1155) o DB2 Enterprise-Extended Edition no AIX (782) o interrompendo processos do DB2 durante (793) o travamento ao utilizar unidade removvel (788) * Instalao * instalao do arquivo de resposta o palavras-chave do DB2 control server (884) o palavras-chave especficas do satlite (889) * Instruo CREATE PROCEDURE o Instruo GET DIAGNOSTICS (1127) * Instruo GET DIAGNOSTICS (1128) * interbloqueios (930) * Internet Explorer o erros com o Centro de Controle (765) * iSeries, consideraes ps-instalao para o agente (994) * iSeries, utilizando transformadores com o agente do (995) J * janelas de memria o no HP-UX 11 (1145) * Japons o DB2 em PTX (763) o definio de locale no Linux (758) * JDBC o cursores desloc veis, acesso (1018) * JDK 1.1 o caminho de instalao (961) L * leitura dispersa (853) * Linux o definio do ambiente para o Centro de Controle (797) o definies de locale para Japons e Chins Simplificado (757) o executando ferramentas de administrao DB2 UBD (941) * locale o Japons e Chins Simplificado no Linux (756) * locales o Chins simplificado no Red Flag Linux (754) M * mensagens o para capture e apply (925) * mensagens de erro o acesso ao arquivo negado (954) o ao incluir ns em bancos de dados particionados (859) o arquivos de ligao no encontrados (1142) o atalho inv lido (948) o durante a migrao (802) o SQL10012N (962) * mtodo de backup o para Data Links Manager (905) * migrao o erros durante (803) o execuo do db2iupdt para atualizar instncias (796) o no Windows 2000 (785) o problemas com exibies (789) * Movimento de dados o limites de clientes Unicode (911) N * navegadores da web o recomendaes para Windows 2000 (767) * NetQuestion o utilizando TCP/IP no OS/2 (773) * Netscape o mensagens de erro (776), (968) o utilizao para acessar informaes online (768) * NEWLOGPATH2 o agora chamado de DB2_NEWLOGPATH2 (903) * nveis de correo o no Solaris verso 2.6 (781) * NUMA-Q o sem suporte para Query Enabler ou Tracker (1001) O * ODBC o cursores desloc veis, acesso (1017) o orientaes de busca (1025) * operando o string (1093) * origens de dados do Microsoft SQL Server o biblioteca MERANT (825) o controlador ODBC (824) o link ao DB2 (827) o melhorando o desempenho (828) o nome do DSN (830) o p ginas de cdigos (832) o rastreios do ODBC (831) o vari veis de ambiente (826) o wrappers MERANT (829) * origens de dados do Sybase (818) o link ao DB2 (821) o melhorando o desempenho (822) o p ginas de cdigos (823) o vari veis de ambiente (820) * OS/2 o instalando o Centro de Controle (952) o NetQuestion (774) P * perfilamento est tico em aplicativos JDBC/ODBC/CLI (1006) * perfilamento est tico JDBC/ODBC/CLI, limitaes (1005) * perfis de usu rios o alterando status do n (996) * pesquisa de descoberta (1144) * pesquisa de informaes online o ambiente operacional no Solaris (770) * planejamentos o duplicado (983) o etapa e processo (982) * pr-requisitos de instalao o para UDB EE e CEE no Linux para OS/390 (798) * Procedimento SQL o Instruo GET DIAGNOSTICS (1131) * procedimentos armazenados o no Data Warehouse Center (1157) * procedimentos armazenados CLI o ligao autom tica (1033) o limitaes (1032) * processo o planejamentos (985), (986) * processos, interrompendo antes da instalao (794) * prximo bloqueio da chave (932) * PTX o utilizando com Japons (762) * publicaes atualizadas o Application Building Guide (744) o Application Development Guide (746) o DB2 Warehouse Manager Installation Guide (751) o Manual Administrativo do Data Warehouse Center (749) o Manual do Administrador (745) o Recuperao de Dados e Guia e Referncia de Alta Disponibilidade (748) o Referncia a Comandos (747) o Referncia a Mensagem (750) o SQL reference (752) Q * Query Enabler o no suportado no HP-UX e NUMA-Q (999) * Query Patroller o perda de privilgios de usu rio aps a migrao (997) * Query Patroller Tracker o no suportado no NUMA-Q (998) R * raid o otimizao para (833) * recuperao de falha o utilizando a ferramenta db2inidb (844) * recursos de acessibilidade (1141) * Red Flag Linux o locale chins simplificado (755) * regras de converso o para comparaes de cadeias (1088) o para operaes que combinam cadeias (1086) * remoo da instalao o DB2 DFS Client Enabler (1147) * replicao o cen rios para (914) o com servidores no IBM (913) o DATALINK (916) o determinao de problemas na (920) o planejamento (918) o pr-requisito update-anywhere (919) o restries de nomes de colunas e tabela (915) * restaurao o problemas com colunas DATALINK (806) * restaurando arquivos o Data Links Manager (809) * restaurar o quando LOGRETAIN=CAPTURE (901) * Restries o Conector SAP (988) * RESULT_STATUS o Instruo GET DIAGNOSTICS (1129) * resultados de consultas, exibindo (966) * retornando data e hora de valores o funo TIMESTAMP (1116) * ROW_COUNT o Instruo GET DIAGNOSTICS (1130) S * satlites o consideraes de instalao (886) o DB2 Personal Edition (875) o DB2 Workgroup Edition (876) o instalao do arquivo de resposta (887) o instalao interativa (890) * sistema operacional Solaris o 64 bits + configurao (933) + restries (934) * sistemas federados o apelidos (811) o restries (812) o wrappers (810) * Sistemas Federados, restries (1151) * SNA Server o acesso ao UDB de aplicativos do host ou do AS/400 (786) * SNA SPM o verificao do incio aps inicializao (1154) * Solaris o falta de suporte para verses anteriores ao UltraSparc (753) o nvel de correo necess rio na V2.6 (780) * SQL, composto (1031) * SQL composto, utilizao (1030) * string o expresso (1092) o operando (1094) * suporte a NLV o Unicode (1136) * Suporte ao Idioma o Conector SAP (989) * suporte ao protocolo IPX/SPX, no Windows 2000 (792) * suporte bidirecional ao idioma o com o Centro de Controle no Windows NT (946) * Sybase o incompatibilidade com ICM no Windows (991) * Sybase Open Client (819) T * tabela o exceo + estrutura da coluna de mensagens (1134) * tabela de exceo o estrutura da coluna de mensagens (1133) * tamanho da extenso o definindo no assistente de criao do banco de dados (969) * taxas de transferncia o aumentando (1138) * taxas de transferncia de dados o aumentando (1139) * TCP/IP o NetQuestion (775) * teclas de acesso r pido o problemas com (950) * teste de conexo de atualizao multisite o incompatibilidade com a verso da instncia (955) * time o retornando data e hora de valores (1117) o retornando valores baseados em hora (1112) o utilizando hora em uma expresso (1111) * tipos de dados o promoo em um banco de dados Unicode (1080) * tipos de dados de data e hora o cadeia de representao de (1097) * tour r pido (976) * transformaes ADT (1007) * tratamento de espelhamento dividido o online (845) U * Unicode o atualizaes na documentao (1137) o banco de dados e aplicativos (1135) o em aplicativos ODBC (1052) o funes no (1096) * utilizando hora em uma expresso o funo TIME (1110) V * valores de data e hora o representaes de cadeia (837) * vari veis de ambiente o LD_ASSUME_KERNAL (940) * vari veis de registro o DB2_BINSORT (860) o DB2_BLOCK_BASED_BP (862) o DB2_INLIST_TO_NLJN (864) o DB2_NEWLOGPATH (866) o DB2_NEWLOGPATH2 (869) o DB2_REDUCED_ OPTIMIZATION (871) o DB2_ROLLFORWARD_ NORETRIEVE (867) o DB2DOMAINLIST (1149) W * warehouse, instalao de agentes do (993) * Windows o incompatibilidade entre Sybase e ICM (992) * Windows 2000 o migrao no (784) o navegadores da Web recomendados no (769) o suporte ao protocolo IPXX/SPX (791) X * XML extender o notas sobre o release (935)