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

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

Informatica PowerExchange Guia de Utilitários Versão 9.5.1 Dezembro 2012 Copyright (c) 1998-2012 Informatica Corporation. Todos os direitos reservados. Este software e a respectiva documentação contêm informações de propriedade da Informatica Corporation. Eles são fornecidos sob um contrato de licença que contém restrições quanto a seu uso e divulgação, e são protegidos por leis de copyright. A engenharia reversa do software é proibida. Não está permitida de forma alguma a reprodução ou a transmissão de qualquer parte deste documento (seja por meio eletrônico, fotocópia, gravação ou quaisquer outros) sem o consentimento prévio da Informatica Corporation. Este Software pode estar protegido por patentes dos EUA e/ou internacionais e outras patentes pendentes. O uso, duplicação ou divulgação do Software pelo Governo dos Estados Unidos estão sujeitos às restrições estipuladas no contrato de licença de software aplicável e como estabelecido em DFARS 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 and Informatica Master Data Management são marcas comerciais ou marcas registradas da Informatica Corporation nos Estados Unidos e em jurisdisdições pelo mundo. Todos os outros nomes de empresas 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 (C) 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 (C) University of Toronto. Todos os direitos reservados. Copyright Daniel Veillard. Todos os direitos reservados. Copyright Unicode, Inc. Copyright IBM Corp. Todos os direitos reservados. Copyright MicroQuill Software Publishing, Inc. Todos os direitos reservados. Copyright PassMark Software Pty Ltd. Todos os direitos reservados. Copyright LogiXML, Inc. Todos os direitos reservados. Copyright 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. Este produto inclui software desenvolvido pela Apache Software Foundation (http://www.apache.org/) e outros softwares licenciados pela Apache License, Versão 2.0 (a "Licença"). Você pode obter uma cópia da Licença em http://www.apache.org/licenses/license-2.0. A menos que exigido pela legislação aplicável ou concordado por escrito, o software distribuído sob a Licença é fornecido em uma base "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA OU CONDIÇÃO DE QUALQUER TIPO, seja expressa ou implícita. Consulte a Licença para conhecer as limitações e as permissões que regulam o idioma específico de acordo com a Licença. Este produto inclui software desenvolvido pela Mozilla (http://www.mozilla.org/), direitos autorais de software de The JBoss Group, LLC; todos os direitos reservados; direitos autorais de software 1999-2006 de Bruno Lowagie e Paulo Soares e outros produtos de software licenciados sob a Licença Pública GNU LGPL (Lesser General Public License), 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-2007, 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 direitos autorais de software 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 direitos autorais de software 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. Permissões e limitações relativas a este software estão sujeitas aos termos disponíveis em http://www.eclipse.org/org/documents/epl-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://www.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://developer.apple.com/library/mac/#samplecode/helphook/listings/helphook_java.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; and http://benalman.com/about/license/. Este produto inclui softwares licenciados de acordo com a Licença Acadêmica Livre (http://www.opensource.org/licenses/afl-3.0.php), a Licença de Distribuição e Desenvolvimento Comum (http://www.opensource.org/licenses/cddl1.php), a Licença Pública Comum (http://www.opensource.org/licenses/cpl1.0.php), os Termos Complementares de Licença do Acordo de Licença de Código Binário da Sun, a Licença BSD (http:// www.opensource.org/licenses/bsd-license.php. a Licença MIT (http:// www.opensource.org/licenses/mit-license.php) e a Licença Artística (http://www.opensource.org/licenses/artistic-license-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 desenvolvido por Andrew Kachites McCallum. "MALLET: A Machine Learning for Language Toolkit." http://mallet.cs.umass.edu (2002). Esse software é protegido pelos números de patentes dos EUA 5,794,246; 6,014,670; 6,016,501; 6,029,178; 6,032,158; 6,035,307; 6,044,374; 6,092,086; 6,208,990; 6,339, 775; 6,640,226; 6,789,096; 6,820,077; 6,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,243,110, 7,254,590; 7,281,001; 7,421,458; 7,496,588; 7,523,121; 7,584, 422; 7676516; 7,720,842; 7,721,270 e 7,774,791, patentes internacionais e outras patentes pendentes. ISENÇÃO DE RESPONSABILIDADE: a Informatica Corporation fornece esta documentação no estado em que se encontra, sem garantia de qualquer tipo, expressa ou implícita, incluindo, mas não limitando-se, as garantias implícitas de não infração, comercialização ou uso para um determinado propósito. A Informatica Corporation não garante que este software ou documentação esteja sem erros. As informações fornecidas neste software ou documentação podem incluir imprecisões técnicas ou erros tipográficos. As informações deste software e documentação estão sujeitas a alterações a qualquer momento sem aviso prévio. AVISOS Este produto da Informatica (o "Software") traz determinados drivers (os "drivers da DataDirect") da DataDirect Technologies, uma empresa da Progress Software Corporation ("DataDirect"), sendo esses 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-951-0001

Conteúdo Prefácio.... viii Recursos da Informatica.... viii Portal de Clientes da Informatica.... viii Documentação da Informatica.... viii Site da Informatica.... ix Biblioteca de Recursos da Informatica.... ix Base de Dados de Conhecimento da Informatica.... ix Base de Dados de Conhecimento Multimídia da Informatica.... ix Suporte Global a Clientes da Informatica.... ix Capítulo 1: Introdução aos Utilitários do PowerExchange.... 1 Visão Geral dos Utilitários do PowerExchange.... 1 Utilitários do PowerExchange por Sistema Operacional.... 2 Convenções de Sintaxe dos Utilitários do PowerExchange... 3 Amostra de JCL do PowerExchange.... 4 Capítulo 2: DTLCCADW - Utilitário Adabas PCAT.... 5 Visão Geral do Utilitário DTLCCADW.... 5 Funções do Utilitário DTLCCADW.... 5 Função P (Preencher Arquivo de Controle PCAT).... 5 Função R (Reportar Arquivo de Controle PCAT).... 6 Função I (Inserir).... 6 Função D (Excluir).... 6 Função L (Redefinir Último Número da Sequência).... 6 Função V (Recriar o Arquivo de Controle PCAT).... 6 Função A (Adicionar).... 7 Função S (Submeter ADASEL).... 7 Função T (Submeter Extração de Registro ET).... 7 Função E (Extração de Registro ET/BT).... 7 Capítulo 3: DTLCUIML - Utilitário Marcador do Log do IMS.... 8 Visão Geral do Utilitário DTLCUIML.... 8 Parâmetros do Utilitário DTLCUIML.... 8 Relatórios do Utilitário DTLCUIML.... 9 SYSPRINT: Relatório de Controle.... 9 DFSSTAT: Relatório de Atividades do IMS.... 9 Registros de Log Definidos pelo Usuário.... 10 Capítulo 4: DTLINFO - Utilitário de Informações de Liberação.... 11 Visão Geral do Utilitário DTLINFO.... 11 Sistemas Operacionais Suportados para o Utilitário DTLINFO.... 11 Sintaxe das Instruções de Controle do Utilitário DTLINFO.... 12 Parâmetros de Instruções de Controle do Utilitário DTLINFO.... 12 Sumário i

Executando o Utilitário DTLINFO no i5/os.... 12 Executando o Utilitário DTLINFO no Linux, UNIX e Windows.... 12 Executando o Utilitário DTLINFO no z/os.... 13 Exemplos do Utilitário DTLINFO no i5/os.... 13 Utilitário DTLINFO no i5/os - Exemplo 1.... 13 Utilitário DTLINFO no i5/os - Exemplo 2.... 13 Exemplos do Utilitário DTLINFO no Linux, UNIX e Windows.... 14 Utilitário DTLINFO no Linux, UNIX e Windows - Exemplo 1.... 14 Utilitário DTLINFO no Linux, UNIX e Windows - Exemplo 2.... 14 Exemplos do Utilitário DTLINFO no z/os.... 14 Utilitário DTLINFO no z/os - Exemplo 1.... 14 Utilitário DTLINFO no z/os - Exemplo 2.... 14 Capítulo 5: DTLREXE - Utilitário de Execução Remota.... 15 Visão Geral do Utilitário DTLREXE.... 15 Sistemas Operacionais Suportados para o Utilitário DTLREXE.... 15 Sintaxe das Instruções de Controle do Utilitário DTLREXE.... 16 Parâmetros das Instruções de Controle do Utilitário DTLREXE.... 16 Instrução DELETE.... 16 Instrução PING.... 17 Instrução SUBMIT.... 17 Instrução SYSTEM.... 18 Executando o Utilitário DTLREXE no i5/os.... 19 Executando o Utilitário DTLREXE no Linux e UNIX.... 19 Submetendo um Trabalho Remoto do z/os Especificando um Membro PDS.... 19 Submetendo um Trabalho Remoto do z/os Especificando um Conjunto de Dados MVS Sequencial.... 19 Excluindo um Arquivo de um Sistema Remoto.... 19 Executando um Arquivo em um Sistema Remoto.... 20 Executando o Utilitário DTLREXE no Windows.... 20 Executando o Utilitário DTLREXE no z/os.... 20 Executando o Utilitário DTLREXE com PROG=SUBMIT.... 20 Executando o Utilitário DTLREXE com PROG=PING.... 21 Executando o Utilitário DTLREXE com PROG=DELETE.... 21 Executando o Utilitário DTLREXE com PROG=SYSTEM.... 21 Notas de Uso do Utilitário DTLREXE.... 22 Exemplo do Utilitário DTLREXE no z/os.... 22 Exemplo de JCL do Utilitário DTLREXE no z/os.... 23 Conjunto de Dados de Saída do Utilitário DTLREXE no z/os.... 23 Capítulo 6: DTLUAPPL - Utilitário de Token de Reinicialização.... 24 Visão Geral do Utilitário DTLUAPPL.... 24 Sistemas Operacionais Suportados para o Utilitário DTLUAPPL.... 25 Instruções de Conexão do Utilitário DTLUAPPL.... 25 Sintaxe de Instrução de Conexão.... 25 Parâmetros de Instrução de Conexão.... 25 Instruções de Entrada de Aplicativo para o Utilitário DTLUAPPL.... 26 ii Sumário

Sintaxe de Instruções ADD e MOD.... 26 Parâmetros das Instruções ADD e MOD.... 26 Executando o Utilitário DTLUAPPL no i5/os.... 28 Executando o Utilitário DTLUAPPL no Linux, UNIX e Windows.... 28 Executando o Utilitário DTLUAPPL no z/os.... 29 Notas de Uso do Utilitário DTLUAPPL.... 30 Exemplos do Utilitário DTLUAPPL.... 30 Gerando Tokens de Reinicialização no Nível de Aplicativo.... 31 Gerando Tokens de Reinicialização no Nível de Registro de Captura.... 31 Gerando Tokens de Reinicialização para Modo de Extração Contínua.... 31 Adicionando um Aplicativo com Tokens de Reinicialização.... 31 Adicionando um Aplicativo e Gerando Tokens de Reinicialização em uma Instância Remota.. 32 Modificando Tokens de Reinicialização em um Aplicativo.... 32 Modificando um Aplicativo e Adicionando um Registro.... 32 Imprimindo um Aplicativo.... 32 Capítulo 7: DTLUCBRG - Utilitário de Registro em Lotes.... 34 Visão Geral do Utilitário DTLUCBRG.... 34 Sistemas Operacionais Suportados para o Utilitário DTLUCBRG... 34 Parâmetros do Utilitário DTLUCBRG.... 35 Especificando Vários Conjuntos de Parâmetros no Utilitário DTLUCBRG.... 39 Parâmetros Específicos da Fonte do Utilitário DTLUCBRG.... 39 Processamento de Página de Código DTLUCBRG.... 41 Processamento de página de código para os registros do DB2 no modo local no z/os.... 42 Executando o Utilitário DTLUCBRG.... 42 Amostra de Entrada para o Utilitário DTLUCBRG.... 42 Executando o Utilitário DTLURDMO no i5/os.... 43 Executando o Utilitário DTLUCBRG no Linux, UNIX e Windows.... 43 Executando o Utilitário DTLUCBRG no z/os.... 43 Notas de Uso do Utilitário DTLUCBRG.... 45 Capítulo 8: DTLUCDEP - Utilitário de Manutenção CDEP.... 46 Visão Geral do Utilitário DTLUCDEP.... 46 Sistemas Operacionais Suportados para o Utilitário DTLUCDEP... 46 Sintaxe das Instruções de Controle do Utilitário DTLUCDEP.... 47 Parâmetros das Instruções de Controle do Utilitário DTLUCDEP.... 47 Exemplos de Definições do CDEP.... 48 Executando o Utilitário DTLUCDEP no i5/os.... 48 Executando o Utilitário DTLUCDEP no Linux, UNIX e Windows.... 48 Executando o Utilitário DTLUCDEP no z/os.... 48 Exemplo do Utilitário DTLUCDEP no i5/os.... 50 Exemplo do Utilitário DTLUCDEP no Linux, UNIX e Windows.... 50 Exemplo do Utilitário DTLUCDEP no z/os.... 51 Capítulo 9: DTLUCSR2 - Utilitário de Registros IDMS SR2 e SR3.... 52 Visão Geral do Utilitário DTLUCSR2.... 52 Executando o Utilitário DTLUCSR2.... 52 Sumário iii

Capítulo 10: DTLUCUDB - Utilitário do DB2 para Linux, UNIX e Windows CDC.. 54 Visão Geral do Utilitário DTLUCUDB.... 54 Executando o Utilitário DTLUCUDB.... 54 Sintaxe do Utilitário DTLUCUDB.... 54 Opções de Comando do Utilitário DTLUCUDB.... 56 Reunindo Informações de Diagnóstico para Resolver um Problema de Captura do DB2.... 61 Capítulo 11: DTLULCAT e DTLULOGC - Utilitários de Catálogo de Logs IDMS... 62 Visão Geral dos Utilitários DTLULCAT e DTLULOGC.... 62 Executando o Utilitário DTLULCAT.... 63 Executando o Utilitário DTLULOGC.... 63 Manipulando Manualmente o Catálogo de Logs.... 64 Diretrizes para Adicionar Logs ao Catálogo com os Utilitários DTLULCAT e DTLULOGC.... 67 Capítulo 12: DTLURDMO - Utilitário de Mapa de Dados.... 68 Visão Geral do Utilitário DTLURDMO.... 68 Sistemas Operacionais Suportados para o Utilitário DTLURDMO.... 68 Visão Geral das Instruções de Controle do Utilitário DTLURDMO.... 69 Sintaxe das Instruções de Controle do Utilitário DTLURDMO.... 69 Instruções de Controle e Parâmetros do Utilitário DTLURDMO.... 70 Instruções Globais.... 70 Instrução DM_COPY.... 73 Instrução REG_COPY.... 78 Instrução XM_COPY.... 85 Executando o Utilitário DTLURDMO no i5/os.... 90 Executando o Utilitário DTLURDMO no Linux, UNIX e Windows.... 90 Executando o Utilitário DTLURDMO no z/os.... 90 Exemplos do Utilitário DTLURDMO.... 91 Copiando Mapas de Dados Selecionados.... 91 Copiando Todos os Mapas de Dados.... 92 Copiando e Modificando Mapas de Dados.... 92 Copiando Registros e Gerando Mapas de Extração.... 92 Copiando Registros, Gerando Mapas de Extração e Mesclando Mapas de Extração com Mapas de Dados em Massa.... 92 Copiando Mapas de Dados de IMS e Copiando e Modificando Registros.... 93 Copiando Mapas de Dados de IMS e Registros e Modificando a Propriedade do Mapa de Dados do IMSID.... 93 Escopo de Operandos.... 95 Capítulo 13: DTLUTSK - Utilitário de Controle de Tarefa.... 97 Visão Geral do Utilitário DTLUTSK.... 97 Utilitário de Linha de Comando DTLUTSK no i5/os.... 97 Utilitário de Linha de Comando DTLUTSK no Linux, UNIX e Windows.... 98 Ajuda do Utilitário DTLUTSK no Linux, UNIX e Windows.... 99 Trabalho DTLUTSK no MVS.... 99 Trabalho DTLUTSK no MVS - Exemplo de JCL.... 99 Trabalho DTLUTSK no MVS - Exemplo de Saída.... 100 iv Sumário

Utilitário da Linha de Comando DTLUTSK no MVS.... 100 Comando LISTTASK no MVS.... 100 Comando STOPTASK no MVS....100 Comando LISTLOCATIONS no MVS....101 Comando LISTALLOC no MVS.... 101 Comando FREEALLOC no MVS....101 Executando o Utilitário DTLUTSK no Navegador do PowerExchange.... 102 Requisitos de Segurança do Utilitário DTLUTSK.... 102 Requisitos de Segurança do Utilitário DTLUTSK no MVS....102 Requisitos de Segurança do Utilitário DTLUTSK no i5/os.... 102 Usando o Signon.txt para Autorizar Usuários a Exibir ou Interromper Tarefas....102 Capítulo 14: EDMLUCTR - Utilitário de Digitalização e Impressão de Log....104 Visão Geral do Utilitário EDMLUCTR....104 Sistemas Operacionais Suportados para o Utilitário EDMLUCTR....104 Sintaxe das Instruções de Controle do Utilitário EDMLUCTR.... 105 Parâmetros das Instruções de Controle do Utilitário EDMLUCTR....105 Instrução -SEL....105 Instrução -MASK....106 Executando o Utilitário EDMLUCTR.... 106 Notas de Uso do Utilitário EDMLUCTR.... 107 Exemplos do Utilitário EDMLUCTR....107 Utilitário EDMLUCTR - Exemplo 1....107 Utilitário EDMLUCTR - Exemplo 2....108 Utilitário EDMLUCTR - Exemplo 3....108 Utilitário EDMLUCTR - Exemplo 4....109 Capítulo 15: EDMXLUTL - Utilitário do Marcador de Eventos....111 Visão Geral do Utilitário EDMXLUTL....111 Criando um Marcador de Eventos no Modo em Lotes.... 111 Instruções da JCL do Utilitário EDMXLUTL....112 Instruções de Controle do Utilitário EDMXLUTL....112 Comando EVENT do Utilitário EDMXLUTL.... 112 Sintaxe do Comando EVENT....112 Uso do Comando EVENT.... 113 Conjuntos de Palavras-chave para a Categoria BASEEDM....113 Conjunto de Palavras-chave MARK....113 Conjunto de Palavras-chave NOTIFY.... 114 Exemplo do Utilitário EDMXLUTL....115 Capítulo 16: HOSTENT - Utilitário Gerador de Relatórios de Endereços TCP/IP. 117 Visão Geral do Utilitário HOSTENT....117 Sistemas Operacionais Suportados para o Utilitário HOSTENT... 117 Executando o Utilitário HOSTENT no i5/os.... 118 Executando o Utilitário HOSTENT no Linux e UNIX.... 118 Executando o Utilitário HOSTENT no z/os... 118 Notas de Uso do Utilitário HOSTENT....119 Sumário v

Detalhes do Resolvedor do Utilitário HOSTENT....119 Saída do Utilitário HOSTENT.... 119 Exemplo do Utilitário HOSTENT no i5/os.... 120 Exemplo do Utilitário HOSTENT no Linux e UNIX.... 120 Exemplo do Utilitário HOSTENT no z/os.... 120 Capítulo 17: PWXUCDCT - Utilitário do Agente de Log do PowerExchange para Linux, UNIX e Windows.... 122 Visão Geral do Utilitário PWXUCDCT.... 122 Sistemas Operacionais Suportados para o Utilitário PWXUCDCT.... 123 Sintaxe das Instruções de Controle para Comandos PWXUCDCT.... 123 Comandos e Parâmetros PWXUCDCT.... 123 Resumo de Comandos.... 123 Descrições de Parâmetros.... 126 Executando o Utilitário PWXUCDCT.... 128 Notas de Uso do Utilitário PWXUCDCT.... 128 Exemplos de Comandos do Utilitário PWXUCDCT.... 128 Exemplo 1. Criando um Backup do Arquivo CDCT.... 129 Exemplo 2. Restaurando o Arquivo CDCT de um Arquivo de Backup.... 129 Exemplo 3. Recriando o Arquivo CDCT Após uma Falha.... 129 Exemplo 4. Reportando e Excluindo Registros CDCT Órfãos.... 130 Exemplo 5. Reportando e Excluindo Registros CDCT Expirados.... 131 Exemplo 6. Determinando Porque um Ponto de Verificação Foi Criado.... 131 Exemplo 7. Inicializando a Quente o Agente de Log do PowerExchange para um Ponto Anterior no Tempo.... 132 Capítulo 18: PWXUCREG - Utilitário de Suspensão de Registro de Captura.... 134 Visão Geral do Utilitário PWXUCREG.... 134 Considerações de Uso do PWXUCREG.... 135 Sistemas Operacionais Suportados para o Utilitário PWXUCREG.... 136 Suspendendo Temporariamente a Captura de Alterações para Origens Registradas.... 136 Sintaxe Geral para Comandos PWXUCREG.... 137 Resumo dos Comandos PWXUCREG.... 138 Parâmetros SET_CONTROL_VALUE Globais.... 140 Parâmetros de Comando Específicos de Registro.... 143 Executando o Utilitário PWXUCREG.... 145 Exemplos de Comandos do Utilitário PWXUCREG.... 145 Exemplo 1. Suspendendo um Registro de Captura.... 145 Exemplo 2. Reativando um Registro de Captura.... 146 Capítulo 19: PWXUDMX - Utilitário de Memória ECSA de Hora de Atualização dos Mapas de Dados.... 148 Visão Geral do Utilitário PWXUDMX.... 148 Sistemas Operacionais Suportados para o Utilitário PWXUDMX.... 148 Executando o Utilitário PWXUDMX no z/os.... 149 Comandos e Parâmetros PWXUDMX.... 149 Comando CREATE_ECSA.... 149 Comando DECREMENT_FILE_COUNT.... 150 vi Sumário

Comando DELETE_ECSA.... 150 Comando DISPLAY_ECSA.... 150 Comando DUMP_ECSA.... 150 Comando INCREMENT_FILE_COUNT.... 150 Capítulo 20: PWXUSSL - Utilitário de Relatório SSL do PowerExchange.... 151 Visão Geral do Utilitário PWXUSSL.... 151 Sistemas Operacionais Suportados para o Utilitário PWXUSSL.... 151 Executando o Utilitário PWXUSSL.... 152 Relatório de Certificado.... 152 Relatório de Criptografia.... 153 Relatório de Versão.... 154 Índice.... 155 Sumário vii

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 Portal de Clientes da Informatica Na qualidade de cliente da Informatica, você pode acessar o site Portal de Clientes da Informatica no endereço http://mysupport.informatica.com. O site contém informações de produtos e de grupo de usuários, boletins informativos, acesso ao sistema de gerenciamento de casos de suporte a clientes da Informatica (ATLAS), à Biblioteca de Recursos da Informatica, à Base de Dados de Conhecimento da Informatica, à Base de Dados de Conhecimento Multimídia da Informatica, à Documentação de Produtos da Informatica e acesso à comunidade de usuários da Informatica. Documentação da Informatica A equipe de Documentação da Informatica se esforça ao máximo para criar documentações precisas e utilizáveis. Se você tiver dúvidas, comentários ou ideias sobre esta documentação, entre em contato com a equipe de Documentação da Informatica pelo e-mail infa_documentation@informatica.com. Nós usaremos seu feedback para melhorar a documentação. Por favor, avise-nos se pudermos entrar em contato com você em relação aos comentários. A equipe de Documentação atualiza a documentação conforme o necessário. Para obter a documentação mais recente do seu produto, navegue para Documentação do Produto no endereço http://mysupport.informatica.com. viii

Site da Informatica Você pode acessar o site corporativo da Informatica no endereçohttp://www.informatica.com. O site contém informações sobre a Informatica, seu histórico, eventos futuros e escritórios de vendas. Você também vai encontrar informações sobre parceiros e produtos. A área de serviços do site inclui informações importantes sobre suporte técnico, treinamento e educação, bem como serviços de implementação. Biblioteca de Recursos da Informatica Na qualidade de cliente da Informatica, você pode acessar a Biblioteca de Recursos da Informatica no endereço http://mysupport.informatica.com. A Biblioteca de Recursos é uma coletânea de recursos que o ajuda a aprender mais sobre os produtos e recursos da Informatica. Ela inclui artigos e demonstrações interativas que apresentam soluções a problemas comuns, comparam recursos e comportamentos e o orienta na execução de tarefas específicas no mundo real. Base de Dados de Conhecimento da Informatica Na qualidade de cliente da Informatica, você pode acessar a Base de Dados de Conhecimento da Informatica no endereço http://mysupport.informatica.com. Use a Base de Dados de Conhecimento para pesquisar soluções documentadas a problemas técnicos conhecidos sobre produtos da Informatica. Você também pode encontrar respostas a perguntas frequentes, white papers e dicas técnicas. Se você tiver dúvidas, comentários ou ideias sobre a Base de Dados de Conhecimento, entre em contato com a equipe da Base de Dados de Conhecimento da Informatica pelo e-mail KB_Feedback@informatica.com. Base de Dados de Conhecimento Multimídia da Informatica Na qualidade de cliente da Informatica, você pode acessar a Base de Dados de Conhecimento Multimídia da Informatica no endereço http://mysupport.informatica.com. A Base de Dados de Conhecimento Multimídia é uma coleção de arquivos multimídia de instrução que o ajuda a aprender os conceitos comuns e o orienta na execução de tarefas específicas. Se você tiver dúvidas, comentários ou ideias sobre a Base de Dados de Conhecimento Multimídia, entre em contato com a equipe da Base de Dados de Conhecimento da Informatica pelo e-mail KB_Feedback@informatica.com. Suporte Global a Clientes da Informatica Você pode entrar em contato com o Centro de Suporte a Clientes por telefone ou pelo Suporte Online. O Suporte Online requer um nome de usuário e uma senha. Você pode solicitar um nome de usuário e uma senha no endereço http://mysupport.informatica.com. Use os números de telefone a seguir para entrar em contato com o Suporte Global a Clientes da Informatica: América do Norte / América do Sul Europa / Oriente Médio / África Ásia / Austrália Ligação Gratuita Brasil: 0800 891 0202 México: 001 888 209 8853 América do Norte: +1 877 463 2435 Ligação Gratuita França: 0805 804632 Alemanha: 0800 5891281 Itália: 800 915 985 Holanda: 0800 2300001 Portugal: 800 208 360 Espanha: 900 813 166 Suíça: 0800 463 200 Reino Unido: 0800 023 4632 Ligação Gratuita Austrália: 1 800 151 830 Nova Zelândia: 09 9 128 901 Tarifa Padrão Índia: +91 80 4112 5738 Tarifa Padrão Bélgica: +31 30 6022 797 França: + 33 1 4138 9226 Prefácio ix

América do Norte / América do Sul Europa / Oriente Médio / África Ásia / Austrália Alemanha: +49 1805 702 702 Holanda: +31 306 022 797 Reino Unido: +44 1628 511445 x 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, 1 Utilitários do PowerExchange por Sistema Operacional, 2 Convenções de Sintaxe dos Utilitários do PowerExchange, 3 Amostra de JCL do PowerExchange, 4 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: 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. 1

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. Se o utilitário estiver disponível apenas para bancos de dados específicos, estes serão listados. Utilitário Linux UNIX Windows z/os i5/os DTLCCADW Sim, no Adabas somente DTLCUIML Sim, no IMS somente DTLINFO Sim Sim Sim Sim Sim DTLREXE Sim Sim Sim Sim Sim 2 Capítulo 1: Introdução aos Utilitários do PowerExchange

Utilitário Linux UNIX Windows z/os i5/os DTLUAPPL Sim Sim Sim Sim Sim DTLUCBRG Sim Sim Sim Sim Sim DTLUCDEP Sim Sim Sim Sim Sim DTLUCSR2 Sim, no CDC do IDMS somente DTLUCUDB Sim, no DB2 somente Sim, no DB2 somente Sim, no DB2 somente DTLULCAT e DTLULOGC Sim, no CDC com Base em Logs do IDMS somente DTLURDMO Sim Sim Sim Sim Sim DTLUTSK Sim Sim Sim Sim Sim EDMLUCTR Sim EDMXLUTL Sim HOSTENT Sim Sim Sim Sim PWXUCDCT Sim Sim Sim PWXUCREG Sim PWXUDMX Sim PWXUSSL Sim Sim Sim 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 nomes de comandos e para a maioria dos 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, instance. 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. Convenções de Sintaxe dos Utilitários do PowerExchange 3

Amostra de JCL do PowerExchange Ao instalar o PowerExchange no z/os, a amostra de JCL é instalada na biblioteca HLQ.RUNLIB. 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. 4 Capítulo 1: Introdução aos Utilitários do PowerExchange

C A P Í T U L O 2 DTLCCADW - Utilitário Adabas PCAT Este capítulo inclui os seguintes tópicos: Visão Geral do Utilitário DTLCCADW, 5 Funções do Utilitário DTLCCADW, 5 Visão Geral do Utilitário DTLCCADW O programa utilitário PCAT, DTLCCADW, é usado pelo processo Adabas ECCR para manipular o conteúdo do arquivo PCAT. O utilitário PCAT é controlado pelas definições dos parâmetros transmitidos por meio do PARM= na instrução EXEC. Há exemplos da JCL que são necessários para cada função na biblioteca DTLEXPL do PowerExchange com nomes DTLCCADx, onde x corresponde ao valor do parâmetro. Normalmente, essas funções são usadas apenas internamente pelo PowerExchange. Entretanto, pode haver momentos em que substituições manuais são desejáveis, as quais são descritas a seguir. Quando estiver em dúvida sobre o uso, entre em contato com o Suporte Global a Clientes da Informatica. Funções do Utilitário DTLCCADW O utilitário DTLCCADW tem as seguintes funções: P (Preencher arquivo de controle PCAT) R (Reportar arquivo de controle PCAT) I (Inserir) D (Excluir) L (Redefinir último número de sequência) V (Recriar arquivo de controle PCAT) A (Adicionar) S (Submeter ADASEL) T (Submeter extração de registro ET) E (Extração de registro ET/BT) Função P (Preencher Arquivo de Controle PCAT) Exemplo de trabalho DTLCCADP - nenhum outro parâmetro é necessário. 5

Essa função pode ser usada depois que o Arquivo de Controle VSAM for estabelecido inicialmente com seu registro de controle 999999999 para pré-preencher o arquivo PCAT com nomes de conjuntos de dados PLOG criados anteriormente. Por padrão, quando o ECCR do Ababas PowerExchange for iniciado, apenas o PLOG arquivado mais recente será reconhecido. Por isso, se houver necessidade de coletar alterações capturadas mais antigas, essa será a função a ser usada. A lista de nomes de conjuntos de dados é inserida por DDCARD DTLCCADF, diretamente como SYSIN ou em um arquivo de imagens de cartão de 80 bytes. O usuário é responsável por obter esses nomes de conjuntos de dados PLOG. O registro de controle 999999999 PCAT então é atualizado com o número de sequência mais alto adicionado. Nota: Use essa função apenas depois de inicializar o arquivo de controle, não após o início da operação normal. Função R (Reportar Arquivo de Controle PCAT) Exemplo de trabalho DTLCCADR - um segundo parâmetro de número de sequência de arquivo de controle. Imprime em SYSOUT com um Nome DD de DTLCCRPT. O segundo parâmetro opcional permite especificar um número de sequência de arquivo de onde o relatório começará. Se nenhum segundo parâmetro for especificado, o arquivo todo será impresso em SYSOUT. Nota: As funções a seguir podem ser úteis no caso de dificuldades operacionais de PLOG, não relacionadas ao processamento de Alteração do PowerExchange do Adabas. Por exemplo, se os arquivos PLOG saírem da sequência operacionalmente, essas funções assegurarão que o PCAT possa ser redefinido para corrigir a sequência de nome de conjunto de dados também. Função I (Inserir) Exemplo do trabalho DTLCCADI - requer dois parâmetros adicionais. O primeiro é um número de sequência de arquivo de controle PCAT, que não deve existir. O segundo é o nome do conjunto de dados de um PLOG a ser inserido. Nota - O DTLCCADW NÃO verifica se o PLOG está na sequência cronológica correta - é responsabilidade do usuário garantir isso. Função D (Excluir) Exemplo de trabalho DTLCCADD - exige um segundo parâmetro de número de sequência de arquivo de controle. O DTLCCADW lê o registro de controle PCAT e o exclui. Se você excluir o último registro adicionado, deverá executar imediatamente a função L (veja a seguir) para redefinir o valor de chave mais recente no registro de controle 999999999. Função L (Redefinir Último Número da Sequência) Exemplo de trabalho DTLCCADL - nenhum outro parâmetro é necessário. Esta função torna a preencher o campo latest sequence number added no registro de controle 999999999 PCAT. A única circunstância na qual essa função seria necessária é se o usuário excluísse o último registro adicionado, o que invalidaria o registro de controle '999999999'. Função V (Recriar o Arquivo de Controle PCAT) Exemplo de trabalho DTLCCADV - nenhum outro parâmetro é necessário. Essa função pode ser usada para excluir e recriar o registro de controle geral PCAT '999999999'. Nota: As funções a seguir devem ser usadas somente sob orientação do Suporte Global a Clientes da Informatica. 6 Capítulo 2: DTLCCADW - Utilitário Adabas PCAT

Função A (Adicionar) Exemplo de trabalho DTLCCADA - nenhum outro parâmetro é necessário. Assume o PLOG especificado pelo nome do conjunto de dados no DDCARD DTLCCPLG e cria uma entrada no arquivo PCAT, assumindo o número de sequência mais alto adicionado até o momento e adicionando 100 a ele (são deixados intervalos na sequência caso seja necessário inserir PLOGs mais antigos posteriormente). Essa função é chamada automaticamente durante o flip PLOG na JCL que está executando a função PLCOPY e por isso não deverá ser necessário chamá-la manualmente, em operação normal. Função S (Submeter ADASEL) Exemplo de trabalho DTLCCADS - exige um segundo parâmetro de número de sequência de arquivo PCAT. O DTLCCADW lê o registro de controle PCAT especificado pelo número de sequência e constrói um trabalho ADASEL para o nome do conjunto de dados PLOG gravado no registro de controle. Ele submete o trabalho que executa o ADASEL e cria um arquivo de saída, o nome do conjunto de dados gravado no registro de controle. Essa função é chamada automaticamente pelo ECCR e por isso não é necessário chamar manualmente em operação normal. Função T (Submeter Extração de Registro ET) Exemplo de trabalho DTLCCADT - exige um segundo parâmetro de número de sequência de arquivo PCAT. O DTLCCADW lê o registro de controle PCAT especificado pelo número de sequência e constrói outro trabalho DTLCCADW para o PLOG gravado no registro de controle, criando um nome de conjunto de dados para o arquivo ET de saída, usando parâmetros de data e hora. Ele submete o trabalho que lê o PLOG especificado no registro de controle e cria um arquivo de saída de registros ET/BT, o nome do conjunto de dados desse arquivo que então é gravado no registro de controle. Essa função é chamada normalmente pelo ECCR e por isso não é necessário chamar manualmente em operação normal. Função E (Extração de Registro ET/BT) Exemplo de trabalho DTLCCADE - exige um segundo parâmetro de número de sequência de arquivo PCAT. Essa função de fato é a mesma do trabalho criado dinamicamente e submetido pela função T anterior - a diferença é que o usuário precisa definir explicitamente o nome do conjunto de dados do arquivo ET/BT de saída na JCL, DDNAME DTLCCETL, e o nome do PLOG arquivado que está sendo processado no DDNAME DTLCCPLG. O ECCR normalmente controla essa operação e essa função só é especificada no caso de dificuldades que possam exigir intervenção manual. Funções do Utilitário DTLCCADW 7

C A P Í T U L O 3 DTLCUIML - Utilitário Marcador do Log do IMS Este capítulo inclui os seguintes tópicos: Visão Geral do Utilitário DTLCUIML, 8 Parâmetros do Utilitário DTLCUIML, 8 Relatórios do Utilitário DTLCUIML, 9 Visão Geral do Utilitário DTLCUIML Use o utilitário DTLCUIML para definir um marcador para o ECCR com base em logs do IMS no system log data set (SLDS) do IMS. Depois que o ECCR com base em logs do IMS encontra um dos marcadores, ele aciona uma mensagem no Agente de Log do PowerExchange que define um Token de Reinicialização e Sequência para as Marcas de Registro afetadas. Esses tokens podem então ser usados como entrada do Utilitário de Manutenção de Aplicativo (DTLUAPPL) para definir o ponto de partida de uma extração. Não há limite ou restrição no número de marcadores definidos no SLDS do IMS. O ID de Registro de Log do IMS escolhido deve ser exclusivo da instalação individual, e o número precisa fazer parte dos parâmetros de entrada para o ECCR com base em logs do IMS. Esse utilitário é usado para gravar registros definidos pelo usuário no log do IMS. Os parâmetros que controlam o utilitário são especificados no arquivo SYSIN da JCL. O utilitário é executado como programa aplicativo padrão do IMS. Não há necessidade de definir um PSB específico. O utilitário poderá usar qualquer PSB, desde que o primeiro PCB do PSB seja um IOPCB. O utilitário usa a Chamada LOG do IMS para gravar registros de log do IMS. Esse utilitário é executado como trabalho BMP do IMS. Isso assegura que o registro de Log do IMS seja gravado no fluxo de logs do IMS e que o log associado seja lido pelo Coletor com base em logs do IMS. Em uma situação DCI do IMS, o utilitário DTLUAPPL deve ser usado para estabelecer um ponto de extração para os dados alterados. Parâmetros do Utilitário DTLCUIML Definindo parâmetros de entrada no SYSIN. Cada registro SYSIN contém os seguintes parâmetros: DBDNAME. Nome do IMS DBD. DBID. Instância do IMS (Identificador Recon). 8

RECID. Um valor em caracteres hexadecimais (maiúsculos) de A0 até FF. Ele define o tipo do registro de log do IMS definido pelo usuário, por isso deverá ser diferente de qualquer outro valor definido pelo usuário que o site esteja usando. Espaços iniciais são ignorados. Os registros nos quais os primeiros caracteres não-espaço são /* serão ignorados para que possam ser usados como comentários. Exemplo: //SYSIN DD * DBDNAME=DTLD004,DBID=IMS7,RECID=A0 DBDNAME=DTLD006,DBID=IMS7,RECID=A0 DBDNAME=DTLD007,DBID=IMS7,RECID=A0 /* Relatórios do Utilitário DTLCUIML O arquivo SYSPRINT reporta a validação dos parâmetros de entrada e o progresso da gravação no log do IMS. O arquivo DFSSTAT reporta a atividade do IMS. A amostra da JCL é especificada no membro IMSLOGW. SYSPRINT: Relatório de Controle O relatório de controle mostra as seguintes informações: Data e hora de início do programa. Essa hora também é usada em cada registro de log definido pelo usuário gravado no log do IMS. Mensagens de validação para os registros SYSIN. Se algum registro for inválido, a execução será interrompida e nenhum registro será gravado no log do IMS. Mensagens de progresso conforme os registros são gravados no log do IMS. Exemplo: 2002-10-15 14:06:14 DTLCUIML REPORT =====================================================================. Input Records Read ------------------ DBDNAME=DTLD004,DBID=IMS1,RECID=A0 DBDNAME=DTLD006,DBID=IMS1,RECID=A0 DBDNAME=DTLD007,DBID=IMS1,RECID=A0 3 record(s) validated from the input file. LOG record processing begins ----------------------------- Processing dbname=dtld004 dbid=ims1 recid=a0 timestamp=20021015140614 Processing dbname=dtld006 dbid=ims7 recid=a0 timestamp=20021015140614 Processing dbname=dtld007 dbid=ims7 recid=a0 timestamp=20021015140614. Number of LOG calls = 3. Run completed successfully DFSSTAT: Relatório de Atividades do IMS As contagens de SYS LOG CALLS corresponderão ao número de registros processados do arquivo SYSIN. Todas as outras contagens têm valor zero. Exemplo: //DFSSTAT STATISTICS FOR: JOB=UIMLRUN STEP=G ---------------------------------------------- *** PST ACCOUNTING STATISTICS *** SYS LOG CALLS 3 Relatórios do Utilitário DTLCUIML 9