Informatica PowerExchange
(Versão 9.6.1 HotFix 4)
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/license-agreements/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/artistic-license-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.
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 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
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=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
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. . . 124Executando 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. . . 133Executando 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
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
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
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 Versão. . . 251
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.
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
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.
• 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.
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
Não
DTLCUIML Não Não Não Sim, no IMS
somente
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
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
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
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
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.
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]
A tabela a seguir descreve as opções e os argumentos do infacmd pwx createdatamaps:
Opção Argumento Descrição
-pwxLocation -loc
pwx_location 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.
-pwxUserName -pun
pwx_user_name Opcional. A ID do usuário para conexão com o Ouvinte do PowerExchange, se pwxLocation for especificado. -pwxPassword
-ppd
pwx_password 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.
Opção Argumento Descrição
-pwxEncryptedPassword -epwd
pwx_encrypted_password Opcional. A senha criptografada para conexão com o Ouvinte do PowerExchange, se pwxLocation for especificado.
Se o Ouvinte do PowerExchange for executado no sistema z/OS ou i5/OS, você poderá inserir um código de acesso criptografado do PowerExchange em vez de uma senha criptografada. Não criptografe um código de acesso que contenha caracteres inválidos, como aspas duplas, aspas simples ou símbolos monetários. -datamapOutputDir
-dod
datamap_output_directory Opcional. O diretório de arquivo local no qual gravar os mapas de dados de saída. O padrão é o diretório de trabalho atual.
-replace -r
replace_existing_datamaps Opcional. Especifica se os mapas de dados existentes serão substituídos.
Se replace=Y, substitui qualquer mapa de dados em datamap_output_directory que tenha o mesmo nome do mapa de dados que você está criando.
Se replace=N, ignora a criação de um mapa de dados se um mapa de dados com o mesmo nome já existir em datamap_output_directory.
O padrão é N. -controlFile
-cf
file_path_for_control_file Obrigatório. O caminho e o nome de arquivo do arquivo de controle que controla a geração do mapa de dados.
-logFile -lf
file_path_for_log_file Opcional. O caminho e o nome de arquivo do arquivo de log de saída. O padrão é STDOUT.
-verbosity -v
logging_verbosity Opcional. Detalhamento de arquivos de log. O padrão é INFO. Valores válidos:
- DEBUG. O log mais detalhado. Pode mostrar rastreamentos de pilha.
- INFO. Mensagens informativas. - AVISO. Indica um problema em potencial.
- ERRO. Indica uma falha. O processamento continua. - FATAL. Indica uma condição fatal. O processo é
encerrado.
O nome de nó do PowerExchange e as credenciais são opcionais. Se você não incluir a opção pwxLocation, o comando acessa o sistema de arquivos local diretamente para ler os metadados. Nesse caso, o
PowerExchange não precisa ser instalado na máquina na qual você executa o createdatamaps.
Criando, Editando e Testando um Mapa de Dados
Para criar, editar e testar um mapa de dados, execute as seguintes tarefas de alto nível:
1. Se o PowerExchange não estiver instalado na máquina local em que você executará o comando createdatamaps, copie os copybooks e os DBDs na máquina local.
2. Crie o arquivo de controle.
Você pode criar um novo arquivo usando um editor de XML. Ou você pode abrir um arquivo de controle de amostra em um editor de XML, renomear o arquivo e editá-lo conforme necessário.
3. Execute o comando infacmd pwx createdatamaps na linha de comando em qualquer máquina que possa acessar o domínio Informatica.
4. Revise o log de saída. Se ocorrerem erros, corrija-os e execute o comando novamente. 5. Copie o mapa de dados na máquina do Navegador do PowerExchange.
6. Abra o mapa de dados no Navegador do PowerExchange.
Sugestão: Se o Navegador já estiver aberto quando você copiar o mapa de dados, selecione Arquivo > Atualizar Configuração para atualizar a lista de mapas de dados.
7. Se necessário, edite o mapa de dados.
Por exemplo, talvez seja necessário excluir registros não utilizados, atribuir valores de ID de registro ou atribuir outras propriedades que não podem ser atribuídas com o utilitário createdatamaps.
8. Faça um teste de linha do banco de dados.
9. Faça edições adicionais e realize outros testes de linha do banco de dados conforme necessário. 10. Envie o mapa de dados ao nó remoto.
Arquivos de Controle para Geração de um Mapa de
Dados
Um arquivo de controle é um arquivo XML que define as opções e os valores que o utilitário createdatamaps usa para criar um ou mais mapas de dados. Um arquivo de controle fornece uma maneira simples de definir parâmetros e ajuda a tornar o processo de criação de importação em massa facilmente repetível.
Ao executar o comando createdatamaps, forneça o nome do arquivo de controle como parâmetro. Cada arquivo de controle deve estar em conformidade com o esquema que é instalado com o Cliente Informatica e com os serviços Informatica. Para obter mais informações, consulte “Arquivo de Esquema para a Descrição de Arquivos de Controle” na página 28 e “Referência de Arquivos de Esquema” na página 30.
Cada arquivo de controle pode especificar apenas um tipo de fonte de dados.
Após criar o arquivo de controle e executar o comando createdatamaps, talvez você precise editar o mapa de dados no Navegador do PowerExchange.
Exemplos de arquivos de controle são fornecidos com o produto. Para obter mais informações, consulte
“Exemplos” na página 45.
Regras para Arquivos de Controle
Observe as seguintes regras quando você criar um arquivo de controle:
• Todos os elementos XML fazem distinção entre maiúsculas e minúsculas. Para cada elemento, siga as maiúsculas e minúsculas definidas no esquema.
• Os elementos devem aparecer no arquivo de controle na ordem em que são definidos no esquema. O Editor de XML deve indicar os elementos permitidos em cada ponto no arquivo de controle.
• Observe as propriedades que são definidas para cada elemento no arquivo de esquema. Para cada elemento, o arquivo de esquema pode definir as seguintes informações, dependendo do tipo de dados: -Nome
-Cardinalidade, ou seja, o número mínimo e o número máximo de ocorrências -Tipo
-Valores válidos
-Comprimento mínimo e máximo
Estrutura de Arquivo de Controle
Os arquivos de controle XML para mapas de dados sequenciais, VSAM e do IMS têm hierarquias que permitem determinados elementos em pontos específicos.
Cada arquivo de controle inclui os seguintes elementos:
• Elemento raiz DatamapGeneration. Obrigatório.
• Elemento imsGen, seqGen ou vsamGen que é um filho do elemento DatamapGeneration. Obrigatório.
• Elementos globais que se aplicam a todos os mapas de dados definidos pelo arquivo de controle. Esses elementos globais são filhos do elemento imsGen, seqGen ou vsamGen. Opcional.
• Elemento DatamapInstances. Esse elemento é um filho do elemento imsGen, seqGen ou vsamGen. Obrigatório.
• Um elemento imsDatamapInstance, seqDatamapInstance ou vsamDatamapInstance para cada mapa de dados que o arquivo de controle define. Esses elementos são filhos do elemento DatamapInstances. Pelo menos uma instância de elemento é necessária.
Para cada mapa de dados, o elemento imsDatamapInstance, seqDatamapInstance ou vsamDatamapInstance herda e opcionalmente substitui as configurações globais.
As seguintes hierarquias de arquivo de controle não mostram a sintaxe necessária, se o elemento é
obrigatório ou opcional, o número de vezes que o elemento pode ocorrer ou se uma opção de apenas um de vários elementos pode aparecer. Para obter essas informações, consulte“Referência de Arquivos de Esquema” na página 30 ou o arquivo de esquema DatamapGeneration.xsd.
Hierarquia de Arquivos de Controle para Mapas de Dados Sequenciais
Use a seguinte hierarquia de arquivo de controle para mapas de dados sequenciais: DatamapGeneration seqGen globalCopybookParserConfig startColumn endColumn maxRedefines globalGenConfig schemaName datamapName datamapRecordName globalSeqProperties seqFileName zosPath windowsPath as400Pth unixPath datamapInstances seqDatamapInstance genConfig schemaName datamapName
datamapRecordName importCopybookDetails filePath zosPath windowsPath as400Path unixPath parserConfig startColumn endColumn maxRedefines datamapProperties seqFileName zosPath windowsPath as400Pth unixPath
Hierarquia de Arquivos de Controle para Mapas de Dados VSAM
Use a seguinte hierarquia de arquivo de controle para mapas de dados VSAM: DatamapGeneration vsamGen globalCopybookParserConfig startColumn endColumn maxRedefines globalGenConfig schemaName datamapName datamapRecordName globalVsamProperties vsamFileName zosPath windowsPath as400Path unixPath globalMapType datamapInstances vsamDatamapInstance genConfig schemaName datamapName datamapRecordName importCopybookDetails filePath zosPath windowsPath as400Path unixPath parserConfig startColumn endColumn maxRedefines datamapProperties vsamFileName zosPath windowsPath as400Path unixPath
Hierarquia de Arquivos de Controle para Mapas de Dados IMS
Use a seguinte hierarquia de arquivo de controle para mapas de dados do IMS: DatamapGeneration
startColumn endColumn maxRedefines globalGenConfig schemaName datamapName datamapRecordName createTablesForHierPath globalImsProperties mapType imsSSID pcbNumber psbName pcbName datamapInstances imsDatamapInstance genConfig schemaName datamapName datamapRecordName createTablesForHierPath importDBDDetails filePath zosPath windowsPath as400Path unixPath overlayDetails nativeRecordName overlayCopybookDetails filePath zosPath windowsPath as400Path unixPath parserConfig startColumn endColumn maxRedefines datamapProperties mapType imsSSID pcbNumber psbName pcbName
Arquivo de Esquema para a Descrição de Arquivos
de Controle
Cada arquivo de controle deve estar em conformidade com o esquema que é instalado com o Cliente Informatica e com os serviços Informatica.
O arquivo de esquema, chamado DatamapGeneration.xsd, é fornecido nos seguintes diretórios de máquinas nas quais o Cliente Informatica e os serviços Informatica estão respectivamente instalados:
• diretório_de_instalação_do_cliente_Informatica\clients\DeveloperClient\osgi_mf_plugins\jars\resources\
• diretório_de_instalação_de_serviços_Informatica\pwxmfplugins\resources\
O esquema consiste em definições de tipos complexos e elementos, em que um tipo complexo consiste em vários elementos.
Definições de Tipos Complexos no Arquivo de Esquema
Para cada tipo complexo, o arquivo de esquema inclui as seguintes informações:
• Nome
• Tipo base, para tipos complexos que herdam propriedades de um tipo base
• Definições de cada elemento filho
Definições de Elementos no Arquivo de Esquema
Para cada elemento, o arquivo de esquema pode incluir as seguintes informações, dependendo do tipo de dados:
• Nome
• Cardinalidade, ou seja, o número mínimo e o número máximo de ocorrências
• Tipo
• Documentação
• Valores válidos
• Comprimento mínimo e máximo
Usando o Arquivo de Esquema para Determinar a Hierarquia de Arquivos de Controle
Você pode usar um editor de XML para determinar a hierarquia permitida de elementos em um arquivo de controle. Você também pode derivar essas informações do arquivo de esquema.
Por exemplo, o elemento raiz no esquema é DatamapGeneration. A definição do tipo complexo DatamapGeneration especifica a escolha de um dos seguintes elementos filho:
• seqGen, do tipo SEQGen
• vsamGen, do tipo VSAMGen
• imsGen, do tipo IMSGen
A definição do tipo SEQGen especifica que ele é uma extensão do tipo base GenBase, que inclui um único elemento chamado globalCopybookParserConfig. Elementos do tipo SEQGen incluem os elementos definidos pelo tipo GenBase, além dos seguintes elementos:
• globalGenConfig, do tipo SEQGenConfig
• globalSeqProperties, do tipo SEQDatamapProperties
• datamapInstances, que consiste em um elemento, seqDatamapInstance, que pode ocorrer uma ou mais vezes
Portanto, o arquivo de controle para a geração de mapas de dados SEQ tem a seguinte estrutura de nível superior: DatamapGeneration seqGen globalCopybookParserConfig (optional) globalGenConfig (optional) globalSeqProperties (optional) datamapInstances (required)
seqDatamapInstance (at least one required)
Você pode continuar dessa forma para determinar a hierarquia completa de arquivos de controle SEQ, bem como de arquivos de controle VSAM e IMS.
Referência de Arquivos de Esquema
Os seguintes tópicos descrevem cada tipo complexo e elemento no arquivo de esquema, incluindo o tipo, os valores permitidos, a cardinalidade e a descrição.
Tipo Complexo DatamapGeneration
O tipo complexo DatamapGeneration define o elemento de nível superior no arquivo de controle. O tipo complexo DatamapGeneration inclui os seguintes elementos:
Opção (cardinalidade = 1):
• SeqGen
• VSAMGen
• IMSGen
Exatamente uma ocorrência de SeqGen, VSAMGen ou IMSGen é necessária.
seqGen
Elemento para a definição de mapas de dados sequenciais. Tipo = SEQGen
vsamGen
Elemento para a definição de mapas de dados VSAM. Tipo = VSAMGen
imsGen
Elemento para a definição de mapas de dados IMS. Tipo = IMSGen
O tipo complexo DatamapGeneration inclui o atributo necessário xmlSchemaVersion.
xmlSchemaVersion
Última versão de esquema com a qual a instância XML é compatível. Valor = 1.0
Tipo Complexo GenBase
O tipo complexo GenBase é o tipo base para os tipos complexos que definem mapas de dados sequenciais, VSAM e IMS.
O tipo complexo GenBase é o tipo base para os seguintes tipos complexos:
• SEQGen
• VSAMGen
• IMSGen
O tipo complexo GenBase inclui os seguintes elementos:
globalCopybookParserConfig
As propriedades de configuração do analisador de copybook padrão que são aplicadas em nível global. Tipo = CopybookParserConfig
Cardinalidade = 0 a 1
Tipo Complexo SEQGen
O tipo complexo SEQGen define um ou mais mapas de dados para fontes de dados sequenciais.
O tipo complexo SEQGen é uma extensão do tipo complexo GenBase. SEQGen estende GenBase com os seguintes elementos:
• globalGenConfig
• globalSeqProperties
• datamapInstances
globalGenConfig
As propriedades de configuração de um gerador padrão que são aplicadas em nível global. Tipo = SEQGenConfig
Cardinalidade = 0 a 1
globalSeqProperties
Padrões globais para propriedades de mapas de dados SEQ. Tipo = SEQDatamapProperties
Cardinalidade = 0 a 1
datamapInstances
Elemento que contém uma ou mais ocorrências de detalhes da instância do mapa de dados SEQ. Tipo = Contêiner de elementos SeqDatamapInstance
Cardinalidade = 1
Tipo Complexo VSAMGen
O tipo complexo VSAMGen define um ou mais mapas de dados para fontes de dados VSAM. O tipo complexo VSAMGen estende o tipo complexo GenBase com os seguintes elementos:
• globalGenConfig
• globalVSAMProperties
• datamapInstances
globalGenConfig
As propriedades de configuração de um gerador padrão que são aplicadas em nível global. Tipo = VSAMGenConfig
Cardinalidade = 0 a 1