Informatica PowerExchange (Versão 9.6.0) Guia do Usuário do Navegador

Transcrição

1 Informatica PowerExchange (Versão 9.6.0) Guia do Usuário do Navegador

2 Informatica PowerExchange Guia do Usuário do Navegador Versão Janeiro 2014 Copyright (c) Informatica Corporation. Todos os direitos reservados. Este software e a respectiva documentação contêm informações de propriedade da Informatica Corporation. Eles são fornecidos sob um contrato de licença que contém restrições quanto a seu uso e divulgação, e são protegidos por leis de copyright. A engenharia reversa do software é proibida. Não está permitida de forma alguma a reprodução ou a transmissão de qualquer parte deste documento (seja por meio eletrônico, fotocópia, gravação ou quaisquer outros) sem o consentimento prévio da Informatica Corporation. Este Software pode estar protegido por patentes dos EUA e/ou internacionais e outras patentes pendentes. O uso, duplicação ou divulgação do Software pelo Governo dos Estados Unidos estão sujeitos às restrições estipuladas no contrato de licença de software aplicável e como estabelecido em DFARS (a) e (a) (1995), DFARS (1)(ii) (OCT 1988), FAR (a) (1995), FAR ou FAR (ALT III), conforme aplicável. As informações contidas neste produto ou documentação estão sujeitas a alteração sem aviso prévio. Informe-nos por escrito caso encontre quaisquer problemas neste produto ou documentação. Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange, PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data Transformation, Informatica B2B Data Exchange Informatica On Demand, Informatica Identity Resolution, Informatica Application Information Lifecycle Management, Informatica Complex Event Processing, Ultra Messaging and Informatica Master Data Management são marcas comerciais ou marcas registradas da Informatica Corporation nos Estados Unidos e em jurisdisdições pelo mundo. Todos os outros nomes de outras companhias e produtos podem ser nomes ou marcas comerciais de seus respectivos proprietários. Partes desta documentação e/ou software estão sujeitas a direitos autorais de terceiros, incluindo sem limitação: Copyright DataDirect Technologies. Todos os direitos reservados. Copyright Sun Microsystems. Todos os direitos reservados. Copyright RSA Security Inc. Todos os direitos reservados. Copyright Ordinal Technology Corp. Todos os direitos reservados. Copyright Aandacht c.v. Todos os direitos reservados. Copyright Genivia, Inc. Todos os direitos reservados. Copyright Isomorphic Software. Todos os direitos reservados. Copyright Meta Integration Technology, Inc. Todos os direitos reservados. Copyright Intalio. Todos os direitos reservados. Copyright Oracle. Todos os direitos reservados. Copyright Adobe Systems Incorporated. Todos os direitos reservados. Copyright DataArt, Inc. Todos os direitos reservados. Copyright ComponentSource. Todos os direitos reservados. Copyright Microsoft Corporation. Todos os direitos reservados. Copyright Rogue Wave Software, Inc. Todos os direitos reservados. Copyright Teradata Corporation. Todos os direitos reservados. Copyright Yahoo! Inc. Todos os direitos reservados. Copyright Glyph & Cog, LLC. Todos os direitos reservados. Copyright Thinkmap, Inc. Todos os direitos reservados. Copyright Clearpace Software Limited. Todos os direitos reservados. Copyright Information Builders, Inc. Todos os direitos reservados. Copyright OSS Nokalva, Inc. Todos os direitos reservados. Copyright Edifecs, Inc. Todos os direitos reservados. Copyright Cleo Communications, Inc. Todos os direitos reservados. Copyright International Organization for Standardization Todos os direitos reservados. Copyright ej-technologies GmbH. Todos os direitos reservados. Copyright Jaspersoft Corporation. Todos os direitos reservados. Copyright é International Business Machines Corporation. Todos os direitos reservados. Copyright yworks GmbH. Todos os direitos reservados. Copyright Lucent Technologies. Todos os direitos reservados. Copyright (C) University of Toronto. Todos os direitos reservados. Copyright Daniel Veillard. Todos os direitos reservados. Copyright Unicode, Inc. Copyright IBM Corp. Todos os direitos reservados. Copyright MicroQuill Software Publishing, Inc. Todos os direitos reservados. Copyright PassMark Software Pty Ltd. Todos os direitos reservados. Copyright LogiXML, Inc. Todos os direitos reservados. Copyright Lorenzi Davide, todos os direitos reservados. Copyright Red Hat, Inc. Todos os direitos reservados. Copyright The Board of Trustees of the Leland Stanford Junior University. Todos os direitos reservados. Copyright EMC Corporation. Todos os direitos reservados. Copyright Flexera Software. Todos os direitos reservados. Copyright Jinfonet Software. Todos os direitos reservados. Copyright Apple Inc. Todos os direitos reservados. Copyright Telerik Inc. Todos os direitos reservados. Copyright BEA Systems. Todos os direitos reservados. Copyright PDFlib GmbH. Todos os direitos reservados. Copyright Orientation in Objects GmbH. Todos os direitos reservados. Copyright Tanuki Software, Ltd. All rights reserved. Copyright Ricebridge. Todos os direitos reservados. Copyright Sencha, Inc. All rights reserved. Este produto inclui software desenvolvido pela Apache Software Foundation ( e/ou outros softwares licenciados nas várias versões da Licença Apache (a "Licença"). Você pode obter uma cópia dessas Licenças em A menos que exigido pela legislação aplicável ou concordado por escrito, o software distribuído em conformidade com estas Licenças é fornecido "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA OU CONDIÇÃO DE QUALQUER TIPO, seja expressa ou implícita. Consulte as Licenças para conhecer as limitações e as permissões que regulam o idioma específico de acordo com as Licenças. Este produto inclui software desenvolvido pela Mozilla ( direitos autorais de software de The JBoss Group, LLC; todos os direitos reservados; direitos autorais de software de Bruno Lowagie e Paulo Soares e outros produtos de software licenciados sob a Licença Pública GNU Lesser General Public License Agreement, que pode ser encontrada em Os materiais são fornecidos gratuitamente pela Informatica, no estado em que se encontram, sem garantia de qualquer tipo, explícita nem implícita, incluindo, mas não limitando-se, as garantias implicadas de comerciabilidade e adequação a um determinado propósito. O produto inclui software ACE(TM) e TAO(TM) com copyright de Douglas C. Schmidt e seu grupo de pesquisa na Washington University, University of California, Irvine e Vanderbilt University, Copyright ( ) , todos os direitos reservados. Este produto inclui o software desenvolvido pelo OpenSSL Project para ser usado no kit de ferramentas OpenSSL (copyright The OpenSSL Project. Todos os direitos reservados) e a redistribuição deste software está sujeita aos termos disponíveis em e Este produto inclui o software Curl com o Copyright , Daniel Stenberg, <daniel@haxx.se>. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em É permitido usar, copiar, modificar e distribuir este software com qualquer objetivo, com ou sem taxa, desde que a nota de direitos autorais acima e esta nota de permissão apareçam em todas as cópias. O produto inclui direitos autorais de software ( ) MetaStuff, Ltd. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em O produto inclui o copyright de software , The Dojo Foundation. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui o software ICU com o copyright International Business Machines Corporation e outros. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui o copyright de software Per Bothner. Todos os direitos reservados. O direito de usar tais materiais é estabelecido na licença que pode ser encontrada em Este produto inclui o software OSSP UUID com Copyright 2002 Ralf S. Engelschall, Copyright 2002 e OSSP Project Copyright 2002 Cable & Wireless Deutschland. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui software desenvolvido pela Boost ( ou sob a licença de software Boost. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui direitos autorais de software University of Cambridge. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em

3 Este produto inclui o copyright de software 2007 The Eclipse Foundation. Todos os direitos reservados. As permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em e em Este produto inclui softwares licenciados de acordo com os termos disponíveis em License, license.html, asm.ow2.org/license.html, httpunit.sourceforge.net/doc/ license.html, license.html, license-agreement; /copyright-software ; forge.ow2.org/projects/javaservice/, license.html; protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto; current/doc/mitk5license.html. e Este produto inclui software licenciado de acordo com a Academic Free License ( a Common Development and Distribution License ( a Common Public License ( a Sun Binary Code License Agreement Supplemental License Terms, a BSD License ( a nova BSD License ( licenses/bsd-3-clause), a MIT License ( a Artistic License ( e a Initial Developer s Public License Version 1.0 ( Este produto inclui copyright do software Joe WaInes, XStream Committers. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em Este produto inclui software desenvolvido pelo Indiana University Extreme! Lab. Para obter mais informações, visite Este produto inclui software Copyright 2013 Frank Balluffi e Markus Moeller. Todos os direitos reservados. As permissões e limitações relativas a este software estão sujeitas aos termos da licença MIT. Este Software é protegido pelos Números de Patentes dos EUA 5,794,246; 6,014,670; 6,016,501; 6,029,178; 6,032,158; 6,035,307; 6,044,374; 6,092,086; 6,208,990; 6,339,775; 6,640,226; 6,789,096; 6,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,243,110; 7,254,590; 7,281,001; 7,421,458; 7,496,588; 7,523,121; 7,584,422; 7,676,516; 7,720,842; 7,721,270; 7,774,791; 8,065,266; 8,150,803; 8,166,048; 8,166,071; 8,200,622; 8,224,873; 8,271,477; 8,327,419; 8,386,435; 8,392,460; 8,453,159; 8,458,230; e RE44,478, Patentes internacionais e outras Patentes Pendentes. ISENÇÃO DE RESPONSABILIDADE: a Informatica Corporation fornece esta documentação no estado em que se encontra, sem garantia de qualquer tipo, expressa ou implícita, incluindo, mas não limitando-se, as garantias implícitas de não infração, comercialização ou uso para um determinado propósito. A Informatica Corporation não garante que este software ou documentação esteja sem erros. As informações fornecidas neste software ou documentação podem incluir imprecisões técnicas ou erros tipográficos. As informações deste software e documentação estão sujeitas a alterações a qualquer momento sem aviso prévio. AVISOS Este produto da Informatica (o "Software") traz determinados drivers (os "drivers da DataDirect") da DataDirect Technologies, uma empresa em funcionamento da Progress Software Corporation ("DataDirect"), que estão sujeitos aos seguintes termos e condições: 1. OS DRIVERS DA DATADIRECT SÃO FORNECIDOS NO ESTADO EM QUE SE ENCONTRAM, SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO LIMITANDO-SE, AS GARANTIAS IMPLÍCITAS DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UMA FINALIDADE ESPECÍFICA E NÃO INFRAÇÃO. 2. EM NENHUM CASO, A DATADIRECT OU SEUS FORNECEDORES TERCEIRIZADOS SERÃO RESPONSÁVEIS, EM RELAÇÃO AO CLIENTE FINAL, POR QUAISQUER DANOS DIRETOS, INDIRETOS, INCIDENTAIS, ESPECIAIS, CONSEQUENCIAIS OU DEMAIS QUE POSSAM ADVIR DO USO DE DRIVERS ODBC, SENDO OU NÃO ANTERIORMENTE INFORMADOS DAS POSSIBILIDADES DE TAIS DANOS. ESTAS LIMITAÇÕES SE APLICAM A TODAS AS CAUSAS DE AÇÃO, INCLUINDO, SEM LIMITAÇÕES, QUEBRA DE CONTRATO, QUEBRA DE GARANTIA, NEGLIGÊNCIA, RESPONSABILIDADE RIGOROSA, DETURPAÇÃO E OUTROS ATOS ILÍCITOS. Parte Número: PWX-NUG

4 Conteúdo Prefácio.... xi Recursos da Informatica.... xi Portal My Support da Informatica.... xi Documentação da Informatica.... xii Site da Informatica.... xii Biblioteca de Recursos da Informatica.... xii Base de Dados de Conhecimento da Informatica.... xii Canal de Suporte da Informatica no YouTube.... xii Informatica Marketplace.... xii Informatica Velocity.... xiii Suporte Global a Clientes da Informatica.... xiii Capítulo 1: Introdução ao Navegador do PowerExchange Visão Geral do Navegador do PowerExchange Incompatibilidades de Variável de Ambiente entre o PowerExchange e o PowerCenter Iniciando o Navegador do PowerExchange Interface do Navegador do PowerExchange Explorador de Recursos, Janela Recursos, Inspetor de Recursos e Outras Janelas Barra de Título Menus e Comandos Barra de ferramentas Teclas de Atalho Barra de Status Recursos do PowerExchange Abrindo um Recurso do PowerExchange Pesquisando um Recurso Fechando um Recurso do PowerExchange Excluindo um Recurso do PowerExchange Configuração de Recurso Adicionando ou Editando uma Configuração de Recurso Criando uma Configuração de Recursos Compartilhada Selecionando uma Configuração de Recurso como a Configuração Atual Excluindo uma Configuração de Recurso Preferências do Mapa de Dados Definindo Preferências do Mapa de Dados Definindo Preferências do Mapa de Dados IDMS Utilitário de Senha Criptografada Gerando uma Senha Criptografada Sumário i

5 Capítulo 2: Mapas de Dados Visão Geral de Mapas de Dados Nomes de Mapas de Dados Fontes de Dados Suportadas por Mapas de Dados Arquivos de Dados e Processamento de Lista de Arquivos Copybooks Field Definition Tables Adabas e Chaves Adabas Registros e Campos do Mapa de Dados Tabelas e Colunas de Mapa de Dados Arrays Páginas de Código Verificação de Dados Mapas de Dados Exportados Itens de Mapa de Dados Datacom Itens de Mapa de Dados IDMS Itens do Mapa de dados IMS Programas de Método de Acesso do Usuário Adicionando um Mapa de Dados Adicionando um Registro de Mapa de Dados Adicionando um Campo a um Registro Adicionando um Campo Definido pelo Usuário a um Registro Adicionando Itens a um Registro Datacom Adicionando um Elemento a um Registro Datacom Adicionando uma Chave a um Registro Datacom Adicionando um Segmento Chave a um Registro Datacom Adicionando Itens a um Registro IDMS Adicionando um Elemento CALC a um Registro IDMS Adicionando um Registro e Conjunto do Proprietário a um Registro IDMS Adicionando Itens a um registro do IMS Adicionando um Campo CCK a um Registro IMS Adicionando campos de pesquisa para um registro do IMS Adicionando uma Tabela de Mapa de Dados Adicionando uma Coluna a uma Tabela Exibindo Registros e Campos Exibindo Tabelas e Colunas Exibindo um Arquivo de Dados Ordenando Registros e Tabelas de Mapa de Dados Exibindo ou Editando Propriedades para um Mapa de Dados ou Itens em um Mapa de Dados Exibindo ou Editando Propriedades para um Mapa de Dados Exibindo ou Editando Propriedades para um Registro de Mapa de Dados Exibindo ou Editando Propriedades para um Campo em um Registro ii Sumário

6 Exibindo ou Editando Propriedades para um Elemento em um Registro Datacom Exibindo ou Editando Propriedades para uma Chave em um Registro Datacom Exibindo ou Editando Propriedades para um Segmento de Chave em um Registro Datacom.. 66 Exibindo ou Editando Propriedades para um Elemento CALC em um Registro IDMS Exibindo ou Editando Propriedades para um Registro do Proprietário e um Conjunto em um Registro IDMS Exibindo ou Editando Propriedades para um Campo CCK em um Registro de Lote IMS Exibindo ou Editando Propriedades para um Campo de Pesquisa em um Registro de Lote IMS Exibindo ou Editando Propriedades para uma Tabela de Mapa de Dados Exibindo ou Editando Propriedades para uma Coluna em uma Tabela Copiando, Recortando e Colando Itens em um Mapa de Dados Editando Informações de Logon para Acessar Mapas de Dados e Dados Enviando um Mapa de Dados para um Sistema Remoto Importando Mapas de Dados Enviados a um Sistema Remoto Associando Vários Arquivos de Dados a um Mapa de Dados Processamento de Lista de Arquivos do PowerExchange Regras de Sintaxe do Arquivo de Lista de Arquivos Criando um Arquivo de Lista de Arquivos e Associando-o a um Mapa de Dados Processamento ODBC e da Lista de Arquivos Exemplo de Arquivo de Lista de Arquivos para Linux, UNIX e Windows Exemplo de Arquivo de Lista de Arquivos no z/os Imprimindo um Mapa de Dados ou Itens em um Mapa de Dados Imprimindo um Mapa de Dados Imprimindo Registros de Mapa de Dados Imprimindo Campos em um Registro Imprimindo Tabelas de Mapa de Dados Imprimindo Colunas em uma Tabela Excluindo Mapas de Dados ou Itens em um Mapa de Dados Excluindo Mapas de Dados Excluindo Mapas de Dados Exportados para uma Sistema Remoto Excluindo Registros de Mapa de Dados Excluindo Campos de um Registro Excluindo Tabelas de Mapa de Dados Excluindo Colunas de uma Tabela Excluindo Elementos de um Registro Datacom Excluindo Chaves de um Registro Datacom Excluindo Segmentos de Chaves de um Registro Datacom Excluindo Elementos CALC de um Registro IDMS Excluindo Registros do Proprietário e Conjuntos de um Registro IDMS Excluindo campos CCK de um registro do IMS Excluindo campos de pesquisa de um registro do IMS Sumário iii

7 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas Visão Geral de Mapas de Dados para Fontes de Dados Específicas Mapas de Dados Adabas Adicionando um Mapa de Dados Adabas Adicionando uma Chave a uma Tabela em um Mapa de Dados Adabas Mapas de dados C-ISAM Adicionando um Mapa de dados C-ISAM Mapas de Dados Datacom Adicionando um Mapa de Dados Datacom Mapas de Dados do Catálogo do DB Adicionando um Mapa de Dados do Catálogo do DB Editando o Layout de Registro em um Mapa de Dados do DB Mapas de Dados do Arquivo de Descarregamento do DB Adicionando um Mapa de Dados do Arquivo de Descarregamento do DB Acessando Dados de Descarregamento do DB2 de Várias Tabelas Adicionando um Mapa de Dados do Arquivo de Descarregamento do DB2 - Exemplo Mapas de Dados IDMS Adicionando um Mapa de Dados IDMS Editando Propriedades de Registro IDMS Adicionando expressões para um Registro IDMS Mapas de Dados IMS Pré-requisitos para Adicionar um Mapa de Dados IMS Configurando Acesso em Lotes DL/I ou BMP a Dados IMS Configurando o acesso IMS ODBA a dados do IMS Configurando o Arquivo dbmover.cfg do PowerExchange no Windows Adicionando um Mapa de Dados IMS Exibindo Dados IMS Exibindo uma Hierarquia IMS Adicionando expressões para um registro do IMS Obtendo o RBA para um registro do IMS Editando Propriedades em um Mapa de Dados IMS Enviando um Mapa de Dados IMS para um Sistema Remoto Usando Transformações de Pesquisa para Pesquisar Dados em Bancos de Dados IMS Gravando Dados para um Banco de Dados IMS Exibindo ou Editando Opções IMS para uma Tabela Testando um Mapa de Dados IMS Exemplos do Mapa de Dados IMS Mapas de Dados SEQ Adicionando um Mapa de Dados SEQ Exibindo uma Hierarquia de Registros SEQ ou VSAM Mapas de Dados VSAM iv Sumário

8 Adicionando um Mapa de Dados VSAM Exibindo uma Hierarquia de Registros SEQ ou VSAM Aprimorando o Desempenho de Leitura em Massa para Conjuntos de Dados VSAM Obtendo o RRN ou RBA para Registros do Conjunto de Dados VSAM Capítulo 4: Copybooks Visão Geral de Copybooks Tipos de Copybook Suportados em Mapas de Dados Importando um Copybook para um Mapa de Dados Importando um Copybook para um Registro ou um Segmento Importando um FDT para um Mapa de Dados Adabas Exibindo e Atualizando o FDT para um Mapa de Dados Adabas Importar Copybook - Caixa de Diálogo Detalhes da Fonte Importar Copybook - Caixa de Diálogo Detalhes do Local Importar Copybook - Caixa de Diálogo Detalhes do Catálogo do DB2 Local Importar Copybook - Caixa de Diálogo Detalhes do Remoto Importar Copybook - Caixa de Diálogo Detalhes Datacom Remoto Importar Copybook - Caixa de Diálogo Detalhes do Catálogo do DB2 Remoto Caixa de Diálogo Seleção de Coluna do DB Caixa de Diálogo Propriedades Avançadas IDMS Caixa de Diálogo Importar Copybook - Detalhes de Configuração Caixas de Diálogo Definição de Registro e Definição de Registro Duplicado Capítulo 5: Grupos de Registro e Registros de Captura Visão Geral do Grupo de Registro e do Registro de Captura Nomes da Marca de Registro Grupos de Registro, Grupos de Extração e Grupos de Aplicativos Adicionando um Grupo de Registro Adicionando um Registro de Captura Opções de Status Opções de Condensação Exibindo um Registro de Captura Exibindo ou Editando Propriedades para um Grupo de Registro Exibindo ou Editando Propriedades para um Registro de Captura Exibindo Elementos para um Registro de Captura Datacom Exibindo Caminhos para um Registro de Captura IDMS Alterando as Colunas em um Registro de Captura Excluindo um Registro de Captura Excluindo um Grupo de Registros Excluindo Todos os Registros de Captura em um Grupo de Registro Capítulo 6: Grupos de Extração e Mapas de Extração Visão Geral de Grupos de Extração e Mapas de Extração Sumário v

9 Nomes de Mapa de Extração Adicionando um Grupo de Extração Adicionando um Mapa de Extração Exibindo um Mapa de Extração Adicionando ou Removendo Colunas Indicador de Mudança e Pré-imagem para uma Coluna de Dados Adicionando ou Removendo Colunas ao/do Processamento de Extração Alterando o Registro de Captura Associado a um Mapa de Extração Mesclando um Mapa de Dados com um Mapa de Extração Exibindo ou Editando Propriedades para um Grupo de Extração Exibindo Propriedades para um Mapa de Extração Criando um Mapa de Dados de um Mapa de Extração Excluindo um Mapa de Extração Excluindo um Grupo de Extração Excluindo Todos os Mapas de Extração em um Grupo de Extração Janela Definição de Extração - Guia Mapas Janela Definição de Extração - Guia Extensões Colunas Geradas pelo PowerExchange em Mapas de Extração Capítulo 7: Metadados Pessoais Visão Geral de Metadados Pessoais Adicionando um Perfil de Metadados Pessoais Exibindo Metadados para Tabelas em um Perfil de Metadados Pessoais Exibindo Propriedades para uma Tabela em um Perfil de Metadados Pessoais Exibindo ou Editando Propriedades para um Perfil de Metadados Pessoais Atualizando Metadados Pessoais Excluindo um Perfil de Metadados Pessoais Capítulo 8: Teste de Linha de Banco de Dados Visão Geral do Teste de Linha de Banco de Dados Exibindo ou Ocultando a Janela Saída do Teste de Linha de Banco de Dados Teste de Linha de Banco de Dados e Dados da Página de Códigos Não Padrão Testando um Mapa de Dados Testando um Mapa de Extração Testando um Perfil de Metadados Pessoais Emitindo Comandos do Ouvinte do PowerExchange em um Teste de Linha de Banco de Dados Gerando Tokens de Reinicialização para Captura de Dados Alterados Caixa de Diálogo Teste de Linha de Banco de Dados Caixa de Diálogo Parâmetros Avançados de CAPX Caixa de Diálogo Parâmetros Avançados de CAPXRT Caixa de Diálogo Parâmetros Avançados de DB2390IMG Caixa de Diálogo Parâmetros Avançados (IMS) vi Sumário

10 Capítulo 9: Exemplos do Navegador do PowerExchange Visão Geral de Exemplos do Navegador do PowerExchange Adicionando um Mapa de Dados de Registro Único - Exemplo Etapa 1. Adicionar um Mapa de Dados Etapa 2. Adicionar um Registro ao Mapa de Dados Etapa 3. Adicionar Campos ao Registro do Mapa de Dados Etapa 4. Adicionar uma Tabela ao Mapa de Dados Etapa 5. Testar o Mapa de Dados de Registro Único Adicionando um Mapa de Dados de Registro Único com um Array - Exemplo Etapa 1. Associar um Arquivo de Dados a um Mapa de Dados Etapa 2. Filtrar os Dados no Mapa de Dados Etapa 3. Criar uma Linha de Saída para Cada Elemento de um Array Etapa 4. Criar uma Linha de Saída para Todos os Elementos de um Array Adicionando um Mapa de Dados de Vários Registros com uma Tabela Complexa - Exemplo Etapa 1. Associar um Arquivo de Dados a um Mapa de Dados de Vários Registros Etapa 2. Exibir Registros em um Mapa de Dados de Vários Registros Etapa 3. Definir uma Hierarquia de Registros em um Mapa de Dados de Vários Registros Etapa 4. Testar um Mapa de Dados de Vários Registros Importando um Copybook COBOL para um Mapa de Dados - Exemplo Etapa 1. Adicionar um Mapa de Dados e Importar um Copybook COBOL para o Mapa de Dados Etapa 2. Aplicar uma Máscara de Data a um Campo no Registro de Mapa de Dados Etapa 3. Usar uma Cláusula WHERE para Filtrar um Registro Vazio da Saída Etapa 4. Exibir Várias Linhas de Saída para Itens em uma Cláusula OCCURS DEPENDING ON Importando um Copybook COBOL com Instruções REDEFINES - Exemplo Etapa 1. Adicionar um Mapa de Dados e Importar um Copybook COBOL com Instruções REDEFINES para o Mapa de Dados Etapa 2. Aplicar uma Máscara de Data a um Campo GROUP no Mapa de Dados Importando um Copybook PL/I - Exemplo Etapa 1. Adicionar um Mapa de Dados e Importar um Copybook PL/I para o Mapa de Dados 244 Etapa 2. Testar o Mapa de Dados Definindo Propriedades da Tabela em um Mapa de Dados para Normalizar um Array - Exemplo. 247 Etapa 1. Adicionar um Mapa de Dados que Contém um Array Definido com Várias Ocorrências Etapa 2. Adicionar Campos Definidos pelo Usuário que Demonstram a Normalização de um Array Etapa 3. Definir Propriedades da Tabela para Normalizar um Array Etapa 4. Testar a Normalização do Array no Mapa de Dados Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo Etapa 1. Adicionar um Mapa de Dados Etapa 2. Criar e Compilar o Programa de Saída do Usuário Sumário vii

11 Etapa 3. Adicionar Campos Definidos pelo Usuário Etapa 4. Atualizar Colunas da Tabela MASTER_REC Etapa 5. Testar os Resultados do Programa de Saída do Usuário Apêndice A: Funções do PowerExchange para Campos Definidos pelo Usuário Visão Geral de Funções do PowerExchange para Campos Definidos pelo Usuário Funções do PowerExchange CallProg Verificar Concat CopyData Fragmento GenVRowKey GetCurrentFileName GetDatabaseKey GetDataFlowType GetDbKey GetDbKeyOfOwner GetFullDbKey GetFullDbKeyOfOwner GetIMSRBAByLevel GetPageGroup GetPageGroupOfOwner GetPgGrpAndRdx GetPgGrpAndRdxOfOwner GetPgGrpOfOwner GetRadix GetRadixOfOwner GetSeqWithinLevel GetSeqWithinParent LengthOf LTrim RTrim SetBitA SetBitN Split Strip ToLower ToUpper Chamando Programas Definidos pelo Usuário com a Função CallProg Carregar Erros para Programas Definidos pelo Usuário Chamados pela Função CallProg Lista de Parâmetros Passada para Programas Definidos pelo Usuário viii Sumário

12 Códigos de Retorno de Programas Definidos pelo Usuário Programas Definidos pelo Usuário - Exemplos Programa COBOL - Exemplo Programa Assembler - Exemplo Programa RPG - Exemplo Programa PL/I - Exemplo Testando Campos Definidos pelo Usuário em um Mapa de Dados Apêndice B: Programas de Método de Acesso do Usuário Visão Geral dos Programas de Método de Acesso do Usuário Estrutura do Parâmetro Passada para o Programa de Método de Acesso do Usuário Códigos de Retorno do Programa do Método de Acesso do Usuário Programas de Método de Acesso do Usuário - Exemplos Apêndice C: Grupos de Aplicativos e Aplicativos Grupos de Aplicativos e Visão Geral dos Aplicativos Adicionando um Grupo de Aplicativos Exibindo ou Editando Propriedades para um Grupo de Aplicativos Redefinindo o Ponto de Início de Extração para um Aplicativo Excluindo um Grupo de Aplicativos Apêndice D: Propriedades do Mapa de Dados Propriedades do Mapa de Dados - Método de Acesso do ADABAS Propriedades do Mapa de Dados - Método de Acesso DATACOM Propriedades do Mapa de Dados - Método de Acesso DB Propriedades do Mapa de Dados - Método de Acesso DB2UNLD Caixa de Diálogo Filtro de Tabela do DB Filtro de Tabela do DB2 - Caixa de Diálogo Tabelas Disponíveis Propriedades do Mapa de Dados - Método de Acesso Lote DL/I ou IMS ODBA Propriedades do Mapa de Dados - Método de Acesso ESDS Propriedades do Mapa de Dados - Método de Acesso IDMS Propriedades do Mapa de Dados - Método de Acesso ISAM Propriedades do Mapa de Dados - Método de Acesso KSDS Propriedades do Mapa de Dados - Método de Acesso MQSeries Propriedades do Mapa de Dados - Método de Acesso RRDS Propriedades do Mapa de Dados - Método de Acesso SEQ Propriedades do Mapa de Dados - Método de Acesso TAPE Propriedades do Mapa de Dados - Método de Acesso USER Propriedades do Mapa de Dados - Padrões de Dados Propriedades do Mapa de Dados - Verificação de Dados Propriedades do Mapa de Dados - Saída do Nível de Registro Propriedades do Mapa de Dados - Chaves Sumário ix

13 Apêndice E: Propriedades do Registro, Campo e Tabela Propriedades do Registro - Nome Propriedades do Registro - Nome (Datacom) Propriedades do Registro - Nome (IDMS) Caixa de Diálogo Ordenar Detalhes do Elemento (IDMS) Propriedades do Registro - Detalhes da Importação Propriedades do Campo - Nome Propriedades do Campo - Array Campos Não Adabas Campos Adabas Propriedades do Campo - Propriedades Extras Propriedades do Campo - Verificação do Campo Propriedades do Campo - Página de Códigos Propriedades do Campo - Tamanho Variável Propriedades da Tabela - Definição Propriedades da Tabela - Filtro Propriedades da Tabela - Opções IMS Propriedades da Tabela - Chaves Caixa de Diálogo Localizar Apêndice F: Carimbos de Data/Hora DTL CAPXTIMESTAMP Carimbos de Data/Hora Que São Relatados no Campo DTL_CAPXTIMESTAMP por Fonte de Dados Índice x Sumário

14 Prefácio Esse guia descreve como usar o Navegador do PowerExchange para definir e gerenciar registros de captura, mapas de extração, mapas de dados e perfis de metadados pessoais. Este guia se aplica aos seguintes produtos PowerExchange: PowerExchange for Adabas PowerExchange for CA Datacom PowerExchange for CA IDMS PowerExchange for DB2 for i5/os e Arquivos Simples PowerExchange for DB2 for Linux, UNIX e Windows PowerExchange for DB2 for z/os PowerExchange para Arquivos Simples em Linux, UNIX e Windows PowerExchange for IMS PowerExchange for Oracle PowerExchange for SQL Server PowerExchange para VSAM (incluindo conjuntos de dados sequenciais) Este guia pressupõe que você instalou o Navegador do PowerExchange em um sistema Windows de 32 ou 64 bits usando o arquivo executável de instalação do Windows de 32 bits. Para obter mais informações, consulte o Guia de Instalação do PowerExchange. Recursos da Informatica Portal My Support da Informatica Como cliente da Informatica, você pode acessar o Portal My Support da Informatica em O site contém informações sobre produtos, informações sobre grupos de usuários, boletins informativos, acesso ao sistema de gerenciamento de casos de suporte a clientes da Informatica (ATLAS), à Biblioteca de Recursos da Informatica, à Base de Dados de Conhecimento da Informatica, à Documentação de Produtos da Informatica e à comunidade de usuários da Informatica. xi

15 Documentação da Informatica A equipe de Documentação da Informatica se esforça ao máximo para criar documentações precisas e utilizáveis. Se você tiver dúvidas, comentários ou ideias sobre esta documentação, entre em contato com a equipe de Documentação da Informatica pelo infa_documentation@informatica.com. Nós usaremos seu feedback para melhorar a documentação. Por favor, avise-nos se pudermos entrar em contato com você em relação aos comentários. A equipe de Documentação atualiza a documentação conforme o necessário. Para obter a documentação mais recente do seu produto, navegue para Documentação do Produto no endereço Site da Informatica Você pode acessar o site corporativo da Informatica no endereçohttp:// O site contém informações sobre a Informatica, seu histórico, eventos futuros e escritórios de vendas. Você também vai encontrar informações sobre parceiros e produtos. A área de serviços do site inclui informações importantes sobre suporte técnico, treinamento e educação, bem como serviços de implementação. Biblioteca de Recursos da Informatica Na qualidade de cliente da Informatica, você pode acessar a Biblioteca de Recursos da Informatica no endereço A Biblioteca de Recursos é uma coletânea de recursos que o ajuda a aprender mais sobre os produtos e recursos da Informatica. Ela inclui artigos e demonstrações interativas que apresentam soluções a problemas comuns, comparam recursos e comportamentos e o orienta na execução de tarefas específicas no mundo real. Base de Dados de Conhecimento da Informatica Na qualidade de cliente da Informatica, você pode acessar a Base de Dados de Conhecimento da Informatica no endereço Use a Base de Dados de Conhecimento para pesquisar soluções documentadas a problemas técnicos conhecidos sobre produtos da Informatica. Você também pode encontrar respostas a perguntas frequentes, white papers e dicas técnicas. Se você tiver dúvidas, comentários ou ideias sobre a Base de Dados de Conhecimento, entre em contato com a equipe da Base de Dados de Conhecimento da Informatica pelo KB_Feedback@informatica.com. Canal de Suporte da Informatica no YouTube Você pode acessar o canal de Suporte da Informatica no YouTube O canal de Suporte da Informatica no YouTube inclui vídeos sobre soluções que orientam você na execução de tarefas específicas. Em caso de dúvidas, comentários ou ideias sobre o canal de Suporte da Informatica no YouTube, entre em contato com a equipe de Suporte do YouTube por em supportvideos@informatica.com ou envie um tweet Informatica Marketplace O Informatica Marketplace é um fórum em que desenvolvedores e parceiros podem compartilhar soluções para aumentar, ampliar ou aprimorar implementações da integração de dados. Ao tirar proveito de qualquer uma das centenas de soluções disponíveis no Marketplace, você pode melhorar sua produtividade e agilizar o tempo de implementação em seu projeto. Você pode acessar o Informatica Marketplace através do link xii Prefácio

16 Informatica Velocity Você pode acessar o Informatica Velocity em Desenvolvido a partir da experiências reais em centenas de projetos de gerenciamento de dados, o Informatica Velocity representa o conhecimento coletivo de nossos consultores que trabalharam com organizações no mundo inteiro para planejar, desenvolver, implantar e manter soluções bem-sucedidas de Gerenciamento de Dados. Se você tiver dúvidas, comentários ou ideias sobre o Informatica Velocity, entre em contato com o Informatica Professional Services em ips@informatica.com. Suporte Global a Clientes da Informatica Você pode entrar em contato com o Centro de Suporte a Clientes por telefone ou pelo Suporte Online. O Suporte Online requer um nome de usuário e uma senha. Você pode solicitar um nome de usuário e uma senha no endereço Os números de telefone para o Suporte Global a Clientes da Informatica estão disponíveis no site da Informatica em Prefácio xiii

17 xiv

18 C A P Í T U L O 1 Introdução ao Navegador do PowerExchange Este capítulo inclui os seguintes tópicos: Visão Geral do Navegador do PowerExchange, 1 Incompatibilidades de Variável de Ambiente entre o PowerExchange e o PowerCenter, 2 Iniciando o Navegador do PowerExchange, 3 Interface do Navegador do PowerExchange, 3 Recursos do PowerExchange, 17 Configuração de Recurso, 21 Preferências do Mapa de Dados, 23 Utilitário de Senha Criptografada, 27 Visão Geral do Navegador do PowerExchange O Navegador do PowerExchange é uma Interface Gráfica do Usuário (GUI) executada no Windows. Use o Navegador do PowerExchange para definir e gerenciar objetos do PowerExchange, incluindo os recursos do PowerExchange necessários para executar operações de movimento de dados em massa e o processamento Change Data Capture (CDC). Execute testes de linha de banco de dados para verificar se o PowerExchange pode acessar dados quando uma operação de movimento de dados em massa ou uma extração de dados alterados é executada. Você também pode usar a caixa de diálogo Teste de Linha de Banco de Dados para emitir os comandos LISTTASK e STOPTASK do Ouvinte do PowerExchange e para gerar tokens de reinicialização para fontes de dados. Use os tokens de reinicialização para preencher o arquivo do token de reinicialização do PowerExchange Client for PowerCenter (PWXPC) para uma sessão Change Data Capture (CDC) do PowerCenter. Use os seguintes recursos do PowerExchange para executar operações de movimentação de dados em massa ou processamento do change data capture (CDC): Grupos de registro e registros de captura. Define os dados de origem para os quais você deseja que o PowerExchange capture mudanças. Necessário para executar o processamento CDC. Grupos de extração e mapas de extração. Define as informações de extração para fontes de dados registradas para captura. Necessário para executar o processamento CDC. 1

19 Mapas de dados. Define mapas de dados para acessar fontes de dados não relacionais, como bancos de dados IMS, arquivos VSAM e arquivos simples, e para executar o processamento de nível de coluna para fontes DB2. Para origens não relacionais, os mapas de dados são necessários para executar operações de movimentação de dados em massa e para especificar metadados para registros de captura. Em um mapa de dados, você pode definir manualmente o layout dos dados. Você pode importar um copybook ou um FDT Adabas, por exemplo, para definir o layout dos dados. Outros objetos do PowerExchange que você pode definir são: Grupos de aplicativos e aplicativos. Se você usar conexões ODBC para extrair dados alterados, define as informações de extração para a fonte de dados registrada para captura. O PowerExchange gera um grupo de aplicativos quando você define um grupo de registro. Nota: Os grupos de aplicativos e os aplicativos não serão usados se você usar o PowerExchange Client for PowerCenter (PWXPC) para extrair dados alterados, o que é recomendado. Perfis de metadados pessoais. Defina um perfil para testar a conectividade com uma fonte de dados, exibir metadados e visualizar dados para fontes de dados relacionais e não relacionais e destinos. Incompatibilidades de Variável de Ambiente entre o PowerExchange e o PowerCenter Quando o PowerCenter e o PowerExchange estão instalados na mesma máquina Linux, UNIX ou Windows, em determinados casos, há requisitos conflitantes para as variáveis de ambiente PATH e LD_LIBRARY_PATH. Para executar corretamente nesses casos, o PowerExchange e o PowerCenter devem ser executados em ambientes separados. Esse requisito se aplica quando o Serviço de Integração do PowerCenter ou o Serviço do Repositório do PowerCenter é executado na mesma máquina como um dos seguintes componentes do PowerExchange: Ouvinte do PowerExchange Agente de Log do PowerExchange para Linux, UNIX e Windows Navegador do PowerExchange Qualquer utilitário do PowerExchange 2 Capítulo 1: Introdução ao Navegador do PowerExchange

20 A seguinte tabela descreve as restrições que se aplicam às variáveis PATH e LD_LIBRARY_PATH nos ambientes do PowerExchange e do PowerCenter: Ambiente PATH LD_LIBRARY_PATH PowerExchange $INFA_HOME não deve anteceder $PWX_HOME. Caso contrário, você não poderá iniciar o Ouvinte ou o Agente de Log do PowerExchange da linha de comando. LD_LIBRARY_PATH não deve conter uma entrada para o PowerCenter. Esse requisito assegura que os utilitários do PowerExchange selecionem suas bibliotecas somente do $PWX_HOME. PowerCenter A entrada $PWX_HOME não deve anteceder a entrada $INFA_HOME. A definição de variável $LD_LIBRARY_PATH deve incluir $INFA_HOME e $PWX_HOME, e $INFA_HOME deve anteceder $PWX_HOME. Por exemplo: $INFA_HOME/server/bin:$PWX_HOME: $LD_LIBRARY_PATH Para definir o ambiente correto para as instâncias do PowerExchange ou do PowerCenter na mesma máquina, use uma das seguintes estratégias: Sempre inicie o PowerExchange e o PowerCenter usando contas de usuário separadas e defina as variáveis de ambiente apropriadas para cada conta. Execute o script pwxsettask.sh ou pwxsettask.bat sempre que iniciar um componente do PowerExchange. Iniciando o Navegador do PowerExchange Use o menu Iniciar para iniciar o Navegador do PowerExchange. Antes de iniciar o Navegador do PowerExchange, talvez você precise definir o ambiente do PowerExchange. 1. Se você precisar definir o ambiente do PowerExchange, emita o seguinte comando: pwxsettask setpwxenv 2. No menu Iniciar, inicie o Navegador do PowerExchange. Para obter mais informações, consulte Incompatibilidades de Variável de Ambiente entre o PowerExchange e o PowerCenter na página 2. Interface do Navegador do PowerExchange O Navegador do PowerExchange exibe recursos e informações de recursos do PowerExchange no Explorador de Recursos, janela Recursos, Inspetor de Recursos e, para recursos específicos, em outras janelas. Use a barra de menus, a barra de ferramentas e os menus de atalho do Navegador do PowerExchange para trabalhar com esses recursos. Iniciando o Navegador do PowerExchange 3

21 A imagem a seguir mostra a guia Recursos no Explorador de Recursos, a janela Recursos e os menus e a barra de ferramentas que você usa para definir e gerenciar recursos. 1. Barra de título 2. Barra de menus 3. Barra de ferramentas 4. Janela Recursos 5. Menu de atalho 6. Guia Recursos no Explorador de Recursos 7. Barra de status A GUI do Navegador do PowerExchange inclui os seguintes elementos específicos do recurso: A guia Grupo de Registro no Explorador de Recursos. A janela Registro de Captura. A barra de status, que exibe informações sobre o grupo de registro aberto e o registro de captura. 4 Capítulo 1: Introdução ao Navegador do PowerExchange

22 As guias Grupo de Registro e Registro de Captura no Inspetor de Recursos, que exibe informações para um grupo de registro aberto e registro de captura. Use as setas de alternância para alternar entre as guias Registro de Captura e Grupo de Registros no Inspetor de Recursos. A imagem a seguir mostra esses elementos: 1. Guia específica do recurso no Explorador de Recursos 2. A janela Registro de Captura 3. Barra de status 4. A guia Grupo de Registro no Inspetor de Recursos 5. A guia Registro de Captura no Inspetor de Recursos 6. Setas de alternância Explorador de Recursos, Janela Recursos, Inspetor de Recursos e Outras Janelas O Navegador do PowerExchange exibe recursos e informações de recursos do PowerExchange no Explorador de Recursos, janela Recursos e Inspetor de Recursos e, para recursos específicos, em outras janelas. As informações que são exibidas no Explorador de Recursos dependem de se um recurso do PowerExchange está aberto e qual tipo de recurso está aberto. Interface do Navegador do PowerExchange 5

23 Quando você inicia o Navegador do PowerExchange e antes de você abrir um recurso do PowerExchange, são exibidas as seguintes janelas: Explorador de Recursos. Exibido no lado esquerdo. Na guia Recursos, o Explorador de Recursos agrupa objetos em pastas em uma estrutura em árvore que pode ser expandida e reduzida para ajudá-lo a exibir definições de recursos do PowerExchange por categoria. As pastas são: - Captura de Dados e suas subpastas, Grupos de Aplicativos, Grupos de Extração e Grupos de Registro - Mapas de Dados - Metadados Pessoais A janela Recursos. Exibido no lado direito. Exibe os seguintes recursos definidos em uma exibição de lista ou de ícone: - Grupos de aplicativos, grupos de registro e grupos de extração - Mapas de dados - Perfis de metadados pessoais Você pode trabalhar com recursos do PowerExchange do Explorador de Recursos ou da janela Recursos. Quando você abre um grupo de registro, grupo de extração, mapa de dados ou perfil de metadados pessoais, o Explorador de Recursos exibe uma nova guia que lista os objetos no grupo, mapa de dados ou perfil. Além disso, quando você abre qualquer um dos seguintes recursos do PowerExchange, o Inspetor de Recursos é exibido no lado direito da interface e exibe propriedades para esse recurso: Grupos de aplicativos e aplicativos Grupos de registro e registros de captura Grupos de extração e mapas de extração Quando você abre um item em qualquer um desses grupos, como um registro de captura em um grupo de registro, tanto o registro quanto o grupo permanecem abertos ao mesmo tempo. É exibida uma janela específica para o item aberto, como a seguir: Janela Aplicativo. Exibe um aplicativo. Janela Registro de Captura. Exibe as colunas registradas por um registro de captura. Janela Definição de Extração. Exibe um mapa de extração. Além disso, o Inspetor de Recursos exibe uma guia para o grupo aberto e para o item aberto no grupo. Use as setas de alternância para alternar entre as guias no Inspetor de Recursos. A barra de status exibe informações sobre o grupo e o registro abertos. Quando você abre um registro em um mapa de dados, uma janela Registro exibe os campos no registro e permite que você adicione, altere ou exclua campos no registro. Quando você abre uma tabela em um mapa de dados, uma janela Tabela exibe as colunas na tabela e permite que você adicione, edite ou exclua colunas na tabela. Exibindo ou Ocultando o Explorador de Recursos ou o Inspetor de Recursos Você pode exibir ou ocultar o Explorador de Recursos ou o Inspetor de Recursos do menu Exibir. Por padrão, o Explorador de Recursos e o Inspetor de Recursos são exibidos. 6 Capítulo 1: Introdução ao Navegador do PowerExchange

24 Alterando o Tipo de Exibição para a Janela Recursos Você pode exibir recursos definidos na janela Recursos como ícones grandes ou pequenos ou em uma lista com ou sem detalhes de modificação usando o botão da barra de ferramentas Exibições. Organizando Janelas Você pode organizar janelas, como as janelas Recursos e Registro de Captura, de maneira sobreposta ou lado a lado no menu Janela. Você pode também alternar para uma janela aberta. A organização das janelas não afeta o posicionamento do Explorador de Recursos ou do Inspetor de Recursos. Barra de Título A barra de título do Navegador do PowerExchange está localizada na parte superior da GUI. A barra de título exibe o nome do aplicativo, Navegador do PowerExchange, potencialmente seguido de: Um nome de configuração de recurso, entre colchetes, se você tiver exibido ou editado uma configuração de recurso Um nome de janela, entre colchetes, se você tiver maximizado uma janela como a janela Recursos Menus e Comandos O Navegador do PowerExchange apresenta menus dos quais você seleciona comandos para definir e gerenciar recursos do PowerExchange e concluir outras tarefas. Os seguintes tipos de menus estão disponíveis: Menus na barra de menus. Clique no nome de um menu na barra de menus na parte superior da janela Navegador do PowerExchange para exibir uma lista de comandos. Menus de atalho. Clique com o botão direito do mouse em um recurso do PowerExchange para exibir um menu de atalho que contém os comandos apropriados para esse recurso. Menus na Barra de Menus Cada menu na barra de menus exibe uma lista de comandos. A barra de menus contém os seguintes menus: Arquivo Editar Adicionar Recurso Modo Exibir Opções Janela Ajuda Os comandos em cada um desses menus estão descritos abaixo. Interface do Navegador do PowerExchange 7

25 Menu Arquivo A tabela a seguir descreve os comandos do menu Arquivo e lista as teclas de atalho disponíveis para os comandos: Comando Descrição Tecla de Atalho Abrir Recurso Abre um recurso do PowerExchange. CTRL+O Fechar Recurso Fecha um recurso do PowerExchange. - Enviar para Nó Remoto Envia um mapa de dados para um sistema remoto. - Teste de Linha de Banco de Dados Abre a caixa de diálogo Teste de Linha de Banco de Dados. - Importar Copybook Importa um copybook para um mapa de dados. - Mapas de Dados Exportados Exibe uma lista dos mapas de dados exportados e permite que você os importe. - Exibir Arquivo de Dados Exibe o arquivo de dados associado a um mapa de dados. - Salvar Salva um mapa de dados, grupo de extração, mapa de extração, grupo de registro ou registro de captura. CTRL+S Salvar como Salva um mapa de dados com outro nome. - Imprimir Imprime um mapa de dados, registro, campo, tabela ou coluna. - Criptografar Senha Criptografa uma senha com texto não criptografado. - Atualizar Configuração Obsoleto. - Sair Sai do Navegador do PowerExchange. - Menu Editar A tabela a seguir descreve os comandos do menu Editar e lista as teclas de atalho disponíveis: Comando Descrição Tecla de Atalho Recortar Recorta um recurso e o move para a área de transferência. CTRL+X Copiar Copia um recurso para a área de transferência. CTRL+C 8 Capítulo 1: Introdução ao Navegador do PowerExchange

26 Comando Descrição Tecla de Atalho Colar Insere uma cópia do conteúdo da área de transferência no ponto de inserção. CTRL+V Localizar Localiza um dos seguintes itens: - Um campo em um registro em um mapa de dados. - Uma coluna em uma tabela em um mapa de dados. - Uma tabela em um perfil de metadados pessoais. - Uma coluna em uma tabela de metadados pessoais. CTRL+F Menu Adicionar A tabela a seguir descreve os comandos do menu Adicionar e lista as teclas de atalho disponíveis: Comando Descrição Tecla de Atalho Metadados Pessoais Adiciona um perfil de metadados pessoais. CTRL+T Mapa de Dados Adiciona um mapa de dados. CTRL+D Grupo de Registro Adiciona um grupo de registro. CTRL+G Grupo de Extração Adiciona um grupo de extração. CTRL+E Grupo de Aplicativos Adiciona um grupo de aplicativos. CTRL+L Registro Adiciona um registro ao mapa de dados selecionado. - Tabela Adiciona uma tabela ao mapa de dados selecionado. - Campo Adiciona um campo ao registro selecionado. - Coluna Adiciona uma coluna à tabela selecionada. - Registro de Captura Adiciona um registro de captura ao grupo de registro selecionado. - Definição de Extração Adiciona um mapa de extração ao grupo de extração selecionado. - Menu Recursos A tabela a seguir descreve os comandos do menu Recursos e lista as teclas de atalho disponíveis: Comando Descrição Tecla de Atalho Propriedades Exibe propriedades para o mapa de dados, registro, campo, tabela ou coluna selecionada. CTRL+P Excluir Exclui um recurso do PowerExchange. DELETE Interface do Navegador do PowerExchange 9

27 Comando Descrição Tecla de Atalho Logons FDT Permite que as informações de logon sejam digitadas para acessar mapas de dados e dados. Para um mapa de dados do Adabas, exibe a tabela de definição de campo (FDT) importada na caixa de diálogo FDT Adabas. Nota: Na caixa de diálogo FDT do Adabas, clique em Atualizar FDT para atualizar o FDT. - - Menu Modo A tabela a seguir descreve os comandos do menu Modo e lista as teclas de atalho disponíveis: Comando Descrição Tecla de Atalho Caractere Caractere/Hex Vertical ASCII EBCDIC Exibe registros em formato de caractere em uma exibição do arquivo de dados. Exibe registros em formato de caractere e hexadecimal em uma exibição do arquivo de dados. Exibe registros verticalmente em formato de caractere e hexadecimal em uma exibição do arquivo de dados. Exibe registros usando a codificação de caracteres ASCII (American Standard Code for Information Interchange) em uma exibição do arquivo de dados. Exibe registros usando a codificação de caracteres EBCDIC (Extended Binary Coded Decimal Interchange Code) em uma exibição do arquivo de dados Nota: Não há teclas de atalho disponíveis para esses comandos. Menu Exibir A tabela a seguir descreve os comandos do menu Exibir e lista as teclas de atalho disponíveis: Comando Descrição Tecla de Atalho Barra de ferramentas Exibe ou oculta a barra de ferramentas. - Barra de Status Exibe ou oculta a barra de status. - Explorador de Recursos Exibe ou oculta o Explorador de Recursos Capítulo 1: Introdução ao Navegador do PowerExchange

28 Comando Descrição Tecla de Atalho Saída Exibe ou oculta a janela Saída do Teste de Linha de Banco de Dados. - Inspetor de Recursos Exibe ou oculta o Inspetor de Recursos. - Nota: Não há teclas de atalho disponíveis para esses comandos. Menu Opções A tabela a seguir descreve os comandos do menu Opções e lista as teclas de atalho disponíveis: Comando Descrição Tecla de Atalho Configuração de Recursos Preferências Permite que você configure diretórios para recursos do PowerExchange. Permite que você configure preferências para mapas de dados. - - Nota: Não há teclas de atalho disponíveis para esses comandos. Menu Janela A tabela a seguir descreve os comandos do menu Janela e lista as teclas de atalho disponíveis: Comando Descrição Tecla de Atalho Cascata Organiza janelas de uma maneira sobreposta. - Lado a Lado Horizontalmente Organiza janelas de uma maneira não sobreposta. - Lado a Lado Verticalmente Organiza janelas lado a lado. - Organizar Ícones Organiza ícones de janelas fechadas. - Janelas abertas Exibe títulos de janelas abertas. Clique no título de uma janela para alternar para essa janela. - Nota: Não há teclas de atalho disponíveis para esses comandos. Interface do Navegador do PowerExchange 11

29 Menu Ajuda A tabela a seguir descreve os comandos do menu Ajuda e lista as teclas de atalho disponíveis: Comando Descrição Tecla de Atalho Conteúdo da Documentação Exibe a documentação do PowerExchange. - Tópicos da Ajuda Exibe a Ajuda para o Navegador do PowerExchange. F1 Sobre Exibe informações sobre versão para o Navegador do PowerExchange. - Menus de Atalho Um menu de atalho é exibido quando você clica com o botão direito do mouse em uma pasta ou recurso no Explorador de Recursos ou clica com o botão direito do mouse em um item em uma janela Registro ou Tabela. Os menus de atalho contêm os comandos apropriados para o item selecionado. Os menus de atalho estão disponíveis para os seguintes itens: Pastas na guia Recursos no Explorador de Recursos: - Captura de Dados e suas subpastas, incluindo Grupos de Aplicativos, Grupos de Extração e Grupos de Registro - Mapas de Dados - Metadados Pessoais Os recursos nas guias Explorador de Recursos ou em uma janela Registro ou Tabela: - Grupos de aplicativos e aplicativos - Grupos de extração e mapas de extração e as colunas em um mapa de extração - Grupos de registro e registros de captura - Mapas de dados e registros, campos, tabelas e colunas em um mapa de dados - Perfis de metadados pessoais e tabelas em perfis de metadados pessoais Há comandos disponíveis na barra de menus, no menu de atalho ou em ambos. As tabelas a seguir descrevem os comandos que estão disponíveis somente nos menus de atalho. Para ver outros comandos, consulte Menus na Barra de Menus na página 7. Grupos de Aplicativos e Aplicativos A tabela a seguir descreve os comandos para grupos de aplicativos e aplicativos que estão disponíveis somente nos menus de atalho: Clicar com o botão direito do mouse Um grupo de aplicativos aberto Comandos Redefinir para Novo Ponto de Partida. Redefine o ponto de início de extração para uma extração rastreada por um aplicativo. 12 Capítulo 1: Introdução ao Navegador do PowerExchange

30 Registros de Captura A tabela a seguir descreve os comandos para registros de captura que estão disponíveis somente nos menus de atalho: Clicar com o botão direito do mouse Um registro de captura aberto Comandos Corrigir Colunas. Adicione ou remova colunas de registros de captura para as fontes que suportam a captura de coluna seletiva. Exibir Elementos. Para origens de CDC síncrono do Datacom, exiba elementos de um registro Datacom, como deslocamento e tamanho. Esse comando não pertence ao CDC baseado em tabela do Datacom. Exibir Caminhos. Para origens do IDMS, exiba a hierarquia pai acima do registro base IDMS. Mapas de Dados A tabela a seguir descreve os comandos para mapas de dados que estão disponíveis somente nos menus de atalho: Clicar com o botão direito do mouse Um mapa de dados aberto Um mapa de dados IMS aberto O nome do campo em uma janela Registro. Um nome da coluna em uma janela Tabela Comandos Ordenar Itens. Ordene os registros e tabelas de um mapa de dados em ordem alfabética. Exibir Hierarquia IMS. Exiba a hierarquia IMS para um mapa de dados IMS. Adicionar Campo Antes. Adicione um campo a um registro antes de um campo selecionado. Adicionar Campo Depois. Adicione um campo a um registro depois de um campo selecionado. Adicionar Campo como Filho. Adicione um campo a um registro como um filho de um campo selecionado do tipo GROUP. Adicionar Campo no Final. Adiciona um campo no final de um registro. Adicionar Coluna Antes. Adicione uma coluna a uma tabela antes de uma coluna selecionada. Adicionar Coluna Depois. Adicione uma coluna a uma tabela depois de uma coluna selecionada. Adicionar Coluna no Final. Adicione uma coluna no final de uma tabela. Interface do Navegador do PowerExchange 13

31 Clicar com o botão direito do mouse Uma linha na guia Expr(n) de uma janela Registro Clique duas vezes em uma célula na coluna Expressão da guia Expr(n) de uma janela Registro Comandos Adicionar Campo Antes. Adicione um campo e uma expressão a este campo antes de um campo selecionado. Adicionar Campo Depois. Adicione um campo e uma expressão a este campo depois de um campo selecionado. Adicionar Campo no Final. Adicione um campo e uma expressão a este campo depois de um campo selecionado. Excluir Campo. Exclua um campo. Mover Campo para Cima. Mova um campo para cima na guia Expr(n) da janela Registro. Mover Campo para Baixo. Mova um campo para baixo na guia Expr(n) da janela Registro. Organizar Campos. Mova os campos preenchidos para a parte superior da lista na guia Expr(n) da janela Registro. Ocultar Colunas de Tipo. Oculte colunas de tipo na guia Expr(n) da janela Registro. Exibir Colunas de Tipo. Exiba colunas de tipo na guia Expr(n) da janela Registro. Restaurar Colunas. Restaure colunas na guia Expr(n) da janela Registro. Inserir o caractere de controle Unicode. Insira o caractere de controle Unicode em uma expressão. Ordem de Leitura da direita para a esquerda. Ative ou desative a ordem de leitura da direita para a esquerda para uma expressão. Exibir caracteres de controle Unicode. Exiba ou oculte caracteres de controle Unicode para uma expressão. Arquivos de Dados Associados a um Mapa de Dados A tabela a seguir descreve os comandos para arquivos de dados que estão disponíveis somente nos menus de atalho: Clicar com o botão direito do mouse Um registro selecionado em uma exibição de arquivo de dados Nota: Para mostrar uma exibição do arquivo de dados, abra um mapa de dados de uma origem de arquivo, clique com o botão direito no mapa de dados e selecione Propriedades, em seguida clique em Exibir Arquivo na guia de Método de Acesso. Comandos Exibir Escala. Exiba uma régua que marca o número de caracteres em um registro em um arquivo de dados. Ocultar Escala. Oculte a régua. 14 Capítulo 1: Introdução ao Navegador do PowerExchange

32 Grupos de Extração e Mapas de Extração A tabela a seguir descreve os comandos para grupos de extração e mapas de extração que estão disponíveis somente nos menus de atalho: Clicar com o botão direito do mouse Um mapa de extração aberto Uma coluna em um mapa de extração Comandos Corrigir Registros de Captura. Altere o registro de captura associado ao mapa de extração. Corrigir Extensões de Indicador de Alteração/Pré-Imagens. Adicione ou remova as colunas indicador de alteração e pré-imagem de um mapa de extração. Criar Mapa de Dados. Crie um mapa de dados de um mapa de extração. Corrigir Extensões de Indicador de Alteração/Pré-Imagens. Adicione ou remova as colunas indicador de alteração (CI) e pré-imagem (BI) de um mapa de extração. Exibir Colunas Geradas Automaticamente. Exiba as colunas geradas pelo PowerExchange em um mapa de extração. Metadados Pessoais A tabela a seguir descreve os comandos para perfis de metadados pessoais e as tabelas que estão disponíveis somente nos menus de atalho: Clicar com o botão direito do mouse Um o perfil de metadados pessoais aberto Uma tabela em um perfil de metadados pessoal. Comandos Atualizar. Atualiza os dados que são exibidos em um perfil de metadados pessoal. Explorar. Exibe metadados da tabela na janela Tabela. Barra de ferramentas Use a barra de ferramentas na parte superior da GUI do Navegador do PowerExchange para iniciar rapidamente tarefas comuns, em vez de selecionar comandos da barra de menus ou dos menus de atalho. Depois que você abre um recurso do PowerExchange, a barra de ferramentas é alterada para exibir os botões da barra de ferramentas apropriada para esse tipo de recurso. Se você apontar para um botão da barra de ferramentas, seu nome será exibido em um pop-up e sua descrição será exibida na barra de status. Exibindo ou Ocultando a Barra de Ferramentas Você pode exibir ou ocultar a barra de ferramentas. Por padrão, a barra de ferramentas é exibida. Para exibir ou ocultar a barra de ferramentas: u Clique em Exibir > Barra de Ferramentas. Teclas de Atalho Use teclas de atalho para iniciar tarefas. Interface do Navegador do PowerExchange 15

33 A tabela a seguir descreve teclas de atalho: Tecla de Atalho CTRL+L CTRL+D CTRL+E CTRL+G CTRL+T CTRL+F6 ALT+F4 CTRL+C CTRL+X DELETE SHIFT+F1 CTRL+P F1 ESC CTRL+F CTRL+V INSERT CTRL+Seta para cima CTRL+Seta para baixo Uso Adicionar um grupo de aplicativos. Adicionar um mapa de dados. Adicionar um grupo de extração. Adicionar um grupo de registro. Adicionar um perfil de metadados pessoais. Fechar uma janela Registro ou Tabela. Primeiro, selecione um campo ou uma coluna na janela. Fechar uma caixa de diálogo ativa ou sair do Navegador do PowerExchange. Copiar um recurso para a área de transferência. Recortar um recurso e movê-lo para a área de transferência. Excluir um dos seguintes itens: - Recurso do PowerExchange - Campo selecionado em uma janela Registro ou coluna em uma janela Tabela e todas as suas referências cruzadas Exibe Ajuda online para um item. Exibir propriedades para o mapa de dados, registro, campo, tabela ou coluna selecionada. Exibir a Ajuda para o Navegador do PowerExchange. Sair de uma operação de edição, como a digitação de informações em uma célula para um campo definido pelo usuário em um registro, sem fazer mudanças. Localizar um dos seguintes itens: - Um campo em um registro em um mapa de dados. - Uma coluna em uma tabela em um mapa de dados. - Uma tabela em um perfil de metadados pessoais. - Uma coluna em uma tabela de metadados pessoais. Inserir uma cópia do conteúdo da área de transferência no ponto de inserção. Inserir um campo ou coluna acima do campo ou coluna selecionada em uma janela Registro ou Tabela. Mover um campo definido pelo usuário para cima na guia Expr(n) em uma janela Registro. Mover um campo definido pelo usuário para cima na guia Expr(n) em uma janela Registro. 16 Capítulo 1: Introdução ao Navegador do PowerExchange

34 Tecla de Atalho Teclas de setas CTRL+O CTRL+S Uso Mover para cima ou para baixo em campos e campos definidos pelo usuário em uma janela Registro ou colunas em uma janela Tabela. Abrir um recurso do PowerExchange. Salvar um mapa de dados, grupo de extração, mapa de extração, grupo de registro ou registro de captura. Barra de Status A barra de status na parte inferior da GUI do Navegador do PowerExchange exibe o status do processamento e informações sobre qualquer recurso aberto do PowerExchange. A barra de status exibe as seguintes informações: O status do processamento, uma descrição do comando de menus ou botão da barra de ferramentas para o qual você está apontando O tipo e o nome de qualquer recurso aberto do PowerExchange Se nenhum recurso estiver aberto, será exibido o seguinte texto: Resouce Open : None A localização do nó de um recurso aberto, como o nó da localização remota na qual reside um registro de captura Para metadados pessoais, o tipo de fonte de dados do perfil de metadados pessoais Exibindo ou Ocultando a Barra de Status Você pode exibir ou ocultar a barra de status. Por padrão, a barra de status é exibida. Para exibir ou ocultar a barra de status: u Clique em Exibir > Barra de Status. Recursos do PowerExchange Use o Navegador do PowerExchange para definir e gerenciar os recursos do PowerExchange que são necessários para executar operações de movimentação de dados em massa e o processamento do change data capture (CDC). Esses recursos incluem: Grupos de registro e registros de captura Grupos de extração e mapas de extração Mapas de dados e os itens nos mapas de dados incluindo registros, tabelas e outros itens Grupos de aplicativos e aplicativos Nota: Os grupos de aplicativos e os aplicativos não serão usados se você usar o PowerExchange Client for PowerCenter (PWXPC) para extrair dados alterados, o que é recomendado. Recursos do PowerExchange 17

35 Perfis de metadados pessoais Abrindo um Recurso do PowerExchange Para exibir ou editar propriedades para um recurso do PowerExchange, você deve primeiro abrir o recurso do Explorador de Recursos ou da janela Recursos. Nota: Pode ser aberto um tipo de recurso de cada vez com a exceção de grupos e itens em grupos. Quando você abre um grupo, como um grupo de registro, e abre um registro de captura no grupo, o registro e o grupo são abertos ao mesmo tempo. Para todos os outros tipos de recursos do PowerExchange, quando você abre um recurso, o PowerExchange fecha qualquer outro recurso aberto. Você pode abrir mapas de dados, perfis de metadados pessoais e grupos de aplicativos, extração e registro do Explorador de Recursos ou da janela Recursos. Abra aplicativos, mapas de extração e registros de captura do Explorador de Recursos. Nota: Você não poderá editar a configuração do recurso se um recurso do PowerExchange estiver aberto. Para abrir um recurso do PowerExchange: u No Explorador de Recursos, clique com o botão direito do mouse no recurso e clique em Abrir. O Explorador de Recursos exibe uma guia para o recurso. A barra de status exibe o tipo e o nome do recurso aberto. Se o recurso for de captura de dados, o Inspetor de Recursos exibirá as propriedades do recurso. Pesquisando um Recurso Você pode usar o recurso Localizar para digitar os critérios de pesquisa para pesquisar um recurso específico. Você pode pesquisar uma tabela em um perfil de metadados pessoais, um campo em um registro do mapa de dados ou uma coluna em uma tabela do mapa de dados, uma tabela do perfil de metadados pessoais, registro de captura ou mapa de extração. Você pode incluir caracteres curinga para a pesquisa. Os caracteres curinga padrão são: Um asterisco (*) representa um ou mais caracteres de correspondência. Um ponto de interrogação (?) representa um caractere de correspondência. Dica: Se um campo de pesquisa contiver caracteres curinga no nome, coloque o caractere de escape antes dos caracteres curinga no nome. Por padrão, o caractere de escape é o til (~). Clique na seta à direita de uma caixa de critérios de pesquisa para inserir caracteres curinga ou o caractere de escape nos critérios de pesquisa. Clique em Avançado para alterar os caracteres curinga ou o caractere de escape. Pesquisando um Campo em um Registro do Mapa de Dados Você pode pesquisar um campo em um registro em um mapa de dados. 1. Abra o mapa de dados e o registro. 2. Clique em qualquer lugar na janela Registro. 3. Clique em Editar > Localizar. 4. Na caixa de diálogo Localizar campo no registro, digite os critérios de pesquisa. 18 Capítulo 1: Introdução ao Navegador do PowerExchange

36 5. Clique em Localizar Próxima. O Navegador do PowerExchange localiza o primeiro campo no registro que corresponde aos critérios de pesquisa. Pesquisando uma Coluna em uma Tabela do Mapa de Dados Você pode pesquisar uma coluna em uma tabela em um mapa de dados. 1. Abra o mapa de dados e a tabela. 2. Clique em qualquer lugar na janela Tabela. 3. Clique em Editar > Localizar. 4. Na caixa de diálogo Localizar coluna na tabela, digite os critérios de pesquisa. 5. Clique em Localizar Próxima. O Navegador do PowerExchange localiza a primeira coluna na tabela que corresponde aos critérios de pesquisa. Pesquisando uma Coluna em um Registro de Captura Você pode pesquisar uma coluna em um registro de captura. 1. Abra o grupo de registro e o registro de captura. 2. Clique em qualquer lugar na janela Tabela. 3. Clique em Editar > Localizar. 4. Na caixa de diálogo Localizar Coluna no Registro de Captura, digite os critérios de pesquisa. 5. Clique em Localizar Próxima. O Navegador do PowerExchange localiza a primeira coluna no registro de captura que corresponde aos critérios de pesquisa. Pesquisando uma Coluna em um Mapa de Extração Você pode pesquisar uma coluna em um mapa de extração. 1. Abra o grupo e o mapa de extração. 2. Clique em qualquer lugar na janela Tabela. 3. Clique em Editar > Localizar. 4. Na caixa de diálogo Localizar nome na Definição de Extração, digite os critérios de pesquisa. 5. Clique em Localizar Próxima. O Navegador do PowerExchange localiza a primeira coluna no mapa de extração que corresponde aos critérios de pesquisa. Pesquisando uma Tabela em um Perfil de Metadados Pessoais Você pode pesquisar uma tabela em um perfil de metadados pessoais. 1. Abra o perfil de metadados pessoais. 2. Clique em Editar > Localizar. 3. Na caixa de diálogo Localizar tabela, digite os critérios de pesquisa. Recursos do PowerExchange 19

37 4. Clique em Localizar Próxima. O Navegador do PowerExchange localiza a primeira tabela no perfil que corresponde aos critérios de pesquisa. Pesquisando uma Coluna em uma Tabela em um Perfil de Metadados Pessoais Você pode pesquisar uma coluna de uma tabela em um perfil de metadados pessoais. 1. Abra o perfil de metadados pessoais. 2. Abra a tabela na qual você deseja localizar uma coluna. 3. Clique em qualquer lugar na janela Tabela. 4. Clique em Editar > Localizar. 5. Na caixa de diálogo Localizar coluna na tabela, digite os critérios de pesquisa. 6. Clique em Localizar Próxima. O Navegador do PowerExchange localiza a primeira coluna na tabela que corresponde aos critérios de pesquisa. Fechando um Recurso do PowerExchange Para excluir um recurso ou para exibir ou editar a configuração do recurso, você deve fechar qualquer recurso aberto do PowerExchange. Nota: Se um recurso do PowerExchange estiver aberto quando você abrir outro recurso, o PowerExchange fechará o primeiro recurso, a não ser que o primeiro recurso seja um grupo de captura de dados e o segundo recurso seja um item no grupo. Por exemplo, se você abrir um grupo de registro e um registro de captura, os dois recursos permanecerão abertos ao mesmo tempo. Para fechar um recurso do PowerExchange: u No Explorador de Recursos, clique com o botão direito do mouse no recurso e clique em Fechar. Excluindo um Recurso do PowerExchange Você pode excluir recursos e itens do PowerExchange dos mapas de dados. Você pode excluir os seguintes recursos do PowerExchange: registros de captura Mapas de extração Grupos de aplicativos, grupos de extração e grupos de registros Mapas de dados Mapas de dados exportados Perfis de metadados pessoais Você também pode excluir os seguintes itens de um mapa de dados: Registros Campos de um registro Tabelas Colunas de uma tabela 20 Capítulo 1: Introdução ao Navegador do PowerExchange

38 Para mapas de dados para as seguintes fontes de dados, você também pode excluir os seguintes itens de registros: Datacom. Elementos, chaves e segmentos de chaves. IDMS. Elementos CALC e registros e conjuntos do proprietário. IMS. Campos CCK e campos de pesquisa. Antes de poder excluir um mapa de dados, perfil de metadados pessoais, registro de captura, mapa de extração ou um grupo, você deve fechar qualquer recurso aberto. Excluir determinados tipos de recursos pode afetar outros recursos. Por exemplo, quando você exclui um campo ou um registro, o PowerExchange exclui todas as referências ao campo ou ao registro. Quando você exclui um registro de captura, não pode mais extrair mudanças usando os mapas de extração associados ao registro de captura. Configuração de Recurso Uma configuração de recurso do Navegador do PowerExchange define a localização de mapas de dados, perfis de metadados pessoais e quaisquer registros de captura e mapas de extração armazenados localmente. Se você estiver iniciando o Navegador do PowerExchange pela primeira vez, será exibida a caixa de diálogo Configuração de Recurso - Configuração Atual. Clique em OK para criar uma configuração de recurso denominada Padrão no seguinte diretório padrão: c:/informatica/powerexchangev.r.m/examples Você pode adicionar ou editar uma configuração de recurso. Se você definir várias configurações de recursos, selecione uma configuração de recurso específica como a configuração atual. Você pode excluir qualquer configuração, exceto a configuração atual. Adicionando ou Editando uma Configuração de Recurso Você pode adicionar ou editar uma configuração de recurso no Navegador do PowerExchange. Se você instalou anteriormente o Navegador do PowerExchange e existirem entradas de registro para essa instalação, conclua as etapas a seguir para adicionar ou editar uma configuração de recurso. 1. Clique em Opções > Configuração de Recurso. 2. Na caixa de diálogo Configuração de Recurso, clique na guia Editar Configuração. 3. Execute uma das seguintes ações: Para adicionar uma configuração de recurso, clique em Adicionar. Para editar uma configuração de recurso, selecione uma configuração na lista Configurações Disponíveis e clique em Editar. 4. Na caixa de diálogo Editar Configuração ou Adicionar Configuração, digite informações sobre a configuração de recurso. Configuração de Recurso 21

39 A tabela a seguir descreve as informações a serem inseridas: Opção Nome Caminho Local Caminho Compartilhado Definir como configuração atual Descrição Um nome definido pelo usuário para a configuração de recurso. Para uma configuração de recurso local, digite a localização do diretório para mapas de dados e outros recursos do PowerExchange ou clique no botão Procurar para buscar o diretório. Para uma configuração de recurso compartilhado, digite a localização do diretório de mapas de dados compartilhados ou clique no botão Procurar para buscar o diretório. O valor Caminho Compartilhado deve ser diferente do valor Caminho Local. Como a barra dupla invertida (\\) não é uma sequência de caracteres válida em um nome de caminho do PowerExchange, você deve primeiro mapear uma unidade de rede para o caminho compartilhado. Na caixa de diálogo Adicionar Configuração, defina a configuração de recurso como a configuração atual. O padrão é selecionado. 5. Clique em OK. 6. Clique em OK. A barra de títulos da GUI exibe a configuração de recurso ativa. Por exemplo, se você editar a Configuração de recurso padrão, a barra de títulos exibirá o nome do aplicativo e a configuração de recurso, da maneira a seguir: PowerExchange Navigator - [Default] Criando uma Configuração de Recursos Compartilhada Você pode armazenar mapas de dados em um diretório compartilhado. Vários usuários podem acessar um mapa de dados compartilhado, mas o mapa de dados é protegido contra atualizações simultâneas. O primeiro usuário a acessar o mapa de dados compartilhado tem acesso total, mas os usuários simultâneos subsequentes não podem concluir as seguintes ações: Renomear, editar ou excluir o mapa de dados Importar um mapa de dados exportado ou enviar o mapa de dados para um nó remoto Testar o mapa de dados Se você tentar abrir um mapa de dados compartilhado que já está aberto por outro usuário, será exibida uma mensagem de aviso. 1. Clique com o botão direito do mouse em Meus Locais de Rede e clique em Mapear Unidade de Rede. 2. Na caixa de diálogo Mapear Unidade de Rede, digite as seguintes informações: Na lista Unidade, selecione a letra da unidade para a conexão. Na caixa Pasta, digite ou navegue até o diretório que contém os mapas de dados compartilhados. 3. Clique em Concluir. 4. No Navegador do PowerExchange, clique em Opções > Configuração de Recursos. 5. Na caixa de diálogo Configuração de Recursos, clique na guia Editar Configuração. 22 Capítulo 1: Introdução ao Navegador do PowerExchange

40 6. Execute uma das ações a seguir: Para adicionar uma configuração de recurso, clique em Adicionar. Para editar uma configuração de recurso, selecione uma configuração na lista Configurações Disponíveis e clique em Editar. 7. Na caixa de diálogo Editar Configuração ou Adicionar Configuração, digite as seguintes informações: No campo Caminho Compartilhado, navegue até a unidade de rede que você mapeou. Se você especificar um caminho compartilhado e um caminho local, verifique se esses caminhos diferem. Caso contrário, será exibida uma mensagem de erro. Para uma nova configuração de recursos, selecione a opção Definir como configuração atual. 8. Clique em OK. A barra de títulos do Navegador do PowerExchange exibe o nome da configuração de recursos e indica que ela é compartilhada. Por exemplo: PowerExchange Navigator - [Default (Shared)] Selecionando uma Configuração de Recurso como a Configuração Atual Se você definir várias configurações de recursos, selecione uma para usar como a configuração atual. A configuração atual permanece em vigor até você selecionar outra configuração. Por padrão, quando você adiciona uma configuração de recurso, ela se torna a configuração atual. 1. Clique em Opções > Configuração de Recurso. 2. Na caixa de diálogo Configuração de Recurso, clique na guia Configuração Atual. 3. Na lista Nome, selecione uma configuração de recurso. 4. Clique em OK. A barra de título do Navegador do PowerExchange exibe a configuração de recursos ativa. Excluindo uma Configuração de Recurso Você pode excluir uma configuração de recurso diferente da atual. 1. Clique em Opções > Configuração de Recurso. 2. Na caixa de diálogo Configuração de Recursos, clique na guia Editar Configuração. 3. Na lista Configurações Disponíveis, selecione uma configuração e clique em Excluir. Nota: O botão Excluir não está disponível para a configuração de recurso atual. Preferências do Mapa de Dados Você pode definir preferências para criar e testar mapas de dados. Você pode definir as seguintes preferências para todos os tipos de mapas de dados, exceto onde observado: Se deve chamar o assistente Importar Copybook quando você adicionar um mapa de dados Preferências do Mapa de Dados 23

41 Se deve chamar o assistente Importação do FDT Adabas quando você adicionar um mapa de dados Adabas A convenção de nomenclatura usada no SQL gerado para uma tabela quando você executa um teste de linha de banco de dados em um mapa de dados Um ponto de inserção padrão para adicionar um campo a um registro ou uma coluna a uma tabela Exibir definições para dados nas janelas Registro, Tabela e Saída de Teste de Linha de Banco de Dados Para mapas de dados IDMS, você pode definir informações de dicionário do Distributed Database System (DDS). Definindo Preferências do Mapa de Dados Você pode definir preferências para adicionar e testar todos os tipos de mapas de dados. 1. Clique em Opções > Preferências. 2. Clique na guia Mapa de Dados da caixa de diálogo Preferências. A tabela a seguir descreve as informações a serem inseridas: Opção Importar Definições de Registro em um novo Mapa de Dados Importar Campos/FDT de Chave (Somente Adabas) Usar nomes de duas camadas Descrição Selecione essa opção para executar o assistente Importar Copybook quando você adicionar um mapa de dados. Limpe essa opção para não executar o assistente Importar Copybook quando você adicionar um mapa de dados. Limpe a opção Importar Definições de Registro na caixa de diálogo Nome no assistente Adicionar Mapa de Dados. O padrão é selecionado. Selecione essa opção para executar o assistente Importação do FDT Adabas quando você adicionar um mapa de dados Adabas. Limpe essa opção para não executar o assistente Importação do FDT Adabas quando você adicionar um mapa de dados Adabas. Limpe a opção Importar Campos de Chaves/FDT na caixa de diálogo Nome no assistente Adicionar Mapa de Dados. O padrão é selecionado. Indica a convenção de nomenclatura a ser usada para identificar uma tabela na SQL que o PowerExchange gera quando você executa um teste de linha de banco de dados para um mapa de dados. Selecione essa opção para usar uma convenção de nomenclatura de duas camadas. Um nome de duas camadas contém um nome de esquema e um nome de mapa com um nome de tabela anexado, como a seguir: select * from schema.map_table Limpe essa opção para usar uma convenção de nomenclatura de três camadas. Um nome de três camadas contém um nome de esquema, um nome de mapa e um nome de tabela, como a seguir: select * from schema.map.table Nota: Essa opção não afeta as convenções de nomenclatura que os tipos de fontes de dados NRDB e NRDB2 usam, como a seguir: - NRDB usa a convenção de nomenclatura de três camadas. - NRDB2 usa a convenção de nomenclatura de duas camadas. 24 Capítulo 1: Introdução ao Navegador do PowerExchange

42 Opção Tempo de Espera de Operação de Rede Tamanho do pool de conexões Manter Ponto de Inserção Mostrar Deslocamentos de Campo Mostrar Tipo de Coluna SQL Filtrar Nomes de Colunas Nome da Coluna Descrição Digite o número de segundos decorridos durante uma operação de envio ou recebimento de rede antes de o PowerExchange encerrar a conexão e emitir uma mensagem de erro de tempo de espera. O padrão é 180. Se você usar o pool de conexões, digite o número máximo de conexões a serem mantidas abertas. O Navegador do PowerExchange mantém o limite desse número de conexões abertas até que os Ouvintes do PowerExchange acelerem o processamento. Antes de inserir um pool de conexões com tamanho maior do que zero, verifique se o valor de MAXTASKS no arquivo DBMOVER da máquina que executa o Ouvinte do PowerExchange é grande o suficiente para acomodar o número máximo de conexões no pool para a tarefa do Ouvinte. Se você usar o pool de conexões, digite o número de segundos durantes os quais uma conexão inativa será mantida no pool de conexões antes que seja fechada. Selecione uma das opções a seguir para especificar o ponto de inserção para adicionar um campo a um registro ou uma coluna a uma tabela: - Antes do item atual - Depois do item atual - No Final O ponto de inserção especificado é usado quando você conclui uma das ações a seguir: - Para adicionar um campo a um registro, clique em Adicionar > Campo. - Para adicionar uma coluna a uma tabela, clique em Adicionar > Coluna. Selecione uma ou ambas as opções a seguir para indicar os formatos nos quais exibir o deslocamento para registros na janela Registro: - Decimal. Formato decimal. - Hex. Formato hexadecimal. Selecione essa opção para exibir os tipos de dados SQL das colunas exibidas para uma tabela na janela Tabela. Limpe essa opção para ocultar os tipos de dados da coluna. Selecione essa opção para filtrar colunas em mapas de dados com base no nome da coluna. As opções são: - Incluir. Inclui colunas que correspondem ao padrão de nome especificado por você. - Excluir. Exclui as colunas que correspondem ao padrão de nome. O padrão é Excluir. O padrão é selecionado. Digite o nome a ser usado como critério de filtragem. Nos critérios de filtragem, use os seguintes caracteres curinga: - Asterisco (*) representa um ou mais caracteres de correspondência. - Ponto de interrogação (?) representa um único caractere de correspondência. Por padrão, o PowerExchange exclui todas as colunas com um nome que comece com FILLER. Preferências do Mapa de Dados 25

43 Opção Número de Registros Exibir formato Descrição Digite o número de registros exibidos de uma vez em uma janela Arquivo de Dados. Nota: Se um arquivo de dados for aberto em uma janela Arquivo de Dados, você deverá primeiro fechar o arquivo de dados e o mapa de dados antes de editar esse valor para que ele tenha efeito. O padrão é 10 registros. Selecione o formato de exibição para registros na exibição do arquivo de dados, que é um dos seguintes valores: - Caractere/Hex. Exibe registros no formato de caractere e no formato hexadecimal. - Caractere. Exibe registros no formato de caractere. - Vertical. Exibe registros verticalmente no formato de caractere e no formato hexadecimal. Nota: Se um arquivo de dados for aberto em uma janela Arquivo de Dados, você deverá fechar o arquivo de dados e o mapa de dados para que as mudanças nesse valor tenham efeito. O padrão é Vertical. 3. Clique em OK. TÓPICOS RELACIONADOS: Exibindo um Arquivo de Dados na página 61 Importando um Copybook para um Mapa de Dados na página 124 Importando um FDT para um Mapa de Dados Adabas na página 128 Definindo Preferências do Mapa de Dados IDMS Para mapas de dados IDMS, você pode definir informações de dicionário do Distributed Database System (DDS). Essas informações são usadas para todos os mapas de dados IDMS, mas você pode substituir esses valores para mapas de dados IDMS individuais. 1. Clique em Opções > Preferências. 2. Clique na guia Propriedades de IDMS. A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Dicionário Nome do DB Identificação de Usuário do Dicionário Descrição Nome do dicionário DDS do qual recuperar metadados do subesquema. O banco de dados IDMS que contém o dicionário. Se necessário, um ID do usuário que tem autoridade para acessar o dicionário. 26 Capítulo 1: Introdução ao Navegador do PowerExchange

44 Opção Senha do Dicionário Nome do Nó Nó do Dicionário Descrição Se um ID do usuário do dicionário for especificada, digite uma senha desse ID do usuário. Nome do nó DDS. Nome do nó do dicionário DDS. 3. Clique em OK. TÓPICOS RELACIONADOS: Mapas de Dados IDMS na página 98 Utilitário de Senha Criptografada Para aumentar a segurança, você pode usar o utilitário de senha criptografada para criptografar uma senha de texto simples ou um código de acesso válido do PowerExchange. O PowerExchange suporta códigos de acesso para acesso somente ao i5/os e z/os. Você pode usar a senha ou o código de acesso criptografado para controlar o acesso a uma origem, executar comandos pwxcmd, executar alguns utilitários do PowerExchange ou configurar o Agente de Log do PowerExchange para Linux, UNIX e Windows. Copie e cole a senha ou código de acesso criptografado no parâmetro de comando, instrução de controle do utilitário ou arquivo de configuração relevante. A tabela a seguir descreve os parâmetros para os quais uma senha ou código de acesso criptografado pode ser especificado: Localização Parâmetro ou Campo Referência de Documentação comandos pwxcmd -epassword Referência de Comandos do PowerExchange Arquivo de configuração DBMOVER Arquivo de configuração pwxccl.cfg do Agente de Log do PowerExchange EPWD na instrução UDB CAPI_CONNECTION (somente senha) CAPTURE_NODE_EPWD Manual de Referência do PowerExchange Guia do CDC do PowerExchange para Linux, UNIX e Windows Utilitário DTLREXE -epwd Guia de Utilitários do PowerExchange Utilitário DTLUAPPL EPWD (somente senha) Guia de Utilitários do PowerExchange Utilitário DTLUCBRG EPWD Guia de Utilitários do PowerExchange Utilitário DTLUCUDB EPWD Guia de Utilitários do PowerExchange Utilitário de Senha Criptografada 27

45 Localização Parâmetro ou Campo Referência de Documentação Utilitário DTLURDMO EPWD Guia de Utilitários do PowerExchange Utilitário DTLUTSK EPWD Guia de Utilitários do PowerExchange Gerando uma Senha Criptografada Você pode especificar uma senha criptografada em alguns arquivos de configuração do PowerExchange, comandos pwxcmd e instruções do utilitário. Para acesso ao z/os, você pode criptografar um código de acesso válido do PowerExchange. 1. Clique em Arquivo > Senha Criptografada. A caixa de diálogo Gerar Senha Criptografada é exibida. 2. Na caixa Senha, digite uma senha com texto não criptografado. Como alternativa, para acesso ao i5/os ou z/os, insira um código de acesso válido do PowerExchange. Um código de acesso para acesso ao i5/os pode ter 9 a 31 caracteres. Um código de acesso para acesso ao z/os pode ter 9 a 128 caracteres (não ODBC) ou 9 a 79 caracteres (ODBC). Um código de acesso pode conter os seguintes caracteres: Letras em maiúsculas e minúsculas Os números de 0 a 9 Espaços Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. 3. Clique em Gerar Senha Criptografada. A senha ou código de acesso criptografado será exibido na caixa Senha Criptografada. 4. Copie e cole a senha ou código de acesso criptografado no parâmetro adequado em um arquivo de configuração, uma instrução do utilitário ou uma opção de comando. Por exemplo, a seguinte senha criptografada está especificado no parâmetro CAPTURE_NODE_EPWD no arquivo de configuração pwxccl.cfg: CAPTURE_NODE_EPWD=F40B3B2742FB3A1F 28 Capítulo 1: Introdução ao Navegador do PowerExchange

46 C A P Í T U L O 2 Mapas de Dados Este capítulo inclui os seguintes tópicos: Visão Geral de Mapas de Dados, 29 Adicionando um Mapa de Dados, 43 Adicionando um Registro de Mapa de Dados, 47 Adicionando um Campo a um Registro, 47 Adicionando um Campo Definido pelo Usuário a um Registro, 48 Adicionando Itens a um Registro Datacom, 49 Adicionando Itens a um Registro IDMS, 52 Adicionando Itens a um registro do IMS, 55 Adicionando uma Tabela de Mapa de Dados, 57 Adicionando uma Coluna a uma Tabela, 58 Exibindo Registros e Campos, 59 Exibindo Tabelas e Colunas, 61 Exibindo um Arquivo de Dados, 61 Ordenando Registros e Tabelas de Mapa de Dados, 63 Exibindo ou Editando Propriedades para um Mapa de Dados ou Itens em um Mapa de Dados, 64 Copiando, Recortando e Colando Itens em um Mapa de Dados, 70 Editando Informações de Logon para Acessar Mapas de Dados e Dados, 71 Enviando um Mapa de Dados para um Sistema Remoto, 73 Importando Mapas de Dados Enviados a um Sistema Remoto, 75 Associando Vários Arquivos de Dados a um Mapa de Dados, 76 Imprimindo um Mapa de Dados ou Itens em um Mapa de Dados, 79 Excluindo Mapas de Dados ou Itens em um Mapa de Dados, 82 Visão Geral de Mapas de Dados Você pode definir mapas de dados para mapear registros não relacionais para tabelas relacionais para que o PowerExchange possa usar a linguagem SQL para acessar os dados. 29

47 Para origens não relacionais, como Bancos de dados IMS, arquivos VSAM, conjuntos de dados sequenciais e arquivos simples, é solicitado que os mapas de dados executem operações de movimento de dados em massa e apresentem os metadados usados para definir registros de captura e mapas de extração para CDC. Para fontes do DB2, você também pode definir mapas de dados para que possa dividir os dados em uma coluna que contém vários campos em campos separados. Um mapa de dados para um arquivo simples ou conjunto de dados sequenciais deve ser associado a um arquivo de dados que define os tipos de registro e os dados no mapa de dados. Quando você adicionar um mapa de dados, importe um copybook para definir o layout dos dados em uma fonte de dados e, para um mapa de dados Adabas, importe um FDT Adabas e chaves Adabas. Você pode também definir o layout dos dados definindo manualmente um ou mais registros e tabelas em um mapa de dados. Os registros em mapas de dados definem o layout do campo dos registros em uma origem ou destino. As tabelas em mapas de dados apresentam uma exibição relacional dos dados. O PowerExchange exige uma exibição relacional para acessar fontes de dados usando a linguagem SQL, como a seguir: Para origens e destinos não relacionais, o PowerExchange suporta um subconjunto limitado da linguagem SQL. O PowerExchange interpreta as instruções SQL internamente para convertê-las, conforme necessário, para acesso ao tipo de fonte de dados. Para origens e destinos relacionais, o PowerExchange também suporta um subconjunto maior da linguagem SQL. O PowerExchange passa as instruções SQL para o RDBMS para o processamento. O PowerExchange mapeia campos em mapas de dados para o nível de byte. Alguns copybooks, como copybooks PL/I, têm mapeamentos de nível de bit. Se você importar um copybook que tem mapeamentos de nível de bit para um mapa de dados, o PowerExchange concatenará os campos de bit em um campo de byte, nomeando o campo usando o nome do campo do primeiro campo de bit. Em um mapa de dados, você pode definir um campo definido pelo usuário que use uma ou mais funções do PowerExchange em uma expressão para separar novamente esse campo em bits. Em seguida, no PowerCenter, use uma transformação de Expressão para calcular o valor numérico dos bits combinados na sequência de caracteres de bits. Você pode executar um teste de linha de banco de dados em um mapa de dados para verificar se ele pode recuperar dados da fonte. Para obter informações sobre a abertura, o fechamento e a exclusão de mapas de dados e a pesquisa de campos em registros e colunas em tabelas em mapas de dados, consulte Recursos do PowerExchange na página 17. TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Nomes de Mapas de Dados O PowerExchange apresenta uma convenção de nomenclatura para mapas de dados. Quando adiciona um mapa de dados, você especifica os seguintes valores: Um nome de esquema, como demo Um nome de mapa, como map1 O PowerExchange usa esses valores para construir o nome do mapa de dados no formato schema.map, por exemplo, demo.map1. Você pode usar a convenção de nomenclatura para agrupar mapas de dados por projeto, sistema operacional ou outra categoria. 30 Capítulo 2: Mapas de Dados

48 Quando você executa um teste de linha de banco de dados em uma tabela, o PowerExchange gera uma instrução SQL que contém o nome da tabela prefixado com os nomes do esquema e do mapa. O formato de nomenclatura depende do Tipo de DB selecionado na caixa de diálogo Teste de Linha de Banco de Dados e da definição para a opção Usar nomes de duas camadas na guia Mapas de Dados na caixa de diálogo Preferências. Você pode usar uma convenção de nomenclatura de duas ou de três camadas: Um nome de duas camadas tem a seguinte instrução: select * from schema.map_table Um nome de três camadas tem o seguinte formato: select * from schema.map.table Para usar uma convenção de nomenclatura de duas camadas, clique em Opções > Preferências. Na guia Mapas de Dados na caixa de diálogo Preferências, selecione a opção Usar nomes de duas camadas para usar um nome de duas camadas. Limpe essa opção para usar um nome de três camadas. TÓPICOS RELACIONADOS: Definindo Preferências do Mapa de Dados na página 24 Fontes de Dados Suportadas por Mapas de Dados Você pode definir mapas de dados para várias fontes de dados nos sistemas operacionais i5/os, z/os, Linux, UNIX e Windows. Ao definir um mapa de dados, você deve selecionar o método de acesso apropriado do PowerExchange para a fonte de dados e o sistema operacional. A tabela a seguir indica qual método de acesso usar para cada fonte de dados e sistema operacional: Fonte de Dados i5/os Linux, UNIX e Windows z/os Método de Acesso do PowerExchange Arquivo Adabas - X X ADABAS Arquivo CA Datacom/DB - - X DATACOM Banco de dados CA IDMS/DB - - X IDMS Arquivo de dados C-ISAM - X - ISAM Banco de dados DB2 X X X DB2 Arquivo de descarregamento do DB2 X X X DB2UNLD Arquivos simples e conjuntos de dados sequenciais X X X SEQ Fila de mensagens IBM MQSeries X X X MQSERIES Banco de dados IMS - - X DL/1 BATCH Banco de dados IMS acessado por meio de um Ouvinte do PowerExchange - - X IMS ODBA Conjunto de dados de fita - - X TAPE Visão Geral de Mapas de Dados 31

49 Fonte de Dados i5/os Linux, UNIX e Windows z/os Método de Acesso do PowerExchange Programa de método de acesso do usuário definido pelo usuário X X X USER VSAM Entry-Sequenced Data Set (ESDS) - - X ESDS VSAM Key-Sequenced Data Set (KSDS) - - X KSDS VSAM Relative Record Data Set (RRDS) - - X RRDS Arquivos de Dados e Processamento de Lista de Arquivos Associe mapas de dados para arquivos simples ou conjuntos de dados sequenciais a um arquivo de dados que defina os tipos de registro e os dados no mapa de dados. Para associar vários arquivos de dados a um mapa de dados, você pode associar um mapa de dados a um arquivo de lista de arquivos. Em um arquivo de lista de arquivos, você lista vários arquivos de dados. O PowerExchange concatena e processa os dados nos arquivos de dados na ordem em que você os lista. Nota: O processamento de lista de arquivos é suportado pelos mapas de dados definidos apenas com os métodos de acesso ESDS, SEQ e TAPE. Associe um arquivo de dados a um mapa de dados para as seguintes fontes de dados: Arquivos de descarregamento do DB2 Arquivos simples, incluindo arquivos simples C-ISAM Conjuntos de dados sequenciais Conjuntos de dados de fita Programas de método de acesso do usuário Conjuntos de dados VSAM ESDS, KSDS e RRDS Para determinar um ou mais arquivos de dados associados a um registro, você pode usar a função GetCurrentFileName de uma expressão em um campo definido pelo usuário no mapa de dados. Nota: O PowerExchange não pode ler conjuntos de dados sequenciais de formato grande. Se você especificar DSNTYPE=LARGE na instrução DD quando você cria o conjunto de dados, o PowerExchange não pode lê-lo. Em vez disso, você pode especificar DSNTYPE=EXTREQ na instrução DD. TÓPICOS RELACIONADOS: Associando Vários Arquivos de Dados a um Mapa de Dados na página 76 Etapa 1. Associar um Arquivo de Dados a um Mapa de Dados na página 231 Etapa 1. Associar um Arquivo de Dados a um Mapa de Dados de Vários Registros na página 234 GetCurrentFileName na página 279 Copybooks No Navegador do PowerExchange, o termo copybook refere-se, genericamente, a definições de dados para registros, segmentos, campos, chaves e outros itens de uma fonte de dados que você importa para um mapa de dados para definir o layout dos dados. 32 Capítulo 2: Mapas de Dados

50 Importe um copybook para eliminar a necessidade de definir manualmente o layout desses itens em um mapa de dados. Você pode importar um copybook quando adicionar um mapa de dados ou após adicioná-lo. Você pode também importar um ou mais copybooks para um registro ou segmento em um mapa de dados para adicionar definições de dados ao registro ou segmento. Depois de importado, um copybook é armazenado no sistema local. Você pode, então, reimportar esse copybook do sistema local. Selecione o tipo de copybook a ser importado na lista Tipo na caixa de diálogo Importar Copybook - Detalhes da Origem. Os tipos de copybooks que você pode importar dependem do tipo da fonte de dados do mapa de dados. TÓPICOS RELACIONADOS: Copybooks na página 122 Field Definition Tables Adabas e Chaves Adabas Você pode importar um FDT Adabas e chaves Adabas para um mapa de dados Adabas quando adiciona um mapa de dados ou após adicioná-lo. Cada arquivo de banco de dados possui um FDT correspondente, que define a estrutura de registro e o conteúdo de cada campo no arquivo físico. Para cada campo no registro, o FDT define o nível, nome, tamanho, formato, opções e atributos especiais de campo e descritor. Se você importar um FDT, poderá abrir o mapa de dados Adabas mais tarde sem conectar ao sistema remoto porque as definições de dados no mapa de dados são armazenadas no sistema local. Você pode exibir um FDT para um mapa de dados Adabas do Navegador do PowerExchange. Ao exibir o FDT, você pode atualizar o FDT salvo localmente com dados do FDT no sistema remoto. TÓPICOS RELACIONADOS: Importando um FDT para um Mapa de Dados Adabas na página 128 Exibindo e Atualizando o FDT para um Mapa de Dados Adabas na página 128 Registros e Campos do Mapa de Dados Um mapa de dados inclui os registros e campos que você define ou importa de um copybook para descrever o layout de uma origem ou um destino. Os campos podem incluir campos definidos pelo usuário e campos definidos como arrays. Nota: O termo registro refere-se aos registros e aos segmentos. Na exibição relacional de um mapa de dados, as colunas da tabela são baseadas nos campos definidos nos registros de mapa de dados. TÓPICOS RELACIONADOS: Definindo Propriedades de Array na Caixa de Diálogo Propriedades da Tabela na página 37 Mapas de Dados de Registro Único e de Vários Registros Você pode criar um mapa de dados que define um ou mais registros para um banco de dados ou arquivo de dados de origem ou de destino. No caso mais simples, um mapa de dados contém um registro e uma tabela derivada do registro. A tabela oferece uma exibição relacional dos dados. Visão Geral de Mapas de Dados 33

51 Você pode criar um mapa de dados com vários registros importando um copybook que define vários registros ou especificando Valores de Identificação de Registro para um campo. Um mapa de dados com vários registros é conhecido como um mapa de dados de vários registros. Use mapas de dados de vários registros nos seguintes casos: Cada segmento em uma origem do IMS tem uma definição de registro diferente. Para um arquivo sequencial, simples ou uma fonte de dados VSAM, defina registros diferentes com base nos valores de identificação de registro que você insere para um campo na caixa de diálogo Propriedades do Campo. Você precisa distinguir os registros redefinidos que, às vezes, armazenam dados do campo como dados numéricos e, às vezes, como dados alfabéticos, dependendo das outras informações no registro. Quando você cria um mapa de dados para um arquivo sequencial ou uma fonte de dados VSAM, pode definir propriedades do registro que identificam relacionamentos hierárquicos entre os registros ou os registros redefinidos. O PowerExchange e o PowerCenter usam essas informações para gravar vários tipos de registro em destinos sequenciais ou VSAM enquanto preserva o sequenciamento dos dados de origem. Para origens de conjunto de dados de descarregamento do IMS, o PowerExchange usa as informações de segmento que você importa de um IMS DBD para o mapa de dados de vários registros para gravar vários tipos de registro em um destino de conjunto de dados de descarregamento do IMS. Para obter exemplos de criação de registro único e mapas de dados de vários registros, consulte Capítulo 9, Exemplos do Navegador do PowerExchange na página 226. Para obter informações sobre as informações de conexão hierárquica que você pode definir em um mapa de dados SEQ ou VSAM, consulte Propriedades do Registro - Nome na página 338. Campos Definidos pelo Usuário Nos mapas de dados, você pode definir campos em registros que usam uma ou mais funções do PowerExchange em uma expressão para processar dados da fonte. Essas funções especificam operações como divisão e concatenação de campos. Você pode também usar a função CallProg em uma expressão para chamar um programa definido pelo usuário para processar dados da fonte. TÓPICOS RELACIONADOS: Adicionando um Campo Definido pelo Usuário a um Registro na página 48 Programas de Saída de Nível de Registro Crie um programa de saída de nível de registro gravado em Assembler, C, COBOL ou PL/I para chamar um programa definido pelo usuário para processar dados em um registro em um mapa de dados antes da recuperação de dados. Por exemplo, configure uma saída de nível de registro para chamar um programa que descompacta dados compactados em um registro antes da recuperação de dados. Você pode definir um programa de saída de nível de registro de um mapa de dados que usa qualquer um dos seguintes métodos de acesso: DATACOM DL/1 BATCH ESDS IDMS 34 Capítulo 2: Mapas de Dados

52 IMS ODBA KSDS MQSERIES SEQ TAPE Para definir um programa de saída de nível de registro, especifique os atributos do programa de saída de nível de registro na guia Saída do Nível de Registro na caixa de diálogo Propriedades do Mapa de Dados. Inclua o nome do DLL compilado ou da biblioteca compartilhada do programa de saída de nível de registro, a convenção de chamada do programa e os parâmetros a serem passados para o programa. O PowerExchange chama o programa de saída de nível de registro repetidamente para processar os dados no registro até que todos os dados sejam processados. O PowerExchange apresenta exemplos de programas de saída de nível de registro com arquivos de cabeçalhos e JCL. Esses arquivos, denominados urle*.*, estão localizados no diretório de exemplos no diretório de instalação do Navegador do PowerExchange. Personalize e compile esses exemplos de programas para seu ambiente. TÓPICOS RELACIONADOS: Propriedades do Mapa de Dados - Saída do Nível de Registro na página 336 Programas de Método de Acesso do Usuário na página 303 Tabelas e Colunas de Mapa de Dados Nos mapas de dados, as tabelas apresentam a exibição relacional dos dados. Se você importar um copybook para um mapa de dados para definir o layout dos dados na fonte, o PowerExchange criará tabelas e colunas no mapa de dados baseadas nos registros e nos campos importados. Você também pode adicionar manualmente tabelas e colunas a um mapa de dados. As colunas em tabelas são baseadas em campos em registros. TÓPICOS RELACIONADOS: Adicionando uma Tabela de Mapa de Dados na página 57 Tabelas Simples e Complexas Uma tabela simples é baseada em um único registro. Uma tabela complexa é baseada em mais de um registro. Em uma tabela complexa, use as opções na caixa de diálogo Propriedades da Tabela para definir um relacionamento hierárquico entre os registros nos quais a tabela é baseada. Em um mapa de dados, uma tabela complexa espelha a hierarquia de registros ou segmentos na fonte de dados associada, como um banco de dados do IMS ou conjunto de dados sequencial. Uma tabela complexa combina informações em uma tabela que, em uma forma mais normalizada, residiria em duas ou mais tabelas. Você pode definir tabelas complexas com base em vários registros relacionados, como segmentos pai e filho em um banco de dados do IMS ou registros pai e filho em um conjunto de dados sequencial. No entanto, para reter as informações de conexão hierárquicas para um arquivo de descarregamento IMS, arquivo sequencial ou origem ou destino VSAM, use as tabelas simples de registro único e os campos de sequenciamento que o PowerExchange pode gerar quando você importa a fonte de dados no PowerCenter. Visão Geral de Mapas de Dados 35

53 O processamento de arquivo e a extração de dados se tornam mais rápidas, porque os dados de coluna nas tabelas pai não são repetidas. A seguinte tabela lista as fontes de dados, com os métodos de acesso associados, que suportam tabelas complexas: Fonte de Dados Métodos de Acesso Comentários Bancos de dados CA IDMS/DB IDMS Para CA IDMS/DB, um registro pode ter vários pais. Bancos de dados IMS IMS ODBA - Usa a interface ODBA LOTE DL/1 - Usa tarefas de lote BMP e DL/1 Para IMS, clique no comando Exibir Hierarquia IMS para exibir a hierarquia para um mapa de dados IMS. Conjuntos de dados sequenciais ou arquivos simples Conjuntos de dados de fita no z/os Conjuntos de dados VSAM ESDS Conjuntos de dados VSAM KSDS SEQ - TAPE - ESDS - KSDS - Arrays Em um mapa de dados, um registro pode conter um campo definido como um array ou, no caso de algumas fontes de dados herdadas com cláusulas OCCURS, vários campos definidos como arrays. Para definir um campo de um registro como um array, defina opções na guia Array da caixa de diálogo Propriedades do Campo. Em seguida, para definir como os elementos do array serão exibidos em um teste de linha de banco de dados ou como serão mapeados para linhas e colunas em uma tabela de destino, defina opções na caixa de diálogo Propriedades da Tabela. Definindo Propriedades de Array na Caixa de Diálogo Propriedades do Campo Para definir um campo de um registro como um array, defina opções na guia Array da caixa de diálogo Propriedades do Campo. A tabela a seguir descreve as opções que você pode usar para definir arrays: Opção Array Fixo Variável Descrição Define o campo como um array. Define o campo como um array fixo. Define o campo como um array variável. 36 Capítulo 2: Mapas de Dados

54 Opção Tamanho do Array Campo de Contagem Descrição O número de elementos no array. Os valores válidos vão de 1 a Para uma definição de registro importada por meio de um copybook COBOL, esse valor corresponde ao valor x especificado na cláusula OCCURS x que define o array. Para um array variável, o nome do campo que determina o número real de elementos na instância do campo de array. Para uma definição de registro importada por meio de um copybook COBOL, esse valor corresponde ao valor field-y especificado na cláusula OCCURS x DEPENDING ON field-y que define o array. Por exemplo, suponha que você importe a seguinte cláusula OCCURS de um copybook COBOL para um mapa de dados: ITEM OCCURS 3 DEPENDING ON ITEMCT PIC X(15). A tabela a seguir lista as opções e os valores que a guia Array da caixa de diálogo Propriedades do Campo mostra para este exemplo: Opção Array Fixo Variável Valor Essa opção é selecionada. Esta opção é desmarcada. Essa opção é selecionada. Tamanho do Array 3 Campo de Contagem ITEMCT Definindo Propriedades de Array na Caixa de Diálogo Propriedades da Tabela Para definir como os elementos do array serão exibidos em um teste de linha de banco de dados ou como serão mapeados para linhas e colunas em uma tabela de destino, defina opções na caixa de diálogo Propriedades da Tabela. Visão Geral de Mapas de Dados 37

55 A tabela a seguir descreve as opções da caixa de diálogo Propriedades da Tabela que você pode usar para definir arrays: Opção Geração de Coluna Campos Como você deseja gerenciar várias instâncias de registros selecionados? Vários Arrays em uma Única Linha de Entrada de Dados Descrição Quando você define uma tabela pela primeira vez, o PowerExchange nomeia as colunas usando os nomes de campo do registro no qual a tabela é baseada. No entanto, uma convenção de nomenclatura especial é usada para registros que contêm campos definidos como arrays. Se renomear as colunas depois de definir a tabela e não desejar que os nomes de coluna sejam gerados novamente, selecione uma das seguintes opções: - Aplicar alterações no formato do array. Apenas as alterações feitas nos elementos do array são refletidas na tabela. - Atualizar com colunas que estão faltando. Somente colunas novas são adicionadas à tabela. - Redefinir para padrões. Um novo conjunto de colunas é gerado com os nomes padrão derivados dos nomes de campo. Todas as alterações feitas são descartados. - Remover Colunas Ocultas. Somente DB2UNLD. Um novo conjunto de colunas é gerado com os valores padrão da opção Ocultar da Tabela de cada campo. Controla como os elementos de um array ou de um campo de grupo são exibidos: - Para exibir cada elemento de um array ou de um campo de grupo em uma única linha, selecione o campo. - Para exibir cada elemento de um array ou de um campo de grupo em uma linha separada, limpe o campo. Nota: Para exibir apenas campos definidos como um campo de grupo ou como um array na lista Campos, selecione a opção Apenas Grupos e Arrays. Para exibir todos os campos do registro na lista Campos, limpe essa opção. Essa opção controla os campos exibidos na lista Campos e na caixa de diálogo Propriedades da Tabela, mas não os campos exibidos na janela Saída do Teste de Linha de Banco de Dados. Selecione uma das seguintes opções: - Nova Linha. Para cada elemento do array, uma nova linha é exibida ou gravada no destino. - Ignorar. O segundo elemento e os elementos subsequentes do array não são exibidos nem gravados no destino. - Array. Os elementos especificados na lista Array são exibidos ou gravados no destino em uma única linha de saída. O PowerExchange preenche a linha de saída até que ela esteja completa e, em seguida, ignora os elementos subsequentes ou exibe uma nova linha com os elementos de overflow, caso você selecione a opção Nova Linha no Overflow. Gera várias linhas de saída de um único registro que contém vários arrays ou cláusulas OCCURS. O PowerExchange define os campos de saída como NULL quando os dados do registro são esgotados. Para obter mais informações sobre essa opção, consulte Vários Arrays em uma Única Linha de Entrada de Dados na página 39. Essa opção só será habilitada para tabelas com um COPYLIB importado com várias cláusulas OCCURS. Para obter um exemplo de como usar essas opções para definir o modo de exibição ou de mapeamento dos elementos do array, consulte Adicionando um Mapa de Dados de Registro Único com um Array - Exemplo na página Capítulo 2: Mapas de Dados

56 TÓPICOS RELACIONADOS: Adicionando um Mapa de Dados de Registro Único com um Array - Exemplo na página 231 Exibindo ou Editando Propriedades para uma Tabela de Mapa de Dados na página 69 Vários Arrays em uma Única Linha de Entrada de Dados Algumas fontes de dados herdadas contêm vários arrays, ou cláusulas OCCURS, em um único registro. O PowerExchange pode gerar várias linhas de saída a partir de um único registro e definir campos de saída como NULL quando os dados do registro forem esgotados. A tabela a seguir mostra alguns exemplos de entrada de dados: Linha de Entrada de Dados fld1 - OCCURS DEPENDING fld2 - OCCURS DEPENDING 1 3 valores 10, 20, 30 2 valores AA, BB 2 1 valor 55 4 valores DD1, DD2, DD3, DD4 A tabela a seguir mostra um exemplo de saída de dados: Linha de Saída de Dados Fld1 Fld AA 2 20 BB 3 30 NULL 4 55 DD1 5 NULL DD2 6 NULL DD3 7 NULL DD4 Você também pode usar esse processo de única entrada-muitas saídas com outros tipos de campo, como números de conta, para que cada linha de saída de dados fique completa. Páginas de Código O PowerExchange apresenta um conjunto de páginas de código padrão que você pode associar a mapas de dados ou a campos de caracteres em mapas de dados. Você também pode associar páginas de código definidas pelo usuário a mapas de dados ou a campos. Você pode associar uma página de código específica a um mapa de dados ou a um campo ou usar a página de código padrão para o sistema operacional. Se você associar uma página de código a um campo, a página de código de nível de campo substituirá a página de código de nível de mapa de dados. Visão Geral de Mapas de Dados 39

57 Páginas de Códigos do PowerExchange O PowerExchange apresenta um conjunto de páginas de códigos padrão. O PowerExchange inclui o software ICU para apresentar o suporte à página de código de byte único e multibyte estendido para as seguintes fontes de dados: Datacom DB2 para i5/os DB2 para z/os Arquivos simples Conjuntos de dados sequenciais Conjunto de dados VSAM Nos sistemas i5/os e z/os, a página de código IBM-037 é a página de código padrão. Nos sistemas Linux, UNIX e Windows, a página de código ISO-8859 é a página de código padrão. Para obter uma lista completa de todas as páginas de código e alias definidos para uma instalação do PowerExchange, use o utilitário ICUCHECK. Para obter mais informações sobre esse utilitário, consulte o Manual de Referência do PowerExchange. A tabela a seguir descreve algumas das páginas de código com suporte pelo PowerExchange: Página de Código IBM-037* IBM-1047* IBM-273* IBM-277* IBM-278* IBM-280* IBM-284* IBM-285* IBM-297* IBM-424* IBM-500* ISO-8859 Descrição Estados Unidos, Canadá, Brasil Latim 1/Sistemas Abertos Alemanha, Áustria Dinamarca, Noruega Finlândia, Suécia Itália Espanha, América Latina Reino Unido França Hebraico Moderno Internacional UNIX e Windows Nota: As páginas de código prefixadas com IBM- podem gerenciar dados de sistemas i5/os e z/os. Páginas de Códigos Definidas pelo Usuário Define até dez páginas de códigos definidas pelo usuário. 40 Capítulo 2: Mapas de Dados

58 As páginas de códigos definidas pelo usuário permitem que você exiba ou imprima valores hexadecimais especificados. Você deve nomear as páginas de códigos definidas pelo usuário USRCPnn, em que nn é um valor de 00 a 09. Para obter mais informações sobre páginas de códigos do PowerExchange, consulte o Manual de Referência do PowerExchange. Verificação de Dados Defina a verificação de dados para especificar como o PowerExchange gerencia erros de mapeamento de registro e erros de dados de nível de campo durante uma extração. As opções de verificação de dados são: Erros de mapeamento de registro. Você pode especificar que o PowerExchange ignore a linha, grave uma mensagem no arquivo de log e continue ou interrompa a extração. Por exemplo, se o PowerExchange detecta um erro de mapeamento de registro como um valor em uma cláusula OCCURS DEPENDING ON que seja maior que o valor máximo permitido, você pode especificar que o PowerExchange interrompa a extração. Erros de dados em campos. Você pode especificar que o PowerExchange conclua uma das ações a seguir: - Para os campos CHAR ou DATE, substitua dados usando valores na guia Padrões de Dados na caixa de diálogo Propriedades do Mapa de Dados. Você pode especificar se substitui o primeiro caractere ou todos os caracteres no campo. Os valores em campos numéricos são definidos como zeros. - Ignore a linha, grave uma mensagem no arquivo de log e continue a extração. - Interrompa a extração. - Defina o campo como NULL. Quando você definir a verificação de dados no nível de mapa de dados, selecione os tipos de dados nos quais executar a verificação de dados. Você pode definir a verificação de dados no mapa de dados ou nível de campo. As definições da verificação de dados de nível de campo substituem as definições da verificação de dados de nível de mapa de dados. Nota: A execução da verificação de dados no nível de campo usa recursos adicionais. TÓPICOS RELACIONADOS: Exibindo ou Editando Propriedades para uma Tabela de Mapa de Dados na página 69 Exibindo ou Editando Propriedades para um Campo em um Registro na página 65 Mapas de Dados Exportados Se a fonte de dados para um mapa de dados estiver em um sistema remoto, como em um sistema i5/os ou z/os, envie o mapa de dados para o sistema remoto para disponibilizá-lo para o PowerExchange para operações de movimento de dados em massa. Quando você envia o mapa de dados para o sistema remoto, o PowerExchange converte o mapa de dados em um arquivo independente de plataforma no sistema remoto, que o PowerExchange usa para extração de dados durante uma operação de movimento de dados em massa. O mapa de dados original permanece no sistema do Navegador do PowerExchange, mas, se você alterar o mapa de dados local, as mudanças não serão refletidas no mapa de dados remoto até você enviar o mapa de dados para o sistema remoto novamente. Visão Geral de Mapas de Dados 41

59 Você pode importar um ou mais mapas de dados enviados ou exportados para um sistema remoto para o sistema do Navegador do PowerExchange. Para cada mapa de dados que você importa, ele permanece no sistema remoto e uma cópia local é salva no sistema do Navegador do PowerExchange. TÓPICOS RELACIONADOS: Enviando um Mapa de Dados para um Sistema Remoto na página 73 Importando Mapas de Dados Enviados a um Sistema Remoto na página 75 Itens de Mapa de Dados Datacom Em um mapa de dados Datacom, defina elementos e chaves para otimizar o acesso a dados CA Datacom/DB. Um elemento é a unidade de transferência usada entre o CA Datacom/DB e aplicativos emitindo comandos CA Datacom/DB. Um elemento consiste em uma ou mais colunas contíguas ou ocorrências de entidade FIELD. Um elemento deve conter colunas que um programa aplicativo usa no tempo de execução. Cada tabela tem no mínimo um e não mais que 255 elementos. As chaves e os segmentos de chaves definem a ordem de classificação para recuperação de dados. Uma chave é composta de colunas, que podem ser não contíguas e em qualquer sequência. Cada coluna em uma chave pode ser crescente ou decrescente no valor. Cada chave pode ter até 180 caracteres de extensão. Defina um máximo de 99 chaves para uma tabela e 999 chaves para um banco de dados. Defina qualquer chave como exclusiva, se cada linha na tabela especificar um valor exclusivo para a chave. Você deve definir uma chave mestra e uma chave nativa para cada tabela em um mapa de dados Datacom. A chave mestra se comporta como outras chaves, mas você pode ativar ou desativar mudanças nela. A chave nativa dita a sequência física na qual os dados são armazenados. A chave nativa pode ser a mesma que a chave mestra. TÓPICOS RELACIONADOS: Adicionando um Elemento a um Registro Datacom na página 49 Mapas de Dados Datacom na página 92 Adicionando uma Chave a um Registro Datacom na página 50 Adicionando um Segmento Chave a um Registro Datacom na página 51 Itens de Mapa de Dados IDMS Em um mapa de dados IDMS, defina o registro e conjuntos do proprietário e elementos CALC para otimizar o acesso ao banco de dados CA IDMS/DB. TÓPICOS RELACIONADOS: Adicionando um Elemento CALC a um Registro IDMS na página 53 Mapas de Dados IDMS na página 98 Adicionando um Registro e Conjunto do Proprietário a um Registro IDMS na página 53 Itens do Mapa de dados IMS Em um registro de mapa de dados IMS ODBA ou lotes IMS DL/1, defina campos de chave concatenada (CCK) e campos de pesquisa para otimizar o acesso ao banco de dados IMS. As definições do campo CCK e do campo de pesquisa, incluindo o nome, a posição e os valores de tamanho, devem corresponder às definições no segmento IMS DBD. Embora você possa incluir qualquer 42 Capítulo 2: Mapas de Dados

60 campo definido no segmento IMS DBD na pesquisa, inclua apenas os campos SEQ definidos com os campos mais importantes na parte superior da lista. TÓPICOS RELACIONADOS: Adicionando um Campo CCK a um Registro IMS na página 56 Mapas de Dados IMS na página 101 Adicionando campos de pesquisa para um registro do IMS na página 56 Programas de Método de Acesso do Usuário Crie um programa de método de acesso do usuário gravado em Assembler, C ou PL/I para processar dados em um mapa de dados. Chame o programa de método de acesso do usuário definindo um mapa de dados com o método de acesso USER e especificando os atributos do programa de método de acesso do usuário, incluindo o nome do DLL ou da biblioteca compartilhada do método de acesso do usuário compilado, parâmetros a serem passados para o programa e o caminho e nome completos do arquivo de dados associado. O PowerExchange chama o programa de método de acesso do usuário repetidamente para processar os dados no arquivo de dados associado até que todos os dados sejam processados. O PowerExchange apresenta exemplos de programas de método de acesso do usuário com arquivos de cabeçalhos e JCL. Esses arquivos, denominados uam*.*, estão localizados no diretório de exemplos no diretório de instalação do Navegador do PowerExchange. Edite e compile esses exemplos de programas para personalizá-los para o seu ambiente. TÓPICOS RELACIONADOS: Programas de Método de Acesso do Usuário na página 303 Adicionando um Mapa de Dados na página 43 Adicionando um Mapa de Dados Quando você adicionar um mapa de dados, especifique um nome de esquema, um nome de mapa de dados e um método de acesso. Se o mapa de dados for um arquivo simples ou conjunto de dados sequenciais, associe-o a um arquivo de dados. Opcionalmente, importe um copybook para definir o layout dos dados em uma fonte de dados. Para mapas de dados Adabas, você pode importar um FDT (tabela de definições de campo) Adabas e chaves Adabas. 1. Na guia Recursos do Explorador de Recursos, clique em Adicionar > Mapa de Dados. A caixa de diálogo Nome é exibida. 2. Insira as informações sobre o mapa de dados. Adicionando um Mapa de Dados 43

61 A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Esquema Nome do Mapa de Dados Método de Acesso Descrição Digite um nome de esquema definido pelo usuário. O PowerExchange usa esse nome como a primeira parte do nome do mapa de dados, como a seguir: schema_name.data_map_name Os valores válidos são caracteres alfanuméricos. Deve iniciar com um caractere alfabético. O tamanho máximo é de 10 caracteres. Digite um nome de mapa definido pelo usuário. O PowerExchange usa esse nome como a segunda parte do nome do mapa de dados, como a seguir: schema_name.data_map_name Os valores válidos contêm somente caracteres alfanuméricos e começam com uma letra. O tamanho máximo é de 10 caracteres. Selecione um dos seguintes métodos de acesso: - ADABAS. Arquivo Adabas. - DATACOM. Arquivo CA Datacom/DB. - DB2. Banco de dados DB2 para i5/os, DB2 para Linux, UNIX e Windows ou DB2 para z/os. - DB2UNLD. Arquivo de descarregamento do DB2. - DL/1 BATCH. Acesso em lotes DL/I ou BMP a um banco de dados IMS no z/os. - ESDS. VSAM Entry Sequenced Data Set (ESDS) no z/os. - IDMS. Banco de dados CA IDMS/DB em z/os. - IMS ODBA. Acesso IMS ODBA a um banco de dados IMS no z/os. As consultas ODBA são executadas como subtarefas do Ouvinte do PowerExchange no z/os. - ISAM. Arquivo de dados C-ISAM. - KSDS. VSAM Key Sequenced Data Set (KSDS) no z/os. - MQSERIES. Fila de mensagens IBM MQSeries. - RRDS. VSAM Relative Record Data Set (RRDS) no z/os. - SEQ. Arquivo simples. - TAPE. Conjunto de dados na fita. - USER. Programa de método de acesso ao usuário definido pelo usuário. Nota: Você pode substituir o método de acesso DL/1 BATCH ou IMS ODBA com outro método disponível para uma sessão do PowerCenter ou teste de linha de banco de dados. 44 Capítulo 2: Mapas de Dados

62 Opção Importar Definições de Registro Importar Campos/FDT de Chave Descrição Selecione essa opção para importar um copybook para o mapa de dados. Limpe essa opção para adicionar apenas o mapa de dados. O padrão é selecionado. Adabas. Selecione essa opção para importar um FDT Adabas e chaves Adabas para o mapa de dados. Limpe essa opção para adicionar apenas o mapa de dados. O padrão é selecionado. 3. Insira as informações na caixa de diálogo sobre o método de acesso que você escolher. A tabela a seguir lista a caixa de diálogo que aparece para cada método de acesso: Método de Acesso ADABAS DATACOM Caixa de Diálogo Método de Acesso ADABAS Método de Acesso DATACOM Referência Propriedades do Mapa de Dados - Método de Acesso do ADABAS na página 315 Propriedades do Mapa de Dados - Método de Acesso DATACOM na página 317 DB2 Método de Acesso DB2 Propriedades do Mapa de Dados - Método de Acesso DB2 na página 318 DB2UNLD DL/1 BATCH Método de Acesso DB2UNLD Método de Acesso Lote DL/1 Propriedades do Mapa de Dados - Método de Acesso DB2UNLD na página 318 Propriedades do Mapa de Dados - Método de Acesso Lote DL/I ou IMS ODBA na página 321 ESDS Método de Acesso ESDS Propriedades do Mapa de Dados - Método de Acesso ESDS na página 323 IDMS Método de Acesso IDMS Propriedades do Mapa de Dados - Método de Acesso IDMS na página 324 IMS ODBA Método de Acesso IMS ODBA Propriedades do Mapa de Dados - Método de Acesso Lote DL/I ou IMS ODBA na página 321 ISAM Método de Acesso ISAM Propriedades do Mapa de Dados - Método de Acesso ISAM na página 325 KSDS Método de Acesso KSDS Propriedades do Mapa de Dados - Método de Acesso KSDS na página 325 MQSERIES Método de Acesso MQSeries Propriedades do Mapa de Dados - Método de Acesso MQSeries na página 326 RRDS Método de Acesso RRDS Propriedades do Mapa de Dados - Método de Acesso RRDS na página 327 Adicionando um Mapa de Dados 45

63 Método de Acesso Caixa de Diálogo Referência SEQ Método de Acesso SEQ Propriedades do Mapa de Dados - Método de Acesso SEQ na página 328 TAPE Método de Acesso TAPE Propriedades do Mapa de Dados - Método de Acesso TAPE na página 331 USER Método de Acesso USER Propriedades do Mapa de Dados - Método de Acesso USER na página Para um mapa de dados Adabas, se você selecionou a opção Importar Campos de Chaves/FDT, clique em Avançar. Em seguida, digite informações na caixa de diálogo Importação do FDT Adabas. A tabela a seguir descreve as informações a serem inseridas: Opção Identificação de Usuário Senha Localização Senha do Arquivo Salvar ID de Usuário e Senha(s) para a sessão Descrição Insira um ID do usuário Adabas que tenha autoridade para acessar a localização. Insira uma senha para o ID do usuário especificado. Se você especificar um ID do usuário e omitir a senha, o Navegador do PowerExchange solicitará a senha na caixa de diálogo Senha Faltando. Selecione a localização do FDT. As opções são: - Local. O FDT está localizado no sistema do Navegador do PowerExchange. - Remoto. O FDT está localizado em um sistema remoto. As localizações exibidas na lista Localização são definidas pelas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. O padrão é Local. Se o arquivo do FDT for protegido por senha, digite a senha para acessar o arquivo. Selecione essa opção para salvar a Identificação de Usuário e a senha, e a senha do arquivo, se especificada, para o restante da sessão. O padrão é selecionado. 5. Se a opção Importar Definições de Registros estiver selecionada, clique em Próximo. Se você limpou essa opção, clique em Concluir. O mapa de dados é exibido na guia Mapa de Dados no Explorador de Recursos. Se você importou um FDT para um mapa de dados Adabas, edite as propriedades da tabela no mapa de dados para adicionar as chaves importadas à tabela. TÓPICOS RELACIONADOS: Adicionando uma Chave a uma Tabela em um Mapa de Dados Adabas na página 90 Importando um Copybook para um Mapa de Dados na página Capítulo 2: Mapas de Dados

64 Adicionando um Registro de Mapa de Dados Adicione um ou mais registros a um mapa de dados. Para mapas de dados de todos os tipos de fonte de dados, digite um nome de registro para adicionar um registro a um mapa de dados. Para Datacom, IDMS, lote IMS DL/1 e mapas de dados IMS ODBA, você deve digitar também informações adicionais. 1. Abra o mapa de dados. 2. Na guia Mapa de Dados, clique com o botão direito do mouse no mapa de dados e clique em Adicionar Registro. A caixa de diálogo Adicionar Registro é exibida. 3. Na guia Nome, defina propriedades do registro. As propriedades que você pode definir dependem do tipo de fonte de dados. 4. Clique em OK. O registro é exibido na guia Mapa de Dados no Explorador de Recursos. A janela Registro exibe o registro. Para um registro do mapa de dados Datacom, adicione elementos, chaves e os segmentos de chaves. Para um registro IDMS, adicione elementos CALC e registros e definições do proprietário. Para um lote IMS DL/1 ou registro de mapa de dados IMS ODBA, adicione campos CCK e campos de pesquisa. TÓPICOS RELACIONADOS: Adicionando um Elemento a um Registro Datacom na página 49 Adicionando uma Chave a um Registro Datacom na página 50 Adicionando um Segmento Chave a um Registro Datacom na página 51 Adicionando um Elemento CALC a um Registro IDMS na página 53 Adicionando um Registro e Conjunto do Proprietário a um Registro IDMS na página 53 Adicionando um Campo CCK a um Registro IMS na página 56 Adicionando campos de pesquisa para um registro do IMS na página 56 Propriedades do Registro, Campo e Tabela na página 338 Adicionando um Campo a um Registro Adicione um ou mais campos a um registro em um mapa de dados. 1. Abra o mapa de dados e o registro. 2. Para adicionar um campo ao final do registro, clique com o botão direito do mouse no nome do registro na janela Registro e clique em Adicionar Campo no Final. Para adicionar um campo adjacente a um campo, clique com o botão direito do mouse em um campo e selecione para adicionar o campo antes ou depois do campo selecionado ou como um filho de um campo GROUP. Adicionando um Registro de Mapa de Dados 47

65 3. Na guia Nome na caixa de diálogo Adicionar Campo, defina as propriedades do campo. 4. Clique em OK. A janela Registro exibe o campo. TÓPICOS RELACIONADOS: Propriedades do Campo - Nome na página 343 Adicionando um Campo Definido pelo Usuário a um Registro Nos mapas de dados, você pode definir campos em registros que usam uma ou mais funções do PowerExchange em uma expressão para processar dados da origem. Essas funções especificam operações como divisão e concatenação de campos. Você pode também usar a função CallProg em uma expressão para executar um programa definido pelo usuário para processar dados da origem. 1. Abra o mapa de dados e o registro. 2. Na janela Registro, clique na guia Expr(n). 3. Para adicionar um campo ao fim do registro, clique com o botão direito do mouse em qualquer lugar na guia Expr(n) e clique em Adicionar Campo no Final. Para adicionar um campo adjacente a um campo, clique com o botão direito do mouse nele e selecione para adicioná-lo antes ou depois do campo selecionado. 4. Para definir as propriedades do campo, clique nas células das colunas Nome, Tipo, Precisão, Escala, Tamanho e Fase. 5. Para digitar uma expressão para o campo, clique na célula da coluna Expressão ou clique no botão Procurar para abrir a caixa de diálogo Editor de Expressão. A tabela a seguir descreve as informações para inserir na caixa de diálogo Editor de Expressão: Opção Lista de Funções Expressão Descrição Dê um clique duplo em uma ou mais funções do PowerExchange para construir uma expressão. As funções são exibidas na caixa Expressão. Digite uma expressão para preencher ou processar os dados no campo. Uma expressão pode conter um ou mais dos seguintes itens: - Um texto ou constante numérica como Meu texto ou Uma função do PowerExchange, como Concat ou Split - A função CallProg do PowerExchange que especifica um programa Assembler, C, COBOL ou PL/I definido pelo usuário e seus parâmetros 48 Capítulo 2: Mapas de Dados

66 Opção Validar Validação Descrição Valida a expressão na caixa Expressão. Se o PowerExchange detecta um erro, uma mensagem de erro é exibida na caixa Validação. Exibe mensagens de erro para os erros detectados durante a validação de uma expressão. 6. Clique em OK. 7. Para testar o campo definido pelo usuário, execute as seguintes ações: Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse em uma tabela e clique em Propriedades. Na caixa de diálogo Propriedades da Tabela, selecione Atualizar com colunas não encontradas na lista Geração de Coluna. Clique em OK. Execute um teste de linha de banco de dados na tabela. TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Visão Geral de Funções do PowerExchange para Campos Definidos pelo Usuário na página 272 Adicionando Itens a um Registro Datacom Edite um registro em um mapa de dados Datacom para adicionar itens específicos Datacom ao registro. Você pode adicionar um ou mais elementos, chaves e segmentos chave a um registro Datacom. Adicionando um Elemento a um Registro Datacom Adicione um ou mais elementos a um registro em um mapa de dados Datacom. Para adicionar um elemento a um registro Datacom: 1. Abra o mapa de dados Datacom. 2. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. A caixa de diálogo Propriedades do Registro é exibida. 3. Na guia Elementos, clique no botão da barra de ferramentas Adicionar Novo. A caixa de diálogo Adicionar Novo Elemento é exibida. 4. Na caixa de diálogo Adicionar Novo Elemento, defina as propriedades do elemento. Adicionando Itens a um Registro Datacom 49

67 A tabela a seguir descreve as informações a serem inseridas: Opção Nome Posição Tamanho Descrição Digite o nome do elemento do registro. Digite o deslocamento de posição do elemento desde o início do registro. O padrão é 1. Digite o tamanho do elemento. O padrão é Clique em OK. O elemento é exibido na lista Elementos na guia Elementos. TÓPICOS RELACIONADOS: Itens de Mapa de Dados Datacom na página 42 Exibindo ou Editando Propriedades para um Elemento em um Registro Datacom na página 66 Adicionando uma Chave a um Registro Datacom Adicione uma ou mais chaves a um registro em um mapa de dados Datacom. Para adicionar uma chave a um registro Datacom: 1. Abra o mapa de dados Datacom. 2. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. A caixa de diálogo Propriedades do Registro é exibida. A tabela a seguir descreve as informações exibidas para todas as chaves definidas na guia Chaves da caixa de diálogo Propriedades do Registro: Opção Nome Longo da Chave Nome Curto da Chave Descrição O nome longo da chave. O tamanho máximo é de 32 caracteres. O nome curto da chave. O tamanho máximo é de cinco caracteres. 3. Na guia Chaves, clique no botão da barra de ferramentas Adicionar Novo. A caixa de diálogo Propriedades Chave é exibida. 4. Na guia Detalhes da Chave, defina a chave. 50 Capítulo 2: Mapas de Dados

68 A tabela a seguir descreve as informações a serem inseridas: Opção Nome Longo da Chave Nome Curto da Chave Chave Mestra Alteração Permitida Único Duplicata Permitida Nativo Anulável Seleção Booleana Composta Permitida Descrição Digite o nome longo da chave. O tamanho máximo é de 32 caracteres. Digite o nome curto da chave. O tamanho máximo é de cinco caracteres. Digite a chave mestra para a tabela. Cada tabela exige uma chave mestra. A chave mestra pode ser a mesma que a chave nativa. Selecione essa opção para permitir que a chave mestra seja alterada. Limpe essa opção para impedir que a chave mestra seja alterada. Se você limpar essa opção, o CA Datacom/DB proibirá qualquer mudança no calor da chave mestra para uma linha na tabela. O padrão é limpo. Selecione essa opção para proibir chaves mestras duplicadas. O padrão é limpo. Selecione essa opção para permitir chaves mestras duplicadas. O padrão é limpo. Selecione essa opção para definir a chave como a chave de sequência nativa para essa tabela. Cada tabela exige uma, e apenas uma, chave nativa, que designa a ordem em que os dados são carregados e mantidos. A chave nativa representa a ordem usada com maior frequência no processamento sequencial. O padrão é limpo. Selecione essa opção para permitir que a chave tenha valores nulos colocados no índice. Nulo representa valores baixos ou em branco. O padrão é limpo. Selecione essa opção para permitir a seleção Booleana composta. O padrão é limpo. 5. Clique em OK. A chave é exibida na lista Chaves na guia Chaves. TÓPICOS RELACIONADOS: Itens de Mapa de Dados Datacom na página 42 Exibindo ou Editando Propriedades para uma Chave em um Registro Datacom na página 66 Adicionando um Segmento Chave a um Registro Datacom Adicione um ou mais segmentos chave a um registro em um mapa de dados Datacom. Para adicionar um segmento chave a um registro Datacom: 1. Abra o mapa de dados Datacom. Adicionando Itens a um Registro Datacom 51

69 2. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. A caixa de diálogo Propriedades do Registro é exibida. 3. Na guia Chaves, selecione a chave na lista Chaves e clique no botão da barra de ferramentas Propriedades. A caixa de diálogo Propriedades Chave é exibida. 4. Na guia Detalhes do Segmento, clique no botão da barra de ferramentas Adicionar Novo. A caixa de diálogo Novo Segmento é exibida. 5. Na caixa de diálogo Novo Segmento, defina o segmento chave. A tabela a seguir descreve as informações a serem inseridas: Opção Nome Descrição Digite o nome do segmento chave. Nota: Esse campo é somente leitura na guia Detalhes do Segmento na caixa de diálogo Propriedades Chave. Posição Tamanho Ordem Sensibilidade Digite a posição do segmento chave. O padrão é 1. Digite o tamanho do segmento chave. O padrão é 1. Selecione uma das opções a seguir para especificar a ordem do segmento chave: - ASC. Ordem crescente. - DESC. Ordem decrescente. Selecione uma das opções a seguir para especificar a sensibilidade do segmento chave: - ON. A sensibilidade está ativada. - OFF. A sensibilidade está desativada. 6. Clique em OK. O segmento chave é exibido na lista Detalhes do Segmento na guia Detalhes do Segmento. TÓPICOS RELACIONADOS: Itens de Mapa de Dados Datacom na página 42 Exibindo ou Editando Propriedades para um Segmento de Chave em um Registro Datacom na página 66 Adicionando Itens a um Registro IDMS Edite um registro em um mapa de dados IDMS para adicionar itens específicos IDMS ao registro. Você pode adicionar um ou mais elementos CALC e registros e conjuntos do proprietário a um registro IDMS. 52 Capítulo 2: Mapas de Dados

70 Adicionando um Elemento CALC a um Registro IDMS Adicione um ou mais elementos CALC a um registro em um mapa de dados IDMS. Para adicionar um elemento CALC a um registro IDMS: 1. Abra o mapa de dados IDMS. 2. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. A caixa de diálogo Propriedades do Registro é exibida. 3. Na guia Nomes de Elementos CALC, clique no botão da barra de ferramentas Adicionar Novo. A caixa de diálogo Novo Elemento CALC é exibida. 4. Na caixa de diálogo Novo Elemento CALC, defina o elemento CALC. A tabela a seguir mostra as informações a serem inseridas: Opção Nome Posição Tamanho Descrição Digite o nome do elemento CALC. Digite o deslocamento de posição do elemento CALC desde o início do registro. O padrão é 1. Digite o tamanho do elemento CALC. O padrão é Clique em OK. O elemento CALC é exibido na lista Nomes de Elementos CALC na guia Nomes de Elementos CALC. Para obter informações sobre as propriedades exibidas para um elemento CALC, consulte Adicionando um Registro e Conjunto do Proprietário a um Registro IDMS na página 53. TÓPICOS RELACIONADOS: Exibindo ou Editando Propriedades para um Elemento CALC em um Registro IDMS na página 67 Adicionando um Registro e Conjunto do Proprietário a um Registro IDMS Adicione um ou mais registros e conjuntos do proprietário a um registro em um mapa de dados IDMS. Para adicionar um registro e conjunto do proprietário a um registro IDMS: 1. Abra o mapa de dados IDMS. 2. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. A caixa de diálogo Propriedades do Registro é exibida. 3. Na guia Nomes do Registro e do Conjunto do Proprietário, clique no botão da barra de ferramentas Adicionar Novo. A caixa de diálogo Propriedades do Registro e do Conjunto do Proprietário é exibida. 4. Na guia Detalhes do Registro e do Conjunto do Proprietário, defina as propriedades do registro e do conjunto do proprietário. Adicionando Itens a um Registro IDMS 53

71 A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Proprietário Definir Nome Nome da Área Ordem Modo Duplica Descrição Digite o nome do registro pai. Digite SYSTEM para identificar o conjunto como um índice de propriedade do sistema. Digite uma descrição do relacionamento entre o registro e o proprietário. Digite o nome da área na qual estão localizados o registro do proprietário e a estrutura do índice. Ativado quando você edita um registro e um conjunto do proprietário existentes com um nome de proprietário de SYSTEM. Selecione a ordem lógica para adicionar novas ocorrências de registro do membro a uma ocorrência de conjunto no tempo de execução: - Nenhuma - Primeiro - Último - Próximo - Anterior - Ordenado Nota: Se você selecionar Ordenado, a guia Ordenar Nome do Elemento será exibida na caixa de diálogo Nomes do Registro e do Conjunto do Proprietário. Clique na guia Ordenar Nome do Elemento para definir a ordem para os elementos. O padrão é nenhum. Selecione a característica do conjunto que determina como os ponteiros CA IDMS/DB são mantidos no tempo de execução: - Nenhuma - Cadeia - Cadeia Vinculada ao Índice Anterior - Índice VSAM O padrão é nenhum. Selecione como o CA IDMS/DB gerencia uma ocorrência de registro com uma chave de ordenação que duplica a chave de ordenação de uma ocorrência existente: - Nenhuma - Por DBKey - Primeiro - Último - Não Permitidos O padrão é nenhum. 54 Capítulo 2: Mapas de Dados

72 Opção Definir Opções Descrição Selecione uma das seguintes opções de conjunto: - Nenhuma - Automático Obrigatório - Manual Obrigatório - Automático Opcional - Manual Opcional O padrão é nenhum. Sequência Natural Vinculado ao Proprietário Posição da Chave do Proprietário Grupo de Página Raiz do Proprietário Selecione essa opção para usar a sequência de ordenação natural, que ordena e avalia os campos de chaves usando valores negativos antes de valores positivos. Limpe essa opção para usar a sequência de ordenação padrão. Por padrão, o CA IDMS/DB ordena e avalia os campos de chaves usando uma sequência de agrupamento padrão, que ordena dados por seu valor hexadecimal. O padrão é limpo. Selecione essa opção para vincular cada registro do membro do tipo especificado no conjunto ao registro do proprietário. Não é possível alterar essa opção se o relacionamento já está sendo usado por uma tabela definida no mapa de dados. Ativado se a opção Vinculado ao Proprietário estiver selecionada. Digite a posição no registro da chave do proprietário. Esse valor é a posição de chave de banco de dados do proprietário ou o valor do índice, relativo a 1, definido em uma instrução do conjunto do esquema. Se você não digitar um valor de posição, um valor será automaticamente designado. O padrão é 0. Digite o grupo de página IDMS do registro do proprietário. O valor máximo é O padrão é 0. Digite a raiz IDMS para o registro do proprietário. Os valores válidos vão de 0 a 12. O padrão é Clique em OK. O registro e o conjunto do proprietário são exibidos na lista Nomes do Registro e do Conjunto do Proprietário na guia Detalhes do Registro e do Conjunto do Proprietário. TÓPICOS RELACIONADOS: Itens de Mapa de Dados IDMS na página 42 Exibindo ou Editando Propriedades para um Registro do Proprietário e um Conjunto em um Registro IDMS na página 67 Adicionando Itens a um registro do IMS Editar um registro em um lote IMS DL/1 ou mapa de dados ODBA do IMS para adicionar itens específicos IMS. Adicionando Itens a um registro do IMS 55

73 Você pode adicionar um ou mais campos CCK e campos de pesquisa a um registro em lote IMS Adicionando um Campo CCK a um Registro IMS Adicione um ou mais campos CCK a um registro em um lote IMS DL/1 ou mapa de dados ODBA do IMS. 1. Abra o mapa de dados. 2. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. A caixa de diálogo Propriedades do Registro é exibida. 3. Na guia Campos CCK, clique no botão da barra de ferramentas Adicionar Novo. A caixa de diálogo Novo Campo CCK é exibida. 4. Na caixa de diálogo Novo Campo CCK, defina as propriedades do campo CCK. A tabela a seguir descreve as informações a serem inseridas: Opção Nome Tipo de Campo Precisão Escala Tamanho Página de Código de Dados Descrição Digite um nome para o campo CCK. O nome deve ser um nome de campo no IMS DBD, geralmente o nome de um campo SEQUENCE. Pode ser qualquer nome de campo definido dentro de um SEGM. O tamanho máximo é de oito caracteres. Os caracteres válidos são caracteres ASCII e o sinal de libra e de iene. Selecione o tipo de dados do campo. Digite a precisão do campo. Digite a escala do campo. Digite o tamanho do campo. Selecione uma página de código para o conteúdo do campo CCK. A página de código descreve o conjunto de caracteres para os dados de caractere no banco de dados. 5. Clique em OK. O campo CCK é exibido na lista Campos CCK na guia Campos CCK. Para exibir colunas CCK, selecione a opção Gerar Colunas CCK nas propriedades do mapa de dados IMS tabela que está baseada no registro que contém os campos de CCK. TÓPICOS RELACIONADOS: Itens do Mapa de dados IMS na página 42 Exibindo ou Editando Propriedades para um Campo CCK em um Registro de Lote IMS na página 68 Propriedades da Tabela - Definição na página 353 Adicionando campos de pesquisa para um registro do IMS Adicionar um ou mais campos de pesquisa para um lote IMS DL/1 registro de mapa de dados ou IMS ODBA. 56 Capítulo 2: Mapas de Dados

74 1. Abra o mapa de dados. Nota: Se a mensagem PWX foi exibida, o DBD importado para o mapa de dados forneceu o valor do tipo de chave de "S" para um campo de pesquisa do registro. O tipo de chave "S", para campos de sequência, foi solicitado. Edite as propriedades do registro para alterar o valor Chave do campo de pesquisa para U. 2. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. A caixa de diálogo Propriedades do Registro é exibida. 3. Na guia Campos de Pesquisa, clique no botão da barra de ferramentas Adicionar Novo. 4. Na caixa de diálogo Novo Campo de Pesquisa, defina o campo de pesquisa. A tabela a seguir descreve as informações a serem inseridas: Opção Nome Posição Tamanho Chave Descrição Digite um nome para o campo de pesquisa. O nome deve ser um nome de campo no IMS DBD, geralmente o nome de um campo SEQUENCE. Pode ser qualquer nome de campo definido dentro de um SEGM. O tamanho máximo é de oito caracteres. Os caracteres válidos são caracteres ASCII e o sinal de libra e de iene. Digite a posição do campo de pesquisa. Os valores válidos vão de 1 a O padrão é 1. Digite o tamanho do campo de pesquisa. Os valores válidos vão de 1 a O padrão é 1. Selecione um dos seguintes tipos de chave: - Em branco. - U. Tipo de chave exclusiva. - M. Normalmente, o tipo de chave não exclusiva. O padrão é U. 5. Clique em OK. O campo de pesquisa é exibido na lista Campos de Pesquisa na guia Campos de Pesquisa. TÓPICOS RELACIONADOS: Itens do Mapa de dados IMS na página 42 Exibindo ou Editando Propriedades para um Campo de Pesquisa em um Registro de Lote IMS na página 68 Adicionando uma Tabela de Mapa de Dados Se você importar um copybook para um mapa de dados para definir o layout dos dados na fonte, o PowerExchange criará tabelas e colunas no mapa de dados baseadas nos registros e nos campos importados. Adicionando uma Tabela de Mapa de Dados 57

75 Você também pode adicionar manualmente tabelas e colunas a um mapa de dados. As colunas em tabelas são baseadas em campos em registros. Você pode definir uma tabela complexa baseada em vários registros. Em um mapa de dados, uma tabela complexa espelha a hierarquia de registros ou segmentos na fonte de dados associada, como um banco de dados IMS ou CA IDMS/DB, conjunto de dados ou conjunto de dados sequencial. Quando você define uma tabela complexa, define um relacionamento hierárquico entre os registros nos quais a tabela é baseada. Você pode também definir opções que controlam como os registros em quais colunas na tabela complexa são exibidos em um teste de linha do banco de dados e são mapeados para linhas e colunas em uma tabela de destino. 1. Abra o mapa de dados. 2. Na guia Mapa de Dados, clique com o botão direito do mouse no mapa de dados e clique em Adicionar Tabela. 3. Dependendo da fonte de dados para o mapa de dados, exiba ou defina as seguintes propriedades em algumas entre todas as seguintes guias na caixa de diálogo Propriedades da Tabela: Definição. Propriedades para uma tabela complexa, incluindo definições para como os registros em uma tabela complexa são exibidos em um teste de linha do banco de dados ou são mapeados em uma tabela de destino e como as mudanças nos registros nos quais a tabela é baseada são refletidas nas colunas correspondentes na tabela. Filtro. Colunas de filtro por nome para incluí-las em uma tabela ou excluí-las dela. Chaves. Para Adabas, a chave primária para a tabela. Opções IMS. Para lote IMS DL/1 e IMS ODBA, propriedades para segmentos em uma tabela complexa. 4. Clique em OK. A tabela é exibida na guia Mapa de Dados no Explorador de Recursos. A janela Tabela exibe a tabela. TÓPICOS RELACIONADOS: Adicionando uma Chave a uma Tabela em um Mapa de Dados Adabas na página 90 Adicionando um Mapa de Dados de Vários Registros com uma Tabela Complexa - Exemplo na página 233 Propriedades da Tabela - Definição na página 353 Propriedades da Tabela - Filtro na página 356 Propriedades da Tabela - Chaves na página 358 Propriedades da Tabela - Opções IMS na página 357 Adicionando uma Coluna a uma Tabela Adicione uma ou mais colunas a uma tabela em um mapa de dados. 1. Abra o mapa de dados e a tabela. 2. Para adicionar uma coluna ao fim da tabela, clique com o botão direito do mouse no nome da tabela na janela Tabela e clique em Adicionar Coluna no Final. 58 Capítulo 2: Mapas de Dados

76 Para adicionar uma coluna adjacente a uma coluna, clique com o botão direito do mouse nela e selecione para adicioná-la antes ou depois da coluna selecionada. A caixa de diálogo Adicionar Coluna é exibida. 3. Na guia Nome, insira as propriedades da coluna. A tabela a seguir descreve essas propriedades: Opção Nome Campo Base Descrição Digite um nome definido pelo usuário para a coluna. O nome da coluna deve ser exclusivo dentro da tabela. Os caracteres válidos são caracteres alfanuméricos ASCII e o sinal de libra e de iene. O primeiro caractere deve ser alfabético. O tamanho máximo é de 32 caracteres. Selecione um campo no registro no qual basear a coluna. 4. Clique em OK. A janela Tabela exibe a coluna. TÓPICOS RELACIONADOS: Exibindo ou Editando Propriedades para uma Coluna em uma Tabela na página 70 Exibindo Registros e Campos Você pode exibir um ou mais registros em um mapa de dados e campos em cada registro. Cada registro é exibido em sua própria janela Registro. Uma janela Registro exibe o nome do registro e os campos no registro. Para exibir registros e campos: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados do Explorador de Recursos, conclua uma das seguintes ações: Para exibir um único registro, dê um clique duplo no registro. Para exibir vários registros, cada um em uma janela separada Registro, clique com o botão direito do mouse em cada registro e clique em Explorar. A guia Campos em uma janela Registro exibe o nome do registro e as seguintes informações para cada campo: Nome do campo Tipo de dados Valores de precisão, escala e tamanho, entre parênteses Se o campo for definido como um array, o valor ARRAY seguido pelo número de elementos no array O deslocamento decimal do campo dentro do registro O deslocamento hexadecimal do campo dentro do registro Exibindo Registros e Campos 59

77 A guia Expr(n) na janela Registro exibe os campos definidos pelo usuário. A variável n indica o número de campos definidos pelo usuário. Cada linha na guia Expr(n) contém uma definição de campo ou a atribuição de um valor a um campo definido. A tabela a seguir descreve as colunas que a guia Expr(n) exibe para cada campo: Coluna Indicador de status do campo Descrição Indica o status do campo. As opções são: - Marca de seleção. O campo é válido. - X. O campo não é válido. O comentário na coluna Validação descreve o tipo de erro que o campo contém. - Seta. Um novo campo é selecionado, após selecionar um dos comandos de menu Adicionar Campo. Nome Tipo Precisão Escala Tamanho Fase O nome definido pelo usuário para o campo. O tipo de dados do campo. A precisão do campo. A escala do campo. O tamanho do campo. Indica o tipo de comunicação de banco de dados para o campo definido pelo usuário. Por exemplo, se um campo for definido com uma fase de R, sua expressão não será recalculada quando o banco de dados estiver sendo gravado. As opções são: - R. Ler. - W. Gravar. - RW. Ler e gravar. Expressão Validação Qualquer expressão definida para o campo. Se você clicar em Validar na caixa de diálogo Editor de Expressão, a coluna Validação exibirá a mensagem de validação. 3. Para ordenar ou excluir campos na guia Expr(n), execute as seguintes ações: Para mover um campo para cima ou para baixo na janela, clique com o botão direito do mouse em um campo e clique em Mover Campo para Cima ou Mover Campo para Baixo. Para mover os campos preenchidos para a parte superior da lista, clique com o botão direito do mouse em qualquer lugar na guia Expr(n) na janela Registro e clique em Organizar Campos. Para excluir um campo, clique com o botão direito do mouse em um campo e clique em Excluir Campo. 4. Para exibir ou ocultar colunas que definem os atributos de tipo de dados para campos na guia Expr(n), clique com o botão direito do mouse em qualquer lugar na guia Expr(n) da janela Registro e clique em um dos seguintes comandos: Para exibir ou ocultar as colunas Tipo, Precisão, Escala e Tamanho, clique em Ocultar Colunas de Tipo ou Exibir Colunas de Tipo. 60 Capítulo 2: Mapas de Dados

78 Para exibir todas as colunas e restaurar todas as colunas para a largura padrão, clique em Restaurar Colunas. TÓPICOS RELACIONADOS: Adicionando um Campo Definido pelo Usuário a um Registro na página 48 Exibindo Tabelas e Colunas Você pode exibir uma ou mais tabelas em um mapa de dados e colunas em cada tabela. Cada tabela é exibida em sua própria janela Tabela. Uma janela Tabela exibe o nome da tabela e as colunas na tabela. 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, conclua uma das seguintes ações: Para exibir uma única tabela, dê um clique duplo na tabela. Para exibir várias tabelas, cada uma em uma janela separada Tabela, clique com o botão direito do mouse em cada tabela e clique em Explorar. Quando você abre uma tabela, a janela Tabela exibe o nome da tabela e as seguintes informações para cada coluna na tabela: Nome da coluna Registro e campo nos quais a coluna é baseada, no seguinte formato: registro:campo Tipo de dados do campo no qual a coluna é baseada Tamanho do campo no qual a coluna é baseada, entre parênteses Exibindo um Arquivo de Dados Se um mapa de dados tiver um arquivo de dados associado, você pode exibir o arquivo de dados na janela Arquivo de Dados. Defina o formato de exibição padrão e o número de registros a serem inicialmente exibidos na caixa de diálogo Preferências do Mapa de Dados. Ao exibir o arquivo de dados, você pode exibir registros adicionais até que todos os registros no arquivo de dados sejam exibidos. Além disso, você pode exibir uma régua acima de um registro para exibir o número de caracteres no registro. 1. Abra o mapa de dados. 2. Na guia Recursos do Explorador de Recursos, clique em Arquivo > Exibir Arquivo de Dados. Nota: Se o mapa de dados não tiver um arquivo de dados associado, esse comando não estará disponível. Na primeira vez que você abre um arquivo de dados para um mapa de dados em uma sessão, a caixa de diálogo Nó Remoto do Arquivo de Dados é exibida. Em seguida, será exibida a janela Arquivo de Dados. Exibindo Tabelas e Colunas 61

79 3. Se a caixa de diálogo Nó Remoto do Arquivo de Dados for exibida, digite as informações de conexão para o sistema no qual o arquivo de dados está localizado e clique em OK. A tabela a seguir descreve as informações de conexão a serem inseridas: Opção Identificação de Usuário Senha Localização Senha do Arquivo Salvar ID de Usuário e Senha(s) para a sessão Descrição Se um ID do usuário for necessária para acessar o sistema onde o arquivo está localizado, insira um ID do usuário. Se você especificar um ID do usuário, insira uma senha do ID do usuário. Para acessar um arquivo no i5/os ou no z/os, você pode inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Um código de acesso pode conter os seguintes caracteres: - Letras em maiúsculas e minúsculas - Os números de 0 a 9 - Espaços - Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Selecione o nome do nó do sistema onde o arquivo de dados está localizado. Este campo lista as localizações definidas nas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. O padrão é local. Se for exigida uma senha para acessar o arquivo de dados, digite-a. Selecione esta opção para salvar as informações inseridas durante a sessão. O padrão é selecionado. 62 Capítulo 2: Mapas de Dados

80 A tabela a seguir descreve as colunas que a janela Arquivo de Dados exibe para cada registro no arquivo de dados: Coluna Descrição Nº do Registro O número do registro. Deslocamento Dados O deslocamento de dados dos dados hexadecimais. Usado para o formato de exibição vertical. Os dados de registro, que são exibidos em um dos seguintes formatos de exibição: - Caractere/Hex. Exibe registros no formato de caractere e no formato hexadecimal. - Caractere. Exibe registros no formato de caractere. - Vertical. Exibe registros verticalmente no formato de caractere e no formato hexadecimal. O padrão é Vertical. Por padrão, dez registros são exibidos. 4. Para exibir registros adicionais no arquivo de dados, insira o número de registros a serem exibidos na caixa ao lado do botão da barra de ferramentas Obter Registros. Clique no botão da barra de ferramentas Obter Registros. Depois que todos os registros tiverem sido recuperado, uma caixa de mensagem indica que o final do arquivo foi atingido. 5. Para alterar o formato de exibição ou exibir ou ocultar a escala de um registro, execute estas ações: Para alterar o formato de exibição, clique em Modo e clique em um formato de exibição. Para exibir ou ocultar a escala para um registro, clique com o botão direito do mouse em um registro e clique em Exibir Escala ou Ocultar Escala. TÓPICOS RELACIONADOS: Definindo Preferências do Mapa de Dados na página 24 Ordenando Registros e Tabelas de Mapa de Dados Você pode ordenar os registros e tabelas em um mapa de dados em ordem alfabética. Por padrão, os registros e tabelas são exibidos em um mapa de dados na ordem em que foram adicionados. Ordenar registros e tabelas em ordem alfabética é uma operação temporária. Da próxima vez que você abrir um mapa de dados, os registros e tabelas serão exibidos em sua ordem de classificação original. Para ordenar registros e tabelas de dados em um mapa de dados: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no mapa de dados e clique em Ordenar Itens. Ordenando Registros e Tabelas de Mapa de Dados 63

81 Exibindo ou Editando Propriedades para um Mapa de Dados ou Itens em um Mapa de Dados Você pode exibir ou editar propriedades para registros, campos, incluindo campos definidos pelo usuário e campos definidos como arrays, tabelas e colunas em um mapa de dados. Nota: O termo registro refere-se aos registros e aos segmentos. Com base no tipo de fonte de dados, você pode também exibir ou editar propriedades para os seguintes itens nos registros do mapa de dados: Datacom. Elementos, chaves e segmentos de chaves. IDMS. Elementos CALC e registros e conjuntos do proprietário. Lote IMS DL/1. Campos CCK e de pesquisa. Exibindo ou Editando Propriedades para um Mapa de Dados Você pode exibir ou editar propriedades que pertencem a um mapa de dados inteiro. Para exibir ou editar propriedades para um mapa de dados: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no mapa de dados e clique em Propriedades. A caixa de diálogo Propriedades do Mapa de Dados é exibida. 3. Com base no tipo de fonte de dados do mapa de dados, exiba ou edite propriedades do mapa de dados em algumas ou em todas as guias: Nome. O nome do esquema, o nome do mapa de dados e o método de acesso. Método de Acesso. Informações do método de acesso. Padrões de Dados. Valores padrão para datas e caracteres de substituição para campos que falham na verificação de dados. Verificação de Dados. O tipo de verificação de dados que o PowerExchange executa para erros de mapeamento de registro e de dados de campo. Programa de Saída de Nível de Registro. Um programa de saída de nível de registro. Chaves. Somente leitura. Para o Adabas, informações sobre chaves. Exibindo ou Editando Propriedades para um Registro de Mapa de Dados Você pode exibir ou editar propriedades para um registro ou segmento em um mapa de dados. Para exibir ou editar propriedades para um registro do mapa de dados: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse em um registro e clique em Propriedades. A caixa de diálogo Propriedades do Registro é exibida. 3. Com base no tipo de fonte de dados do mapa de dados, exiba ou edite propriedades do registro em algumas ou em todas as guias: 64 Capítulo 2: Mapas de Dados

82 Nome. Para todos os tipos de fontes de dados, exceto Datacom e IDMS, o nome do registro definido pelo usuário. Para Datacom, o nome longo da tabela, o nome curto da tabela e outras informações. Para IDMS, o nome do registro, o nome do registro IDMS correspondente e outras informações. Detalhes da Importação. Somente leitura. Informações sobre o último copybook importado. Chaves. Para Datacom, o nome longo e o nome curto para uma chave. Elementos. Para Datacom, o nome, a posição e o tamanho para um elemento. Nomes de Elementos CALC. Para IDMS, o nome, a posição e o tamanho para um elemento CALC. Registros do Proprietário e Nomes de Conjuntos. Para IDMS, o registro do proprietário e as propriedades dos conjuntos. Campos CCK. Para IMS, as propriedades do campo CCK. Campos de Pesquisa. Para IMS, as propriedades do campo de pesquisa. Exibindo ou Editando Propriedades para um Campo em um Registro Você pode exibir ou editar propriedades para um campo em um registro em um mapa de dados. Você pode editar propriedades para um campo para alterar seu nome ou tipo de dados, definir o campo como um array ou alterar a página de códigos para o campo. Para exibir ou editar propriedades para um campo em um registro: 1. Abra o mapa de dados e o registro. 2. Na janela Registro, clique com o botão direito do mouse em um campo e clique em Propriedades. A caixa de diálogo Propriedades do Campo é exibida. 3. Com base no tipo de fonte de dados do mapa de dados e no tipo de dados do campo, exiba ou edite as propriedades do campo em algumas ou em todas as guias: Nome. O nome para o campo. Array. Propriedades para definir o campo como um array. Propriedades Extra. Somente leitura. As propriedades de metadados estendidas para o campo. Verificação de Campo. Para os tipos de dados CHAR, NUMCHAR, PACKED, SPACKED, UPACKED, UZONED, VARCHAR e ZONED, o tipo de verificação de dados que o PowerExchange conclui no nível de campo, que sobrescreve o comportamento da verificação de dados definido para o mapa de dados. Página de Códigos. Para os tipos de dados CHAR e NUMCHAR para alguns tipos de fonte de dados, a página de códigos para o campo, que sobrescreve a página de códigos definida para o mapa de dados. Tamanho da Variável. Para os tipos de dados VARBIN e VARCHAR, as propriedades para um campo de tamanho variável. TÓPICOS RELACIONADOS: Propriedades do Campo - Nome na página 343 Propriedades do Campo - Array na página 349 Propriedades do Campo - Tamanho Variável na página 353 Propriedades do Campo - Propriedades Extras na página 351 Exibindo ou Editando Propriedades para um Mapa de Dados ou Itens em um Mapa de Dados 65

83 Propriedades do Campo - Verificação do Campo na página 351 Propriedades do Campo - Página de Códigos na página 352 Exibindo ou Editando Propriedades para um Elemento em um Registro Datacom Você pode exibir ou editar propriedades para um elemento em um registro em um mapa de dados Datacom. 1. Abra o mapa de dados Datacom. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. A guia Elementos na caixa de diálogo Propriedades do Registro exibe propriedades para elementos definidos. 3. Para editar propriedades para um elemento, selecione o elemento na lista Elementos e clique no botão da barra de ferramentas Propriedades. 4. Na caixa de diálogo Novo Elemento, exiba ou edite as propriedades do elemento. TÓPICOS RELACIONADOS: Adicionando um Elemento a um Registro Datacom na página 49 Itens de Mapa de Dados Datacom na página 42 Exibindo ou Editando Propriedades para uma Chave em um Registro Datacom Você pode exibir ou editar propriedades para uma chave em um registro Datacom. Para exibir ou editar propriedades para uma chave em um registro Datacom: 1. Abra o mapa de dados Datacom. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. 3. Na guia Chaves na caixa de diálogo Propriedades do Registro, selecione a chave na lista Chaves e clique no botão da barra de ferramentas Propriedades. A guia Detalhes da Chave na caixa de diálogo Propriedades da Chave exibe as propriedades para a chave. 4. Na guia Detalhes da Chave, exiba ou edite as propriedades da chave. TÓPICOS RELACIONADOS: Adicionando uma Chave a um Registro Datacom na página 50 Itens de Mapa de Dados Datacom na página 42 Exibindo ou Editando Propriedades para um Segmento de Chave em um Registro Datacom Você pode exibir ou editar propriedades para um segmento de chave em um registro Datacom. Para exibir ou editar propriedades para um segmento de chave em um registro Datacom: 1. Abra o mapa de dados Datacom. 66 Capítulo 2: Mapas de Dados

84 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. 3. Na guia Chaves na caixa de diálogo Propriedades do Registro, selecione uma chave na lista Chaves e clique no botão da barra de ferramentas Propriedades. A guia Detalhes do Segmento na caixa de diálogo Propriedades da Chave exibe as propriedades para os segmentos definidos da chave. 4. Para editar propriedades para o segmento da chave, selecione-o na lista Detalhes do Segmento e clique no botão da barra de ferramentas Propriedades. 5. Na caixa de diálogo Novo Segmento, exiba ou edite as propriedades do segmento da chave. TÓPICOS RELACIONADOS: Adicionando um Segmento Chave a um Registro Datacom na página 51 Itens de Mapa de Dados Datacom na página 42 Exibindo ou Editando Propriedades para um Elemento CALC em um Registro IDMS Você pode exibir ou editar propriedades para um elemento CALC em um registro IDMS. Para exibir ou editar propriedades para um elemento CALC em um registro IDMS: 1. Abra o mapa de dados IDMS. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. 3. A guia Nomes de Elementos CALC na caixa de diálogo Propriedades do Registro exibe propriedades para elementos CALC definidos. 4. Para editar propriedades para um elemento CALC, selecione-o na lista Elementos CALC e clique no botão da barra de ferramentas Propriedades. 5. Na caixa de diálogo Novo Elemento CALC, exiba ou edite as propriedades dos elementos CALC. TÓPICOS RELACIONADOS: Adicionando um Elemento CALC a um Registro IDMS na página 53 Itens de Mapa de Dados IDMS na página 42 Exibindo ou Editando Propriedades para um Registro do Proprietário e um Conjunto em um Registro IDMS Você pode exibir ou editar propriedades para um registro e conjunto do proprietário em um registro IDMS. Para exibir ou editar propriedades para um registro e conjunto do proprietário em um registro IDMS: 1. Abra o mapa de dados IDMS. 2. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. A caixa de diálogo Propriedades do Registro e do Conjunto do Proprietário é exibida. Exibindo ou Editando Propriedades para um Mapa de Dados ou Itens em um Mapa de Dados 67

85 A tabela a seguir descreve as informações que a guia Registro e Conjunto do Proprietário da caixa de diálogo Propriedades do Registro e Conjunto do Proprietário exibe para quaisquer registros e conjuntos do proprietário definidos: Opção Nome do Proprietário Definir Nome Descrição Somente leitura. O nome do registro pai. O nome SYSTEM, que é um nome reservado, identifica o conjunto como um índice de propriedade do sistema. Especificar o relacionamento entre o registro e o proprietário. 3. Para editar propriedades para um registro e conjunto do proprietário, selecione o registro e o conjunto do proprietário na lista Nomes do Registro e Conjunto do Proprietário e clique no botão da barra de ferramentas Propriedades. A caixa de diálogo Propriedades do Registro e do Conjunto do Proprietário é exibida. 4. Na guia Detalhes do Registro e Conjunto do Proprietário, exiba ou edite as propriedades do registro e conjunto do proprietário. TÓPICOS RELACIONADOS: Adicionando um Registro e Conjunto do Proprietário a um Registro IDMS na página 53 Itens de Mapa de Dados IDMS na página 42 Exibindo ou Editando Propriedades para um Campo CCK em um Registro de Lote IMS Você pode exibir ou editar propriedades para um campo CCK em um registro em um lote IMS DL/1 ou mapa de dados ODBA. 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. A guia Campos CCK na caixa de diálogo Propriedades do Registro exibe propriedades para campos CCK definidos. 3. Para editar propriedades para um campo CCK, selecione-o na lista Campos CCK e clique no botão da barra de ferramentas Propriedades. 4. Na caixa de diálogo Novo Campo CCK, exiba ou edite as propriedades dos campos CCK. TÓPICOS RELACIONADOS: Adicionando um Campo CCK a um Registro IMS na página 56 Itens do Mapa de dados IMS na página 42 Exibindo ou Editando Propriedades para um Campo de Pesquisa em um Registro de Lote IMS Você pode exibir ou editar propriedades para um campo de pesquisa em um registro em um lote IMS DL/1 ou mapa de dados ODBA do IMS. 68 Capítulo 2: Mapas de Dados

86 1. Abra o mapa de dados. Nota: Se a mensagem PWX foi exibida, o DBD importado para o mapa de dados forneceu o valor do tipo de chave de "S" para um campo de pesquisa do registro. O tipo de chave "S" para campos de sequência foi solicitado. Edite as propriedades do registro para alterar o valor Chave do campo de pesquisa para U. 2. Na guia Mapa de Dados em Explorador de Recursos, clique com o botão direito no registro para o qual você deseja exibir ou editar campos de pesquisa e clique em Propriedades. 3. Na caixa Propriedades de Registro, clique na guia Campos de Pesquisa. 4. Para editar propriedades de um campo de pesquisa, clique na célula da coluna que você deseja editar e insira outro valor. Como alternativa, selecione o campo na lista e clique no botão Propriedades. Em seguida, edite as propriedades do campo de pesquisa em uma caixa de diálogo separada. TÓPICOS RELACIONADOS: Adicionando campos de pesquisa para um registro do IMS na página 56 Itens do Mapa de dados IMS na página 42 Exibindo ou Editando Propriedades para uma Tabela de Mapa de Dados Você pode exibir ou editar propriedades para uma tabela em um mapa de dados. Você pode alterar o nome de uma tabela ou definir uma hierarquia em uma tabela complexa. Além disso, você pode definir como os registros em uma tabela complexa são exibidos em um teste de linha de banco de dados ou são mapeados em uma tabela de destino. Para exibir ou editar propriedades para uma tabela do mapa de dados: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse em uma tabela e clique em Propriedades. A caixa de diálogo Propriedades da Tabela é exibida. 3. Dependendo da fonte de dados para o mapa de dados, exiba ou edite propriedades da tabela em algumas ou em todas as guias: Definição. Propriedades para uma tabela complexa, incluindo definições para como os registros em uma tabela complexa são exibidos em um teste de linha do banco de dados ou são mapeados em uma tabela de destino e como as mudanças nos registros nos quais a tabela é baseada são refletidas nas colunas correspondentes na tabela. Chaves. Para Adabas, a chave primária para a tabela. Opções IMS. Para lote IMS DL/1 e IMS ODBA, propriedades para segmentos em uma tabela complexa. TÓPICOS RELACIONADOS: Adicionando um Mapa de Dados na página 43 Adicionando um Elemento a um Registro Datacom na página 49 Adicionando uma Chave a um Registro Datacom na página 50 Adicionando um Segmento Chave a um Registro Datacom na página 51 Adicionando um Elemento CALC a um Registro IDMS na página 53 Exibindo ou Editando Propriedades para um Mapa de Dados ou Itens em um Mapa de Dados 69

87 Adicionando um Registro e Conjunto do Proprietário a um Registro IDMS na página 53 Adicionando um Campo CCK a um Registro IMS na página 56 Adicionando campos de pesquisa para um registro do IMS na página 56 Propriedades do Mapa de Dados na página 315 Propriedades da Tabela - Definição na página 353 Propriedades da Tabela - Chaves na página 358 Propriedades da Tabela - Opções IMS na página 357 Exibindo ou Editando Propriedades para uma Coluna em uma Tabela Você pode exibir ou editar propriedades para uma coluna em uma tabela em um mapa de dados. Você pode alterar o nome de uma coluna ou o campo no qual a coluna é baseada. 1. Abra o mapa de dados e a tabela. 2. Na janela Tabela, clique com o botão direito do mouse em uma coluna e clique em Propriedades. A caixa de diálogo Propriedades da Coluna é exibida. 3. Na guia Nome, exiba ou edite as propriedades da coluna. TÓPICOS RELACIONADOS: Adicionando uma Coluna a uma Tabela na página 58 Copiando, Recortando e Colando Itens em um Mapa de Dados Você pode copiar ou recortar e colar registros, campos, tabelas e colunas no mesmo mapa de dados. Por exemplo, se você copiar uma tabela para um mapa de dados, o PowerExchange inserirá a tabela copiada na posição selecionada no mapa de dados e anexará um sublinhado e um valor numérico ao seu nome. Se você copiar uma tabela denominada EMPLOYEE, o PowerExchange inserirá uma cópia da tabela EMPLOYEE com o nome EMPLOYEE_1 no mapa de dados. Se você copiar outra cópia da tabela EMPLOYEE, a segunda cópia terá o nome EMPLOYEE_2. Para copiar um item para um mapa de dados: 1. Abra o mapa de dados. 2. Conclua uma das ações a seguir: Para copiar ou recortar um registro ou uma tabela, clique com o botão direito do mouse no registro ou na tabela e clique em Copiar ou Recortar. Para copiar ou recortar um campo em um registro, abra o registro. Na janela Registro, clique com o botão direito do mouse no campo e clique em Copiar ou Recortar. Para copiar ou recortar uma coluna em uma tabela, abra a tabela. Na janela Tabela, clique com o botão direito do mouse na coluna e clique em Copiar ou Recortar. 3. Clique com o botão direito do mouse no item antes ou depois do qual você deseja colar o item copiado ou recortado e clique em Colar. 70 Capítulo 2: Mapas de Dados

88 4. Na caixa de diálogo Colar Posição, selecione a opção para colar o item copiado ou recortado antes ou depois do item selecionado. O item copiado ou recortado aparece antes ou depois do item selecionado. Editando Informações de Logon para Acessar Mapas de Dados e Dados Você pode editar as credenciais usadas para fazer login em um sistema remoto para acessar um mapa de dados ou dados. 1. Abra o mapa de dados. 2. Clique em Recurso > Logons. 3. Na caixa de diálogo Logons de Mapa de Dados, digite as credenciais para fazer logon em um sistema remoto para acessar um mapa de dados e dados. Editando Informações de Logon para Acessar Mapas de Dados e Dados 71

89 A tabela a seguir descreve as informações a serem inseridas: Opção Localização Logon de Mapa de Dados Descrição Selecione a localização da fonte de dados. Selecione local se a fonte de dados estiver no sistema do Navegador do PowerExchange. Este campo lista as localizações definidas pelas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. O padrão é local. Digite as seguintes credenciais para acessar o mapa de dados: - Identificação de Usuário. Digite a Identificação de Usuário do banco de dados para acessar a fonte de dados, se necessário. - Senha. Insira uma senha para o ID de usuário, se especificado. Para acessar mapas de dados em um sistema i5/os ou z/os, você pode inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Um código de acesso pode conter os seguintes caracteres: - Letras em maiúsculas e minúsculas - Os números de 0 a 9 - Espaços - Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. - Senha do Arquivo. Para o Adabas, se o arquivo do FDT for protegido por senha, digite a senha para acessar o arquivo. 72 Capítulo 2: Mapas de Dados

90 Opção Logon de Acesso de Dados Permita que logons sejam alterados da próxima vez em que forem necessários Descrição Digite as seguintes credenciais para acessar a fonte de dados: - Identificação de Usuário. Para z/os, digite a Identificação de Usuário do banco de dados para acessar a fonte de dados, se necessário. - Senha. Para z/os, necessário. Digite uma senha para o ID de usuário. Para acesso aos dados em um sistema i5/os ou z/os, você pode inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Um código de acesso pode conter os seguintes caracteres: - Letras em maiúsculas e minúsculas - Os números de 0 a 9 - Espaços - Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. Os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: Um código de acesso RACF válido pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Nota: Você deve inserir credenciais para Logon de Mapa de Dados e Logon de Acesso de Dados, mesmo que as IDs do usuário e as senhas de login sejam as mesmas. No z/os, usuários diferentes podem possuir os mapas de dados e os dados reais. Selecione essa opção para solicitar novamente as credenciais antes de continuar com a próxima função solicitada. Enviando um Mapa de Dados para um Sistema Remoto Se a fonte de dados de um mapa de dados estiver em um sistema remoto, envie o mapa de dados para o sistema remoto para disponibilizá-lo para o PowerExchange para operações de movimentação de dados em massa. Quando você envia o mapa de dados para o sistema remoto, o PowerExchange converte o mapa de dados em um arquivo independente de plataforma a ser usado para a extração de dados em massa. O mapa de dados original permanece no sistema do Navegador do PowerExchange. Se você alterar o mapa de dados Enviando um Mapa de Dados para um Sistema Remoto 73

91 local do Navegador do PowerExchange, será necessário enviar o mapa de dados para o sistema remoto novamente para atualizá-lo no sistema. 1. Abra o mapa de dados. 2. Clique em Arquivo > Enviar para o Nó Remoto. 3. Na caixa de diálogo Nó Remoto do Mapa de Dados, digite as informações de conexão para o sistema remoto para o qual enviar o mapa de dados. A tabela a seguir descreve as informações de conexão a serem inseridas: Opção Identificação de Usuário Senha Localização Salvar ID de Usuário e Senha(s) para a sessão Descrição Se for necessária um ID do usuário para acessar o sistema remoto, insira um ID do usuário. Se você especificou um ID do usuário, insira uma senha do ID do usuário. Para acessar um sistema i5/os ou z/os, você pode inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Um código de acesso pode conter os seguintes caracteres: - Letras em maiúsculas e minúsculas - Os números de 0 a 9 - Espaços - Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Selecione o nome do nó da localização do sistema para o qual enviar o mapa de dados. Esse campo lista as localizações definidas nas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. O padrão é local. Selecione essa opção para salvar as informações inseridas durante a sessão. O padrão é selecionado. 4. Clique em OK. Uma caixa de mensagem exibe o status da operação de envio. 5. Clique em OK. O PowerExchange salva o mapa de dados no sistema remoto. 74 Capítulo 2: Mapas de Dados

92 TÓPICOS RELACIONADOS: Mapas de Dados Exportados na página 41 Importando Mapas de Dados Enviados a um Sistema Remoto Se você enviou ou exportou mapas de dados para um sistema remoto, é possível importar um ou mais desses mapas de dados para o sistema do Navegador do PowerExchange. Para cada mapa de dados que você importa, ele permanece no sistema remoto e uma cópia local é salva no sistema do Navegador do PowerExchange. 1. Feche todos os recursos abertos do PowerExchange. 2. Clique em Arquivo > Mapas de Dados Exportados. 3. Na caixa de diálogo Nó de Importação do Mapa de Dados, insira as informações de conexão do sistema do qual você está importando os mapas de dados: A tabela a seguir descreve as informações de conexão a serem inseridas: Opção Identificação de Usuário Senha Descrição Se for necessária um ID do usuário para acessar o sistema remoto, insira um ID do usuário. Se você especificar um ID do usuário, insira uma senha do ID do usuário. Para acessar um sistema i5/os ou z/os, você pode inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Um código de acesso pode conter os seguintes caracteres: - Letras em maiúsculas e minúsculas - Os números de 0 a 9 - Espaços - Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Importando Mapas de Dados Enviados a um Sistema Remoto 75

93 Opção Localização Senha do Arquivo Salvar ID de Usuário e Senha(s) para a sessão Descrição Selecione o nome do nó do sistema remoto do qual você está importando o mapa de dados. Esse campo lista as localizações definidas nas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. O padrão é local. Para o Adabas, se o arquivo do FDT for protegido por senha, insira a senha que permite o acesso ao arquivo. Selecione esta opção para salvar as informações inseridas durante a sessão. O padrão é selecionado. 4. Na caixa de diálogo Mapas de Dados Exportados, importe um ou mais mapas de dados. Uma caixa de mensagem exibe o status da operação de importação. 5. Clique em OK. O mapa ou mapas de dados são exibidos na guia Recursos no Explorador de Recursos. TÓPICOS RELACIONADOS: Mapas de Dados Exportados na página 41 Associando Vários Arquivos de Dados a um Mapa de Dados Você pode associar vários arquivos de dados a um mapa de dados usando o processamento de lista de arquivos do PowerExchange. Em vez de associar um único arquivo de dados a um mapa de dados, crie um arquivo de lista de arquivos. No arquivo de lista de arquivos, você lista vários arquivos de dados. Em seguida, associe o arquivo de lista de arquivos ao mapa de dados e selecione a opção Processamento de Lista de Arquivos nas propriedades de mapa de dados. O PowerExchange concatena e processa os dados nos arquivos de dados na ordem em que os arquivos são listados no arquivo de lista de arquivos. O processamento da lista de arquivos é suportado por arquivos simples, conjuntos de dados sequenciais, ESDSs e conjuntos de dados de fita. Se você exibir o arquivo de dados associado a um mapa de dados que usa o processamento da lista de arquivos, será exibido o arquivo de lista de arquivos em vez dos arquivos de dados listados. 76 Capítulo 2: Mapas de Dados

94 TÓPICOS RELACIONADOS: Arquivos de Dados e Processamento de Lista de Arquivos na página 32 Processamento de Lista de Arquivos do PowerExchange Quando você executa um teste de linha do banco de dados ou uma operação de movimentação de dados em massa usando um mapa de dados configurado para utilizar o processamento de lista de arquivos, o PowerExchange processa o arquivo de lista de arquivos da seguinte forma: 1. O PowerExchange ignora linhas em branco e espaços em branco à esquerda e à direita de uma linha. 2. Se o PowerExchange encontra um erro no arquivo de lista de arquivos, o processamento da lista de arquivos é encerrado. Os erros podem incluir um nome de arquivo que não é válido, arquivos não existentes ou erros de leitura. 3. O PowerExchange registra em log os nomes de arquivos que não são válidos no log do Ouvinte do PowerExchange. Os nomes de arquivos são registrados em log no formato hexadecimal. 4. Se o PowerExchange não detectar nenhum erro, ele concatenará e processará os dados nos arquivos de dados listados em um arquivo de lista de arquivos na ordem em que eles forem listados. Regras de Sintaxe do Arquivo de Lista de Arquivos Você deve seguir regras de sintaxe para criar um arquivo de lista de arquivos. Use as seguintes regras de sintaxe para criar um arquivo de lista de arquivos: Liste um arquivo de dados por linha. Inicie linhas de comentário com barra e asterisco, como a seguir: /* Todos os caracteres especificados entre espaços em branco à esquerda e à direita em uma linha são considerados nome de arquivo de dados. No z/os, se você definir números de sequência como ON, o número também será considerado parte do nome do arquivo de dados. Criando um Arquivo de Lista de Arquivos e Associando-o a um Mapa de Dados Para associar vários arquivos de dados a um mapa de dados, crie um arquivo de lista de arquivos que liste os arquivos de dados e associe o arquivo de lista de arquivos a um mapa de dados. Nota: Para usar o processamento do arquivo de lista de arquivos com o ODBC, defina sequências de escape SQL em vez de definir propriedades de mapa de dados. 1. Crie um arquivo de lista de arquivos no sistema em que os arquivos de dados estão localizados. O arquivo de lista de arquivos lista o caminho e o nome de arquivo de cada arquivo de dados. 2. No Navegador do PowerExchange, edite um mapa de dados. Nota: O processamento de lista de arquivos é suportado para mapas de dados definidos apenas com os métodos de acesso ESDS, SEQ e TAPE. 3. Na guia Método de Acesso na caixa de diálogo Propriedades do Mapa de Dados, digite o caminho e o nome de arquivo do arquivo de lista de arquivos na caixa Nome do Arquivo ou clique no botão Procurar para buscar o arquivo. 4. Selecione a opção Processamento de Lista de Arquivos. Associando Vários Arquivos de Dados a um Mapa de Dados 77

95 5. Clique em OK. Processamento ODBC e da Lista de Arquivos Você pode usar o processamento de lista de arquivos com ODBC. Para usar o processamento de lista de arquivos com ODBC, use as seguintes sequências de escape SQL: DTLDSN Especifica o arquivo de lista de arquivos. DTLFILELIST Indica que o processamento de lista de arquivos deve ser usado. Para obter mais informações sobre ODBC, processamento de lista de arquivos e sequências de escape SQL, consulte o Manual de Referência do PowerExchange. Exemplo de Arquivo de Lista de Arquivos para Linux, UNIX e Windows No Linux, UNIX ou Windows, você pode definir um arquivo de lista de arquivos que lista arquivos de dados. Você poderá listar os seguintes arquivos de dados em um arquivo de lista de arquivos denominado filelist.dat: c:\pwx\data\filelist1.dat c:\pwx\data\filelist2.dat c:\pwx\data\filelist3.dat Quando você adicionar um mapa de dados, associe o arquivo filelist.dat ao mapa de dados e selecione a opção Processamento da Lista de Arquivos nas propriedades do mapa de dados. Exemplo de Arquivo de Lista de Arquivos no z/os No z/os, você pode definir um membro da lista de arquivos que lista os membros do arquivo de dados. Você poderá listar os seguintes membros do arquivo de dados em um membro de lista de arquivos denominado DTLUSR.V901.V1.DEMO.ESDS: ***************************** Top of Data ****************************** /* FILE LIST PROCESSING DEFINITION FILE /* DTLUSR.V901.V1.DEMO.ESDS /* DTLUSR.V901.V1.DEMO.ESDS /* DTLUSR.V901.V1.DEMO.ESDS /* ***************************** Bottom of Data **************************** Quando você adicionar um mapa de dados, associe o membro DTLUSR.V900.V1.DEMO.ESDS ao mapa de dados e selecione a opção Processamento de Lista de Arquivos nas propriedades do mapa de dados. 78 Capítulo 2: Mapas de Dados

96 Imprimindo um Mapa de Dados ou Itens em um Mapa de Dados Você pode imprimir um mapa de dados ou registros, campos, tabelas ou colunas em um mapa de dados para uma impressora ou para um arquivo. Se você escolher imprimir em um arquivo, o nome de arquivo padrão será Navegador do PowerExchange.xxx na pasta Meus Documentos, em que xxx é uma extensão de arquivo apropriada ao tipo de impressora. Nota: Você não pode imprimir campos definidos pelo usuário. Em um documento impresso ou arquivo salvo, você pode escolher as seguintes informações: Incluir informações detalhadas além das informações de resumo para um item. Identificar o nível hierárquico de um item usando números ou recuo. Incluir informações para os objetos dependentes. Imprimindo um Mapa de Dados Você pode imprimir um mapa de dados de cada vez. Para imprimir um mapa de dados: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no mapa de dados e clique em Imprimir. 3. Na caixa de diálogo Imprimir, exiba ou edite as opções de impressão. A tabela a seguir descreve as opções de impressão: Opção Nome Status Tipo Em que Comentário Imprimir para arquivo Tudo Páginas Descrição Selecione a impressora. Clique em Propriedades para definir as propriedades para a impressora. Somente leitura. O status da impressora selecionada. Somente leitura. O tipo de impressora da impressora selecionada. Somente leitura. A localização da impressora selecionada. Somente leitura. Os comentários definidos para a impressora selecionada. Selecione essa opção para salvar o item no formato de texto sem formatação para um arquivo. Selecione um tipo de impressora apropriado para a impressão para a opção de arquivo. Selecione essa opção para imprimir todas as páginas no documento. O padrão é selecionado, que é a única opção válida. Não disponível. Imprimindo um Mapa de Dados ou Itens em um Mapa de Dados 79

97 Opção Seleção Número de cópias Imprimir detalhes Imprimir dependentes Usar número de nível Descrição Não disponível. Digite o número de cópias a imprimir em uma impressora. Esse valor não se aplica a itens impressos para um arquivo. O padrão é 1. Selecione essa opção para imprimir informações detalhadas, além de informações de resumo, para o item ou os itens selecionados. O padrão é imprimir informações de resumo. Selecione essa opção para imprimir informações de resumo e, se selecionado, informações detalhadas, para os objetos dependentes do item ou dos itens selecionados. O padrão é não imprimir informações para objetos dependentes. Selecione essa opção para imprimir números de nível que identifiquem qualquer hierarquia no item ou itens selecionados. O padrão é usar recuo. 4. Clique em OK. O PowerExchange imprime o mapa de dados na impressora selecionada a menos que você tenha selecionado a opção Imprimir para arquivo. 5. Se você imprimiu o mapa de dados para um arquivo, digite as propriedades do arquivo na caixa de diálogo Salvar Como e clique em Salvar. O PowerExchange salva o documento para o arquivo especificado na localização especificada. Imprimindo Registros de Mapa de Dados Você pode imprimir um ou mais registros em um mapa de dados. Para imprimir registros do mapa de dados: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, imprima um ou mais registros. 3. Na caixa de diálogo Imprimir, defina as opções de impressão. Para obter informações sobre as opções de impressão, consulte Imprimindo um Mapa de Dados na página 79. O PowerExchange imprime os registros na impressora selecionada a menos que você tenha selecionado a opção Imprimir para arquivo. 4. Se você imprimiu os registros para um arquivo, digite as propriedades do arquivo na caixa de diálogo Salvar Como e clique em Salvar. O PowerExchange salva o documento para o arquivo especificado na localização especificada. Imprimindo Campos em um Registro Você pode imprimir um ou mais campos em um registro em um mapa de dados. Nota: Você não pode imprimir campos definidos pelo usuário. 80 Capítulo 2: Mapas de Dados

98 Para imprimir campos em um registro: 1. Abra o mapa de dados. 2. Abra o registro. 3. Na guia Campos na janela Registro, imprima um ou mais campos. 4. Na caixa de diálogo Imprimir, defina as opções de impressão. Para obter informações sobre as opções de impressão, consulte Imprimindo um Mapa de Dados na página 79. O PowerExchange imprime os campos na impressora selecionada a menos que você tenha selecionado a opção Imprimir para arquivo. 5. Se você imprimiu os campos para um arquivo, digite as propriedades do arquivo na caixa de diálogo Salvar Como e clique em Salvar. O PowerExchange salva o documento para o arquivo especificado na localização especificada. Imprimindo Tabelas de Mapa de Dados Você pode imprimir uma ou mais tabelas em um mapa de dados. Para imprimir tabelas do mapa de dados: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, imprima uma ou mais tabelas. 3. Na caixa de diálogo Imprimir, defina as opções de impressão. Para obter informações sobre as opções de impressão, consulte Imprimindo um Mapa de Dados na página 79. O PowerExchange imprime as tabelas na impressora selecionada a menos que você tenha selecionado a opção Imprimir para arquivo. 4. Se você imprimiu as tabelas para um arquivo, digite as propriedades do arquivo na caixa de diálogo Salvar Como e clique em Salvar. O PowerExchange salva o documento para o arquivo especificado na localização especificada. Imprimindo Colunas em uma Tabela Você pode imprimir uma ou mais colunas em uma tabela em um mapa de dados. 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique na tabela. 3. Na janela Tabela, imprima uma ou mais colunas. 4. Na caixa de diálogo Imprimir, defina as opções de impressão. Para obter informações sobre as opções de impressão, consulte Imprimindo um Mapa de Dados na página 79. O PowerExchange imprime as colunas na impressora selecionada a menos que você tenha selecionado a opção Imprimir para arquivo. 5. Se você imprimiu as colunas para um arquivo, digite as propriedades do arquivo na caixa de diálogo Salvar Como e clique em Salvar. O PowerExchange salva o documento para o arquivo especificado na localização especificada. Imprimindo um Mapa de Dados ou Itens em um Mapa de Dados 81

99 Excluindo Mapas de Dados ou Itens em um Mapa de Dados Você pode excluir mapas de dados ou itens em um mapa de dados. Você pode excluir vários mapas de dados ou itens do mapa de dados de uma vez. Você pode excluir os seguintes itens do mapa de dados: Registros Campos de um registro Tabelas Colunas de uma tabela Para mapas de dados, elementos, chaves e segmentos de chaves Datacom Para mapas de dados IDMS, elementos CALC e registros e conjuntos do proprietário Para mapas de dados IMS, campos CCK e campos de pesquisa Quando você exclui mapas de dados ou itens do mapa de dados, o PowerExchange exclui o mapa de dados ou itens do mapa de dados do diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. Excluindo Mapas de Dados Você pode excluir mapas de dados. Para excluir mapas de dados: 1. Na janela Recursos, exclua um ou mais mapas de dados. 2. Na caixa de mensagem que solicita a confirmação da exclusão, clique em Sim. O PowerExchange exclui os mapas de dados do diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. Excluindo Mapas de Dados Exportados para uma Sistema Remoto Você pode excluir mapas de dados enviados ou exportados para um sistema remoto. Para excluir mapas de dados exportados para um sistema remoto: 1. Feche todos os recursos abertos do PowerExchange. 2. Clique em Arquivo > Mapas de Dados Exportados. 3. Na caixa de diálogo Nó de Importação do Mapa de Dados, digite informações de conexão para o sistema no qual você deseja excluir os mapas de dados exportados. 4. Na caixa de diálogo Mapas de Dados Exportados, exclua um ou mais mapas de dados exportados. 5. Na caixa de mensagem que solicita que você confirme a exclusão, clique em Sim. O PowerExchange exclui os mapas de dados no sistema remoto. 82 Capítulo 2: Mapas de Dados

100 TÓPICOS RELACIONADOS: Enviando um Mapa de Dados para um Sistema Remoto na página 73 Excluindo Registros de Mapa de Dados Você pode excluir registros de um mapa de dados. Para excluir registros do mapa de dados: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, exclua um ou mais registros. Uma caixa de mensagem solicita que você confirme a exclusão do registro ou registros. 3. Se existir alguma referência cruzada para o registro ou registros, a caixa de mensagem o notificará de que a exclusão do registro também exclui todas as referências cruzadas para o registro ou registros. Para exibir as referências cruzadas para o registro ou registros, clique em Mais Detalhes. Na lista Referências afetadas pela exclusão atual, os ícones para os itens que o PowerExchange excluirá quando excluir o registro ou registros serão exibidos em cinza. 4. Na caixa de mensagem que solicita que você confirme a exclusão, clique em Sim. O PowerExchange exclui os registros e as referências cruzadas para os registros do mapa de dados no diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. Excluindo Campos de um Registro Você pode excluir campos de um registro. Para excluir campos de um registro: 1. Abra o mapa de dados e o registro. 2. Na guia Campos ou na guia Expr(n) na janela Registro, exclua um ou mais registros. Uma caixa de mensagem solicita que você confirme a exclusão do campo ou campos. Se as tabelas no mapa de dados contiverem colunas baseadas no campo ou campos, a caixa de mensagem o notificará de que a exclusão do campo ou campos também exclui as colunas que têm referência cruzada com o campo ou campos. 3. Para exibir quais colunas em quais tabelas têm referência cruzada com o campo ou campos, clique em Mais Detalhes. Na lista Referências afetadas pela exclusão atual, os ícones para os itens que o PowerExchange excluirá quando excluir o campo ou campos serão exibidos em cinza. 4. Na caixa de mensagem que solicita que você confirme a exclusão, clique em Sim. O PowerExchange exclui o campo ou campos do registro. Se você excluir todos os campos de um registro, o PowerExchange não excluirá o registro. Se as colunas nas tabelas forem baseadas no campo ou campos, o PowerExchange excluirá essas colunas das tabelas. Se você excluir todos os campos de um registro no qual todas as colunas em uma tabela são baseadas, o PowerExchange excluirá todas as colunas na tabela, mas não excluirá a tabela. Excluindo Tabelas de Mapa de Dados Você pode excluir tabelas de um mapa de dados. Para excluir tabelas de mapa de dados: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, exclua uma ou mais tabelas. Excluindo Mapas de Dados ou Itens em um Mapa de Dados 83

101 3. Na caixa de mensagem que solicita que você confirme a exclusão, clique em Sim. O PowerExchange exclui as tabelas do mapa de dados no diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. Excluindo Colunas de uma Tabela Você pode excluir colunas de uma tabela. 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique na tabela. 3. Na janela Tabela, exclua uma ou mais colunas. Uma caixa de mensagem solicita que você confirme a exclusão da coluna ou colunas. 4. Na caixa de mensagem que solicita que você confirme a exclusão, clique em Sim. O PowerExchange exclui as colunas da tabela e as referências cruzadas para as colunas do mapa de dados no diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. Se você excluir todas as colunas de uma tabela, o PowerExchange não excluirá a tabela. Excluindo Elementos de um Registro Datacom Você pode excluir elementos de um registro Datacom. Para excluir elementos de um registro Datacom: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. 3. Na guia Elementos na caixa de diálogo Propriedades do Registro, exclua um ou mais elementos. O PowerExchange exclui os elementos do registro no mapa de dados no diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. Excluindo Chaves de um Registro Datacom Você pode excluir chaves de um registro Datacom. Para excluir chaves de um registro Datacom: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. 3. Na guia Chaves na caixa de diálogo Propriedades do Registro, exclua uma ou mais chaves. O PowerExchange exclui as chaves do registro no mapa de dados no diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. Excluindo Segmentos de Chaves de um Registro Datacom Você pode excluir segmentos de chaves de um registro Datacom. Para excluir segmentos de chaves de um registro Datacom: 1. Abra o mapa de dados. 84 Capítulo 2: Mapas de Dados

102 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. 3. Na guia Chaves na caixa de diálogo Propriedades do Registro, clique no botão Propriedades na caixa de diálogo. 4. Na guia Detalhes do Segmento na caixa de diálogo Propriedades de Chaves, exclua um ou mais segmentos de chaves. O PowerExchange exclui os segmentos de chaves do registro no mapa de dados no diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. Excluindo Elementos CALC de um Registro IDMS Você pode excluir elementos CALC de um registro IDMS. Para excluir elementos CALC de um registro IDMS: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. 3. Na guia Nomes de Elementos CALC na caixa de diálogo Propriedades do Registro, exclua um ou mais elementos CALC. O PowerExchange exclui os elementos CALC do registro no mapa de dados no diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. Excluindo Registros do Proprietário e Conjuntos de um Registro IDMS Você pode excluir registros e conjuntos do proprietário de um registro IDMS. Para excluir registros e conjuntos do proprietário de um registro IDMS: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. 3. Na guia Nomes de Registros e Conjuntos do Proprietário na caixa de diálogo Propriedades do Registro, exclua um ou mais registros e conjuntos do proprietário. O PowerExchange exclui os registros e conjuntos do proprietário do registro no mapa de dados no diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. Excluindo campos CCK de um registro do IMS Você pode excluir campos CCK de um registro em um lote IMS DL/1 ou mapa de dados ODBA do IMS. 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. 3. Na guia Campos CCK na caixa de diálogo Propriedades do Registro, exclua um ou mais campos CCK. O PowerExchange exclui os campos CCK do registro no mapa de dados no diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. Excluindo Mapas de Dados ou Itens em um Mapa de Dados 85

103 Excluindo campos de pesquisa de um registro do IMS Você pode excluir campos de pesquisa de um registro em um lote IMS DL/1 ou mapa de dados ODBA do IMS. 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no registro e clique em Propriedades. 3. Na guia Campos de Pesquisa na caixa de diálogo Propriedades do Registro, exclua um ou mais campos de pesquisa. O PowerExchange exclui os campos de pesquisa do registro no mapa de dados no diretório de configuração de recursos atual no sistema do Navegador do PowerExchange. 86 Capítulo 2: Mapas de Dados

104 C A P Í T U L O 3 Mapas de Dados para Fontes de Dados Específicas Este capítulo inclui os seguintes tópicos: Visão Geral de Mapas de Dados para Fontes de Dados Específicas, 87 Mapas de Dados Adabas, 88 Mapas de dados C-ISAM, 91 Mapas de Dados Datacom, 92 Mapas de Dados do Catálogo do DB2, 93 Mapas de Dados do Arquivo de Descarregamento do DB2, 95 Mapas de Dados IDMS, 98 Mapas de Dados IMS, 101 Mapas de Dados SEQ, 114 Mapas de Dados VSAM, 115 Visão Geral de Mapas de Dados para Fontes de Dados Específicas As opções que você configura quando adiciona um mapa de dados dependem do tipo de fonte de dados do mapa de dados. Além disso, o tipo de copybook que você pode importar para o mapa de dados depende do tipo de fonte de dados para o mapa de dados. A tabela a seguir lista os tópicos que apresentam detalhes para adicionar mapas de dados e importar copybooks para mapas de dados para cada fonte de dados: Fonte de Dados Método de Acesso do PowerExchange Referência Arquivo Adabas ADABAS Mapas de Dados Adabas na página 88 Arquivo C-ISAM ISAM Mapas de dados C-ISAM na página 91 87

105 Fonte de Dados Método de Acesso do PowerExchange Referência Arquivo CA Datacom/DB DATACOM Mapas de Dados Datacom na página 92 Banco de dados CA IDMS/DB IDMS Mapas de Dados IDMS na página 98 catálogo DB2 DB2 Mapas de Dados do Catálogo do DB2 na página 93 Arquivo de descarregamento do DB2 DB2UNLD Mapas de Dados do Arquivo de Descarregamento do DB2 na página 95 Banco de dados IMS DL/1 BATCH Mapas de Dados IMS na página 101 Banco de dados IMS acessado por meio de um Ouvinte do PowerExchange Conjunto de dados sequenciais ou arquivo simples IMS ODBA Mapas de Dados IMS na página 101 SEQ Mapas de Dados SEQ na página 114 Programa de método de acesso do usuário definido pelo usuário USER Apêndice B, Programas de Método de Acesso do Usuário na página 303 VSAM Entry-Sequenced Data Set (ESDS) VSAM Key-Sequenced Data Set (KSDS) VSAM Relative Record Data Set (RRDS) ESDS Mapas de Dados VSAM na página 115 KSDS Mapas de Dados VSAM na página 115 RRDS Mapas de Dados VSAM na página 115 TÓPICOS RELACIONADOS: Mapas de Dados na página 29 Copybooks na página 122 Teste de Linha de Banco de Dados na página 203 Mapas de Dados Adabas Você pode importar um copybook, um Field Definition Table (FDT) do Adabas e chaves do Adabas quando adiciona um mapa de dados do Adabas ou após adicioná-lo. O FDT define o layout dos dados em uma fonte de dados. Quando você importa um FDT, as definições de dados no mapa de dados são armazenadas no sistema local. Se você importar chaves Adabas para o mapa de dados, poderá adicionar essas chaves às tabelas no mapa de dados. Você pode atualizar o FDT após adicionar o mapa de dados. 88 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

106 Você pode importar qualquer um dos tipos de copybook a seguir para um mapa de dados do Adabas: Copybook COBOL. Se você importar um copybook COBOL, deverá editar o mapa de dados para associar as definições de campo importadas às definições de campo Adabas. Copybook PL/I. Se você importar um copybook PL/I, deverá editar o mapa de dados para associar as definições de campo importadas às definições de campo Adabas. Arquivo criado usando o utilitário ADACMP. Data Definition Module (DDM) Natural. Para importar um DDM, você deve digitar o ID do banco de dados FDIC e os valores de número de arquivo. Nota: Se você importar metadados DDM para bancos de dados Adabas em z/os que contenham tipos de dados de caracteres largos, o PowerExchange não selecionará a opção Caractere Largo na guia Página de Códigos para esses campos. Você deve importar metadados Previsão ou FDT ou editar propriedades de campos no mapa de dados para selecionar a opção Caractere Largo para todos os tipos de dados de caracteres largos. Data Definition Module (DDM) Natural para sistemas UNIX e Windows. Para importar um DDM, você deve digitar um caminho de biblioteca de usuário Natural. FDT do Adabas que contém a definição do banco de dados, que especifica nomes curtos e informações sem escala. Um FDT permite a validação de informações relacionadas ao Adabas, como nomes de campos, tamanhos de arrays e tamanhos de substituição. Depois que um FDT é importado, ele é armazenado em cache para sessões subsequentes, o que permite que algumas verificações de validação ocorram antes do tempo de execução. Você pode atualizar um FDT importado. Dicionário de dados de previsão, que especifica um nome longo e informações de escala. Para importar um Dicionário de dados de previsão, você deve digitar o ID do banco de dados FDIC e os valores de número de arquivo. Arquivo de texto, que usa um formato interno delimitado da Informatica. Você pode subdividir ou redefinir qualquer campo do PowerExchange mapeado para um campo Adabas. Para subdividir um campo, defina-o como um campo de grupo com subcampos que remapeiam o grupo. Para testar um mapa de dados Adabas, execute um teste de linha de banco de dados. Adicionando um Mapa de Dados Adabas Quando você adiciona um mapa de dados Adabas, pode importar um FDT Adabas e um copybook. Para adicionar um mapa de dados Adabas: 1. Na guia Recursos no Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Digite as seguintes informações na caixa de diálogo Nome: Selecione o método de acesso ADABAS. Selecione as opções Importar Definições de Registro e Importar Campos Chave/FDT. 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso Adabas, defina informações da fonte de dados e clique em Concluir. 5. Na caixa de diálogo Importação do FDT Adabas, selecione o nome do nó para o sistema de origem Adabas. Se o sistema de origem for z/os e o PowerExchange estiver configurado para segurança, digite uma Identificação de Usuário e uma senha válidas do z/os. Se você usar a segurança de arquivo Adabas, digite a senha do arquivo. 6. Clique em OK. Mapas de Dados Adabas 89

107 7. Na caixa de diálogo Importar Copybook - Detalhes da Origem, digite informações sobre o copybook. Selecione um dos seguintes tipos de origem: ADACMP COBOL DDM. Digite também o ID de banco de dados FDIC e os valores do número do arquivo. DDM OPEN SYS. Digite também o caminho para a biblioteca do usuário Natural que contém o DDM para o banco de dados. FDT PL/1 PREDICT. Digite também o ID de banco de dados FDIC e os valores do número do arquivo. TEXT. Disponível se Local estiver selecionado como a origem. O padrão é DDM. 8. Clique em Avançar. 9. Na caixa de diálogo Importar Copybook - Detalhes Remotos, digite informações para o copybook remoto. Se você selecionou o tipo de origem DDM, DMM OPEN SYS ou PREDICT, digite um nome na caixa Nome ou clique no botão Procurar para buscar o arquivo. Clique em Avançar. 10. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, selecione as ações para registros, campos e tabelas importados e clique em Avançar. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página Na janela Informações de Importação do Copybook, consulte as informações da operação de importação e clique em OK. 12. Na caixa de diálogo Definição de Registro, selecione uma ação para cada registro importado e clique em OK. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página 124. A janela Importação exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. Nota: Se uma mensagem de erro for exibida na janela Log de Mensagens do Copybook, clique duas vezes na mensagem para localizar a linha associada no copybook. TÓPICOS RELACIONADOS: Importando um FDT para um Mapa de Dados Adabas na página 128 Propriedades do Mapa de Dados - Método de Acesso do ADABAS na página 315 Importar Copybook - Caixa de Diálogo Detalhes da Fonte na página 129 Importar Copybook - Caixa de Diálogo Detalhes do Remoto na página 135 Adicionando uma Chave a uma Tabela em um Mapa de Dados Adabas Se você importou chaves Adabas para um mapa de dados Adabas, pode definir uma chave para cada tabela no mapa de dados. 90 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

108 Para adicionar uma chave a uma tabela em um mapa de dados Adabas: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse na tabela e clique em Propriedades. 3. Na caixa de diálogo Propriedades da Tabela, clique na guia Chaves. 4. Na lista Chave Primária, selecione uma chave para a tabela. A chave selecionada é exibida na lista Detalhes da Chave. A validade de uma chave é determinada verificando-se se a tabela contém todos os campos definidos no registro como tendo os nomes de campo Adabas necessários ao descritor. Se qualquer um desses campos forem mapeados em grupos, todos os membros do grupo deverão estar presentes. Os campos em arrays verticais não são válidos. 5. Clique em OK. Mapas de dados C-ISAM Para usar um arquivo C-ISAM como uma fonte de dados, defina um mapa de dados C-ISAM. Você pode importar um copybook COBOL ou PL/I para um mapa de dados C-ISAM. Para testar um mapa de dados C-ISAM, execute um teste de linha de banco de dados. Adicionando um Mapa de dados C-ISAM Para adicionar um mapa de dados C-ISAM: 1. Na guia Recursos no Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Digite as seguintes informações na caixa de diálogo Nome: Selecione o método de acesso ISAM. Opcionalmente, selecione Importar Definições de Registro. 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso DATACOM, digite as informações para o método de acesso e clique em Concluir. 5. Se você selecionou para importar definições de registro, execute as seguintes ações: Na caixa de diálogo Importar Copybook - Detalhes da Origem, selecione Remoto. Em Tipo, selecione COBOL (padrão) ou PL/1. Clique em Avançar. Na caixa de diálogo Importar Copybook - Detalhes Remotos para o tipo de copybook, digite informações para o copybook e clique em Avançar. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, selecione as ações para registros, campos e tabelas importados e clique em Avançar. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página 124. Na janela Informações de Importação do Copybook, consulte as informações para a importação e clique em OK. Mapas de dados C-ISAM 91

109 Na caixa de diálogo Definição de Registro, selecione uma ação para cada registro importado e clique em OK. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página 124. A janela Importação exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. Nota: Se uma mensagem de erro for exibida na janela Log de Mensagens do Copybook, dê um clique duplo na mensagem para localizar a linha associada no copybook. 6. Se você não importar definições de registro, você deve adicionar registros, campos e tabelas manualmente. Para obter mais informações, consulte Capítulo 2, Mapas de Dados na página 29. Mapas de Dados Datacom Você pode importar um copybook quando adiciona um mapa de dados CA Datacom ou após adicioná-lo. Você pode importar um copybook COBOL, DATACOM ou PL/I para um mapa de dados Datacom. Após adicionar um mapa de dados Datacom, você pode adicionar elementos, chaves e segmentos de chaves ao mapa de dados. Para testar um mapa de dados Datacom, execute um teste de linha de banco de dados. TÓPICOS RELACIONADOS: Itens de Mapa de Dados Datacom na página 42 Adicionando um Mapa de Dados Datacom Quando você adiciona um mapa de dados Datacom, pode importar um copybook. Para adicionar um mapa de dados Datacom: 1. Na guia Recursos no Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Digite as seguintes informações na caixa de diálogo Nome: Selecione o método de acesso DATACOM. Selecione a opção Importar Definições de Registro. 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso DATACOM, digite as informações para o método de acesso e clique em Concluir. 5. Na caixa de diálogo Importar Copybook - Detalhes da Origem, selecione Remoto. Selecione um dos seguintes tipos de copybook: COBOL DATACOM PL/1 O padrão é COBOL. 6. Clique em Avançar. 92 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

110 7. Na caixa de diálogo Importar Copybook - Detalhes Remotos para o tipo de copybook, digite informações de conexão. Para o tipo de copybook DATACOM, digite duas identificações e senhas do usuário, conforme exigido pela configuração do PowerExchange e do banco de dados CA Datacom/DB. A primeira Identificação de Usuário e senha serão necessárias se a segurança for ativada usando a instrução SECURITY no arquivo de configuração DBMOVER. Os valores Identificação de Usuário do Dicionário e Senha do Dicionário serão necessários se CA Datacom/DB os exigir. Para importar um copybook com os metadados, selecione Copybook e selecione COBOL ou PL/1. As opções Status da Tabela, Chave e Elementos são desativadas por padrão. 8. Clique em Avançar. 9. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, selecione as ações para registros, campos e tabelas importados e clique em Avançar. Para obter mais informações, consulte Adicionando um Mapa de Dados Adabas na página Na janela Informações de Importação do Copybook, consulte as informações para a importação e clique em OK. 11. Na caixa de diálogo Definição de Registro, selecione uma ação para cada registro importado e clique em OK. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página 124. A janela Importação exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. Nota: Se uma mensagem de erro for exibida na janela Log de Mensagens do Copybook, clique duas vezes na mensagem para localizar a linha associada no copybook. TÓPICOS RELACIONADOS: Adicionando um Elemento a um Registro Datacom na página 49 Adicionando uma Chave a um Registro Datacom na página 50 Adicionando um Segmento Chave a um Registro Datacom na página 51 Propriedades do Mapa de Dados - Método de Acesso DATACOM na página 317 Importar Copybook - Caixa de Diálogo Detalhes do Remoto na página 135 Importar Copybook - Caixa de Diálogo Detalhes Datacom Remoto na página 136 Mapas de Dados do Catálogo do DB2 Como o DB2 é um banco de dados relacional, um mapa de dados do DB2 não é exigido pelo PowerExchange para acessar tabelas do DB2. No entanto, algumas tabelas do DB2 usam uma única coluna do DB2 para armazenar uma matriz de campos em um formato que não deve ser consistente com o tipo de coluna. Por exemplo, uma coluna CHAR pode conter vários campos de decimais compactados. Você pode definir um mapa de dados do DB2 para dividir os dados na coluna CHAR em colunas separadas com o tipo de dados correto para refletir o conteúdo. Você pode adicionar mapas de dados para as seguintes fontes de dados do DB2: DB2 para i5/os DB2 para Linux, UNIX e Windows Mapas de Dados do Catálogo do DB2 93

111 DB2 para z/os Para testar um mapa de dados DB2, execute um teste de linha de banco de dados. Adicionando um Mapa de Dados do Catálogo do DB2 Quando você adiciona um mapa de dados do catálogo do DB2, pode importar um copybook. Para adicionar um mapa de dados do catálogo do DB2: 1. Na guia Recursos no Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Digite as seguintes informações na caixa de diálogo Nome: Selecione o método de acesso DB2. Selecione a opção Importar Definições de Registro. 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso DB2, digite as informações para o método de acesso e clique em Concluir. 5. Na caixa de diálogo Importar Copybook - Detalhes da Fonte, selecione Remoto. Na lista Tipo, selecione tipo de copybook Catálogo do DB2. 6. Clique em Avançar. 7. Na caixa de diálogo Importar Copybook - Detalhes do Catálogo do DB2 Remoto, digite as seguintes informações: Altere os detalhes de importação. Os campos de entrada de dados são preenchidos de seleções anteriores. Na caixa Salvar Arquivo Localmente Como, digite um nome de arquivo. Para selecionar colunas específicas, clique em Visualizar/Corrigir Colunas. 8. Clique em Avançar. 9. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, selecione as ações para registros, campos e tabelas importados e clique em Avançar. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página Na janela Informações de Importação do Copybook, consulte as informações para a importação e clique em OK. 11. Na caixa de diálogo Definição de Registro, selecione uma ação para cada registro importado e clique em OK. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página 124. A janela Importação de Catálogo do DB2 exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. Nota: Se uma mensagem de erro for exibida na janela Log de Mensagens do Copybook, dê um clique duplo na mensagem para localizar a linha associada no copybook. TÓPICOS RELACIONADOS: Propriedades do Mapa de Dados - Método de Acesso DB2 na página 318 Importar Copybook - Caixa de Diálogo Detalhes do Catálogo do DB2 Remoto na página 138 Editando o Layout de Registro em um Mapa de Dados do DB2 Você pode editar o layout de registro de uma tabela do DB2 em um mapa de dados do DB2. 94 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

112 Por exemplo, você pode editar um campo em um registro que contém três itens para separar os dados do campo em campos filho. Neste exemplo, o campo MISC_DATA é definido como um campo CHAR(15). No entanto, o campo é usado para armazenar três campos de decimais compactados, cada um com precisão de 9 e escala de 2. Para editar o layout de registro em um mapa de dados do DB2: 1. Abra o mapa de dados. 2. Abra o registro. 3. Na janela Registro, clique com o botão direito do mouse no campo MISC_DATA e clique em Propriedades. A caixa de diálogo Propriedades do Campo é exibida. 4. Em Tipo de Campo, digite GROUP. 5. Clique em OK. 6. Na janela Registro, clique com o botão direito do mouse no campo MISC_DATA e clique em Adicionar Campo como Filho. 7. Adicione os campos MISC_1, MISC_2 e MISC_3 como filhos do campo MISC_DATA. Defina cada campo como um campo PACKED com uma precisão de 9 e uma escala de 2. Mapas de Dados do Arquivo de Descarregamento do DB2 Além disso, para direcionar o mapeamento de dados de tabelas do DB2, você também pode mapear arquivos de descarregamento do DB2. Para arquivos de descarregamento do DB2, o PowerExchange suporta os seguintes formatos de Software IBM e BMC: Utilitário online REORG TABLESPACE do DB2 para z/os com UNLOAD EXTERNAL Utilitário online UNLOAD do DB2 para z/os Programa de descarregamento de amostra DSNTIAUL do DB2 para z/os BMC Software Unload Plus Utilitário Descarregamento de Alto Desempenho do DB2 para Linux, UNIX e Windows Quando você executar um teste de linha de banco de dados para testar um mapa de dados do arquivo de descarregamento do DB2, selecione o tipo de fonte de dados NRDB. Nota: Quando você adiciona um mapa de dados de descarregamento do DB2 e seleciona DSNUTILB UNLOAD para Tipo de Descarregamento, o PowerExchange inclui um campo para o OBID no registro. Se você criar arquivos de descarregamento do DB2 especificando HEADER NONE nas instruções de controle DB2 UNLOAD, selecione UNDEFINED para Tipo de Descarregamento. Nota: O PowerExchange não pode ler conjuntos de dados sequenciais de formato grande. Se você especificar DSNTYPE=LARGE na instrução DD quando você cria o arquivo de descarregamento, o PowerExchange não pode ler o arquivo. Em vez disso, você pode especificar DSNTYPE=EXTREQ na instrução DD. Mapas de Dados do Arquivo de Descarregamento do DB2 95

113 Adicionando um Mapa de Dados do Arquivo de Descarregamento do DB2 Quando você adiciona um mapa de dados do arquivo de descarregamento do DB2, pode importar um copybook. Para adicionar um mapa de dados do arquivo de descarregamento do DB2: 1. Na guia Recursos no Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Digite as seguintes informações na caixa de diálogo Nome: Selecione o método de acesso DB2UNLD. Selecione a opção Importar Definições de Registro. 3. Na caixa de diálogo Método de Acesso DB2UNLD, digite as seguintes informações: Na caixa Nome do Arquivo, digite o nome do arquivo de descarregamento do DB2 de destino. Na caixa Instância do DB, digite a instância do DB, como DSN9. Na caixa Nome da Tabela, digite o nome da tabela ou clique no botão Procurar para buscar o arquivo. Na caixa de diálogo Filtro de Tabela do DB2, digite os critérios de filtragem com base no nome do criador ou do esquema, nome do banco de dados ou nome da tabela. Clique em Avançar. Selecione uma tabela e clique em Concluir. Na lista Tipo de Descarregamento, selecione o tipo de descarregamento. Para acesso em massa aos arquivos de descarregamento, os seguintes formatos IBM e BMC são suportados:.reorg UNLOAD,.DSNTIAUL/BMC UNLOAD+,.DSNUTILB UNLOAD e.undefined. Por padrão, o tipo.undefined é gerado com indicadores nulos e campos de contagem na mesma posição que no tipo REORG UNLOAD EXTERNAL. Em vez de usar esses tipos de descarregamento, você pode modificar essas instruções para que atendam requisitos específicos. Você pode mover ou excluir essas instruções para que correspondam aos formatos de descarregamento definidos pelo usuário, mas o PowerExchange os interpretará se eles precederem o campo de dados aos quais se aplicam. 4. Clique em Concluir. 5. Na caixa de diálogo Importar Copybook - Detalhes da Fonte, selecione Remoto e selecione o tipo de copybook Catálogo do DB2. 6. Clique em Avançar. 7. Na caixa de diálogo Importar Copybook - Detalhes do Catálogo do DB2 Remoto, digite as seguintes informações: Na caixa Salvar Arquivo Localmente como, digite um nome de arquivo. Na caixa Indicador Nulo, digite o valor hexadecimal do indicador nulo usado no arquivo de descarregamento que você está mapeando. Se as variáveis forem preenchidas no arquivo de descarregamento que você está mapeando, selecione a opção Preencher Variável. Essa opção corresponde à opção BMC UNLOAD PLUS FIXEDVARCHAR. Para selecionar colunas específicas, clique em Visualizar/Corrigir Colunas. 8. Clique em Avançar. 9. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, selecione as ações para registros, campos e tabelas importados e clique em Avançar. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página Na janela Informações de Importação do Copybook, consulte as informações para a importação e clique em OK. 96 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

114 11. Na caixa de diálogo Definição de Registro, selecione uma ação para cada registro importado e clique em OK. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página 124. A janela Importação de Catálogo do DB2 exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. Nota: Se uma mensagem de erro for exibida na janela Log de Mensagens do Copybook, clique duas vezes na mensagem para localizar a linha associada no copybook. TÓPICOS RELACIONADOS: Propriedades do Mapa de Dados - Método de Acesso DB2UNLD na página 318 Importar Copybook - Caixa de Diálogo Detalhes do Catálogo do DB2 Remoto na página 138 Acessando Dados de Descarregamento do DB2 de Várias Tabelas Vários espaços de tabela resultam em um único arquivo de descarregamento que contém dados de várias tabelas. É possível criar um mapa de dados que pode acessar várias tabelas em um único arquivo de descarregamento. Você pode selecionar tabelas individuais do descarregamento usando o OBID da tabela. Os seguintes tipos de arquivos de descarregamento são suportados por esse tipo de acesso de várias tabelas: Tipo 1 REORG UNLOAD O OBID é mantido no quarto e no quinto bytes de cada registro. Tipo 3 DSNUTILB UNLOAD O OBID é mantido nos dois primeiros bytes de cada registro. Execute as seguintes tarefas para criar um mapa de dados que pode ser usado para acessar várias tabelas no mesmo arquivo de descarregamento: 1. Adicione um mapa de dados. 2. Adicione as tabelas subjacentes. 3. Para especificar a tabela subjacente para cada tipo de registro no mapa de dados, digite o OBID apropriado na caixa de diálogo Propriedades do Registro para o campo DTL OBID. Adicionando um Mapa de Dados do Arquivo de Descarregamento do DB2 - Exemplo Esse exemplo demonstra como usar um arquivo DSNUTILB UNLOAD Tipo 3. Você pode usar esse mesmo procedimento para um arquivo REORG UNLOAD Tipo 1. O arquivo de descarregamento contém dados das tabelas PWXTAB3 e PWXTAB4, cada uma com sua própria estrutura. Para o Tipo 3, a tabela subjacente é especificada pelo OBID nos dois primeiros bytes. Os OBIDs para as tabelas são x 0004 e x 0005 respectivamente. Para adicionar o mapa de dados do arquivo de descarregamento do DB2: 1. Adicione um mapa de dados para mapear a tabela PWXTAB3. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse no campo DTL_OBID e clique em Propriedades. 3. Na caixa Valores do ID de Registro, digite o valor hexadecimal de OBID de x 0004 e clique em OK. Mapas de Dados do Arquivo de Descarregamento do DB2 97

115 O ícone para o campo DTL_OBID aparece em verde, indicando que o filtro ID do Registro está definido para o campo. 4. Importar a próxima tabela subjacente, PWXTAB4. 5. Na caixa Valores do ID de Registro, digite o valor hexadecimal de OBID de x 0005 e clique em OK. O ícone para o campo DTL_OBID aparece em verde, indicando que o filtro ID do Registro está definido para o campo. 6. Para testar a tabela PWXTAB4, execute um teste de linha do banco de dados. A janela Saída de Teste de Linha do Banco de Dados exibe duas linhas com um OBID de x Mapas de Dados IDMS Você pode importar um copybook COBOL, IDMS ou PL/I quando adiciona um mapa de dados IDMS ou após adicioná-lo. Depois de adicionar um mapa de dados IDMS, você pode adicionar elementos CALC e registros e conjuntos do proprietário. Execute um teste de linha de banco de dados para testar um mapa de dados IDMS. TÓPICOS RELACIONADOS: Itens de Mapa de Dados IDMS na página 42 Adicionando um Mapa de Dados IDMS Esse exemplo demonstra como adicionar um mapa de dados IDMS e importar um copybook para o mapa de dados. O PowerExchange transfere por download metadados de z/os para criar os mapas de dados para CA IDMS/DB. Quando estão sendo executados com um nível de segurança de 0 ou 1, os conjuntos de dados são criados em z/os prefixado com a Identificação de Usuário na qual o Ouvinte do PowerExchange está em execução. Se essa Identificação de Usuário não for aceitável, inclua a instrução TEMPHLQ no arquivo de configuração DBMOVER. Para adicionar um mapa de dados IDMS: 1. Na guia Recursos no Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Digite as seguintes informações na caixa de diálogo Nome: Selecione o método de acesso IDMS. Selecione a opção Importar Definições de Registro. 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso IDMS, digite as informações para o método de acesso e clique em Concluir. 5. Na caixa de diálogo Importar Copybook - Detalhes da Origem, selecione Remoto e selecione um dos seguintes tipos de copybook: COBOL 98 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

116 IDMS PL/1 O padrão é COBOL. Nota: Importações de COBOL e PL/I são permitidas com IDMS. No entanto, você deve adicionar manualmente as informações de navegação de registro IDMS. 6. Clique em Avançar. 7. Digite informações na caixa de diálogo Importar Copybook - Detalhes Remotos para o tipo de copybook. Nota: Os parâmetros IDMS são determinados pela configuração e pelos padrões de instalação. 8. Se você selecionou o tipo de copybook IDMS, na caixa de diálogo Importar Copybook - Detalhes IDMS Remotos, clique em Avançado. Na caixa de diálogo Propriedades Avançadas IDMS, digite as informações adicionais para a aquisição de metadados IDMS. Para obter mais informações, consulte Caixa de Diálogo Propriedades Avançadas IDMS na página 140. Clique em OK. 9. Clique em Concluir. 10. Clique em OK. Se você clicar em OK, o Navegador do PowerExchange se comunicará com o Ouvinte do PowerExchange no sistema z/os especificado pelo nome do nó na lista Localização. O Ouvinte do PowerExchange submete a tarefa em lote IDMSMJCL para importar os metadados IDMS. IDMSMJCL é um membro na biblioteca RUNLIB nesse sistema z/os. 11. Clique em Avançar. A caixa de diálogo Importar Copybook - Detalhes de Configuração é exibida. 12. A captura de dados alterados baseada em log IDMS funciona em um nível de registro único. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, digite as seguintes informações: Se o mapa de dados tiver que ser usado para CDC, selecione a opção Criar Tabela em Cada Registro Importado. Se o mapa de dados tiver que ser usado para o movimento de dados em massa e uma representação relacional dos dados IDMS for necessária, selecione a opção Criar Tabelas para Caminhos Hierárquicos IDMS. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página Clique em Concluir. 14. Clique em OK. 15. Na caixa de diálogo Definição de Registro, clique em Aplicar. 16. Para o registro COVERAGE, clique em OK. TÓPICOS RELACIONADOS: Adicionando um Elemento CALC a um Registro IDMS na página 53 Adicionando um Registro e Conjunto do Proprietário a um Registro IDMS na página 53 Enviando um Mapa de Dados para um Sistema Remoto na página 73 Importar Copybook - Caixa de Diálogo Detalhes do Remoto na página 135 Caixa de Diálogo Propriedades Avançadas IDMS na página 140 Mapas de Dados IDMS 99

117 Propriedades do Mapa de Dados - Método de Acesso IDMS na página 324 Editando Propriedades de Registro IDMS Você pode alterar as propriedades de registro IDMS depois de importar os metadados IDMS. Para editar propriedades de registro IDMS: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse em um registro e clique em Propriedades. A caixa de diálogo Propriedades do Registro é exibida. 3. Na guia Nome, defina as propriedades do registro. 4. Na guia Nomes de Registros e Conjuntos do Proprietário, defina as propriedades para registros e conjuntos do proprietário. TÓPICOS RELACIONADOS: Adicionando um Elemento CALC a um Registro IDMS na página 53 Adicionando um Registro e Conjunto do Proprietário a um Registro IDMS na página 53 Itens de Mapa de Dados IDMS na página 42 Propriedades do Registro - Nome (IDMS) na página 340 Adicionando expressões para um Registro IDMS Para retornar informações adicionais para um registro de mapa de dados IDMS, adicione campos definidos pelo usuário que usam um ou mais funções do PowerExchange em uma expressão para processar dados de origem. Essas funções especificam operações como divisão e concatenação de campos. Você também pode chamar as seguintes funções para obter dados de origem CA IDMS/DB: GetDatabaseKey GetDataFlowType GetDbKeyOfOwner GetFullDbKey GetFullDbKeyOfOwner GetPageGroup GetPageGroupOfOwner GetPgGrpAndRdx GetPgGrpAndRdxOfOwner GetPgGrpOfOwner GetRadix GetRadixOfOwner GetSeqWithinLevel GetSeqWithinParent 100 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

118 Você pode também usar a função CallProg em uma expressão para chamar um programa definido pelo usuário para processar dados da fonte. Use expressões para criar estruturas relacionais, como data warehouses, de dados de origem CA IDMS/DB. TÓPICOS RELACIONADOS: Adicionando um Campo Definido pelo Usuário a um Registro na página 48 GetDataFlowType na página 282 GetDbKeyOfOwner na página 282 Adicionando expressões para um registro do IMS na página 107 Funções do PowerExchange para Campos Definidos pelo Usuário na página 272 Mapas de Dados IMS Para usar um banco de dados IMS como fonteou destino de dados, defina um mapa de dados IMS. O mapa de dados é necessário para criar instruções SQL para acesso de tipo relacional a dados IMS durante o processamento da sessão. Ao criar o mapa de dados de um banco de dados de origem ou destino IMS, adicione um ou mais segmentos do IMS e os campos nos segmentos para definir o layout físico dos dados. Um mapa de dados também inclui exibições de tabela dos dados. O segmento e as definições de campo apresentam a exibição não relacional dos dados, e as tabelas e as colunas apresentam a exibição relacional dos dados. Nota: Para fontes de dados IMS, registro refere-se a um segmento raiz e seus filhos. Um mapa de dados pode incluir um ou vários segmentos: Defina um único segmento em um mapa de dados se o arquivo de dados associado contiver um tipo de segmento. Um mapa de dados de segmento único pode definir várias tabelas. Defina vários segmentos em um mapa de dados se o banco de dados de origem contiver vários tipos de segmento. As colunas a menos que o PowerExchange deve recuperar resultam no processamento de arquivos e na extração de dados mais rápidos. Você pode usar mapas de dados para alinhar campos, converter datas, filtrar dados e aprimorar dados para melhorar a precisão dos dados e reduzir o volume de dados. Você pode usar mapas de dados em transformações de Pesquisa para pesquisar valores relacionados e determinar se existem linhas em um destino IMS. Para definir um mapa de dados IMS, conclua as seguintes tarefas: 1. Adicione um mapa de dados IMS. Quando você definir o mapa de dados, selecione o método de acesso DL/1 BATCH ou IMS ODBA e associe o mapa de dados a um arquivo de dados que define os tipos de registro e os dados. Você também deve inserir a origem IMS ou as propriedades de destino necessários para o método de acesso. O acesso ao lote DL/I exige um número do PCB. O acesso ODBA exige um SSID do IMS, um nome do PSB e um nome do PCB. Nota: Você pode substituir o método de acesso no mapa de dados ao configurar uma sessão do PowerCenter ou executar um teste de linha de banco de dados. Se você substituir o método de acesso, deve também inserir as propriedades que o novo método de acesso exige. 2. Se a fonte DBD estiver disponível para os dados IMS, importe a fonte DBD para o mapa de dados. Mapas de Dados IMS 101

119 A fonte DBD define segmentos e a sequência hierárquica para o mapa de dados. Durante o processo de importação, o PowerExchange mapeia os segmentos e campos IMS para tabelas, que criam a exibição relacional dos dados de origem exigida pelo PowerExchange. 3. Para sobrepor cada segmento com seu COPYLIB, importe um copybook COBOL para cada segmento IMS no mapa de dados. 4. Envie o mapa de dados para o Ouvinte do PowerExchange no nó local ou remoto para armazenar o mapa de dados no PowerExchange. Essa ação converte o mapa de dados em um arquivo independente do sistema operacional que o PowerExchange pode acessar para o processamento de extração. 5. Execute um teste de linha de banco de dados para testar o mapa de dados. Um teste de linha de banco de dados acessa os dados de origem reais, exibe-os no formato de tabela e verifica se você pode acessar dados do banco de dados de origem. A instalação do PowerExchange inclui o exemplo de arquivo IMSDEMOS que inclui um exemplo de fonte IMS DBD que você pode usar para criar um exemplo de mapa de dados IMS. Pré-requisitos para Adicionar um Mapa de Dados IMS Antes de adicionar um mapa de dados IMS, você deve reunir informações sobre o banco de dados IMS. Reúna as seguintes informações sobre a origem ou o destino IMS: - O SSID do IMS, que é necessária para acesso ODBA e IMSUNLD aos arquivos de descarregamento. - O nome do banco de dados IMS e do conjunto de dados do banco de dados. - O nome e a localização do conjunto de dados DBD. - O nome do PSB. - Se você usar acesso em lotes DL/I ou BMP aos dados IMS, determine o número do PCB contando o número de PCBs no PSB. Se o PSB tiver COMPAT=YES, adicione um a esse número. - Se você usar acesso IMS ODBA, registre o nome do PCB. - Os nomes dos segmentos IMS e quais segmentos, se houver, são de tamanho variável. Além disso, observe a sequência hierárquica conforme definida na fonte DBD. Para reduzir o número de conflitos de bloqueio, defina PROCOPT para somente leitura para o PCB do banco de dados IMS. Se o PSB for usado com a interface IMS ODBA ou um trabalho Netport BMP, defina o PSB no IMS SYSGEN. Atualize o membro de configuração DBMOVER na biblioteca RUNLIB. Atualize o arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. Se você planeja executar INSERTs ou UPDATEs em um segmento IMS, o mapa de dados deverá representar o tamanho do segmento completo conforme definido no IMS DBD. Caso contrário, um INSERT ou UPDATE no segmento pode gravar dados que não estão em branco no fim do segmento não definido como FILLER. Para evitar esse problema, você pode adicionar uma definição FILLER à COPYLIB antes de importá-lo para o PowerExchange. Configurando Acesso em Lotes DL/I ou BMP a Dados IMS Para usar as interfaces em lotes DL/I ou BMP para acessar dados de origem ou destino IMS, você deve executar algumas tarefas de configuração do PowerExchange no sistema z/os. 102 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

120 O PowerExchange usa o acesso em lotes DL/I ou BMP quando o mapa de dados IMS especifica o método de acesso DL/1 BATCH ou quando você substituir o método de acesso IMS ODBA por DL/1 BATCH em um teste de linha de banco de dados ou uma sessão de movimentação de dados em massa do PowerCenter. Antes de executar um teste de linha de banco de dados ou uma sessão do PowerCenter que usa acesso em lotes DL/I ou BMP, conclua as seguintes tarefas: Personalize o membro IMSJCL na biblioteca RUNLIB para que ele funcione como um trabalho netport de lotes DL/I ou BMP. Você pode incluir a variável de substituição %PSBNAME se desejar substituir o nome do PSB ao executar a sessão de movimentação de dados em massa no PowerCenter. Usando a variável %PSBNAME com a substituição de sessão, você pode usar o mesmo membro da JCL netport para acessar vários PSBs. Se você usar o acesso BMP, autorize por APF o trabalho netport. Criar um mapa de dados IMS que especifica o método de acesso DL/1 BATCH ou substitua o método de acesso IMS ODBA em um mapa de dados IMS por DL/1 BATCH. Você pode substituir o método de acesso nas propriedades da sessão do PowerCenter do destino ou origem IMS, ou ao configurar um teste de linha de banco de dados. No membro de configuração DBMOVER no RUNLIB, adicione uma instrução NETPORT e a instrução LISTENER correspondente a cada PSB. Você pode inserir até dez pares de instruções no membro DBMOVER. Sugestão: Para evitar exceder este limite quando você precisar processar mais de dez PSBs, especifique o %PSBNAME na JCL netport e um valor Substituição IMS PSBNAME nas propriedades da sessão do PowerCenter. Em seguida, você poderá usar o mesmo par de instruções NETPORT e LISTENER para vários PSBs. Para obter mais informações, consulte Interfaces do PowerExchange para PowerCenter. Para que as alterações do DBMOVER entrem em vigor, você deve reiniciar o Ouvinte do PowerExchange. Nota: Você também pode substituir o nome do PSB e número do PCB de uma sessão do PowerCenter ou um teste de linha de banco de dados. Configurando o acesso IMS ODBA a dados do IMS Para usar o IMS ODBA para acessar dados do IMS, é necessário concluir algumas tarefas de configuração do PowerExchange e do IMS no sistema z/os. O PowerExchange usa acesso IMS ODBA quando o mapa de dados IMS especifica IMS ODBA como o método de acesso ou quando você substitui o método de acesso DL/1 BATCH por IMS ODBA em um teste de linha de banco de dados ou uma sessão de movimentação de dados em massa do PowerCenter. As consultas IMS ODBA são executadas como subtarefas do Ouvinte do PowerExchange e usam a porta do Ouvinte. Para usar o acesso ODBA, execute as seguintes tarefas de configuração: Autorize por APF as bibliotecas STEPLIB do Ouvinte do PowerExchange. Inclua a biblioteca RESLIB na biblioteca STEPLIB do Ouvinte do PowerExchange para acesso ODBA ou verifique se a RESLIB está acessível por meio da concatenação LNKLST no sistema z/os. Verifique se cada PSB contém PCBNAMEs definidos. Crie um mapa de dados IMS que especifique IMS ODBA como método de acesso ou substitua o método de acesso DL/1 BATCH em um mapa de dados IMS pelo IMS ODBA. Você pode substituir o método de acesso nas propriedades da sessão do PowerCenter ou ao configurar um teste de linha de banco de dados. Nota: Você também pode substituir o SSID do IMS, o nome do PSB e o nome do PCB em uma sessão do PowerCenter ou um teste de linha de banco de dados. Mapas de Dados IMS 103

121 No membro de configuração DBMOVER na RUNLIB, adicione as instruções IMSID =ssid e ODBASUPP=YES. Em seguida, reinicie o Ouvinte do PowerExchange para que essas alterações do DBMOVER entrem em vigor. Verifique se o Resource Recovery Services (RRS) do IMS está ativo no sistema. No membro DFSPBxxx da PROCLIB do IMS, especifique RRS=Y. Monte e linkedit o módulo de carregamento IMS para configurar o acesso ODBA aos dados. Use a JCL semelhante à seguinte JCL: //ULIA JOB (),CLASS=A,MSGCLASS=H,MSGLEVEL=(1,1),REGION=4M //* //STEP1 EXEC HLASMCL, // PARM.C=('RENT') //C.SYSLIB DD DISP=SHR,DSN=SYS1.MACLIB // DD DISP=SHR,DSN=IMS710.ADFSMAC //C.SYSIN DD * DFSIMS70 CSECT * * THE DFSPRP MACRO GENERATES THE DRA STARTUP TABLE * THERE ARE A FEW MORE POSSIBLE PARMS DFSPRP DSECT=NO, GENERATE X FUNCLV=1, FUNCTION LEVEL X DDNAME=CCTLDD, DDNAME FOR DRA RESLIB X DSNAME=IMS1210.SDFSRESL, DSNAME FOR DRA RESLIB X DBCTLID=IMSC, DBCTL IDENTIFIER X USERID=, USERID X MINTHRD=2, MIN NUMBER OF THREADS X MAXTHRD=7, MAX NUMBER OF THREADS X TIMER=60, IDENTIFY TIMER VALUE DEFAULT X FPBUF=5, NUMBER OF FP BUFFERS PER THREAD X FPBOF=5, NUMBER OF FP OVERFLOW BUFFERS X SOD=A, SNAP DATASET OUTPUT CLASS X AGN=, APPLICATION GROUP NAME X TIMEOUT=60, DRATERM TIMEOUT VALUE X IDRETRY=0, IDENTIFY RETRY COUNT X CNBA=10 TOTAL FP NBA BUFFERS FOR CCTL END //L.SYSLMOD DD DSN=ABC.A.LOAD(DFSIMSC0), // DISP=SHR A instrução L.SYSLMOD DD deve especificar um nome de módulo que tenha o seguinte formato: "DFS" + DBCTLID_value + "0". Esse nome de módulo deve corresponder ao SSID da região de controle e deve ser especificado no mapa de dados IMS. Neste exemplo de JCL, o nome do módulo é DFSIMSC0. Configurando o Arquivo dbmover.cfg do PowerExchange no Windows Antes de adicionar um mapa de dados IMS, atualize o arquivo dbmover.cfg no Windows para conceder acesso aos dados de origem IMS. As definições de configuração dependem de se você acessa o IMS usando o lote DL/1 ou o IMS ODBA. 104 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

122 Para configurar o arquivo dbmover.cfg do PowerExchange no Windows: 1. Adicione uma instrução NODE ao arquivo dbmover.cfg para acessar o sistema IMS remoto, como a seguir: Para usar o lote DL/1 ou o BMP para acessar IMS, adicione uma instrução NODE que aponta para a porta netport para o Ouvinte do PowerExchange no z/os. O formato é: NODE=(location_name,TCPIP,[hostname_or_IPaddress],port_number) Para usar IMS ODBA para acessar IMS, adicione uma instrução NODE que aponte para a porta do Ouvinte do PowerExchange no z/os. O formato é: NODE=(location_name,TCPIP,[hostname_or_IPaddress],port_number) 2. Reinicie o Ouvinte do PowerExchange para implementar as mudanças de configuração. Nota: Não é necessário iniciar o Ouvinte do PowerExchange no Windows para acessar os dados IMS. Adicionando um Mapa de Dados IMS Para adicionar um mapa de dados IMS, é necessário especificar um nome de esquema, um nome do mapa de dados e um método de acesso. Para definir o layout de dados, você pode importar um IMS DBD ao criar o mapa de dados ou posteriormente. 1. Na guia Recursos no Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Na caixa de diálogo Nome, digite as seguintes informações: Campo Nome do Esquema Nome do Mapa de Dados Descrição O nome do esquema. Um nome definido pelo usuário para o mapa de dados. Mapas de Dados IMS 105

123 Campo Método de Acesso Importar Definições de Registro Descrição Uma das seguintes opções para acessar os dados de origem: - DL/1 BATCH. Acessa um banco de dados IMS por meio da JCL submetida. Embora o método de acesso seja lote DL/1, você pode escolher DL/1 ou BMP para a tarefa netport. - IMS ODBA. Conecta a um banco de dados IMS por meio de uma conexão aberta de banco de dados de fonte. - SEQ. Acessa um banco de dados IMS que você planeja usar como um arquivo simples. Nota: Você pode substituir o método de acesso DL/1 BATCH IMS ODBA posteriormente ao executar um teste de linha de banco de dados ou uma sessão de movimentação de dados em massa do PowerCenter. Selecione essa caixa para importar um DBD para o mapa de dados. A importação DBD adiciona segmentos e exibições de tabela correspondentes ao mapa de dados, juntamente com o campo de chave, o campo de pesquisa e as definições de campo CCK. Ela define também a sequência hierárquica de segmentos. Depois de importar um DBD, você pode importar um copybook COBOL ou PL/I para cada segmento no mapa de dados para sobrepor o segmento com seu COPYLIB. 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso, insira as informações do método de acesso que você selecionou. Clique em Concluir. 5. Se você selecionou Importar Definições de Registro, importe o IMS DBD e os copybooks de segmento. Depois de concluir o mapa de dados, execute testes de linha do banco de dados nas tabelas no mapa de dados para verificar se o mapa de dados pode ser usado para acessar dados. TÓPICOS RELACIONADOS: Importando um Copybook para um Mapa de Dados na página 124 Exibindo Dados IMS Em um mapa de dados IMS, os registros mostram a exibição não relacional dos dados e as tabelas mostram a exibição relacional dos dados. Quando você importa dados para um único segmento, a exibição do registro e da tabela para o segmento é mostrada no mapa de dados. Se você importar dados para vários segmentos, vários segmentos serão exibidos no mapa de dados. Você pode também exibir a hierarquia IMS criada pela importação de fonte DBD. 106 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

124 Exibindo uma Hierarquia IMS Você pode exibir uma hierarquia IMS criada pela importação de fonte DBD. Para exibir uma hierarquia IMS: u Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse em um mapa de dados e clique em Exibir Hierarquia IMS. É exibida a hierarquia IMS para o mapa de dados IMS. Adicionando expressões para um registro do IMS Para retornar informações adicionais para um registro de mapa de dados IMS, adicione campos definidos pelo usuário que usam um ou mais funções do PowerExchange em uma expressão para processar dados de origem. Essas funções especificam operações como divisão e concatenação de campos. Você também pode usar as seguintes funções para obter dados de origem IMS: GetDatabaseKey GetIMSRBAByLevel GetSeqWithinLevel GetSeqWithinParent Você pode também usar a função CallProg em uma expressão para chamar um programa definido pelo usuário para processar dados da fonte. TÓPICOS RELACIONADOS: Adicionando expressões para um Registro IDMS na página 100 Funções do PowerExchange para Campos Definidos pelo Usuário na página 272 Obtendo o RBA para um registro do IMS Para obter o RBA IMS para um registro do IMS, adicione um campo definido pelo usuário para o registro no mapa de dados do IMS. No campo definido pelo usuário, use a função GetDatabaseKey ou GetIMSRBAByLevel em uma expressão. Para adicionar o segmento RBA aos dados de segmento em um mapa de dados do IMS, a Informatica recomenda que você use a função GetIMSRBAByLevel em vez da função GetDatabaseKey. A função GetIMSRBAByLevel permite que você obtenha o RBA de um segmento pai sem chave ou com chave não exclusivo. Use a função GetIMSRBAByLevel nos mapas de dados do IMS usados para operações de movimentação de dados em massa ou CDC síncrono do IMS. Você não pode usar a função GetIMSRBAByLevel em registros nos seguintes tipos de mapas de dados do IMS: Mapas de dados do IMS usados para CDC com base em logs do IMS. Mapas de dados do IMS usados para acessar arquivos descarregados do IMS que contêm os seguintes tipos de registros: - Registros de descarregamento de qualquer formato para os conjuntos de dados HISAM Mapas de Dados IMS 107

125 - Registros de descarregamento com formato BMC SHORT ou BMC XSHORT para os conjuntos de dados HDAM e HIDAM - Registros de descarregamento que apresentam o formato IBM padrão para os conjuntos de dados de Caminho Rápido IMS Para executar um teste de linha de banco de dados nos seguintes tipos de mapas de dados que usam a função GetIMSRBAByLevel, será necessário autorizar por APF as seguintes bibliotecas: Se você usar os mapas de dados do batch IMS DL/1 com BMP para o trabalho netport, será necessário autorizar por APF de todas as bibliotecas na concatenação STEPLIB de BMP. Caso contrário, o PowerExchange emitirá a mensagem PWX com o código de retorno 12. Se você usar mapas de dados IMS ODBA, será necessário autorizar por APF de todas as bibliotecas na concatenação STEPLIB do Ouvinte do PowerExchange. Caso contrário, o PowerExchange será encerrado de forma anormal. TÓPICOS RELACIONADOS: Adicionando um Campo Definido pelo Usuário a um Registro na página 48 GetDatabaseKey na página 280 Editando Propriedades em um Mapa de Dados IMS Para atualizar segmentos e tabelas em um mapa de dados IMS, reimporte o copybook DBD ou COBOL para o mapa de dados. Você pode também editar manualmente propriedades para segmentos e tabelas em um mapa de dados IMS. Aviso: Editar manualmente segmentos e tabelas em um mapa de dados pode resultar na perda de dados do mapa de dados. TÓPICOS RELACIONADOS: Exibindo ou Editando Propriedades para uma Tabela de Mapa de Dados na página 69 Importando um Copybook para um Mapa de Dados na página 124 Importando um Copybook para um Registro ou um Segmento na página 126 Enviando um Mapa de Dados IMS para um Sistema Remoto Para armazenar um mapa de dados IMS, envie o mapa de dados para o Ouvinte do PowerExchange no mesmo sistema que os dados de origem IMS. Armazene cada mapa de dados que você criar para que o PowerExchange possa extrair os dados de origem relacionados. Quando você armazena um mapa de dados, o PowerExchange o converte para um arquivo independente do sistema operacional que o PowerExchange pode acessar para o processamento de extração. TÓPICOS RELACIONADOS: Enviando um Mapa de Dados para um Sistema Remoto na página 73 Usando Transformações de Pesquisa para Pesquisar Dados em Bancos de Dados IMS Para pesquisar dados em bancos de dados IMS, use as transformações de Pesquisa do PowerCenter. 108 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

126 Use uma tarefa netport separada para cada transformação de Pesquisa para PCBs com um GOx PROCOPT. Nota: Especifique os valores de chave IMS de um segmento para que os SSAs sejam executados de forma eficiente no IMS. Gravando Dados para um Banco de Dados IMS Você pode gravar dados de origem de um mapa de dados para um banco de dados IMS. Use o Cliente do PowerExchange para PowerCenter (PWXPC) para gravar dados para IMS. Quando você gravar dados no IMS, considere as seguintes diretrizes: Especifique os valores de chaves de um segmento para que todo o processamento necessário para gravar dados para o segmento ocorra dentro do IMS. Você não pode usar segmentos SDEP. Você não pode atualizar um segmento abaixo de um segmento sem chave. Você pode usar segmentos que contêm uma cláusula OCCURS na qual o COPYLIB foi alterado para identificar cada um dos campos na cláusula OCCURS como um campo separado, que elimina a cláusula OCCURS na definição COPYLIB. Você não pode gerar uma linha separada para cada ocorrência da cláusula OCCURS. Quando você importar um mapa de dados para o PowerCenter, verifique se os campos CCK que você deseja usar como campos de chaves estão marcados como campos de chaves. No PowerCenter, use uma frequência mais baixa de Confirmação para reduzir o risco de bloquear os segmentos. Use uma tarefa netport separada para gravar dados IMS. Usar uma tarefa netport separada permite que você acesse um PSB com intenção de gravar e modifique a JCL para atualizar dados IMS, como o log IEFRDER. Quando você gravar dados para um dos seguintes tipos de campos para o banco de dados, indique se o campo é opcional quando você adicionar o mapa de dados: - Espaços para um campo - Nenhum dado para um campo Se você tiver vários campos desse tipo, indique se o primeiro campo no mapa de dados é opcional e se todos os campos seguintes são opcionais. Se você não especificar se o campo é opcional, serão exibidos erros no log de sessão do PowerCenter. 1. Para verificar se o sistema z/os está acessível, execute ping no endereço IP do sistema z/os no qual o banco de dados de destino está localizado. 2. No arquivo de configuração dbmover.cfg, inclua uma instrução NODE que aponta para o sistema z/os remoto. 3. Para verificar se o Ouvinte do PowerExchange remoto foi iniciado, emita o seguinte comando: dtlrexe loc=xxxx prog=ping uid=userid pwd={password passphrase} Em que xxxx é o nome NODE do arquivo de configuração dbmover.cfg do PowerExchange. 4. No Navegador do PowerExchange, adicione, teste e armazene um mapa de dados IMS. 5. Use o PowerCenter para mover os dados para o IMS. Mapas de Dados IMS 109

127 Exibindo ou Editando Opções IMS para uma Tabela As opções definidas na guia Opções IMS na caixa de diálogo Propriedades da Tabela indicam como os dados são gravados para um banco de dados IMS e apresentam valores padrão para um desempenho ótimo ao trabalhar com o IMS. Essas opções são definidas para valores padrão que fazem com que o PowerExchange: Trate o IMS como um destino relacional Comporte-se como um programa aplicativo IMS COBOL Editar os valores padrão para essas opções impacta a quantidade de dados enviados ao banco de dados e o tempo necessário para gravar os dados. Para exibir ou alterar opções IMS: 1. Abra um mapa de dados IMS. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse em uma tabela e selecione Propriedades. 3. Na guia Opções IMS na caixa de diálogo Propriedades da Tabela, defina as opções IMS para a tabela. Aviso: Não edite o valor padrão para a opção Opções de Exclusão a não ser que você esteja familiarizado com a hierarquia IMS. Alterar essas definições pode resultar na perda de dados IMS. TÓPICOS RELACIONADOS: Propriedades da Tabela - Opções IMS na página 357 Testando um Mapa de Dados IMS Depois de adicionar um mapa de dados e armazená-lo no PowerExchange, execute um teste de linha de banco de dados para testar o mapa de dados e verificar se você pode acessar a fonte de dados. Um teste de linha de banco de dados acessa os dados de origem reais e os exibe no formato de tabela. Um teste de linha de banco de dados pode ler dados de um arquivo de descarregamento IMS ou de um banco de dados IMS. Para testar um mapa de dados IMS, selecione o tipo de fonte de dados na caixa de diálogo Teste de Linha de Banco de Dados, como a seguir: Arquivo de descarregamento IMS. Na lista Tipo de DB, selecione IMSUNLD. Banco de dados IMS. Na lista Tipo de DB, selecione NRDB ou NRDB2. TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Exemplos do Mapa de Dados IMS Os exemplos a seguir demonstram como criar um mapa de dados de segmento único e um mapa de dados de vários segmentos usando o exemplo de fonte DBD apresentado pelo PowerExchange. O PowerExchange apresenta o seguinte exemplo de fonte DBD: DBD NAME=IMSDEMO,ACCESS=(HDAM,VSAM),X RMNAME=(DFSHDC40,50,80),X EXIT=(*,KEY,PATH,(CASCADE,KEY,PATH),LOG) DATASET DD1=IMSDEMO,DEVICE=3380,SIZE=8192,SCAN=3 SEGM NAME=IMSDEMOS,BYTES=80FIELD NAME=(DTLKEY,SEQ),BYTES=9,START=3 FIELD NAME=RECTYPE,BYTES=1,START=12FIELD NAME=AMOUNT,BYTES=4,START= Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

128 FIELD NAME=BINNO,BYTES=4,START=17FIELD NAME=DECNO,BYTES=3,START=21 FIELD NAME=DTYY,BYTES=2,START=24FIELD NAME=DTMM,BYTES=2,START=26 FIELD NAME=DTDD,BYTES=2,START=28FIELD NAME=ACCT1,BYTES=10,START=30 FIELD NAME=ACCT2,BYTES=10,START=40 FIELD NAME=ACCT3,BYTES=10,START=50 DBDGEN FINISH Quando você instala o PowerExchange no z/os, o PowerExchange cria bibliotecas com o qualificador de alto nível especificado no Assistente de Instalação MVS. No z/os, execute a seguinte tarefa para criar o ambiente IMS para o exemplo de instalação: hlq.dtldemo(imsdef) Adicionando um Mapa de Dados de Segmento Único IMS - Exemplo Esse exemplo demonstra como criar um mapa de dados para um segmento IMS único. Nesse exemplo, você usa o exemplo IMSDEMOS e importa o exemplo de arquivo de origem DBD para definir o segmento e a sequência hierárquica. Você também importa um copybook COBOL para o segmento. Esse exemplo usa o método de acesso ao lote DL/1. Para adicionar um mapa de dados IMS de segmento único: 1. Na guia Recursos no Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Digite as seguintes informações na caixa de diálogo Nome: Na caixa Nome do Esquema, digite IMSS1. Na caixa Nome do Mapa de Dados, digite IMSM1. Na lista Método de Acesso, selecione DL/1 BATCH. Selecione a opção Importar Definições de Registro. 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso ao Lote DL/1, especifique informações sobre a fonte de dados. Se você estiver lendo um conjunto de dados de descarregamento IMS, os valores IMS SSID e Nome do DBD serão necessários. Se você estiver lendo o banco de dados IMS usando uma tarefa netport que executa lote DL/1 ou BMP, o valor Número de PCB será necessário. 5. Clique em Concluir. Na guia Mapa de Dados no Explorador de Recursos, o mapa de dados IMSS1.IMSM1 é exibido. 6. Na caixa de diálogo Importar Copybook - Detalhes da Origem, digite as seguintes informações: Selecione a opção Remoto. Na lista Tipo, selecione DBD. 7. Clique em Avançar. 8. Na caixa de diálogo Importar Copybook - Detalhes do DBD Remoto, digite as seguintes informações: Na caixa Nome do Arquivo, digite o nome PDS e o membro DBD com o qualificador de alto nível (HLQ) que você especificou na instalação. Por exemplo: hlq.dtldemo(imsdbd) Na lista Localização, selecione a localização do z/os. Mapas de Dados IMS 111

129 As localizações exibidas na lista Localização são definidas pelas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. Se a segurança tiver sido implementada para o Ouvinte do PowerExchange em z/os, digite a Identificação de Usuário e a senha do z/os. Na caixa Salvar Arquivo Localmente como, digite IMSDBD. 9. Clique em Avançar. 10. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, selecione as seguintes opções: Selecione a opção Criar tabelas para caminhos hierárquicos DL1. Aceite os outros padrões. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página Clique em Concluir. 12. Na caixa de diálogo Importar Detalhes de Configuração do Copybook, consulte suas seleções e clique em Concluir. 13. Para importar a origem DBD, clique em OK. 14. Na caixa de diálogo Definição de Registro, clique em Importar. Se necessário, ignore um tipo de registro ou interrompa uma importação. Para obter mais informações, consulte Importando um Copybook para um Registro ou um Segmento na página Para concluir a importação, clique em Próxima Redefinição ou Redefinição Anterior para mover a seta azul para selecionar uma linha. 16. Se solicitado, clique em Retomar Importação para retomar a importação. 17. Exiba as informações de log relativas ao processo de importação. Importando um Copybook para um Mapa de Dados de Segmento Único IMS - Exemplo Esse exemplo demonstra como importar um copybook para um mapa de dados de segmento único IMS. Para importar um copybook para um mapa de dados de segmento único IMS - exemplo: 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, selecione o segmento IMS. 3. Clique em Arquivo > Importar Copybook. 4. Na caixa de diálogo Importar Copybook - Detalhes da Fonte, digite as seguintes informações: Selecione a opção Remoto. Na lista Tipo, selecione COBOL. 5. Clique em Avançar. 6. Na caixa de diálogo Importar Detalhes do DBD Remoto do Copybook, digite as seguintes informações: Na caixa Nome do Arquivo, digite o nome e a localização do copybook. Na lista Localização, selecione a localização do z/os. 112 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

130 As localizações exibidas na lista Localização são definidas pelas instruções NODE no arquivo de configuração dbmover.cfg na máquina do Navegador do PowerExchange. Se a segurança tiver sido implementada para o Ouvinte do PowerExchange em z/os, digite a Identificação de Usuário e a senha do z/os. Na caixa Salvar Arquivo Localmente Como, digite um nome de arquivo. 7. Clique em Avançar. 8. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, aceite os padrões e clique em Concluir. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página Na caixa de diálogo Importar Detalhes de Configuração do Copybook, consulte suas seleções e clique em Concluir. 10. Responda ao avisos de importação. 11. Quando a importação for concluída, consulte os dados. 12. Armazene o mapa de dados. 13. Execute um teste de linha de banco de dados para testar o mapa de dados. Adicionando um Mapa de Dados de Segmentos Múltiplos IMS - Exemplo Esse exemplo demonstra como adicionar um mapa de dados de segmentos múltiplos IMS que define uma tabela complexa. Nesse exemplo, você adiciona vários segmentos, um de cada vez, para criar um relacionamento hierárquico entre os segmentos na tabela complexa. Para criar um mapa de dados de segmentos múltiplos IMS: 1. Abra um mapa de dados que contém vários segmentos. 2. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse em uma tabela e clique em Propriedades. 3. Na caixa de diálogo Propriedades da Tabela, digite as seguintes informações: Na lista Dependências do Registro, selecione um segmento para torná-lo o pai. Na lista Registros Disponíveis, clique com o botão direito do mouse em um segmento para adicioná-lo como filho e clique em Adicionar Registro como Filho. Na lista Dependências do Registro, selecione o segmento pai. Na lista Como você deseja gerenciar várias instâncias do registro selecionado, selecione Nova Linha. Na lista Dependências do Registro, selecione cada segmento filho e defina a opção de várias instâncias para Nova Linha. 4. Clique em OK. Nota: Para cada segmento na hierarquia, você pode definir diferentes opções para a opção Como você deseja gerenciar várias instâncias do registro selecionado. Por exemplo, defina ROOT para Ignorar, SEG1 para Nova Linha e SEG2 para Array. Se um segmento pai for definido para Array, defina todos os segmentos filhos para Ignorar. Você pode também definir segmentos no mesmo nível. Por exemplo, adicione SEG1 e SEG2 aos segmentos ROOT como irmãos. Mapas de Dados IMS 113

131 TÓPICOS RELACIONADOS: Exibindo uma Hierarquia IMS na página 107 Propriedades da Tabela - Definição na página 353 Mapas de Dados SEQ Para acessar arquivos no Linux, UNIX ou Windows ou conjuntos de dados sequenciais no z/os por meio do PowerExchange, adicione um mapa de dados que usa o método de acesso SEQ. Você pode importar um copybook COBOL ou PL/I para descrever a estrutura do arquivo de origem quando adiciona um mapa de dados SEQ ou posterior. Para testar um mapa de dados SEQ, execute um teste de linha de banco de dados. Adicionando um Mapa de Dados SEQ Quando você adiciona um mapa de dados, pode importar um copybook para descrever a estrutura do conjunto de dados sequencial ou do arquivo simples. As etapas a seguir pressupõem que você usa um copybook. 1. Clique na guia Recursos no Explorador de Recursos. 2. Na barra de menus, clique em Adicionar > Mapa de Dados. 3. Na página Nome, digite as seguintes informações: Insira o Nome do Esquema e o Nome do Mapa de Dados. Na lista Método de Acesso, selecione SEQ. Para importar definições de registro de um copybook, selecione a opção Importar Definições de Registro. 4. Clique em Avançar. 5. Na página Método de Acesso SEQ, digite Nome de Arquivo e outras informações necessárias e clique em Concluir. Para obter mais informações, consulte Propriedades do Mapa de Dados - Método de Acesso SEQ na página Na página Importar Copybook - Detalhes da Fonte, selecione o tipo de origem. Em seguida, selecione um dos seguintes tipos de copybook: COBOL PL/1 O padrão é COBOL. 7. Clique em Avançar. 8. Na página Importar Copybook - Detalhes Remotos referente ao tipo de copybook, digite as informações sobre o copybook e clique em Avançar. 9. Na página Importar Copybook - Detalhes de Configuração, selecione as ações para registros, campos e tabelas importados e clique em Avançar. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

132 10. Na página Informações de Importação do Copybook, consulte as informações da operação de importação e clique em OK. 11. Na página Definição de Registro, selecione uma ação para cada registro importado e clique em OK. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página 124. A janela Importação exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. Nota: Se uma mensagem de erro for exibida na janela Log de Mensagens do Copybook, dê um clique duplo na mensagem para localizar a linha associada no copybook. 12. Se você importou vários registros, pode executar as seguintes ações para cada registro para definir um valor de identificação de registro: a. Na guia Mapa de Dados do Explorador de Recursos, clique no registro. b. Na janela Registro, clique com o botão direito do mouse no campo que identifica o registro e clique em Propriedades. A guia Nome na caixa de diálogo Propriedades do Campo é exibida. c. Na caixa Valores de Identificação de Registro, digite um valor e o operador que define o registro. 13. Para identificar os relacionamentos entre tipos de registro, insira as propriedades opcionais do registro. Execute as seguintes ações para cada registro: a. Clique com o botão direito do mouse no registro. b. Selecione Propriedades. c. Selecione a opção Nome do Registro Pai, Nome do Registro de Redefinições ou Registro de Cabeçalho/Trailer e selecione o nome do registro ou o tipo de registro. Com esses metadados, você pode importar um mapa de dados de vários registros para o PowerCenter para executar gravações de vários registros. Para obter mais informações sobre gravações de vários registros, consulte o Guia de Movimentação de Dados em Massa do PowerExchange e as Interfaces do PowerExchange para o PowerCenter. Exibindo uma Hierarquia de Registros SEQ ou VSAM Você pode exibir a hierarquia de um registro em um mapa de dados SEQ ou VSAM. A hierarquia é baseada nas propriedades de registro opcionais de Nome do Registro Pai, Nome do Registro de Redefinições e Registro de Cabeçalho/Trailer definidas por você. u Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse em um registro e clique em Exibir Hierarquia. A hierarquia que inclui o registro selecionado aparece, com o nome do registro selecionado exibido em negrito. Um registro que é uma redefinição de outro registro é rotulado como REDEF no diagrama de hierarquia. Mapas de Dados VSAM Para acessar dados VSAM não relacionais por meio do PowerExchange, adicione um mapa de dados VSAM. Mapas de Dados VSAM 115

133 O PowerExchange acessa os dados VSAM usando SQL, como se a fonte de dados fosse relacional. Você pode adicionar mapas de dados para os seguintes tipos de conjuntos de dados VSAM: Key-Sequenced Data Set (KSDS) Entry-Sequenced Data Set (ESDS) Fixed-length Relative Record Data Set (RRDS) Variable-length Relative Record Data Set (VRRDS) Estes conjuntos de dados podem estar no formato básico, no formato estendido ou compactado. Execute um teste de linha de banco de dados para testar um mapa de dados VSAM. Adicionando um Mapa de Dados VSAM Quando você adiciona um mapa de dados, pode importar um copybook para descrever a estrutura do conjunto de dados VSAM. As etapas a seguir pressupõem que você usa um copybook. 1. Clique na guia Recursos no Explorador de Recursos. 2. Na barra de menus, clique em Adicionar > Mapa de Dados. 3. Na página Nome, digite as seguintes informações: Na lista Método de Acesso, selecione ESDS, KSDS ou RRDS. Selecione a opção Importar Definições de Registro. Nota: Selecione o método de acesso RRDS para os conjuntos de dados de tamanho fixo e de tamanho variável RRDS (VRRDS). 4. Clique em Avançar. 5. Na página Método de Acesso, digite as informações para o método de acesso e clique em Concluir. Nota: Por padrão, o PowerExchange usa o armazenamento em buffer definido pelo sistema para o processamento VSAM. Para ajustar o processamento do PowerExchange, especifique buffers VSAM adicionais. 6. Na página Importar Copybook - Detalhes da Fonte, selecione o tipo de origem. Em seguida, selecione um dos seguintes tipos de copybook: COBOL PL/1 O padrão é COBOL. 7. Clique em Avançar. 8. Na página Importar Copybook - Detalhes Remotos referente ao tipo de copybook, digite as informações sobre o copybook e clique em Avançar. 9. Na página Importar Copybook - Detalhes de Configuração, selecione as ações para registros, campos e tabelas importados e clique em Avançar. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página Na página Informações de Importação do Copybook, consulte as informações da operação de importação e clique em OK. 11. Na página Definição de Registro, selecione uma ação para cada registro importado e clique em OK. Para obter mais informações, consulte Importando um Copybook para um Mapa de Dados na página Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

134 A janela Importação exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. Nota: Se uma mensagem de erro for exibida na janela Log de Mensagens do Copybook, dê um clique duplo na mensagem para localizar a linha associada no copybook. 12. Se você importou vários registros, pode executar as seguintes ações para cada registro para definir um valor de identificação de registro: a. Na guia Mapa de Dados do Explorador de Recursos, clique no registro. b. Na janela Registro, clique com o botão direito do mouse no campo que identifica o registro e clique em Propriedades. A guia Nome na caixa de diálogo Propriedades do Campo é exibida. c. Na caixa Valores de Identificação de Registro, digite um valor e o operador que define o registro. 13. Para identificar os relacionamentos entre tipos de registro, insira as propriedades opcionais do registro. Execute as seguintes ações para cada registro: a. Clique com o botão direito do mouse no registro. b. Selecione Propriedades. c. Selecione a opção Nome do Registro Pai, Nome do Registro de Redefinições ou Registro de Cabeçalho/Trailer e selecione o nome do registro ou o tipo de registro. Com esses metadados, você pode importar um mapa de dados de vários registros para o PowerCenter para executar gravações de vários registros. Para obter mais informações sobre gravações de vários registros, consulte o Guia de Movimentação de Dados em Massa do PowerExchange e as Interfaces do PowerExchange para o PowerCenter. TÓPICOS RELACIONADOS: Propriedades do Mapa de Dados - Método de Acesso ESDS na página 323 Propriedades do Mapa de Dados - Método de Acesso KSDS na página 325 Propriedades do Mapa de Dados - Método de Acesso RRDS na página 327 Exibindo uma Hierarquia de Registros SEQ ou VSAM Você pode exibir a hierarquia de um registro em um mapa de dados SEQ ou VSAM. A hierarquia é baseada nas propriedades de registro opcionais de Nome do Registro Pai, Nome do Registro de Redefinições e Registro de Cabeçalho/Trailer definidas por você. u Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse em um registro e clique em Exibir Hierarquia. A hierarquia que inclui o registro selecionado aparece, com o nome do registro selecionado exibido em negrito. Um registro que é uma redefinição de outro registro é rotulado como REDEF no diagrama de hierarquia. Aprimorando o Desempenho de Leitura em Massa para Conjuntos de Dados VSAM Você pode aprimorar o desempenho de operações de leitura em massa para conjuntos de dados VSAM. O PowerExchange apresenta as seguintes opções para aprimorar o desempenho: Especificar o número de buffers de dados e de índice a usar durante a leitura de dados. Mapas de Dados VSAM 117

135 Especificar o acesso do intervalo de controle. Usar chaves em cláusulas WHERE. Número de Buffers de Dados VSAM Você pode especificar o número de buffers de E/S que VSAM usa para transmitir dados entre o armazenamento virtual e o auxiliar. Um buffer é o tamanho de um intervalo de controle no componente de dados. Os valores válidos para o número de buffers de dados (BUFND) vão de 0 a O valor mínimo é 1 mais o valor especificado para STRNO. Se você omitir STRNO, BUFND deverá ser no mínimo 2, pois o padrão para STRNO é 1. Nota: A especificação mínima do buffer não apresenta um desempenho de processamento sequencial ótimo. Geralmente, quanto mais os buffers de dados são especificados, melhor o desempenho. Os buffers de dados adicionais podem beneficiar inserções ou atualizações de divisões da área de controle e acesso de registro abrangido de benefícios. O número máximo de buffers é 255, que inclui 254 buffers de dados e um buffer de inserção. Número de Buffers de Índice VSAM Especifica o número de buffers de E/S que VSAM usa para transmitir o conteúdo de entradas do índice entre o armazenamento virtual e o auxiliar para acesso de chave. Um buffer é o tamanho de um intervalo de controle no índice. Os valores válidos para o número de buffers de índice (BUFNI) vão de 0 a O número mínimo é o número especificado para STRNO. Se você omitir STRNO, BUFNI deverá ser no mínimo 1, pois o padrão para STRNO é 1. O padrão é o número mínimo necessário. Os buffers de índice adicionais aperfeiçoam o desempenho apresentando a residência de alguns ou todos os índices de alto nível, o que minimiza o número de registros de índice de alto nível recuperados de DASD para o processamento direto de chave. Altere o número de buffers usados em um nível de sistema do PowerExchange incluindo uma instrução VSAM no membro de configuração DBMOVER. O valor nessa instrução substitui qualquer entrada no mapa de dados. O número máximo de buffers é 255, que inclui 254 buffers de dados e um buffer de inserção. O padrão é o número mínimo necessário. Usando o Acesso do Intervalo de Controle VSAM O acesso do Intervalo de Controle (CI) é uma opção de leitura que faz com que o método de acesso VSAM use leituras do intervalo de controle direto para recuperar registros de dados. Se você extrair todos os dados do conjunto de dados VSAM, essa opção poderá aperfeiçoar o desempenho de leitura sequencial. Se você especificar uma cláusula WHERE ao recuperar os dados, o acesso do CI não apresentará nenhum benefício ao desempenho. Para selecionar o acesso do CI no nível do mapa de dados, selecione a opção CI ACCESS na guia Método de Acesso na caixa de diálogo Propriedades do Mapa de Dados. A opção CI ACCESS é válida para os métodos de acesso KSDS, ESDS e RRDS. O acesso ao CI não é suportado para conjuntos de dados VSAM compactados ou conjuntos de dados VSAM com registros estendidos. 118 Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

136 Usando Chaves VSAM O PowerExchange lê informações de chaves para conjuntos de dados VSAM do catálogo quando o conjunto de dados é alocado e aberto. Tanto o tamanho da chave quanto a posição da chave relativa são recuperados. Por exemplo, as linhas a seguir definem um layout de registro para keypos=10 e keylen=4: 01 REC. 04 HEADER PIC X(10). 04 KEY. 08 KEY1 PIC KEY2 PIC REST PIC X(200). Para que a otimização funcione, inclua KEY1 na cláusula WHERE. Use informações da chave para acelerar o processamento de cláusulas WHERE, que especificam a otimização. Formatos diferentes da cláusula WHERE produzem resultados diferentes. Por exemplo: Line 1 SELECT * FROM TEST.VSAM1.TAB WHERE (KEY1 > 50) AND (KEY1 < 90) A linha 1 é convertida para: (50 < KEY1 < HIGH-HALUES) AND (LOW-VALUES < KEY1 < 90) O exemplo a seguir gera os mesmos resultados que o exemplo da Linha 1, mas com um tempo decorrido diferente: Line 2 SELECT * FROM TEST.VSAM1.TAB WHERE (KEY1 > 50 AND KEY1 < 90) A linha 2 é convertida para: (KEY1 > LOW-VALUES AND KEY1 < HIGH-HALUES) Esse formato ainda é tecnicamente otimizado, mas, quando o arquivo é processado, o início da leitura é posicionado em LOW-VALUES e lê até HIGH-VALUES, o que não é ideal. A linha 2 é a sintaxe preferida. Essa sintaxe posiciona o arquivo no registro 50 e lê dados até KEY1 ser maior ou igual a 90. A otimização é usada para o posicionamento de chaves, os dados são selecionados em relação à cláusula WHERE para verificar se os registros corretos são filtrados. Nota: Se você especificar um valor maior que 0 na caixa Ignorar Primeiros Registros do Arquivo na caixa de diálogo Método de Acesso KSDS, a instrução SELECT não será otimizada mesmo que você especifique KEY1. Obtendo o RRN ou RBA para Registros do Conjunto de Dados VSAM Você pode obter o Relative Record Number (RRN) ou o Relative Byte Address (RBA) para VSAM Entry- Sequenced Data Sets (ESDSs) e Relative Record Data Sets (RRDSs). Retorne o RRN ou o RBA das maneiras a seguir: Registros do prefixo com o valor RRN ou XRBA quando você selecionar essas opções nas propriedades do mapa de dados. Inclua o valor RRN ou RBA em um novo campo no registro quando você usar a função GetDatabasekey em uma expressão. Mapas de Dados VSAM 119

137 Nota: Se você solicitar o processamento de descarregamento, você não pode usar a função GetDatabaseKey em uma expressão. Definindo propriedades do mapa de dados para obter o RRN ou RBA em um Registro do Conjunto de Dados VSAM Você pode definir propriedades do mapa de dados para obter o Relative Record Number (RRN) ou o Relative Byte Address (RBA) para conjuntos de dados VSAM. 1. Abra o mapa de dados. 2. Clique com o botão direito do mouse no mapa de dados e clique em Propriedades. 3. Na guia Método de Acesso na caixa de diálogo Propriedades do Mapa de Dados, selecione uma das opções a seguir: Para obter o RBA para conjuntos de dados ESDS, selecione Registro do prefixo com XRBA. Para obter o RRN para conjuntos de dados RRDS, selecione Registro do prefixo com RRN. Nota: Se você solicitar que o PowerExchange retorne o valor RRN ou RBA, você deverá adicionar um campo binário de 8 bytes no início da definição do registro para conter esse valor. 4. Abra o registro. 5. Na janela Registro, clique com o botão direito do mouse no primeiro campo no registro e clique em Adicionar Campo Antes. 6. Digite um valor para Nome do Campo. Selecione BIN para o Tipo de Campo e 8 para o campo Tamanho. 7. Clique em OK. 8. Abra a tabela. 9. Na janela Tabela, clique com o botão direito do mouse na primeira coluna na tabela e clique em Adicionar Coluna Antes. 10. No campo Nome, digite um nome para a nova coluna. 11. Na lista Campo Base, selecione o novo campo. 12. Para enviar o mapa de dados para o sistema z/os no qual reside o conjunto de dados VSAM, clique em Arquivo > Enviar para Nó Remoto. Usando a função GetDatabaseKey para obter o RRN ou RBA em registros do conjunto de dados VSAM Use a função GetDatabaseKey em uma expressão para obter o Relative Record Number (RRN) ou o Relative Byte Address (RBA) para conjuntos de dados VSAM. Nota: Se você usar o processamento de descarregamento, você não pode usar a função GetDatabaseKey em uma expressão. Defina expressões na definição do registro no mapa de dados. Adicione campos definidos pelo usuário ao registro para conter os resultados da expressão. 1. Abra o mapa de dados e o registro. 2. Na guia Expr(n), clique com o botão direito do mouse na janela e clique em Adicionar Campo no Fim. 3. Na coluna Nome, digite um nome. 4. Na coluna Tipo, digite BIN. 5. Na coluna Tamanho, digite Capítulo 3: Mapas de Dados para Fontes de Dados Específicas

138 6. Na coluna Expressão, digite GetDatabasekey(). Se o campo de expressão for válido, será exibido um ícone de visto em verde. Caso contrário, serão exibidos um ícone de cruz vermelha e uma mensagem. 7. Abra a tabela. 8. Na janela Tabela, clique com o botão direito do mouse no nome da tabela e clique em Adicionar Coluna no Fim. 9. Na lista Campo Base, selecione a nova coluna. 10. No campo Nome, digite um nome para a coluna. 11. Clique em OK. 12. Clique em Arquivo > Enviar para Nó Remoto para enviar o mapa de dados para o sistema z/os no qual reside o conjunto de dados VSAM. Mapas de Dados VSAM 121

139 C A P Í T U L O 4 Copybooks Este capítulo inclui os seguintes tópicos: Visão Geral de Copybooks, 122 Importando um Copybook para um Mapa de Dados, 124 Importando um Copybook para um Registro ou um Segmento, 126 Importando um FDT para um Mapa de Dados Adabas, 128 Exibindo e Atualizando o FDT para um Mapa de Dados Adabas, 128 Importar Copybook - Caixa de Diálogo Detalhes da Fonte, 129 Importar Copybook - Caixa de Diálogo Detalhes do Local, 133 Importar Copybook - Caixa de Diálogo Detalhes do Catálogo do DB2 Local, 134 Importar Copybook - Caixa de Diálogo Detalhes do Remoto, 135 Importar Copybook - Caixa de Diálogo Detalhes Datacom Remoto, 136 Importar Copybook - Caixa de Diálogo Detalhes do Catálogo do DB2 Remoto, 138 Caixa de Diálogo Seleção de Coluna do DB2, 139 Caixa de Diálogo Propriedades Avançadas IDMS, 140 Caixa de Diálogo Importar Copybook - Detalhes de Configuração, 140 Caixas de Diálogo Definição de Registro e Definição de Registro Duplicado, 141 Visão Geral de Copybooks No Navegador do PowerExchange, o termo copybook refere-se, genericamente, a definições de dados para registros, segmentos, campos, chaves e outros itens de uma fonte de dados que você importa para um mapa de dados para definir o layout dos dados. Importe um copybook para eliminar a necessidade de definir manualmente o layout desses itens em um mapa de dados. Você pode importar um copybook quando adicionar um mapa de dados ou após adicioná-lo. Você pode também importar um ou mais copybooks para um registro ou segmento em um mapa de dados para adicionar definições de dados ao registro ou segmento. Depois de importado, um copybook é armazenado no sistema local. Você pode, então, reimportar esse copybook do sistema local. 122

140 Se um copybook contém um registro ou campo que duplica um registro ou campo que já está em um mapa de dados, você pode selecionar opções para indicar como gerenciar o item duplicado. Por exemplo, você pode escolher importar, sobrescrever ou ignorar o item ou interromper a importação. Use exemplos de mapas de dados e copybooks na pasta de exemplos no diretório de instalação do PowerExchange para aprender como importar os seguintes tipos de copybooks para mapas de dados: Copybook COBOL Copybook COBOL com instruções REDEFINES Copybook PL/I com várias definições para um campo TÓPICOS RELACIONADOS: Importando um Copybook COBOL para um Mapa de Dados - Exemplo na página 236 Importando um Copybook COBOL com Instruções REDEFINES - Exemplo na página 240 Importando um Copybook PL/I - Exemplo na página 244 Tipos de Copybook Suportados em Mapas de Dados Você seleciona o tipo de copybook a ser importado na lista Tipo na caixa de diálogo Importar Copybook - Detalhes da Origem. O tipo de copybook que você pode importar depende do tipo da fonte de dados do mapa de dados para o qual está importando o copybook, como a seguir: Mapas de dados para todos os tipos de fonte de dados, exceto DB2. Importe um copybook COBOL ou PL/I do sistema local ou remoto para definir o layout de registros e campos. Mapas de dados Adabas. Você pode importar um FDT e um copybook para um mapa de dados Adabas, como a seguir: - FDT. Cada arquivo de banco de dados possui um FDT correspondente, que define a estrutura de registro e o conteúdo de cada campo no arquivo físico. Para cada campo no registro, o FDT define o nível, nome, tamanho, formato, opções e atributos especiais de campo e descritor. Um FDT apresenta nomes curtos e informações sem escala. Depois que você importa um FDT, ele é armazenado em cache no sistema local para sessões subsequentes. Um FDT pode ser exibido para um mapa de dados Adabas. Ao exibir o FDT, você pode atualizar o FDT salvo no local com dados do FDT no sistema remoto. - ADACMP. Um arquivo criado usando o utilitário ADACMP. - DDM. Um DDM Natural para Adabas para origens z/os. Apresenta nome longo e informações com escala. - DDM OPEN SYS. Um DDM Natural para Adabas para origens UNIX e Windows. - PREDICT. Um dicionário de dados de Previsão. Apresenta nomes longos e informações com escala. - TEXT. Um arquivo de texto que usa um formato delimitado interno da Informatica. - COBOL ou PL/1. Se você importar um copybook COBOL ou PL/I para um mapa de dados Adabas, deverá editar propriedades da tabela no mapa de dados para associar as definições de campo importadas às definições de campo Adabas. Mapas de dados Datacom. Importe um copybook COBOL ou PL/I ou importe um copybook DATACOM de um sistema z/os remoto ou de um arquivo.dcm local. Um copybook DATACOM apresenta informações combinadas do esquema CA Datacom/DB e do copybook COBOL. Mapas de dados IDMS. Importe um copybook COBOL ou PL/I ou importe um copybook IDMS de um sistema z/os remoto ou de um arquivo.idm local. Um copybook IDMS apresenta informações combinadas do esquema CA IDMS/DB e do copybook COBOL. Visão Geral de Copybooks 123

141 Mapas de dados do arquivo de descarregamento do DB2 para i5/os, DB2 para Linux, UNIX e Windows, DB2 para z/os e DB2. Você pode importar um catálogo DB2. Mapas de dados do DB2 para i5/os que são acessados em sequência. Importe um copybook COBOL ou PL/I ou importe especificações de descrição de dados (DDS), que descrevem atributos de dados em descrições de arquivos que são externas ao programa aplicativo que processa os dados. Lote IMS DL/1 e mapas de dados ODBA. Importe um bloco de descrição de banco de dados (DBD) para adicionar segmento, campo chave, campo de pesquisa e definições de campo CCK do banco de dados IMS e para adicionar tabelas ao mapa de dados. A importação de um DBD também define a sequência hierárquica de segmentos. Depois de importar um DBD, importe um copybook COBOL ou PL/I para cada segmento no mapa de dados para sobrepor o segmento com seu COPYLIB. Essa ação redefine o mapa de dados enquanto mantém os metadados hierárquicos para o banco de dados. Importando um Copybook para um Mapa de Dados Importe um copybook quando você adicionar um mapa de dados ou após adicioná-lo. 1. Execute uma das seguintes etapas (uma etapa é para importar um copybook para um mapa de dados existente e a outra, para adicionar um mapa de dados): Para um mapa de dados existente, abra o mapa de dados e clique em Arquivo > Importar Copybook. Se estiver adicionando um mapa de dados, marque a caixa de seleção Importar Definições de Registro na caixa de diálogo Nome. Em seguida, clique em Próximo. Insira informações na caixa de diálogo Método de Acesso e clique em Concluir. A caixa de diálogo Importar Copybook - Detalhes da Fonte é exibida. 2. Na caixa de diálogo Importar Copybook - Detalhes da Fonte, insira informações sobre a localização e o tipo de copybook que deseja importar. Para alguns tipos de copybook, é necessário inserir informações adicionais. Para obter mais informações, consulte Importar Copybook - Caixa de Diálogo Detalhes da Fonte na página 129. Nota: Para um mapa de dados IMS, importe um copybook DBD. Em seguida, importe um copybook COBOL ou PL/I para cada segmento do mapa de dados. 3. Para exibir informações sobre a última operação de importação, clique em Última Importação. A janela Informações de Importação do Copybook exibe as seguintes informações sobre a última operação de importação do copybook: Se o copybook foi importado do sistema local ou de um sistema remoto O nome e o tipo do copybook As ações padrão definidas para registros, campos e tabelas importados Para fechar a caixa de diálogo, clique em Cancelar. 4. Clique em Avançar. 124 Capítulo 4: Copybooks

142 5. Com base em se você especificou uma localização de copybook remota ou local, digite informações sobre o copybook em uma das seguintes caixas de diálogo para o tipo de fonte de dados: Caixa de diálogo Importar Copybook - Detalhes Remotos Para obter mais informações, consulte Importar Copybook - Caixa de Diálogo Detalhes do Remoto na página 135. Caixa de diálogo Importar Copybook - Detalhes Locais Para obter mais informações, consulte Importar Copybook - Caixa de Diálogo Detalhes do Local na página Clique em Avançar. 7. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, selecione opções para definir as ações padrão a serem executadas para registros, campos e tabelas importados. Para obter mais informações, consulte Caixa de Diálogo Importar Copybook - Detalhes de Configuração na página Clique em Concluir. 9. Na janela Informações de Importação do Copybook, consulte as informações para a operação de importação. A janela Informações de Importação do Copybook exibe as seguintes informações: Se o PowerExchange importa o copybook do sistema local ou de um sistema remoto O nome e o tipo do copybook As ações padrão definidas para registros, campos e tabelas importados 10. Clique em OK. 11. Na caixa de diálogo Definição de Registro, selecione uma ação para cada registro ou segmento importado. Se o copybook contiver um registro ou campo que duplique o registro ou campo no mapa de dados, a caixa de diálogo Definição de Registro Duplicado será exibida. Na caixa de diálogo Definição de Registro Duplicado, você pode selecionar opções para indicar como gerenciar o item duplicado. Por exemplo, você pode escolher importar, sobrescrever ou ignorar o item ou interromper a importação. Para obter mais informações, consulte Caixas de Diálogo Definição de Registro e Definição de Registro Duplicado na página Clique em OK. 13. Se o copybook contiver instruções REDEFINES, uma janela Redefinições do Copybook notificará você de que o copybook contém instruções REDEFINES. Execute as seguintes etapas: a. Para apontar para a linha que contém o campo correto, clique em Redefinição > Próximo ou em Redefinição > Anterior. b. Clique em Importar > Retomar. 14. A janela Importação exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. Nota: Se uma mensagem de erro for exibida na janela Log de Mensagens do Copybook, dê um clique duplo na mensagem para localizar a linha associada no copybook. 15. Feche a janela Importação. 16. Se optar por sobrescrever um registro ou um campo duplicado em um mapa de dados, execute as seguintes ações: Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse na tabela que contém colunas baseadas no registro ou campo atualizado e clique em Propriedades. Importando um Copybook para um Mapa de Dados 125

143 Na lista Dependências do Registro na caixa de diálogo Propriedades da Tabela, selecione a tabela. Na lista Geração de Coluna, selecione Atualizar com colunas não encontradas. Execute um teste de linha de banco de dados na tabela. Com base no tipo de fonte de dados para o mapa de dados e no tipo de copybook importado, talvez seja necessário concluir uma das seguintes tarefas: Se tiver importado um copybook COBOL ou PL/I para um mapa de dados Adabas, edite o mapa de dados para associar as definições de campo importadas às definições de campo do Adabas. Para obter informações, consulte Exibindo ou Editando Propriedades para uma Tabela de Mapa de Dados na página 69. Se tiver importado uma fonte DBD para um mapa de dados IMS, importe um copybook COBOL ou PL/I para cada segmento do mapa de dados. Para obter mais informações, consulte Importando um Copybook para um Registro ou um Segmento na página 126. Se você tiver importado um copybook DDM com campos definidos com tipos de dados de caractere largo para um mapa de dados Adabas para z/os, o PowerExchange não selecionará a opção Caractere Largo na guia Página de Códigos da caixa de diálogo Propriedades do Campo. Para definir a opção caractere largo para campos definidos com o tipo de dados de caractere largo, execute uma das seguintes tarefas: Importe um copybook PREDICT ou FDT. Edite propriedades de campo no mapa de dados. TÓPICOS RELACIONADOS: Importar Copybook - Caixa de Diálogo Detalhes do Local na página 133 Importar Copybook - Caixa de Diálogo Detalhes do Catálogo do DB2 Local na página 134 Importar Copybook - Caixa de Diálogo Detalhes do Remoto na página 135 Importar Copybook - Caixa de Diálogo Detalhes Datacom Remoto na página 136 Importar Copybook - Caixa de Diálogo Detalhes do Catálogo do DB2 Remoto na página 138 Importando um Copybook para um Registro ou um Segmento Importe um ou mais copybooks para um registro ou segmento para adicionar definições de dados para o registro ou segmento. Nota: Depois de importar um DBD para um mapa de dados IMS, importe um copybook COBOL para cada segmento no mapa de dados para sobrepor cada segmento com seu COPYLIB. Essa ação redefine o mapa de dados enquanto mantém as informações dos metadados hierárquicos para o banco de dados IMS. 1. Abra o mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, selecione um registro ou um segmento. 3. Clique em Arquivo > Importar Copybook. 4. Na caixa de diálogo Importar Copybook - Detalhes da Fonte, insira informações sobre a localização e o tipo de copybook a ser importado. 126 Capítulo 4: Copybooks

144 Para alguns tipos de copybook, é necessário inserir informações adicionais. Para obter mais informações, consulte Importar Copybook - Caixa de Diálogo Detalhes da Fonte na página 129. Nota: Para um mapa de dados IMS, importe um copybook DBD. Em seguida, importe um copybook COBOL ou PL/I para cada segmento do mapa de dados. 5. Clique em Avançar. 6. Com base em se você especificou uma localização de copybook remota ou local, digite informações sobre o copybook em uma das seguintes caixas de diálogo: Caixa de diálogo Importar Copybook - Detalhes Remotos Para obter mais informações, consulte Importar Copybook - Caixa de Diálogo Detalhes do Remoto na página 135. Caixa de diálogo Importar Copybook - Detalhes Locais Para obter mais informações, consulte Importar Copybook - Caixa de Diálogo Detalhes do Local na página 133. Nota: Se a segurança estiver habilitada no z/os, digite uma identificação de usuário e uma senha. 7. Clique em Avançar. 8. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, selecione as ações para registros ou segmentos, campos e tabelas importados e clique em Concluir. Para obter mais informações, consulte Caixa de Diálogo Importar Copybook - Detalhes de Configuração na página Na janela Informações de Importação do Copybook, consulte as informações para a operação de importação. A janela Informações de Importação do Copybook exibe as seguintes informações: Se o PowerExchange importa o copybook do sistema local ou de um sistema remoto O nome e o tipo do copybook As ações padrão definidas para registros, campos e tabelas importados 10. Clique em OK. 11. Na caixa de diálogo Definição de Registro, selecione uma ação para cada registro ou segmento importado. Se o copybook contiver um registro ou campo que duplique o registro ou campo no mapa de dados, a caixa de diálogo Definição de Registro Duplicado será exibida. Na caixa de diálogo Definição de Registro Duplicado, você pode selecionar opções para indicar como gerenciar o item duplicado. Por exemplo, você pode escolher importar, sobrescrever ou ignorar o item ou interromper a importação. Para obter mais informações, consulte Caixas de Diálogo Definição de Registro e Definição de Registro Duplicado na página Clique em OK. 13. Se o copybook contiver instruções REDEFINES, uma janela Redefinições do Copybook notificará você de que o copybook contém instruções REDEFINES. Execute as seguintes etapas: a. Para apontar para a linha que contém o campo correto, clique em Redefinição > Próximo ou em Redefinição > Anterior. b. Clique em Importar > Retomar. 14. A janela Importação exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. Nota: Se uma mensagem de erro for exibida na janela Log de Mensagens do Copybook, dê um clique duplo na mensagem para localizar a linha associada no copybook. Importando um Copybook para um Registro ou um Segmento 127

145 15. Feche a janela Importação. 16. Se optar por sobrescrever um registro ou um campo duplicado em um mapa de dados, execute as seguintes ações: Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse na tabela que contém colunas baseadas no registro ou campo atualizado e clique em Propriedades. Na lista Dependências do Registro na caixa de diálogo Propriedades da Tabela, selecione a tabela. Na lista Geração de Coluna, selecione Atualizar com colunas não encontradas. Execute um teste de linha de banco de dados na tabela. TÓPICOS RELACIONADOS: Importar Copybook - Caixa de Diálogo Detalhes da Fonte na página 129 Importar Copybook - Caixa de Diálogo Detalhes do Local na página 133 Importar Copybook - Caixa de Diálogo Detalhes do Remoto na página 135 Importando um FDT para um Mapa de Dados Adabas Você poderá importar um FDT para um mapa de dados Adabas se não tiver importado anteriormente um FDT para o mapa de dados. Quando você importa um FDT para um mapa de dados, importa também chaves Adabas. Para importar um FDT para um mapa de dados Adabas: 1. Abra o mapa de dados. 2. Se o Navegador do PowerExchange não solicitar que você importe um FDT, clique em Recurso > FDT. 3. Na caixa de diálogo Importação do FDT Adabas, digite informações de conexão para o sistema no qual o FDT está localizado. Para obter mais informações, consulte Adicionando um Mapa de Dados na página Clique em OK. Edite propriedades da tabela no mapa de dados para adicionar as chaves importadas à tabela. TÓPICOS RELACIONADOS: Adicionando uma Chave a uma Tabela em um Mapa de Dados Adabas na página 90 Exibindo e Atualizando o FDT para um Mapa de Dados Adabas Você pode exibir o FDT que é salvo localmente para um mapa de dados Adabas no Navegador do PowerExchange. 128 Capítulo 4: Copybooks

146 Quando o FDT é exibido, você pode atualizá-lo com dados do FDT original que está no sistema remoto Adabas. Para exibir e atualizar o FDT para um mapa de dados Adabas: 1. Abra o mapa de dados. 2. Clique em Recurso > FDT. A caixa de diálogo FDT Adabas exibe o FDT. 3. Na caixa de diálogo FDT Adabas, clique em Atualizar FDT. 4. Na caixa de diálogo Importação do FDT Adabas, digite informações de conexão para o sistema do qual você está lendo o FDT. Para obter mais informações, consulte Importando um FDT para um Mapa de Dados Adabas na página Clique em OK. Uma caixa de mensagem exibe o status da operação de atualização. Se a operação de atualização foi bem-sucedida, a cópia do FDT no sistema local é atualizada com dados do arquivo remoto do FDT. Importar Copybook - Caixa de Diálogo Detalhes da Fonte Digite informações sobre o copybook que você está importando para um mapa de dados ou um registro. Fonte Selecione a localização do copybook. A tabela a seguir descreve as opções: Opção Local Remoto Descrição O copybook está localizado no sistema do Navegador do PowerExchange. O copybook está localizado em um sistema remoto. Tipo Selecione o tipo de copybook. O tipo de copybook que você pode importar depende do método de acesso do mapa de dados para o qual está importando o copybook. Por exemplo, você pode importar um tipo de copybook de ADACMP para um mapa de dados definido com o método de acesso ADABAS apenas. Para importar um copybook COBOL ou PL/1, selecione COBOL ou PL/1, respectivamente. Importar Copybook - Caixa de Diálogo Detalhes da Fonte 129

147 A tabela a seguir lista os tipos de mapas de dados, por método de acesso e fonte de dados correspondente, para os quais você pode importar um copybook COBOL ou PL/1: Importar para Mapas de Dados Definidos com Métodos de Acesso ADABAS DATACOM DB2UNLD DL/1 BATCH ESDS IMDS IMS ODBA ISAM KSDS MQSERIES RRDS SEQ TAPE USER Fonte de Dados Correspondente Arquivo Adabas Arquivo CA Datacom/DB Arquivo de descarregamento do DB2 Banco de dados IMS VSAM ESDS Banco de dados CA IDMS/DB Banco de dados IMS acessado por meio de um Ouvinte do PowerExchange Arquivo de dados C-ISAM VSAM KSDS Fila de mensagens IBM MQSeries VSAM RRDS Arquivo simples ou conjunto de dados sequenciais Conjunto de dados de fita Programa de método de acesso do usuário A tabela a seguir descreve as opções de Tipo e lista os tipos de mapas de dados, pelo método de acesso e fonte de dados correspondentes, para os quais você pode importar cada tipo de copybook diferente de um copybook COBOL ou PL/1: Opção Descrição Importar para Mapas de Dados Definidos com Métodos de Acesso Fonte de Dados Correspondente ADACMP Arquivo criado usando o utilitário ADACMP. ADABAS Arquivo Adabas DATACOM Copybook Datacom. Apresenta informações combinadas do esquema CA Datacom/DB e do copybook COBOL. DATACOM Arquivo CA Datacom/DB 130 Capítulo 4: Copybooks

148 Opção Descrição Importar para Mapas de Dados Definidos com Métodos de Acesso Fonte de Dados Correspondente Catálogo DB2 Catálogo do DB2. DB2 Banco de dados DB2 para i5/os, DB2 para Linux, UNIX e Windows ou DB2 para z/os Catálogo DB2 Catálogo do DB2. DB2UNLD Arquivo de descarregamento do DB2 DBD Database description block (DBD). Adiciona definições de segmento, campo de chave, campo de pesquisa e campo CCK do banco de dados IMS e adiciona tabelas ao mapa de dados. Define também a sequência hierárquica de segmentos. 1 DL/1 BATCH Banco de dados IMS DBD Database description block (DBD). Adiciona definições de segmento, campo de chave, campo de pesquisa e campo CCK do banco de dados IMS e adiciona tabelas ao mapa de dados. Define também a sequência hierárquica de segmentos. 1 IMS ODBA Banco de dados IMS acessado por meio de um Ouvinte do PowerExchange DDM Data Definition Module (DDM) Natural. Apresenta nome longo e informações com escala. ADABAS Arquivo Adabas no z/os DDM OPEN SYS DDM Natural. ADABAS Arquivo Adabas em Linux, UNIX ou Windows DDS Data Description Specifications (DDS). Descreve atributos de dados em descrições de arquivos que são externos ao programa aplicativo que processa os dados. SEQ Dados do DB2 para i5/os que são acessados em sequência Importar Copybook - Caixa de Diálogo Detalhes da Fonte 131

149 Opção Descrição Importar para Mapas de Dados Definidos com Métodos de Acesso Fonte de Dados Correspondente FDT Field Definition Table (FDT). Cada arquivo de banco de dados possui um FDT correspondente, que define a estrutura de registro e o conteúdo de cada campo no arquivo físico. Para cada campo no registro, o FDT define o nível, nome, tamanho, formato, opções e atributos especiais de campo e descritor. Um FDT apresenta nomes curtos e informações sem escala. ADABAS Arquivo Adabas IDMS Copybook IDMS. Apresenta informações combinadas do esquema CA IDMS/DB e do copybook COBOL. IMDS Banco de dados CA IDMS/DB PREDICT Dicionário de dados de previsão. Apresenta nome longo e informações com escala. ADABAS Arquivo Adabas no z/os TEXT Arquivo de texto, que é um arquivo de formato delimitado que usa um formato interno da Informatica. ADABAS Arquivo Adabas 1. Quando você importa um DBD, o PowerExchange oferece suporte total a instruções DBD que precediam a introdução do catálogo do IMS no IMS 12. O PowerExchange ignora todos os aprimoramentos do DBD que estão relacionados ao catálogo do IMS. Intervalo da Coluna A tabela a seguir descreve o intervalo inicial e final da coluna para o copybook: Opção Iniciar Término Descrição O número da coluna de início. Os valores válidos vão de 1 a 999. Para o tipo de copybook COBOL, o padrão é 7. Para todos os outros tipos de copybook, o padrão é 1. O número da coluna de término. Os valores válidos vão de 1 a 999. Para os tipos de copybook COBOL e PL/I, o padrão é 72. Para todos os outros tipos de copybook, o padrão é 80. Nota: Você não pode definir um intervalo de coluna para DBDs importados para mapas de dados de lote IMS DL/ Capítulo 4: Copybooks

150 Detalhes do Arquivo FDIC A tabela a seguir descreve os detalhes do arquivo FDIC para tipos de Copybook DDM ou PREDICT: Opção Identificação do Banco de Dados Número do Arquivo Descrição A identificação do banco de dados FDIC. Os valores válidos vão de 1 a O número do arquivo FDIC. Os valores válidos vão de 1 a O padrão é 1. Caminho Natural da Biblioteca do Usuário Para o tipo de copybook DDM OPEN SYS, digite o caminho natural da biblioteca do usuário. Clique no botão Procurar para buscar o caminho. TÓPICOS RELACIONADOS: Importando um Copybook para um Mapa de Dados na página 124 Importar Copybook - Caixa de Diálogo Detalhes do Local Digite informações para o copybook local. Nome do Arquivo Digite o caminho e o nome do arquivo para o copybook ou clique no botão Procurar para buscar o arquivo. Visualizar O padrão é o último copybook importado para o mapa de dados do sistema local. Clique em Visualizar para exibir o copybook. Concatenar Nome do Campo e Descrição Para um DDS, selecione essa opção para concatenar o nome do campo e a descrição DDS. O padrão é limpo. Importar Copybook - Caixa de Diálogo Detalhes do Local 133

151 TÓPICOS RELACIONADOS: Importando um Copybook para um Mapa de Dados na página 124 Importar Copybook - Caixa de Diálogo Detalhes do Catálogo do DB2 Local Digite informações para o catálogo do DB2 local. Instância DB Digite o nome da instância do banco de dados DB2. Localização Selecione Local da localização do catálogo DB2. O catálogo está no sistema no qual o Navegador do PowerExchange é executado. Nome da Tabela Digite o nome da tabela para a qual você está importando um catálogo do DB2 ou clique no botão Procurar para digitar critérios de filtragem para uma tabela. Identificação de Usuário Senha Digite o ID do usuário que tem autoridade para acessar o banco de dados. Insira uma senha para o ID do usuário especificado. Salvar Arquivo Localmente Como Digite o caminho e o nome do arquivo no sistema local no qual uma cópia do catálogo DB2 foi salva ou clique no botão Procurar para procurar um arquivo. Indicador Nulo Para um mapa de dados do arquivo de descarregamento do DB2, digite o valor hexadecimal do indicador nulo usado no arquivo de descarregamento. Preencher Variável Para um mapa de dados do arquivo de descarregamento do DB2, selecione essa opção se as variáveis no arquivo de descarregamento forem preenchidas. Nota: Essa opção corresponde a BMC UNLOAD PLUS FIXEDVARCHAR. Visualizar/Corrigir Colunas Exibe a caixa de diálogo Seleção de Coluna do DB2, que permite a você exibir ou selecionar as colunas na tabela que será acessada. TÓPICOS RELACIONADOS: Importando um Copybook para um Mapa de Dados na página 124 Caixa de Diálogo Seleção de Coluna do DB2 na página Capítulo 4: Copybooks

152 Importar Copybook - Caixa de Diálogo Detalhes do Remoto Digite informações para o copybook remoto. Nome do Arquivo Digite o nome completo do arquivo do copybook no sistema remoto. Para um DBD, digite o nome de arquivo de Partitioned Data Set (PDS) e o membro no seguinte formato: HLQ.DTLDEMO(dbdname) Nota: O conjunto de dados do z/os que você importar não deve ser criado no formato compactado usando a opção do pacote no conjunto de dados de perfil. Localização Localização da qual importar o copybook. As opções são: Local. O copybook está localizado no sistema do Navegador do PowerExchange. Remoto. O copybook está localizado em um sistema remoto. Se você selecionar Remoto, a lista Localização inclui as localizações definidas pelas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. Selecione local se o copybook estiver localizado no sistema do Navegador do PowerExchange. Identificação de Usuário Senha Para acessar z/os ou i5/os, digite um ID de usuário do sistema operacional se a instrução SECURITY especificar (1,x) ou (2, x) no membro DBMOVER. Para acessar um copybook em um sistema z/os ou uma especificação de descrição de dados (DDS) no i5/os, digite uma senha para o ID de usuário especificado ou um código de acesso válido do PowerExchange. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Códigos de acesso podem conter os seguintes caracteres: Letras em maiúsculas e minúsculas Os números de 0 a 9 Espaços Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Importar Copybook - Caixa de Diálogo Detalhes do Remoto 135

153 Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Salvar Arquivo Localmente Como Nome Digite o caminho e o nome do arquivo no sistema local no qual uma cópia do copybook é salva ou clique no botão Procurar para buscar um arquivo. Para um DDM, digite o nome DDM. Procura por Nome Visualizar Para um DDM, clique em Navegação por Nome para buscar o DDM. Exibe o copybook. Não disponível para um copybook IDMS. Nome do DB Avançado Para um copybook IDMS, digite o nome de banco de dados IDMS. Para um copybook IDMS, clique em Avançado para digitar informações na caixa de diálogo Propriedades Avançadas IDMS. TÓPICOS RELACIONADOS: Importando um Copybook para um Mapa de Dados na página 124 Caixa de Diálogo Propriedades Avançadas IDMS na página 140 Importar Copybook - Caixa de Diálogo Detalhes Datacom Remoto Digite informações para o copybook Datacom remoto. Nome da tabela (Longo) Digite o nome da tabela. Localização Localização da qual importar o copybook Datacom. As opções são: Local. O copybook está localizado no sistema do Navegador do PowerExchange. Remoto. O copybook está localizado em um sistema remoto. Se você selecionar Remoto, a lista Localização inclui as localizações definidas pelas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. 136 Capítulo 4: Copybooks

154 Identificação de Usuário Senha Para z/os, digite uma Identificação de Usuário do sistema operacional, que será necessária se a segurança estiver ativada. Para z/os, digite uma senha do ID do usuário especificado. Para acessar um subsistema DB2 para z/os, você pode inserir um código de acesso válido do PowerExchange em vez de uma senha. O código de acesso do PowerExchange pode ter 9 a 128 caracteres e pode conter os seguintes caracteres: Letras em maiúsculas e minúsculas Os números de 0 a 9 Espaços Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. Os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: Um código de acesso RACF válido pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Salvar Arquivo Localmente Como Digite o caminho e o nome do arquivo no sistema local no qual uma cópia do copybook é salva ou clique no botão Procurar para buscar um arquivo. Identificação de Usuário do Dicionário Senha Digite a Identificação de Usuário do dicionário Datacom. Digite uma senha para a Identificação de Usuário. Status da Tabela Copybook Chave Somente leitura. Especifica o valor PROD. Selecione essa opção para ativar a seleção de um dos seguintes tipos de copybooks: COBOL PL/1 Por padrão, a opção Copybook é desmarcada e o tipo de copybook padrão é COBOL. Somente leitura. As informações da chave são importadas. O padrão é selecionado. Importar Copybook - Caixa de Diálogo Detalhes Datacom Remoto 137

155 Elementos Somente leitura. As informações do elemento são importadas. O padrão é selecionado. TÓPICOS RELACIONADOS: Importando um Copybook para um Mapa de Dados na página 124 Importar Copybook - Caixa de Diálogo Detalhes do Catálogo do DB2 Remoto Digite informações para o copybook DB2 remoto. Instância DB Insira o nome da instância do banco de dados DB2. Localização Localização da qual importar o catálogo do DB2. As opções são: Local. O catálogo está localizado no sistema do Navegador do PowerExchange. Remoto. O catálogo está localizado em um sistema remoto. Se você selecionar Remoto, a lista Localização inclui as localizações definidas pelas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. Selecione local na lista se o copybook estiver localizado no sistema do Navegador do PowerExchange Nome da Tabela Digite o nome da tabela ou clique no botão Procurar para buscar para digitar critérios de filtragem para uma tabela. Identificação de Usuário Senha Insira o ID do usuário que tem autoridade para acessar o banco de dados. Insira uma senha para o ID do usuário especificado. Para acessar um catálogo do DB2 no z/os, você pode inserir um código de acesso válido do PowerExchange em vez de uma senha. O código de acesso do PowerExchange pode ter 9 a 128 caracteres e pode conter os seguintes caracteres: Letras em maiúsculas e minúsculas Os números de 0 a 9 Espaços Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. 138 Capítulo 4: Copybooks

156 Os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: Um código de acesso RACF válido pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Salvar Arquivo Localmente Como Digite o caminho e o nome do arquivo no sistema local no qual uma cópia do copybook é salva ou clique no botão Procurar para buscar um arquivo. Indicador Nulo Para um mapa de dados do arquivo de descarregamento do DB2, digite o valor hexadecimal do indicador nulo usado no arquivo de descarregamento. Preencher Variável Para um mapa de dados do arquivo de descarregamento do DB2, selecione essa opção se as variáveis estiverem preenchidas no arquivo de descarregamento. Nota: Essa opção corresponde a BMC UNLOAD PLUS FIXEDVARCHAR. Visualizar/Corrigir Colunas Exibe a caixa de diálogo Seleção de Coluna do DB2, que permite a você exibir ou selecionar as colunas na tabela a ser acessada. TÓPICOS RELACIONADOS: Importando um Copybook para um Mapa de Dados na página 124 Caixa de Diálogo Seleção de Coluna do DB2 na página 139 Caixa de Diálogo Seleção de Coluna do DB2 Digite informações para selecionar colunas do DB2 quando você importar um catálogo do DB2. Colunas Disponíveis Selecione ou limpe colunas individuais na tabela selecionada. Selecionar Tudo Clique em Selecionar Tudo para selecionar todas as colunas. Tirar Seleção de Tudo Clique em Tirar Seleção de Tudo para limpar todas as colunas. Caixa de Diálogo Seleção de Coluna do DB2 139

157 TÓPICOS RELACIONADOS: Importando um FDT para um Mapa de Dados Adabas na página 128 Caixa de Diálogo Propriedades Avançadas IDMS Digite informações para o copybook IDMS. Nome do Esquema Digite o nome do esquema de banco de dados IDMS. Versão do Esquema Selecione a versão do esquema de banco de dados IDMS. As opções são: HIGHEST LOWEST Identificação de Usuário do Dicionário Digite a Identificação de Usuário para acessar o esquema ou o subesquema IDMS, se necessário. Senha do Dicionário Digite a senha para a Identificação de Usuário. Nome do Nó Digite o nome do nó DDS do nó que contém o seguinte dicionário: //SYSIDMS Nó do Dicionário Digite o nome do nó que contém o seguinte dicionário para os utilitários IDMSSUBSC ou IDMSCHEM: //SYSIPT Caixa de Diálogo Importar Copybook - Detalhes de Configuração Selecione opções para definir as ações padrão a serem executadas para registros, campos e tabelas importados. A tabela a seguir descreve as opções: Opção Avisar quando da importação de registro Avisar quando da importação de campo Descrição Selecione essa opção para solicitar um nome de registro quando você importar um registro. O padrão é selecionado. Selecione essa opção para solicitar um nome de campo quando você importar um campo. O padrão é limpo. 140 Capítulo 4: Copybooks

158 Opção Avisar quando da criação de tabela Criar tabela para cada registro importado Criar tabelas para caminhos hierárquicos DL1 Atualizar colunas da tabela para registros importados Selecionar primeira redefinição de dados Iniciar importação automaticamente Ação sobre registro duplicado Ação sobre campo duplicado Ação sobre tabela duplicada Descrição Selecione essa opção para solicitar um nome de tabela quando você criar uma tabela. O padrão é limpo. Selecione essa opção para criar uma tabela com base no registro para cada registro importado. O padrão é selecionado. Para um DBD, selecione essa opção para criar todas as tabelas para todos os caminhos hierárquicos DL/1. O padrão é limpo. Para copybooks COBOL ou PL/I importados para um mapa de dados IDMS, lote IMS DL/1 ou IMS ODBA, selecione essa opção para atualizar colunas em tabelas baseadas em registros que são sobrescritos durante a operação de importação do copybook. O padrão é limpo. Selecione essa opção para usar a primeira definição de dados se o PowerExchange localizar uma cláusula REDEFINES. O padrão é limpo. Selecione essa opção para iniciar a importação automaticamente. O padrão é selecionado. Especifica a ação a ser executada se o PowerExchange localizar um registro, campo ou tabela duplicado durante a operação de importação. As opções são: - PROMPT. Solicita a ação a ser executada. - UNIQUE NAME. Importa o registro ou segmento usando um nome exclusivo. - OVERWRITE. Sobrescreve o registro ou segmento. - SKIP. Ignora o registro ou segmento. - APPEND. Anexa o registro ou segmento do copybook ao registro ou segmento no mapa de dados. O padrão é PROMPT. Caixas de Diálogo Definição de Registro e Definição de Registro Duplicado Selecione uma ação para cada registro ou segmento importado. Se o copybook contiver um registro ou um campo que duplique um registro ou um campo no mapa de dados, você poderá selecionar opções para indicar como gerenciar o item duplicado. Por exemplo, você pode escolher importar, sobrescrever ou ignorar o item ou interromper a importação. Caixas de Diálogo Definição de Registro e Definição de Registro Duplicado 141

159 A tabela a seguir lista as opções que você pode selecionar nas caixas de diálogo Definição de Registro e Definição de Registro Duplicado: Opção Importar Nome Ignorar Interromper Importação Gerar Nome Exclusivo Sobrescrever Anexar Procura do Registro Aplicar ao restante da sessão de importação Descrição Selecione essa opção para importar o item. O padrão é selecionado. Digite um nome para o item importado. O padrão é o nome no arquivo do copybook. Selecione essa opção para ignorar a importação do item. O padrão é limpo. Selecione essa opção para interromper a importação. O padrão é limpo. Selecione essa opção para gerar um nome exclusivo para um item duplicado. O padrão é limpo. Selecione essa opção para sobrescrever o item para o qual o PowerExchange localizou um item duplicado. Se você selecionar essa opção, selecione o tipo de item a sobrescrever, que é um dos seguintes: - Somente Campos - Registros O padrão é limpo. Selecione essa opção para anexar o item duplicado do copybook ao item no mapa de dados. O padrão é limpo. Selecione um registro no mapa de dados a procurar. Selecione essa opção para aplicar as opções selecionadas ao restante da sessão de importação. O padrão é limpo. 142 Capítulo 4: Copybooks

160 C A P Í T U L O 5 Grupos de Registro e Registros de Captura Este capítulo inclui os seguintes tópicos: Visão Geral do Grupo de Registro e do Registro de Captura, 143 Nomes da Marca de Registro, 144 Grupos de Registro, Grupos de Extração e Grupos de Aplicativos, 147 Adicionando um Grupo de Registro, 147 Adicionando um Registro de Captura, 150 Exibindo um Registro de Captura, 157 Exibindo ou Editando Propriedades para um Grupo de Registro, 158 Exibindo ou Editando Propriedades para um Registro de Captura, 160 Exibindo Elementos para um Registro de Captura Datacom, 166 Exibindo Caminhos para um Registro de Captura IDMS, 166 Alterando as Colunas em um Registro de Captura, 166 Excluindo um Registro de Captura, 167 Excluindo um Grupo de Registros, 168 Excluindo Todos os Registros de Captura em um Grupo de Registro, 168 Visão Geral do Grupo de Registro e do Registro de Captura Para o PowerExchange capturar mudanças, você deve registrar conjuntos de dados de origem, bancos de dados, segmentos ou tabelas para o Change Data Capture (CDC). Os grupos de registro e os registros de captura definem os dados de origem para os quais você deseja que o PowerExchange capture mudanças e que são necessários para o processamento CDC. Um grupo de registro define a localização e o tipo da fonte de dados, o identificador de coleta e, como opção, a Identificação de Usuário e a senha para acesso aos dados da fonte. Quando você adiciona um grupo de registro, o PowerExchange adiciona um grupo de extração e um grupo de aplicativos com o mesmo nome. 143

161 Um grupo de registro contém um ou mais registros de captura. Um registro de captura especifica uma fonte de dados para a qual capturar mudanças. Um registro de captura também especifica a opção de condensação a usar e o status do registro. O nome do registro de captura é o nome que você especifica quando cria o registro. Quando você adiciona um registro de captura, o PowerExchange adiciona um mapa de extração para esse registro. O PowerExchange atribui um nome de marca de registro ao registro de captura e ao mapa de extração gerado. Se você adicionar manualmente um mapa de extração adicional para um registro de captura, o mapa de extração terá o mesmo nome de marca de registro que em seu registro de captura associado. O formato do nome de marca de registro varia de acordo com o tipo de fonte. Para criar um registro de captura para origens não relacionais como fontes Adabas, IMS e VSAM, você deve primeiro criar um mapa de dados para a fonte. Para origens não relacionais, os mapas de dados apresentam os metadados usados para definir registros de captura e mapas de extração para CDC. O arquivo CCT contém informações para registros de captura definidos no Navegador do PowerExchange. O grupo de registro filtra os registros de captura do arquivo CCT para exibição no Navegador do PowerExchange. Depois de adicionar um registro de captura, você pode alterar algumas de suas propriedades. TÓPICOS RELACIONADOS: Grupos de Registro, Grupos de Extração e Grupos de Aplicativos na página 147 Nomes da Marca de Registro Um nome de marca de registro é um identificador exclusivo que o PowerExchange gera e atribui a uma fonte de dados registrada para CDC. O PowerExchange usa essas marcas de registro para identificar os registros de mudanças de interesse para o processamento CDC. O Agente de Log do PowerExchange para MVS, o Condensador do PowerExchange e Agente de Log do PowerExchange para Linux, UNIX e Windows armazenam um nome de marca de registro com cada registro de mudança em seus arquivos de log ou condensados. Nota: Para fontes de dados do z/os que são processados pelo ECCRs z/os e pelo Agente de Log do PowerExchange para MVS, o nome de marca de registro também é conhecido como EDMNAME. Quando você cria um registro de captura, o PowerExchange atribui o mesmo nome de marca de registro ao registro de captura e ao mapeamento de extração correspondente gerado pelo PowerExchange. Quando você adiciona manualmente outro mapeamento de extração ao registro de captura, esse mapa de extração adicional tem o mesmo nome de marca de registro. O formato do nome de marca de registro varia de acordo com o tipo de fonte. A lista a seguir descreve o formato do nome de marca de registro para cada tipo de fonte: Adabas ADAinstanceDBIDnnnnnFILEIDnnnnn Este formato do nome de marca de registro é composto dos seguintes valores: ADAinstance. O identificador de coleta que você especificou quando criou o grupo de registro. DBIDnnnnn. O número do ID de banco de dados (DBID) Adabas. FILEIDnnnnn. O número do arquivo Adabas. 144 Capítulo 5: Grupos de Registro e Registros de Captura

162 CA Datacom/DB síncrono ou baseado em tabela DCMmuf_nameDBIDdatabase_IDSTNshort_table_nameVreg_version Este formato do nome de marca de registro é composto dos seguintes valores: DCMmuf_name. O nome do MUF do Datacom que você especificou quando criou o grupo de registro. DBIDdatabase_ID. O ID de banco de dados Datacom. STNshort_table_name. O formato curto com três caracteres do nome de tabela que o PowerExchange exibe no campo Nome Curto da Tabela da caixa de diálogo Propriedades do Registro referente à tabela do Datacom. Vreg_version. Um número de versão de registro gerado pelo PowerExchange. Exemplo: DCMR11G4DBID00800STNTB1V1 DB2 para Linux, UNIX e Windows UDBdatabase_namereg_namen Este formato do nome de marca de registro é composto dos seguintes valores: UDBdatabase_name. O nome do banco de dados DB2 para Linux, UNIX e Windows que você especificou quando criou o grupo de registro. reg_name. O nome de registro especificado para o registro de captura. n. Um número de versão. DB2 para z/os DB2instancereg_namen Este formato do nome de marca de registro é composto dos seguintes valores: DB2instance. A instância de banco de dados DB2 para z/os que você especificou quando criou o grupo de registro. reg_name. O nome de registro especificado para o registro de captura. n. Um número de versão. DB2 para i5/os AS4instancereg_namen Este formato do nome de marca de registro é composto dos seguintes valores: AS4instance. O identificador de coleta que você especificou quando criou o grupo de registro. reg_name. O nome de registro especificado para o registro de captura. n. Um número de versão. Baseado em log IDMS IDLlogsidreg_namen Este formato do nome de marca de registro é composto dos seguintes valores: IDLlogsid. O valor Logsid que você especificou quando criou o grupo de registro. reg_name. O nome de registro especificado para o registro de captura. n. Um número de versão. Baseado em log IMS IMLrecon_idreg_name Nomes da Marca de Registro 145

163 Este formato do nome de marca de registro é composto dos seguintes valores: IML recon_id. O valor do identificador RECON do IMS que você especificou quando criou o grupo de registro. reg_name. O nome de registro especificado para o registro de captura Um número de versão estático IMS síncrono IMS.database_name.segment_name Este formato do nome de marca de registro é composto dos seguintes valores: IMS.database_name. O nome do banco de dados IMS que você especificou quando criou o mapa de dados. segment_name. O nome do segmento do IMS. Microsoft SQL Server Oracle VSAM MSSinstancereg_namen Este formato do nome de marca de registro é composto dos seguintes valores: MSSinstance. Um valor de instância gerado a partir do nome de banco de dados do Microsoft SQL Server que você especificou quando criou o grupo de registro. reg_name. O nome de registro especificado para o registro de captura. n. Um número de versão. ORAinstancereg_namen Este formato do nome de marca de registro é composto dos seguintes valores: ORAinstance. O identificador de coleta que você especificou quando criou o grupo de registro. reg_name. O nome de registro atribuído ao registro de captura. n. Um número de versão. O nome de marca de registro que foi atribuído a um conjunto de dados VSAM depende do tamanho do nome do conjunto de dados VSAM no mapa de dados. Se o nome do conjunto de dados VSAM for menor ou igual a 28 caracteres de extensão, o nome de marca de registro terá o seguinte formato: VSAMdataset_name Por exemplo, o nome do conjunto de dados de USERID1.VSAM.EDMSRCV.MAKEITA tem 28 caracteres. Para este conjunto de dados, o PowerExchange gera o seguinte nome de marca de registro: VSAMUSERID1.VSAM.EDMSRCV.MAKEITA Se o nome do conjunto de dados VSAM tiver tamanho igual ou maior que 29 caracteres, o PowerExchange truncará o nome do conjunto de dados para 23 caracteres e anexará um valor numérico em ordem crescente, nnnnn, para criar o nome da marca de registro. O nome de marca de registro tem o seguinte formato: VSAMdataset_namennnnn 146 Capítulo 5: Grupos de Registro e Registros de Captura

164 Por exemplo, o nome do conjunto de dados de USERID1.VSAM.EDMSRCV.MAKEITAB tem 29 caracteres. Para este conjunto de dados, o PowerExchange gera o seguinte nome de marca de registro: VSAMUSERID1.VSAM.EDMSRCV.MA00001 Se você tiver nomes de conjunto de dados subsequentes que têm mais de 28 caracteres e têm os mesmos primeiros 23 caracteres que um nome do conjunto de dados anterior com mais de 28 caracteres, o Navegador do PowerExchange anexado incrementará o valor numérico nnnnn em 1: VSAMUSERID1.VSAM.EDMSRCV.MAnnnnn+1 Por exemplo, se o nome do conjunto de dados for USERID1.VSAM.EDMSRCV.MAKEITAV, o PowerExchange gerará o seguinte nome de marca de registro: VSAMUSERID1.VSAM.EDMSRCV.MA00002 Grupos de Registro, Grupos de Extração e Grupos de Aplicativos Antes de poder adicionar registros de captura, você deve adicionar um grupo de registro. Um grupo define a localização e o tipo da fonte de dados, o identificador de coleta e, como opção, a Identificação de Usuário e a senha para acesso aos dados de origem. Quando você adiciona um grupo de registro, o PowerExchange adiciona um grupo de extração e um grupo de aplicativos com o mesmo nome. Você pode também adicionar manualmente um grupo de extração ou um grupo de aplicativos. O PowerExchange armazena informações do grupo de registro, do grupo de extração e do grupo de aplicativos no sistema Windows em que os grupos são adicionados. Os grupos são exclusivos para esse sistema. Quando você exclui um grupo de registro, grupo de extração ou grupo de aplicativos, o PowerExchange exclui informações do grupo local no sistema do Navegador do PowerExchange. O PowerExchange não exclui os registros de captura, mapas de extração ou aplicativos no grupo excluído. Além disso, quando você exclui um grupo de aplicativos ou grupo de extração gerado pelo PowerExchange, o PowerExchange não exclui o grupo de registro que gerou a criação desse grupo de aplicativos ou grupo de extração. Se você adicionar outro grupo com as mesmas propriedades que um grupo excluído, o novo grupo conterá os registros de captura, os mapas de extração ou os aplicativos existentes para o grupo excluído. TÓPICOS RELACIONADOS: Adicionando um Grupo de Registro na página 147 Adicionando um Grupo de Aplicativos na página 310 Adicionando um Grupo de Extração na página 173 Adicionando um Grupo de Registro Um grupo de registro é um grupo nomeado de registros de captura do mesmo tipo e instância da origem. Grupos de Registro, Grupos de Extração e Grupos de Aplicativos 147

165 Adicione um grupo de registro antes de incluir registros de captura. É possível adicionar registros de captura imediatamente depois de definir o grupo de registro ou posterior. 1. Na guia Recursos no Explorador de Recursos, clique em Adicionar > Grupo de Registro. 2. Na caixa de diálogo Adicionar Grupo de Registro, digite as seguintes informações: Nome Nome definido pelo usuário para o grupo de registro. O tamanho máximo é de 16 caracteres. Localização Tipo A localização da origem da qual você deseja capturar alterações. Selecione local se a origem estiver no sistema do Navegador do PowerExchange. Este campo lista os locais que são definidos nas instruções NODE no arquivo de configuração dbmover no sistema do Navegador do PowerExchange. O padrão é local. Nota: Para obter uma origem do Microsoft SQL Server remoto, especifique o nome do servidor. Não use um alias local para identificar o servidor. O PowerExchange não suporta o uso de aliases locais ao se conectar a um servidor remoto e ao criar publicações do SQL Server durante a criação do registro. Tipo de fonte de dados. Selecione um tipo de fonte de dados e insira as informações associadas: ADABAS. Arquivos Adabas. Na caixa Identificador de Coleta, digite o nome da instância. AS4. Tabelas do DB2 para i5/os. Na caixa Identificador de Coleta, digite o nome da instância especificado no parâmetro INST da instrução AS4J CAPI_CONNECTION no membro DBMOVER do arquivo dtllib/cfg no sistema de origem. DATACOM. Tabelas de CA Datacom/DB. Na caixa Nome do MUF, digite o nome do Recurso de Vários Usuários (MUF). DB2. Tabelas do DB2 para z/os. Na caixa Instância de Banco de Dados, digite o ID de subsistema do DB2 ou o nome do grupo de compartilhamento de dados do DB2. DB2UDB. Tabelas do DB2 para Linux, UNIX e Windows. Na caixa Banco de Dados, digite o nome do banco de dados. IDMS. Tabelas IDMS registradas para CDC síncrono do IDMS. Obsoleto. IDMS_L. Tabelas IDMS registradas para CDC baseado em log do IDMS. Na lista Localização do Registro, selecione a localização na qual os registros de captura devem ser armazenados. Na lista Localização do Mapa de Origem, selecione a localização na qual estão os mapas de dados para as tabelas IDMS. Na caixa Logsid, digite o valor especificado no parâmetro LOGSID no arquivo de configuração DBMOVER no sistema de origem. IMS. Bancos de dados IMS. 148 Capítulo 5: Grupos de Registro e Registros de Captura

166 Para o CDC síncrono IMS, digite o ID do subsistema IMS na caixa Identificador de Recon. Para o CDC baseado em log IMS, na caixa Identificador de Recon, digite o valor especificado no parâmetro IMSID no membro de configuração DBMOVER no sistema z/os em que os conjuntos de dados RECON estão localizados. MSSql. Tabelas do Microsoft SQL Server. Na lista Servidor de Banco de Dados, selecione o servidor no qual a origem está localizada. Na lista Nome do Banco de Dados, selecione ou digite o nome do banco de dados. ORACLE. Tabelas Oracle. Na caixa Identificador de Coleta, digite o identificador de instância Oracle especificado na instrução ORACLEID no arquivo de configuração DBMOVER no sistema de origem. VSAM. Conjuntos de dados VSAM ESDS, KSDS, RRDS e VRRDS. Na caixa Identificador de Coleta, digite o nome da instância. Identificação de Usuário Senha Insira um ID do usuário que permita o acesso à fonte. O tipo de ID do usuário depende do tipo de origem e das configurações de segurança do PowerExchange: Se a origem estiver em um sistema i5/os ou z/os e a segurança do PowerExchange estiver ativada, insira um ID do usuário do sistema operacional. A segurança do PowerExchange é habilitada quando a instrução SECURITY do PowerExchange no membro DBMOVER está definida como (1,x) ou 2.x). Para uma origem DB2 para Linux, UNIX e Windows, Microsoft SQL Server ou Oracle, digite um ID do usuário de banco de dados válido, se necessário. Para obter mais informações, consulte a Instrução SECURITY no Manual de Referência do PowerExchange. Uma senha do ID do usuário especificado. Se a origem estiver em um sistema i5/os ou z/os, você poderá inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Um código de acesso pode conter os seguintes caracteres: Letras em maiúsculas e minúsculas Os números de 0 a 9 Espaços Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Adicionando um Grupo de Registro 149

167 Se você especificar um ID do usuário, mas omitir a senha ou código de acesso, ao abrir o grupo de registro, o Navegador do PowerExchange solicitará uma senha na caixa de diálogo Senha Faltando. Adicionar Registro Adiciona registros de captura ao grupo. Limpe essa opção para adicionar apenas o grupo de registro. Por padrão, essa opção é selecionada. 3. Execute uma das ações a seguir: Se você selecionou a opção Adicionar Registro, clique em Avançar e continue com Adicionando um Registro de Captura na página 150 no procedimento Adicionar um registro de captura. Se você limpou a opção Adicionar Registro, clique em Concluir. A guia Grupo de Registro no Inspetor de Recursos exibe as propriedades para o grupo de registro. Além disso, se o Ouvinte do PowerExchange no sistema de origem estiver em execução, a guia Grupo de Registro no Explorador de Recursos exibirá também os registros de captura existentes para a instância da origem associada ao grupo de registro. TÓPICOS RELACIONADOS: Grupos de Registro, Grupos de Extração e Grupos de Aplicativos na página 147 Adicionando um Registro de Captura na página 150 Adicionando um Registro de Captura Um registro de captura define um objeto de origem como um segmento IMS, tabela do DB2 ou conjunto de dados VSAM para o PowerExchange Change capturar o processamento. O PowerExchange armazena os registros de captura no arquivo CCT do sistema de origem. Antes de adicionar um registro de captura, você deve definir o grupo de registro. Dentro de um grupo de registro, você pode adicionar um registro de captura para uma origem específica somente uma vez. O registro de captura fornece metadados do objeto de origem e identifica as colunas das quais você deseja capturar dados alterados. Nota: Não é possível registrar um objeto de origem que tem nomes de coluna com mais de 128 caracteres. 1. Abra um grupo de registro. 2. Na guia Grupo de Registro no Explorador de Recursos, clique com o botão direito do mouse no grupo de registro e clique em Adicionar Registro de Captura. 3. Na caixa de diálogo Adicionar Registro de Captura - Filtro de Nome e de Tabela, digite informações sobre o registro de captura. 150 Capítulo 5: Grupos de Registro e Registros de Captura

168 A tabela a seguir descreve as informações a serem inseridas: Campo Nome Filtro de Tabela Manter Capitalização Caractere de Escape Descrição Obrigatório. Um nome definido pelo usuário para o registro de captura. O nome deve ter de um a oito caracteres alfanuméricos em letras minúsculas e começar com uma letra. Opcional. Dependendo do tipo de origem, insira os critérios de filtro nas seguintes campos: - Para Adabas, digite as informações do filtro nas caixas Esquema e Tabela. O tamanho máximo para ambos os campos é de 128 caracteres. - Para Datacom, insira informações de filtro nas caixas Esquema e Tabela. O tamanho máximo para ambos os campos é de 128 caracteres. - Para todos os tipos de DB2, digite informações de filtro nas caixas Criador/Esquema, DBName/Definidor e Tabela. Para DB2 para i5/os, os tamanhos máximos são: 10 caracteres para o campo Criador/ Esquema campo e 32 caracteres para o campo Tabela Para DB2 para z/os, o tamanho máximo dos campos Criador/Esquema e Tabela é 128 caracteres. - Para IDMS, insira informações de filtro nas caixas Esquema e Tabela. O tamanho máximo de ambos os campos é de 128 caracteres. - Para IMS, insira informações de filtro nas caixas Esquema, MapName e Tabela. No campo MapName, digite um nome de mapa de dados do IMS do PowerExchange. Os tamanhos máximos são: 10 caracteres para os valores Esquema e MapName e 128 caracteres para o valor Tabela. - Para MSSQL, insira informações de filtro nas caixas Proprietário e Tabela. O tamanho máximo para ambos os campos é de 128 caracteres. - Para Oracle, digite informações de filtro nas caixas Esquema e Tabela. O tamanho máximo para ambos os campos é de 128 caracteres. - Para VSAM, insira informações de filtro nas caixas Esquema, MapName e Tabela caixas. Na caixa MapName, digite o nome de um mapa de dados VSAM do PowerExchange. Os tamanhos máximos são: 10 caracteres para os campos Esquema e MapName e 128 caracteres para o campo Tabela. Em qualquer campo de filtro, você pode usar os seguintes caracteres curinga: - Um asterisco (*) para representar um ou mais caracteres. - Um ponto de interrogação (?) para representar um único caractere. Por padrão, o PowerExchange converte o texto digitado nas caixas de filtro na capitalização padrão para a fonte de dados. Por exemplo, no Oracle, letras maiúsculas é o padrão. Um valor de scott ou SCOTT produziria SCOTT. Selecione a opção Manter Capitalização para os campos de filtros para os quais você não deseja que o PowerExchange use a capitalização padrão para a fonte de dados. Digite o caractere de escape a ser usado nas caixas de filtro para delimitar um asterisco (*) ou um ponto de interrogação (?) que é usado um valor literal em vez de um caractere curinga. Por exemplo, se você especificar um caractere de escape ~, um valor de filtro guia* retornará todas as tabelas que tiverem nomes de tabela que começam com guia. Um valor de filtro guia~* retorna a tabela que tem o nome guia*. Nota: Não use um caractere de escape com fontes de dados multibyte habilitadas. 4. Clique em Avançar. A caixa de diálogo Adicionar Registro de Captura - Tabelas e Colunas é exibida. Adicionando um Registro de Captura 151

169 Se você tiver inserido critérios de filtro, a lista Tabelas exibirá as tabelas que correspondem a esses critérios. Caso contrário, a lista Tabelas exibe todas as tabelas. A tabela a seguir descreve as colunas que podem ser exibidas na lista Tabelas, dependendo do tipo de origem: Coluna Nome do Criador Esquema Nome Tabela Tipo Nome do Conjunto de Dados Descrição O nome do criador para a tabela O nome do esquema O nome da tabela O nome da tabela O tipo de objeto, como TABLE O nome do conjunto de dados 5. Na lista Tabelas, clique duas vezes em uma tabela para registrá-la para captura de mudança. Nota: Se a tabela contiver nomes de coluna com mais de 128 caracteres, será emitida uma mensagem de erro e não será possível registrar a tabela. A tabela a seguir descreve as informações que a lista Colunas exibe para cada coluna na tabela selecionada: Campo Selecionar Coluna Nome CCSID PWXCP Página de código Descrição A caixa que você seleciona para registrar uma coluna para a captura de alterações. Uma coluna de índice que é uma chave primária é selecionada por padrão. O nome da coluna. Para uma origem do DB2, o Coded Character Set Identifier (CCSID) relacionado à coluna. Para uma origem do DB2, a representação interna do PowerExchange da página de código. Para uma origem do DB2, a página de código relacionada à coluna. 6. Na lista Colunas, selecione as colunas para as quais deseja que o PowerExchange capture mudanças. Para selecionar colunas individuais, marque a caixa de seleção Selecionar Coluna ao lado de cada uma. Para selecionar todas as colunas, clique na opção Selecionar Todas as Colunas ou na opção Selecionar tudo e notificar alterações. 152 Capítulo 5: Grupos de Registro e Registros de Captura

170 A tabela a seguir descreve as opções para selecionar todas as colunas: Opção Selecionar Todas as Colunas Selecionar tudo e notificar alterações Descrição Disponíveis para os tipos de origem que suportam captura de coluna seletiva. Seleciona todas as colunas na lista Colunas para captura de alterações. Depois que você adiciona o registro, as colunas adicionadas à tabela de origem são ignoradas até o registro de captura ser editado para selecioná-las. Disponível para origens DB2 e Oracle. Se você selecionar essa opção, o PowerExchange irá capturar mudanças para todas as colunas. Qualquer mudança no esquema para a tabela faz com que o CDC do PowerExchange falhe e registre uma mensagem de erro. Para uma origem DB2 para z/os, o ECCR do DB2 termina de forma anormal depois de ler o primeiro registro de mudança para a tabela depois da mudança do esquema. Para uma origem Oracle, o CDC do Oracle falha e registra uma mensagem de erro nas seguintes situações: - Se um registro de mudança para uma tabela registrada para captura contiver uma coluna que você não registrou para captura - Se um registro de mudança não contiver uma coluna que você registrou para captura Para o CDC do Oracle, se uma definição para uma tabela for alterada de forma compatível com o registro de captura do PowerExchange, o CDC do Oracle continuará a capturar mudanças para essa tabela. Por exemplo, se o tamanho de uma coluna de caracteres diminuir, mas o registro de captura não refletir essa mudança, o CDC do Oracle continuará a capturar mudanças para a tabela. De modo inverso, se o tipo de dados de uma coluna for alterado de numérico para caractere sem uma mudança no registro de captura, o CDC do Oracle continuará a capturar mudanças para a tabela até encontrar o primeiro registro de mudança que contém dados não numéricos para a coluna. Quando o CDC do Oracle encontra um registro de mudança contendo dados não numéricos para a coluna, ele falha e registra uma mensagem de erro. Nota: Se você desmarcar a opção Selecionar tudo e notificar alterações, as caixas de seleção que aparecem ao lado das colunas serão desmarcadas. Para selecionar as colunas novamente, você deve marcar as caixas de seleção. Sugestão: Ao selecionar colunas, considere as seguintes práticas recomendadas: Selecione todas as colunas para as quais você deseja capturar dados alterados desde que você possa definir um registro somente uma vez em um grupo de registro para determinada origem. Você pode editar o mapa de extração correspondente para extrair dados para um subconjunto das colunas capturadas. Um símbolo de chave indica que uma coluna é uma coluna de índice usada pelo processamento do Condensador. Se você limpar a caixa de seleção para uma coluna de índice, pode comprometer a exclusividade da linha. 7. Clique em Avançar. 8. Na caixa de diálogo Adicionar Registro de Captura - Tipo, digite informações adicionais sobre o registro de captura. Adicionando um Registro de Captura 153

171 A tabela a seguir descreve as informações a serem inseridas: Campo Tipo de Origem Descrição Status Tudo O status do registro de captura com relação à disponibilidade para o uso de captura de alterações. As opções são: - I para Inativo. O PowerExchange ainda não usa o registro para capturar alterações para a origem. Essa opção é a configuração inicial de status. Você deve configurar manualmente a opção como A para tornar o registro elegível para o uso de captura de alterações. - A para Ativo. O PowerExchange pode usar o registro para capturar alterações para a origem. O padrão é I. Nota: Você pode alterar o status de Inativo para Ativo depois para tornálo elegível para o processamento de captura de alteração. Para obter mais informações sobre as configurações de status, consulte Opções de Status na página 155. Condensar Tudo Se o Condensador do PowerExchange ou o Agente de Log do PowerExchange para Linux, UNIX e Windows for usado e o tipo de processamento do Condensador do PowerExchange no i5/os ou z/os. As opções são: - Nenhum. O PowerExchange não usa o Condensador do PowerExchange ou o Agente de Log do PowerExchange para Linux, UNIX e Windows para processar as alterações para a origem registrada. - Parte. O PowerExchange usa o Condensador do PowerExchange ou o Agente de Log do PowerExchange para processar as alterações para a origem registrada. O Condensador do PowerExchange usa o processamento de condensação parcial. Essa opção mantém a consistência transacional e é recomendada pela Informatica. - Completo. O PowerExchange usa o processamento de condensação completa do Condensador do PowerExchange para origens do i5/os ou z/os, mas algumas limitações se aplicam. Essa opção não mantém a consistência transacional. Você pode alterar a opção de condensação mais tarde sem incrementar o número de versão do registro. Para obter mais informações, consulte Opções de Condensação na página 156. Comentário Tudo Comentários definidos pelo usuário sobre o registro de captura. ID do Banco de Dados Número do Arquivo Nome do Conjunto de Dados Primário Adabas Adabas IMS síncrono O DBID do banco de dados do Adabas que contém o arquivo cujas alterações são capturadas. O número do arquivo do arquivo Adabas no banco de dados identificado pelo campo ID de Banco de Dados. O nome do conjunto de dados do IMS principal para acessar. 154 Capítulo 5: Grupos de Registro e Registros de Captura

172 Campo Suplementar Nome do Grupo de Log Executar DDL agora Tipo de Origem Oracle Oracle Descrição O nome do grupo de logs suplementar que será criado para a origem. O PowerExchange gera DDL para criar grupos de logs suplementares quando você conclui o registro de captura. Você deve definir um grupo de logs suplementar para cada tabela para a qual deseja que o PowerExchange capture dados alterados do Oracle. Esse grupo de logs suplementar deve conter todas as colunas da tabela para as quais os dados alterados devem ser capturados. Para uma origem Oracle, selecione essa opção para executar o DDL para criar um grupo de logs suplementar quando você concluir o registro de captura. Limpe essa opção para executar o DDL mais tarde. Você deve também digitar um valor na caixa Nome do Grupo de Logs Suplementar. Nota: As instruções GRANT no arquivo ORACAPT.SQL para o usuário de captura do Oracle não incluem a autoridade necessária para executar o DDL. 9. Clique em Concluir. 10. Para uma origem Oracle, em Salvar ALTER TABLE SQL na janela de arquivos, digite um nome de arquivo para a SQL na caixa Nome do Arquivo e clique em Salvar. O PowerExchange salva o SQL para o arquivo especificado no sistema local. O Ouvinte do PowerExchange grava o registro de captura para o arquivo CCT no sistema de origem. No Navegador do PowerExchange, o registro de captura é exibido na lista de registros de captura na guia Grupo de Registros no Explorador de Recursos. Além disso, o registro é exibido nas seguintes localizações na interface: A janela Registro de Captura exibe as colunas no registro de captura. A guia Registro de Captura no Inspetor de Recursos exibe as propriedades para o registro de captura. Use as setas para alternar entre as guias Registro de Captura e Grupo de Registros no Inspetor de Recursos. A barra de status exibe informações sobre o grupo de registros aberto e o registro de captura. TÓPICOS RELACIONADOS: Exibindo um Registro de Captura na página 157 Opções de Status na página 155 Opções de Condensação na página 156 Opções de Status A opção Status de registro de captura indica se o registro está disponível para captura de alterações, temporariamente suspenso ou mantidos somente para histórico. Quando você cria um registro de captura, a configuração de Status inicial é Inativo. No Navegador do PowerExchange, você pode alterar o status com limitações. A seguinte transições unidirecionais são permitidas: Inativo > Ativo > Histórico Adicionando um Registro de Captura 155

173 Suspenso > Histórico Use as seguintes descrições para determinar qual opção de status usar: Inativo Ativo Histórico O status de inicial que evita que os dados sejam capturados para a origem antes do destino é materializado. O status que permite que as alterações sejam capturadas para a origem registrada com base no registro de captura. O status que permanentemente desabilita o registro de captura para o uso de captura de alterações, mas mantém o registro de captura para fins de auditoria e histórico. Depois que definir o status de registro como Histórico, você não poderá executar as seguintes ações: Suspenso Use o mesmo nome de registro novamente, a menos que você exclua o registro e crie outro registro com esse nome. Defina o registro como Ativo novamente. Para retomar a captura de alterações para a origem, crie outro registro de captura. O status que é definido depois de executar o comando SUSPEND_REGISTRATION do utilitário PWXUCREG para suspender temporariamente a captura de alterações para a origem registrada. Não é possível selecionar este status do Navegador do PowerExchange. Somente os seguintes tipos de fontes de dados do CDC podem ter esse status: Adabas, tabelas do Datacom, IDMS baseado em log e IMS baseado em log. Enquanto o status está Suspenso, o PowerExchange não captura alterações para a origem registrada. Você pode reativar o registro de uso de captura de alterações emitindo um comando do utilitário PWXUCREG diferente. Nota: Você pode alterar o status de Suspenso de volta para Ativo, emitindo o comando ACTIVATE_REGISTRATION com o utilitário PWXUCREG. Para obter mais informações, consulte o Guia de Utilitários do PowerExchange. Opções de Condensação A opção Condensador em um registro de captura controla se você pode usar o processamento do Condensador do PowerExchange ou do Agente de Log do PowerExchange para Linux, UNIX e Windows para a origem registrada. Para o Condensador do PowerExchange no i5/os ou z/os, a opção também indica o tipo de processamento de condensação. No Navegador do PowerExchange, você pode editar a opção Condensar para um registro de captura existente sem controle de versão do registro. Por exemplo, você pode alternar de Nenhum para Parcial ou Completo para Parcial. As opções Condensar são: Nenhuma O registro de captura não é elegível para uso pelo Condensador do PowerExchange ou pelo Agente de Log do PowerExchange para Linux, UNIX e Windows. 156 Capítulo 5: Grupos de Registro e Registros de Captura

174 Parte O registro de captura é elegível para uso pelo Condensador do PowerExchange ou pelo Agente de Log do PowerExchange para Linux, UNIX e Windows. O Condensador do PowerExchange usa o registro para o processamento de condensação parcial. Com essa opção, somente as alterações em UOWs concluídos com êxito na origem são gravadas em arquivos condensados do Condensador do PowerExchange ou arquivos do Agente de Log do PowerExchange. O PowerExchange grava todas as alterações para colunas de interesse do CDC, não apenas as alterações mais recentes, em ordem cronológica baseada na hora de término do UOW. Essa opção mantém a consistência transacional. A Informatica recomenda que você selecione a opção Parcial, mesmo se você não planejar usar o Condensador do PowerExchange ou o Agente de Log do PowerExchange. Você pode implementar o Condensador do PowerExchange ou o Agente de Log do PowerExchange posteriormente sem ter que atualizar o registro. Completo O registro de captura é elegível para uso pelo Condensador do PowerExchange no i5/os ou z/os para o processamento de condensação total. O Condensador do PowerExchange acumula as alterações em arquivos condensados de chave para por fazer as alterações mais recentes substituirem as anteriores. Essa opção não mantém a consistência transacional. As restrições a seguir aplicam-se ao processamento completo do condensador: Para as origens do Adabas e do CDC baseado em log IDMS, o processamento completo do condensador não está disponível. Para o Condensador do PowerExchange no i5/os, o processamento de condensação total está disponível somente para tabelas que têm chaves primárias e arquivos DDS definidos com uma chave exclusiva. Para o Condensador do PowerExchange no z/os, o processamento completo do condensador está disponível para tabelas ou mapas de dados que especificam colunas chave. Use essa opção somente se a origem tiver uma chave exclusiva. O Condensador do PowerExchange usa a chave exclusiva como parte da chave no arquivo condensado para manter uma única pré e pósimagem. Sugestão: Para poder atualizar uma chave exclusiva ao usar o processamento de condensação completa, você deverá especificar KEY_CHANGE_ALW=Y no arquivo de configuração do Condensador do PowerExchange. Com essa configuração, o Condensador do PowerExchange ignora a chave de atualização e continua o processamento de condensação total. Exibindo um Registro de Captura Você pode exibir as colunas em um registro de captura. 1. Abra o grupo de registro e o registro de captura. Exibindo um Registro de Captura 157

175 A tabela a seguir descreve as informações que a janela Registro de Captura exibe para cada coluna registrada: Campo Nome Nome da Tabela Descrição O nome da coluna. O nome da tabela. Nº da Coluna O número da coluna. Tipo Tamanho Escala Chave CCSID PWXCP Página de códigos Anulável O tipo dos dados. O tamanho do campo. A escala de dados. O valor YES ou NO para indicar se a coluna é uma coluna de chave de índice. Para uma fonte do DB2, o Coded Character Set Identifier (CCSID) para a página de códigos usada para a coluna. Para uma fonte do DB2, a página de códigos do PowerExchange usada para a coluna. Para uma fonte do DB2, a página de códigos usada para a coluna. O valor YES ou NO para indicar se a coluna é anulável. 2. Para ordenar as colunas em ordem alfabética por nome de coluna, clique no título da coluna Nome em uma janela Registro de Captura. Para ordenar a coluna em ordem alfabética reversa, clique no título da coluna Nome novamente. Uma seta pequena é exibida no título da coluna Nome para indicar a ordem de classificação, como a seguir: Uma seta para baixo indica ordem alfabética. Uma seta para cima indica ordem alfabética reversa. Exibindo ou Editando Propriedades para um Grupo de Registro Você pode exibir ou editar propriedades para um grupo de registro. Você pode editar as propriedades para um grupo de registro para alterar seu nome, localização ou a Identificação de Usuário e a senha usadas para acessar a fonte. Você não pode alterar o tipo de banco de dados para um grupo de registro. 1. Abra o grupo de registro. 158 Capítulo 5: Grupos de Registro e Registros de Captura

176 A tabela a seguir descreve as propriedades que a guia Grupo de Registro do Inspetor de Recursos exibe para o grupo de registro, dependendo do tipo de fonte de dados: Propriedade Nome Método de Acesso Localização Identificação de Usuário Senha Descrição Nome definido pelo usuário para o grupo de registro. Somente leitura. Tipo de fonte de dados. Localização da fonte para a qual você deseja capturar mudanças. A localização é um nome de nó em uma instrução NODE do arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. Um ID do usuário que permite o acesso à origem. O tipo de ID do usuário depende do tipo de origem e das configurações de segurança do PowerExchange: - Se a origem estiver em um sistema i5/os ou z/os e a segurança do PowerExchange estiver ativada, insira um ID do usuário do sistema operacional. A segurança do PowerExchange é habilitada quando a instrução SECURITY do PowerExchange no membro DBMOVER está definida como (1,x) ou 2.x). - Para uma origem DB2 para Linux, UNIX e Windows, Microsoft SQL Server ou Oracle, digite um ID do usuário de banco de dados válido, se necessário. Para obter mais informações, consulte a Instrução SECURITY no Manual de Referência do PowerExchange. Uma senha do ID do usuário especificado. Se a fonte de dados estiver em um sistema i5/os ou z/os, você poderá inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Um código de acesso pode conter os seguintes caracteres: - Letras em maiúsculas e minúsculas - Os números de 0 a 9 - Espaços - Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Exibindo ou Editando Propriedades para um Grupo de Registro 159

177 Propriedade Instância Nome do MUF Banco de Dados Nome do DB Reconhecer Identificação SID Oracle Descrição Para uma origem Adabas, DB2 para i5/os, Oracle ou VSAM, o nome da instância é o identificador de coleta que você inseriu ao definir o grupo de registro. Para uma origem DB2 para z/os, o nome da instância é o nome da instância de banco de dados. Para uma origem do Microsoft SQL Server, o nome da instância é um valor gerado que é composto dos primeiros quatro caracteres do nome do banco de dados, seguido por um número crescente, que é iniciado em 000. Para uma fonte CA Datacom/DB, o nome do Recurso de Vários Usuários (MUF). Para uma fonte DB2 para Linux, UNIX e Windows, o nome do banco de dados. Para uma fonte com base em log IDMS, o nome do banco de dados. Em uma fonte IMS, o identificador RECON do banco de dados. Somente leitura. Para uma fonte Oracle, o identificador do sistema (SID) para o banco de dados. 2. Para editar uma propriedade, clique em uma propriedade no Inspetor de Recursos e digite um valor. Depois que você edita uma propriedade, é exibido um quadrado vermelho próximo à propriedade alterada. Sugestão: Para desfazer uma mudança antes de aplicá-la, clique em Redefinir. 3. Para aplicar uma mudança, clique em Aplicar. Se você editar o nome do grupo de registro, será solicitado que você confirme a mudança. Se o novo nome corresponder ao nome de um grupo de registro existente, será solicitado que você sobrescreva o grupo existente. Se você editar a localização, o PowerExchange exibirá uma mensagem de erro se a localização não for válida para a instância. Se você editar a instância, o PowerExchange exibirá uma mensagem de erro se a instância especificada não existir. 4. Clique em Sim para confirmar as alterações. O Inspetor de Recursos atualiza todos os campos que você editou. TÓPICOS RELACIONADOS: Adicionando um Grupo de Registro na página 147 Exibindo ou Editando Propriedades para um Registro de Captura Depois que você registrar uma origem para captura de alterações, poderá editar algumas propriedades de registro de captura. 160 Capítulo 5: Grupos de Registro e Registros de Captura

178 As seguintes propriedades podem ser editadas: Status. Para todos os tipos de origem, você pode alterar a configuração de status para um registro de captura. O Navegador do PowerExchange permite que as seguintes transições de status: Inativo para Ativo, Ativo para Histórico e Suspenso para Histórico. Você deve usar o utilitário PWXUCREG para alterar um status de registro de Ativo para Suspenso e de Suspenso de volta para Ativo. Condensar. Para todos os tipos de origem, você pode alterar a opção de condensação para um registro de captura de Nenhum para Parcial ou de Parcial para Nenhum. Para fontes de dados do i5/os e z/os que têm chaves, você também pode alterar a opção de condensação de Nenhum ou Parcial para Completo ou de Completo ou Nenhum para Parcial. Comentários. Para todos os tipos de origem, você pode adicionar ou editar comentários para o registro de captura. Para uma fonte de dados do DB2, você também pode adicionar ou remover colunas. Se precisar fazer quaisquer outras alterações em um registro de captura, você deverá recriar o registro. Aviso: Editar um registro de captura ativo pode ter vários implicações para o CDC. 1. Abra o grupo de registro. 2. Abra o registro de captura. As tabelas a seguir descrevem as propriedades que a guia Registro de Captura do Inspetor de Recursos exibe, dependendo do tipo de fonte de dados, para o registro de captura. A tabela a seguir descreve as propriedades que a guia Registro de Captura do Inspetor de Recursos exibe para todos os tipos de fonte de dados: Propriedade Nome Tipo Status Descrição Somente leitura. O nome definido pelo usuário para o registro de captura. Somente leitura. O tipo de captura do PowerExchange. As opções são: - Com Base em Log. O PowerExchange captura as alterações dos logs do banco de dados. - Síncrono. O PowerExchange captura mudanças de maneira síncrona. O status do registro de captura com relação à disponibilidade para o uso de captura de alterações. As opções são: - Inativo. O PowerExchange ainda não pode usar o registro para capturar alterações para a origem. Essa opção é o status de configuração inicial ao criar o registro. Você deve configurar manualmente a opção para Ativo para tornar o registro elegível para o uso de captura de alterações. - Ativo. O PowerExchange pode usar o registro para capturar alterações para a origem. - Histórico. O PowerExchange foi interrompido permanentemente usando o registro de captura de alterações. Selecione essa opção se o registro estiver obsoleto e você quiser mantê-lo para fins de auditoria ou excluí-lo. Depois de definir o status como Histórico, você não poderá tornar o registro ativo novamente. - Suspenso. O processamento de captura de alterações do PowerExchange está temporariamente suspenso para a origem registrada. Esse status é definido pelo comando SUSPEND_REGISTRATION do utilitário PWXUCREG e está disponível somente para uma origem CDC de Adabas, de Datacom baseado em tabela, de IDMS baseado em log ou de IMS baseado em log. Você pode alterar esse status para Histórico no Navegador do PowerExchange. No entanto, para alterar o status de volta para Ativo, você deve usar o comando ACTIVATE_REGISTRATION do utilitário PWXUCREG. Para obter mais informações, consulte Opções de Status na página 155. Exibindo ou Editando Propriedades para um Registro de Captura 161

179 Propriedade Suspender Hora Hora Ativa Condensar Versão Capturar Tipo Descrição Somente leitura. O carimbo de data/hora atual do sistema, sem ajustes para hora local, que indica quando o comando SUSPEND_REGISTRATION do utilitário PWXUCREG foi processado para suspender temporariamente o uso do registro de captura de alterações. O formato do carimbo de data/hora é YYYY/MM/DD HH:MM:SS.ssssss, onde ssssss são segundos fracionários. Essa propriedade estará em branco se o registro nunca tiver sido suspenso. Essa propriedade é exibida para origens CDC de Adabas, baseadas em tabelas do Datacom, baseadas em logs do IDMS e baseadas logs do IMS porque o utilitário PWXUCREG é compatível apenas com essas origens. Para origens do CDC síncrono do Datacom, essa propriedade é exibida, mas a suspensão do carimbo de data/hora não é usada no processamento de CDC síncrono. Essa propriedade não é exibida para outros tipos de origem. Para obter mais informações sobre o tempo de suspensão PWXUCREG, consulte Guia de Utilitários do PowerExchange. Somente leitura. O carimbo de data/hora atual do sistema, sem ajustes para hora local, que indica quando o comando ACTIVATE_REGISTRATION do utilitário PWXUCREG foi processado para reativar o registro de uso de captura de alterações. O formato do carimbo de data/hora é YYYY/MM/DD HH:MM:SS.ssssss, onde ssssss são segundos fracionários. Esse campo ficará em branco se o status de registro for definido como Ativo pela primeira vez no Navegador do PowerExchange ou se o registro nunca tiver sido ativado ou reativadas com o utilitário PWXUCREG. Esse campo permanecerá em branco até você emitir um comando SUSPEND_REGISTRATION do utilitário PWXUCREG, seguido por um comando ACTIVATE_REGISTRATION. Essa propriedade é exibida para origens CDC de Adabas, baseadas em tabelas do Datacom, baseadas em logs do IDMS e baseadas logs do IMS porque o utilitário PWXUCREG é compatível apenas com essas origens. Para origens do CDC síncrono do Datacom, esta propriedade é exibida, mas a ativação do carimbo de data/hora não é usada no processamento de CDC síncrono. Essa propriedade não é exibida para outros tipos de origem. Para obter mais informações sobre o tempo de ativação de PWXUCREG, consulte o Guia de Utilitários do PowerExchange. Se o Condensador do PowerExchange ou o Agente de Log do PowerExchange para Linux, UNIX e Windows for usado e o tipo de processamento do Condensador do PowerExchange no i5/os ou z/os. As opções são: - Nenhum. O PowerExchange não usa o Condensador do PowerExchange ou o Agente de Log do PowerExchange para Linux, UNIX e Windows para processar as alterações para a origem registrada. - Parte. O PowerExchange usa o Condensador do PowerExchange ou o Agente de Log do PowerExchange para processar as alterações para a origem registrada. O Condensador do PowerExchange usa o processamento de condensação parcial. Essa opção mantém a consistência transacional e é recomendada pela Informatica. - Completo. O PowerExchange usa o processamento de condensação completa do Condensador do PowerExchange para origens do i5/os ou z/os, mas algumas limitações se aplicam. Essa opção não mantém a consistência transacional. Para obter mais informações, consulte Opções de Condensação na página 156. Somente leitura. O número de versão do registro. Somente leitura. O tipo de fonte de dados. 162 Capítulo 5: Grupos de Registro e Registros de Captura

180 Propriedade Comentários Marca Descrição Comentários definidos pelo usuário sobre o registro de captura. Somente leitura. Um nome de marca de gerada pelo PowerExchange atribuído à fonte registrada e que é usado para identificar os registros de alteração de interesse do CDC. A tabela a seguir descreve as propriedades que a guia Registro de Captura do Inspetor de Recursos exibe para fontes de dados do Adabas: Propriedade ID do Banco de Dados Número do Arquivo Descrição O DBID do banco de dados. O número do arquivo do banco de dados. A tabela a seguir descreve as propriedades que a guia Registro de Captura do Inspetor de Recursos exibe para fontes de dados CA Datacom/DB: Propriedade ID do Banco de Dados Nome Curto da Tabela ID da Tabela Tamanho do Registro Recuperação da Tabela Contagem de Elementos Descrição O ID do banco de dados. O nome curto da tabela. O identificador interno da tabela. O tamanho do registro. Uma opção que indica se os recursos de recuperação de CA DATACOM/DB são usados nessa tabela. Os valores válidos são YES e NO. O número de elementos. A tabela a seguir descreve as propriedades que a guia Registro de Captura do Inspetor de Recursos exibe para fontes de dados DB2 para i5/os: Propriedade Nome do Arquivo Descrição O nome do arquivo. Exibindo ou Editando Propriedades para um Registro de Captura 163

181 A tabela a seguir descreve as propriedades que a guia Registro de Captura do Inspetor de Recursos exibe para fontes de dados baseadas em log IDMS: Propriedade Nome da Área Tipo de SubSchema Nome do DB Registro Base Modo de Localização ID do Registro Base Compactado Presspack Comp Presspack Dctable Variável Grupo de Páginas Raiz Tamanho Mín. da Raiz Tamanho dos Dados Descrição O nome da área IDMS que contém um conjunto de páginas que armazena os registros do banco de dados. O nome do subesquema. Um subesquema oferece um programa de exibição do banco de dados e é usado no tempo de execução. Ele inclui elementos de dados, tipos de registro, tipos de definição, áreas e componentes de registro lógico. Os caracteres válidos são caracteres ASCII e o sinal de libra e de iene. O nome do banco de dados do IDMS. Os caracteres válidos são caracteres ASCII e o sinal de libra e de iene. O nome do registro base do IDMS. Um dos seguintes modos que determinam como um registro é atribuído a uma determinada página na área: - C. Indica o modo CALC. - V. Indica o modo VIA. - D. Indica o modo DIRECT. O identificador de registro base do IDMS. Indica se a compactação IDMS nativa é usada para compactar os registros. Os valores válidos são YES e NO. Indica se a ferramenta de compactação Presspack do IDMS é usada para compactar os registros. Os valores válidos são YES e NO. Se a compactação Presspack for usada, o nome da tabela de características de dados (DCT) que contém informações sobre os dados e que é necessária para compactação e descompressão. Indica se as ocorrências de registro são de tamanho variável. Os valores válidos são YES e NO. O número do grupo de páginas. O número da raiz. Uma raiz é o formato da chave de banco de dados que descreve a estrutura das chaves de banco de dados que identificam registros no banco de dados. O tamanho mínimo da parte da raiz de um registro de tamanho variável na página inicial. O tamanho do componente de Dados de uma ocorrência de registro. O componente de Dados é um conjunto de bytes que representa o valor de registro. 164 Capítulo 5: Grupos de Registro e Registros de Captura

182 Propriedade Tamanho do Prefixo Tamanho da Porção de Controle Descrição O tamanho do componente do Prefixo de uma ocorrência de registro. O prefixo aponta para os registros NEXT, PRIOR e OWNER. O tamanho da porção de controle de um registro incluindo a chave simbólica. A tabela a seguir descreve as propriedades que a guia Registro de Captura do Inspetor de Recursos exibe para Fontes de dados síncrono IMS: Propriedade Nome do Banco de Dados Nome do Conjunto de Dados Primário Descrição Somente leitura. O nome do banco de dados. Somente leitura. O nome do arquivo do conjunto de dados. A tabela a seguir descreve as propriedades que a guia Registro de Captura do Inspetor de Recursos exibe para fontes de dados do Microsoft SQL Server: Propriedade Servidor Nome do Banco de Dados Dist DBName ID do Artigo Descrição O servidor no qual a fonte está localizada. O nome do banco de dados. O nome do banco de dados de distribuição do SQL Server. O ID do artigo do SQL Server. A tabela a seguir descreve as propriedades que a guia Registro de Captura do Inspetor de Recursos exibe para fontes de dados do Oracle: Propriedade Log Suplementar Descrição Somente leitura. O nome do grupo de logs suplementares. A tabela a seguir descreve as propriedades que a guia Registro de Captura do Inspetor de Recursos exibe para fontes de dados do VSAM: Propriedade Nome do Conjunto de Dados Descrição Um nome do conjunto de dados VSAM ESDS, KSDS ou RRDS. 3. Clique na propriedade no Inspetor de Recursos que você deseja editar e, em seguida, altere o valor de propriedade. Depois de editar uma propriedade, um quadrado vermelho é exibido ao lado dela. Sugestão: Para desfazer uma mudança, clique em Redefinir. 4. Para aplicar a alteração, clique em Aplicar. Exibindo ou Editando Propriedades para um Registro de Captura 165

183 TÓPICOS RELACIONADOS: Adicionando um Registro de Captura na página 150 Alterando as Colunas em um Registro de Captura na página 166 Nomes da Marca de Registro na página 144 Opções de Status na página 155 Opções de Condensação na página 156 Exibindo Elementos para um Registro de Captura Datacom Você pode exibir os elementos para a tabela Datacom registrada para a captura de alteração. 1. Abra o grupo de registros e o registro de captura. 2. Na guia Grupo de Registro no Explorador de Recursos, clique com o botão direito do mouse no registro de captura e clique em Exibir Elementos. A janela Registro de Captura - Detalhes de Elementos exibe as seguintes informações para os elementos na tabela registrada: Nome. O nome do elemento. Posição. O deslocamento de posição do elemento desde o início do registro. Tamanho. O tamanho do elemento. Exibindo Caminhos para um Registro de Captura IDMS Você pode exibir caminhos ou a hierarquia pai para um registro base IDMS para uma tabela IDMS registrada para captura de mudança. Para exibir caminhos para um registro de captura IDMS: 1. Abra o grupo de registros e o registro de captura. 2. Na guia Grupo de Registro no Explorador de Recursos, clique com o botão direito do mouse no registro de captura e clique em Exibir Caminhos. A janela Exibir Caminhos exibe a hierarquia pai para o registro base. Alterando as Colunas em um Registro de Captura Para uma fonte de dados DB2, você pode adicionar colunas a um registro de captura e remover colunas dele. 166 Capítulo 5: Grupos de Registro e Registros de Captura

184 Nota: Fazer mudanças em um registro de captura ativo tem implicações específicas. 1. Abra o grupo de registros e o registro de captura. 2. Na guia Grupo de Registros no Explorador de Recursos, clique com o botão direito do mouse no registro de captura e clique em Corrigir Colunas. 3. A caixa de diálogo Registro de Captura - Colunas é exibida. 4. Para uma fonte DB2, você pode concluir uma das seguintes ações: Se a opção Selecionar tudo e notificar mudanças estiver selecionada, limpe essa opção para permitir mudanças nas colunas. Se a opção Selecionar tudo e notificar mudanças estiver limpa, selecione essa opção para capturar mudanças para todas as colunas e ser notificado de qualquer mudança no esquema para a tabela. 5. Para adicionar uma coluna, selecione-a na lista Colunas Disponíveis e clique em Adicionar. 6. Para remover uma coluna, selecione-a na lista Colunas Atuais e clique em Remover. 7. Clique em OK. Excluindo um Registro de Captura Você pode excluir registros de captura que não tem intenção de usar mais. Você pode excluir um registro de captura de cada vez. Quando você exclui um registro de captura, o PowerExchange exclui o registro do arquivo CCT, que está localizado no sistema em que a fonte de dados está localizada. Para capturar novas mudanças para a origem registrada pelo registro excluído, você deve adicionar o registro de captura novamente. O PowerExchange não exclui o mapa de extração associado ao registro de captura excluído. Você deve excluir manualmente o mapa de extração associado, se desejado. Para usar o mapa de extração novamente, você pode adicionar outra vez o registro de captura associado. Para excluir um registro de captura: 1. Se o registro de captura estiver aberto, feche-o. 2. Na guia Grupo de Registros no Explorador de Recursos, selecione o registro de captura e clique no botão Excluir na barra de ferramentas. 3. Na caixa de mensagens que solicita que você confirme a exclusão do registro, clique em Sim. 4. Se o registro estiver ativo, uma segunda caixa de mensagens solicitará que você confirme a exclusão do registro. Clique em Sim para confirmar a exclusão do grupo. Caso contrário, clique em Não para cancelar a exclusão e definir o status para Histórico. O PowerExchange exclui o registro de captura no sistema de origem. Mudanças não são mais capturadas para o registro. Excluindo um Registro de Captura 167

185 TÓPICOS RELACIONADOS: Exibindo ou Editando Propriedades para um Registro de Captura na página 160 Excluindo um Grupo de Registros Quando você exclui um grupo de registros, o PowerExchange exclui informações do grupo local no sistema do Navegador do PowerExchange. O PowerExchange não exclui os registros de captura no grupo. Se você criar outro grupo de registro com as mesmas propriedades que um grupo excluído, o novo grupo conterá os registros de captura existentes para o grupo excluído. Além disso, o PowerExchange não exclui o grupo de extração e o grupo de aplicativos que gerou quando o grupo de registro foi criado. Para excluir um grupo de registro: 1. Se o grupo de registro estiver aberto, feche-o. 2. Na janela Recursos, exclua um ou mais grupos de registro. 3. Na caixa de mensagens que solicita que você confirme a exclusão do grupo ou grupos, clique em Sim. O PowerExchange exclui o grupo ou os grupos de registro. TÓPICOS RELACIONADOS: Excluindo Todos os Registros de Captura em um Grupo de Registro na página 168 Excluindo Todos os Registros de Captura em um Grupo de Registro Para excluir completamente um grupo de registro e seus registros de captura, exclua os registros de captura, os mapas de extração associados e seu grupo de extração e o grupo de registro. Não é possível abrir ou usar um mapa de extração associado a um registro de captura excluído. Você pode editar os mapas de extração para alterar os registros de captura associados a eles. Para excluir todos os registros de captura em um grupo de registro: 1. Exclua cada registro de captura no grupo de registro. 2. Como você não pode abrir ou usar um mapa de extração associado a um registro de captura excluído, conclua uma das ações a seguir: Exclua os mapas de extração e seu grupo de extração. Altere os registros de captura associados aos mapas de extração para registros de captura ativos. 3. Exclua o grupo de registro. TÓPICOS RELACIONADOS: Excluindo um Grupo de Registros na página 168 Excluindo um Registro de Captura na página Capítulo 5: Grupos de Registro e Registros de Captura

186 Alterando o Registro de Captura Associado a um Mapa de Extração na página 181 Excluindo um Mapa de Extração na página 187 Excluindo um Grupo de Extração na página 188 Excluindo Todos os Registros de Captura em um Grupo de Registro 169

187 C A P Í T U L O 6 Grupos de Extração e Mapas de Extração Este capítulo inclui os seguintes tópicos: Visão Geral de Grupos de Extração e Mapas de Extração, 170 Nomes de Mapa de Extração, 171 Adicionando um Grupo de Extração, 173 Adicionando um Mapa de Extração, 175 Exibindo um Mapa de Extração, 178 Adicionando ou Removendo Colunas Indicador de Mudança e Pré-imagem para uma Coluna de Dados, 179 Adicionando ou Removendo Colunas ao/do Processamento de Extração, 180 Alterando o Registro de Captura Associado a um Mapa de Extração, 181 Mesclando um Mapa de Dados com um Mapa de Extração, 182 Exibindo ou Editando Propriedades para um Grupo de Extração, 183 Exibindo Propriedades para um Mapa de Extração, 185 Criando um Mapa de Dados de um Mapa de Extração, 186 Excluindo um Mapa de Extração, 187 Excluindo um Grupo de Extração, 188 Excluindo Todos os Mapas de Extração em um Grupo de Extração, 188 Janela Definição de Extração - Guia Mapas, 189 Janela Definição de Extração - Guia Extensões, 189 Colunas Geradas pelo PowerExchange em Mapas de Extração, 190 Visão Geral de Grupos de Extração e Mapas de Extração Use mapas de extração para extrair dados alterados capturados pelo PowerExchange. Grupos de extração e mapas de extração definem as informações de extração para fontes de dados registradas e são necessários para o processamento CDC. 170

188 Um grupo de extração define a instância do banco de dados, a localização do nó e o tipo da fonte de dados. Quando você cria um grupo de registro, o PowerExchange cria um grupo de extração com o mesmo nome. Você pode também adicionar manualmente um grupo de extração. Um grupo de extração contém um ou mais mapas de extração. Um mapa de extração mapeia uma fonte de dados. Quando você cria um registro de captura, o PowerExchange cria um mapa de extração que inclui as mesmas colunas e nome de marca de registro que no registro de captura. O PowerExchange designa um nome exclusivo ao mapa de extração. É possível também adicionar manualmente mapas de extração adicionais para um registro de captura. Um mapa de extração definido pelo usuário inclui as mesmas colunas e nome de marca de registro que em seu registro de captura associado. O PowerExchange designa um nome exclusivo para um mapa de extração definido pelo usuário que inclui o nome do mapa especificado quando você adicionou o mapa de extração. O arquivo DTLCAMAP, em um sistema z/os, ou o arquivo CAMAPS, em um sistema não z/os, contém informações do mapa de extração definidas no Navegador do PowerExchange. O grupo de extração filtra os dados no arquivo DTLCAMAP ou CAMAPS para exibição no Navegador do PowerExchange. Você pode editar mapas de extração para adicionar colunas Indicador de mudança (CI) e pré-imagem (BI) para colunas de dados e para adicionar colunas ao processamento de extração ou remover colunas dele. Para uma origem DB2, você pode mesclar um mapa de dados com um mapa de extração. O mapa de extração usa o mapa de dados associado para mapear os dados alterados. Para testar um mapa de extração, execute um teste de linha de banco de dados. TÓPICOS RELACIONADOS: Testando um Mapa de Extração na página 206 Nomes da Marca de Registro na página 144 Grupos de Registro, Grupos de Extração e Grupos de Aplicativos na página 147 Nomes de Mapa de Extração O nome de um mapa de extração tem um formato específico. O nome de um mapa de extração tem o seguinte formato: xnninstance.mapname Nos mapas de extração, a sequência de caracteres de variável xnninstance é chamada de esquema. Quando você extrai mudanças usando um mapa de extração, o nome da tabela é anexado ao nome do mapa de extração, como a seguir: xnninstance.mapname_tablename As variáveis no nome do mapa de extração são: x Um caractere que define o tipo de mapa de extração, que pode ser um dos valores a seguir: d. Mapa de extração padrão. u. Mapa de extração definido pelo usuário. Nomes de Mapa de Extração 171

189 nn instance Um valor de um ou dois dígitos que define o tipo de origem, como a seguir: 1. DB2 para z/os. 2. IMS. 3. DB2 para i5/os. 4. Adabas. 5. IDMS síncrono. 6. VSAM. 7. CA Datacom/DB. 8. Oracle. 10. Microsoft SQL Server. B. DB2 para Linux, UNIX e Windows. D. IDMS baseado em log. O valor da instância especificado quando o grupo de registro foi criado. O valor da instância varia de acordo com o tipo de origem. mapname tablename Um dos valores a seguir: Para um mapa de extração padrão, o nome especificado quando o registro de captura foi criado. Para um mapa de extração definido pelo usuário, o nome do mapa especificado quando o mapa de extração foi criado. O nome da tabela da tabela de origem relacional ou do mapa de dados de origem. Nos mapas de extração, a sequência de caracteres de variável xnninstance é chamada de esquema. Quando você abre um grupo de extração, o Navegador do PowerExchange exibe os mapas de extração no grupo como schema.mapname. Quando você extrai mudanças usando um mapa de extração, é usado o nome completo do mapa de extração de schema.mapname_tablename. Por exemplo, quando você executa um teste de linha de banco de dados, o Navegador do PowerExchange gera a seguinte instrução SQL para extrair as mudanças: SELECT * FROM schema.mapname_tablename No teste de linha de banco de dados, todas as colunas são selecionadas por padrão. No entanto, você pode editar a instrução SQL para selecionar colunas específicas de uma das maneiras a seguir: Na caixa de diálogo Teste de Linha de Banco de Dados, edite manualmente a instrução SQL na caixa Instrução SQL para selecionar colunas específicas. Na janela Definição de Extração, selecione colunas específicas e execute um teste de linha de banco de dados. O PowerExchange gera uma instrução SQL na caixa de diálogo Teste de Linha de Banco de Dados que seleciona as colunas especificadas. Nota: Você pode substituir o nome do esquema e o nome do mapa usando os campos Substituição de Nome do Esquema e Substituição de Nome do Mapa no Cliente PowerExchange do PowerCenter (PWXPC). 172 Capítulo 6: Grupos de Extração e Mapas de Extração

190 TÓPICOS RELACIONADOS: Adicionando um Grupo de Registro na página 147 Adicionando um Registro de Captura na página 150 Adicionando um Mapa de Extração na página 175 Adicionando um Grupo de Extração Um grupo de extração é um grupo nomeado de mapas de extração. Um grupo de extração define a instância da fonte de dados, a localização do nó e o tipo da fonte de dados. Quando você adiciona um grupo de registro, o PowerExchange adiciona um grupo de extração com o mesmo nome. Você pode também adicionar manualmente um grupo de extração conforme descrito neste procedimento. Adicione mapas de extração ao grupo de extração quando você definir o grupo ou mais tarde. 1. Na guia Recursos no Explorador de Recursos, clique em Adicionar > Grupo de Extração. 2. Na caixa de diálogo Adicionar Grupo de Extração, digite as seguintes informações: Nome Um nome definido pelo usuário para o grupo de extração. O tamanho máximo é de 16 caracteres. Localização Tipo A localização da origem cujos dados alterados você deseja extrair. Selecione local se a origem estiver no sistema do Navegador do PowerExchange. Esse campo lista as localizações definidas nas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. O padrão é local. Tipo de fonte de dados. Selecione um tipo de fonte de dados e insira as informações associadas, que devem corresponder às informações no grupo de registro correspondente: ADABAS. Arquivos Adabas. Na caixa Identificador de Coleta, digite o nome da instância. AS4. Tabelas do DB2 para i5/os. Na caixa Identificador de Coleta, digite o nome da instância especificado no parâmetro INST da instrução AS4J CAPI_CONNECTION no membro DBMOVER do arquivo dtllib/cfg no sistema de origem. DATACOM. Tabelas CA Datacom/DB registradas para CDC síncrono ou baseado na tabela CA Datacom/DB. Na caixa Nome do MUF, digite o nome do Recurso de Vários Usuários (MUF) de origem. DB2. Tabelas do DB2 para z/os. Na caixa Instância de Banco de Dados, digite o ID de subsistema do DB2 ou o nome do grupo de compartilhamento de dados do DB2. DB2UDB. Tabelas do DB2 para Linux, UNIX e Windows. Adicionando um Grupo de Extração 173

191 Na caixa Banco de Dados, digite o nome do banco de dados. IDMS. Tabelas IDMS registradas para CDC síncrono do IDMS. Obsoleto. IDMS_L. Tabelas IDMS registradas para CDC baseado em log do IDMS. Na lista Localização do Registro, selecione a localização na qual os registros de captura devem ser armazenados. Na lista Localização do Mapa de Origem, selecione a localização na qual estão os mapas de dados para as tabelas IDMS. Na caixa Logsid, digite o valor especificado no parâmetro LOGSID no arquivo de configuração DBMOVER no sistema de origem. IMS. Bancos de dados IMS. Para o CDC síncrono IMS, na caixa Identificador de Recon, digite o ID do subsistema IMS. Para o CDC baseado em log IMS, na caixa Identificador de Recon, digite o valor especificado no parâmetro IMSID no membro de configuração DBMOVER no sistema z/os em que os conjuntos de dados RECON estão localizados. MSSql. Tabelas do Microsoft SQL Server. Na lista Servidor de Banco de Dados, selecione o servidor no qual a origem está localizada. Na lista Nome do Banco de Dados, selecione ou digite o nome do banco de dados. ORACLE. Tabelas Oracle. Na caixa Identificador de Coleta, digite o identificador de instância Oracle especificado na instrução ORACLEID no arquivo de configuração DBMOVER no sistema de origem. VSAM. Conjuntos de dados VSAM ESDS, KSDS, RRDS e VRRDS. Na caixa Identificador de Coleta, digite o nome da instância. Identificação de Usuário Senha Insira um ID do usuário que permita o acesso à fonte. O tipo de ID do usuário depende do tipo de origem e das configurações de segurança do PowerExchange: Se a origem estiver em um sistema i5/os ou z/os e a segurança do PowerExchange estiver ativada, insira um ID do usuário do sistema operacional. A segurança do PowerExchange é habilitada quando a instrução SECURITY do PowerExchange no membro DBMOVER está definida como (1,x) ou 2.x). Para uma origem DB2 para Linux, UNIX e Windows, Microsoft SQL Server ou Oracle, digite um ID do usuário de banco de dados válido, se necessário. Para obter mais informações, consulte a Instrução SECURITY no Manual de Referência do PowerExchange. Uma senha do ID do usuário especificado. Se a origem estiver em um sistema i5/os ou z/os, você poderá inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres. Um código de acesso pode conter os seguintes caracteres: Letras em maiúsculas e minúsculas Os números de 0 a 9 Espaços 174 Capítulo 6: Grupos de Extração e Mapas de Extração

192 Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Se você especificar um ID do usuário, mas omitir a senha, ao abrir o grupo de extração, o Navegador do PowerExchange solicitará uma senha na caixa de diálogo Senha Faltando. Adicionar Definição de Extração Adiciona mapas de extração ao grupo. Limpe essa opção para adicionar apenas o grupo de extração. O padrão é selecionado. 3. Execute uma das ações a seguir: Se você selecionou a opção Adicionar Definição de Extração, clique em Avançar e continue com Adicionando um Mapa de Extração na página 175 no procedimento Adicionar um mapa de extração. Se você limpou a opção Adicionar Definição de Extração, clique em Concluir. A guia Grupo de Extração no Inspetor de Recursos exibe as propriedades para o grupo de extração. Se o Ouvinte do PowerExchange no sistema de origem estiver em execução, a guia Grupo de Extração no Explorador de Recursos exibirá também os mapas de extração existentes para a instância da origem associada ao grupo de extração. TÓPICOS RELACIONADOS: Grupos de Registro, Grupos de Extração e Grupos de Aplicativos na página 147 Adicionando um Mapa de Extração na página 175 Adicionando um Mapa de Extração Você pode adicionar manualmente um mapa de extração a um grupo de extração, se necessário. O PowerExchange gera um mapa de extração quando você define um registro de captura. No entanto, talvez você queira adicionar um mapa de extração adicional para um registro. 1. Abra um grupo de extração. 2. Na guia Grupo de Extração no Explorador de Recursos, clique com o botão direito do mouse no grupo de extração e clique em Adicionar Definição de Extração. Adicionando um Mapa de Extração 175

193 3. Na caixa de diálogo Adicionar Definição de Extração - Nome, digite as seguintes informações: a. No campo Nome do Mapa, digite um nome exclusivo definido pelo usuário para o mapa de extração. O tamanho máximo é de oito caracteres. b. No campo Nome da Tabela, digite um nome definido pelo usuário para a parte da tabela do nome do mapa de extração. O tamanho máximo é de 20 caracteres. O campo Nome do Esquema é somente leitura. Ele exibe o nome que o PowerExchange gera para a parte do esquema do nome do mapa de extração, que tem o seguinte formato: Onde: unninstance u indica que o mapa de extração é definido pelo usuário. nn é um valor de um a dois dígitos que indica o tipo de origem. Por exemplo, 10 representa o Microsoft SQL Server. instance é o valor da instância especificado quando o grupo de registro foi criado, o que varia por tipo de origem. 4. Clique em Avançar. Na caixa de diálogo Adicionar Definição de Extração - Registros de Captura, a lista Registros de Captura Ativos exibe os registros de captura que estão disponíveis para o mapeamento. A seguinte tabela descreve as colunas da lista: Coluna Nome Versão Descrição O nome definido pelo usuário para o registro de captura. O número de versão do registro. 176 Capítulo 6: Grupos de Extração e Mapas de Extração

194 Coluna Condensar Status Descrição Se o Condensador do PowerExchange ou o Agente de Log do PowerExchange para Linux, UNIX e Windows for usado e o tipo de processamento do Condensador do PowerExchange no i5/os ou z/os. As opções são: - Nenhum. O PowerExchange não usa o Condensador do PowerExchange ou o Agente de Log do PowerExchange para Linux, UNIX e Windows para processar as alterações para a origem registrada. - Parte. O PowerExchange usa o Condensador do PowerExchange ou o Agente de Log do PowerExchange para processar as alterações para a origem registrada. O Condensador do PowerExchange usa o processamento de condensação parcial. Essa opção mantém a consistência transacional. - Completo. O PowerExchange usa o processamento de condensação completa do Condensador do PowerExchange para uma origem do i5/os ou z/os, mas algumas limitações se aplicam. Essa opção não mantém a consistência transacional. Para obter mais informações, consulte Opções de Condensação na página 156. O status do registro de captura com relação à disponibilidade para o uso de captura de alterações. As opções são: - I para Inativo. O PowerExchange ainda não pode usar o registro para capturar alterações para a origem. Essa opção é a configuração inicial de status para um novo registro. - A para Ativo. O PowerExchange pode usar o registro para capturar alterações para a origem. - H para Histórico. O PowerExchange foi interrompido permanentemente usando o registro de captura de alterações. O registro está obsoleto, mas é mantido para fins de auditoria. - S para Suspenso. O processamento de captura de alterações do PowerExchange está temporariamente suspenso para a origem registrada. Esse status é definido pelo comando SUSPEND_REGISTRATION do utilitário PWXUCREG e está disponível somente para uma origem CDC de Adabas, de Datacom baseado em tabela, de IDMS baseado em log ou de IMS baseado em log. Para obter mais informações, consulte Opções de Status na página Na lista Registros de Captura Ativos, selecione um registro de captura e clique em Adicionar. O registro de captura selecionado é exibido na lista Registro de Captura Atual. Para alterar sua seleção, clique duas vezes em um registro na lista Registros de Captura Ativos. O registro na lista Registro de Captura Atual é movido para a lista Registros de Captura Ativos e o novo registro é movido para a lista Registro de Captura Atual. Para remover o registro de captura selecionado, selecione-o na lista Registro de Captura Atual e clique em Remover. O registro é movido da lista Registro de Captura Atual para a lista Registros de Captura Ativos. 6. Clique em Avançar. O PowerExchange cria o mapa de extração no arquivo DTLCAMAP em um sistema de origem z/os ou no arquivo CAMAPS em um sistema de origem não z/os. O nome do mapa de extração tem este formato: Onde: schema.mapname schema é o nome do esquema que o PowerExchange gera. mapname é o nome do mapa especificado na Etapa 3. Adicionando um Mapa de Extração 177

195 O novo mapa de extração é exibido na lista de mapas de extração da guia Grupo de Extração no Explorador de Recursos. Além disso, o mapa de extração é exibido nas seguintes localizações na interface: A janela Definição de Extração exibe as colunas no mapa de extração. A guia Definição de Extração no Inspetor de Recursos exibe as propriedades para o mapa de extração. Use as setas para alternar entre as guias Definição de Extração e Grupo de Extração no Inspetor de Recursos. A barra de status exibe informações sobre o grupo de extração aberto e o mapa de extração. TÓPICOS RELACIONADOS: Nomes de Mapa de Extração na página 171 Adicionando um Grupo de Registro na página 147 Opções de Status na página 155 Opções de Condensação na página 156 Exibindo um Mapa de Extração Você pode exibir as colunas em um mapa de extração, incluindo as colunas geradas pelo PowerExchange para o processamento CDC. Para exibir um mapa de extração: 1. Abra o grupo e o mapa de extração. As seguintes guias na janela Definição de Extração exibem as informações do mapa de extração: A guia Mapas exibe os metadados para as colunas para as quais o PowerExchange captura mudanças e as colunas CI ou BI adicionadas. A guia Mapas também exibe os metadados para as colunas geradas pelo PowerExchange se você selecionar exibir essas colunas. A guia Extensões exibe as colunas CI e BI definidas para as colunas do mapa de extração. 2. Para exibir as colunas geradas pelo PowerExchange, clique com o botão direito do mouse em qualquer lugar na guia Mapas e clique em Exibir Colunas Geradas Automaticamente. São exibidos os metadados para as colunas geradas pelo PowerExchange. Para ocultar as colunas geradas pelo PowerExchange, clique com o botão direito do mouse em qualquer lugar na guia Mapas e clique em Ocultar Colunas Geradas Automaticamente. 3. Para ordenar as colunas em qualquer uma das guias em ordem alfabética por tipo de coluna, clique no título de uma coluna em uma janela Definição de Extração. Para ordenar a coluna em ordem alfabética reversa, clique no título da coluna novamente. Uma seta pequena é exibida no título da coluna que indica a ordem de classificação, como a seguir: Uma seta para baixo indica ordem alfabética. Uma seta para cima indica ordem alfabética reversa. TÓPICOS RELACIONADOS: Janela Definição de Extração - Guia Mapas na página 189 Janela Definição de Extração - Guia Extensões na página Capítulo 6: Grupos de Extração e Mapas de Extração

196 Adicionando ou Removendo Colunas Indicador de Mudança e Pré-imagem para uma Coluna de Dados Você pode editar um mapa de extração para uma tabela de fonte para adicionar ou remover as colunas Indicador de Mudança (CI) e Pré-imagem (BI) para uma ou mais colunas de dados na tabela. Essas colunas armazenam as seguintes informações: Uma coluna CI indica se ocorreu um UPDATE na coluna de dados associada. Uma coluna BI contém a pré-imagem para um UPDATE na coluna de dados. O PowerExchange preenche uma coluna CI com um dos seguintes valores quando ocorre uma mudança na coluna de dados associada na fonte: Y. Indica que um UPDATE alterou a coluna de dados. N. Indica que um UPDATE não alterou a coluna de dados. Nulo. Indica que ocorreu um INSERT ou DELETE na coluna de dados. Você pode usar uma coluna CI em um filtro de cláusula SQL WHERE para uma sessão CDC para filtrar os registros de mudança que PWXPC passa para o PowerCenter para o processamento. Uma coluna BI armazena a pré-imagem para um UPDATE de uma coluna de dados. Se seu banco de dados de fonte permite mudanças em chaves primárias, você pode usar os campos BI com uma transformação Customização Chave de Destino Flexível do PowerCenter para acionar atualizações para chaves primárias no destino quando as chaves fonte são alteradas. Para obter mais informações sobre os usos de colunas CI e BI, consulte o guia CDC do PowerExchange para seu sistema operacional. Sugestão: Se você usar o Agente de Log do PowerExchange para Linux, UNIX e Windows e especificar AI para o parâmetro CAPT_IMAGE no arquivo pwxccl.cfg, não adicione colunas BI ou CI. Com a definição AI, o Agente de Log do PowerExchange armazena apenas pós-imagens. Consequentemente, o PowerExchange não pode apresentar pré-imagens ao PWXPC para o processamento de downstream no PowerCenter. Além disso, se você digitar BA para o parâmetro CAPT_IMAGE, o Agente de Log do PowerExchange armazenará pré e pós-imagens para UPDATEs. Quaisquer operações INSERT ou DELETE na fonte resultam em valores Nulos nas colunas CI. Se necessário, você pode editar um mapa de extração para remover colunas CI e BI. No mapa de extração, os campos do indicador são exibidos como DTL CI_column_name e DTL BI_column_name. Para adicionar colunas CI ou BI a uma coluna de dados ou removê-las: 1. Abra o grupo e o mapa de extração. 2. Clique com o botão direito do mouse no mapa de extração e clique em Corrigir Extensões de Indicador de Mudança/Pré-imagem. A caixa de diálogo Definição de Extração - Corrigir Colunas é exibida. A guia Indicadores de Mudança está ativa. 3. Para adicionar colunas CI, na lista Colunas Disponíveis, selecione uma ou mais colunas e clique em Adicionar. As colunas selecionadas são exibidas na lista Colunas Selecionadas. 4. Para adicionar colunas BI, clique na guia Pré-imagens. Na lista Colunas Disponíveis, selecione uma ou mais colunas e clique em Adicionar. As colunas selecionadas são exibidas na lista Colunas Selecionadas. Adicionando ou Removendo Colunas Indicador de Mudança e Pré-imagem para uma Coluna de Dados 179

197 5. Para remover colunas CI ou BI, na lista Colunas Selecionadas, selecione as colunas e clique em Remover. As colunas selecionadas são exibidas na lista Colunas Disponíveis. 6. Clique em OK. Se você adicionou colunas CI ou BI, elas são exibidas nas guias Mapas e Extensões na janela Definição de Extração. 7. Para verificar as mudanças nas colunas, execute um teste de linha de banco de dados no mapa de extração. TÓPICOS RELACIONADOS: Testando um Mapa de Extração na página 206 Adicionando ou Removendo Colunas ao/do Processamento de Extração Você pode editar um mapa de extração para adicionar ou remover colunas ao/do processamento de extração. Depois que você remove colunas, o PowerExchange interrompe a extração de dados alterados para essas colunas. Nota: Adicionar ou remover colunas do processamento de extração não afeta as colunas no registro de captura associado para o qual o PowerExchange captura dados alterados. Você pode também associar as colunas CI ou BI às colunas no mapa de extração para capturar as seguintes informações: Coluna Indicador de mudança (CI). Indica se o conteúdo da coluna foi alterado em um registro de mudança. Coluna Pré-imagem (BI). Contém o conteúdo da coluna de antes da última operação de atualização. O PowerExchange pode salvar as pré-imagens como parte do fluxo de dados alterados. Para adicionar ou remover colunas do processamento de extração: 1. Abra o grupo e o mapa de extração. As seguintes guias na janela Definição de Extração exibem as seguintes informações: A guia Mapas exibe os metadados para as colunas para as quais o PowerExchange captura mudanças e as colunas CI ou BI adicionadas. A guia Mapas também exibe os metadados para as colunas geradas pelo PowerExchange se você selecionar exibir essas colunas. A guia Extensões exibe as colunas CI e BI definidas para as colunas do mapa de extração. 2. Para exibir as colunas geradas pelo PowerExchange, clique com o botão direito do mouse em qualquer lugar na guia Mapas e clique em Exibir Colunas Geradas Automaticamente. 3. Para remover uma coluna do processamento de extração, limpe a caixa de seleção próxima ao nome da coluna. O PowerExchange interrompe a extração de dados alterados para as colunas removidas, mas continua extraindo dados para as colunas selecionadas. 4. Para adicionar uma coluna ao processamento de extração, marque a caixa de seleção próxima ao nome da coluna. 180 Capítulo 6: Grupos de Extração e Mapas de Extração

198 5. Para verificar as mudanças no mapa de extração, execute um teste de linha de banco de dados. TÓPICOS RELACIONADOS: Adicionando ou Removendo Colunas Indicador de Mudança e Pré-imagem para uma Coluna de Dados na página 179 Testando um Mapa de Extração na página 206 Janela Definição de Extração - Guia Mapas na página 189 Janela Definição de Extração - Guia Extensões na página 189 Alterando o Registro de Captura Associado a um Mapa de Extração Você pode editar um mapa de extração para alterar seu registro de captura associado. Você poderá alterar o registro de captura associado a um mapa de extração se uma nova versão do registro de captura tiver sido adicionada. 1. Abra o grupo de extração. 2. Abra o mapa de extração. 3. Clique com o botão direito do mouse no mapa de extração e clique em Corrigir Registros de Captura. A caixa de diálogo Definição de Extração - Corrigir Registros de Captura é exibida. Na guia Corrigir Registro de Captura, a lista Registro de Captura Atual exibe o registro de captura atualmente associado ao mapa de extração e a lista Registro de Captura Disponível exibe os registros disponíveis para seleção. A tabela a seguir descreve as colunas de cada lista: Coluna Nome Versão Descrição O nome definido pelo usuário para o registro de captura. O número de versão do registro. Alterando o Registro de Captura Associado a um Mapa de Extração 181

199 Coluna Condensar Status Descrição Se o Condensador do PowerExchange ou o Agente de Log do PowerExchange para Linux, UNIX e Windows for usado e o tipo de processamento do Condensador do PowerExchange no i5/os ou z/os. As opções são: - Nenhum. O PowerExchange não usa o Condensador do PowerExchange ou o Agente de Log do PowerExchange para Linux, UNIX e Windows para processar as alterações para a origem registrada. - Parte. O PowerExchange usa o Condensador do PowerExchange ou o Agente de Log do PowerExchange para processar as alterações para a origem registrada. O Condensador do PowerExchange usa o processamento de condensação parcial. Essa opção mantém a consistência transacional. - Completo. O PowerExchange usa o processamento de condensação completa do Condensador do PowerExchange para uma origem do i5/os ou z/os, mas algumas limitações se aplicam. Essa opção não mantém a consistência transacional. Para obter mais informações, consulte Opções de Condensação na página 156. O status do registro de captura com relação à disponibilidade para o uso de captura de alterações. As opções são: - Inativo. O PowerExchange ainda não pode usar o registro para capturar alterações para a origem. Essa opção é a configuração inicial de status para um novo registro. - Ativo. O PowerExchange pode usar o registro para capturar alterações para a origem. - Histórico. O PowerExchange foi interrompido permanentemente usando o registro de captura de alterações. O registro está obsoleto, mas é mantido para fins de auditoria. - Suspenso. O processamento de captura de alterações do PowerExchange está temporariamente suspenso para a origem registrada. Esse status é definido pelo comando SUSPEND_REGISTRATION do utilitário PWXUCREG e está disponível somente para uma origem CDC de Adabas, de Datacom baseado em tabela, de IDMS baseado em log ou de IMS baseado em log. Para obter mais informações, consulte Opções de Status na página Na lista Registro de Captura Atual, selecione o registro atual e clique em Remover. 5. Na lista Registros de Captura Disponíveis, selecione o registro associado ao mapa de extração e clique em Adicionar. O registro de captura é exibido na lista Registro de Captura Atual. 6. Clique em OK. 7. Para verificar a mudança, execute um teste de linha de banco de dados em um mapa de extração. TÓPICOS RELACIONADOS: Testando um Mapa de Extração na página 206 Opções de Status na página 155 Opções de Condensação na página 156 Mesclando um Mapa de Dados com um Mapa de Extração Para uma fonte DB2, você pode mesclar um mapa de dados com um mapa de extração. 182 Capítulo 6: Grupos de Extração e Mapas de Extração

200 Por exemplo, se uma tabela de origem contiver colunas nas quais você armazena dados em um formato inconsistente com o tipo de dados da coluna, você poderá criar um mapa de dados para manipular esses dados com expressões do PowerExchange. Se você armazenar dados compactados em uma coluna CHAR, poderá criar um mapa de dados para manipular e preparar esses dados para carregamento para um destino. Você pode, então, mesclar o mapa de dados com um mapa de extração. O mapa de extração usa o mapa de dados associado para mapear os dados alterados. Para mesclar um mapa de extração com um mapa de dados: 1. Abra o grupo e o mapa de extração. 2. Na guia Grupo de Extração no Explorador de Recursos, clique com o botão direito do mouse no mapa de extração e selecione Corrigir Registros de Captura. 3. Na caixa de diálogo Definição de Extração - Corrigir Registros de Captura, selecione Mesclar. 4. Na caixa Nome do Mapa de Dados em Massa, digite o nome de um mapa de dados ou selecione um mapa de dados, como a seguir: Clique no botão Procurar para buscar o arquivo. Na caixa de diálogo Seleção de Mapas de Dados DB2, especifique os critérios de filtragem em Dados de Filtragem do Mapa DB2 para restringir a lista de mapas de dados. Você pode incluir caracteres curinga. Clique em Avançar. Na lista Mapas de Dados Disponíveis, selecione um mapa de dados e clique em Concluir. 5. Clique em OK. O mapa de extração usa o mapa de dados associado para mapear os dados alterados. O mapa de dados mesclado é exibido no campo Mesclado com na guia Definição de Extração do Inspetor de Recursos. TÓPICOS RELACIONADOS: Mapas de Dados do Catálogo do DB2 na página 93 Exibindo ou Editando Propriedades para um Grupo de Extração Você pode exibir ou editar propriedades para um grupo de extração. Você pode editar as propriedades para um grupo de extração para alterar seu nome, localização ou a Identificação de Usuário e a senha usadas para acessar a fonte. Você não pode alterar o tipo de banco de dados para um grupo de extração. 1. Abra o grupo de extração. Exibindo ou Editando Propriedades para um Grupo de Extração 183

201 A tabela a seguir descreve as propriedades que a guia Grupo de Extração do Inspetor de Recursos exibe para o grupo de extração, dependendo do tipo de fonte de dados: Propriedade Nome Método de Acesso Localização Identificação de Usuário Senha Instância Nome do MUF Banco de Dados Descrição Um nome definido pelo usuário para o grupo de extração. Somente leitura. O tipo de fonte de dados. Localização da fonte para a qual você deseja capturar mudanças. Um ID do usuário que permite o acesso à origem. O tipo de ID do usuário depende do tipo de origem e das configurações de segurança do PowerExchange: - Se a origem estiver em um sistema i5/os ou z/os e a segurança do PowerExchange estiver ativada, insira um ID do usuário do sistema operacional. A segurança do PowerExchange é habilitada quando a instrução SECURITY do PowerExchange no membro DBMOVER está definida como (1,x) ou 2.x). - Para uma origem DB2 para Linux, UNIX e Windows, Microsoft SQL Server ou Oracle, digite um ID do usuário de banco de dados válido, se necessário. Para obter mais informações, consulte a Instrução SECURITY no Manual de Referência do PowerExchange. Uma senha do ID do usuário especificado. Se a fonte de dados estiver em um sistema i5/os ou z/os, você poderá inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Um código de acesso pode conter os seguintes caracteres: - Letras em maiúsculas e minúsculas - Os números de 0 a 9 - Espaços - Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Para uma fonte Adabas, DB2 para i5/os, DB2 para z/os, Oracle ou VSAM, a instância do banco de dados. Para uma fonte CA Datacom/DB, o nome do Recurso de Vários Usuários (MUF). Para uma fonte DB2 para Linux, UNIX e Windows, o nome do banco de dados. 184 Capítulo 6: Grupos de Extração e Mapas de Extração

202 Propriedade Nome do DB Reconhecer Identificação SID Oracle Descrição Para uma fonte com base em log IDMS, o nome do banco de dados. Em uma fonte IMS, o identificador RECON do banco de dados. Somente leitura. Para uma fonte Oracle, o identificador do sistema (SID) para o banco de dados. 2. Para editar uma propriedade, clique na caixa da propriedade no Inspetor de Recursos e insira um valor. Depois que você edita uma propriedade, é exibido um quadrado vermelho próximo à propriedade alterada. Sugestão: Para desfazer uma mudança antes de aplicá-la, clique em Redefinir. 3. Para aplicar uma mudança, clique em Aplicar. Se você editar o nome do grupo de extração, será solicitado que você confirme a mudança. Se o novo nome corresponder ao nome de um grupo de extração existente, será solicitado que você sobrescreva o grupo existente. Se você editar a localização, o PowerExchange exibirá uma mensagem de erro se a localização não for válida para a instância. Se você editar a instância, o PowerExchange exibirá uma mensagem de erro se a instância especificada não existir. 4. Clique em Sim para confirmar as alterações. O Inspetor de Recursos atualiza todos os campos que você editou. TÓPICOS RELACIONADOS: Adicionando um Grupo de Extração na página 173 Exibindo Propriedades para um Mapa de Extração Você pode exibir, mas não alterar, as propriedades de um mapa de extração. Para exibir as propriedades para um mapa de extração: u Abra o grupo e o mapa de extração. A tabela a seguir descreve as propriedades que a guia Definição de Extração do Inspetor de Recursos exibe para o mapa de extração: Propriedade Esquema Mapa Descrição O nome do esquema gerado pelo PowerExchange. O nome do mapa gerado pelo PowerExchange. Exibindo Propriedades para um Mapa de Extração 185

203 Propriedade Registro Versão Tabela Mesclado a Etiqueta Descrição O nome do registro de captura associado. O número da versão. A tabela à qual se refere o mapa de extração. Para uma fonte DB2, se o mapa de extração foi mesclado com um mapa de dados, exibe o nome do mapa de dados. O identificador exclusivo que o PowerExchange gera e atribui a uma fonte de dados registrada para captura. TÓPICOS RELACIONADOS: Adicionando um Grupo de Extração na página 173 Nomes da Marca de Registro na página 144 Criando um Mapa de Dados de um Mapa de Extração Você pode criar um mapa de dados do PowerExchange de um mapa de extração. Por exemplo, talvez você queira criar um mapa de dados sequencial com o mesmo layout que uma tabela do DB2 ou uma tabela do Adabas. O PowerExchange armazena o mapa de dados no diretório de configuração de recursos atual no sistema local. Para criar um mapa de dados de um mapa de extração: 1. Abra o grupo e o mapa de extração. 2. Clique com o botão direito do mouse no mapa de extração e clique em Criar Mapa de Dados. 3. Na caixa de diálogo Criar Mapa, digite as seguintes informações: Nome do esquema Digite o nome do esquema, que o PowerExchange usa como a primeira parte do nome do mapa de dados, como a seguir: schema_name.map_name Nome do Mapa Digite o nome do mapa, que o PowerExchange usa como a segunda parte do nome do mapa de dados, como a seguir: schema_name.map_name 186 Capítulo 6: Grupos de Extração e Mapas de Extração

204 Incluir Campos de Controle de Captura Inclui as seguintes colunas geradas pelo PowerExchange no mapa de dados: DTL CAPXtype DTL columnname_bi DTL columnname_ci Limpe essa opção para excluir essas colunas do mapa de dados. O padrão é selecionado. Incluir Campos de Contagem Binária e de Indicadores Nulos Inclui as colunas geradas pelo PowerExchange, DTL columnname_cnt e DTL columnname_ind, no mapa de dados. Limpe essa opção para excluir essas colunas do mapa de dados. O padrão é limpo. 4. Clique em OK. O PowerExchange salva o mapa de dados no diretório de configuração de recursos atual no sistema local. Excluindo um Mapa de Extração Você pode excluir mapas de extração que não tem intenção de usar mais. Depois de excluir um mapa de extração, você não pode mais usá-lo para extrair dados alterados. Você deve atualizar os mapeamentos e as sessões do PowerCenter que fazem referência ao mapa de extração excluído. Quando você exclui um mapa de extração, o PowerExchange não exclui o registro de captura associado ao mapa de extração. Para excluir um mapa de extração: 1. Se o mapa de extração estiver aberto, feche-o. 2. Na guia Grupo de Extração no Explorador de Recursos, selecione o mapa de extração e clique no botão Excluir na barra de ferramentas. 3. Na caixa de mensagens que solicita que você confirme a exclusão do mapa, clique em Sim. O PowerExchange exclui o mapa de extração, mas não exclui o registro de captura associado ao mapa de extração. 4. No PowerCenter, atualize os mapeamentos e as sessões do PowerCenter que fazem referência ao mapa de extração excluído. Excluindo um Mapa de Extração 187

205 TÓPICOS RELACIONADOS: Excluindo um Registro de Captura na página 167 Excluindo um Grupo de Extração Você pode excluir grupos de extração que não tem intenção de usar mais. Quando você exclui um grupo de extração, o PowerExchange exclui informações do grupo local no sistema do Navegador do PowerExchange, mas não exclui os mapas de extração no grupo. Se você criar outro grupo de extração com as mesmas propriedades que um grupo excluído, o novo grupo conterá os mapas de extração existentes para o grupo excluído. O PowerExchange não exclui o grupo de registro para o qual esse grupo de extração foi gerado. Para excluir um grupo de extração: 1. Se o grupo de extração estiver aberto, feche-o. 2. Na janela Recursos, exclua um ou mais grupos de extração. 3. Na caixa de mensagens que solicita que você confirme a exclusão do grupo ou grupos, clique em Sim. O PowerExchange exclui o grupo ou os grupos de extração. Excluindo Todos os Mapas de Extração em um Grupo de Extração Para excluir completamente um grupo de extração e seus mapas de extração, você deve excluir os mapas de extração, os registros de captura associados e seu grupo de registro e o grupo de extração. Para excluir todos os mapas de extração em um grupo de extração: 1. Exclua cada mapa de extração no grupo de extração. 2. Exclua os registros de captura associados e seu grupo de registro. 3. Exclua o grupo de extração. TÓPICOS RELACIONADOS: Excluindo um Mapa de Extração na página 187 Excluindo um Grupo de Extração na página 188 Excluindo um Registro de Captura na página 167 Excluindo um Grupo de Registros na página Capítulo 6: Grupos de Extração e Mapas de Extração

206 Janela Definição de Extração - Guia Mapas A guia Mapas de uma janela Definição de Extração exibe informações para cada coluna em um mapa de extração. A tabela a seguir descreve as informações que a guia Mapas exibe: Coluna Nome ColType Tipo de Dados Precisão Escala Tamanho Descrição O nome da coluna. O tipo da coluna, que é um dos seguintes valores: - Real. Uma coluna original do mapa de extração. - BI. Uma coluna pré-imagem que foi adicionada por meio do comando Corrigir Extensões do Indicador de Mudança/Pré-Imagem. - CI. Uma coluna imagem do indicador de mudança que foi adicionada por meio do comando Corrigir Extensões do Indicador de Mudança/Pré-Imagem. - Automático. Uma coluna gerada pelo PowerExchange. O tipo de dados. A precisão do campo. A escala de dados. O tamanho da coluna. Para colunas de tipos de dados de tamanho variável, os dados podem não ser tão extensos quanto a coluna permite. Janela Definição de Extração - Guia Extensões A guia Extensões de uma janela Definição de Extração exibe informações sobre as extensões de BI e CI para cada coluna em um mapa de extração. A tabela a seguir descreve as informações que a guia Extensões de uma janela Definição de Extração exibe: Coluna Nome Coluna CI Coluna BI Coluna real Descrição O nome da coluna. A coluna Indicador de mudança (CI) associada. A coluna Pré-imagem (BI) associada. A coluna real à qual as extensões CI e BI foram adicionadas. Nota: Se você adicionou uma coluna CI ou BI para uma coluna de dados, as caixas de seleção para as colunas CI e BI estarão desativadas e serão exibidas em cinza. Janela Definição de Extração - Guia Mapas 189

207 TÓPICOS RELACIONADOS: Adicionando ou Removendo Colunas Indicador de Mudança e Pré-imagem para uma Coluna de Dados na página 179 Colunas Geradas pelo PowerExchange em Mapas de Extração Além das colunas de tabela definidas nos registros de captura, os mapas de extração incluem colunas geradas pelo PowerExchange. Essas colunas geradas pelo PowerExchange contêm informações relacionadas ao CDC, como o tipo de alteração e o carimbo de data/hora. Quando você importa um mapa de extração no Designer, o PWXPC inclui as colunas geradas pelo PowerExchange na definição de origem. Quando você executa um teste de linha do banco de dados em um mapa de extração, o Navegador do PowerExchange exibe as colunas geradas pelo PowerExchange nos resultados. Por padrão, o Navegador do PowerExchange oculta a exibição dessas colunas quando você abre o mapa de extração. Para exibir essas colunas, abra o mapa de extração, clique com o botão direito do mouse em qualquer lugar na janela Definição de Extração e selecione Exibir Colunas Geradas Automaticamente. Nota: Por padrão, todas as colunas, exceto DTL columnname_cnt e DTL columnname_ind, são selecionadas em um mapa de extração. Para selecionar essas colunas, edite o mapa de extração. 190 Capítulo 6: Grupos de Extração e Mapas de Extração

208 A tabela a seguir descreve as colunas que o PowerExchange gera para cada registro de alteração: Coluna Descrição Tipo de dados Tamanho DTL CAPXRESTART1 DTL CAPXRESTART2 DTL CAPXROWID Um valor binário que representa a posição do fim do UOW para esse registro de alteração seguido pela posição do próprio registro de alteração. O tamanho de um token de sequência varia de acordo com o tipo de fonte de dados, exceto no z/os, em que os tokens de sequência para todos os tipos de fonte de dados têm o mesmo tamanho. O valor de DTL CAPXRESTART1 é conhecido também como o token de sequência, que, quando combinado com o token de reinicialização, forma o par de tokens de reinicialização. Um token de sequência para um registro de alteração é um valor estritamente crescente e que pode ser repetido. Um valor binário que representa uma posição no fluxo de mudança que pode ser usado para reconstruir o estado do UOW para o registro de alteração, com as seguintes exceções: - CDC do Microsoft SQL Server. Um valor binário que contém o DBID do banco de dados de distribuição e o nome do servidor de distribuição. - Dados alterados extraídos de arquivos condensados completos no z/os ou i5/os. Um valor binário que contém o nome da instância do grupo de registro do registro de captura. O tamanho de um token de reinicialização varia de acordo com o tipo de fonte de dados. No z/os, os tokens de reinicialização para todos os tipos de fonte de dados têm o mesmo tamanho, exceto dados alterados extraídos de arquivos condensados completos. O valor de DTL CAPXRESTART2 é conhecido também como o token de reinicialização, que, quando combinado com o token de sequência, forma o par de tokens de reinicialização. Para o PowerExchange Oracle CDC com LogMiner e o Express CDC para Oracle, oferece o valor rowid físico. O PowerExchange poderá incluir valores de rowid em registros de alteração para tabelas Oracle somente se as tabelas não tiverem a movimentação de linhas habilitada. Para habilitar a captura de valores de rowid, você deve configurar um dos seguintes parâmetros: - Para o PowerExchange Oracle CDC com LogMiner, defina o parâmetro ROWID na instrução ORCL CAPI_CONNECTION como Y ou ALLOW. - Para o PowerExchange Express CDC para Oracle, inclua a instrução OPTIONS ROWID=Y no arquivo de configuração do Express CDC. O rowid é útil para processar linhas em tabelas sem chave durante sessões de extração do CDC. VARBIN 255 VARBIN 255 CHAR 18 Colunas Geradas pelo PowerExchange em Mapas de Extração 191

209 Coluna Descrição Tipo de dados Tamanho DTL CAPXRRN DTL CAPXUOW DTL CAPXUSER Apenas para DB2 no i5/os, o número de registro relativo. Um valor binário que representa a posição no fluxo de mudança do início do UOW para o registro de alteração. A Identificação do Usuário que fez a mudança na fonte de dados, com as seguintes exceções: - Para origens de CDC síncrono Datacom, este valor é o nome do cartão JOB relativo à tarefa que fez a alteração na fonte de dados. - Para origens de CDC baseado em tabela Datacom, este valor é o nome do MUF. - Para origens de DB2 para i5/os, este valor depende do parâmetro LIBASUSER na instrução AS4J CAPI_CONNECTION. Se LIBASUSER=Y, este valor será o nome da biblioteca e o nome do arquivo em que a alteração foi feita. Se LIBASUSER=M, este valor será o nome da biblioteca, o nome do arquivo e o nome do membro de dados do arquivo em que a alteração foi feita. Se LIBASUSER=N, este valor será o ID do usuário que fez a alteração. - Para origens de DB2 para z/os, se você não especificar o parâmetro UIDFMT em LRAP CAPI_CONNECTION, este valor será o ID do usuário que fez a alteração. Caso contrário, este valor se baseará no parâmetro UIDFMT. - Para origens do Microsoft SQL Server, este valor é nulo porque o Microsoft SQL Server não registra essas informações no banco de dados de distribuição. - Para origens do Oracle, esse valor é uma identificação de usuário que o PowerExchange obtém do Oracle, se disponível. Caso contrário, este valor será nulo. Estas informações se aplicam ao PowerExchange Oracle CDC com LogMiner e ao PowerExchange Express CDC para Oracle. DECIMAL 10 VARBIN 255 VARCHAR Capítulo 6: Grupos de Extração e Mapas de Extração

210 Coluna Descrição Tipo de dados Tamanho DTL CAPXTIMESTAMP O registro de data/hora que o DBMS de origem registra para uma alteração no banco de dados de origem. Esse valor pode ser o registro de data/hora que o DBMS de origem grava no registro de alteração nos logs do banco de dados ou o registro de data/hora de confirmação da transação no banco de dados de origem. O tipo de carimbo de data/hora depende do tipo de origem e de determinados parâmetros: - Para origens do DB2 para Linux, UNIX e Windows, o carimbo de data/hora de confirmação da transação. - Para origens do Microsoft SQL Server, a hora em que a alteração foi gravada no banco de dados de distribuição. - Para origens do PowerExchange Express CDC para Oracle, o tipo de registro de data/hora tipo é controlado pelo parâmetro TIME_STAMP_MODE na instrução OPTIONS do arquivo de configuração do Express CDC. - Para todas as origens que exigem uma instrução UOWC CAPI_CONNECTION, o tipo de registro de data/hora é controlado pelo parâmetro TIMESTAMP na instrução UOWC CAPI_CONNECTION do arquivo DBMOVER. Para obter mais informações detalhadas sobre carimbos de data/hora para cada tipo de origem, consulte Apêndice F, Carimbos de Data/Hora DTL CAPXTIMESTAMP na página 360. O formato de carimbo de data/hora é: YYYYMMDDhhmmssnnnnnn Onde: - YYYY é o ano de quatro dígitos. - MM é o mês. - DD é o dia. - hhmmssnnnnnn é horas, minutos, segundos e microssegundos. Nota: O DB2 para Linux, UNIX e Windows e o Oracle não dão suporte a microssegundos no carimbo de data/hora. CHAR 20 Colunas Geradas pelo PowerExchange em Mapas de Extração 193

211 Coluna Descrição Tipo de dados Tamanho DTL CAPXACTION DTL CAPXCASDELIND Um único caractere que indica o tipo de registro de mudança que o PowerExchange passa para o destino durante o processamento de extração. Um valor DTL CAPXACTION corresponde ao tipo de operação de alteração no banco de dados de origem. Os valores válidos são: - I. Inserir. - D. Excluir. - U. Pós-imagem de uma atualização. - T. Pré-imagem de uma atualização. Somente as conexões (ODBC) Se você especificar um Tipo de Imagem de BA na conexão para uma sessão do CDC, o PowerExchange gera um registro de Exclusão, seguido por um registro de inserção para um atualização de origem. No registro de exclusão, a coluna DTL CAPXACTION contém o valor D. No registro de inserção, a coluna DTL CAPXACTION contém o valor I. Se você especificar um Tipo de Imagem de AI na conexão para uma sessão do CDC, o PowerExchange gera um registro para uma atualização. Nesse registro, a coluna DTL CAPXACTION contém o U valor. Se você usar uma conexão ODBC para gravar dados alterados para uma tabela de preparação e o defina o driver ODBC CAPXIMAGETYPE parâmetro para TU ou digite o SQL de sequência de escape DTLIMTYPE=TU no PowerCenter, essa coluna pode conter um valor de T ou U. para cada atualização de origem, o PowerExchange entrega dois registros para a tabela de preparação: um para a pré-imagem e outro para a pós-imagem. No registro de pré-imagem, a coluna DTL CAPXACTION contém a T valor. No registro da pós-imagem, a coluna DTL CAPXACTION contém o U valor. Apenas nas fontes do DB2 para z/os, um único caractere que indica se o DB2 excluiu a linha porque a tabela especifica a cláusula ON DELETE CASCADE. Os valores válidos são: - Y. Indica que o DB2 excluiu essa linha por causa de uma regra de exclusão em cascata. - N. Indica que o DB2 não excluiu essa linha por causa de uma regra de exclusão em cascata. CHAR 1 CHAR 1 DTL BI_columnname Para operações UPDATE, o valor da pré-imagem da coluna selecionada no registro de alteração. Tipo de dados da coluna de origem Tamanho da coluna de origem DTL CI_columnname Para operações UPDATE, um único caractere que indica se a coluna selecionada foi alterada. Os valores válidos são: - Y. Indica que a coluna foi alterada. - N. Indica que a coluna não foi alterada. - Valor nulo. Indica uma operação INSERT ou DELETE. CHAR Capítulo 6: Grupos de Extração e Mapas de Extração

212 Coluna Descrição Tipo de dados Tamanho DTL columnname_cnt DTL columnname_ind Coluna de contagem binária. O PowerExchange gera essa coluna para colunas de tamanho variável dos tipos VARCHAR e VARBIN para determinar o tamanho da coluna durante o processamento de extração de dados alterados. Nota: Por padrão, as colunas de contagem binária não são selecionadas em um mapa de extração. Você deve editar um mapa de extração para selecionar essas colunas. Coluna de indicador nulo. O PowerExchange gera essa coluna para colunas anuláveis para indicar o valor anulável para a coluna. Nota: Por padrão, as colunas com indicador nulo não são selecionadas em um mapa de extração. Você deve editar um mapa de extração para selecionar essas colunas. NUM32U 0 BIN 1 Colunas Geradas pelo PowerExchange em Mapas de Extração 195

213 C A P Í T U L O 7 Metadados Pessoais Este capítulo inclui os seguintes tópicos: Visão Geral de Metadados Pessoais, 196 Adicionando um Perfil de Metadados Pessoais, 196 Exibindo Metadados para Tabelas em um Perfil de Metadados Pessoais, 199 Exibindo Propriedades para uma Tabela em um Perfil de Metadados Pessoais, 200 Exibindo ou Editando Propriedades para um Perfil de Metadados Pessoais, 201 Atualizando Metadados Pessoais, 201 Excluindo um Perfil de Metadados Pessoais, 201 Visão Geral de Metadados Pessoais Você pode definir perfis de metadados pessoais para origens e destinos relacionais e não relacionais para testar a conectividade e acessar metadados e dados. Os perfis de metadados pessoais não são necessários para executar operações de movimento de dados em massa ou change data capture (CDC). Para exibir metadados para uma origem ou destino, crie um perfil de metadados pessoais. Exibir tabelas no perfil para ver metadados para cada coluna na tabela, como tipo de dados, formato de data e CCSID. Você pode exibir metadados para várias tabelas em um perfil ao mesmo tempo. Para visualizar dados para a origem ou o destino, execute um teste de linha de banco de dados em tabelas no perfil. Para obter informações sobre como abrir e fechar perfis de metadados pessoais, consulte Abrindo um Recurso do PowerExchange na página 18 e Fechando um Recurso do PowerExchange na página 20. Para obter informações sobre como pesquisar tabelas e colunas em tabelas nos perfis de metadados pessoais, consulte Pesquisando um Recurso na página 18. O PowerExchange apresenta um exemplo de perfil de metadados pessoais, demo_oracle. Para usar esse exemplo de perfil, edite suas propriedades para apontar para a instância Oracle. Adicionando um Perfil de Metadados Pessoais Adicione um perfil de metadados pessoais que você pode usar para se conectar a uma origem ou destino. 196

214 Você pode incluir filtros para limitar as tabelas que o perfil contém. 1. Na guia Recursos no Explorador de Recursos, clique em Adicionar > Metadados Pessoais. 2. Na caixa de diálogo Metadados Pessoais - Nome, digite as seguintes informações: Nome Um nome definido pelo usuário para o perfil de metadados pessoais. Localização Tipo A localização da origem ou do destino do qual você deseja exibir metadados. Selecione local se a origem ou o destino estiver no sistema do Navegador do PowerExchange. Esse campo lista as localizações definidas nas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. O padrão é local. Tipo de fonte de dados para a origem ou o destino. Selecione um dos seguintes tipos e digite as informações associadas: DB2. Origens ou destinos do DB2 para i5/os ou DB2 para z/os. Para o DB2 para i5/os, digite o nome do banco de dados na caixa SSID ou Nome do DB. O padrão é o banco de dados padrão. Para o DB2 para z/os, digite o SSID na caixa SSID ou Nome do DB. DB2400C. Interface de Nível de Chamada (CLI) do DB2 para origens i5/os. Digite o nome do banco de dados na caixa SSID ou Nome do DB. DB2UDB. Origens ou destinos do DB2 para Linux, UNIX e Windows. Digite o nome de um banco de dados na caixa Nome do DB. MSSQL. Origens ou destinos do Microsoft SQL Server. Digite o nome da instância do SQL Server na caixa DSN. Digite o nome de um banco de dados para substituir o banco de dados para a conexão na caixa Banco de Dados. NRDB ou NRDB2. Mapas de dados do PowerExchange para origens não relacionais como Adabas, CA Datacom/DB, CA IDMS/DB, IMS, VSAM e arquivos simples. Digite um nome de arquivo de substituição na caixa Nome do Arquivo de Substituição. O tipo de fonte de dados NRDB2 usa uma convenção de nomenclatura de duas camadas para a SQL gerada em um teste de linha de banco de dados enquanto o NRDB usa uma convenção de nomenclatura de três camadas. Você pode usar NRDB ou NRDB2 para mapas de dados do PowerExchange. ORACLE. Origens ou destinos Oracle. Digite um nome TNS para a instância Oracle na caixa Nome de SQL*Net. Nota: Não crie perfis de metadados pessoais para os seguintes tipos de fonte de dados preteridos: AS4_META CAPX CAPXRT ODBC TASK_CNTL Adicionando um Perfil de Metadados Pessoais 197

215 Identificação de Usuário Senha Insira um ID do usuário que permita o acesso à fonte. O tipo de ID do usuário depende do tipo de origem e das configurações de segurança do PowerExchange: Se a origem estiver em um sistema i5/os ou z/os e a segurança do PowerExchange estiver ativada, insira um ID do usuário do sistema operacional. A segurança do PowerExchange é habilitada quando a instrução SECURITY do PowerExchange no membro DBMOVER está definida como (1,x) ou 2.x). Para uma origem DB2 para Linux, UNIX e Windows, Microsoft SQL Server ou Oracle, digite um ID do usuário de banco de dados válido, se necessário. Para obter mais informações, consulte a Instrução SECURITY no Manual de Referência do PowerExchange. Uma senha do ID do usuário especificado. Se a origem estiver em um sistema i5/os ou z/os, você poderá inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Um código de acesso pode conter os seguintes caracteres: Letras em maiúsculas e minúsculas Os números de 0 a 9 Espaços Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. Se você especificar um ID do usuário e omitir a senha ou o código de acesso, ao abrir o perfil de metadados pessoais, o Navegador do PowerExchange solicitará a senha na caixa de diálogo Senha Faltando. Descrição Uma descrição definida pelo usuário para o perfil de metadados pessoais. 3. Clique em Avançar. 4. Na caixa de diálogo Metadados Pessoais - Filtros, digite as seguintes informações para limitar as tabelas que o perfil contém: 198 Capítulo 7: Metadados Pessoais

216 Dados de Filtro Dependendo do tipo de fonte de dados, insira filtros opcionais nas seguintes caixas de filtro, com ou sem caracteres curinga: Para o tipo de fonte de dados DB2, DB2400C ou DB2UDB, digite filtros nas caixas Criador/ Esquema, Nome do DB/Definidor e Tabela. Para o tipo de fonte de dados ORACLE, digite filtros nas caixas Esquema e Tabela. Para o tipo de fonte de dados MSSQL, insira filtros nas caixas Proprietário e Tabela. Para o tipo de fonte de dados NRDB ou NRDB2, digite filtros nas caixas Esquema, Nome do Mapa e Tabela. Em qualquer caixa de filtro, você pode usar os seguintes caracteres curinga: Um asterisco (*) para representar um ou mais caracteres correspondentes. Um ponto de interrogação (?) para representar um único caractere correspondente. Manter Capitalização Por padrão, o texto digitado em qualquer uma das caixas de filtro é convertido para a capitalização padrão para a fonte de dados. Por exemplo, no Oracle, letras maiúsculas são o padrão e, portanto, um valor de scott ou SCOTT produz o mesmo resultado: SCOTT. Selecione a opção Manter Capitalização para os filtros para os quais você não deseja que o PowerExchange use a capitalização padrão para a fonte de dados. Caractere de Escape Digite o caractere de escape a ser usado para delimitar um asterisco (*) ou um ponto de interrogação (?) que é usado como um valor literal em vez de como um caractere curinga nas caixas de filtro. Por exemplo, se você especificar um caractere de escape de ~, um valor de filtro de tab* retornará todas as tabelas que começam com tab. Um valor de filtro de tab~* retorna a tabela denominada tab*. Nota: Não use um caractere de escape com fontes de dados ativadas por multibyte. 5. Clique em Concluir. A guia Metadados Pessoais no Explorador de Recursos exibe o perfil de metadados pessoais e todas as tabelas que correspondem aos filtros especificados. 6. Para verificar se o perfil de metadados pessoais pode visualizar dados, execute um teste de linha de banco de dados em uma tabela no perfil. TÓPICOS RELACIONADOS: Testando um Perfil de Metadados Pessoais na página 207 Exibindo Metadados para Tabelas em um Perfil de Metadados Pessoais Você pode exibir metadados para as colunas em uma ou mais tabelas em um perfil de metadados pessoais. Você pode exibir metadados para uma única tabela de cada vez ou exibir metadados para várias tabelas, cada uma em uma janela separada Tabela. Exibindo Metadados para Tabelas em um Perfil de Metadados Pessoais 199

217 Para exibir metadados para tabelas em um perfil de metadados pessoais: 1. Na guia Metadados Pessoais no Explorador de Recursos, conclua uma das seguintes ações: Para exibir uma única tabela, dê um clique duplo na tabela. Para exibir várias tabelas, cada uma em uma janela separada Tabela, clique com o botão direito do mouse em cada tabela e clique em Explorar. Uma janela Tabela exibe os seguintes metadados para cada coluna da tabela: Nome. O nome da coluna. Tipo. O tipo dos dados. Precisão. A precisão dos dados. Escala. A escala de dados. Anulável. O valor YES ou NO para indicar se a coluna é anulável. Tipo de PowerExchange. O tipo dos dados do PowerExchange. O PowerExchange tem diferentes designações para alguns tipos de dados. Comentários. Comentários para a tabela. 2. Para ordenar os metadados em ordem alfabética por nome ou tipo de dados, clique no título Nome ou Tipo em uma janela Tabela. Para ordenar os metadados em ordem alfabética reversa, clique no título da coluna novamente. Uma seta pequena é exibida no título Nome ou Tipo que indica a ordem de classificação, como a seguir: Uma seta para baixo indica ordem alfabética. Uma seta para cima indica ordem alfabética reversa. Exibindo Propriedades para uma Tabela em um Perfil de Metadados Pessoais Você pode exibir o nome da tabela, o tipo de objeto e comentários para uma tabela em um perfil de metadados pessoais. u Na guia Metadados Pessoais no Explorador de Recursos, clique com o botão direito do mouse em uma tabela em um perfil de metadados pessoais e clique em Propriedades. A caixa de diálogo Propriedades da Tabela de Metadados Pessoais exibe as seguintes informações: Nome O nome da tabela em um dos seguintes formatos, dependendo do tipo de metadados pessoais: Para NRDB: schema.map.table Para NRDB2: schema.map_table Para origens relacionais: schema.table 200 Capítulo 7: Metadados Pessoais

218 Tipo O tipo de objeto. Comentários Comentários para a tabela. Exibindo ou Editando Propriedades para um Perfil de Metadados Pessoais Você pode exibir ou editar propriedades para um perfil de metadados pessoais. Você pode editar um perfil de metadados pessoais para alterar os critérios de filtragem para as tabelas. 1. Abra o perfil de metadados pessoais. 2. Na guia Metadados Pessoais no Explorador de Recursos, clique com o botão direito do mouse em um perfil de metadados pessoais e clique em Propriedades. A caixa de diálogo Propriedades de Metadados Pessoais é exibida. 3. Na guia Nome, na guia Filtro ou em ambas, exiba ou edite as propriedades do perfil. 4. Clique em OK. TÓPICOS RELACIONADOS: Adicionando um Perfil de Metadados Pessoais na página 196 Atualizando Metadados Pessoais Você pode atualizar os objetos exibidos por um perfil de metadados pessoais. Talvez você queira atualizar metadados pessoais se tiver definido novas tabelas ou exibições na fonte. Ou, se o Ouvinte do PowerExchange não estava em execução no sistema de origem quando você abriu o perfil, você pode iniciar o Ouvinte do PowerExchange e atualizar os metadados pessoais. Para atualizar metadados pessoais: u Na guia Metadados Pessoais no Explorador de Recursos, clique com o botão direito do mouse em um perfil de metadados pessoais e clique em Atualizar. Os metadados no perfil de metadados pessoais são atualizados com metadados atuais da fonte de dados. Excluindo um Perfil de Metadados Pessoais Você pode excluir um perfil de metadados pessoais. Exibindo ou Editando Propriedades para um Perfil de Metadados Pessoais 201

219 Para excluir um perfil de metadados pessoais: 1. Se o perfil de metadados pessoais estiver aberto, feche-o. 2. Na guia Recursos do Explorador de Recursos, clique com o botão direito do mouse no perfil e clique em Excluir. 3. Na caixa de mensagens que solicita que você confirme a exclusão do perfil, clique em Sim. O PowerExchange exclui o perfil. 202 Capítulo 7: Metadados Pessoais

220 C A P Í T U L O 8 Teste de Linha de Banco de Dados Este capítulo inclui os seguintes tópicos: Visão Geral do Teste de Linha de Banco de Dados, 203 Testando um Mapa de Dados, 205 Testando um Mapa de Extração, 206 Testando um Perfil de Metadados Pessoais, 207 Emitindo Comandos do Ouvinte do PowerExchange em um Teste de Linha de Banco de Dados, 208 Gerando Tokens de Reinicialização para Captura de Dados Alterados, 209 Caixa de Diálogo Teste de Linha de Banco de Dados, 210 Caixa de Diálogo Parâmetros Avançados de CAPX, 218 Caixa de Diálogo Parâmetros Avançados de CAPXRT, 219 Caixa de Diálogo Parâmetros Avançados de DB2390IMG, 223 Caixa de Diálogo Parâmetros Avançados (IMS), 223 Visão Geral do Teste de Linha de Banco de Dados Você pode executar um teste de linha de banco de dados em um recurso do PowerExchange para visualizar dados para todas as fontes de dados e para gerar tokens de reinicialização para fontes de captura de dados alterados do PowerExchange. Você também pode executar um teste de linha de banco de dados para emitir comandos do Ouvinte do PowerExchange por meio do Navegador do PowerExchange. Para visualizar dados, você pode executar um teste de linha de banco de dados nos seguintes recursos do PowerExchange: Mapas de dados. Um teste de linha de banco de dados valida mapas de dados e permite visualizar dados da fonte para tabelas em mapas de dados. Mapas de extração. Um teste de linha de banco de dados permite visualizar dados alterados capturados. Perfis de metadados pessoais. Um teste de linha de banco de dados permite visualizar dados da fonte para tabelas em perfis de metadados pessoais. Um teste de linha de banco de dados acessa dados em uma fonte de dados e os exibe no formato de tabela na janela Saída do Teste de Linha de Banco de Dados. Os resultados de um teste de linha de mapa de 203

221 dados ou de mapa de extração indicam que o PowerExchange pode acessar dados quando uma operação de movimento de dados em massa ou uma extração de dados alterados é executada. Além de visualizar dados para fontes de dados em um teste de linha de banco de dados, você pode usar instruções SQL DTLDESCRIBE para visualizar metadados em um mapa de dados ou em um mapa de extração. Dependendo do tipo de fonte de dados, você pode visualizar metadados para colunas, chaves externas e primárias, procedimentos e colunas de procedimento, registros, esquemas e tabelas. Se você visualizar metadados na caixa de diálogo Teste de Linha de Banco de Dados, o PowerExchange gerará uma instrução SQL DTLDESCRIBE na caixa Instrução SQL. Você pode editar essa instrução. Nota: A sintaxe SQL DTLDESCRIBE é válida para origens relacionais e não relacionais. Para obter informações sobre a sintaxe DTLDESCRIBE, consulte o Manual de Referência do PowerExchange. Se você executar um teste de linha de banco de dados para gerar tokens de reinicialização para fontes de captura de dados alterados do PowerExchange, o Navegador do PowerExchange exibirá os tokens de reinicialização gerados na janela Saída do Teste de Linha de Banco de Dados. Você pode copiar a saída dessa janela para preencher o arquivo do token de reinicialização PWXPC. Exibindo ou Ocultando a Janela Saída do Teste de Linha de Banco de Dados Você pode exibir ou ocultar a janela Saída do Teste de Linha de Banco de Dados. Se você exibi-la, a janela mostrará os resultados do último teste de linha de banco de dados na parte inferior da GUI do Navegador do PowerExchange. Para exibir ou ocultar a janela Saída do Teste de Linha de Banco de Dados: u Clique em Exibir > Saída. Nota: Essa opção está ativada depois que você executa um teste de linha de banco de dados. Teste de Linha de Banco de Dados e Dados da Página de Códigos Não Padrão Os dados da página de códigos não padrão, incluindo dados multibyte, estão disponíveis para seleção no DB2 no z/os e no i5/os e o Navegador do PowerExchange pode exibir caracteres de byte duplo. O Navegador do PowerExchange usa uma página de códigos UTF-16LE, que permite a exibição de um conjunto de caracteres largos. Antes de visualizar dados com um teste de linha de banco de dados, verifique se os dados aparecerão no formato correto editando as seguintes instruções no arquivo de configuração do PowerExchange no sistema do qual você acessa dados: DB2CODEPAGE for DB2 no z/os DB2_BIN_CODEPAGE for DB2 no i5/os Para obter mais informações sobre páginas de códigos, consulte o Manual de Referência do PowerExchange. 204 Capítulo 8: Teste de Linha de Banco de Dados

222 Testando um Mapa de Dados Você pode executar um teste de linha de banco de dados para validar um mapa de dados e visualizar dados de tabelas em um mapa de dados. Um teste de linha de banco de dados acessa dados em uma fonte de dados e os exibe no formato de tabela na janela Saída do Teste de Linha de Banco de Dados. 1. Abra um mapa de dados. 2. Na guia Mapa de Dados no Explorador de Recursos, clique em uma tabela. 3. Para obter dados de colunas específicas, selecione essas colunas na janela Tabela. O PowerExchange adiciona as colunas selecionadas à instrução SQL SELECT gerada na caixa Instrução SQL na caixa de diálogo Teste de Linha de Banco de Dados. Nota: Selecionar colunas específicas na tabela não afeta as solicitações SQL DTLDESCRIBE. 4. Clique em Arquivo > Teste de Linha de Banco de Dados. A caixa de diálogo Nó Remoto do Mapa de Dados é exibida. 5. Na caixa de diálogo Nó Remoto do Mapa de Dados, insira as informações de conexão do sistema remoto e clique em OK. A caixa de diálogo Teste de Linha de Banco de Dados é exibida. 6. Na lista Tipo de DB na caixa de diálogo Teste de Linha de Banco de Dados, clique no tipo de fonte de dados. Em seguida, digite qualquer informação associada ao tipo de fonte de dados. Nota: Use o tipo de fonte de dados AS4_META sob orientação do Suporte Global a Clientes da Informatica. 7. Na lista Obter, selecione Dados para visualizar dados ou selecione outra opção para visualizar metadados de um item, como metadados de uma tabela ou um esquema. Dependendo da opção que você seleciona na lista Buscar, uma instrução SQL é gerada na caixa Instrução SQL, como a seguir: Se você selecionar Dados na lista Buscar, será gerada uma instrução SQL SELECT. Se você selecionar uma opção de metadados na lista Buscar, uma instrução SQL DTLDESCRIBE. 8. Como alternativa, edite a instrução SQL SELECT ou DTLDESCRIBE na caixa Instrução SQL. 9. Para o tipo de fonte de dados CAPX ou CAPXRT, digite um nome de aplicativo na caixa Aplicativo. 10. Para os tipos de fontes de dados CAPX, CAPXRT, DB2390IMG ou NRDB, clique em Avançado para inserir valores de substituição do teste de linha. Em seguida, na caixa de diálogo Parâmetros Avançados, insira qualquer um dos valores de substituição disponíveis para o tipo de origem. Esses valores substituem determinados valores nas definições ou arquivos de configuração do PowerExchange, como mapas de dados ou o arquivo de configuração DBMOVER. 11. Na lista Obter Linhas, selecione o número de linhas a retornar na saída. Você pode exibir até 999 linhas de dados de uma vez. Por padrão, o PowerExchange exibe dez linhas de dados. 12. Clique em Ir. A janela Saída do Teste de Linha de Banco de Dados exibe os resultados do teste de linha de banco de dados. TÓPICOS RELACIONADOS: Caixa de Diálogo Teste de Linha de Banco de Dados na página 210 Caixa de Diálogo Parâmetros Avançados de CAPX na página 218 Caixa de Diálogo Parâmetros Avançados de CAPXRT na página 219 Testando um Mapa de Dados 205

223 Caixa de Diálogo Parâmetros Avançados de DB2390IMG na página 223 Caixa de Diálogo Parâmetros Avançados (IMS) na página 223 Testando um Mapa de Extração Você pode executar um teste de linha de banco de dados para um mapa de extração para visualizar dados alterados capturados e testar mudanças para um registro de captura. 1. Abra um grupo e um mapa de extração. 2. Para obter dados para colunas específicas, selecione as colunas na janela Definição de Extração. O PowerExchange adiciona as colunas selecionadas à instrução SQL SELECT gerada na caixa Instrução SQL na caixa de diálogo Teste de Linha de Banco de Dados. Nota: Selecionar colunas específicas na tabela não afeta as solicitações SQL DTLDESCRIBE. 3. Clique em Arquivo > Teste de Linha de Banco de Dados. A caixa de diálogo Teste de Linha de Banco de Dados é exibida. 4. Na lista Tipo de DB na caixa de diálogo Teste de Linha de Banco de Dados, clique no tipo de fonte de dados. Em seguida, digite qualquer informação associada ao tipo de fonte de dados. Nota: Use o tipo de fonte de dados AS4_META sob orientação do Suporte Global a Clientes da Informatica. 5. Na lista Obter, selecione Dados para visualizar dados ou selecione outra opção para visualizar metadados de um item, como metadados de uma tabela ou um esquema. Dependendo da opção que você seleciona na lista Buscar, uma instrução SQL é gerada na caixa Instrução SQL, como a seguir: Se você selecionar Dados na lista Buscar, será gerada uma instrução SQL SELECT. Se você selecionar uma opção de metadados na lista Buscar, uma instrução SQL DTLDESCRIBE. 6. Como alternativa, edite a instrução SQL SELECT ou DTLDESCRIBE na caixa Instrução SQL. 7. Para o tipo de fonte de dados CAPX ou CAPXRT, digite um nome de aplicativo na caixa Aplicativo. 8. Para os tipos de fontes de dados CAPX, CAPXRT, DB2390IMG ou NRDB, clique em Avançado para inserir valores de substituição do teste de linha. Em seguida, na caixa de diálogo Parâmetros Avançados, insira qualquer um dos valores de substituição disponíveis para o tipo de origem. Esses valores substituem determinados valores nas definições ou arquivos de configuração do PowerExchange, como mapas de dados ou o arquivo de configuração DBMOVER. 9. Na lista Obter Linhas, selecione o número de linhas a retornar na saída. Você pode exibir até 999 linhas de dados de uma vez. Por padrão, o PowerExchange exibe dez linhas de dados. 10. Clique em Ir. A janela Saída do Teste de Linha de Banco de Dados exibe os resultados do teste de linha de banco de dados, que exibe as mudanças ocorridas na tabela registrada para captura de dados. Se você adicionou colunas de pré ou pós-imagem ao mapa de extração, essas colunas também serão exibidas na saída do teste de linha de banco de dados. 206 Capítulo 8: Teste de Linha de Banco de Dados

224 TÓPICOS RELACIONADOS: Adicionando ou Removendo Colunas Indicador de Mudança e Pré-imagem para uma Coluna de Dados na página 179 Testando um Perfil de Metadados Pessoais Você pode executar um teste de linha de banco de dados para uma tabela em um perfil de metadados pessoais para visualizar dados. Aviso: O Navegador do PowerExchange permite que você selecione colunas com tipos de dados que o PowerExchange não suporta. Um teste de linha de banco de dados falha quando você inclui colunas com tipos de dados não suportados. 1. Abra um perfil de metadados pessoais. 2. Na guia Metadados Pessoais no Explorador de Recursos, dê um clique duplo em uma tabela para abri-la. 3. Para obter dados para colunas específicas, selecione essas colunas na janela Tabela. O PowerExchange adiciona as colunas selecionadas à instrução SQL SELECT gerada na caixa Instrução SQL na caixa de diálogo Teste de Linha de Banco de Dados. 4. Clique em Arquivo > Teste de Linha de Banco de Dados. A caixa de diálogo Teste de Linha de Banco de Dados é exibida. 5. Na lista Tipo de DB na caixa de diálogo Teste de Linha de Banco de Dados, clique no tipo de fonte de dados. Em seguida, digite qualquer informação associada ao tipo de fonte de dados. Nota: Use o tipo de fonte de dados AS4_META sob orientação do Suporte Global a Clientes da Informatica. 6. A lista Busca é desativada. Para um perfil de metadados pessoais, a opção padrão é Dados. 7. Como alternativa, edite a instrução SQL SELECT ou DTLDESCRIBE na caixa Instrução SQL. 8. Para o tipo de fonte de dados CAPX ou CAPXRT, digite um nome de aplicativo na caixa Aplicativo. 9. Para os tipos de fontes de dados CAPX, CAPXRT, DB2390IMG ou NRDB, clique em Avançado para inserir valores de substituição do teste de linha. Em seguida, na caixa de diálogo Parâmetros Avançados, insira qualquer um dos valores de substituição disponíveis para o tipo de origem. Esses valores substituem determinados valores nas definições ou arquivos de configuração do PowerExchange, como mapas de dados ou o arquivo de configuração DBMOVER. 10. Na lista Obter Linhas, selecione o número de linhas a retornar na saída. Você pode exibir até 999 linhas de dados de uma vez. Por padrão, o PowerExchange exibe dez linhas de dados. 11. Clique em Ir. A janela Saída do Teste de Linha de Banco de Dados exibe os resultados do teste de linha de banco de dados. Testando um Perfil de Metadados Pessoais 207

225 Emitindo Comandos do Ouvinte do PowerExchange em um Teste de Linha de Banco de Dados Você pode executar um teste de linha de banco de dados para emitir um comando LISTTASK ou STOPTASK para um Ouvinte do PowerExchange em execução em qualquer sistema. Você também pode emitir um comando LISTLOCATIONS, que retorna uma listagem das instruções NODE definidas no arquivo de configuração DBMOVER. Para emitir comandos do Ouvinte do PowerExchange em um teste de linha de banco de dados: 1. Abra um mapa de dados definido para o sistema no qual está em execução o Ouvinte do PowerExchange para o qual você deseja emitir comandos. Nota: Você pode abrir um mapa de extração ou um perfil de metadados pessoais definido para a localização do Ouvinte do PowerExchange. 2. Na guia Mapa de Dados no Explorador de Recursos, clique em uma tabela e clique em Arquivo > Teste de Linha de Banco de Dados. 3. Na caixa de diálogo Nó Remoto do Mapa de Dados, digite informações de conexão para o sistema no qual o Ouvinte do PowerExchange está em execução e clique em OK. A caixa de diálogo Teste de Linha de Banco de Dados é exibida. 4. Na lista Tipo de DB, selecione TASK_CNTL. 5. Na lista Buscar, selecione um dos comandos a seguir: Listar Localizações. Exibe informações sobre as instruções NODE definidas no arquivo de configuração DBMOVER no sistema em que o Ouvinte do PowerExchange está em execução. Listar Tarefa. Exibe informações sobre cada tarefa ativa do Ouvinte do PowerExchange, incluindo o endereço TCP/IP, número da porta, nome do aplicativo, tipo de acesso e status. Interromper Tarefa. Interrompe uma tarefa individual do Ouvinte do PowerExchange com base no nome do aplicativo especificado. 6. Se você estiver emitindo um comando STOPTASK, poderá digitar um nome de aplicativo na caixa Aplicativo. O nome do aplicativo é o nome do processo de extração ativo a ser interrompido. Esse nome é incluído na saída do comando LISTTASK. 7. Se você estiver emitindo um comando STOPTASK, adicione um ID de tarefa ao seguinte comando na caixa Instrução SQL: stoptask taskid= Os IDs de tarefa para tarefas ativas são incluídos na saída do comando LISTTASK. 8. Clique em Ir. A janela Saída do Teste de Linha de Banco de Dados exibe a saída para o comando. 208 Capítulo 8: Teste de Linha de Banco de Dados

226 TÓPICOS RELACIONADOS: Enviando um Mapa de Dados para um Sistema Remoto na página 73 Gerando Tokens de Reinicialização para Captura de Dados Alterados Você pode executar um teste de linha de banco de dados para gerar tokens de reinicialização para fontes de dados. Use esses tokens de reinicialização gerados para preencher o arquivo do token de reinicialização PWXPC para uma sessão do PowerCenter. O PowerExchange gera tokens de reinicialização usando a localização e o tipo de origem especificados. Esses tokens de reinicialização representam o fim atual do fluxo de mudança no momento em que você executou o teste de linha do banco de dados. O Navegador do PowerExchange exibe os tokens de reinicialização gerados na janela Saída do Teste de Linha de Banco de Dados. Copie a saída dessa janela para preencher o arquivo de tokens de reinicialização PWXPC. Use um dos métodos a seguir para gerar tokens de reinicialização: Inclua a instrução de substituição especial com CURRENT_RESTART no arquivo de tokens de reinicialização do PWXPC. O PWXPC e o PowerExchange geram tokens de reinicialização que representam o fim atual do fluxo de mudança no momento em que a sessão do PowerCenter é executada. Use o utilitário DTLUAPPL com os parâmetros GENERATE RSTTKN e um registro de captura válido. O DTLUAPPL gera tokens de reinicialização que representam o fim atual do fluxo de mudança no momento em que o utilitário é executado. Para gerar tokens de reinicialização para captura de dados alterados: 1. Abra o mapa de extração para o registro de captura para o qual você deseja gerar tokens de reinicialização. 2. Na guia Mapa de Extração no Explorador de Recursos, clique no mapa de extração e clique em Arquivo > Teste de Linha de Banco de Dados. A caixa de diálogo Teste de Linha de Banco de Dados é exibida. 3. Na lista Tipo de DB, selecione CAPXRT. 4. Na lista Localização, selecione o nome do nó que representa a localização da fonte de dados. As localizações exibidas na lista Localização são definidas pelas instruções NODE no arquivo de configuração dbmover.cfg no sistema do Navegador do PowerExchange. 5. Na caixa Aplicativo, digite o nome de um aplicativo. Um valor válido é de 1 a 20 caracteres de extensão. 6. Para gerar tokens de reinicialização, digite a seguinte instrução SQL do PowerExchange na caixa Instrução SQL: SELECT CURRENT_RESTART [WHERE {CONNAME=conn_name CONTYPE=conn_type}] Essa instrução SQL tem os seguintes parâmetros: SELECT CURRENT_RESTART Gera tokens de reinicialização atuais. Gerando Tokens de Reinicialização para Captura de Dados Alterados 209

227 CONNAME=conn_name Especifica o nome CAPI_CONNECTION na localização de origem que o PowerExchange usa para determinar o tipo de fonte de dados. Nota: Se você não especificar o parâmetro CONNAME ou CONTYPE, o PowerExchange determinará o tipo de fonte de dados usando o valor na instrução CAPI_CONN_NAME para o Ouvinte do PowerExchange na localização de origem. CONTYPE=conn_type Especifica o tipo de conexão que o PowerExchange usa para determinar o tipo de fonte de dados. Nota: Se você não especificar o parâmetro CONNAME ou CONTYPE, o PowerExchange determinará o tipo de fonte de dados usando o valor na instrução CAPI_CONN_NAME para o Ouvinte do PowerExchange na localização de origem. Os formatos dos tokens de reinicialização variam de acordo com o tipo de origem. Especifique um dos seguintes valores para o valor conn_type: ADA. Origens Adabas (z/os). AS4. Origens DB2 para i5/os. DCM. Origens CA Datacom/DB (z/os). DB2. Origens DB2 para z/os (z/os). IDL. Origens baseadas em log CA IDMS/DB (z/os). IDM. Origens síncronas CA IDMS/DB (z/os). IML. Origens baseadas em log IMS (z/os). IMS. Origens síncronas IMS (z/os). ORA. Origens Oracle. MSS. Origens Microsoft SQL Server. UDB. Origens DB2 para Linux, UNIX e Windows. VSAM ou VSM. Origens VSAM (z/os). Para origens z/os, todos os tipos de conexão z/os resultam em tokens de reinicialização do mesmo formato, pois o PowerExchange registra todos os dados alterados de origens z/os no Agente de Log do PowerExchange. Os tokens de reinicialização para origens z/os representam localizações nos logs do Agente de Log do PowerExchange. 7. Clique em Ir. A janela Saída do Teste de Linha de Banco de Dados exibe os tokens de reinicialização gerados. 8. Para copiar os tokens de reinicialização gerados, clique com o botão direito do mouse na janela Saída do Teste de Linha de Banco de Dados e clique em Copiar Saída. Você pode usar os tokens de reinicialização gerados no arquivo de tokens de reinicialização do PWXPC. Caixa de Diálogo Teste de Linha de Banco de Dados Na caixa de diálogo Teste de Linha de Banco de Dados, você pode definir as opções de um teste de linha de banco de dados. A caixa de diálogo inclui as seguintes opções: 210 Capítulo 8: Teste de Linha de Banco de Dados

228 Tipo de DB O tipo de fonte de dados e, para algumas fontes de dados, como ela é acessada. Para mapas de extração, o padrão é CAPXRT. Selecione um tipo de fonte de dados e insira as informações da fonte de dados associada: ADAUNLD. Arquivo de descarregamento não relacional do Adabas acessado por meio de um mapa de dados. Na caixa Nome do Arquivo, digite o nome do arquivo para recuperação de dados. Na caixa Banco de Dados, digite o nome do banco de dados. AS4_META. Use sob a orientação do Suporte Global a Clientes da Informatica. CAPX. Lê as mudanças dos arquivos no Condensador do PowerExchange ou nos arquivos do Agente de Log do PowerExchange para Linux, UNIX e Windows em lotes e para. Na caixa Substituir Nome do Arquivo, digite o nome do arquivo para substituir o arquivo padrão. CAPXRT. Lê as alterações diretamente no fluxo de mudança, nos arquivos do Condensador do PowerExchange ou nos arquivos do Agente de Log do PowerExchange para Linux, UNIX e Windows em tempo real. Na caixa Substituir Nome do Arquivo, digite o nome do arquivo para substituir o arquivo padrão. DB2. Banco de dados DB2 para i5/os ou DB2 para z/os. Para o DB2 para z/os, digite o ID do subsistema do DB2 ou o nome do grupo de compartilhamento de dados do DB2 na caixa SSID ou Nome do DB. DB2390IMG. Lê dados de uma cópia de imagem do DB2 para espaços de tabela não compactados de um sistema remoto. Na caixa Substituir Nome do Arquivo, digite o nome do arquivo para substituir o arquivo padrão. Na caixa SSID, digite o SSID. DB2400C. Usa o método de acesso Interface de Nível de Chamada (CLI) para acessar dados do DB2, que fornecem acesso mais rápido aos dados do DB2. Para o DB2 para z/os, digite o SSID na caixa SSID ou Nome do DB. DB2UDB. Banco de dados do DB2 para Linux, UNIX e Windows. Digite o nome do banco de dados na caixa SSID ou Nome do DB. Se você omitir o nome do banco de dados, o nome do banco de dados padrão será usado. IMSUNLD. Arquivo de descarregamento do IMS. Na caixa Nome do Arquivo, digite o nome do arquivo de descarregamento do IMS. MSSQL. Banco de dados do Microsoft SQL Server. Na caixa DSN, digite o nome da instância do SQL Server. Digite o nome de um banco de dados para substituir o banco de dados para a conexão na caixa Banco de Dados. NRDB. Fonte de dados não relacionais, como um conjunto de dados VSAM, um banco de dados IMS ou um arquivo simples. Nota: Esse tipo de fonte de dados usa uma convenção de nomenclatura de três camadas na SQL gerada. Digite o nome do arquivo para substituir o arquivo padrão na caixa Substituir Nome do Arquivo. Na caixa Senha do Arquivo, digite a senha para o arquivo, se necessário. NRDB2. Fonte de dados não relacional. Caixa de Diálogo Teste de Linha de Banco de Dados 211

229 Nota: Esse tipo de fonte de dados usa uma convenção de nomenclatura de duas camadas na SQL gerada. Digite o nome do arquivo para substituir o arquivo padrão na caixa Substituir Nome do Arquivo. Na caixa Senha do Arquivo, digite a senha para o arquivo, se necessário. ODBC. Fonte de dados ODBC. Na caixa DSN, digite o nome do conjunto de dados. Na caixa Banco de Dados, digite o nome do banco de dados. ORACLE. Banco de dados Oracle. Digite um nome TNS para a instância Oracle na caixa Nome de SQL*Net. Simulador. Fonte de dados do simulador. Na caixa DB Qual1, digite um valor. TASK_CTRL. Permite que você emita um comando do Ouvinte do PowerExchange por meio do Localização Navegador do PowerExchange. Para obter mais informações, consulte Emitindo Comandos do Ouvinte do PowerExchange em um Teste de Linha de Banco de Dados na página 208. Selecione o nome do nó do local da fonte de dados. Este campo lista os locais que são definidos nas instruções NODE no arquivo de configuração DBMOVER no sistema do Navegador do PowerExchange. Um valor local indica que a fonte está no sistema do Navegador do PowerExchange. Se você estiver testando um mapa de dados IMS com o método de acesso DL/1, insira o nome do nó do local em que o trabalho netport é executado. Se você estiver testando um mapa de dados IMS com o método de acesso ODBA, insira o nome do nó da localização na qual o Ouvinte do PowerExchange é executado. Identificação de Usuário Senha Um ID do usuário que permite o acesso à origem. O tipo de ID do usuário depende do tipo de origem e das configurações de segurança do PowerExchange na instrução SECURITY do arquivo de configuração DBMOVER. Uma senha do ID do usuário, se especificada. Se a origem estiver em um sistema i5/os ou z/os, você poderá inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Um código de acesso pode conter os seguintes caracteres: Letras em maiúsculas e minúsculas Os números de 0 a 9 Espaços Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. 212 Capítulo 8: Teste de Linha de Banco de Dados

230 Busca No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. O tipo de dados para acessar e exibir no teste de linha de banco de dados ou, para o tipo de fonte de dados TASK_CTRL, o tipo de comando para emitir para um Ouvinte do PowerExchange. Nota: Para perfis de metadados pessoais, a lista Busca é desativada e a opção padrão é Dados. A tabela a seguir descreve as opções na lista Busca: Opção Disponível para Tipos de Fonte de Dados Descrição Colunas Tudo, exceto TASK_CTRL Exibe metadados para colunas. Dados Tudo, exceto TASK_CTRL Exibe linhas de dados. Chaves externas Tudo, exceto TASK_CTRL Exibe metadados para chaves externas. Chaves primárias Tudo, exceto TASK_CTRL Exibe metadados para chaves primárias. Colunas de Procedimento - DB2 - DB2400C - Simulador Exibe metadados para procedimentos armazenados específicos. Procedimentos - DB2 - DB2400C - Simulador Registros - NRDB - NRDB2 Exibe metadados para os procedimentos armazenados disponíveis. Exibe metadados para os registros NRDB e NRDB2. Caixa de Diálogo Teste de Linha de Banco de Dados 213

231 Opção Disponível para Tipos de Fonte de Dados Descrição Esquemas - ADAUNLD - CAPX - CAPXRT - DB2 - DB2390IMG - DB2400C - DB2UDB - IMSUNLD - INFORMIX - MSSQL - NRDB - NRDB2 - ODBC - ORACLE Exibe metadados para nomes de esquema para o tipo de fonte de dados especificado. Tabelas Tudo, exceto TASK_CTRL Exibe metadados para tabelas. Listar Localizações TASK_CTRL Exibe informações sobre as instruções NODE definidas no arquivo de configuração DBMOVER no sistema em que o Ouvinte do PowerExchange está em execução. Listar Tarefa TASK_CTRL Exibe informações sobre cada tarefa ativa do Ouvinte do PowerExchange, incluindo o endereço TCP/IP, número da porta, nome do aplicativo, tipo de acesso e status. Interromper Tarefa TASK_CTRL Interrompe uma tarefa individual do Ouvinte do PowerExchange com base no nome do aplicativo especificado. Para visualizar dados, selecione Dados. O padrão é Dados. Métodos de Acesso Se você selecionar Tabelas ou Colunas na lista Busca para o tipo de fonte de dados NRDB ou NRDB2 ou se a opção Tabelas for selecionada para o tipo de fonte de dados CAPX ou CAPXRT, a lista Métodos de Acesso será ativada. Para retornar informações para métodos de acesso específicos, selecione um ou mais métodos de acesso. O PowerExchange adiciona palavras-chave de filtragem à instrução DTLDESCRIBE na caixa Instrução SQL. Se você não selecionar um método de acesso, a instrução DTLDESCRIBE retornará informações para todos os métodos de acesso. Nota: Para limpar todas as seleções na lista Métodos de Acesso, clique com o botão direito do mouse na lista Métodos de Acesso e clique em Tirar Seleção de Tudo. 214 Capítulo 8: Teste de Linha de Banco de Dados

232 A tabela a seguir descreve as opções na lista Métodos de Acesso: Método de Acesso Descrição Palavra-chave DTLDESCRIBE DM_ADABAS Adabas A DM_CAPX - CAPX - CAPXRT C DM_DATACOM Datacom X DM_DB2 - DB2 para i5/os - DB2 para z/os Z DM_DB2390IMG DB2390IMG G DM_DB2UNLD Arquivo de descarregamento do DB2 W DM_DL1 Lote IMS DL/1 D DM_ESDS VSAM ESDS E DM_IDMS IDMS I DM_ISAM C-ISAM M DM_KSDS VSAM KSDS K DM_MQ MQSeries Q DM_ODBA IMS ODBA O DM_RRDS VSAM RRDS N DM_SEQ Conjunto de dados sequenciais ou arquivo simples S DM_TAPE Fita T DM_USER Método de acesso do usuário U A tabela a seguir descreve os métodos de acesso do mapa de extração disponíveis para o tipo de fonte de dados CAPX ou CAPXRT: Método de Acesso Descrição Palavra-chave DTLDESCRIBE DM_XDB2 Mapa de extração do DB2 B DM_XDB2UDB Mapa de extração do DB2 para Linux, UNIX e Windows V Caixa de Diálogo Teste de Linha de Banco de Dados 215

233 Método de Acesso Descrição Palavra-chave DTLDESCRIBE DM_XMSSQL Mapa de extração do Microsoft SQL Server L DM_XORACLE Mapa de extração Oracle P Arquivo SQL Editar Usa um arquivo que contém uma instrução SQL em vez de usar a SQL gerada na caixa Instrução SQL. Se você selecionar essa opção, digite o caminho e o nome de arquivo do arquivo SQL na caixa Arquivo SQL ou clique no botão Procurar para buscar o arquivo. O padrão é limpo. Ativado se a opção Arquivo SQL estiver selecionada. Clique em Editar para editar o arquivo SQL especificado na caixa Arquivo SQL. Tamanho de Registro SQL Ativado se a opção Arquivo SQL estiver selecionada. O tamanho do registro da SQL no arquivo SQL. Instrução SQL Exibe a SQL gerada, SQL DTLDESCRIBE, ou a instrução de comando do Ouvinte do PowerExchange para o tipo de fonte de dados especificado e as opções Busca. Você pode editar a instrução na caixa Instrução SQL. Nota: Se você selecionar a opção Arquivo SQL, a caixa Instrução SQL será desativada. O PowerExchange gera as seguintes instruções na caixa Instrução SQL para as seguintes combinações de tipo de fonte de dados e opção Busca: Qualquer tipo de fonte de dados, exceto TASK_CTRL e Dados na lista Busca Uma instrução SQL é gerada e exibida na caixa Instrução SQL. O PowerExchange gera a seguinte instrução SELECT para mapas de dados que usam uma convenção de nomenclatura de duas camadas: select * from schema.map_table O PowerExchange gera a seguinte instrução SELECT para mapas de dados que usam uma convenção de nomenclatura de três camadas: select * from schema.map.table Qualquer tipo de fonte de dados, exceto TASK_CTRL e uma opção de metadados na lista Busca Uma instrução DTLDESCRIBE é gerada e exibida na caixa Instrução SQL. As opções de metadados incluem Colunas, Chaves Externas, Chaves Primárias, Colunas de Procedimento, Procedimentos, Esquemas e Tabelas. O tipo de fonte de dados TASK_CTRL e um comando do Ouvinte do PowerExchange na lista Busca Um comando do Ouvinte do PowerExchange é gerado e exibido na caixa Instrução SQL. Nota: Use o tipo de fonte de dados AS4_META sob orientação do Suporte Global a Clientes da Informatica. 216 Capítulo 8: Teste de Linha de Banco de Dados

234 Filtros de Metadados Se você selecionar uma opção de metadados na lista Busca, poderá digitar filtros nas seguintes caixas de filtro de metadados, com ou sem caracteres curinga: Para o tipo de fonte de dados ADAUNLD, CAPX, CAPXRT, DB2390IMG, IMSUNLD, NRDB2 ou ORACLE, digite filtros nas caixas Esquema e Tabela. O tamanho máximo é de 128 caracteres na caixa Esquema e 128 caracteres na caixa Tabela. Para o tipo de fonte de dados Simulador, digite um filtro na caixa Tabela. Para o tipo de fonte de dados DB2, DB2400C ou DB2UDB, digite filtros nas caixas Criador/ Esquema, Nome do DB/Definidor e Tabela. Para o DB2 para i5/os, o tamanho máximo é de 10 caracteres na caixa Criador/Esquema e de 32 caracteres na caixa Tabela. Para o DB2 para z/os, o tamanho máximo é de 128 caracteres na caixa Criador/Esquema e de 128 caracteres na caixa Tabela. Para o tipo de fonte de dados INFORMIX, MSSQL ou ODBC, insira filtros nas caixas Proprietário e Tabela. O tamanho máximo é de 128 caracteres na caixa Proprietário e 128 caracteres na caixa Tabela. Para o tipo de fonte de dados NRDB, digite filtros nas caixas Esquema, Nome do Mapa e Tabela. Na caixa Nome do Mapa, digite o nome de um mapa de dados do PowerExchange que você definiu. O tamanho máximo é de 10 caracteres na caixa Esquema, 10 caracteres na caixa Nome do Mapa e 128 caracteres na caixa Tabela. Em qualquer caixa de filtro, você pode usar os seguintes caracteres curinga: Asterisco (*) representa um ou mais caracteres de correspondência. Ponto de interrogação (?) representa um único caractere de correspondência. Manter Capitalização Por padrão, o texto digitado em qualquer uma das caixas de filtro é convertido para a capitalização padrão para a fonte de dados. Por exemplo, no Oracle, letras maiúsculas são o padrão e, portanto, um valor de scott ou SCOTT produz o mesmo resultado: SCOTT Selecione a opção Manter Capitalização para os filtros para os quais você não deseja que o PowerExchange use a capitalização padrão para a fonte de dados. Comentários Comentários para a tabela. Extensões Avançado Retorna metadados estendidos, se apropriado para o tipo de fonte de dados selecionado. Disponível para os tipos de fontes de dados CAPX, CAPXRT, DB2390IMG, IMSUNLD e IMS NRDB. Clique em Avançado para exibir a caixa de diálogo Parâmetros Avançados. Nesta caixa de diálogo, você pode inserir valores de parâmetro que substituem determinadas configurações em arquivos de configuração, mapas de dados e mapas de extração do PowerExchange. Aplicativo Obrigatório para os tipos de fonte de dados CAPX e CAPXRT. O nome do aplicativo. Caixa de Diálogo Teste de Linha de Banco de Dados 217

235 Um valor válido é uma sequência de caracteres de 1 a 20 caracteres. Caractere de Escape Digite o caractere de escape a ser usado para delimitar um asterisco (*) ou um ponto de interrogação (?) que é usado como um valor literal em vez de como um caractere curinga nas caixas de filtro Metadados. Por exemplo, se você especificar um caractere de escape de ~, um valor de filtro de tab* retornará todas as tabelas que começam com tab. Um valor de filtro de tab~* retorna a tabela denominada tab*. Nota: Não use um caractere de escape com fontes de dados ativadas por multibyte. Obter as Próximas n Linhas Indica quantas linhas devem ser obtidas na próxima solicitação. Nota: Recuperar grandes quantidades de dados pode reduzir o desempenho. Os valores válidos vão de 1 a 999. O padrão é 10. TÓPICOS RELACIONADOS: Caixa de Diálogo Parâmetros Avançados de CAPX na página 218 Caixa de Diálogo Parâmetros Avançados de CAPXRT na página 219 Caixa de Diálogo Parâmetros Avançados de DB2390IMG na página 223 Caixa de Diálogo Parâmetros Avançados (IMS) na página 223 Nomes de Mapas de Dados na página 30 Caixa de Diálogo Parâmetros Avançados de CAPX Digite informações para definir os parâmetros avançados de CAPX em um teste de linha de banco de dados. Tipo de Extração O tipo de extração. As opções são: SL. Inicia a extração do ponto em que a última extração foi encerrada, seja por tokens de reinicialização para z/os ou por carimbos de data/hora do ponto de verificação para i5/os. RS. Reinicia a extração do ponto de início da última extração. Essa opção permite que você execute a mesma extração várias vezes. O padrão é RS. Tipo de Imagem O tipo de imagem de captura. As opções são: BA. Captura os dados da pré-imagem, antes da última mudança, e os dados da pós-imagem, depois da última mudança. Os dados da pré-imagem são enviados com um caractere de ação forçando a exclusão do registro. Os dados da pós-imagem, que inclui os dados alterados, estão no formato de uma operação de inserção. AI. Captura os dados da pós-imagem. 218 Capítulo 8: Teste de Linha de Banco de Dados

236 TU. Captura os dados da pré e pós-imagem, conforme eles ocorrem. Os dados da pré-imagem permitem que o aplicativo verifique se nenhuma mudança ocorreu no registro desde a solicitação. Os dados da pós-imagem são exibidos como uma operação de atualização. A atualização é uma imagem completa, mas o aplicativo que captura essa mudança pode alterar o registro de destino em vez de excluí-lo e digitar um novo registro, como ocorre com BA. O padrão é AI. Tempo de espera O tempo máximo em segundos para esperar os dados antes de retornar Final de Arquivo (EOF). Os valores válidos vão de 0 a As opções são: 0. EOF é retornado quando o final do log atual é atingido. O final do log é determinado no início do processo de extração, pois o ponto final real é constantemente alterado. 2 a O número de segundos para esperar os dados antes de retornar EOF EOF nunca é retornado. A tarefa espera para sempre. O padrão é 15. Atualização sem Progresso Indica se deve adicionar a saída de teste de linha de banco de dados à trilha de auditoria do CDC do PowerExchange para o aplicativo. As opções são: Selecione essa opção para omitir a saída de teste de linha de banco de dados da trilha de auditoria do CDC do PowerExchange. Limpe essa opção para incluir a saída de teste de linha de banco de dados na trilha de auditoria do CDC do PowerExchange. O padrão é selecionado. Instância AS400 Substitui o nome da instância do banco de dados DB2 para i5/os. Esquema de Extração Substitui o esquema especificado no mapa de extração. Caixa de Diálogo Parâmetros Avançados de CAPXRT Na caixa de diálogo Parâmetros Avançados CAPXRT, você pode definir substituições para testar o acesso a dados alterados em tempo real. Tipo de Extração O tipo de extração. Selecione uma das seguintes opções: RS. Reinicia a extração do ponto de início da última extração. Essa opção permite que você execute a mesma extração várias vezes. SL. Inicia a extração do ponto em que a última extração foi encerrada, seja por tokens de reinicialização para z/os ou por carimbos de data/hora do ponto de verificação para i5/os. Caixa de Diálogo Parâmetros Avançados de CAPXRT 219

237 O padrão é RS. Tipo de Imagem O tipo de imagem de captura. Selecione uma das seguintes opções: AI. Captura os dados da pós-imagem. BA. Captura os dados da pré-imagem, antes da última alteração. Além disso, captura os dados da pós-imagem, após a última alteração. Os dados da pré-imagem são enviados com um caractere de ação forçando a exclusão do registro. Os dados da pós-imagem, que inclui os dados alterados, estão no formato de uma operação de inserção. TU. Captura os dados da pré e pós-imagem, conforme eles ocorrem. Os dados da pré-imagem permitem que o aplicativo verifique se nenhuma mudança ocorreu no registro desde a solicitação. Os dados da pós-imagem são exibidos como uma operação de atualização. A atualização é uma imagem completa, mas o aplicativo que captura essa mudança pode alterar o registro de destino em vez de excluí-lo e digitar um novo registro, como ocorre com BA. O padrão é AI. Tempo de espera O tempo máximo em segundos para esperar os dados antes de retornar Final de Arquivo (EOF). Os valores válidos vão de 0 a Insira um dos seguintes valores: 0. EOF é retornado quando o final do log atual é atingido. O final do log é determinado no início do processo de extração, pois o ponto final real é constantemente alterado. Um número de 2 a O número de segundos para esperar os dados antes de retornar EOF EOF nunca é retornado. A tarefa espera para sempre. O padrão é 15. Atualização sem Progresso Indica se é necessário adicionar a saída de teste de linha de banco de dados à trilha de auditoria do CDC do PowerExchange para o aplicativo. Selecione essa opção para omitir a saída de teste de linha de banco de dados da trilha de auditoria do CDC do PowerExchange. Desmarque essa opção para incluir a saída de teste de linha de banco de dados na trilha de auditoria do CDC do PowerExchange. Por padrão, essa opção é selecionada. Biblioteca/Diário AS400 Substitui o nome completo de biblioteca e do diário que você especificar no registro de captura do PowerExchange. Por exemplo: Instância Oracle STQA/NEWJOURNAL Substitui o valor da instância Oracle no segundo parâmetro posicional na instrução ORACLEID no arquivo de configuração dbmover.cfg. Por exemplo: ORACLEID=(coll_id,oracle_sid,connect_string,cap_connect_string) 220 Capítulo 8: Teste de Linha de Banco de Dados

238 Usado juntamente com o valor Sequência de Caracteres de Conexão Oracle para permitir o uso de um único conjunto de registros de captura para capturar dados de várias instâncias Oracle. Se você especificar um valor Instância Oracle, mas nenhum valor Sequência de Caracteres de Conexão Oracle, a captura Oracle usará o valor da sequência de caracteres de conexão Oracle que você definir na instrução ORACLEID no arquivo dbmover.cfg. Sequência de Caracteres de Conexão Oracle Substitui o valor da sequência de caracteres de conexão Oracle no terceiro parâmetro posicional na instrução ORACLEID no arquivo de configuração dbmover.cfg. Por exemplo: ORACLEID=(coll_id,oracle_sid,connect_string,cap_connect_string) Usado juntamente com o valor Instância Oracle para permitir o uso de um único conjunto de registros de captura para capturar dados de várias instâncias Oracle. Se você especificar um valor Sequência de Caracteres de Conexão Oracle, mas nenhum valor Instância Oracle, a captura Oracle usará o valor da sequência de caracteres de conexão Oracle que você definir na instrução ORACLEID no arquivo dbmover.cfg. Esquema Oracle Substitui o valor do esquema Oracle no grupo de registro do PowerExchange para permitir o uso de um único conjunto de registros de captura para capturar dados de vários esquemas que podem existir em uma instância Oracle. IDMS LOGSID Não use. Banco de Dados UDB DB2 Para DB2 para Linux, UNIX e Windows. Substitui o valor de conexão de banco de dados que você especificar no mapa de extração do PowerExchange. Nome de Conexão CAPI Substitui a conexão de banco de dados padrão que você definiu em uma instrução CAPI_CONNECTION no arquivo de configuração DBMOVER. Para apontar para a fonte de dados relevante, use o valor que você definiu no parâmetro NAME da instrução CAPI_CONNECTION no arquivo de configuração DBMOVER. Necessário quando várias instruções de conexão CAPI são incluídas no arquivo de configuração DBMOVER. Esquema de Extração Substitui o esquema de extração no mapa de extração. Senha do arquivo ADABAS A senha do FTD Adabas. Necessário se o FTD Adabas estiver protegido por senha no Adabas. MSS LUW DBId Se você usar o Agente de Log do PowerExchange para Linux, UNIX e Windows no modo de extração contínua e capturar dados de um banco de dados de distribuição do Microsoft SQL Server para artigos em vários bancos de dados de publicação, digite o valor do parâmetro DBID especificado no arquivo de configuração do Agente de Log do PowerExchange, pwxccl. Esse valor DBID identifica o conjunto de registros que será usado para processamento de teste de linha. Se esse valor não for especificado, o teste de linha falhará. Caixa de Diálogo Parâmetros Avançados de CAPXRT 221

239 Localização do Mapa de Extração Se você estiver extraindo dados alterados no modo de extração contínuo dos arquivos de log do Agente de Log do PowerExchange para Linux, UNIX e Windows que são remotos dos mapas de extração na fonte de dados, digite o nome do nó do sistema no qual os mapas de extração estão localizados. Você deve definir esse nó em uma instrução NODE no arquivo dbmover.cfg no qual o Agente de Log do PowerExchange para Linux, UNIX e Windows é executado. Geralmente, esse nome de nó é aquele que você definiu no parâmetro CAPTURE_NODE no arquivo de configuração pwxccl.cfg. Por exemplo, se um processo do Agente de Log do PowerExchange para Linux, UNIX e Windows capturar dados alterados de uma origem IMS remota em um sistema z/os, especifique o nome do nó para o sistema z/os. Identificação de Usuário Senha O ID do usuário usado para autorizar o acesso do Agente de Log do PowerExchange para Linux, UNIX e Windows aos mapas de extração no nó remoto selecionado na lista Localização. A necessidade da Identificação de Usuário depende da definição SECURITY no arquivo de configuração DBMOVER na localização remota. Essa Identificação de Usuário pode ser uma Identificação de Usuário do sistema operacional ou uma Identificação de banco de dados, dependendo do tipo de fonte de dados. Geralmente, essa Identificação de Usuário é aquela que você definiu no parâmetro CAPTURE_NODE_UID no arquivo de configuração pwxccl.cfg. Uma senha de texto simples para o ID do usuário especificada na caixa UserID. Normalmente, este valor corresponde ao valor do parâmetro CAPTURE_NODE_PWD no arquivo de configuração pwxccl.cfg. Se você estiver usando o Agente de Log do PowerExchange para acessar mapas de extração que estão em um nó i5/os ou z/os remoto, você poderá inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/os pode ter de 9 a 31 caracteres de comprimento. Um código de acesso do z/os pode ter de 9 a 128 caracteres de comprimento. Um código de acesso pode conter os seguintes caracteres: Letras em maiúsculas e minúsculas Os números de 0 a 9 Espaços Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. No z/os, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no Manual de Referência do PowerExchange. 222 Capítulo 8: Teste de Linha de Banco de Dados

240 Caixa de Diálogo Parâmetros Avançados de DB2390IMG O método de acesso DB2390IMG cria um mapa de dados dinamicamente como parte de seu processamento. Digite um nome de esquema e nome de mapa de dados para o mapa de dados. O PowerExchange constrói o nome do mapa de dados do nome do esquema e do nome do mapa. Por exemplo: schema_name.data_map_name.dmp Digite informações para definir os parâmetros avançados de DB2390IMG em um teste de linha de banco de dados. Nome do esquema Nome do esquema para o mapa de dados. Deve iniciar com um caractere alfabético. Tamanho máximo de dez bytes. Nome do Mapa de Dados Nome do mapa para o mapa de dados. Deve iniciar com um caractere alfabético. Tamanho máximo de dez bytes. Caixa de Diálogo Parâmetros Avançados (IMS) Insira as substituições de um teste de linha de banco de dados de um mapa de dados IMS que use o método de acesso DL/1 BATCH ou IMS ODBA, ou que acesse uma origem de arquivo de descarregamento do IMS. Você pode substituir o método de acesso e as propriedades relacionadas. Método de Acesso Para substituir o método de acesso especificado no mapa de dados, selecione uma das seguintes opções: DL/1 BATCH. Se o mapa de dados especificar o método de acesso IMS ODBA, selecione essa opção para usar o acesso em lotes DL/I ou BMP a dados IMS do teste de linha de banco de dados. Além disso, defina o valor Localização na caixa de diálogo Teste de Linha de Banco de Dados para apontar para o nó no qual o trabalho netport é executado. IMS ODBA. Se o mapa de dados especificar o método de acesso DL/1 BATCH, selecione esta opção para usar o acesso IMS ODBA a dados IMS do teste de linha de banco de dados. Além disso, defina o valor Localização na caixa de diálogo Teste de Linha de Banco de Dados para apontar para o nó no qual o Ouvinte do PowerExchange é executado. Por padrão, o método de acesso do mapa de dados é exibido inicialmente. Para substitui-lo, selecione outro método de acesso disponível na lista. Caixa de Diálogo Parâmetros Avançados de DB2390IMG 223

241 IMS SSID Se você selecionar a linha em branco na lista, o teste de linha de banco de dados usa o método de acesso do mapa de dados. Você ainda pode inserir qualquer uma das outras substituições nessa caixa de diálogo que forem válidas para tal método de acesso. Se você alterar o método de acesso sem alterar também o valor Localização, o PowerExchange emite uma das seguintes mensagens de erro: Para acesso DL/1: PWX Incorrect environment for DL1 execution. Check NETPORT for server job or executable for client. Para acesso ODBA: PWX ODBA "ALLOCATE" Call Failed RC= Reason= Importante: Se você alternar o método de acesso, verifique se configurou o PowerExchange para usar o novo método de acesso. Para obter mais informações, consulte Configurando Acesso em Lotes DL/I ou BMP a Dados IMS na página 102 e Configurando o acesso IMS ODBA a dados do IMS na página 103. Se você estiver testando um mapa de dados IMS ODBA e não substituir o método de acesso, use este valor para substituir o ID do subsistema IMS (SSID) do mapa de dados. Se você especificou o acesso IMS ODBA como uma substituição no campo Método de Acesso, será necessário inserir esse valor. Um SSID é necessário para acesso ODBA. Se você estiver testando um mapa de dados com uma origem de arquivo de descarregamento do IMS, use essa substituição para apontar para outra instrução IMSID no membro DBMOVER para fins de alteração de uma biblioteca DBD para outra biblioteca DBD. Por exemplo, se você tiver um mapa de dados DL/I, mas desejar executar o teste de linha em um arquivo de descarregamento do IMS para reduzir consultas ao banco de dados, insira o tipo de banco de dados IMSUNLD, a localização do arquivo de descarregamento e o nome do arquivo de descarregamento na caixa de diálogo Teste de Linha de Banco de Dados. Em seguida, insira nesse campo o SSID do IMS associado à instrução IMSID que inclui a biblioteca DBD que você deseja usar no arquivo de descarregamento do IMS. Se você estiver testando um mapa de dados de um tipo de banco de dados NRDB e usando um trabalho netport BMP, será possível usar essa substituição com a variável de substituição %IMSID da JCL netport. Essa substituição substitui a variável de substituição para especificar qual SSID do IMS será usado no teste de linha. Ao usar a substituição com a variável de substituição, você pode usar a mesma JCL netport para acessar vários ambientes IMS, como ambientes de desenvolvimento, teste e produção. Nota: Um SSID do IMS não é necessário para acesso ao lote DL/I a dados IMS ou para acessar um arquivo de descarregamento do IMS. Nome do PSB Insira uma substituição de nome de PSB do IMS. Se você estiver testando um mapa de dados ODBA e não substituir o método de acesso, esse valor substituirá o nome do PSB do mapa de dados. Se você especificou IMS ODBA como uma substituição no campo Método de Acesso, será necessário inserir esse valor. Um nome do PSB é necessário para acesso ODBA. Ao usar substituição, você pode usar o mesmo mapa de dados para testar o acesso a diferentes PSBs. Se você estiver testando um mapa de dados em lotes DL/I ou BMP e tiver especificado a variável de substituição PSB=%PSBNAME na JCL netport, esse valor substituirá o nome do PSB na JCL. Se você especificou a variável de substituição PSB=%1 em vez de %PSBNAME na JCL netport, o teste de linha usa o nome do PSB na instrução NETPORT, se especificado. A Informatica recomenda usar essa 224 Capítulo 8: Teste de Linha de Banco de Dados

242 substituição com a variável de substituição %PSBNAME para evitar a edição ou a adição das instruções NETPORT e o reinício do Ouvinte do PowerExchange. Nota: Um nome do PSB não é usado para acessar um arquivo de descarregamento do IMS (tipo de banco de dados IMSUNLD). Número do PCB Insira um número do PCB. Esse campo está disponível somente para acesso DL/I ou BMP aos dados IMS. Se você estiver testando um mapa de dados em lotes DL/I ou BMP e não tiver substituído o método de acesso, esse valor substituirá o número do PCB do mapa de dados. Se você especificou DL/1 BATCH como uma substituição no campo Método de Acesso, será necessário inserir esse valor. Um número do PCB é necessário para acesso DL/I ou BMP. Nota: Um número do PCB não é usado para acesso ODBA ou para acessar um arquivo de descarregamento do IMS (tipo de banco de dados IMSUNLD). Nome do PCB Insira uma substituição do nome do PCB IMS. O nome do PCB está disponível somente para acesso ODBA aos dados IMS. Se você estiver testando um mapa de dados IMS ODBA da origem e não tiver substituído o método de acesso, esse valor substituirá o nome do PCB do mapa de dados. Se você especificou IMS ODBA como uma substituição no campo Método de Acesso, será necessário inserir esse valor. Um nome do PCB é necessário para acesso ODBA. Nota: Um nome do PCB não é usado para acesso em lotes DL/I ou BMP, ou para acessar um arquivo de descarregamento do IMS (tipo de banco de dados IMSUNLD). Caixa de Diálogo Parâmetros Avançados (IMS) 225

243 C A P Í T U L O 9 Exemplos do Navegador do PowerExchange Este capítulo inclui os seguintes tópicos: Visão Geral de Exemplos do Navegador do PowerExchange, 226 Adicionando um Mapa de Dados de Registro Único - Exemplo, 227 Adicionando um Mapa de Dados de Registro Único com um Array - Exemplo, 231 Adicionando um Mapa de Dados de Vários Registros com uma Tabela Complexa - Exemplo, 233 Importando um Copybook COBOL para um Mapa de Dados - Exemplo, 236 Importando um Copybook COBOL com Instruções REDEFINES - Exemplo, 240 Importando um Copybook PL/I - Exemplo, 244 Definindo Propriedades da Tabela em um Mapa de Dados para Normalizar um Array - Exemplo, 247 Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo, 251 Visão Geral de Exemplos do Navegador do PowerExchange O PowerExchange apresenta exemplos de mapas de dados, copybooks e arquivos de dados que você pode usar para aprender como criar mapas de dados. Além disso, o PowerExchange apresenta os seguintes exemplos de tipos de programas gravados em Assembler, C e PL/I: Programas do método de acesso do usuário, denominados uam*.* Programas de saída do nível de registro, denominados urle*.* Programas chamados usando a função CallProg, denominados ucpe*.* Exemplos de arquivos de cabeçalho e JCL são apresentados para esses programas. Os exemplos de arquivos estão localizados no subdiretório de exemplos no diretório de instalação do PowerExchange no Windows. Por exemplo: C:\Informatica\PowerExchangen.n.n\examples\ 226

244 Nessa seção, você usa os exemplos de arquivos para criar os seguintes tipos de mapas de dados: Mapa de dados de registro único Mapa de dados de registro único que contém arrays Mapa de dados de vários registros com tabelas complexas Mapa de dados com um copybook COBOL importado Mapa de dados com um copybook COBOL importado com instruções REDEFINES Mapa de dados com um copybook PL/I importado com várias definições para um campo Mapa de dados que normaliza um campo definido como array com várias ocorrências Mapa de dados com campos definidos pelo usuário que usa a função CallProg do PowerExchange para chamar um programa de saída do usuário que retorna o tipo de classe de um campo no registro do mapa de dados Adicionando um Mapa de Dados de Registro Único - Exemplo Nesse exemplo, você cria um mapa de dados de registro único. Este exemplo mostra como executar as seguintes tarefas: 1. Adicionar um mapa de dados. 2. Adicionar um registro ao mapa de dados. 3. Adicionar campos ao registro do mapa de dados. 4. Adicionar uma tabela ao mapa de dados. 5. Testar o mapa de dados de registro único. Esse exemplo usa o arquivo de dados demo1.dat. Etapa 1. Adicionar um Mapa de Dados Crie o mapa de dados demo.map1 usando o exemplo de arquivo demo1.dat. 1. Na guia Recursos do Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Na caixa de diálogo Nome, digite as informações necessárias. A tabela a seguir descreve as informações necessárias: Opção Nome do Esquema Nome do Mapa de Dados Método de Acesso Importar Definições de Registro Descrição Digite demo. Digite map1. Selecione SEQ. Desmarque essa opção. Você especificará as definições de registro depois. Adicionando um Mapa de Dados de Registro Único - Exemplo 227

245 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso SEQ, digite as informações necessárias. A tabela a seguir descreve as informações necessárias: Opção Nome do Arquivo Separador de Campo Descrição Clique no botão Procurar para navegar para o arquivo demo1.dat no diretório de exemplos. Selecione essa opção e digite vírgula (,) como o caractere separador. Se não puder inserir o caractere separador usando o teclado, digite sua representação hexadecimal como: x'nn'. Como o arquivo de dados demo1.dat é um arquivo separado por caracteres, você não precisará fornecer o caractere separador. 5. Clique em Concluir. O mapa de dados demo.map1 é exibido na guia Mapa de Dados no Explorador de Recursos. TÓPICOS RELACIONADOS: Adicionando um Mapa de Dados na página 43 Etapa 2. Adicionar um Registro ao Mapa de Dados Adicione o registro record1 ao mapa de dados demo.map1. 1. Na guia Mapa de Dados no Explorador de Recursos, clique com o botão direito do mouse em demo.map1 e clique em Adicionar Registro. A caixa de diálogo Adicionar Registro é exibida. 2. Na caixa Nome do Registro, digite record1. 3. Clique em OK. O registro record1 é exibido na janela Registro. TÓPICOS RELACIONADOS: Adicionando um Registro de Mapa de Dados na página 47 Etapa 3. Adicionar Campos ao Registro do Mapa de Dados Adicione os campos no. de sequência, nome e gênero ao registro record1 no mapa de dados demo.map1. 1. Na guia Mapa de Dados no Explorador de Recursos, clique em record1. 2. Clique em Adicionar > Campo. 3. Na caixa de diálogo Adicionar Campo, insira as informações sobre o campo. A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Campo Descrição Digite no. de sequência. 228 Capítulo 9: Exemplos do Navegador do PowerExchange

246 Opção Tipo de Campo Descrição Selecione NUMCHAR. Precisão Digite 2. Escala Digite 0. Tamanho Digite 2. O campo Tamanho indica o tamanho máximo da entrada de dados, permitindo espaços em branco à esquerda ou outros caracteres. O valor do tamanho deve ser igual ou maior que o valor da precisão. 4. Clique em OK. A janela Registro exibe o campo no. de sequência. 5. Na janela Registro, clique em record1. 6. Clique em Adicionar > Campo. 7. Na caixa de diálogo Adicionar Campo, insira as informações sobre o campo. A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Campo Tipo de Campo Descrição Digite nome. Selecione CHAR. Tamanho Digite Clique em OK. A janela Registro exibe o campo nome. 9. Na guia Mapa de Dados, clique em record Clique em Adicionar > Campo. 11. Na caixa de diálogo Adicionar Campo, insira as informações sobre o campo. A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Campo Tipo de Campo Descrição Digite gênero. Selecione CHAR. Tamanho Digite Clique em OK. A janela Registro exibe o campo gênero. Adicionando um Mapa de Dados de Registro Único - Exemplo 229

247 TÓPICOS RELACIONADOS: Adicionando um Campo a um Registro na página 47 Etapa 4. Adicionar uma Tabela ao Mapa de Dados Adicione a tabela table1 ao mapa de dados demo.map1. As colunas na tabela table1 são baseadas nos campos no registro record1. 1. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse em demo.map1 e clique em Adicionar Tabela. 2. Na caixa de diálogo Adicionar Tabela, insira as informações sobre a tabela. A tabela a seguir descreve as informações a serem inseridas: Opção Nome da Tabela Dependências do Registro Apenas Grupos e Arrays Como você deseja gerenciar várias instâncias de registros selecionados Descrição Digite table1. Verifique se o registro record1 é exibido. Selecione essa opção. Essa opção faz com que os campos definidos como um campo de grupo, ou qualquer array, sejam exibidos. Se você desmarcar essa opção, todos os campos do registro serão exibidos. Selecione Nova Linha. Essa opção faz com que uma nova linha seja criada para cada instância do registro. 3. Clique em OK. A janela Tabela exibe a tabela table1, que contém colunas baseadas nos campos que você adicionou ao registro record1. TÓPICOS RELACIONADOS: Adicionando uma Tabela de Mapa de Dados na página 57 Etapa 5. Testar o Mapa de Dados de Registro Único Execute um teste de linha de banco de dados no mapa de dados demo.map1. Você acessa o mapa de dados localmente. 1. Na janela Tabela, selecione table1. 2. Clique em Arquivo > Teste de Linha de Banco de Dados. 3. Na caixa de mensagem que solicita que você envie o mapa de dados para uma localização remota, clique em Sim. 4. Na caixa de diálogo Nó Remoto do Mapa de Dados, clique em local na lista Local. 5. Clique em OK. 6. Na caixa de diálogo Teste de Linha de Banco de Dados, clique em Ir. A janela Saída do Teste de Linha de Banco de Dados exibe a saída. 230 Capítulo 9: Exemplos do Navegador do PowerExchange

248 TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Adicionando um Mapa de Dados de Registro Único com um Array - Exemplo Neste exemplo, você adiciona um mapa de dados de registro único usando um arquivo de dados que contém vários tipos de registro. Você define opções para uma tabela controlar o modo como o PowerExchange exibirá saídas de registros que contêm arrays. Este exemplo mostra como executar as seguintes tarefas: 1. Associar um arquivo de dados a um mapa de dados. 2. Filtrar os dados no mapa de dados. 3. Criar uma linha de saída para cada elemento de um array. 4. Criar uma linha de saída para todos os elementos de um array. Esse exemplo usa os arquivos demo.map2.dmp e demo2.dat. Etapa 1. Associar um Arquivo de Dados a um Mapa de Dados Associe um arquivo de dados a um mapa de dados. 1. Na guia Recursos no Explorador de Recursos, dê um clique duplo em demo.map2. 2. Na guia Mapa de Dados, clique com o botão direito do mouse em demo.map2 e clique em Propriedades. A caixa de diálogo Propriedades do Mapa de Dados é exibida. 3. Na guia Método de Acesso SEQ, clique no botão Procurar para navegar até o arquivo demo2.dat no diretório de exemplos. 4. Clique em OK. 5. Clique em OK. TÓPICOS RELACIONADOS: Arquivos de Dados e Processamento de Lista de Arquivos na página 32 Etapa 2. Filtrar os Dados no Mapa de Dados As identificações de registro fornecem um mecanismo de filtragem em tempo de execução. Com isso, as instruções SQL não precisam selecionar os registros desejados. 1. Na guia Mapa de Dados no Explorador de Recursos, clique em record1. 2. Na janela Registro, clique com o botão direito do mouse no campo rectype e clique em Propriedades. A caixa de diálogo Propriedades do Campo é exibida. Adicionando um Mapa de Dados de Registro Único com um Array - Exemplo 231

249 3. Na lista Valores de Identificação de Registro, clique no botão = ou <> para selecionar os operadores para a filtragem dos dados. As identificações de registro 10 e 20 combinadas com a configuração do operador determinam que dados são exibidos. Execute uma das seguintes ações: Clique no botão = para exibir registros com um valor de ID de registro igual a 10 ou 20. Na janela Saída do Teste de Linha de Banco de Dados, os registros com identificação diferente de 10 ou 20 não são exibidos. Clique no botão <> para exibir registros cujo valor de identificação seja maior ou menor que (mas não igual a) 10 ou 20. Nota: O mapa de dados armazena os IDs de registro, mas não os dados. Os campos de ID de registro podem não aparecer na exibição da coluna dos dados. Você não pode usar a filtragem do ID de registro em WRITE. 4. Clique em OK. Etapa 3. Criar uma Linha de Saída para Cada Elemento de um Array Crie uma linha de saída para cada elemento de um array. 1. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse na tabela row_out e clique em Propriedades. A caixa de diálogo Propriedades da Tabela é exibida. 2. Na caixa de diálogo Propriedades da Tabela, selecione as opções para criar uma linha de saída para cada elemento na matriz. A tabela a seguir descreve essas opções: Opção Descrição Campos Campos Como você deseja gerenciar várias instâncias de registros selecionados Selecione Apenas Grupos e Arrays. Essa opção exibe na lista campos definidos como campos de grupo ou de array. Selecione o campo de itens. Nessa lista, você pode selecionar campos definidos como grupos ou arrays. Selecione Nova Linha. Essa opção faz com que cada ocorrência dos dados do campo de itens seja exibida em sua própria linha. 3. Clique em OK. 4. Na guia Mapa de Dados, clique duas vezes na tabela row_out para abrir a caixa de diálogo Propriedades da Tabela. A coluna items_l é exibida em turquesa, o que indica que ela faz parte de um array. 5. Para testar o mapa de dados, execute um teste de linha de banco de dados. Acesse o mapa de dados localmente e clique em NRDB na lista Tipo de DB da caixa de diálogo Teste de Linha de Banco de Dados. A janela Saída do Teste de Linha de Banco de Dados exibe várias linhas de saída de um único registro de entrada de dados, dependendo do número de elementos no array. 232 Capítulo 9: Exemplos do Navegador do PowerExchange

250 TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Definindo Propriedades de Array na Caixa de Diálogo Propriedades da Tabela na página 37 Etapa 4. Criar uma Linha de Saída para Todos os Elementos de um Array Crie uma única linha de saída para um registro que contém um array. Todos os elementos no array são exibidos em uma única linha. 1. Na caixa de diálogo Propriedades da Tabela da tabela row_out, selecione as opções para criar uma linha de saída para todos os elementos na matriz. A tabela a seguir descreve essas opções: Opção Campos Como você deseja gerenciar várias instâncias de registros selecionados Descrição Limpe o campo itens. Selecione Array. Array Selecione 1. Nova Linha no Overflow Selecione essa opção. O PowerExchange preenche a linha de saída até que ela esteja completa e, em seguida, exibe uma nova linha com os registros do overflow. 2. Clique em OK. 3. Para testar o mapa de dados, execute um teste de linha de banco de dados. Acesse o mapa de dados localmente e selecione NRDB na lista Tipo de DB da caixa de diálogo Teste de Linha de Banco de Dados. Na janela Saída do Teste de Linha de Banco de Dados, é exibida uma linha para cada registro. Todos os elementos do array em um registro são exibidos em uma única linha. TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Definindo Propriedades de Array na Caixa de Diálogo Propriedades da Tabela na página 37 Adicionando um Mapa de Dados de Vários Registros com uma Tabela Complexa - Exemplo Nesse exemplo, você define uma tabela complexa com um relacionamento hierárquico entre registros de tipos diferentes. Este exemplo ilustra os seguintes conceitos: Uma tabela de mapa de dados pode ter vários registros de mapa de dados associados a ela. Você pode definir um relacionamento hierárquico entre os registros. Adicionando um Mapa de Dados de Vários Registros com uma Tabela Complexa - Exemplo 233

251 Este exemplo mostra como executar as seguintes tarefas: 1. Associar um arquivo de dados a um mapa de dados de vários registros. 2. Exibir registros de mapa de dados de vários registros. 3. Definir a hierarquia de registros de mapa de dados de vários registros. 4. Testar o mapa de dados de vários registros. Esse exemplo usa os arquivos demo.map3.dmp e demo3.dat. Etapa 1. Associar um Arquivo de Dados a um Mapa de Dados de Vários Registros Associe um arquivo de dados a um mapa de dados de vários registros. 1. Na guia Recursos do Explorador de Recursos, clique duas vezes no mapa de dados demo.map3. 2. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse em demo.map3 e clique em Propriedades. A caixa de diálogo Propriedades do Mapa de Dados é exibida. 3. Na guia Método de Acesso SEQ, clique no botão Procurar para navegar até o arquivo demo3.dat no diretório de exemplos. 4. Clique em OK. 5. Clique em OK. TÓPICOS RELACIONADOS: Arquivos de Dados e Processamento de Lista de Arquivos na página 32 Etapa 2. Exibir Registros em um Mapa de Dados de Vários Registros As identificações de registro identificam vários registros em um arquivo simples. O primeiro caractere de cada linha do arquivo demo3.dat, que o mapa de dados demo.map3 define como o campo rectype, distingue o registro rec1 do registro rec2. 1. Na guia Recursos no Explorador de Recursos, dê um clique duplo em demo.map3. 2. Na guia Mapa de Dados no Explorador de Recursos, clique no registro rec1. 3. Na janela Registro - rec1, dê um clique duplo no campo rectype. A caixa Valores do ID de Registro indica que o ID de registro para o campo rectype é Na guia Mapa de Dados no Explorador de Recursos, clique no registro rec2. 5. Na janela Registro - rec2, dê um clique duplo no campo rectype. A caixa Valores do ID de Registro indica que o ID de registro para o campo rectype é 2. Etapa 3. Definir uma Hierarquia de Registros em um Mapa de Dados de Vários Registros Define um relacionamento hierárquico entre os registros rec1 e rec2 para refletir a hierarquia real na fonte de dados. 234 Capítulo 9: Exemplos do Navegador do PowerExchange

252 1. Na guia Mapa de Dados DO Explorador de Recursos, clique com o botão direito do mouse na tabela row_out e clique em Propriedades. A lista Dependências do Registro exibe a hierarquia entre os registros rec1 e rec2. 2. Para excluir essa hierarquia, na lista Dependências do Registro, clique com o botão direito do mouse em rec2 e clique em Excluir. Essa ação move o registro rec2 para a lista Registros Disponíveis. 3. Na lista Dependências do Registro, clique com o botão direito do mouse em rec1 e clique em Excluir. Essa ação move o registro rec1 para a lista Registros Disponíveis. 4. Para redefinir a hierarquia, na lista Registros Disponíveis, clique com o botão direito do mouse em rec1 e clique em Adicionar Registro. Essa ação move o registro rec1 para a lista Dependências do Registro. Para esse registro, a opção Como você deseja gerenciar várias instâncias do registro selecionado é definida como Nova Linha. 5. Na lista Registros Disponíveis, clique com o botão direito do mouse em rec2 e clique em Adicionar Registro como Filho. Essa ação move o registro rec2 para a lista Dependências do Registro como um registro filho do registro pai rec1. Para esse registro, a opção Como você deseja gerenciar várias instâncias do registro selecionado é definida como Nova Linha. 6. Clique em OK. Na janela Tabela, a coluna de nome é baseada no campo de nome do registro rec1 e a coluna de endereço é baseada no campo de endereço no registro rec2. O nome para cada coluna na tabela é prefixado com o nome do registro no qual a coluna é baseada. Etapa 4. Testar um Mapa de Dados de Vários Registros Execute um teste de linha de banco de dados em um mapa de dados de vários registros. Você acessa o mapa de dados localmente. 1. Na guia Mapa de Dados no Explorador de Recursos, clique em row_out. 2. Clique em Arquivo > Teste de Linha de Banco de Dados. 3. Na caixa de mensagem que solicita que você envie o mapa de dados para uma localização remota, clique em Sim. 4. Na caixa de diálogo Nó Remoto do Mapa de Dados, selecione local na lista Local. 5. Clique em OK. 6. Na caixa de diálogo Teste de Linha de Banco de Dados, clique em Ir. Na janela Saída do Teste de Linha de Banco de Dados, a coluna de nome é preenchida com base no registro rec1 e a coluna de endereço é preenchida com base no registro rec2. Se você alterar a hierarquia na caixa de diálogo Propriedades da Tabela da tabela row_out para tornar o registro rec2 irmão do registro rec1, a saída na janela Saída do Teste de Linha de Banco de Dados será alterada. Adicionando um Mapa de Dados de Vários Registros com uma Tabela Complexa - Exemplo 235

253 TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Importando um Copybook COBOL para um Mapa de Dados - Exemplo Neste exemplo, você adiciona um mapa de dados de vários registros e importa um copybook COBOL para ele. Este exemplo mostra como executar as seguintes tarefas: 1. Adicione um mapa de dados e importe um copybook COBOL que contém uma cláusula OCCURS DEPENDING ON para o mapa de dados. Ao adicionar o mapa de dados, você usa um arquivo de dados de tamanho fixo. Depois de adicionar o mapa de dados, você cria uma exibição hierárquica do arquivo simples. 2. Aplique uma máscara de data a um campo em um registro de mapa de dados. 3. Use uma cláusula WHERE para filtrar um registro vazio da saída. 4. Exiba várias linhas de saída para itens em uma cláusula OCCURS DEPENDING ON: Esse exemplo usa os arquivos train3.dat e train3.cob. Etapa 1. Adicionar um Mapa de Dados e Importar um Copybook COBOL para o Mapa de Dados Adicione um mapa de dados para um arquivo simples sequencial e importe um copybook COBOL para o mapa de dados. 1. Na guia Recursos do Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Na caixa de diálogo Nome, digite informações sobre o mapa de dados. A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Esquema Nome do Mapa de Dados Método de Acesso Importar Definições de Registro Descrição Digite COBOL. Digite map2. Selecione SEQ. Selecione essa opção. 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso SEQ, digite informações sobre o arquivo de dados. 236 Capítulo 9: Exemplos do Navegador do PowerExchange

254 A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Arquivo Fixo Descrição Clique no botão Procurar para navegar até o arquivo train3.dat no diretório de exemplos. Selecione essa opção. Tamanho Digite Clique em Concluir. 6. Na caixa de diálogo Importar Copybook - Detalhes da Origem, digite as informações do copybook. A tabela a seguir descreve as informações a serem inseridas: Opção Fonte Tipo Descrição Selecione Local. Selecione COBOL. Início Digite 7. Término Digite Clique em Avançar. 8. Na caixa de diálogo Importar Copybook - Detalhes de Cobol Local, clique no botão Procurar para navegar até o arquivo train3.cob no diretório de exemplos. Nota: Para exibir o copybook, clique em Visualizar. 9. Clique em Avançar. 10. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, selecione as ações para registros, campos e tabelas importados e clique em Concluir. Para obter mais informações, consulte Caixa de Diálogo Importar Copybook - Detalhes de Configuração na página Na janela Informações de Importação do Copybook, consulte as informações para a importação e clique em OK. 12. Na caixa de diálogo Definição de Registro dos registros NAME_REC e ACCOUNT_REC, clique em OK. Para obter mais informações, consulte Caixas de Diálogo Definição de Registro e Definição de Registro Duplicado na página 141. A janela Importação Cobol exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. Nota: Para localizar a linha associada no copybook para um erro que aparece na janela Log de Mensagens do Copybook, dê um clique duplo na mensagem. 13. Feche a janela Importação Cobol. 14. Na guia Mapa de Dados do Explorador de Recursos, clique no registro NAME_REC. 15. Na janela Registro, clique com o botão direito do mouse no campo RECTYPE e clique em Propriedades. A guia Nome na caixa de diálogo Propriedades do Campo é exibida. Importando um Copybook COBOL para um Mapa de Dados - Exemplo 237

255 16. Na caixa Valores do ID de Registro, digite 01. Nota: Para exibir as propriedades originais para o campo do copybook importado, clique na guia Propriedades Extra. 17. Clique em OK. Na janela Registro, o ícone do campo RECTYPE é exibido em verde. 18. Na guia Mapa de Dados do Explorador de Recursos, clique no registro ACCOUNT_REC. 19. Na janela Registro, clique com o botão direito do mouse no campo RECTYPE e clique em Propriedades. A guia Nome na caixa de diálogo Propriedades do Campo é exibida. 20. Na caixa Valores do ID de Registro, digite Clique em OK. Na janela Registro, o ícone do campo RECTYPE é exibido em verde. 22. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse em COBOL.map2 e clique em Adicionar Tabela. 23. Na caixa de diálogo Adicionar Tabela, insira as informações sobre a tabela. A tabela a seguir descreve as informações a serem inseridas: Opção Nome da Tabela Registros Disponíveis Descrição Digite ambos. Clique com o botão direito do mouse no registro NAME_REC e clique em Adicionar Registro. Em seguida, clique com o botão direito do mouse no registro ACCOUNT_REC e clique em Adicionar Registro como Filho. 24. Clique em OK. 25. Para exibir a saída da tabela antes de aplicar uma máscara de data ao registro POLICY_DATE, execute um teste de linha de banco de dados. Na guia Mapa de Dados, no Explorador de Recursos, clique na tabela ambos e clique em Arquivo > Teste de Linha de Banco de Dados. 26. Na caixa de diálogo Teste de Linha de Banco de Dados, digite informações sobre o teste de linha de banco de dados. A tabela a seguir descreve as informações a serem inseridas: Opção Tipo de DB Local Descrição Selecione NRDB. Selecione local. 27. Clique em Ir. A janela Saída do Teste de Linha de Banco de Dados exibe a saída. 28. Feche as janelas Saída do Teste de Linha de Banco de Dados e Teste de Linha de Banco de Dados. 29. Feche as janelas Saída do Teste de Linha de Banco de Dados e Teste de Linha de Banco de Dados. 238 Capítulo 9: Exemplos do Navegador do PowerExchange

256 TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Importar Copybook - Caixa de Diálogo Detalhes do Local na página 133 Importar Copybook - Caixa de Diálogo Detalhes do Remoto na página 135 Etapa 2. Aplicar uma Máscara de Data a um Campo no Registro de Mapa de Dados Aplique uma máscara de data a um campo em um mapa de dados e exclua campos estranhos de uma tabela antes de executar um teste de linha de banco de dados. 1. Na janela Tabela da tabela ambos, clique com o botão direito do mouse nas seguintes colunas, uma de cada uma vez, e clique em Excluir: RECTYPE ACCOUNT_REC_ACCOUNT ACCOUNT_REC_RECTYPE Para cada registro, clique em OK na janela que solicita que você confirme a exclusão. 2. Na guia Mapa de Dados do Explorador de Recursos, clique no registro ACCOUNT_REC. 3. Na janela Registro, clique com o botão direito do mouse no campo POLICY_DATE e clique em Propriedades. 4. Na lista Formato do Campo, selecione Y2-MM-D2. 5. Clique em OK. 6. Na guia Mapa de Dados do Explorador de Recursos, clique na tabela ambos. 7. Clique em Arquivo > Teste de Linha de Banco de Dados. 8. Na caixa de diálogo Teste de Linha de Banco de Dados, digite informações sobre o teste de linha de banco de dados. A tabela a seguir descreve as informações a serem inseridas: Opção Tipo de DB Local Descrição Selecione NRDB. Selecione local. 9. Clique em Ir. Na janela Saída do Teste de Linha de Banco de Dados, a coluna POLICY_DATE inclui o século no formato de data. TÓPICOS RELACIONADOS: Etapa 3. Usar uma Cláusula WHERE para Filtrar um Registro Vazio da Saída na página 240 Testando um Mapa de Dados na página 205 Importando um Copybook COBOL para um Mapa de Dados - Exemplo 239

257 Etapa 3. Usar uma Cláusula WHERE para Filtrar um Registro Vazio da Saída Use uma cláusula WHERE para filtrar um registro vazio da saída na janela Saída do Teste de Linha de Banco de Dados. 1. Na caixa de diálogo Teste de Linha de Banco de Dados, digite a seguinte instrução na caixa Instrução SQL: select * from COBOL.map2.both where itemct > 0 2. Na caixa de diálogo Teste de Linha de Banco de Dados, clique em Ir. Na janela Saída do Teste de Linha de Banco de Dados, o quarto registro, que não contém itens, não aparece na saída. 3. Feche as janelas Saída do Teste de Linha de Banco de Dados e Teste de Linha de Banco de Dados. TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Etapa 4. Exibir Várias Linhas de Saída para Itens em uma Cláusula OCCURS DEPENDING ON Exiba várias linhas de saída na janela Saída do Teste de Linha de Banco de Dados para itens em uma cláusula OCCURS DEPENDING ON. 1. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse na tabela ambos e clique em Propriedades. 2. Na caixa de diálogo Propriedades da Tabela, marque a caixa de seleção ITEMS na lista Campos. 3. Clique em OK. Na janela Tabela, o ícone da coluna ITEMS_L é exibido em turquesa. 4. Na guia Mapa de Dados do Explorador de Recursos, clique na tabela ambos. 5. Clique em Arquivo > Teste de Linha de Banco de Dados. 6. Na caixa de diálogo Teste de Linha de Banco de Dados, clique em Ir. Na janela Saída do Teste de Linha de Banco de Dados, é exibida uma linha para cada item do registro. TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Importando um Copybook COBOL com Instruções REDEFINES - Exemplo Você pode adicionar um mapa de dados de vários registros e importar um copybook COBOL complexo com instruções REDEFINES para ele. 240 Capítulo 9: Exemplos do Navegador do PowerExchange

258 Este exemplo mostra como executar as seguintes tarefas: 1. Adicione um mapa de dados e importe um copybook COBOL para ele. Ao adicionar o mapa de dados, você usa um arquivo de dados binário de tamanho fixo de dados EBCDIC com registros. Cada registro tem 57 bytes de extensão. Esse arquivo de dados EBCDIC simula a leitura de dados em um sistema mainframe IBM. Na caixa de diálogo Adicionar Mapa de Dados, defina a opção Ignorar Registros para ignorar um registro do cabeçalho no arquivo de dados. Você importa um copybook COBOL com números de linha nas colunas 1 a 6 e comentários nas colunas 73 a 80. O copybook COBOL também contém instruções REDEFINES. Nota: O PowerExchange ignora as linhas de comentários no copybook. 2. Aplique uma máscara de data a um campo GROUP no mapa de dados. Esse exemplo usa os arquivos train5.dat e train5.cob. Etapa 1. Adicionar um Mapa de Dados e Importar um Copybook COBOL com Instruções REDEFINES para o Mapa de Dados Adicione um mapa de dados de vários registros e importe um copybook COBOL com instruções REDEFINES para o mapa de dados. 1. Na guia Recursos do Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Na caixa de diálogo Nome, digite informações sobre o mapa de dados. A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Esquema Nome do Mapa de Dados Método de Acesso Importar Definições de Registro Descrição Digite COBOL. Digite map3. Selecione SEQ. Selecione essa opção. 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso SEQ, digite informações sobre o arquivo de dados. A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Arquivo Fixo Descrição Clique no botão Procurar para navegar até o arquivo train5.dat no diretório de exemplos. Selecione essa opção. Tamanho Digite 57. Padrão Codificação Selecione essa opção. Selecione EBCDIC. Importando um Copybook COBOL com Instruções REDEFINES - Exemplo 241

259 Opção Página de Código Descrição Selecione Padrão. Ignorar Primeiro Digite 1. Depois de definir a codificação e a página de código, selecione a opção Fixo novamente. 5. Clique em Concluir. 6. Na caixa de diálogo Importar Copybook - Detalhes da Origem, digite informações sobre o copybook. A tabela a seguir descreve as informações a serem inseridas: Opção Fonte Tipo Descrição Selecione Local. Selecione COBOL. Início Digite 7. Término Digite Clique em Avançar. 8. Na caixa de diálogo Importar Copybook - Detalhes de Cobol Local, clique no botão Procurar para navegar até o arquivo train5.cob no diretório de exemplos. Nota: Para exibir o copybook, clique em Visualizar. 9. Clique em Avançar. 10. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, selecione as ações para registros, campos e tabelas importados e clique em Concluir. Para obter mais informações, consulte Caixa de Diálogo Importar Copybook - Detalhes de Configuração na página Na janela Informações de Importação do Copybook, consulte as informações para a importação e clique em OK. 12. Na caixa de diálogo Definição de Registro do registro MASTER_REC, clique em OK. Para obter mais informações, consulte Caixas de Diálogo Definição de Registro e Definição de Registro Duplicado na página 141. A janela Redefines do Copybook o notifica de que o copybook contém instruções REDEFINES. A janela Importação Cobol é exibida. 13. Para apontar para a linha que contém o campo PIC S9(8), clique em Redefinição > Próximo ou Redefinição > Anterior. 14. Clique em Importar > Retomar. A janela Importação Cobol exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. Nota: A primeira linha no log de mensagens refere-se a um registro na janela Importação Cobol. Clique na primeira linha no log de mensagens para realçar o registro especificado na janela Importação Cobol. 15. Feche a janela Importação Cobol. 242 Capítulo 9: Exemplos do Navegador do PowerExchange

260 TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Importar Copybook - Caixa de Diálogo Detalhes da Fonte na página 129 Importar Copybook - Caixa de Diálogo Detalhes do Local na página 133 Importar Copybook - Caixa de Diálogo Detalhes do Remoto na página 135 Etapa 2. Aplicar uma Máscara de Data a um Campo GROUP no Mapa de Dados Aplique uma máscara de data a um campo GROUP em um mapa de dados. 1. Na guia Mapa de Dados do Explorador de Recursos, clique no registro MASTER_REC. 2. Na janela Registro, clique no campo MASTER_DATE. O campo MASTER_DATE é definido como um campo GROUP que contém os seguintes subcampos, que são definidos como campos UZONED: DATE_YY DATE_MM DATE_DD Na próxima etapa, exclua esses subcampos e defina propriedades para o campo MASTER_DATE para criar uma única coluna de data na saída do teste de linha de banco de dados do campo MASTER_DATE GROUP. 3. Na janela Registro, selecione o campo DATE_YY. Pressione SHIFT e clique em DATE_DD. Clique no botão Excluir na barra de ferramentas. 4. Na caixa de diálogo de confirmação, para exibir detalhes sobre quais referências cruzadas serão excluídas com os campos, clique em Mais Detalhes. 5. Clique em Sim. 6. Na janela Registro, clique com o botão direito do mouse no campo MASTER_DATE e clique em Propriedades. 7. Na caixa de diálogo Propriedades do Campo, digite informações sobre o campo. A tabela a seguir descreve as informações a serem inseridas: Opção Tipo de Campo Descrição Selecione CHAR. Tamanho Digite 6. Formato de Campo Selecione Y2-MM-D2. Exclua os hífens. 8. Clique em OK. 9. Na guia Mapa de Dados do Explorador de Recursos, clique na tabela MASTER_REC. 10. Clique em Adicionar > Coluna. 11. Na caixa de diálogo Adicionar Coluna, insira as informações sobre a coluna. Importando um Copybook COBOL com Instruções REDEFINES - Exemplo 243

261 A tabela a seguir descreve as informações a serem inseridas: Opção Nome Campo Base Descrição Digite new_date. Selecione MASTER_REC:MASTER_DATE. 12. Clique em OK. 13. Na guia Mapa de Dados do Explorador de Recursos, clique na tabela MASTER_REC. 14. Clique em Arquivo > Teste de Linha de Banco de Dados. 15. Na caixa de diálogo Teste de Linha de Banco de Dados, clique em Ir. Na janela Saída do Teste de Linha de Banco de Dados, a coluna new_date exibe a data. TÓPICOS RELACIONADOS: Adicionando uma Coluna a uma Tabela na página 58 Exibindo ou Editando Propriedades para um Campo em um Registro na página 65 Testando um Mapa de Dados na página 205 Importando um Copybook PL/I - Exemplo Você pode substituir um copybook PL/I por um copybook COBOL. Este exemplo mostra como adicionar um mapa de dados de vários registros e importar um copybook PL/I para ele. Este exemplo mostra como executar as seguintes tarefas: 1. Adicione um mapa de dados e importe um copybook PL/I com várias definições de um campo para esse mapa de dados. Ao adicionar o mapa de dados, você usa um arquivo de dados binário de tamanho fixo de registros de dados EBCDIC, que segue um único registro de cabeçalho ASCII. Cada registro tem 57 bytes de extensão. Esse arquivo de dados EBCDIC simula a leitura de dados em um sistema mainframe IBM. 2. Teste o mapa de dados. Este exemplo usa os arquivos train5.dat e train5.pl1. Etapa 1. Adicionar um Mapa de Dados e Importar um Copybook PL/I para o Mapa de Dados Adicione um mapa de dados e importe um copybook PL/I para o mapa de dados. 1. Na guia Recursos do Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Na caixa de diálogo Nome, digite informações sobre o mapa de dados. 244 Capítulo 9: Exemplos do Navegador do PowerExchange

262 A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Esquema Nome do Mapa de Dados Método de Acesso Importar Definições de Registro Descrição Digite PLI. Digite map5. Selecione SEQ. Selecione essa opção. 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso SEQ, digite informações sobre o arquivo de dados. A tabela a seguir descreve as informações a serem inseridas: Opção Nome do Arquivo Fixo Descrição Clique no botão Procurar para navegar até o arquivo train5.dat no diretório de exemplos. Selecione essa opção. Tamanho Digite 57. Padrão Codificação Selecione essa opção. Selecione EBCDIC. Ignorar Primeiro Digite 1. Depois de definir a codificação, selecione a opção Fixo novamente. 5. Clique em Concluir. 6. Na caixa de diálogo Importar Copybook - Detalhes da Origem, insira as informações sobre o copybook: A tabela a seguir descreve as informações a serem inseridas: Opção Fonte Tipo Descrição Selecione Local. Selecione PL/1. Início Digite 1. Término Digite Clique em Avançar. 8. Na caixa de diálogo Importar Copybook - Detalhes de PL/1 Local, clique no botão Procurar para navegar até o arquivo train5.pl1 no diretório de exemplos. Nota: Para exibir o copybook, clique em Visualizar. Importando um Copybook PL/I - Exemplo 245

263 9. Clique em Avançar. 10. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, selecione as ações para registros, campos e tabelas importados e clique em Concluir. Para obter mais informações, consulte Caixa de Diálogo Importar Copybook - Detalhes de Configuração na página Na janela Informações de Importação do Copybook, consulte as informações para a importação e clique em OK. 12. Na caixa de diálogo Definição de Registro do registro MASTER_REC, clique em OK. Para obter mais informações, consulte Caixas de Diálogo Definição de Registro e Definição de Registro Duplicado na página 141. A janela Redefinições do Copybook notifica você de que o copybook contém duas definições do campo BIN_NO. A janela Importação de PL/1 é exibida. 13. Para apontar para a linha 6, que contém o campo FIXED BINARY(16), clique em Redefinição > Próximo ou em Redefinição > Anterior. 14. Clique em Importar > Retomar. A janela Importação de PL/1 exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. 15. Feche a janela Importação de PL/1. TÓPICOS RELACIONADOS: Testando um Mapa de Dados na página 205 Importar Copybook - Caixa de Diálogo Detalhes da Fonte na página 129 Importar Copybook - Caixa de Diálogo Detalhes do Local na página 133 Importar Copybook - Caixa de Diálogo Detalhes do Remoto na página 135 Etapa 2. Testar o Mapa de Dados Execute um teste de linha de banco de dados na tabela MASTER_REC, no mapa de dados para o qual você importou o copybook PL/I. 1. Na guia Mapa de Dados do Explorador de Recursos, clique na tabela MASTER_REC. 2. Clique em Arquivo > Teste de Linha de Banco de Dados. 3. Na caixa de mensagem, clique em Sim para enviar o mapa de dados PL1.map5 para um local remoto. A caixa de diálogo Nó Remoto do Mapa de Dados é exibida. 4. Na caixa de diálogo Nó Remoto do Mapa de Dados, aceite a localização padrão local e clique em OK. A caixa de diálogo Teste de Linha de Banco de Dados é exibida. 5. Na caixa de diálogo Teste de Linha de Banco de Dados, clique em Ir. A janela Saída do Teste de Linha de Banco de Dados exibe a saída. 246 Capítulo 9: Exemplos do Navegador do PowerExchange

264 Definindo Propriedades da Tabela em um Mapa de Dados para Normalizar um Array - Exemplo Para definir o layout de vários registros de uma vez só e não em várias vezes, defina um array com várias ocorrências. Em seguida, defina as propriedades da tabela no mapa de dados para normalizar o array e produzir a saída correta do arquivo de fonte. Neste exemplo, você adiciona campos definidos pelo usuário ao mapa de dados. Esses campos chamam as funções GenVRowKey e GetSeqWithinLevel do PowerExchange, que demonstram a normalização do array na saída do teste de linha de banco de dados. Este exemplo mostra como executar as seguintes tarefas: 1. Adicione um mapa de dados para um arquivo simples sequencial. Ao adicionar o mapa de dados, você importa um copybook COBOL que define um array com várias ocorrências no mapa de dados. 2. Adicione campos definidos pelo usuário ao mapa de dados. Esses campos definidos pelo usuário chamam as funções GenVRowKey e GetSeqWithinLevel do PowerExchange, que demonstram a normalização do array na saída do teste de linha de banco de dados. Para uma linha de fonte que contém um array, a função GenVRowKey gera várias linhas da tabela identificadas por números de linha exclusivos. A função GetSeqWithinLevel obtém o número de sequência de um registro no nível hierárquico atual. 3. Defina as propriedades da tabela que normalizam o array na saída do teste de linha de banco de dados. 4. Execute um teste de linha de banco de dados para exibir os resultados da normalização. Na saída do teste de linha de banco de dados, é exibida uma linha para cada ocorrência no array. Neste exemplo, você usa o arquivo de dados demo2.dat e o copybook demo2.cob para criar o mapa de dados demo.map2array. O copybook demo2.cob usa a seguinte cláusula OCCURS para definir um array com várias ocorrências: 04 ITEM OCCURS 3 DEPENDING ON ITEMCT PIC X(15). Etapa 1. Adicionar um Mapa de Dados que Contém um Array Definido com Várias Ocorrências Nesta etapa, você adiciona um mapa de dados para um arquivo simples sequencial e importa um copybook COBOL, que define um array com várias ocorrências, para o mapa de dados. 1. Na guia Recursos, no Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Na caixa de diálogo Nome, digite as seguintes informações: Na caixa Nome do Esquema, digite demo. Na caixa Nome do Mapa de Dados, digite map2array. Selecione a opção Importar Definições de Registro. Na lista Método de Acesso, selecione SEQ. 3. Clique em Avançar. Definindo Propriedades da Tabela em um Mapa de Dados para Normalizar um Array - Exemplo 247

265 4. Na caixa de diálogo Método de Acesso SEQ, digite as seguintes informações: Na caixa Nome do Arquivo, clique no botão Procurar para navegar para o arquivo demo2.dat no diretório de exemplos. Na área Formato de Registro, selecione a opção Separador de Campo e digite a vírgula (,) na caixaseparador de Campo. O arquivo de dados demo2.dat é um arquivo separado por vírgula (,). 5. Clique em Concluir. 6. Na caixa de diálogo Importar Copybook - Detalhes da Fonte, digite as seguintes informações: Na área Fonte, selecione Local. Na lista Tipo, selecione COBOL. Na área Intervalo de Coluna, digite 7 na caixa Início e 72 na caixa Fim. 7. Clique em Avançar. 8. Na caixa de diálogo Importar Copybook - Detalhes de Cobol Local, digite as seguintes informações: Clique no botão Procurar para navegar para o arquivo demo2.cob no diretório de exemplos. Para exibir o copybook, clique em Visualizar. O copybook inclui a seguinte cláusula OCCURS para definir um array com várias ocorrências: 04 ITEM OCCURS 3 DEPENDING ON ITEMCT PIC X(15). 9. Feche a janela de visualização. Na caixa de diálogo Importar Copybook - Detalhes de Cobol Local, clique em Próximo. 10. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, consulte as ações selecionadas para registros, campos e tabelas importados e clique em Concluir. 11. Na janela Informações de Importação do Copybook, consulte as informações para a importação e clique em OK. 12. Para importar o registro RECORD_IN, clique em OK na caixa de diálogo Definição de Registro. 13. Para importar os campos no registro, clique em OK na caixa de diálogo Definição de Campo para cada campo. 14. Para importar a tabela RECORD_IN, clique em OK na caixa de diálogo Definição de Tabela. A janela Importação Cobol exibe o copybook importado. A janela Log de Mensagens do Copybook exibe os resultados da operação de importação. 15. Feche as janelas Importação Cobol e Log de Mensagens do Copybook. 16. Na guia Recursos, em Explorador de Recursos, selecione a tabela RECORD_IN e clique em Arquivo > Teste de Linha de Banco de Dados. O Navegador do PowerExchange exibe uma mensagem de erro que indica que o campo RECTYPE no registro RECORD_IN é um tipo inválido para um arquivo de dados delimitado. Além disso, o campo ITEMCT é um tipo inválido. 17. Altere o tipo de dados dos campos RECTYPE e ITEMCT executando as seguintes ações: Na janela Registro referente ao registro RECORD_IN, clique duas vezes no campo RECTYPE. Na caixa de diálogo Propriedades do Campo, selecione um Tipo de Campo igual a NUMCHAR. Digite 2 na caixa Tamanho. Clique em OK. Na janela Registro, clique duas vezes no campo ITEMCT. Na caixa de diálogo Propriedades do Campo, selecione um Tipo de Campo igual a NUMCHAR. Digite 1 na caixa Tamanho. Clique em OK. 248 Capítulo 9: Exemplos do Navegador do PowerExchange

266 18. Na guia Recursos, no Explorador de Recursos, selecione a tabela RECORD_IN e clique em Arquivo > Teste de Linha de Banco de Dados. 19. Na caixa de diálogo Teste de Linha de Banco de Dados, clique em Ir. A janela Saída do Teste de Linha de Banco de Dados exibe os resultados do teste de linha de banco de dados. Etapa 2. Adicionar Campos Definidos pelo Usuário que Demonstram a Normalização de um Array Nesta etapa, você adiciona campos definidos pelo usuário que chamam funções do PowerExchange que demonstram a normalização de um array com várias ocorrências. Os campos definidos pelo usuário chamam as funções GenVRowKey e GetSeqWithinLevel do PowerExchange. Essas funções adicionam dados à saída do teste de linha de banco de dados que demonstram como as propriedades da tabela que você definiu normalizam o array. Quando você executa um teste de linha de banco de dados, o PowerExchange exibe uma linha para cada ocorrência no array. Para obter mais informações sobre essas funções, consulte GenVRowKey na página 278 e GetSeqWithinLevel na página Abra o mapa de dados demo.map2array e o registro RECORD_IN. 2. Na janela Registro, clique na guia Expr(0). 3. Clique com o botão direito do mouse em qualquer lugar da guia Expr(0) e clique em Adicionar Campo no Final. 4. Na célula da coluna Nome, digite r1genvrow_idx. 5. Na célula da coluna Tipo, selecione NUM32U. 6. Na célula da coluna Fase, selecione R. Essa seleção indica uma operação de leitura. 7. Para digitar uma expressão no campo, clique na célula da coluna Expressão e clique no botão Procurar. A caixa de diálogo Editor de Expressão é exibida. 8. Na lista Lista de Funções da caixa de diálogo Editor de Expressão, clique duas vezes na função GenVRowKey. 9. Na lista Lista de Expressões, digite () no final do nome da função GenVRowKey. Clique em Validar. Na caixa Validar, a mensagem Nenhum Erro é exibida. 10. Clique em OK. 11. Clique com o botão direito do mouse em qualquer lugar da guia Expr(0) e clique em Adicionar Campo no Final. 12. Na célula da coluna Nome, digite r1genseq. 13. Na célula da coluna Tipo, selecione NUM32U. 14. Na célula da coluna Fase, selecione R. Essa seleção indica uma operação de leitura. 15. Para digitar uma expressão para o campo, clique na célula da coluna Expressão e clique no botão Procurar. A caixa de diálogo Editor de Expressão é exibida. 16. Na lista Lista de Funções da caixa de diálogo Editor de Expressão, clique duas vezes na função GenSeqWithinLevel. Definindo Propriedades da Tabela em um Mapa de Dados para Normalizar um Array - Exemplo 249

267 17. Na lista Lista de Expressões, digite () no final do nome da função GenSeqWithinLevel. Clique em Validar. Na caixa Validar, a mensagem Nenhum Erro é exibida. 18. Clique em OK. Etapa 3. Definir Propriedades da Tabela para Normalizar um Array Nesta etapa, você define as propriedades da tabela que normalizam um array em um mapa de dados. 1. Abra o mapa de dados demo.map2array. 2. Na guia Mapa de Dados, emexplorador de Recursos, clique com o botão direito do mouse na tabela RECORD_IN e clique em Propriedades. A caixa de diálogo Propriedades da Tabela - Definição é exibida. 3. Na lista Geração de Coluna, selecione Atualizar com colunas não encontradas. Como o registro no qual a tabela está baseada contém novos campos, as colunas correspondentes serão adicionadas à tabela. 4. Clique em OK. 5. Na guia Mapa de Dados, no Explorador de Recursos, clique com o botão direito do mouse na tabela RECORD_IN e clique em Propriedades. A caixa de diálogo Propriedades da Tabela - Definição é exibida. 6. Na caixa de diálogo Propriedades da Tabela - Definição, execute as seguintes ações: Na lista Geração de Coluna, selecione Aplicar alterações no formato do array. Como o registro no qual a tabela está baseada contém campos alterados definidos como arrays, essas alterações são refletidas nas colunas correspondentes da tabela. Na lista Como deseja gerenciar várias instâncias do registro selecionado?, selecione Nova Linha. Essa ação faz com que o PowerExchange exiba uma nova linha para cada ocorrência no array em um teste de linha de banco de dados. 7. Clique em OK. Para obter mais informações sobre a caixa de diálogo Propriedades da Tabela - Definição, consulte Propriedades da Tabela - Definição na página 353. Etapa 4. Testar a Normalização do Array no Mapa de Dados Nesta etapa, você executa um teste de linha de banco de dados para testar a normalização do array no mapa de dados. 1. Abra o mapa de dados demo.map2array. 2. Na guia Mapa de Dados do Explorador de Recursos, selecione a tabela RECORD_IN e clique em Arquivo > Teste da Linha do Banco de Dados. A caixa de diálogo Teste da Linha do Banco de Dados é exibida. 3. Na caixa de diálogo Teste de Linha de Banco de Dados, clique em Ir. A janela Saída do Teste de Linha de Banco de Dadosé exibida. 250 Capítulo 9: Exemplos do Navegador do PowerExchange

268 A imagem a seguir exibe a janela Saída do Teste de Linha de Banco de Dados: 1. Resultados da função GenVRowKey 2. Resultados da função GetSeqWithinLevel A coluna r1genvrow_idx exibe os resultados da função GenVRowKey, que é o número da ocorrência no array. A coluna r1genseq exibe os resultados da função GetSeqWithinLevel, que é o número do registro. Por exemplo, os seguintes resultados são exibidos na saída: A primeira linha exibe os dados da ocorrência 1 no array, no registro 1. A terceira linha exibe os dados da ocorrência 3 no array, no registro 1. A quarta linha exibe os dados da ocorrência 1 no array, no registro 2. Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo Neste exemplo, você chama um programa de saída do usuário adicionando campos definidos pelo usuário a um registro de mapa de dados para chamar a função CallProg do PowerExchange. O programa de saída do usuário retorna o tipo de classe dos dados em um campo especificado. O programa de saída do usuário testa qualquer campo com um tamanho máximo de 15 bytes. A tabela a seguir descreve os tipos de classe que o programa de saída do usuário retorna: Tipo de Classe A H L N S Descrição Alfabético Valores altos Valores baixos Numéricos zoneados de forma decimal Espaços Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo 251

269 Este exemplo mostra como executar as seguintes tarefas: 1. Adicionar um mapa de dados usando um exemplo de arquivo de dados e um copybook que acompanham o PowerExchange no z/os. 2. Criar e compilar um programa de saída do usuário. Salvar a DLL na biblioteca LOADLIB do Ouvinte do PowerExchange no z/os. 3. Adicionar os seguintes campos definidos pelo usuário ao registro de mapa de dados MASTER_REC: Os campos classtype_bin_no, classtype_dec_no e classtype_rec_type. Definidos como campos CHAR de um byte. O programa de saída do usuário chamado pela função CallProg retorna o tipo de classe de um campo especificado nesses campos. Você deve definir um campo classtype separado para cada campo cujo tipo de classe você deseje verificar. Os campos rc_bin_no, rc_decimal_no e rc_rec_type. Definidos como campos NUM32. Use esses campos para chamar a função CallProg e para obter o código de retorno da chamada do programa de saída do usuário. Antes de concluir a verificação de dados de um registro de mapa de dados, o PowerExchange executa todas as chamadas de programa e expressões definidas em campos definidos pelo usuário do registro do mapa de dados. 4. Atualize as colunas da tabela MASTER_REC para selecionar os campos definidos pelo usuário adicionados ao registro MASTER_REC. 5. Execute um teste de linha de banco de dados no registro do mapa de dados para testar os resultados do programa de saída do usuário e para verificar se o programa de saída do usuário é executado corretamente. Etapa 1. Adicionar um Mapa de Dados Nesta etapa, você adiciona um mapa de dados para um arquivo simples sequencial e importa um copybook COBOL. Para adicionar o mapa de dados, use os membros do conjunto de dados que acompanham o PowerExchange no sistema z/os. A tabela a seguir descreve os membros do conjunto de dados: Membro do Conjunto de Dados KSDSDAT KSDSCOB Descrição Arquivo de dados que contém dados de fonte. Copybook COBOL que você importa para definir o layout dos dados. 1. Na guia Recursos do Explorador de Recursos, clique em Adicionar > Mapa de Dados. 2. Na caixa de diálogo Nome, defina as propriedades para o mapa de dados. 252 Capítulo 9: Exemplos do Navegador do PowerExchange

270 A seguinte tabela descreve as propriedades: Propriedade Nome do Esquema Nome do Mapa de Dados Método de Acesso Valor demo userexit SEQ Além disso, selecione a opção Importar Definições de Registro. 3. Clique em Avançar. 4. Na caixa de diálogo Método de Acesso SEQ, digite informações sobre o arquivo de dados. A tabela a seguir descreve as informações a serem inseridas: Propriedade Valor Observações Nome do Arquivo PWX_installation_dataset.DTLDEMO( KSDSDAT) Onde PWX_installation_dataset é o conjunto de dados de instalação do PowerExchange. Por exemplo, você pode digitar o seguinte valor para o nome de arquivo: PWX.V901.DTLDEMO(KSDSDAT) Formato de Registro Ignorar Primeiro Padrão Além disso, verifique se a opção Processamento de Lista de Arquivo está desabilitada. Por padrão, essa opção está desabilitada. 5. Clique em Concluir. 6. Na caixa de diálogo Importar Copybook - Detalhes da Origem, defina as seguintes propriedades para o copybook: A tabela a seguir lista os valores a serem inseridos: Propriedade Fonte Tipo Valor Remoto COBOL Início do Intervalo de Coluna 7 Término do Intervalo de Coluna Clique em Avançar. 8. Na caixa de diálogo Importar Copybook - Detalhes de Cobol Remoto, defina as propriedades do copybook no sistema remoto. Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo 253

271 A tabela a seguir descreve as informações a serem inseridas: Propriedad e Nome do Arquivo Valor PWX_installation_dataset.DTLDEMO(K SDSCOB) Observações Onde PWX_installation_dataset é o conjunto de dados de instalação do PowerExchange. Por exemplo, você pode digitar o seguinte valor para o nome de arquivo: PWX.V901.DTLDEMO(KSDSCOB) Localização Nó para o sistema z/os - Identificação de Usuário A identificação de usuário para o sistema z/os - Senha Salvar Arquivo Localmente Como A senha ou código de acesso válido do PowerExchange do ID do usuário no sistema z/os. Um código de acesso para acesso ao z/os pode ter 9 a 128 caracteres e pode conter os seguintes caracteres: - Letras em maiúsculas e minúsculas - Os números de 0 a 9 - Espaços - Os seguintes caracteres especiais: - ; # \,. /! % & * ( ) _ + { } < >? Nota: O primeiro caractere é uma apóstrofe. Códigos de acesso não podem incluir aspas simples ('), aspas duplas ( ) ou símbolos monetários. Nota: No z/os, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação. Um nome para o arquivo do copybook no sistema Windows local - - Nota: Se quiser visualizar o copybook, clique em Visualizar. Depois de visualizar o copybook, feche a janela de visualização. 9. Clique em Avançar. 10. Na caixa de diálogo Importar Copybook - Detalhes de Configuração, consulte as ações selecionadas para registros, campos e tabelas importados, e clique em Concluir. 11. Na janela Informações de Importação do Copybook, consulte as informações para a importação e clique em OK. 12. Na caixa de diálogo Definição de Registro do registro MASTER_REC, clique em OK. 254 Capítulo 9: Exemplos do Navegador do PowerExchange

272 A caixa de mensagem Redefinições do Copybook aparece indicando que existem duas definições para o campo BIN_NO no copybook. Neste exemplo, a primeira definição é a correta. 13. Para aceitar a primeira definição para o campo BIN_NO, clique em Importar > Ir para Linha Atual. Em seguida, clique em Importar > Retomar para continuar a importação. A janela Importação Cobol exibe o copybook importado e a janela Log de Mensagens do Copybook exibe os resultados da operação de importação. 14. Feche a janela Importação Cobol. 15. Para verificar se o mapa de dados foi adicionado corretamente, na guia Recursos do Explorador de Recursos, selecione a tabela MASTER_REC e clique em Arquivo > Teste de Linha de Banco de Dados. 16. Quando você for solicitado a enviar o mapa de dados para um local remoto, clique em Sim. A caixa de diálogo Nó Remoto do Mapa de Dados é exibida. 17. Na caixa de diálogo Nó Remoto do Mapa de Dados, digite o ID de usuário, a senha e o nó do sistema z/os. A caixa de diálogo Teste de Linha de Banco de Dados é exibida. 18. Na caixa de diálogo Teste de Linha de Banco de Dados, aceite os valores padrão e clique em Ir. A janela Saída do Teste de Linha de Banco de Dados exibe os resultados do teste de linha de banco de dados. A imagem a seguir exibe a janela Saída do Teste de Linha de Banco de Dados: Etapa 2. Criar e Compilar o Programa de Saída do Usuário Nesta etapa, você copia e modifica o programa de saída do usuário UCPEP. Em seguida, você compila o programa de saída do usuário e salva a DLL na biblioteca LOADLIB do Ouvinte do PowerExchange. O PowerExchange inclui exemplos de programas de saída do usuário, incluindo o programa UCPEP, na biblioteca SRCLIB do conjunto de dados de instalação no z/os. 1. Na biblioteca SRCLIB do conjunto de dados de instalação do PowerExchange no z/os, copie o programa de saída do usuário UCPEP e nomeie-o UCPGCLSC. 2. Edite o programa UCPGCLSC e faça as alterações marcadas em negrito, conforme mostrado neste código: IDENTIFICATION DIVISION. PROGRAM-ID. UCPGCLSC. **************************************************** * GLOBAL CUSTOMER SUPPORT SAMPLE CLASS TEST * EXAMPLE COBOL PROGRAM CALLED VIA CALLPROG. * ***** ***** * USER EXITS ARE NOT SUPPORTED BY INFORMATICA * USER EXITS ARE USED AT THE CUSTOMERS OWN RISK * Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo 255

273 256 Capítulo 9: Exemplos do Navegador do PowerExchange * * USING SYNTAX :- * CALLPROG('UCPGCLSC','UCPGCLSC','COBOL','VOID', * TEXT_FIELD,NUMBER1_FIELD) * * RECEIVES THE FOLLOWING ARGUMENTS :- * 1. NUMBER-ARGUMENTS - REQUIRED * THE NUMBER OF ARGUMENTS WHICH FOLLOW. * THE PROGRAM WILL EXIT SETTING A BAD RETURN CODE * IF THE NUMBER IS NOT WHAT IT EXPECTS. * * 2. FAILURE-CODE. - REQUIRED * AN INTEGER PASSED BACK TO THE CALLER TO INDICATE IF * PROCESSING WAS WAS NOT SUCCESSFUL. * THE FAILURE-CODE IS MONITORED * SO THAT ACTION CAN BE TAKEN TO HANDLE ERRORS. * * BECAUSE THE MVS COBOL LINKAGE TYPE ONLY SUPPORTS A * RETURN TYPE OF 'VOID', IT IS NECESSARY TO PASS IT * BACK AS A NORMAL FIELD WITH ITS ACCOMPANYING LENGTH. * (SEE CLLPRGL2 FOR HOW THE RETURN CODE CAN BE PASSED * USING A LINKAGE TYPE OF 'OS' RETURNING 'INT') * * 3. MESSAGE-BUFFER. - REQUIRED * AN ERROR INTO WHICH THE PROGRAM CAN PUT A MESSAGE * TO ACCOMPANY A NON-ZERO FAILURE CODE, INDICATING * THE REASON. * * 4. MESSAGE-BUFFER-LENGTH. - REQUIRED * THE LENGTH OF MESSAGE-BUFFER * * 5. TEXT-AREA. * THIS IS THE 5TH ARGUMENT TO CALLPROG DEFINED IN THE * NAVIGATOR EXPRESSIONS SCREEN. * IN THIS EXAMPLE, IT IS A FIELD CONTAINING A MAX OF 15 BYTES * * 6. TEXT-AREA-LENGTH. * THE LENGTH OF TEXT-AREA WHICH VARIES ACCORDING * TO THE ACTUAL FIELD LENGTH ON THE FILE. * * 7. CLASS-TYPE. * THIS IS THE 6TH ARGUMENT TO CALLPROG DEFINED IN THE * NAVIGATOR EXPRESSIONS SCREEN. * IN THIS EXAMPLE, IT IS A 1 BYTE CHARACTER FIELD WITH VALUES * S=SPACES, L=LOW-VALUES, H=HIGH-VALUES, A=ALPHABETIC, N=NUMERIC * * 8. CLASS-TYPE-LENGTH. * THE LENGTH OF FIELD CLASS-TYPE WHICH WILL ALWAYS * BE 1. **************************************************** * ENVIRONMENT DIVISION. * DATA DIVISION. WORKING-STORAGE SECTION. * 01 WS-DATE PIC X(6). 01 WS-TIME PIC X(8). 01 WS-DATA. 05 WS-DATA15 PIC X(15). 01 WS-DATAL14 REDEFINES WS-DATA. 05 WS-DATA14 PIC X(14). 05 FILLER PIC X(01). 01 WS-DATAL13 REDEFINES WS-DATA. 05 WS-DATA13 PIC X(13). 05 FILLER PIC X(02). 01 WS-DATAL12 REDEFINES WS-DATA. 05 WS-DATA12 PIC X(12). 05 FILLER PIC X(03).

274 01 WS-DATAL11 REDEFINES WS-DATA. 05 WS-DATA11 PIC X(11). 05 FILLER PIC X(04). 01 WS-DATAL10 REDEFINES WS-DATA. 05 WS-DATA10 PIC X(10). 05 FILLER PIC X(05). 01 WS-DATAL09 REDEFINES WS-DATA. 05 WS-DATA09 PIC X(09). 05 FILLER PIC X(06). 01 WS-DATAL08 REDEFINES WS-DATA. 05 WS-DATA08 PIC X(08). 05 FILLER PIC X(07). 01 WS-DATAL07 REDEFINES WS-DATA. 05 WS-DATA07 PIC X(07). 05 FILLER PIC X(08). 01 WS-DATAL06 REDEFINES WS-DATA. 05 WS-DATA06 PIC X(06). 05 FILLER PIC X(09). 01 WS-DATAL05 REDEFINES WS-DATA. 05 WS-DATA05 PIC X(05). 05 FILLER PIC X(10). 01 WS-DATAL04 REDEFINES WS-DATA. 05 WS-DATA04 PIC X(04). 05 FILLER PIC X(11). 01 WS-DATAL03 REDEFINES WS-DATA. 05 WS-DATA03 PIC X(03). 05 FILLER PIC X(12). 01 WS-DATAL02 REDEFINES WS-DATA. 05 WS-DATA02 PIC X(02). 05 FILLER PIC X(13). 01 WS-DATAL01 REDEFINES WS-DATA. 05 WS-DATA01 PIC X(01). 05 FILLER PIC X(14). * LINKAGE SECTION. 01 LK-NUMBER-ARGUMENTS PIC S9(9) COMP. 01 LK-FAILURE-CODE PIC S9(9) COMP. 01 LK-MESSAGE-BUFFER. 05 LK-MESSAGE-BUFFER-BYTE PIC X(1) OCCURS 1 TO 255 DEPENDING ON LK-MESSAGE-BUFFER-LENGTH. 01 LK-MESSAGE-BUFFER-LENGTH PIC S9(9) COMP. 01 LK-TEXT-AREA. 05 LK-TEXT-AREA-BYTE PIC X(1) OCCURS LK-TEXT-AREA-LENGTH PIC S9(9) COMP. 01 LK-CLASS PIC X. 01 LK-CLASS-LENGTH PIC S9(9) COMP. PROCEDURE DIVISION USING LK-NUMBER-ARGUMENTS LK-FAILURE-CODE LK-MESSAGE-BUFFER LK-MESSAGE-BUFFER-LENGTH LK-TEXT-AREA LK-TEXT-AREA-LENGTH LK-CLASS LK-CLASS-LENGTH. MAIN SECTION MAIN. MOVE ZERO TO LK-FAILURE-CODE. MOVE ZERO TO LK-MESSAGE-BUFFER-LENGTH. Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo 257

275 ************************************************************** * EXIT FLAGGING AN ERROR IF THE WRONG NUMBER OF ARGUMENT PAIRS ************************************************************** IF LK-NUMBER-ARGUMENTS NOT = 2 DISPLAY 'UCPGCLSC:NUMBER-ARGUMENTS=' LK-NUMBER-ARGUMENTS ' (REQUIRED 2)' ' EXITTING WITH RC=401' MOVE 401 TO LK-FAILURE-CODE MOVE 'UCPGCLSC:NOT ENOUGH ARGUMENTS ' TO LK-MESSAGE-BUFFER GO TO 0900-MAIN-EXIT END-IF. *********************************************************************** * IF DATA PRESENT FIND LENGTH AND TEST CLASS *********************************************************************** * IF LK-TEXT-AREA-LENGTH = ZERO MOVE 'FIELD EMPTY' TO LK-MESSAGE-BUFFER MOVE 11 TO LK-MESSAGE-BUFFER-LENGTH MOVE 402 TO LK-FAILURE-CODE GO TO 0900-MAIN-EXIT ELSE IF LK-TEXT-AREA-LENGTH > +15 MOVE 'LENGTH > 15' TO LK-MESSAGE-BUFFER MOVE 11 TO LK-MESSAGE-BUFFER-LENGTH MOVE 403 TO LK-FAILURE-CODE GO TO 0900-MAIN-EXIT ELSE MOVE LK-TEXT-AREA TO WS-DATA END-IF. * MOVE SPACES TO LK-CLASS. MOVE +1 TO LK-CLASS-LENGTH. * 0100-CLASS15. * IF LK-TEXT-AREA-LENGTH < +15 GO TO 0100-CLASS14 END-IF. * IF WS-DATA ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS Capítulo 9: Exemplos do Navegador do PowerExchange

276 * * * * * * IF LK-TEXT-AREA-LENGTH < +14 GO TO 0100-CLASS13 END-IF. IF WS-DATA14 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA14 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA14 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA14 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA14 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS13. * IF LK-TEXT-AREA-LENGTH < +13 GO TO 0100-CLASS12 END-IF. * IF WS-DATA13 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA13 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA13 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA13 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA13 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS12. * IF LK-TEXT-AREA-LENGTH < +12 GO TO 0100-CLASS11 END-IF. * Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo 259

277 * * * * IF WS-DATA12 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA12 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA12 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA12 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA12 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS11. * IF LK-TEXT-AREA-LENGTH < +11 GO TO 0100-CLASS10 END-IF. * IF WS-DATA11 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA11 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA11 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA11 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA11 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS10. * IF LK-TEXT-AREA-LENGTH < +10 GO TO 0100-CLASS09 END-IF. * IF WS-DATA10 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * 260 Capítulo 9: Exemplos do Navegador do PowerExchange

278 * * * IF WS-DATA10 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA10 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA10 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA10 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS09. * IF LK-TEXT-AREA-LENGTH < +9 GO TO 0100-CLASS08 END-IF. * IF WS-DATA09 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA09 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA09 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA09 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA09 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS08. * IF LK-TEXT-AREA-LENGTH < +8 GO TO 0100-CLASS07 END-IF. * IF WS-DATA08 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA08 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo 261

279 * * IF WS-DATA08 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA08 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA08 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS07. * IF LK-TEXT-AREA-LENGTH < +7 GO TO 0100-CLASS06 END-IF. * IF WS-DATA07 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA07 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA07 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA07 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA07 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS06. * IF LK-TEXT-AREA-LENGTH < +6 GO TO 0100-CLASS05 END-IF. * IF WS-DATA06 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA06 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA06 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * 262 Capítulo 9: Exemplos do Navegador do PowerExchange

280 * IF WS-DATA06 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. IF WS-DATA06 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS05. * IF LK-TEXT-AREA-LENGTH < +5 GO TO 0100-CLASS04 END-IF. * IF WS-DATA05 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA05 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA05 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA05 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA05 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS04. * IF LK-TEXT-AREA-LENGTH < +4 GO TO 0100-CLASS03 END-IF. * IF WS-DATA04 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA04 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA04 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA04 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo 263

281 IF WS-DATA04 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS03. * IF LK-TEXT-AREA-LENGTH < +3 GO TO 0100-CLASS02 END-IF. * IF WS-DATA03 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA03 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA03 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA03 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA03 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * 0100-CLASS02. * IF LK-TEXT-AREA-LENGTH < +2 GO TO 0100-CLASS01 END-IF. * IF WS-DATA02 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA02 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA02 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA02 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA02 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. 264 Capítulo 9: Exemplos do Navegador do PowerExchange

282 * 0100-CLASS01. * IF LK-TEXT-AREA-LENGTH < +1 GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA01 ALPHABETIC MOVE 'A' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA01 NUMERIC MOVE 'N' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA01 = LOW-VALUES MOVE 'L' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA01 = HIGH-VALUES MOVE 'H' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. * IF WS-DATA01 = SPACES MOVE 'S' TO LK-CLASS GO TO 0900-MAIN-EXIT END-IF. GO TO 0900-MAIN-EXIT. * * 0900-MAIN-EXIT. GOBACK. 3. Compile o programa UCPGCLSC e salve a DLL na biblioteca LOADLIB do Ouvinte do PowerExchange. Etapa 3. Adicionar Campos Definidos pelo Usuário Nesta etapa, você adiciona campos definidos pelo usuário. Os campos definidos pelo usuário chamam a função CallProg do PowerExchange, que, por sua vez, chama o programa de saída do usuário. Para obter mais informações sobre a função CallProg, consulte CallProg na página 273. O programa de saída do usuário processa dados e retorna os tipos de classe dos campos REC_TYPE, BIN_NO e DECIMAL_NO. 1. Abra o mapa de dados demo.userexit e o registro MASTER_REC. 2. Na janela Registro, clique na guia Expr(0). 3. Clique com o botão direito do mouse em qualquer lugar da guia Expr(0) e clique em Adicionar Campo no Final. 4. Adicione o campo classtype_rec_type, que é um campo de saída que contém o resultado do programa de saída do usuário quando ele é chamado para o campo REC_TYPE. Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo 265

283 A tabela a seguir descreve as propriedades a serem definidas para o campo: Propriedade Nome Tipo Valor classtype_rec_type CHAR Precisão 0 Escala 0 Tamanho 1 5. Clique com o botão direito do mouse em qualquer lugar da guia Expr(0) e clique em Adicionar Campo no Final. 6. Adicione o campo rc_rec_type, que chama o programa de saída do usuário para processar o campo REC_TYPE. A tabela a seguir descreve as propriedades a serem definidas para o campo: Proprieda de Valor Observações Nome rc_rec_type - Tipo NUM32 - Precisão 0 - Escala 0 - Tamanho Capítulo 9: Exemplos do Navegador do PowerExchange

284 Proprieda de Valor Observações Fase RW Indica que a operação é de leitura ou gravação. Expressão CallProg('UCPGCLSC', 'UCPGCLSC','COBOL', REC_TYPE,classtype_rec_type) Para inserir a expressão do campo, execute as seguintes etapas: 1. Clique na célula da coluna Expressão e clique no botão Procurar. A caixa de diálogo Editor de Expressão é exibida. 2. Na lista Lista de Funções da caixa de diálogo Editor de Expressão, clique duas vezes na função CallProg. 3. Na lista Lista de Expressões, digite ('UCPGCLSC','UCPGCLSC','C OBOL',REC_TYPE,classtype_ rec_type) no final do nome de função CallProg. 4. Clique em Validar. Na caixa Validar, a mensagem Nenhum Erro é exibida. 5. Clique em OK. 7. Na janela Registro, clique na guia Expr(0). 8. Clique com o botão direito do mouse em qualquer lugar da guia Expr(0) e clique em Adicionar Campo no Final. 9. Adicione o campo classtype_bin_no, que é um campo de saída que contém o resultado do programa de saída do usuário quando ele é chamado para o campo BIN_NO. A tabela a seguir descreve as propriedades a serem definidas para o campo: Propriedade Nome Tipo Valor classtype_bin_no CHAR Precisão 0 Escala 0 Tamanho Clique com o botão direito do mouse em qualquer lugar da guia Expr(0) e clique em Adicionar Campo no Final. 11. Adicione o campo rc_bin_no, que chama o programa de saída do usuário para processar o campo BIN_NO. Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo 267

285 A tabela a seguir descreve as propriedades a serem definidas para o campo: Proprieda de Valor Observações Nome rc_bin_no - Tipo NUM32 - Precisão 0 - Escala 0 - Tamanho 0 - Fase RW Indica que a operação é de leitura ou gravação. Expressão CallProg('UCPGCLSC', 'UCPGCLSC','COBOL', BIN_NO,classtype_bin_no) Para inserir a expressão do campo, execute as seguintes etapas: 1. Clique na célula da coluna Expressão e clique no botão Procurar. A caixa de diálogo Editor de Expressão é exibida. 2. Na lista Lista de Funções da caixa de diálogo Editor de Expressão, clique duas vezes na função CallProg. 3. Na lista Lista de Expressões, digite ('UCPGCLSC','UCPGCLSC','C OBOL',BIN_NO,classtype_bi n_no) no final do nome de função CallProg. 4. Clique em Validar. Na caixa Validar, a mensagem Nenhum Erro é exibida. 5. Clique em OK. 12. Clique com o botão direito do mouse em qualquer lugar da guia Expr(0) e clique em Adicionar Campo no Final. 13. Adicione o campo classtype_dec_no, que é um campo de saída que contém o resultado do programa de saída do usuário quando ele é chamado para o campo DECIMAL_NO. A tabela a seguir descreve as propriedades a serem definidas para o campo: Propriedade Nome Tipo Valor classtype_dec_no CHAR Precisão Capítulo 9: Exemplos do Navegador do PowerExchange

286 Propriedade Valor Escala 0 Tamanho Clique com o botão direito do mouse em qualquer lugar da guia Expr(0) e clique em Adicionar Campo no Final. 15. Adicione o campo rc_decimal_no, que chama o programa de saída do usuário para processar uma cópia do campo DECIMAL_NO. A tabela a seguir descreve as propriedades a serem definidas para o campo: Proprieda de Valor Observações Nome rc_decimal_no - Tipo NUM32 - Precisão 0 - Escala 0 - Tamanho 0 - Fase RW Indica que a operação é de leitura ou gravação. Expressão CallProg('UCPGCLSC', 'UCPGCLSC','COBOL', DECIMAL_NO,classtype_dec_no) Para inserir a expressão do campo, execute as seguintes etapas: 1. Clique na célula da coluna Expressão e clique no botão Procurar. A caixa de diálogo Editor de Expressão é exibida. 2. Na lista Lista de Funções da caixa de diálogo Editor de Expressão, clique duas vezes na função CallProg. 3. Na lista Lista de Expressões, digite ('UCPGCLSC','UCPGCLSC','C OBOL',DECIMAL_NO,classtyp e_dec_no) no final do nome de função CallProg. 4. Clique em Validar. Na caixa Validar, a mensagem Nenhum Erro é exibida. 5. Clique em OK. Etapa 4. Atualizar Colunas da Tabela MASTER_REC Nesta etapa, você atualiza as colunas da tabela MASTER_REC para selecionar os campos definidos pelo usuário que você adicionou ao registro MASTER_REC. 1. Abra o mapa de dados demo.userexit. Chamando um Programa de Saída do Usuário por meio da Função CallProg do PowerExchange - Exemplo 269

287 2. Na guia Mapa de Dados do Explorador de Recursos, clique com o botão direito do mouse na tabela MASTER_REC e clique em Propriedades. A caixa de diálogo Propriedades da Tabela - Definição é exibida. 3. Na lista Geração de Coluna, selecione Atualizar com colunas não encontradas. Como o registro no qual a tabela é baseada contém novos campos, essa ação adiciona as colunas correspondentes à tabela. 4. Clique em OK. Para obter mais informações sobre a caixa de diálogo Propriedades da Tabela - Definição, consulte Propriedades da Tabela - Definição na página 353. Etapa 5. Testar os Resultados do Programa de Saída do Usuário Nesta etapa, você executa um teste de linha de banco de dados para testar os resultados do programa de saída do usuário no registro do mapa de dados. 1. Abra o mapa de dados demo.userexit. 2. Na guia Mapa de Dados do Explorador de Recursos, selecione a tabela MASTER_REC e clique em Arquivo > Teste de Linha de Banco de Dados. 3. Quando for solicitado a enviar o mapa de dados para um local remoto, clique em Sim. A caixa de diálogo Nó Remoto do Mapa de Dados é exibida. 4. Na caixa de diálogo Nó Remoto do Mapa de Dados, insira o ID do usuário, uma senha ou um código de acesso válido do PowerExchange para o usuário e o nome do nó do sistema z/os. A caixa de diálogo Teste de Linha de Banco de Dados é exibida. 5. Na caixa de diálogo Teste de Linha de Banco de Dados, aceite os valores padrão e clique em Ir. A janela Saída do Teste de Linha de Banco de Dados exibe os resultados do teste de linha de banco de dados, incluindo os campos definidos pelo usuário. A imagem seguinte mostra a janela Saída do Teste de Linha de Banco de Dados: A tabela a seguir descreve os campos definidos pelo usuário: Campo Definido pelo Usuário Valor Descrição classtype_bin_no H Indica que o campo BIN_NO da linha contém um valor alto. classtype_dec_no N Indica que o campo DECIMAL_NO da linha contém um valor numérico zoneado de forma decimal. 270 Capítulo 9: Exemplos do Navegador do PowerExchange