Informatica PowerExchange (Versão HotFix 4) Guia de Utilitários

Informatica PowerExchange (Versão 9.6.1 HotFix 4) Guia de Utilitários

Informatica PowerExchange Guia de Utilitários Versão 9.6.1 HotFix 4 Abril 2016 Copyright (c) 1993-2016 Informatica LLC. Todos os direitos reservados. Este software e documentação contêm informações de propriedade da Informatica LLC, 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 LLC. 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 227.7202-1(a) e 227.7702-3(a) (1995), DFARS 252.227-7013 (1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19 ou FAR 52.227-14 (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, Informatica Master Data Management e Live Data Map são marcas comerciais ou marcas registradas da Informatica LLC nos Estados Unidos e em jurisdiçõ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 1986. 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 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 2003-2010 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. Todos os direitos reservados. Copyright Ricebridge. Todos os direitos reservados. Copyright Sencha, Inc. Todos os direitos reservados. Copyright Scalable Systems, Inc. Todos os direitos reservados. Copyright jqwidgets. Todos os direitos reservados. Copyright Tableau Software, Inc. Todos os direitos reservados. Copyright MaxMind, Inc. Todos os direitos reservados. Copyright TMate Software s.r.o. Todos os direitos reservados. Copyright MapR Technologies Inc. Todos os direitos reservados. Copyright Amazon Corporate LLC. Todos os direitos reservados. Copyright Highsoft. Todos os direitos reservados. Copyright Python Software Foundation. Todos os direitos reservados. Copyright BeOpen.com. Todos os direitos reservados. Copyright CNRI. Todos os direitos reservados. Este produto inclui software desenvolvido pela Apache Software Foundation (http://www.apache.org/) 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 http://www.apache.org/licenses/. 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 (http://www.mozilla.org/), direitos autorais de software de The JBoss Group, LLC; todos os direitos reservados; software copyright 1999-2006 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 http://www.gnu.org/licenses/lgpl.html. 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 ( ) 1993-2006, 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 http://www.openssl.org e http://www.openssl.org/source/license.html. Este produto inclui o software Curl com o Copyright 1996-2013, 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 http://curl.haxx.se/docs/copyright.html. É 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 software copyright 2001-2005 ( ) MetaStuff, Ltd. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em http://www.dom4j.org/license.html. O produto inclui o copyright de software 2004-2007, The Dojo Foundation. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em http://dojotoolkit.org/license. 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 http://source.icu-project.org/repos/icu/icu/trunk/license.html. Este produto inclui o copyright de software 1996-2006 Per Bothner. Todos os direitos reservados. O direito de usar tais materiais é estabelecido na licença que pode ser encontrada em http://www.gnu.org/software/kawa/software-license.html. 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 http://www.opensource.org/licenses/mit-license.php. Este produto inclui software desenvolvido pela Boost (http://www.boost.org/) 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 http://www.boost.org/license_1_0.txt.

Este produto inclui software copyright 1997-2007 University of Cambridge. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em http://www.pcre.org/license.txt. Este produto inclui o copyright de software 2007 The Eclipse Foundation. Todos os direitos reservados. As permissões e as limitações relativas a este software estão sujeitas aos termos disponíveis em http://www.eclipse.org/org/documents/epl-v10.php e em http://www.eclipse.org/org/documents/edl-v10.php. Este produto inclui softwares licenciados de acordo com os termos disponíveis em http://www.tcl.tk/software/tcltk/license.html, http://www.bosrup.com/web/overlib/? License, http://www.stlport.org/doc/ license.html, http:// asm.ow2.org/license.html, http://www.cryptix.org/license.txt, http://hsqldb.org/web/hsqllicense.html, http:// httpunit.sourceforge.net/doc/ license.html, http://jung.sourceforge.net/license.txt, http://www.gzip.org/zlib/zlib_license.html, http://www.openldap.org/software/release/ license.html, http://www.libssh2.org, http://slf4j.org/license.html, http://www.sente.ch/software/opensourcelicense.html, http://fusesource.com/downloads/licenseagreements/fuse-message-broker-v-5-3- license-agreement; http://antlr.org/license.html; http://aopalliance.sourceforge.net/; http://www.bouncycastle.org/licence.html; http://www.jgraph.com/jgraphdownload.html; http://www.jcraft.com/jsch/license.txt; http://jotm.objectweb.org/bsd_license.html;. http://www.w3.org/consortium/legal/ 2002/copyright-software-20021231; http://www.slf4j.org/license.html; http://nanoxml.sourceforge.net/orig/copyright.html; http://www.json.org/license.html; http:// forge.ow2.org/projects/javaservice/, http://www.postgresql.org/about/licence.html, http://www.sqlite.org/copyright.html, http://www.tcl.tk/software/tcltk/license.html, http:// www.jaxen.org/faq.html, http://www.jdom.org/docs/faq.html, http://www.slf4j.org/license.html; http://www.iodbc.org/dataspace/iodbc/wiki/iodbc/license; http:// www.keplerproject.org/md5/license.html; http://www.toedter.com/en/jcalendar/license.html; http://www.edankert.com/bounce/index.html; http://www.net-snmp.org/about/ license.html; http://www.openmdx.org/#faq; http://www.php.net/license/3_01.txt; http://srp.stanford.edu/license.txt; http://www.schneier.com/blowfish.html; http:// www.jmock.org/license.html; http://xsom.java.net; http://benalman.com/about/license/; https://github.com/createjs/easeljs/blob/master/src/easeljs/display/bitmap.js; http://www.h2database.com/html/license.html#summary; http://jsoncpp.sourceforge.net/license; http://jdbc.postgresql.org/license.html; http:// protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto; https://github.com/rantav/hector/blob/master/license; http://web.mit.edu/kerberos/krb5- current/doc/mitk5license.html; http://jibx.sourceforge.net/jibx-license.html; https://github.com/lyokato/libgeohash/blob/master/license; https://github.com/hjiang/jsonxx/ blob/master/license; https://code.google.com/p/lz4/; https://github.com/jedisct1/libsodium/blob/master/license; http://one-jar.sourceforge.net/index.php? page=documents&file=license; https://github.com/esotericsoftware/kryo/blob/master/license.txt; http://www.scala-lang.org/license.html; https://github.com/tinkerpop/ blueprints/blob/master/license.txt; http://gee.cs.oswego.edu/dl/classes/edu/oswego/cs/dl/util/concurrent/intro.html; https://aws.amazon.com/asl/; https://github.com/ twbs/bootstrap/blob/master/license; https://sourceforge.net/p/xmlunit/code/head/tree/trunk/license.txt. Este produto inclui software licenciado de acordo com a Academic Free License (http://www.opensource.org/licenses/afl-3.0.php), a Common Development and Distribution License (http://www.opensource.org/licenses/cddl1.php), a Common Public License (http://www.opensource.org/licenses/cpl1.0.php), a Sun Binary Code License Agreement Supplemental License Terms, a BSD License (http://www.opensource.org/licenses/bsd-license.php), a nova BSD License (http://opensource.org/ licenses/bsd-3-clause), a MIT License (http://www.opensource.org/licenses/mit-license.php), a Artistic License (http://www.opensource.org/licenses/artisticlicense-1.0) e a Initial Developer s Public License Version 1.0 (http://www.firebirdsql.org/en/initial-developer-s-public-license-version-1-0/). Este produto inclui copyright do software 2003-2006 Joe WaInes, 2006-2007 XStream Committers. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em http://xstream.codehaus.org/license.html. Este produto inclui software desenvolvido pelo Indiana University Extreme! Lab. Para obter mais informações, visite http://www.extreme.indiana.edu/. 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. Consulte as patentes em https://www.informatica.com/legal/patents.html. ISENÇÃO DE RESPONSABILIDADE: a Informatica LLC 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 LLC não garante que este software ou documentação não contenha 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-UTG-961-HF4-0001

Conteúdo Prefácio.... 13 Recursos da Informatica.... 13 Rede da Informatica.... 13 Base de Dados de Conhecimento da Informatica.... 14 Documentação da Informatica.... 14 Matrizes de Disponibilidade de Produto Informatica.... 14 Informatica Marketplace.... 14 Suporte Global a Clientes da Informatica.... 14 Capítulo 1: Introdução aos Utilitários do PowerExchange.... 15 Visão Geral dos Utilitários do PowerExchange.... 15 Utilitários do PowerExchange por Sistema Operacional.... 17 Convenções de Sintaxe dos Utilitários do PowerExchange... 18 Incompatibilidades de Variável de Ambiente entre o PowerExchange e o PowerCenter.... 18 Definindo o Ambiente do PowerExchange e Iniciando um Utilitário.... 19 Amostra de JCL do PowerExchange.... 19 Capítulo 2: createdatamaps - Utilitário de Criação do Mapa de Dados.... 21 Visão Geral do Utilitário createdatamaps.... 21 Requisitos e Considerações para Copybooks COBOL e DBDs.... 22 Sintaxe do Comando createdatamaps.... 22 Criando, Editando e Testando um Mapa de Dados.... 24 Arquivos de Controle para Geração de um Mapa de Dados.... 25 Regras para Arquivos de Controle.... 25 Estrutura de Arquivo de Controle.... 26 Arquivo de Esquema para a Descrição de Arquivos de Controle.... 28 Referência de Arquivos de Esquema.... 30 Tipo Complexo DatamapGeneration.... 30 Tipo Complexo GenBase.... 30 Tipo Complexo SEQGen.... 31 Tipo Complexo VSAMGen.... 31 Tipo Complexo IMSGen.... 32 Tipo Complexo GenConfigBase.... 32 Tipo Complexo SEQGenConfig.... 33 Tipo Complexo VSAMGenConfig.... 33 Tipo Complexo IMSGenConfig.... 34 Tipo Complexo DatamapPropertiesBase.... 34 Tipo Complexo SEQDatamapProperties.... 34 Tipo Complexo VSAMDatamapProperties.... 34 Tipo Complexo IMSDatamapProperties.... 35 4 Sumário

Tipo Complexo ParserConfigBase.... 36 Tipo Complexo CopybookParserConfig.... 36 Tipo Complexo FilePath.... 37 Tipo Complexo ImportMetadataBase.... 37 Tipo Complexo CopybookImportMetadata.... 38 Tipo Complexo DBDImportMetadata.... 38 Tipo Complexo OverlayMetadata.... 38 Tipo Complexo DatamapInstanceBase.... 38 Tipo Complexo SEQDatamapInstance.... 39 Tipo Complexo VSAMDatamapInstance.... 39 Tipo Complexo IMSDatamapInstance.... 40 Arquivo de Log do Utilitário de Criação de Mapas de Dados.... 40 Mensagens de Erro JAXB.... 41 Instruções REDEFINES em Copybooks Importados.... 42 Como o Utilitário createdatamaps Cria Registros para Campos e Grupos Redefinidos.... 42 Uso de maxredefines para Limitar o Número de Registros.... 43 Copybook e Metadados DBD para Mapas de Dados IMS.... 44 Propriedades de Mapa de Dados Indisponíveis.... 44 Exemplos.... 45 Exemplo: Mapa de Dados SEQ Simples.... 45 Exemplo: Mapa de Dados SEQ com Vários Registros e Tabelas.... 47 Exemplo: Mapa de dados VSAM KSDS Simples.... 50 Exemplo: Mapas de Dados VSAM RRDS com Vários Registros e Tabelas.... 51 Exemplo: Importação de IMS DBD sem Sobreposição COBOL.... 53 Exemplo: Importação de IMS DBD com Sobreposições COBOL.... 55 Capítulo 3: DTLCCADW - Utilitário Adabas PCAT.... 60 Visão Geral do Utilitário DTLCCADW.... 60 Funções do Utilitário DTLCCADW.... 60 Função P (Preencher Arquivo de Controle PCAT).... 61 Função R (Reportar Arquivo de Controle PCAT).... 61 Função I (Inserir).... 61 Função D (Excluir).... 61 Função L (Redefinir Último Número da Sequência).... 61 Função V (Recriar o Arquivo de Controle PCAT).... 62 Função A (Adicionar).... 62 Função S (Submeter ADASEL).... 62 Função T (Submeter Extração de Registro ET).... 62 Função E (Extração de Registro ET/BT).... 62 Capítulo 4: DTLCUIML - Utilitário Marcador do Log do IMS.... 63 Visão Geral do Utilitário DTLCUIML.... 63 Parâmetros do Utilitário DTLCUIML.... 64 Sumário 5

Relatórios do Utilitário DTLCUIML.... 64 SYSPRINT: Relatório de Controle.... 64 DFSSTAT: Relatório de Atividades do IMS.... 65 Registros de Log Definidos pelo Usuário.... 65 Capítulo 5: DTLINFO - Utilitário de Informações de Liberação.... 66 Visão Geral do Utilitário DTLINFO.... 66 Sistemas Operacionais Suportados para o Utilitário DTLINFO.... 66 Sintaxe das Instruções de Controle do Utilitário DTLINFO.... 67 Parâmetros de Instruções de Controle do Utilitário DTLINFO.... 67 Executando o Utilitário DTLINFO no i5/os.... 67 Executando o Utilitário DTLINFO no Linux, UNIX e Windows.... 68 Executando o Utilitário DTLINFO no z/os.... 68 Exemplos do Utilitário DTLINFO no i5/os.... 69 Utilitário DTLINFO no i5/os - Exemplo 1.... 69 Utilitário DTLINFO no i5/os - Exemplo 2.... 69 Exemplos do Utilitário DTLINFO no Linux, UNIX e Windows.... 69 Utilitário DTLINFO no Linux, UNIX e Windows - Exemplo 1.... 69 Utilitário DTLINFO no Linux, UNIX e Windows - Exemplo 2.... 69 Exemplos do Utilitário DTLINFO no z/os.... 70 Utilitário DTLINFO no z/os - Exemplo 1.... 70 Utilitário DTLINFO no z/os - Exemplo 2.... 70 Capítulo 6: DTLREXE - Utilitário de Execução Remota.... 71 Visão Geral do Utilitário DTLREXE.... 71 Sistemas Operacionais Suportados para o Utilitário DTLREXE.... 71 Sintaxe das Instruções de Controle do Utilitário DTLREXE.... 72 Parâmetros das Instruções de Controle do Utilitário DTLREXE.... 72 Instrução DELETE.... 72 Instrução PING.... 74 Instrução SUBMIT.... 75 Instrução SYSTEM.... 77 Executando o Utilitário DTLREXE no i5/os.... 77 Executando o Utilitário DTLREXE no Linux e UNIX.... 78 Submetendo um Trabalho Remoto do z/os Especificando um Membro PDS.... 78 Submetendo um Trabalho Remoto do z/os Especificando um Conjunto de Dados MVS Sequencial.... 78 Excluindo um Arquivo de um Sistema Remoto.... 78 Executando um Arquivo em um Sistema Remoto.... 78 Executando o Utilitário DTLREXE no Windows.... 79 Executando o Utilitário DTLREXE no z/os.... 79 Executando o Utilitário DTLREXE com PROG=SUBMIT.... 79 Executando o Utilitário DTLREXE com PROG=PING.... 80 6 Sumário

Executando o Utilitário DTLREXE com PROG=DELETE.... 80 Executando o Utilitário DTLREXE com PROG=SYSTEM.... 80 Notas de Uso do Utilitário DTLREXE.... 81 Exemplo do Utilitário DTLREXE no z/os.... 81 Exemplo de JCL do Utilitário DTLREXE no z/os.... 82 Conjunto de Dados de Saída do Utilitário DTLREXE no z/os.... 82 Capítulo 7: DTLUAPPL - Utilitário de Token de Reinicialização.... 84 Visão Geral do Utilitário DTLUAPPL.... 84 Sistemas Operacionais Suportados para o Utilitário DTLUAPPL.... 85 Sintaxe da Instrução de Controle DTLUAPPL.... 85 Instrução de Conexão.... 86 Instruções ADD e MOD.... 87 Instrução END APPL.... 90 Instrução PRINT APPL.... 90 Executando o Utilitário DTLUAPPL no i5/os.... 91 Executando o Utilitário DTLUAPPL no Linux, UNIX e Windows.... 91 Executando o Utilitário DTLUAPPL no z/os.... 91 Exemplos do Utilitário DTLUAPPL.... 93 Exemplo 1. Gerando Tokens de Reinicialização no Nível de Aplicativo.... 93 Exemplo 2. Gerando Tokens de Reinicialização no Nível de Registro de Captura.... 94 Exemplo 3. Gerando Tokens de Reinicialização para Modo de Extração Contínua.... 94 Exemplo 4. Adicionando um Aplicativo com Tokens de Reinicialização.... 94 Exemplo 5. Adicionando um Aplicativo e Gerando Tokens de Reinicialização em uma Instância Remota.... 95 Exemplo 6. Modificando Tokens de Reinicialização em um Aplicativo.... 95 Exemplo 7. Modificando um Aplicativo e Adicionando um Registro.... 95 Exemplo 8. Imprimindo Informações para um Aplicativo.... 96 Capítulo 8: DTLUCBRG - Utilitário de Registro em Lotes.... 97 Visão Geral do Utilitário DTLUCBRG.... 97 Sistemas Operacionais Suportados para o Utilitário DTLUCBRG.... 98 Parâmetros do Utilitário DTLUCBRG.... 98 Especificando Vários Conjuntos de Parâmetros no Utilitário DTLUCBRG.... 105 Parâmetros Específicos da Fonte do Utilitário DTLUCBRG.... 105 Exemplo de Entrada para o Utilitário DTLUCBRG.... 108 Processamento de Página de Código DTLUCBRG.... 109 Processamento de página de código para os registros do DB2 no modo local no z/os.... 110 Executando o Utilitário DTLUCBRG.... 110 Executando o Utilitário DTLURDMO no i5/os.... 110 Executando o Utilitário DTLUCBRG no Linux, UNIX e Windows.... 110 Executando o Utilitário DTLUCBRG no z/os.... 111 Notas de Uso do Utilitário DTLUCBRG.... 113 Sumário 7

Capítulo 9: DTLUCDEP - Utilitário de Manutenção CDEP.... 114 Visão Geral do Utilitário DTLUCDEP.... 114 Sistemas Operacionais Suportados para o Utilitário DTLUCDEP... 115 Sintaxe das Instruções de Controle do Utilitário DTLUCDEP.... 115 Parâmetros das Instruções de Controle do Utilitário DTLUCDEP.... 115 Exemplos de Definições do CDEP.... 117 Executando o Utilitário DTLUCDEP no i5/os.... 117 Executando o Utilitário DTLUCDEP no Linux, UNIX e Windows.... 117 Executando o Utilitário DTLUCDEP no z/os.... 117 Exemplo do Utilitário DTLUCDEP no i5/os.... 119 Exemplo do Utilitário DTLUCDEP no Linux, UNIX e Windows.... 120 Exemplo do Utilitário DTLUCDEP no z/os.... 120 Capítulo 10: DTLUCSR2 - Utilitário de Registros IDMS SR2 e SR3.... 122 Visão Geral do Utilitário DTLUCSR2.... 122 Executando o Utilitário DTLUCSR2.... 123 Capítulo 11: DTLUCUDB - Utilitário do DB2 para Linux, UNIX e Windows CDC 124 Visão Geral do Utilitário DTLUCUDB.... 124 Executando o Utilitário DTLUCUDB.... 124 Sintaxe do Utilitário DTLUCUDB.... 125 Opções de Comando do Utilitário DTLUCUDB.... 126 Reunindo Informações de Diagnóstico para Resolver um Problema de Captura do DB2.... 132 Capítulo 12: DTLULCAT e DTLULOGC - Utilitários de Catálogo de Logs IDMS. 133 Visão Geral dos Utilitários DTLULCAT e DTLULOGC.... 133 Executando o Utilitário DTLULCAT.... 134 Executando o Utilitário DTLULOGC.... 134 Manipulando Manualmente o Catálogo de Logs.... 135 Diretrizes para Adicionar Logs ao Catálogo com os Utilitários DTLULCAT e DTLULOGC.... 138 Capítulo 13: DTLURDMO - Utilitário de Mapa de Dados.... 140 Visão Geral do Utilitário DTLURDMO.... 140 Sistemas Operacionais Suportados para o Utilitário DTLURDMO.... 141 Visão Geral das Instruções de Controle do Utilitário DTLURDMO.... 141 Sintaxe de Instruções de Controle do Utilitário DTLURDMO.... 141 Instruções de Controle e Parâmetros do Utilitário DTLURDMO... 142 Instruções Globais.... 142 Instrução DM_COPY.... 147 Instrução REG_COPY.... 153 Instrução XM_COPY.... 162 Escopo de Operandos.... 169 8 Sumário

Executando o Utilitário DTLURDMO no i5/os.... 170 Executando o Utilitário DTLURDMO no Linux, UNIX e Windows.... 171 Executando o Utilitário DTLURDMO no z/os.... 171 Exemplos do Utilitário DTLURDMO.... 172 Copiando Mapas de Dados Selecionados.... 172 Copiando Todos os Mapas de Dados.... 172 Copiando e Modificando Mapas de Dados.... 172 Copiando Registros e Gerando Mapas de Extração.... 173 Copiando Registros, Gerando Mapas de Extração e Mesclando Mapas de Extração com Mapas de Dados em Massa.... 173 Copiando Registros do Microsoft SQL Server e Gerando Mapas de Extração com um ID de Instância definido pelo Usuário.... 173 Copiando Mapas de Dados de IMS e Copiando e Modificando Registros.... 174 Copiando Mapas de Dados de IMS e Registros e Modificando a Propriedade do Mapa de Dados do IMSID.... 175 Capítulo 14: DTLUTSK - Utilitário de Controle de Tarefa.... 177 Visão Geral do Utilitário DTLUTSK.... 177 Utilitário de Linha de Comando DTLUTSK no i5/os.... 178 Utilitário de Linha de Comando DTLUTSK no Linux, UNIX e Windows.... 179 Ajuda do Utilitário DTLUTSK no Linux, UNIX e Windows.... 181 Trabalho DTLUTSK no MVS.... 181 Trabalho DTLUTSK no MVS - Exemplo de JCL.... 181 Trabalho DTLUTSK no MVS - Exemplo de Saída.... 182 Utilitário da Linha de Comando DTLUTSK no MVS.... 183 Comando LISTTASK no MVS.... 183 Comando STOPTASK no MVS.... 183 Comando LISTLOCATIONS no MVS.... 183 Comando LISTALLOC no MVS.... 184 Comando FREEALLOC no MVS.... 184 Executando o Utilitário DTLUTSK no Navegador do PowerExchange.... 185 Requisitos de Segurança do Utilitário DTLUTSK.... 185 Requisitos de Segurança do Utilitário DTLUTSK no MVS.... 185 Requisitos de Segurança do Utilitário DTLUTSK no i5/os.... 185 Usando o Signon.txt para Autorizar Usuários a Exibir ou Interromper Tarefas.... 186 Capítulo 15: EDMLUCTR - Utilitário de Digitalização e Impressão de Log.... 187 Visão Geral do Utilitário EDMLUCTR.... 187 Sistemas Operacionais Suportados para o Utilitário EDMLUCTR.... 187 Sintaxe das Instruções de Controle do Utilitário EDMLUCTR.... 188 Parâmetros das Instruções de Controle do Utilitário EDMLUCTR.... 188 Instrução -SEL.... 188 Instrução -MASK.... 189 Sumário 9

Executando o Utilitário EDMLUCTR.... 190 Notas de Uso do Utilitário EDMLUCTR.... 190 Exemplos do Utilitário EDMLUCTR.... 191 Utilitário EDMLUCTR - Exemplo 1.... 191 Utilitário EDMLUCTR - Exemplo 2.... 192 Utilitário EDMLUCTR - Exemplo 3.... 192 Utilitário EDMLUCTR - Exemplo 4.... 193 Capítulo 16: EDMXLUTL - Utilitário do Marcador de Eventos.... 195 Visão Geral do Utilitário EDMXLUTL.... 195 Criando um Marcador de Eventos no Modo em Lotes.... 195 Instruções da JCL do Utilitário EDMXLUTL.... 196 Instruções de Controle do Utilitário EDMXLUTL.... 196 Comando EVENT do Utilitário EDMXLUTL.... 196 Sintaxe do Comando EVENT.... 197 Uso do Comando EVENT.... 197 Conjuntos de Palavras-chave para a Categoria BASEEDM.... 197 Conjunto de Palavras-chave MARK.... 198 Conjunto de Palavras-chave NOTIFY.... 198 Exemplo do Utilitário EDMXLUTL.... 200 Capítulo 17: HOSTENT - Utilitário Gerador de Relatórios de Endereços TCP/IP.... 201 Visão Geral do Utilitário HOSTENT.... 201 Sistemas Operacionais Suportados para o Utilitário HOSTENT.... 201 Executando o Utilitário HOSTENT no i5/os.... 202 Executando o Utilitário HOSTENT no Linux e UNIX.... 202 Executando o Utilitário HOSTENT no z/os.... 202 Notas de Uso do Utilitário HOSTENT.... 203 Detalhes do Resolvedor do Utilitário HOSTENT.... 203 Saída do Utilitário HOSTENT.... 204 Exemplo do Utilitário HOSTENT no i5/os.... 205 Exemplo do Utilitário HOSTENT no Linux e UNIX.... 205 Exemplo do Utilitário HOSTENT no z/os.... 205 Capítulo 18: PWXUCDCT - Utilitário do Agente de Log do PowerExchange para Linux, UNIX e Windows.... 206 Visão Geral do Utilitário PWXUCDCT.... 206 Sistemas Operacionais com Suporte para o Utilitário PWXUCDCT.... 207 Sintaxe de Instruções de Controle para Comandos PWXUCDCT.... 207 Comandos e Parâmetros PWXUCDCT.... 208 Comandos.... 208 Descrições de Parâmetros.... 213 10 Sumário

Executando o Utilitário PWXUCDCT.... 215 Notas de Uso do Utilitário PWXUCDCT.... 215 Exemplos de Comandos do Utilitário PWXUCDCT.... 215 Exemplo 1. Criando um Backup do Arquivo CDCT.... 215 Exemplo 2. Restaurando o Arquivo CDCT de um Arquivo de Backup.... 216 Exemplo 3. Recriando o Arquivo CDCT Após uma Falha.... 216 Exemplo 4. Reportando e Excluindo Registros CDCT Órfãos.... 217 Exemplo 5. Reportando e Excluindo Registros CDCT Expirados... 218 Exemplo 6. Imprimindo o Conteúdo do Arquivo CDCT.... 220 Capítulo 19: PWXUCREG - Utilitário de Suspensão de Registro de Captura.... 223 Visão Geral do Utilitário PWXUCREG.... 223 Considerações de Uso do PWXUCREG.... 224 Sistemas Operacionais Suportados para o Utilitário PWXUCREG.... 225 Suspendendo Temporariamente a Captura de Alterações para Origens Registradas.... 226 Sintaxe Geral para Comandos PWXUCREG.... 227 Resumo dos Comandos PWXUCREG.... 228 Parâmetros SET_CONTROL_VALUE Globais.... 233 Parâmetros de Comando Específicos de Registro.... 236 Executando o Utilitário PWXUCREG.... 238 Exemplos de Comandos do Utilitário PWXUCREG.... 239 Exemplo 1. Suspendendo um Registro de Captura.... 239 Exemplo 2. Reativando um Registro de Captura.... 240 Capítulo 20: PWXUDMX - Utilitário de Memória ECSA de Hora de Atualização dos Mapas de Dados.... 243 Visão Geral do Utilitário PWXUDMX.... 243 Sistemas Operacionais Suportados para o Utilitário PWXUDMX.... 244 Executando o Utilitário PWXUDMX no z/os.... 244 Comandos e Parâmetros PWXUDMX.... 245 Comando CREATE_ECSA.... 245 Comando DECREMENT_FILE_COUNT.... 245 Comando DELETE_ECSA.... 245 Comando DISPLAY_ECSA.... 245 Comando DUMP_ECSA.... 246 Comando INCREMENT_FILE_COUNT.... 246 Capítulo 21: PWXUSSL - Utilitário de Relatório SSL do PowerExchange.... 247 Visão Geral do Utilitário PWXUSSL.... 247 Sistemas Operacionais Suportados para o Utilitário PWXUSSL.... 248 Executando o Utilitário PWXUSSL.... 248 Relatório de Certificado.... 248 Relatório de Criptografia.... 249 Sumário 11

Relatório de Versão.... 251 Índice.... 252 12 Sumário

Prefácio Este guia descreve uma coletânea de programas utilitários que foram projetados para auxiliar na manutenção da instalação do PowerExchange. 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 PowerExchange for DB2 for Linux, UNIX, and Windows PowerExchange for DB2 for z/os PowerExchange for IMS PowerExchange for Oracle PowerExchange for SQL Server PowerExchange for VSAM Recursos da Informatica Rede da Informatica A Rede da Informatica hospeda o Suporte Global a Clientes da Informatica, a Base de Dados de Conhecimento da Informatica e outros recursos de produtos. Para acessar a Rede da Informatica, visite https://network.informatica.com. Como membro, você pode: Acessar todos os seus recursos Informatica em um só lugar. Pesquisar a Base de Dados de Conhecimento em busca de recursos de produtos, incluindo documentações, perguntas frequentes e práticas recomendadas. Visualizar informações sobre disponibilidade de produtos. Revisar seus casos de suporte. Encontrar a sua Rede de Grupo de Usuários da Informatica local e colaborar com seus colegas. 13

Base de Dados de Conhecimento da Informatica Use a Base de Dados de Conhecimento da Informatica para pesquisar a Rede da Informatica em busca de recursos de produtos, como documentações, artigos de instruções, práticas recomendadas e PAMs. Para acessar a Base de Dados de Conhecimento, visite https://kb.informatica.com. Em caso de 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 em KB_Feedback@informatica.com. Documentação da Informatica Para obter a documentação mais recente do seu produto, navegue pela Base de Dados de Conhecimento da Informatica em.https://kb.informatica.com/_layouts/productdocumentation/page/productdocumentsearch.aspx Em caso de dúvidas, comentários ou ideias sobre esta documentação, entre em contato com a equipe de Documentação da Informatica pelo e-mail infa_documentation@informatica.com. Matrizes de Disponibilidade de Produto Informatica As Matrizes de Disponibilidade de Produto (PAMs) indicam as versões dos sistemas operacionais, os bancos de dados e outros tipos de fontes e destinos de dados com os quais uma versão de produto é compatível. Se você for membro da Rede da Informatica, poderá acessar PAMs em https://network.informatica.com/community/informatica-network/product-availability-matrices. Informatica Marketplace O Informatica Marketplace é um fórum onde você pode encontrar soluções que aumentam, ampliam ou aprimoram suas implementações da Informatica. Aproveitando qualquer uma das centenas de soluções fornecidas por desenvolvedores e parceiros da Informatica, você pode melhorar sua produtividade e agilizar o tempo de implementação nos seus projetos. Você pode acessar o Informatica Marketplace através do link https://marketplace.informatica.com. Suporte Global a Clientes da Informatica Você pode entrar em contato com um Centro de Suporte Global por telefone ou via Suporte Online na Rede da Informatica. Para descobrir o número de telefone local do Suporte Global a Clientes da Informatica, visite o site da Informatica no seguinte link: http://www.informatica.com/us/services-and-training/support-services/global-support-centers. Se você for membro da Rede da Informatica, poderá usar o Suporte Online em http://network.informatica.com. 14 Prefácio

C A P Í T U L O 1 Introdução aos Utilitários do PowerExchange Este capítulo inclui os seguintes tópicos: Visão Geral dos Utilitários do PowerExchange, 15 Utilitários do PowerExchange por Sistema Operacional, 17 Convenções de Sintaxe dos Utilitários do PowerExchange, 18 Incompatibilidades de Variável de Ambiente entre o PowerExchange e o PowerCenter, 18 Amostra de JCL do PowerExchange, 19 Visão Geral dos Utilitários do PowerExchange Este guia destina-se aos administradores do PowerExchange que executam um ou mais utilitários para gerenciar suas instalações do PowerExchange. Cada capítulo oferece alguma ou toda a seguinte informação de referência com relação a um utilitário específico: As tarefas que podem ser executadas com o utilitário Cada pré-requisito para a execução do utilitário Os sistemas nos quais o utilitário pode ser executado A sintaxe dos comandos e parâmetros do utilitário Descrições detalhadas dos parâmetros obrigatórios e opcionais Como emitir as instruções de controle do utilitário nos vários sistemas Exemplos de sintaxe do utilitário por sistema operacional e/ou tarefa O PowerExchange inclui os seguintes utilitários para ajudar a gerenciar a instalação: createdatamaps - Utilitário de criação do mapa de dados. Use o createdatamaps para gerar mapas de dados em fontes de dados IMS, sequencial e VSAM na linha de comando do Windows. O createdatamaps é uma opção de comando infacmd pwx. DTLCCADW - Utilitário de arquivo PCAT do Adabas. Use o DTLCCADW para manipular o conteúdo do arquivo PCAT. DTLCUIML - Utilitário marcador do log do IMS. Use DTLCUIML para definir um marcador para o ECCR com base em logs do IMS no system log data set (SLDS) do IMS. 15

DTLINFO - Utilitário de informações de compilação. Use o DTLINFO para exibir o nível de versão, liberação e compilação do PowerExchange. DTLREXE - Utilitário de programa remoto. Use o DTLREXE para executar programas em plataformas remotas. DTLUAPPL - Utilitário de token de reinicialização. Use DTLUAPPL para atualizar o arquivo CDEP com aplicativos e registros de captura especificados. DTLUCBRG - Utilitário de registro em lotes. Use o utilitário DTLUCBRG para adicionar ou modificar registros de captura e mapas de extração. DTLUCDEP - Utilitário CDEP. Use o DTLUCDEP para modificar ou imprimir o conteúdo do arquivo CDEP. DTLUCSR2 - Utilitário de registros SR2 e SR3 do IDMS. Use o DTLUCSR2 para determinar a posição dos registros SR3. DTLUCUDB - Utilitário CDC do DB2. Use o DTLUCUDB para criar um snapshot do catálogo a fim de inicializar a tabela do catálogo de capturas e gerar informações de diagnóstico. DTLULCAT e DTLULOGC - Utilitários de catálogo de logs do IDMS. Use DTLULCAT e DTLULOGC para preencher o catálogo de logs com informações sobre os logs a serem processados. DTLURDMO - Utilitário de mapa de dados. Use o DTLURDMO para migrar mapas de dados, bem como capturar registros e definições de mapa de extração, de um ambiente ou local para outro. DTLUTSK - Utilitário de controle de tarefa. Use o DTLUTSK para listar as tarefas ativas e interrompê-las, se for necessário. EDMLUCTR - Utilitário de digitalização e impressão de logs do PowerExchange. Use o EDMLUCTR para exibir informações sobre as alterações capturadas nos logs do Agente de Log do PowerExchange ou para diagnosticar problemas relacionados à captura de alterações. EDMXLUTL - Utilitário marcador de eventos. Use o EDMXLUTL para criar um marcador de eventos no Agente de Log do PowerExchange. HOSTENT - Utilitário Gerador de Relatórios de Endereços TCP/IP. Use HOSTENT para exibir o nome do host e o endereço TCP/IP de um sistema e para diagnosticar problemas de comunicação e licença do PowerExchange. PWXUCDCT - Utilitário do Agente de Log do PowerExchange para Linux, UNIX e Windows. Use o PWXUCDCT para gerenciar e gerar novamente o arquivo CDCT, excluir arquivos de log que não são referidos pelos registros CDCT e imprimir relatórios do arquivo CDCT, dos arquivos de ponto de verificação e dos arquivos de log. PWXUCREG - Utilitário de Suspensão de Registro de Captura do PowerExchange Use o PWXUCREG para suspender temporariamente o processamento de captura de alterações para origens registradas. Posteriormente, você pode usar o utilitário para reativar os registros suspensos para retomar a captura de alterações. PWXUDMX - Utilitário de memória ECSA de Hora de Atualização dos Mapas de Dados do PowerExchange. Use o utilitário PWXUDMX para alocar, exibir e excluir a memória ECSA, que mantém carimbos de data/hora das últimas atualizações em arquivos de mapas de dados, bem como para modificar as contagens de uso de um arquivo. PWXUSSL - Utilitário de Relatório SSL do PowerExchange. Use o PWXUSSL para gerar relatórios sobre bibliotecas e certificados SSL no Linux, UNIX e Windows. 16 Capítulo 1: Introdução aos Utilitários do PowerExchange

Utilitários do PowerExchange por Sistema Operacional A tabela a seguir lista os sistemas operacionais nos quais cada utilitário pode ser executado: Utilitário Linux UNIX Windows z/os i5/os createdatamaps Não Não Sim Não Não DTLCCADW Não Não Não Sim, no Adabas somente DTLCUIML Não Não Não Sim, no IMS somente Não Não DTLINFO Sim Sim Sim Sim Sim DTLREXE Sim Sim Sim Sim Sim DTLUAPPL Sim Sim Sim Sim Sim DTLUCBRG Sim Sim Sim Sim Sim DTLUCDEP Sim Sim Sim Sim Sim DTLUCSR2 Não Não Não Sim, no CDC do IDMS somente Não DTLUCUDB Sim, no DB2 somente Sim, no DB2 somente Sim, no DB2 somente Não Não DTLULCAT e DTLULOGC Não Não Não Sim, no CDC com Base em Logs do IDMS somente Não DTLURDMO Sim Sim Sim Sim Sim DTLUTSK Sim Sim Sim Sim Sim EDMLUCTR Não Não Não Sim Não EDMXLUTL Não Não Não Sim Não HOSTENT Sim Sim Não Sim Sim PWXUCDCT Sim Sim Sim Não Não PWXUCREG Não Não Não Sim Não PWXUDMX Não Não Não Sim Não PWXUSSL Sim Sim Sim Não Não Utilitários do PowerExchange por Sistema Operacional 17

Convenções de Sintaxe dos Utilitários do PowerExchange Este guia usa as seguintes convenções de sintaxe de comandos e parâmetros de utilitários: Para a maioria dos nomes de comandos e nomes de parâmetros, usam-se todas as letras em MAIÚSCULAS, não importando o tipo de plataforma. Entretanto, parâmetros posicionais para os quais você especifica um determinado valor são mostrados em minúsculo e itálico, por exemplo, instância. Colchetes [ ] indicam parâmetros opcionais. Considere obrigatório qualquer parâmetro sem colchetes. Uma barra vertical separa opções alternativas dentre as quais uma pode ser especificada para um parâmetro. Entradas alternativas são colocadas entre chaves simples { }. Use apenas uma das entradas. Não digite as chaves quando você digitar a opção. Sublinhado indica a opção padrão para um parâmetro, se disponível. Itálico indica um parâmetro variável ou posicional cujo valor varia. 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, exceto o utilitário createdatamaps 18 Capítulo 1: Introdução aos Utilitários do PowerExchange

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. Definindo o Ambiente do PowerExchange e Iniciando um Utilitário Se você executa o PowerExchange e o PowerCenter com a mesma conta de usuário e precisa criar ambientes separados para o PowerExchange e o PowerCenter, execute o script pwxsettask.sh ou pwxsettask.bat para iniciar um utilitário do PowerExchange. O script define as variáveis PATH e LD_LIBRARY_PATH corretamente para o PowerExchange. Para definir o ambiente do PowerExchange e iniciar um utilitário do PowerExchange no Linux ou UNIX, emita o seguinte comando: pwxsettask.sh utility_name parameter_list Para definir o ambiente do PowerExchange e iniciar um utilitário do PowerExchange no Windows, emita o seguinte comando: pwxsettask utility_name parameter_list parameter_list representa uma lista de expressões no formato parameter=value. Ao executar o script no Windows, você deve incluir cada expressão parameter=value entre aspas duplas. No Linux e no UNIX, as aspas são opcionais. Por exemplo, para iniciar o utilitário DTLUCBRG no Windows: pwxsettask dtlucbrg "cs=filename" Amostra de JCL do PowerExchange Ao instalar o PowerExchange no z/os, a amostra de JCL é instalada na biblioteca HLQ.RUNLIB. Amostra de JCL do PowerExchange 19

Se você tiver selecionado a opção Excluir Membros da Instalação na guia Selecionar Parâmetros Adicionais do Assistente de Instalação do z/os, o processo de instalação moverá a amostra de JCL para a biblioteca HLQ.DTLEXPL. 20 Capítulo 1: Introdução aos Utilitários do PowerExchange

C A P Í T U L O 2 createdatamaps - Utilitário de Criação do Mapa de Dados Este capítulo inclui os seguintes tópicos: Visão Geral do Utilitário createdatamaps, 21 Requisitos e Considerações para Copybooks COBOL e DBDs, 22 Sintaxe do Comando createdatamaps, 22 Criando, Editando e Testando um Mapa de Dados, 24 Arquivos de Controle para Geração de um Mapa de Dados, 25 Arquivo de Esquema para a Descrição de Arquivos de Controle, 28 Referência de Arquivos de Esquema, 30 Arquivo de Log do Utilitário de Criação de Mapas de Dados, 40 Instruções REDEFINES em Copybooks Importados, 42 Copybook e Metadados DBD para Mapas de Dados IMS, 44 Propriedades de Mapa de Dados Indisponíveis, 44 Exemplos, 45 Visão Geral do Utilitário createdatamaps Use o utilitário createdatamaps para gerar mapas de dados em fontes de dados IMS, sequencial e VSAM na linha de comando do Windows. O utilitário oferece uma alternativa ao uso do Navegador do PowerExchange em determinados casos e permite que você gere ou gere novamente mapas de dados de maneira não interativa. Para executar o utilitário, use o comando infacmd pwx createdatamaps. Os serviços Informatica ou o Cliente Informatica devem estar instalados na máquina Windows na qual o comando é executado. Você pode criar vários mapas de dados por execução, mas suas fontes de dados devem ser do mesmo tipo. Use o utilitário createdatamaps somente para criar novos mapas de dados. Não use o utilitário para modificar mapas de dados que já estão em uso. O utilitário createdatamaps não é compatível com o IMS Versão 12 ou posterior. Nota: Se houver um erro de memória Java no comando, aumente a disponibilidade de memória do sistema para o infacmd. Para aumentar a memória do sistema, defina o valor -Xmx na variável de ambiente ICMD_JAVA_OPTS. Para obter mais informações, consulte a Referência de Comandos da Informatica. 21

Requisitos e Considerações para Copybooks COBOL e DBDs O utilitário createdatamaps importa metadados de copybooks COBOL e DBDs. Os seguintes requisitos e considerações se aplicam: Você pode importar metadados de apenas um copybook COBOL para cada mapa de dados sequencial ou VSAM que criar. Você pode importar metadados de um copybook COBOL para cada segmento em um mapa de dados IMS. Se o copybook de um mapa de dados sequenciais ou VSAM incluir vários registros de nível 01, o utilitário criará um registro e uma tabela no mapa de dados para cada registro de nível 01 no copybook. Se o copybook de um mapa de dados IMS incluir vários registros de nível 01, o utilitário criará um registro e uma tabela somente para o primeiro registro de nível 01 no copybook. É possível importar metadados de apenas um DBD para cada mapa de dados do IMS que você criar. Opcionalmente, você pode sobrepor os metadados do DBD com os metadados de um copybook COBOL para cada segmento que o DBD define. Para mapas de dados do IMS, se o DBD ou a sobreposição do copybook COBOL inclui redefinições de campo, o utilitário cria um registro somente para a primeira combinação de campos redefinidos. Sintaxe do Comando createdatamaps O comando infacmd pwx createdatamaps usa a seguinte sintaxe: infacmd pwx createdatamaps [<-pwxlocation -loc> pwx_location] [<-pwxusername -pun> pwx_user_name] [<-pwxpassword -ppd> pwx_password] [<-pwxencryptedpassword -epwd> pwx_encrypted_password] [<-datamapoutputdir -dod> datamap_output_directory] [<-replace -r> replace_existing_datamaps <-controlfile -cf> file_path_for_control_file [<-logfile -lf> file_path_for_log_file] [<-verbosity -v> logging_verbosity] 22 Capítulo 2: createdatamaps - Utilitário de Criação do Mapa de Dados

A tabela a seguir descreve as opções e os argumentos do infacmd pwx createdatamaps: Opção Argumento Descrição -pwxlocation -loc -pwxusername -pun -pwxpassword -ppd pwx_location pwx_user_name pwx_password Opcional. A localização da fonte de dados conforme especificada em uma instrução NODE no arquivo de configuração dbmover do PowerExchange. Se pwxlocation não for especificado, o utilitário createdatamaps acessará o copybook e os metadados do DBD no sistema local. Opcional. A ID do usuário para conexão com o Ouvinte do PowerExchange, se pwxlocation for especificado. Opcional. A senha para conexão com o Ouvinte do PowerExchange, se pwxlocation for especificado. Em vez de uma senha, você pode inserir um código de acesso válido do PowerExchange. Os códigos de acesso para acessar um Ouvinte do PowerExchange no z/os podem ter de 9 a 128 caracteres e 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. Se um código de acesso contiver espaços, você deverá colocá-lo entre aspas duplas ("), por exemplo, "Este é um exemplo de código de acesso". Se um código de acesso contiver caracteres especiais, você deverá colocá-lo entre três caracteres de aspas duplas ("""), por exemplo, """Este código de acesso contém caracteres especiais! % & *.""". Se um código de acesso contiver somente caracteres alfanuméricos sem espaços, você poderá inseri-lo sem delimitadores. 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. Sintaxe do Comando createdatamaps 23