informatica powerexchange (versão 9.0.1) documentation...qualquer objetivo, com ou sem taxa, é...

Informatica PowerExchange (Versão 9.0.1)

Referência de Comandos

Informatica PowerExchange Referência de Comandos

Versão 9.0.1Junho 2010

Copyright (c) 1998-2010 Informatica. 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 quecontém restrições quanto ao seu uso e divulgação e são protegidas por leis de direitos autorais. A engenharia reversa do software é proibida. Não está permitida deforma 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 oconsentimento 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 ecomo 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 FAR52.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. Caso você encontre algum problema neste produto oudocumentação, informe-nos por escrito.

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 eInformatica On Demand são marcas comerciais ou registradas da Informatica Corporation nos Estados Unidos e jurisdições de todo o mundo. Todos os outros nomesde 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 direitosreservados. Copyright © Sun Microsystems. Todos os direitos reservados. Copyright © RSA Security Inc. Todos os direitos reservados. Copyright © Ordinal TechnologyCorp. Todos os direitos reservados. Copyright © Aandacht c.v. Todos os direitos reservados. Copyright Genivia, Inc. Todos os direitos reservados. Copyright 2007Isomorphic Software. Todos os direitos reservados. Copyright © Meta Integration Technology, Inc. Todos os direitos reservados. 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 © Rouge 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.

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 porescrito, o software distribuído sob a Licença é fornecido em uma base "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA OU CONDIÇÃO DE QUALQUERTIPO, 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 (LesserGeneral Public License), que pode ser encontrada em http://www.gnu.org/licenses/lgpl.html. Os materiais são fornecidos gratuitamente pela Informatica, "no estado emque se encontram", sem garantia de qualquer tipo, explícita nem implícita, incluindo, mas não de forma restritiva, as garantias implicadas de comerciabilidade eadequaçã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, Irvinee 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 direitosreservados) e a redistribuição deste software está sujeita aos termos disponíveis no site http://www.openssl.org.

Este produto inclui o software Curl com o Copyright 1996-2007, Daniel Stenberg, <[email protected]>. Todos os direitos reservados. Permissões e limitações relativas aeste software estão sujeitas aos termos disponíveis em http://curl.haxx.se/docs/copyright.html. A permissão para usar, copiar, modificar e distribuir este software comqualquer objetivo, com ou sem taxa, é concedida por este documento, desde que a nota de copyright acima e esta nota de permissão apareçam em todas as cópias.

O produto inclui o copyright de software 2001-2005 (©) MetaStuff, Ltd. Todos os direitos reservados. Permissões e limitações relativas a este software estão sujeitasaos 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ãosujeitas aos termos disponíveis em http://svn.dojotoolkit.org/dojo/trunk/LICENSE.

Este produto inclui o software ICU com o copyright International Business Machines Corporation e outros. Todos os direitos reservados. Permissões e limitaçõesrelativas 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 seu direito de usar tais materiais é estabelecido na licença quepode 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 & WirelessDeutschland. 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ãosujeitas aos termos disponíveis em http:/ /www.boost.org/LICENSE_1_0.txt.

Este produto inclui o copyright de software © 1997-2007 University of Cambridge. Permissões e limitações relativas a este software estão sujeitas aos termosdisponí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ãosujeitas aos termos disponíveis em http://www.eclipse.org/org/documents/epl-v10.php.

Este produto inclui software licenciado de acordo com os termos disponíveis nos endereços 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 e http://fusesource.com/downloads/license-agreements/fuse-message-broker-v-5-3-license-agreement.

Este produto inclui o software licenciado conforme a Academic Free License (http://www.opensource.org/licenses/afl-3.0.php), a Common Development and DistributionLicense (http://www.opensource.org/licenses/cddl1.php), a Common Public License (http://www.opensource.org/licenses/cpl1.0.php) e a BSD License (http://www.opensource.org/licenses/bsd-license.php).

Este produto inclui copyright do software © 2003-2006 Joe WaInes, 2006-2007 XStream Committers. Todos os direitos reservados. Permissões e limitações relativas aeste software estão sujeitas aos termos disponíveis em http://xstream.codehaus.org/license.html. Este produto inclui software desenvolvido pelo Indiana UniversityExtreme! Lab. Para obter mais informações, visite http://www.extreme.indiana.edu/.

Este software é protegido pelos números de patentes dos EUA 5,794,246; 6,014,670; 6,016,501; 6,029,178; 6,032,158; 6,035,307; 6,044,374; 6,092,086; 6,208,990;6,339,775; 6,640,226; 6,789,096; 6,820,077; 6,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,254,590; 7,281,001; 7,421,458 e 7,584,422, patentesinternacionais 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, expressaou implícita, incluindo, mas não de forma restritiva, as garantias implícitas de não infração, comercialização ou uso para um determinado propósito. A InformaticaCorporation não garante que este software ou documentação esteja sem erros. As informações fornecidas neste software ou documentação podem incluir imprecisõesté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 daProgress Software Corporation ("DataDirect") e 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, SEJA EXPRESSAOU IMPLÍCITA, INCLUINDO, MAS NÃO DE FORMA RESTRITIVA, AS GARANTIAS IMPLÍCITAS DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UMAFINALIDADE ESPECÍFICA E SEM VIOLAÇÃO.

2.EM NENHUM CASO, A DATADIRECT OU SEUS FORNECEDORES TERCEIRIZADOS SERÃO RESPONSÁVEIS, EM RELAÇÃO AO CLIENTE FINAL, PORQUAISQUER DANOS DIRETOS, INDIRETOS, INCIDENTAIS, ESPECIAIS, CONSEQUENCIAIS OU DEMAIS QUE POSSAM ADVIR DO USO DE DRIVERSODBC, SENDO OU NÃO ANTERIORMENTE INFORMADOS DAS POSSIBILIDADES DE DANOS. ESTAS LIMITAÇÕES SE APLICAM A TODAS AS CAUSASDE AÇÃO, O QUE INCLUI, SEM LIMITAÇÕES, QUEBRA DE CONTRATO, QUEBRA DE GARANTIA, NEGLIGÊNCIA, RESPONSABILIDADE RIGOROSA,DETURPAÇÃO E OUTROS ATOS ILÍCITOS.

Parte Número: PWX-CMD-901-0001

Conteúdo

Prefácio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viRecursos da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Portal de Clientes da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Documentação da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Site da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Biblioteca de Recursos da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Base de Dados de Conhecimento da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Base de Dados de Conhecimento Multimídia da Informatica. . . . . . . . . . . . . . . . . . . . . . . . vii

Suporte Global a Clientes da Informatica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Capítulo 1: Introdução aos Comandos do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . 1Visão Geral dos Comandos do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Convenções de Sintaxe dos Comandos do PowerExchange . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Executando os Comandos do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Capítulo 2: Comandos do ECCR Baseado em Log do Adabas. . . . . . . . . . . . . . . . . . . . 3Introdução aos Comandos do ECCR Baseado em Log do Adabas. . . . . . . . . . . . . . . . . . . . . . . . 3

Inicializando o trabalho do ECCR Baseado em Log do Adabas.. . . . . . . . . . . . . . . . . . . . . . . . . 3

Comando CLOSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Comando DISPLAY TRACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Comando STATUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Comando TRACEOFF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Comando TRACEON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Capítulo 3: Comandos do ECCR do VSAM em lotes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Introdução aos Comandos do ECCR do VSAM em Lotes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Comando DISPLAY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Comando START. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Comando STOP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Capítulo 4: Comandos do ECCR do CICS/VSAM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Introdução aos Comandos do ECCR do CICS/VSAM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Comando DISPLAY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Comando HELP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Comando INIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Comando TERM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Capítulo 5: Comandos do ECCR Síncrono do Datacom. . . . . . . . . . . . . . . . . . . . . . . . . 12Introdução aos Comandos do ECCR Síncrono do Datacom. . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Inicializando o ECCR Síncrono do Datacom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Interrompendo o Controlador de Alteração do Datacom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Interrompendo o Alimentador de Log do Datacom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Comando do Controlador de Alteração do Datacom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Sumário i

Comando REFRESH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Comandos do Alimentador de Log do Datacom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Comando DEBUG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Comando STATUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Comando TRACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Capítulo 6: Comandos do ECCR Baseado em Tabela do Datacom. . . . . . . . . . . . . . . 16Introdução aos Comandos do ECCR Baseado em Tabela do Datacom. . . . . . . . . . . . . . . . . . . . 16

Inicializando o ECCR Baseado em Tabela do Datacom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Interrompendo o ECCR Baseado em Tabela do Datacom. . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Capítulo 7: Comandos do ECCR do DB2 para z/OS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Introdução aos Comandos do ECCR do DB2 para z/OS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Inicializando o ECCR do DB2 para z/OS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Interrompendo o ECCR do DB2 para z/OS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Comando DISPLAY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Comando QUIESCE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Comando REFRESH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Comando TERM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Comando URID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Capítulo 8: Comandos do ECCR Baseado em Log do IDMS. . . . . . . . . . . . . . . . . . . . . 25Introdução aos Comandos do ECCR Baseado em Log do IDMS. . . . . . . . . . . . . . . . . . . . . . . . 25

Inicializando o ECCR Baseado em Log do IDMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Comando CLOSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Comando DISPLAY TRACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Comando STATUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Comando TRACEOFF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Comando TRACEON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Capítulo 9: Comandos do ECCR Síncrono do IMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Introdução aos Comandos do ECCR Síncrono do IMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Comandos do Console do IMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Comando DISPLAY SUBSYS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Comando START SUBSYS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Comando STOP SUBSYS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Comandos do subsistema externo do IMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Comando xEDP-ABORT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Comando xEDP-CONTINUE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Comando xEDP-STAT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Comando xEDP-STATWTO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Capítulo 10: Comandos do ECCR Baseado em Log do IMS. . . . . . . . . . . . . . . . . . . . . 33Introdução aos Comandos do ECCR Baseado em Log do IMS. . . . . . . . . . . . . . . . . . . . . . . . . 33

Inicializando o ECCR Baseado em Log do IMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Comando CLOSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Comando DISPLAY TRACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

ii Sumário

Comando TRACEOFF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Comando TRACEON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Capítulo 11: Comandos do Agente do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . . 36Introdução aos Comandos do Agente do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Inicializando o Agente do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Comando DISPLAY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Comando DRAIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Comando LOGCLOSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Comando LOGOPEN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Comando LOGSPIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Comando REPCLOSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Comando REPOPEN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Comando REPOSITORYDSN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Comando REPSTATUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Comando RESUME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Comando SHUTDOWN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Comando START. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Comando STOP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Capítulo 12: Comandos do Condensador do PowerExchange. . . . . . . . . . . . . . . . . . . 45Introdução aos Comandos do Condensador do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . 45

Inicializando o Condensador do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Emitindo os Comandos do Condensador do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . . . 47

Interrompendo o Processamento do Condensador do PowerExchange. . . . . . . . . . . . . . . . . . . . 47

Comando CONDENSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Comando DISPLAY STATUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Comando FILESWITCH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Comando SHUTCOND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50


Capítulo 13: Comandos do Ouvinte do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . 53Introdução aos Comandos do Ouvinte do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Inicializando o Ouvinte do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Serviço do Ouvinte do PowerExchange no Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Inicializando o Serviço do Ouvinte do PowerExchange no Windows. . . . . . . . . . . . . . . . . . . 56

Testando o Serviço do Ouvinte do PowerExchange no Windows. . . . . . . . . . . . . . . . . . . . . 56

Interrompendo o Serviço do Ouvinte do PowerExchange no Windows. . . . . . . . . . . . . . . . . 57

Comandos CLOSE e CLOSE FORCE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Comandos DISPLAY ACTIVE e LISTTASK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Comando DTLLSTSI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Comando STOPTASK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Capítulo 14: Comandos do Agente de Log do PowerExchange para MVS. . . . . . . . 64Introdução ao Agente de Log do PowerExchange para os Comandos do MVS. . . . . . . . . . . . . . . 64

Métodos para Emitir os Comandos do Agente de Log do PowerExchange. . . . . . . . . . . . . . . 65

Regras de Sintaxe e Diretrizes para os Comandos do Agente de Log do PowerExchange. . . . 65

Sumário iii

Inicializando o Agente de Log do PowerExchange para MVS. . . . . . . . . . . . . . . . . . . . . . . . . . 66

Comando DEFINE_LOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Comando DELETE_LOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Comando DISPLAY OBJECT=CONNECTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Comando DISPLAY OBJECT=LOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Comando PRINT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Comando RESOLVE_INDOUBT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Comando STOP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Comandos de Mesclagem Pós-Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Comandos DISPLAY e STATUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Comandos QUIT e STOP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Comandos TRACEE, TRACEL e TRACES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Capítulo 15: Comandos do Agente de Log do PowerExchange para Linux, UNIX eWindows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Introdução aos Comandos do Agente de Log do PowerExchange para Linux, UNIX e Windows. . . . 77

Inicializando o Agente de Log do PowerExchange para Linux, UNIX e Windows. . . . . . . . . . . . . . 78

Comando CONDENSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Comando DISPLAY ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Comando DISPLAY CHECKPOINTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Comando DISPLAY CPU. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Comando DISPLAY EVENTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Comando DISPLAY MEMORY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Comando DISPLAY RECORDS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Comando DISPLAY STATUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Comando FILESWITCH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Comando SHUTCOND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88


Capítulo 16: Comandos pwxcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Introdução aos Comandos pwxcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Sintaxe de Comando para os Comandos pwxcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Parâmetros para os Comandos pwxcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Processamento de Comandos para os Comandos pwxcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Configurando os Processos do PowerExchange para Receberem os Comandos pwxcmd. . . . . . . . 94

Exemplo 1: Configurando um Ouvinte do PowerExchange para Receber os Comandos pwxcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

Exemplo 2: Configurando um Processo do Condensador do PowerExchange para Receber osComandos pwxcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Exemplo 3: Configurando um Processo do Agente de Log do PowerExchange para Receberos Comandos pwxcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

Autorizando os Usuários a Emitirem os Comandos pwxcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Executando os Comandos pwxcmd da Linha de Comando. . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Script dos Comandos pwxcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Comandos pwxcmd para o Ouvinte do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Comando pwxcmd close. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Comando pwxcmd closeforce. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Comando pwxcmd listtask. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

iv Sumário

Comando pwxcmd stoptask. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Comandos pwxcmd para o Condensador do PowerExchange. . . . . . . . . . . . . . . . . . . . . . . . . 103

Comando pwxcmd condense. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Comando pwxcmd displaystatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Comando pwxcmd fileswitch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Comando pwxcmd shutcond . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Comando pwxcmd shutdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Comandos pwxcmd para o Agente de Log do PowerExchange para Linux, UNIX e Windows. . . . . 106

Comando pwxcmd condense. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Comando pwxcmd displayall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Comando pwxcmd displaycheckpoints. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Comando pwxcmd displaycpu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Comando pwxcmd displayevents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Comando pwxcmd displaymemory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Comando pwxcmd displayrecords. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Comando pwxcmd displaystatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Comando pwxcmd fileswitch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Comando pwxcmd shutcond . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Comando pwxcmd shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Outros Comandos pwxcmd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

Comando pwxcmd help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

Comando pwxcmd version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Índice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Sumário v

PrefácioEsse manual contém informações de referência sobre os comandos do PowerExchange, incluindo a sintaxe eo uso dos mesmos. Ele foi projetado para os administradores do PowerExchange que são responsáveis peladefinição e gerenciamento das operações de movimentação de dados em massa e captura de dadosalterados do PowerExchange.

O manual inclui os comandos que se aplicam aos seguintes produtos da Informatica:

¨ 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 InformaticaNa qualidade de cliente da Informatica, você pode acessar o site Portal de Clientes da Informatica noendereç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, à Basede Dados de Conhecimento Multimídia da Informatica, à Documentação de Produtos da Informatica e acessoà comunidade de usuários da Informatica.

Documentação da InformaticaA equipe de Documentação da Informatica se esforça ao máximo para criar documentações precisas eutilizáveis. Se você tiver dúvidas, comentários ou ideias sobre esta documentação, entre em contato com aequipe de Documentação da Informatica pelo e-mail [email protected]. Nós usaremosseu 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çãomais recente do seu produto, navegue para Documentação do Produto no endereço http://mysupport.informatica.com.

vi

http://mysupport.informatica.com

mailto:[email protected]


Site da InformaticaVocê pode acessar o site corporativo da Informatica no endereçohttp://www.informatica.com. O site contéminformações sobre a Informatica, seu histórico, eventos futuros e escritórios de vendas. Você também vaiencontrar informações sobre parceiros e produtos. A área de serviços do site inclui informações importantessobre suporte técnico, treinamento e educação, bem como serviços de implementação.

Biblioteca de Recursos da InformaticaNa qualidade de cliente da Informatica, você pode acessar a Biblioteca de Recursos da Informatica noendereço http://mysupport.informatica.com. A Biblioteca de Recursos é uma coletânea de recursos que oajuda a aprender mais sobre os produtos e recursos da Informatica. Ela inclui artigos e demonstraçõesinterativas que apresentam soluções a problemas comuns, comparam recursos e comportamentos e o orientana execução de tarefas específicas no mundo real.

Base de Dados de Conhecimento da InformaticaNa qualidade de cliente da Informatica, você pode acessar a Base de Dados de Conhecimento da Informaticano endereço http://mysupport.informatica.com. Use a Base de Dados de Conhecimento para pesquisarsoluções documentadas a problemas técnicos conhecidos sobre produtos da Informatica. Você também podeencontrar 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 deDados de Conhecimento da Informatica pelo e-mail [email protected].

Base de Dados de Conhecimento Multimídia da InformaticaNa qualidade de cliente da Informatica, você pode acessar a Base de Dados de Conhecimento Multimídia daInformatica 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 naexecução de tarefas específicas. Se você tiver dúvidas, comentários ou ideias sobre a Base de Dados deConhecimento Multimídia, entre em contato com a equipe da Base de Dados de Conhecimento da Informaticapelo e-mail [email protected].

Suporte Global a Clientes da InformaticaVocê pode entrar em contato com o Centro de Suporte a Clientes por telefone ou pelo Suporte Online. OSuporte Online requer um nome de usuário e uma senha. Você pode solicitar um nome de usuário e umasenha no endereço http://mysupport.informatica.com.

Prefácio vii

http://www.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 GratuitaBrasil: 0800 891 0202México: 001 888 209 8853América do Norte: +1 877 463 2435 Tarifa PadrãoAmérica do Norte: +1 650 653 6332

Ligação GratuitaFrança: 00800 4632 4357Alemanha: 00800 4632 4357Israel: 00800 4632 4357Itália: 800 915 985Holanda: 00800 4632 4357Portugal: 800 208 360Espanha: 900 813 166Suíça: 00800 4632 4357 ou 0800 463 200Reino Unido: 00800 4632 4357 ou 0800023 4632 Tarifa PadrãoBélgica: +31 30 6022 797França: 0805 804632Alemanha: 01805 702702Holanda: 030 6022 797

Ligação GratuitaAustrália: 1 800 151 830Nova Zelândia: 1 800 151 830Cingapura: 001 800 4632 4357 Tarifa PadrãoÍndia: +91 80 4112 5738

viii Prefácio

C A P Í T U L O 1

Introdução aos Comandos doPowerExchange

Este capítulo inclui os seguintes tópicos:

¨ Visão Geral dos Comandos do PowerExchange, 1

¨ Convenções de Sintaxe dos Comandos do PowerExchange , 2

¨ Executando os Comandos do PowerExchange, 2

Visão Geral dos Comandos do PowerExchangeEsse manual descreve a sintaxe, o uso e as limitações corretas dos comandos para controlar oscomponentes e processos do PowerExchange. Ele inclui os comandos para os seguintes componentescomuns que pertencem às várias fontes de dados e aos produtos do PowerExchange:

¨ Agente do PowerExchange

¨ Condensador do PowerExchange

¨ Ouvinte do PowerExchange

¨ Agente de Log do PowerExchange para Linux, UNIX e Windows

¨ Agente de Log do PowerExchange para MVS e Trabalhos de Mesclagem Pós-Log

O manual também inclui os comandos para os seguintes componentes específicos da fonte:

¨ Environmental Change Capture Routine (ECCR) baseado em log do Adabas

¨ ECCR em Lotes/VSAM

¨ ECCR do CIC/VSAM

¨ ECCR síncrono do Datacom

¨ ECCR baseado em tabela do Datacom

¨ ECCR do DB2 para z/OS

¨ ECCR baseado em log do IDMS

¨ ECCR baseado em log do IMS

¨ ECCR síncrono do IMS

Nota: Para a sua comodidade, o manual também inclui alguns comandos e técnicas que não estão noPowerExchange, como os comandos do operador START e STOP do MVS.

Esse manual não inclui os seguintes tópicos:

¨ As instruções e os parâmetros de configuração, tais como os contidos no arquivo de configuraçãoDBMOVER. Para obter informações sobre a configuração desses parâmetros, consulte o Manual deReferência do PowerExchange e os guias do CDC aplicáveis à sua plataforma.

¨ As instruções de controle e os parâmetros para os utilitários do PowerExchange.

1

¨ Uma Job Control Language (JCL) oferecida como parte da instalação do PowerExchange do MVS nabiblioteca hlq.SAMPLIB, onde hlq é o qualificador de alto nível que você especificou na instalação.

Esse manual é organizado para ajudá-lo a consultar rapidamente os comandos. Cada capítulo aborda umcomponente de captura de dados alterados específico ou comum da fonte do PowerExchange. Os capítulospara os componentes específicos da fonte são anteriores aos dos componentes comuns. Em cada capítulo,os comandos são organizados de modo alfabético, por nome. Se um nome de comando varia por plataforma,é utilizado um nome genérico, como comandos Start.

Convenções de Sintaxe dos Comandos doPowerExchange

Esse manual usa as seguintes convenções gerais para indicar a sintaxe de comando correta:

Convenção Description Exemplo

Fonte monospaced Indica as linhas que são parte do exemplode comando ou sintaxe geral.

F job_name,FILESWITCH

Itálico Indica uma variável na qual você informaum valor específico.

DSName=data_set_name

Colchetes ([ ]) Indica um parâmetro opcional ousubparâmetro.

F job_name,CLOSE [FORCE]

Uma barra vertical (|),também denominadacanal, entre os itens

Indica que você informa apenas um dositens.

DEBUG=ON|OFF

Uma vírgula (,) entre ositens

Indica que você pode informar mais de umitem.

{STARBA='rba',ENDRBA=x'rba'}

Chaves ({ }), tambémdenominadas braces, aoredor de vários itens

Indica que você deve informar, pelomenos, um dos itens entre chaves.

COPY={PRILOG|SECLOG}

Executando os Comandos do PowerExchangeA anotação e o método de entrada específicos do comando variam conforme a plataforma. Por exemplo, oscomandos MODIFY (F) do MVS frequentemente necessitam de uma vírgula (,) após um valor job_name epode ser informado do console do operador do MVS ou de uma interface como a SDF. Consulte a seção docomando que você está interessado para obter informações específicas sobre como informar um comando.

2 Capítulo 1: Introdução aos Comandos do PowerExchange

C A P Í T U L O 2

Comandos do ECCR Baseado emLog do Adabas


¨ Introdução aos Comandos do ECCR Baseado em Log do Adabas, 3

¨ Inicializando o trabalho do ECCR Baseado em Log do Adabas., 3

¨ Comando CLOSE, 4

¨ Comando DISPLAY TRACE, 4

¨ Comando STATUS, 5

¨ Comando TRACEOFF, 5

¨ Comando TRACEON, 5

Introdução aos Comandos do ECCR Baseado emLog do Adabas

Use os comandos do ECCR baseado em log do Adabas para inicializar e interromper o ECCR baseado emlog do Adabas.

Emita os comandos do console do operador do MVS ou de uma interface como a SDSF. Você deve incluir nocomando o nome de trabalho ou da tarefa inicializada do ECCR.

Inicializando o trabalho do ECCR Baseado em Logdo Adabas.

O ECCR baseado em log do Adabas pode ser executado como um trabalho em lotes ou tarefa inicializada.De modo geral, o ECCR do Adabas é executado como uma tarefa inicializada. A JCL de amostra do PROCdo ECCR é incluída no membro ECCRADA da biblioteca RUNLIB. Quando você executou o trabalhoXIZZZ998 durante a instalação, esse trabalho copiou o conteúdo do membro ECCRADA para o membroxxxAD1EC da biblioteca PROCLIB, onde xxx é o prefixo do Agente do PowerExchange.

Antes de inicializar a tarefa inicializada do ECCR, realize as seguintes tarefas:

¨ Crie registros de captura para as suas fontes de dados de alteração do Adabas.

¨ Verifique se o valor do parâmetro DBID do ECCR do PowerExchange especificado no membroADAECRP1 da biblioteca RUNLIB corresponde ao identificador de coletânea nos registros de captura doAdabas. Se você usa o processamento de condensação, verifique também se esse mesmo valor DBID éespecificado no membro CAPTADA1 da biblioteca RUNLIB.

¨ Verifique se o DBID especificado do Adabas DBID está ativo.

3

SintaxePara inicializar o ECCR do Adabas como uma tarefa inicializada, use o comando START (S) do MVS:

S xxxAD1EC

A variável xxx é um valor de três caracteres que você especificou para o valor PowerExchange Agent/Logger Prefix quando executou o MVS Installation Assistant. O padrão é PWX. O valor xxxAD1EC é o nomedo membro PROCLIB que contém a JCL da tarefa inicializada do ECCR.

Notas de UsoConsulte as seguintes notas de uso:

¨ Você deve inicializar um ECCR para cada DBID do Adabas ou Nucleus para o qual o PowerExchangesolicita acesso para a captura de dados alterados.

¨ O ECCR, o Agente de Log do PowerExchange e o Agente do PowerExchange devem ser executados nomesmo sistema MVS, exceto em um ambiente sysplex que use o processamento de Mesclagem Pós-Log.

¨ Quando o ECCR é inicializado, ele avalia o conjunto de dados PCAT para detectar novas entradas PLOGarquivadas para o processamento de captura. Posteriormente, o ECCR verifica se há novas entradasPLOG sempre que o período de espera definido no parâmetro NO_DATA_WAIT ou NO_DATA_WAIT2 domembro ADAECRP1 é concluído.

¨ O ECCR do PowerExchange é concluído com um código de retorno 8, se não houver registros de capturado Adabas.

¨ Ao inicializar o ECCR pela primeira vez, você deve realizar uma inicialização a frio. Para obter maisinformações, consulte o Guia do CDC do PowerExchange para z/OS.

¨ Para confirmar se o ECCR do PowerExchange é conectado com o Agente de Log do PowerExchange,consulte as mensagens no conjunto de dados EDMMSG.

Comando CLOSEInterrompe o trabalho do ECCR baseado em log do Adabas. Quando você reinicializa o ECCR, ele retoma osregistros de log de leitura do ponto em que foi interrompido. Nenhuma alteração é perdida. Como alternativa,você pode emitir o comando STOP (P) do MVS.

SintaxePara o comando CLOSE do PowerExchange, use a seguinte sintaxe:

F task_name,{CLOSE|CLOS}

Para o comando STOP (P) do MVS, use a seguinte sintaxe:

P task_name

Nos dois comandos, a variável task_name é o nome da tarefa inicializada ou do trabalho do ECCR baseadoem log do Adabas.

Comando DISPLAY TRACEExibe o número de rastreamentos ativos para o ECCR baseado em log do Adabas e os seus níveis derastreamento e critérios de filtro. Use esse comando somente se instruído pelo Suporte Global a Clientes daInformatica.

SintaxeUse a seguinte sintaxe de comando:

F job_name,{DISPLAY TRACE|DISP TRAC}

4 Capítulo 2: Comandos do ECCR Baseado em Log do Adabas

A variável job_name é o nome da tarefa inicializada ou do trabalho do ECCR baseado em log.

TÓPICOS RELACIONADOS:¨ “Comando TRACEOFF” na página 5

¨ “Comando TRACEON” na página 5

Comando STATUSGrava estatísticas na atividade de captura de dados alterados do Adabas atual para o arquivo de saída doSYSPRINT.


F job_name,{STATUS|STAT}


Exemplo de SaídaO resultado do comando STATUS é a seguinte mensagem:

PWX-07905 DTL07905 Current PLOG copy is plog_file latest time processed yy/mm/dd hh:mm:ss (ADABAS Capture)

Comando TRACEOFFDesabilita o trabalho do ECCR baseado em log do Adabas. Use esse comando somente se instruído peloSuporte Global a Clientes da Informatica.


F job_name,TRACEOFF


Exemplo de SaídaA seguinte mensagem no arquivo DTLLOG indica que o rastreamento foi desabilitado:

PWX-07968 Tracing turned off

TÓPICOS RELACIONADOS:¨ “Comando DISPLAY TRACE” na página 4


Comando TRACEONHabilita o rastreamento para o ECCR baseado em log do Adabas com um critério de filtro específico e umnível de rastreamento específico. As informações de rastreamento mostram um histórico dos eventos doECCR do Adabas. Essas informações são úteis para o diagnóstico de problemas. Use esse comandosomente se instruído pelo Suporte Global a Clientes da Informatica.

Comando STATUS 5


F job_name,TRACEON trace_filter,level_number

Onde:

¨ job_name é o nome da tarefa inicializada ou do trabalho do ECCR baseado em log do Adabas.

¨ trace_filter e level_number são valores oferecidos pelo Suporte Global a Clientes da Informatica.


¨ “Comando TRACEOFF” na página 5

6 Capítulo 2: Comandos do ECCR Baseado em Log do Adabas

C A P Í T U L O 3

Comandos do ECCR do VSAMem lotes


¨ Introdução aos Comandos do ECCR do VSAM em Lotes, 7

¨ Comando DISPLAY, 7

¨ Comando START, 8

¨ Comando STOP, 8

Introdução aos Comandos do ECCR do VSAM emLotes

Use os comandos do ECCR do VSAM em lotes para realizar as seguintes tarefas de gerenciamento do ECCRem um sistema MVS:

¨ Exibir o número de interfaces ativas e inativas do ECCR do VSAM em lotes no sistema MVS.

¨ Inicializar a interface do ECCR do VSAM em lotes

¨ Interromper a interface do ECCR do VSAM em lotes.

¨ Recarregar a interface do ECCR do VSAM em lotes.

Emita os comandos do console do operador do MVS ou de uma interface como a SDSF. Como o Agente doPowerExchange processa os comandos de interface do ECCR do VSAM em lotes, você deve colocar antesde cada comando o prefixo do comando do MVS para o Agente do PowerExchange. Use o comando doprefixo que você especificou para o parâmetro CmdPrefix no membro AGENTCTL da biblioteca RUNLIB. Sevocê não definiu o parâmetro CmdPrefix, use o prefixo padrão do comando, que é o valor do parâmetroAGENTID no membro AGENTCTL. Na sintaxe, o prefixo do comando é representado pela variável cmd_prefix.

Comando DISPLAYExibe o número de módulos de interface ativos e inativos do ECCR do VSAM em lotes que foi carregado nosistema MVS.


cmd_prefix DISPLAY VSAMECCR

7

Comando STARTAtiva manualmente a interface do ECCR do VSAM em lotes, não importando o valor que é especificado noparâmetro CCVACTIVE do Agente do PowerExchange no membro AGENTCTL da biblioteca RUNLIB.

O parâmetro CCVACTIVE controla se o ECCR do VSAM em lotes é ativado automaticamente na inicializaçãodo Agente do PowerExchange.

Se você deseja carregar um novo módulo de interface do ECCR do VSAM em lotes para o ExtendedCommon Storage Area (ECSA) ou recarregar um módulo existente que foi alterado, especifique o comandoVSAMECCR/RELOAD em vez de VSAMECCR. Em seguida, o comando coloca o módulo em um estado ativono começo da fila de LPA.

Nota: Se você ativar o ECCR do VSAM em lotes para um Agente do PowerExchange, o ECCR torna-seglobalmente ativo para todos os Agentes do PowerExchange na imagem do MVS. Consequentemente, sevocê estiver executando vários Agentes do PowerExchange em uma imagem do MVS, pode ativar uma vez oECCR do VSAM em lotes com apenas um prefixo de comando do Agente do PowerExchange.

SintaxePara inicializar a interface do ECCR do VSAM em lotes, use a seguinte sintaxe de comando:

cmd_prefix START VSAMECCR

Para carregar um novo módulo de interface do ECCR do VSAM em lotes para o ECSA, use a seguintesintaxe de comando:

cmd_prefix START VSAMECCR/RELOAD

Comando STOPInterrompe o ECCR do VSAM em lotes. Essa ação desabilita o ECCR para todo o sistema MVS. Qualqueratividade de captura de dados alterados em andamento continua até que o conjunto de dados seja fechado.Depois disso, qualquer alteração adicional aos conjuntos de dados VSAM não é capturada.

Se deseja interromper a captura de alteração de um determinado conjunto de dados VSAM, defina o statusdo registro de captura associado para inativo do Navegador do PowerExchange.


cmd_prefix STOP VSAMECCR

Para obter mais informações sobre a interrupção do ECCR do VSAM em lotes, consulte o Guia do CDC doPowerExchange para z/OS.

8 Capítulo 3: Comandos do ECCR do VSAM em lotes

C A P Í T U L O 4

Comandos do ECCR do CICS/VSAM


¨ Introdução aos Comandos do ECCR do CICS/VSAM, 9


¨ Comando HELP, 9

¨ Comando INIT, 10

¨ Comando TERM, 10

Introdução aos Comandos do ECCR do CICS/VSAMUse os comandos do ECCR do CICS/VSAM para realizar as seguintes tarefas de gerenciamento do ECCRem um sistema MVS:

¨ Exibir todos os conjuntos de dados do VSAM registrados para a captura de dados alterados.

¨ Exibir um painel de Ajuda para o ECCR do CICS/VSAM.

¨ Inicializar o ECCR do CICS/VSAM.

¨ Interromper o ECCR do CICS/VSAM.

Emita os comandos como comandos do CICS de um terminal CICS. Informe os comandos com o código detransação padrão “EDMC” do CICS para o ECCR do CICS/VSAM.

Comando DISPLAYExibe os nomes dos conjuntos de dados do VSAM registrados para captura de dados alterados e que foramabertos desde a inicialização do ECCR do CICS/VSAM.


EDMC {DISPLAY|DISP}

Comando HELPExibe um painel de Ajuda que lista os comandos disponíveis do ECCR do CICS/VSAM e suas funções.

9


EDMC HELP

Comando INITInicializa o ECCR do CICS/VSAM na região do CICS.

Aviso: A Informatica Corporation recomenda que você não use a transação INIT do EDMC para ativarmanualmente o ECCR do CICS/VSAM. Em vez, adicione o nome do módulo EDMKOPER à lista deinicialização PLT do CICS. Essa ação provoca a inicialização do ECCR sempre que você inicializa a regiãode controle do CICS/VSAM. Essa ação também ajuda a evitar possíveis problemas de captura de dadosalterados que possam ocorrer quando a saída global CICS XFCFRIN ou XCFROUT, utilizada pelo ECCR,assumir o controle na ordem incorreta.


EDMC INIT

Notas de UsoConsulte as seguintes notas antes de emitir o comando:

¨ Se você ativar o ECCR do CICS/VSAM e abrir o conjunto de dados do VSAM, antes de ativar o Agente doPowerExchange, deve fechar e reabrir o conjunto de dados para iniciar a captura de alterações.

¨ Se você especificou CCERR=ABEND no módulo de opções EDMSDIR, e o ECCR do CICS/VSAMencontrou um erro sério ou foi encerrado de forma anormal durante a inicialização, o ECCRimediatamente fecha a região do CICS para evitar a perda de dados. Esse processo aborta as tarefasatuais e retrocede as transações em andamento. O ECCR opera como se você tivesse emitido o comandoCEMT PERFORM SHUTDOWN IMMEDIATE do CICS. Essa ação garante a integridade da replicação dosdados.

¨ O ECCR do CICS/VSAM utiliza a saída global CICS XFCFRIN ou XFCFROUT para capturar alteraçõesaos conjuntos de dados do VSAM. O comando INIT faz com que as saídas sejam adicionadasdinamicamente e o comando TERM faz com que elas sejam removidas dinamicamente. Se outras saídasCICS XFCFRIN ou XCFROUT forem implementadas no sistema em que o ECCR do CICS/VSAM éexecutado, podem ocorrer problemas de captura de dados se as saídas do ECCR do CICS/VSAMassumirem o controle na ordem incorreta.

Para obter mais informações, consulte o Guia do CDC do PowerExchange para z/OS.

Comando TERMConclui o ECCR do CICS/VSAM na região do CICS. O ECCR do VSAM interrompe imediatamente a capturade dados alterados dos conjuntos de dados de origem do VSAM, desconecta-se do Agente de Log doPowerExchange e exibe as mensagens que indicam o número e tipo de alteração capturado desde que osconjuntos de dados foram abertos pela última vez.

Aviso: A Informatica Corporation recomenda que você não use a transação TERM do EDMC para concluirmanualmente o ECCR do CICS/VSAM. Essa ação pode resultar em perda de dados alterados. Ao invésdisso, permita que o CICS solicite ao ECCR que inicie a conclusão sempre que você desligar a região doCICS.

10 Capítulo 4: Comandos do ECCR do CICS/VSAM


EDMC TERM


¨ Se você concluir o ECCR do CICS/VSAM enquanto as transações em fontes de dados estiverematualizando os conjuntos de dados do VSAM registrados para captura de dados alterados, a perda dedados alterados provavelmente ocorrerá.

¨ O ECCR do CICS/VSAM utiliza a saída global XFCFRIN ou XFCFROUT do CICS para capturar alteraçõesaos conjuntos de dados do VSAM. O comando INIT faz com que as saídas sejam adicionadasdinamicamente e o comando TERM faz com que elas sejam removidas dinamicamente. Se outras saídasCICS XFCFRIN ou XCFROUT forem implementadas no sistema em que o ECCR do CICS/VSAM éexecutado, podem ocorrer problemas de captura de dados se as saídas do ECCR do CICS/VSAMassumirem o controle na ordem incorreta.


Comando TERM 11

C A P Í T U L O 5

Comandos do ECCR Síncrono doDatacom


¨ Introdução aos Comandos do ECCR Síncrono do Datacom, 12

¨ Inicializando o ECCR Síncrono do Datacom, 12

¨ Interrompendo o Controlador de Alteração do Datacom, 13

¨ Interrompendo o Alimentador de Log do Datacom, 13

¨ Comando do Controlador de Alteração do Datacom, 14

¨ Comandos do Alimentador de Log do Datacom, 14

Introdução aos Comandos do ECCR Síncrono doDatacom

Use os comandos do ECCR síncrono do Datacom para controlar o Controlador de Alteração e o Alimentadorde Log, se usado, do Datacom em um sistema MVS. Esses componentes são usados para capturaralterações de modo síncrono das fontes do Datacom em um espaço de endereço do MUF.

Se você configurou o ECCR síncrono do Datacom para usar o método Direct Log Write de captura de dadosalterados, conforme recomendado, o Coletor de Alteração captura as alterações à medida que elas ocorrem eas transfere para o Agente de Log do PowerExchange. O Controlador de Alteração gerencia os registros decaptura utilizados pelo Coletor de Alteração. Nessa configuração, o Alimentador de Log não é usado.

Se você usa uma versão do PowerExchange para Datacom anterior a 8.1.1, que não aceita o método DirectLog Write, o Coletor de Alteração captura as alterações à medida que elas ocorrem e transfere-as para umespaço de dados temporário criado por ele. O Alimentador de Log, em seguida, lê os dados de alteração doespaço de dados e transfere-os para o Agente de Log do PowerExchange.

O Controlador de Alteração e o Alimentador de Log são executados em um espaço de endereço separado doespaço de endereço do Recurso de Vários Usuários do Datacom (MUF).

Nota: Você não pode emitir os comandos do Coletor de Alteração do Datacom do console do operador. OColetor de Alteração é executado no espaço de endereço do MUF do Datacom.

Inicializando o ECCR Síncrono do DatacomVocê deve inicializar o Controlador de Alteração para capturar de modo síncrono os dados alterados doDatacom. Se você não usa o método Direct Write Log de captura de alteração, deve inicializar também oAlimentador de Log do Datacom. Para inicializar o Controlador de Alteração e o Alimentador de Log, use ocomando padrão START (S) do MVS.

12

SintaxeUse a seguinte sintaxe para inicializar o Controlador de Alteração e o Alimentador de Log:

{START|S} task_name

A variável task_name é o nome do trabalho ou tarefa inicializada do Controlador de Alteração ou o nome datarefa inicializada do Alimentador de Log.

Notas de UsoSe você não estiver usando o método Direct Log Write de captura de dados alterados, quando o Controladorde Inicialização for inicializado, ele cria um espaço de dados temporário que mantém os dados alteradoscapturados pelo Coletor de Alteração do Datacom. O Coletor de Alteração e o Alimentador de Log seconectam com esse espaço de dados para gravar ou ler dados alterados.

Se você necessita reinicializar o Controlador de Alteração, deve primeiro interromper todos os componentesde captura de alteração ao realizar as seguintes etapas:

1. Suspenda o MUF do Datacom para interromper o Coletor de Alteração.

2. Se você não estiver usando o método Direct Log Write, interrompa o Alimentador de Log após ele ter lidotodos os dados de alteração que estejam atualmente no espaço de dados.

3. Interrompa o Controlador de Alteração.

4. Reinicialize o Controlador de Alteração utilizando o comando START do MVS.

Interrompendo o Controlador de Alteração do DatacomUse o comando padrão STOP (P) do MVS para interromper o Controlador de Alteração do Datacom. OControlador de Alteração é interrompido, sem primeiro esperar que as alterações em andamento sejamprocessadas. Essa ação tem os seguintes efeitos:

¨ Se você estiver usando o método Direct Log Write de captura de dados alterados, o espaço de dadostemporário ainda armazena os registros de captura, mas não os dados alterados.

¨ Se você não estiver usando o método Direct Log Write, o espaço de dados temporário é removido e oAlimentador de Log é terminado de modo anormal.

Importante: Antes de interromper o Controlador de Alteração, suspenda o MUF do Datacom. Além disso, sevocê não estiver usando o método Direct Log Write, interrompa o Alimentador de Log após ele ter lido todosos dados de alteração que estejam no espaço de dados. Se o espaço de dados ainda contiver dadosalterados, quando você interromper o Controlador de Alteração, eles serão perdidos.


P task_name

A variável task_name é o nome do trabalho ou da tarefa inicializada do Controlador de Alteração.

Interrompendo o Alimentador de Log do DatacomSe você usar o Alimentador de Log em vez do recurso Direct Log Write, você pode usar o comando STOP (P)do MVS para interromper o Alimentador de Log. O Alimentador de Log é interrompido, sem primeiro esperarpela conclusão do processamento atual.

Importante: Antes de interromper o Alimentador de Log, suspenda o MUF do Datacom. Além disso, certifique-se de que o espaço de dados temporário não contenha qualquer dado alterado capturado. Caso contrário, osdados alterados podem ser perdidos.

Interrompendo o Controlador de Alteração do Datacom 13


P task_name

A variável task_name é o nome da tarefa inicializada do Alimentador de Log.

Comando do Controlador de Alteração do DatacomUse o comando REFRESH do Controlador de Alteração do Datacom para atualizá-lo.

Comando REFRESHAtualiza o Controlador de Alteração do Datacom Você deve atualizar o Controlador de Alteração apósadicionar, editar ou excluir os registros de captura. Emita esse comando com o comando padrão MODIFY (F)do MVS.

A variável task_name é o nome do trabalho ou da tarefa inicializada do Controlador de Alteração.


F task_name,REFRESH

Comandos do Alimentador de Log do DatacomUse os comandos do Alimentador de Log do Datacom para imprimir as informações de status e diagnósticodo Alimentador de Log.

Nota: O PowerExchange para versões do Datacom anteriores a 8.1.1 usa o Alimentador de Log. Paraversões mais recentes, o método recomendado de captura de alterações de modo síncrono é o de Direct LogWrite, que não usa o Alimentador de Log.

Para emitir esses comandos, use o comando MODIFY (F) padrão do MVS.

Comando DEBUGHabilita ou desabilita a produção das informações de depuração do Alimentador de Log relacionada aosproblemas de diagnóstico. Use esse comando somente se instruído pelo Suporte Global a Clientes daInformatica.


F task_name,DEBUG {ON|OFF}

A variável task_name é o nome do trabalho ou da tarefa inicializada do Alimentador de Log.

Descrições de ParâmetrosInforme uma das seguintes opções:

ON

Habilita a depuração.

OFF

Desabilita a depuração.

14 Capítulo 5: Comandos do ECCR Síncrono do Datacom

Comando STATUSGrava estatísticas para a atividade de captura de dados alterados do Alimentador de Log do Datacom atualao arquivo de saída do SYSPRINT.


F task_name,STATUS


Comando TRACEHabilita ou desabilita o rastreamento durante o processamento do Alimentador de Log. O rastreamentocontém um histórico dos eventos do Alimentador de Log, que podem ser úteis para fins de diagnóstico deproblemas. Emita esse comando somente se instruído pelo Suporte Global a Clientes da Informatica.


F task_name,TRACE {ON|OFF}


Descrições de ParâmetrosInforme uma das seguintes opções:

ON

Habilita o rastreamento.

OFF

Desabilita o rastreamento.

Comandos do Alimentador de Log do Datacom 15

C A P Í T U L O 6

Comandos do ECCR Baseado emTabela do Datacom


¨ Introdução aos Comandos do ECCR Baseado em Tabela do Datacom, 16

¨ Inicializando o ECCR Baseado em Tabela do Datacom, 16

¨ Interrompendo o ECCR Baseado em Tabela do Datacom, 17

Introdução aos Comandos do ECCR Baseado emTabela do Datacom

Use os comandos START e STOP do MVS para inicializar ou interromper o ECCR baseado em tabela doDatacom.

Emita os comandos do console do operador do MVS ou de uma interface como a SDSF. Você deve incluir nocomando o nome do trabalho ou da tarefa inicializada do ECCR.

Inicializando o ECCR Baseado em Tabela do DatacomPara inicializar o ECCR baseado em tabela do Datacom como uma tarefa inicializada, use o comando START(S) do MVS:


START task_name

A variável task_name é o nome da tarefa inicializada do ECCR baseado em tabela do Datacom.

Notas de UsoAo inicializar o ECCR pela primeira vez, realize uma inicialização a frio.


16

Interrompendo o ECCR Baseado em Tabela doDatacom

Para interromper o ECCR baseado em tabela do Datacom, use o comando STOP (P) do MVS. Quando vocêreinicializa o ECCR, ele retoma as tabelas do CDC do ponto em que foi interrompido. Nenhuma alteração éperdida.

SintaxeUse a seguinte sintaxe:

{STOP|P} task_name

A variável task_name é o nome do trabalho ou tarefa inicializada do ECCR.

Por exemplo:

STOP DTLCCDCR

Interrompendo o ECCR Baseado em Tabela do Datacom 17

C A P Í T U L O 7

Comandos do ECCR do DB2 paraz/OS


¨ Introdução aos Comandos do ECCR do DB2 para z/OS, 18

¨ Inicializando o ECCR do DB2 para z/OS, 19

¨ Interrompendo o ECCR do DB2 para z/OS, 19


¨ Comando QUIESCE, 22

¨ Comando REFRESH, 23

¨ Comando TERM, 23

¨ Comando URID, 24

Introdução aos Comandos do ECCR do DB2 para z/OS

Use os comandos do ECCR do DB2 para z/OS para executar as seguintes tarefas em um sistema MVS:

¨ Exibir as estatísticas sobre a atividade de processamento do ECCR do DB2.

¨ Realizar um desligamento controlado do ECCR do DB2 após a conclusão de todos os UOWs.

¨ Atualizar o ECCR do DB2, após a atualização dos registros de captura do ECCR ou das instruções decontrole do ECCR no membro REPDB2OP da biblioteca RUNLIB, que é alocada pelo REPL2OPT DD naJCL do ECCR.

¨ Exibir as unidades de recuperação (URs) abertas do DB2, conforme detectadas pelo ECCR do DB2 combase no seu ponto atual de processamento no log do DB2.

¨ Confirmar as URs incomuns do DB2.

Para emitir os comandos do ECCR do DB2 para z/OS, use o comando MODIFY (F) do MVS. Você deveespecificar o nome do trabalho ou da tarefa inicializada do ECCR em cada comando, seguido por uma vírgula(,). Na sintaxe, esse nome é indicado por task_name. Você pode emitir os comandos do console do operadordo MVS ou de uma interface como a SDSF.

Os comandos para inicialização e interrupção do ECCR são os comandos padrão START e STOP do MVS.

18

Inicializando o ECCR do DB2 para z/OSDe modo geral, o ECCR do DB2 é executado como uma tarefa inicializada. Entretanto, você pode inicializar oECCR do DB2 como parte de um trabalho em lotes, se apropriado. A JCL do PROC do ECCR do DB2 éincluída no membro ECCRDB2 da biblioteca SAMPLIB.

Use o comando START (S) do MVS padrão para reinicializar uma tarefa inicializada do ECCR do DB2 que foiinterrompida.

SintaxeUse a seguinte sintaxe para o comando START do MVS:

{START|S} task_name

A variável task_name é o nome da tarefa inicializada do ECCR do DB2 para z/OZ.

Notas de UsoConsulte as seguintes notas antes de usar o comando:

¨ Para que o ECCR do DB2 seja inicializado, o subsistema DB2 deve estar sendo executado na imagemMVS em que você emite o comando START.

¨ Você deve ter a autoridade apropriada para executar o ECCR do DB2.


¨ A instrução START no membro REPDB2OP da biblioteca RUNLIB controla se uma inicialização aQUENTE, FRIO ou STARTLOC especial é realizada. Ao inicializar o ECCR do DB2 pela primeira vez,você deve realizar uma inicialização a frio. Posteriormente, uma inicialização a QUENTE é normalmentepreferível para reinicializar o ECCR do DB2.

¨ Interrompendo o ECCR do DB2 para z/OS

Interrompendo o ECCR do DB2 para z/OSUse o comando padrão STOP (P) do MVS para interromper imediatamente o ECCR do DB2 para z/OS, semesperar a conclusão de qualquer UOW em andamento para as alterações do DB2. O PowerExchange nãopode extrair UOWs incompletos nos logs do Agente de Log do PowerExchange - se houver - até que vocêreinicialize o ECCR do DB2.

Sugestão: Se você usar o comando QUIESCE em vez do comando STOP do MVS, a reinicialização dacaptura de dados alterados será mais rápida. O comando QUIESCE espera pela conclusão de todos osUOWs em andamento, antes de interromper o ECCR. Entretanto, você pode precisar usar o comando STOP,caso o comando QUIESCE não interrompa o ECCR, por exemplo, devido a captura de alterações pelo ECCRem um arquivo em lotes de execução prolongada.

SintaxeUse a seguinte sintaxe:

{STOP|P} task_name

A variável task_name é o nome do trabalho ou da tarefa inicializada do ECCR do DB2 para z/OS.

Inicializando o ECCR do DB2 para z/OS 19

TÓPICOS RELACIONADOS:¨ “Comando QUIESCE” na página 22

Comando DISPLAYImprime estatísticas detalhadas e resumidas sobre a atividade do ECCR do DB2 para o conjunto de dadosEDMMSG. Além disso, grava as estatísticas resumidas para o log impresso do MVS e o log de trabalho doJob Entry System (JES) para o ECCR do DB2.

As estatísticas resumidas incluem um número total de intervalos de controle de log do DB2 lidos pelo ECCR.As estatísticas detalhadas incluem um número de leituras de registros de alteração para cada tabela. Ocomando exibe as estatísticas para o período de tempo decorrido desde a inicialização do ECCR e a últimageração de estatísticas.


MODIFY task_name,DISPLAY[,SQ]

Como alternativa, você pode especificar a seguinte sintaxe de comando:

F task_name,DI[,SQ]


Descrição de ParâmetrosO parâmetro a seguir é opcional:

SQ

Faz com que o ECCR do DB2 grave um relatório estatístico de operação da SQL em tabela namensagem PWXEDM177085I do conjuntos de dados EDMMSG, em vez do relatório estatístico resumidoem tabela na mensagem PWXEDM177085I.

Exemplo de SaídaO comando gerou o seguinte exemplo de relatório estatístico resumido em tabela:

PWXEDM177084I STATISTICS OF CAPTURE PGM CCMDBM01 AT=2008-04-09 13.16.17-----------------------------------------------------------------------DB2-LOG LOCATION=0000A7A49976/0000 DB2-LOG TIMESTMP=2008-04-09 13.08.45LAST DELAY= 1.68 SEC AVERAGE DELAY= 2.14 SECNBR OF ERRORS= 0DB2 LOG CI'S CI_TOT CI_INTV CI_PSEC 60 2 0EDM MESSAGES MSG_TOT MSG_INTV MSG_PSEC 0 0 0PWXEDM177085I DETAIL-LEVEL STATISTICS FOLLOW BELOW MSG_TOT MSG_INTV MSG_PSEC TABLE_NAME 0 0 0 PWX.DEMO_SRC 0 0 0 PWX.TABLE_TO_CLONE 0 0 0 PWX.V2SS

Nota: As estatísticas resumidas são as localizadas acima da linha “PWXEDM1770851 DETAIL-LEVELSTATISTICS”.

O relatório resumido exibido na mensagem PWXEDM1767084I contém os seguintes campos:

DB2-LOG LOCATION

RBA ou LRSN da localização atual do processamento ECCR do DB2 no log do DB2. Um valor LRSN éexibido em vez de um RBA, se você tem um ambiente de compartilhamento de dados do DB2. Osúltimos quatro dígitos, após a barra (/), são a Identificação do membro de grupo de compartilhamento dedados da localização de log atual ou o número “0000”, se você não usa o compartilhamento de dados doDB2.

20 Capítulo 7: Comandos do ECCR do DB2 para z/OS

DB2-LOG TIMESTAMP

O carimbo de data/hora do último registro de log do DB2 lido pelo ECCR. Esse valor é a data e hora emque o registro foi gravado no log do DB2. O carimbo de data/hora está no formato AAAA-MM-DDHH.MM.SS.

LAST DELAY

Número de segundos decorridos entre o momento em que o DB2 gravou o último registro de alteraçãopara o log do DB2 e o momento em que o ECCR do DB2 leu esse registro. Esse intervalo é baseado nosvalores do carimbo de data/hora do registro. Esse intervalo indica o tempo decorrido na leitura doregistro de alteração pelo ECCR do DB2, após o DB2 efetuar o log da alteração. Se o campo estiver embranco, não houve atraso, ou o ECCR ainda não leu os registros.

AVERAGE DELAY

Média do número de segundos decorridos entre o momento em que o DB2 gravou um registro dealteração para o log do DB2 e o momento em que o ECCR do DB2 leu o registro. Esse intervalo ébaseado nos valores do carimbo de data/hora dos registros. Esse intervalo indica a média de tempodecorrido durante a leitura dos registros de alteração pelo ECCR do DB2, após o DB2 efetuar o log dasalterações. Se o campo estiver em branco, não houve atraso, ou o ECCR ainda não leu os registros.

NBR OF ERRORS

Número total de erros que o ECCR do DB2 encontrou na leitura dos registros de alteração desde que elefoi inicializado. Esse número é relatado apenas se a instrução de controle EC PERMIL no membroREPDB2OP da biblioteca RUNLIB for definida para um valor maior do que zero. O REPDB2OP é omembro alocado pela REPL2OPT DD na JCL do ECCR. Se a instrução EC PERMIL especificar zero, oECCR é encerrado de forma anormal quando ocorrer um erro, e esse campo fica em branco.

CI_TOT

Número total estimado de intervalos de log do DB2 lidos pelo ECCR do DB2 desde que ele foiinicializado.

CI_INTV

Número total estimado de intervalos de log do DB2 lidos pelo ECCR do DB2 durante o período degeração de relatório estatístico.

CI_PSEC

Média do número total estimado de intervalos de log do DB2 lidos pelo ECCR do DB2, por segundo,durante o período de geração de relatório estatístico.

MSG_TOT

Número total de registros de alteração para todas as tabelas com alterações capturadas pelo ECCR doDB2 desde que foi inicializado.

MSG_INTV

Número total de registros de alteração para todas as tabelas com alterações capturadas pelo ECCR doDB2 durante o período de geração de relatório estatístico.

MSG_PSEC

Número total de registros de alteração para todas as tabelas lidas pelo ECCR do DB2, por segundo,durante o período de geração de relatório estatístico.

A seção DETAIL_LEVEL STATISTICS, exibida na mensagem PWXEDM177085I, contém campos queincluem dados de tabelas individuais. Os campos diferem caso você solicite um resumo em tabela ou umrelatório estatístico de operações do SQL em tabela. Solicite um relatório estatístico de operações doSQL usando a opção SQ. Como padrão, o comando DISPLAY exibe um relatório estatístico resumido emtabela.

O relatório estatístico resumido em tabela exibido na mensagem PWXEDM177085I contém os seguintescampos:

Comando DISPLAY 21

MSG_TOT

Número total de registros de alteração lidos pelo ECCR do DB2 desde que ele inicializou.

MSG_INTV

Número total de registros de alteração lidos pelo ECCR do DB2 durante o período de geração derelatório estatístico.

MSG_PSEC

Média do número de registros de alteração lidos pelo ECCR do DB2, por segundo, durante o período degeração de relatório estatístico.

TABLE_NAME

Nome da tabela para qual as estatísticas MSG_TOT, MSG_INTV e MSG_PSEC são reportadas.

O relatório estatístico da operação do SQL em tabela exibido na mensagem PWXEDM177085I contémos seguintes campos:

TABLE

Nome da tabela para qual as estatísticas de operação INSERTS, UPDATES e DELETES SQL sãorelatadas.

INSERTS

Número total de registros de alteração da operação de inserção lidos na tabela pelo ECCR do DB2,desde que ele inicializou.

UPDATES

Número total de registros de alteração da operação de atualização lidos na tabela pelo ECCR do DB2,desde que ele inicializou.

DELETES

Número total de registros de alteração da operação de exclusão lidos na tabela pelo ECCR do DB2,desde que ele inicializou.

Comando QUIESCEInterrompe o ECCR do DB2 para z/OS apenas depois que todos os UOWs em andamento para aquele ECCRconcluírem o processamento e o ECCR enviar os registros dessas alterações para o Agente de Log doPowerExchange.


MODIFY task_name,QUIESCE


F task_name,QU



TÓPICOS RELACIONADOS:¨ “Interrompendo o ECCR do DB2 para z/OS” na página 19

Comando REFRESHAtualiza o ECCR após a atualização das instruções de controle no membro REPDB2OP da biblioteca RUNLIBou após você adicionar, editar ou excluir os registros de captura para as tabelas de origem do DB2. Aoperação de atualização ativa novas alterações de registro e opções do ECCR do DB2 para a captura dedados alterados. Você pode atualizar o ECCR do DB2 apenas quando ele estiver ativo.

Nota: O REPDB2OP é o membro alocado pelo REPL2OPT DD na JCL do ECCR do DB2.

Esse comando é equivalente a interromper o ECCR do DB2 e, em seguida, reinicializá-lo com a instruçãoSTART WARM.


MODIFY task_name,REFRESH


F task_name,RE



¨ Você deve emitir o comando REFRESH após adicionar ou alterar os registros de captura e após editarqualquer instrução de controle que não seja o DB2, IFI306OPT ou START no membro REPDB2OP dabiblioteca RUNLIB. Caso contrário, suas alterações são ignoradas.

¨ O comando REFRESH ignora qualquer alteração que você fez na instrução CA NAME do arquivoREPL2CTL.

Comando TERMConfirma uma unidade de recuperação (UR) incomum do DB2 para uma fonte de dados do DB2. Use essecomando somente se instruído pelo Suporte Global a Clientes da Informatica.

Sugestão: Para localizar um identificador da unidade de recuperação (URID) para a UR que desejaconfirmar, execute primeiro o comando URID.


F task_name,TERM,urid

Onde:

¨ A variável task_name é o nome do trabalho ou da tarefa inicializada do ECCR do DB2 para z/OS.

¨ urid é o ID da unidade de recuperação da UR que você deseja confirmar.

Comando REFRESH 23

TÓPICOS RELACIONADOS:¨ “Comando URID” na página 24

Comando URIDLista os URIDs do DB2 para o subsistema DB2 ou o grupo de compartilhamento de dados no qual o ECCR doDB2 para z/OS está sendo executado. Relata apenas os URIDs para as URs ativos.

Nota: Uma UR do DB2, se capturada, também pode ser um UOW incomum do Agente de Log doPowerExchange.

Use esse comando para diagnosticar os problemas, como operações QUIESCE malsucedidas ou UOWspersistentes que não são finalizadas.


F task_name,URID


Exemplo de SaídaO comando produziu o seguinte exemplo de mensagem:

PWXEDM177438I UR=123005F7319C STATUS=T LRSN=BC1C7951FA31/0002 Last=BC1C7951FA31/0002 Oper=nn

Como o ECCR do DB2 foi conectado com um grupo de compartilhamento de dados do DB2, a mensageminclui o campo LRSN. Além disso, o valor “Último” é um valor de LRSN em vez de RBA, e ele é finalizado comuma Identificação de membro de grupo de compartilhamento de dados, diferente de zero, de 0002.

TÓPICOS RELACIONADOS:¨ “Comando TERM” na página 23


C A P Í T U L O 8

Comandos do ECCR Baseado emLog do IDMS


¨ Introdução aos Comandos do ECCR Baseado em Log do IDMS, 25

¨ Inicializando o ECCR Baseado em Log do IDMS, 25

¨ Comando CLOSE, 26


¨ Comando STATUS, 26



Introdução aos Comandos do ECCR Baseado emLog do IDMS

Use os comandos do ECCR baseado em log do IDMS para interromper o ECCR baseado em log do IDMS oupara controlar o rastreamento ao ECCR. Use o comando de rastreamento somente se instruído pelo SuporteGlobal a Clientes da Informatica.

Emita os comandos do console do operador do MVS ou de uma interface como a SDSF. Para emitir oscomandos ECCR do PowerExchange, use o comando MODIFY (F) padrão do MVS. Você deve incluir o nomede trabalho ou da tarefa inicializada do ECCR. Na sintaxe, esse nome é indicado por job_name.

Inicializando o ECCR Baseado em Log do IDMSO ECCR baseado em log do IDMS pode ser executado como um trabalho em lotes ou tarefa inicializada. Demodo geral, o ECCR é executado como uma tarefa inicializada. Sempre que você criar ou alterar os registrosde captura do IDMS, deve reinicializar o ECCR para ativá-los.

Antes de inicializar o ECCR pela primeira vez, configure as opções do ECCR do IDMS no membroECCRIDLP de RUNLIB.

SintaxePara inicializar o ECCR do IDMS como uma tarefa inicializada, use o comando START (S) do MVS:

{START|S} task_name

A variável task_name é o nome da tarefa inicializada do ECCR.

25

Comando CLOSEInterrompe o trabalho do ECCR baseado em log do IDMS. Quando você reinicializa o ECCR, ele retoma osregistros de log de leitura do ponto em que foi interrompido. Nenhum dado alterado é perdido.


F job_name,{CLOSE|CLOS}

A variável job_name é o nome da tarefa inicializada ou do trabalho do ECCR baseado em log do IDMS.

Comando DISPLAY TRACEExibe o número de rastreamentos ativos para o ECCR baseado em log do IDMS e os seus níveis derastreamento e critérios de filtro. Use esse comando somente se instruído pelo Suporte Global a Clientes daInformatica.




Exemplo de SaídaOs seguinte exemplo de saída é produzido pelo comando DISPLAY TRACE quando dois rastreamentosestiverem ativos com nível -1 e os critérios de filtro especificados:

PWX-07994 Tracing is onPWX-07996 Number of traces is 2PWX-07997 Trace level=-1 filter=IMTCOLL,0,99PWX-07997 Trace level=-1 filter=IMTCOLX,0,99



Comando STATUSGrava estatísticas para a atividade de captura de dados alterados do IDMS atual para o arquivo de saída doSYSPRINT.

O resultado do comando STATUS é a seguinte mensagem:

PWX-07976 Latest time processed timestamp Records processed number (IDMS Capture).


F job_name,{STATUS|STAT}


26 Capítulo 8: Comandos do ECCR Baseado em Log do IDMS

Comando TRACEOFFDesabilita o rastreamento do ECCR baseado em log do IDMS. Use esse comando somente se instruído peloSuporte Global a Clientes da Informatica.


F job_name,TRACEOFF


Exemplo de SaídaA seguinte mensagem no arquivo DTLLOG verifica se o rastreamento foi desabilitado:




Comando TRACEONHabilita o rastreamento para o ECCR baseado em log do IDMS com um critério de filtro específico e um nívelde rastreamento específico. As informações de rastreamento mostram um histórico dos eventos do ECCR doIDMS.

Essas informações são úteis para o diagnóstico de problemas. Use esse comando somente se instruído peloSuporte Global a Clientes da Informatica.


F job_name,TRACEON trace_filter,level_number

Onde:

¨ job_name é o nome da tarefa inicializada ou do trabalho do ECCR baseado em log do IDMS.


Exemplo de SaídaSe o comando tiver êxito, a seguinte mensagem é gravada no arquivo do DTLLOG:

PWX-07998 Trace trace_id level trace_level turned on



Comando TRACEOFF 27

C A P Í T U L O 9

Comandos do ECCR Síncrono doIMS


¨ Introdução aos Comandos do ECCR Síncrono do IMS, 28

¨ Comandos do Console do IMS, 28

¨ Comandos do subsistema externo do IMS , 30

Introdução aos Comandos do ECCR Síncrono do IMSUse os comandos do ECCR síncrono do IMS para controlar o ECCR síncrono do IMS. O ECCR opera comoum subsistema externo do IMS.

Os seguintes tipos de comandos estão disponíveis:

¨ Comandos do console do IMS para inicialização e interrupção do subsistema externo do IMS que secomunica com o ECCR síncrono do IMS e para exibição do status do subsistema externo.

¨ Comandos do subsistema externo do IMS, emitidos com o comando /SSR, para geração de relatórios desnapshot na atividade de captura de dados alterados do ECCR do IMS e para substituição do valor deparâmetro CCERR no módulo de opções padrão EDMSDIR.

Comandos do Console do IMSUse os seguintes comandos do IMS para inicializar e interromper o subsistema externo do IMS do ECCRsíncrono do IMS e para exibir o status do subsistema externo do IMS. Emita os comandos do console do IMS.

Comando DISPLAY SUBSYSExibe o status de um subsistema externo especificado pelo IMS para o ECCR síncrono do IMS e o caracterede reconhecimento de comando (CRC) atribuído àquele subsistema.

Sugestão: Você pode usar esse comando para obter o valor do CRC necessário para emitir os comandos dosubsistema externo do IMS com o comando /SSR.


/DISPLAY SUBSYS ssid

A variável ssid é o identificador do subsistema externo do IMS no ECCR síncrono do IMS.

28

Exemplo de SaídaO comando produziu o seguinte exemplo de saída para o subsistema externo do IMS que contém aIdentificação do subsistema do I24A:

R 89,/DISPLAY SUBSYS I24AIEE600I REPLY TO 89 IS;/DISPLAY SUBSYS I24ADFS000I SUBSYS CRC REGID PROGRAM LTERM STATUS EDMADFS000I I24A # CONN EDMA

A saída mostra o CRC atribuído para o I24A do subsistema externo do IMS. Você necessita desse CRC paraemitir os comandos /SSR ao subsistema externo do IMS no ECCR do IMS.

Comando START SUBSYSInicializa o subsistema externo do IMS no ECCR síncrono do IMS. Durante a inicialização do subsistemaexterno do IMS, o ECCR síncrono do IMS inicializa e gera um relatório no conjunto de dados EDMMSGSYSOUT, que inicia com a mensagem PWXEDM172852I. A captura de dados alterados pode começar após aconclusão do processamento da inicialização.

Nota: Use esse comando somente se instruído pelo Suporte Global a Clientes da Informatica.


/START SUBSYS ssid


Exemplo de SaídaO comando /START SUBSYS 124A produziu o seguinte exemplo de relatório:

PWXEDM172852I Options in effect: Load Library containing EDMSDIR. . . . . : EDM.QA.I24L.USERLIB EDMSDIR assembly date/time . . . . . . . : 20071023 19.54 Product distribution date. . . . . . . . : 20060831 Product distribution level . . . . . . . : 2.4.05 Agent Id . . . . . . . . . . . . . . . . : I24A Logger Id. . . . . . . . . . . . . . . . : I24L SYSOUT class . . . . . . . . . . . . . . : * Action if ECCR error encountered . . . . : AbendPWXEDM172818I Joined XCF group 'I24L' as member 'EDMA'PWXEDM172841I EDM ECCR EDMA connected to EDM Logger I24L, Log RBA=X'000000001168000’PWXEDM172852I DFSESL DD allocation options: DSNs to allocate to DFSESL DD. . . . . . : EDM.IMS.EDMA91.SDFSRESL : IMS910.SDFSRESL : DSN810.SDSNLOAD : EDM.PROD.LOADPWXEDM172820I Change Capture initialized for IMS Online on V9.1.0 - EDMA

O relatório lista as opções padrão do EDMSDIR que estão em vigor. Se o ECCR síncrono do IMS estiversendo executado em uma região on-line, o relatório também contém as opções de alocação para a instruçãoDFSESL DD.

Para obter mais informações sobre a ativação do ECCR do IMS, consulte o Guia do CDC do PowerExchangepara z/OS.

Comando STOP SUBSYSInterrompe o subsistema externo do IMS para o ECCR síncrono do IMS.

Nota: Use esse comando somente se instruído pelo Suporte Global a Clientes da Informatica.

Os resultados desse comando dependem da definição do CCERR no módulo de opções EDMSDIR:

¨ Se a opção CCERR for definida para CONT, as transações continuam em execução para o banco dedados do IMS. Entretanto, como o ECCR síncrono do IMS não está mais disponível, as alterações não sãoenviadas para o Agente de Log do PowerExchange.

Comandos do Console do IMS 29

¨ Se a opção do CCERR for definida para ABEND, as transações on-line que acessam os segmentos doIMS, para os quais as alterações são capturadas, são concluídas de modo anormal com um código deabend de usuário U4094, porém a região de controle do IMS continua a funcionar.

Antes de emitir o comando STOP, defina a opção do CCERR para CONT de modo a evitar abends detransação. Para alterar de modo persistente o valor do CCERR, edite o módulo de opções EDMSDIR. Paraalterar temporariamente o valor do CCERR, use o comando do subsistema externo /SSR xEDP-CONTINUEdo IMS.


/STOP SUBSYS ssid


Notas de UsoSe o ECCR do IMS for parte da região on-line do IMS, após você emitir esse comando, o ECCR do IMSpermanece ativo e conectado com o Agente de Log do PowerExchange. Entretando, a captura de dadosalterados é interrompida.

Comandos do subsistema externo do IMSUse os comandos do subsistema externo do IMS para realizar as seguintes tarefas:

¨ Substituir temporariamente o parâmetro CCERR no módulo de opções padrão EDMSDIR. Normalmente, oparâmetro CCERR é definido para ABORT no módulo de opções padrão EDMSDIR. Pode ser necessárioque você substitua essa definição padrão, caso o Agente de Log do PowerExchange fique indisponível evocê não consiga resolver o problema imediatamente. Nesse caso, emita o comando xEDP-CONTINUEpara reinicializar as suas transações on-line do IMS. As transações podem ser executadas enquanto vocêestiver resolvendo o problema.

¨ Gerar um relatório sobre a atividade de captura de dados alterados do ECCR do IMS. Você pode imprimiro relatório para o conjunto de dados EDMMSG SYSOUT ou o log JESMSGLG do trabalho da região doIMS. Do relatório, você pode determinar os bancos de dados para os quais o PowerExchange estácapturando as alterações. O conjunto de dados EDMMSG contém mensagens que são enviadas do LogRead API após ele se conectar com o Agente de Log do PowerExchange para ler os dados alteradoscapturados.

Emita esses comandos com o comando /SSR em um console do IMS. Para cada comando, substitua avariável x pelo caractere de reconhecimento de comando (CRC) que você especificou ao definir o subsistemaexterno do IMS. Se você não sabe qual é o CRC, pode executar o comando DISPLAY SUBSYS.

Nota: Os comandos externos do IMS estão disponíveis somente se você editar o membro SSM apropriadona biblioteca PROCLIB do IMS para fornecer um CRC às definições do subsistema utilizadas peloPowerExchange.

Comando xEDP-ABORTSubstitui o valor da opção do CCERR nas opções padrão do EDMSDIR com o valor ABEND. Enquanto ovalor ABEND estiver em vigor, se o subsistema externo do IMS ou o Agente de Log do PowerExchange forconcluído, as transações on-line BMP ou MPP têm um pseudo-abend com um código de abend IBM U4094.Um pseudo-abend significa que o programa de controle do IMS transfere as condições de encerramentoanormal para a transação on-line responsável pela condição anormal e, em seguida, continua a atenderoutras regiões de mensagem.

O valor ABEND permanece em vigor até que o processo ou comando conclua a região de controle do IMS ouaté que um comando xEDP_CONTINUE substitua o comando xEDP_ABORT atual.

30 Capítulo 9: Comandos do ECCR Síncrono do IMS


/SSR xEDP-ABORT

A variável x é o CRC que você especificou ao definir o subsistema IMS externo durante a instalação.

Exemplo de SaídaO comando produziu o seguinte exemplo de saída de mensagem:

R 93,/SSR #EDP-ABORT.DFS058I SSR COMMAND COMPLETED EDMAPWXEDM172889I Action if ECCR error encountered has been set to ABORT

Essa mensagem indica que o valor de substituição do CCERR foi definida com êxito para ABORT.

Comando xEDP-CONTINUESubstitui o valor da opção do CCERR nas opções padrão do EDMSDIR com o valor CONTINUE. Enquanto ovalor CONTINUE estiver em vigor, se o subsistema IMS externo ou o Agente de Log do PowerExchange setornar indisponível, o ECCR síncrono do IMS não captura dados alterados. Consequentemente, nenhum dadoalterado é perdido. Entretanto, as transações on-line não são pseudo-abend. O destino e a origem de dadosse tornam fora de sincronia. Para recuperar a sincronização, você precisará rematerializar o destino.

O valor CONTINUE permanece válido até que o processo ou comando conclua a região de controle do IMSou até que outro comando /SSR substitua o comando xEDP-CONTINUE atual.


/SSR xEDP-CONTINUE


Exemplo de SaídaO comando produziu o seguinte exemplo de saída de mensagem:

R 94,/SSR #EDP-CONTINUE.DFS058I SSR COMMAND COMPLETED EDMAPWXEDM172889I Action if ECCR error encountered has been set to CONTINUE

Essa mensagem indica que o valor de substituição do CCERR foi definida com êxito para CONTINUE.

Comando xEDP-STATImprime um relatório de status do conjunto de dados EDMMSG SYSOUT. O relatório indica a atividade decaptura de dados alterados do ECCR do IMS, incluindo o número de inserções de registro, substituições eexclusões que o ECCR do IMS capturou. O relatório mostra os dados por segmento e área de banco dedados do IMS.

Nota: Se você deseja imprimir esse relatório para o log do trabalho da região do IMS, use o comando xEDP-STATWTO.


/SSR xEDP-STAT


Exemplo de SaídaO comando imprimiu o seguinte exemplo de saída do conjunto de dados EDMMSG SYSOUT:

PWXEDM172853I Change Capture counts for IMS DBD DBLOG5OF Segment=DB#AASEG ISRT=0 REPL=0 DLET=0 Segment=DB#BASEG ISRT=0 REPL=0 DLET=0 Segment=DB#CASEG ISRT=0 REPL=0 DLET=0 Segment=DB#BBSEG ISRT=0 REPL=0 DLET=0

Comandos do subsistema externo do IMS 31

Essa saída indica se um único banco de dados com quatro segmentos está registrado para a captura dedados alterados. O ECCR síncrono do IMS ainda não capturou qualquer inserção, substituição ou exclusãopara esse banco de dados.

Comando xEDP-STATWTOImprime um relatório de status do trabalho de log do JESMSGLG da região do IMS. O relatório indica aatividade de captura de dados alterados do ECCR do IMS, incluindo o número de inserções de registro,substituições e exclusões que o ECCR do IMS capturou. O relatório mostra os dados por segmento e área debanco de dados do IMS.

Nota: Se você deseja imprimir esse relatório para o conjunto de dados EDMMSG SYSOUT, use o comandoxEDP-STAT.


/SSR xEDP-STATWTO


Exemplo de SaídaO comando EDP-STATWTO produziu o seguinte exemplo de saída de mensagem:

R 95,/SSR #EDP-STATWTO.DFS058I SSR COMMAND COMPLETED EDMAPWXEDM172890W There are no open databases registered for capture

Essa saída indica que nenhum registro de captura foi definido para qualquer banco de dados aberto. Asalterações não serão capturadas para os bancos de dados.

32 Capítulo 9: Comandos do ECCR Síncrono do IMS

C A P Í T U L O 1 0

Comandos do ECCR Baseado emLog do IMS


¨ Introdução aos Comandos do ECCR Baseado em Log do IMS, 33

¨ Inicializando o ECCR Baseado em Log do IMS, 33

¨ Comando CLOSE, 34




Introdução aos Comandos do ECCR Baseado emLog do IMS

Use os comandos do ECCR baseado em log do IMS para interromper o ECCR baseado em log do IMS oupara controlar o rastreamento ao ECCR. Use o comando de rastreamento somente se instruído pelo SuporteGlobal a Clientes da Informatica.

Para emitir esses comandos, use o comando MODIFY (F) do MVS. Você deve incluir o nome de trabalho ouda tarefa inicializada do ECCR. Na sintaxe, esse nome é indicado por job_name.

Inicializando o ECCR Baseado em Log do IMSVocê pode executar o ECCR baseado em log do IMS como um trabalho em lotes ou tarefa inicializada.Sempre que você criar ou alterar os registros de captura, deve reinicializar o ECCR para ativá-los.

Antes de inicializar o ECCR pela primeira vez, realize as seguintes tarefas:

¨ Verifique se o Ouvinte do PowerExchange, Agente do PowerExchange e Agente de Log doPowerExchange estão sendo executados.

¨ Configura a JCL do ECCR baseado em log do IMS.

SintaxePara inicializar o ECCR do IMS como uma tarefa inicializada, use o comando START (S) do MVS:

{START|S} task_name

Para inicializar o ECCR do IMS como um trabalho em lotes, submeta a JCL configurada.

33

Comando CLOSEInterrompe o trabalho do ECCR baseado em log do IMS. Quando você reinicializa o ECCR, ele retoma osregistros de log de leitura do ponto em que foi interrompido. Nenhum dado alterado é perdido.


F job_name,CLOSE

A variável job_name é o nome da tarefa inicializada ou do trabalho do ECCR baseado em log do IMS.

Exemplo de SaídaQuando a operação de fechamento é concluída, o PowerExchange emite a seguinte mensagem informativa:

PWX-07291 CCIMT: DTLCCIMT is shutting down after reading the IMS log to yy/mm/dd hh:mm:ss

Comando DISPLAY TRACEExibe o número de rastreamentos ativos para o ECCR baseado em log do IMS e os seus níveis derastreamento e critérios de filtro. Use esse comando somente se instruído pelo Suporte Global a Clientes daInformatica.




Exemplo de SaídaO seguinte exemplo de saída foi produzido quando dois rastreamentos estavam ativos com nível -1 e oscritérios de filtro especificados:

PWX-07994 Tracing is onPWX-07996 Number of traces is 2PWX-07997 Trace level=-1 filter=IMTCOLL,0,99PWX-07997 Trace level=-1 filter=IMTCOLX,0,99



Comando TRACEOFFDesabilita o rastreamento do ECCR baseado em log do IMS. Use esse comando somente se instruído peloSuporte Global a Clientes da Informatica.


F job_name,TRACEOFF


Notas de UsoVocê pode verificar se o rastreamento está desativado procurando a seguinte mensagem no arquivo DTLLOG:


34 Capítulo 10: Comandos do ECCR Baseado em Log do IMS



Comando TRACEONHabilita o rastreamento para o ECCR baseado em log do IMS com um critério de filtro específico e um nívelde rastreamento específico. As informações de rastreamento mostram um histórico dos eventos do ECCR doIMS.

Essas informações podem ser úteis para o diagnóstico de problemas. Use esse comando somente seinstruído pelo Suporte Global a Clientes da Informatica.


F job_name,TRACEON trace_filter level_number

Onde:

¨ job_name é o nome da tarefa inicializada ou do trabalho do ECCR baseado em log do IMS.


Exemplo de SaídaSe você tiver êxito ao emitir esse comando, a seguinte mensagem é gravada no arquivo do DTLLOG:

PWX-07998 Trace trace_id level trace_level turned on

Se você emitir esse comando sem critérios de filtro de rastreamento válidos ou um nível de rastreamentoválido, a seguinte mensagem é gravada no arquivo DTLLOG:

PWX-07282 CCIMT: The TRACEON command is missing the trace filter and trace level



Comando TRACEON 35


Comandos do Agente doPowerExchange


¨ Introdução aos Comandos do Agente do PowerExchange, 36

¨ Inicializando o Agente do PowerExchange, 37


¨ Comando DRAIN, 38

¨ Comando LOGCLOSE, 38

¨ Comando LOGOPEN, 39

¨ Comando LOGSPIN, 39

¨ Comando REPCLOSE, 40

¨ Comando REPOPEN, 40

¨ Comando REPOSITORYDSN, 40

¨ Comando REPSTATUS, 41

¨ Comando RESUME, 42

¨ Comando SHUTDOWN, 42

¨ Comando START, 43

¨ Comando STOP, 43

Introdução aos Comandos do Agente doPowerExchange

Use os comandos do Agente do PowerExchange para concluir as seguintes tarefas:

¨ Exibir informações sobre o processamento do Agente do PowerExchange.

¨ Gerenciar o log de mensagens do Agente do PowerExchange.

¨ Abrir ou fechar o conjunto de dados de repositório do Agente do PowerExchange, alterar o nome que oAgente do PowerExchange utiliza para o conjunto de dados de repositório e exibir as informações destatus sobre esse conjunto de dados.

¨ Inicializar e interromper as subtarefas do Agente do PowerExchange.

¨ Desligar o espaço de endereço do Agente do PowerExchange.

Os comandos iniciados por “REP” gerenciam o conjunto de dados de repositório do Agente doPowerExchange. O Agente do PowerExchange usa o conjunto de dados de repositório para obter asinformações de registro de captura. Você pode utilizar o conjunto de dados AGENTREP ou CCT como orepositório do Agente do PowerExchange. A Informatica Corporation recomenda o uso do conjunto de dadosAGENTREP para evitar a atividade desnecessária de E/S.

36

Para emitir os comandos do Agente do PowerExchange, use o console do operador do MVS ou uma interfacecomo a SDSF. Antes de cada comando, você deve colocar o prefixo de comando do MVS especificado para oparâmetro CmdPrefix no membro AGENTCTL da biblioteca RUNLIB. Se você não definiu o parâmetroCmdPrefix opcional, use o prefixo padrão do comando, que é o valor do parâmetro AGENTID no membroAGENTCTL. O Agente do PowerExchange usa o prefixo de comando para interceptar os comandos emitidospara o MVS. Na sintaxe, o prefixo do comando é representado pela variável cmd_prefix.

Se você emitir um comando do Agente do PowerExchange, quando o espaço de endereço do Agente doPowerExchange estiver inativo, o MVS rejeita o comando e o PowerExchange emite a seguinte mensagem:

PWXEDM172054W module: agentid Command Exit. command command rejected – Agent is not active

Se você emitir um comando do Agente do PowerExchange com o prefixo incorreto, ou com o Agente doPowerExchange inativo desde o último IPL do sistema, o MVS emite a seguinte mensagem:

IEE305I agent_command COMMAND INVALID

Para inicializar o Agente do PowerExchange, use o comando padrão START do MVS.

Para obter mais informações sobre o conjunto de dados AGENTREP e o repositório do AgentePowerExchange, consulte o Guia do CDC do PowerExchange para z/OS.

Inicializando o Agente do PowerExchangePara inicializar o Agente do PowerExchange após a instalação ou reinicializá-lo após ter sido interrompido,use o comando START do MVS seguido pelo nome da tarefa inicializada do Agente do PowerExchange.


START task_name

Esse comando inicia o procedimento de inicialização do Agente do PowerExchange.

Para inicializar uma subparefa DIS, LOG ou REP específica, use o comando START do PowerExchange.

TÓPICOS RELACIONADOS:¨ “Comando START” na página 43

Comando DISPLAYExibe as informações sobre o processamento do Agente do PowerExchange no console do operador do MVS.


cmd_prefix DISPLAY {GBLQDSNS|JOBS|LOCKS|MODULES}

A variável cmd_prefix é o prefixo de comando especificado no membro AGENTCTL da biblioteca RUNLIB ouo valor do parâmetro AGENTID no membro AGENTCTL.

Descrições de ParâmetrosVocê deve especificar um dos seguintes parâmetros para esse comando:

GBLQDSNS

Exibe os identificadores de todas as filas circulares globais alocadas no Agente do PowerExchange.

JOBS

Exibe todos os TCBs do MVS registrados para serviços do Agente do PowerExchange.

Inicializando o Agente do PowerExchange 37

LOCKS

Exibe qualquer bloqueio do Agente do PowerExchange e os proprietários desses bloqueios.

MODULES

Exibe os nomes de todos os módulos carregados pelo Agente do PowerExchange.

Notas de UsoPara esse comando ter êxito, o Agente do PowerExchange deve estar em execução. Se você emitir ocomando quando o Agente do PowerExchange não estiver em execução, mas houve a execução desde oúltimo IPL, o PowerExchange emite a seguinte mensagem:

PWXEDM172054W module: agentid Command Exit. command command rejected – Agent is not active

Exemplo de SaídaO comando a seguir foi informado para o Agente do PowerExchange que tem um valor AGENTID de “DBM1”e está atualmente em execução:

DBM1 DISPLAY GBLQDSNS

O comando produziu a seguinte saída de mensagem:

DTLEDM172078I EDMSDIS0: DISPLAY command accepted by EDM Agent DBM1DTLEDM172200I EDMSDIS0: Global Queue DSNs display for EDM Agent DBM1DTLEDM172205I EDMSDIS0: DTLL.LOGGER.QUEUE.DBM1.DBML - CQMN=0A989028,Seq=28DTLEDM172206I EDMSDIS0: End of list

Comando DRAINVerifica se todas as tarefas que acessavam o Agente do PowerExchange foram concluídas e não estão maissendo executadas no sistema.

Você deve emitir o comando DRAIN, antes do comando SHUTDOWN COMPLETELY, para garantir que todasas tarefas sejam concluídas antes do desligamento do espaço de endereço.

Sugestão: Após emitir o comando DRAIN, você pode usar o comando RESUME para permitir que as tarefasretomem o acesso ao Agente do PowerExchange.


cmd_prefix DRAIN


TÓPICOS RELACIONADOS:¨ “Comando RESUME” na página 42

¨ “Comando SHUTDOWN” na página 42

Comando LOGCLOSEFecha e desaloca o conjunto de dados do log de mensagem do Agente do PowerExchange denominadoEDMSLOG.


cmd_prefix LOGCLOSE

38 Capítulo 11: Comandos do Agente do PowerExchange


TÓPICOS RELACIONADOS:¨ “Comando LOGSPIN” na página 39

Comando LOGOPENAloca e abre um novo conjunto de dados do log de mensagem do Agente do PowerExchange denominadoEDMSLOG. EDMSLOG é um conjunto de dados SYSOUT que contém as mensagens do Agente doPowerExchange e de todos os componentes que interagem com o Agente do PowerExchange. Após aabertura do log de mensagem, ele está disponível para aceitar as mensagens do Agente do PowerExchange.


cmd_prefix LOGOPEN


Notas de UsoSe você emitir o comando LOGOPEN quando o conjunto de dados de log EDMSLOG já estiver aberto, oAgente do PowerExchange rejeita-o e emite as seguintes mensagens para o conjunto de dados de log atual:

PWXEDM172078W EDMSLOG0: LOGOPEN command rejected by EDM Agent agent_idPWXEDM172083W EDMSLOG0: The Agent Message log is already open

TÓPICOS RELACIONADOS:¨ “Comando LOGSPIN” na página 39

Comando LOGSPINFecha e desaloca o log de mensagem EDMSLOG atual do Agente do PowerExchange e, em seguida, aloca eabre um novo log de mensagens EDMSLOG. Essa ação equivale à emissão do comando LOGCLOSEseguido pelo comando LOGOPEN.


cmd_prefix LOGSPIN


TÓPICOS RELACIONADOS:¨ “Comando LOGCLOSE” na página 38

¨ “Comando LOGOPEN” na página 39

Comando LOGOPEN 39

Comando REPCLOSEFecha e desaloca o conjunto de dados do repositório do Agente do PowerExchange atual. Você podenecessitar realizar essa função quando estiver gerenciando os conjuntos de dados do repositório em umambiente de teste ou quando necessitar movê-los ou reorganizá-los. Normalmente, o conjunto de dados dorepositório atual é o definido pelo parâmetro REPOSITORYDSN no membro AGENTCTL da bibliotecaRUNLIB. Entretanto, se você usou o comando REPOSITORYDSN para substituir o conjunto de dados dorepositório, o comando REPCLOSE fecha o conjunto de dados do repositório alocado pelo comandoREPOSITORYDSN.


cmd_prefix REPCLOSE


TÓPICOS RELACIONADOS:¨ “Comando REPOPEN” na página 40

¨ “Comando REPOSITORYDSN” na página 40

Comando REPOPENAloca e abre um novo conjunto de dados do repositório do Agente do PowerExchange após a emissão docomando REPCLOSE. Normalmente, esse comando abre o conjunto de dados do repositório definido peloparâmetro REPOSITORYDSN no membro AGENTCTL da biblioteca RUNLIB. Entretanto, se você usou ocomando REPOSITORYDSN para substituir o conjunto de dados do repositório, o comando REPOPEN fechao conjunto de dados do repositório alocado pelo comando REPOSITORYDSN.


cmd_prefix REPOPEN


Notas de UsoSe você emitir esse comando quando o conjunto de dados do repositório já estiver aberto, o Agente doPowerExchange ignora o comando e emite a seguinte mensagem:

PWXEDM172078W EDMSREP0: REPOPEN command rejected by EDM Agent agent_idPWXEDM172083W EDMSREP0: The Repository is already open

TÓPICOS RELACIONADOS:¨ “Comando REPCLOSE” na página 40

¨ “Comando REPOSITORYDSN” na página 40

Comando REPOSITORYDSNFecha e desaloca o conjunto de dados do repositório do Agente do PowerExchange e, em seguida, aloca eabre um novo conjunto de dados com o nome que você especificar.



cmd_prefix REPOSITORYDSN data_set_name

Onde:

¨ cmd_prefix é o prefixo de comando especificado no membro AGENTCTL da biblioteca RUNLIB ou o valordo parâmetro AGENTID no membro AGENTCTL.

¨ data_set_name é o nome que você deseja usar para o novo conjunto de dados do repositório.

Notas de UsoSe você especificar um nome inválido de conjunto de dados no comando REPOSITORYDSN, a alocação donovo conjunto de dados de repositório falha. As seguintes mensagens são gravadas para o conjunto dedados do EDMSLOG:

PWXEDM172076I EDMSREP0: Repository file CLOSEDIKJ56228I DATA SET data_set_name NOT IN CATALOG OR CATALOG CAN NOT BE ACCESSED

Nesse caso, o Agente do PowerExchange aloca um conjunto de dados com o nome do conjunto de dadosanterior. Você deve emitir o comando REPOPEN para abrir esse conjunto de dados do repositório.

TÓPICOS RELACIONADOS:¨ “Comando REPCLOSE” na página 40

¨ “Comando REPOPEN” na página 40

Comando REPSTATUSExibe as informações de status para o conjunto de dados do repositório do Agente do PowerExchange atual,incluindo o nome do conjunto de dados, a hora da última tentativa de atualização, o carimbo de data/hora emque as informações de captura de dados alterados foram recebidas pela última vez e os conjuntos de dadosde cache, se usados.


cmd_prefix REPSTATUS


Exemplo de SaídaO seguinte comando RESTATUS foi informado com o prefixo de comando “AG01”:

AG01 REPSTATUS

Esse comando produz a seguinte saída:

PWXEDM172078I EDMSREP0: REPSTATUS command accepted by EDM Agent AG01PWXEDM181216I DTERIOM : Repository status follows: PWXEDM181217I DTERIOM : PWX10052 last refresh attempt Thu Apr 3 18:32:56 2008PWXEDM181217I DTERIOM : PWX10053 current change identifier 20080403122139PWXEDM181217I DTERIOM : PWX10055 configuration type repository PWX.V.AGENTREPPWXEDM181217I DTERIOM : PWX10057 location node1PWXEDM181217I DTERIOM : PWX10058 cache (1) PWX.V.C1.CACHEPWXEDM181217I DTERIOM : PWX10058 cache (2) PWX.V.C2.CACHEPWXEDM181217I DTERIOM : PWX10062 memory usage: REGS 33K, VIRT 252K, SYS 264K, EXT 5964K, SYS 11964KPWXEDM181217I DTERIOM : PWX10063 memory usage: below the line 2%, above the line 0%PWXEDM181218I DTERIOM : End of repository status

Comando REPSTATUS 41

Comando RESUMERetoma o acesso da tarefa ao Agente do PowerExchange após a emissão de um comando DRAIN. Vocêpode usar os comandos DRAIN e RESUME para suspender temporariamente e, em seguida, retomar aatividade do Agente do PowerExchange.


cmd_prefix RESUME


TÓPICOS RELACIONADOS:¨ “Comando DRAIN” na página 38

Comando SHUTDOWNDesliga o espaço de endereço do Agente do PowerExchange. Esse comando evita que qualquer tarefaadicional seja conectada com o Agente do PowerExchange, porém permite que as tarefas que estejamatualmente conectadas continuem a ser executadas.

Você pode incluir o parâmetro COMPLETELY opcional para desligar o espaço de endereço do Agente doPowerExchange e excluir do armazenamento os espaços de dados e os módulos do Agente doPowerExchange. Antes de emitir o comando SHUTDOWN COMPLETELY, emita o comando DRAIN. Ocomando DRAIN assegura que todas as tarefas que acessam atualmente o Agente do PowerExchange sejamconcluídas antes do início do processamento do desligamento. Após emitir o comando DRAIN, emita ocomando DISPLAY JOBS para determinar se qualquer processo ainda está ativo.

Não use o comando STOP do MVS para interromper o agente do PowerExchange.

Sugestão: Para inicializar o Agente do PowerExchange após um desligamento, use o comando padrãoSTART do MVS.


cmd_prefix SHUTDOWN [COMPLETELY]


Descrição de ParâmetrosComo opção, você pode especificar o seguinte parâmetro para esse comando:

COMPLETELY

Desliga o espaço de endereço do Agente do PowerExchange e exclui o espaço de dados e os módulosdo Agente do PowerExchange do armazenamento. O parâmetro remove completamente o Agente doPowerExchange de um sistema MVS.

TÓPICOS RELACIONADOS:¨ “Comando DRAIN” na página 38

¨ “Comando DISPLAY” na página 37


Comando STARTInicia uma tarefa inativa DIS, LOG ou REP do Agente do PowerExchange.

Essas subtarefas são inicializadas automaticamente na inicialização do Agente do PowerExchange. Se elasforem interrompidas porque você emitiu o comando STOP, ou por qualquer outra razão, use o comandoSTART para reinicializá-las.

Nota: Para inicializar o Agente do PowerExchange após a instalação, ou reinicializá-lo após ter sidointerrompido, use o comando START do MVS com o nome da tarefa do Agente do PowerExchange.


cmd_prefix START {DIS|LOG|REP}

A variável cmd_prefix é o prefixo de comando especificado no membro AGENTCTL da biblioteca RUNLIB.


DIS

Inicializa a subtarefa DIS, que controla dos comandos DISPLAY.

LOG

Inicializa a subtarefa LOG, que grava os dados do espaço de dados do Agente do PowerExchange parao conjunto de dados do log de mensagem EDMSLOG.

REP

Inicializa a subtarefa REP, que oferece acesso às informações do repositório do Agente doPowerExchange, principalmente para os ECCRs.

TÓPICOS RELACIONADOS:¨ “Inicializando o Agente do PowerExchange” na página 37

Comando STOPInterrompe uma tarefa ativa DIS, LOG ou REP do Agente do PowerExchange. De modo geral, você usa essecomando conforme instruções do Suporte Global a Clientes da Informatica ao tentar resolver problemas.


cmd_prefix STOP {DIS|LOG|REP}

A variável cmd_prefix é o prefixo de comando especificado no membro AGENTCTL da biblioteca RUNLIB.


DIS

Interrompe a subtarefa DIS, que controla dos comandos DISPLAY.

LOG

Interrompe a subtarefa LOG, que grava os dados do espaço de dados do Agente do PowerExchangepara o conjunto de dados do log de mensagem EDMSLOG.

Comando START 43

REP

Interrompe a subtarefa REP, que evita o acesso do ECCR às informações de repositório doPowerExchange.



Comandos do Condensador doPowerExchange


¨ Introdução aos Comandos do Condensador do PowerExchange, 45

¨ Inicializando o Condensador do PowerExchange, 46

¨ Emitindo os Comandos do Condensador do PowerExchange, 47

¨ Interrompendo o Processamento do Condensador do PowerExchange, 47

¨ Comando CONDENSE, 48

¨ Comando DISPLAY STATUS, 48

¨ Comando FILESWITCH, 49

¨ Comando SHUTCOND, 50


Introdução aos Comandos do Condensador doPowerExchange

Use os comandos do Condensador do PowerExchange para controlar o processamento do Condensador doPowerExchange em um sistema i5/OS ou z/OS. Com esses comandos, você pode realizar as seguintestarefas:

¨ Exibir o status das subtarefas do Condensador.

¨ Inicializar manualmente um trabalho do Condensador.

¨ Interromper o trabalho do Condensador.

¨ Alternar para um novo conjunto de arquivos condensados.

Nota: No Linux, UNIX e Windows, o Agente de Log do PowerExchange para Linux, UNIX e Windows realizaa função de condensação parcial do Condensador do PowerExchange. Os comandos do Agente de Log doPowerExchange são similares aos do Condensador do PowerExchange.

Você pode usar o programa pwxcmd para emitir os comandos do Condensador do PowerExchange de umsistema Linux, UNIX ou Windows para o processo do Condensador do PowerExchange que está sendoexecutado em um sistema remoto i5/OS ou z/OS.

TÓPICOS RELACIONADOS:¨ “Comandos do Agente de Log do PowerExchange para Linux, UNIX e Windows” na página 77

¨ “Comandos pwxcmd” na página 91

45

Inicializando o Condensador do PowerExchangeO Condensador do PowerExchange deve estar em execução antes de você emitir os comandos.

Antes de você inicializar o Condensador do PowerExchange, deve configurar o Condensador doPowerExchange. Use o parâmetro COLL_END_LOG no arquivo de configuração ou membro CAPTPARMpara definir o modo de execução para contínuo ou em lotes.

O método de inicialização do Condensador do PowerExchange varia conforme o sistema operacional:

¨ Em um sistema i5/OS, execute o programa DTLCACON: Você pode incluir os parâmetros opcionaisCONFIG e LICENSE para especificar qualquer arquivo de configuração de substituição ou arquivo dechave de licença que você criou e deseja usar em vez do arquivo de configuração DBMOVER padrão ouarquivo license.key. Os arquivos de substituição devem ter o caminho ou o nome de arquivo diferente dosarquivos padrão. Esses arquivos de substituição têm precedência em relação a qualquer arquivo de chavede licença e de configuração de substituição que você especificou nas variáveis de ambiente opcionaisPWX_CONFIG e PWX_LICENSE.

¨ Em um sistema z/OS, você pode executar o Condensador do PowerExchange como um trabalho em lotesou uma tarefa inicializada. O PowerExchange oferece uma JCL de amostra nos membros CONDxxx ePCNDxxx da biblioteca SAMPLIB, onde xxx indica o tipo de fonte de dados. Os membros CONDxxxexecutam o Condensador do PowerExchange como um trabalho em lotes e os membros PCNDxxxexecutam o Condensador do PowerExchange como uma tarefa inicializada.

Para obter mais informações sobre a configuração e a inicialização do Condensador do PowerExchange,consulte o guia do CDC para o seu sistema operacional.

Nota: Você não pode usar o programa pwxcmd para inicializar o Condensador do PowerExchange.

Sintaxe no i5/OSEm um subsistema i5/OS, use a seguinte sintaxe para executar o programa DTLCACON no mesmosubsistema do Ouvinte do PowerExchange:

SBMJOB CMD(CALL PGM(DTLCACON) PARM(‘[CS=library/file(mycondense_config_member)] [CONFIG=library/file(myconfig_member)] [LICENSE=library/file(mylicensekey_member)])’)JOB(job_name) JOBD(datalib/DTLLIST) JOBQ(*JOBD) PRTDEV(*JOBD) OUTQ(*JOBD)CURLIB(datalib) INLLIBL(*JOBD)

Onde:

¨ job_name é o nome do trabalho do Condensador que você deseja inicializar.

¨ datalib é o nome da biblioteca de dados do PowerExchange que você especificou na instalação.

Descrições dos parâmetros para i5/OSAo chamar o DTLCACON no i5/OS, você pode especificar um ou mais dos seguintes parâmetros opcionais:

CS

Especifica a biblioteca, nome de arquivo e nome do membro para qualquer membro de configuração decondensação que você criou e deseja usar, em vez do membro de configuração padrão condlib/CFGCOND(CAPTPARM).

CONFIG

Especifica a biblioteca, nome de arquivo e nome do membro de qualquer membro de configuraçãodbmover de substituição que você criou e deseja usar, em vez do membro de configuração padrãocondlib/CFG(DBMOVER) .

LICENSE

Especifica a biblioteca, nome de arquivo e nome do membro para qualquer membro de chave de licençade substituição que você criou e deseja usar, em vez do membro de chave de licença padrão.

Nesses parâmetros, o caminho completo é necessário apenas se o membro não residir em umalocalização padrão.

46 Capítulo 12: Comandos do Condensador do PowerExchange

Emitindo os Comandos do Condensador doPowerExchange

A emissão de comandos para um processo do Condensador do PowerExchange varia conforme o sistemaoperacional.

Em um sistema z/OS, use o comando MODIFY (F) do MVS para emitir os comandos do Condensador doPowerExchange. Você deve incluir o nome do trabalho ou da tarefa inicializada do Condensador, seguido poruma vírgula (,). Nas sintaxes dos comandos, esse nome é indicado pela variável job_name. Você podeinformar os comandos do console do operador do MVS, de uma interface como a SDSF ou de um trabalhoem lotes.

Em um sistema i5/OS, você geralmente usa o SNDPWXCMD para emitir comandos do Condensador doPowerExchange em modo de primeiro plano. Informe os comandos da linha de comando do i5/OS ou inclua-os nos arquivos de script.

Como alternativa, use o programa pwxcmd para emitir os comandos do Condensador do PowerExchange.Você pode emitir um comando pwxcmd de um sistema Linux, UNIX ou Windows para o processo doCondensador do PowerExchange que está sendo executado em um sistema remoto i5/OS ou z/OS.

TÓPICOS RELACIONADOS:¨ “Comandos pwxcmd” na página 91

Interrompendo o Processamento do Condensador doPowerExchange

Use um dos seguintes comandos do PowerExchange para interromper um trabalho do Condensador queesteja sendo executado em modo contínuo:

¨ SHUTDOWN

¨ SHUTCOND

Esses comandos mantém a integridade dos dados e permitem que você retome de modo eficiente oprocessamento de condensação. Ambos os comandos efetuam o mesmo desligamento, porém o comandoSHUTCOND efetua primeiro uma operação de condensação final. Antes de desligar, o Condensador doPowerExchange faz um ponto de verificação que contém os tokens de reinicialização mais recentes para queo processamento do condensador possa ser retomado do ponto em que foi interrompido.

No z/OS, o Condensador do PowerExchange ignora o comando STOP (P). Se você emitir esse comando, oPowerExchange emite uma mensagem indicando que ele não é válido.

No z/OS, se você emitir o comando CANCEL (C) para um trabalho do Condensador, o trabalho éinterrompido. Quando você reinicia o trabalho, ele é retomado do último ponto de verificação. Qualquerprocessamento do condensador que ocorreu desde que o último ponto de verificação é revertido e oPowerExchange exclui os arquivos condensados e registros do CDCT correspondentes.

Você pode emitir um comando pwxcmd shutcond e pwxcmd shutdown de um sistema Linux, UNIX ouWindows para o processo do Condensador do PowerExchange que está sendo executado em um sistemaremoto i5/OS ou z/OS.

TÓPICOS RELACIONADOS:¨ “Comando SHUTCOND” na página 50

¨ “Comando SHUTDOWN” na página 51

¨ “Comando pwxcmd shutcond ” na página 105

¨ “Comando pwxcmd shutdown” na página 105

Emitindo os Comandos do Condensador do PowerExchange 47

Comando CONDENSEInicia manualmente um novo ciclo do condensador, antes do término do período de espera para a retomadado processamento do condensador, se você estiver executando o Condensador do PowerExchange em modocontínuo. Você especifica o período de espera no parâmetro NO_DATA_WAIT do membro de configuraçãoCAPTPARM do Condensador do PowerExchange.

Você pode emitir um comando pwxcmd condense de um sistema Linux, UNIX ou Windows para o processodo Condensador do PowerExchange que está sendo executado em um sistema remoto i5/OS ou z/OS.

SintaxeA sintaxe varia conforme o sistema.

¨ Em um sistema i5/OS, use a seguinte sintaxe para emitir um comando a um trabalho em lotes do i5/OS:SNDPWXCMD CMDHDLRLIB(condlib) DTLCMD(CONDENSE)

A variável condlib é o nome da biblioteca que contém os arquivos condensados. Você especifica essabiblioteca no parâmetro COND_DIR do membro de configuração CAPTPARM.

¨ No sistema z/OS, use a seguinte sintaxe:F job_name,CONDENSE

A variável job_name é o nome da tarefa inicializada do Condensador que está sendo executada por vocêem modo contínuo.

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd condense” na página 103

Comando DISPLAY STATUSExibe o status atual do Controlador do Condensador e cada subtarefa do trabalho do Condensador doPowerExchange.

Como alternativa, em um sistema Linux, UNIX ou Windows, você pode emitir o comando pwxcmddisplaystatus da linha de comando, de um arquivo em lotes ou do script para um processo do Condensadordo PowerExchange que está sendo executado em um sistema remoto ou local.

SintaxeA sintaxe varia conforme a plataforma.

¨ No sistema i5/OS, use a seguinte sintaxe:SNDPWXCMD CMDHDLRLIB(condlib) DTLCMD(DISPLAY) DISPLAYOPT(STATUS)

A variável condlib é o nome da biblioteca que contém os arquivos condensados, que você especificou noparâmetro COND_DIR do arquivo de configuração CAPTPARM.

¨ Em um sistema z/OS, use a seguinte sintaxe:F job_name,DISPLAY STATUS

A váriável job_name é o nome do trabalho do Condensador para o qual deseja exibir as informações.

Exemplo de SaídaO seguinte exemplo de saída foi produzido pelo comando DISPLAY STATUS:

Command=DISPLAY****************** STATUS ************************COMMAND_HANDLER NOT waiting Event=02 ALL_TASK_SHUTDOWN status=1 INTERESTED Event=09 GOT_A_COMMAND status=1 INTERESTED Event=32 CAPTURE_STARTUP_COMPLETE status=1 INTERESTED Event=33 ALL_STUBS_STARTED status=1 INTERESTED Event=38 Unknown status=1 INTERESTEDCONDENSE NOT waiting Event=02 ALL_TASK_SHUTDOWN status=1 INTERESTED Event=24 START_CONDENSING status=1 INTERESTED


Event=32 CAPTURE_STARTUP_COMPLETE status=1 INTERESTED Event=33 ALL_STUBS_STARTED status=1 INTERESTEDDUMP WAITING Event=02 ALL_TASK_SHUTDOWN status=1 INTERESTED Event=10 CMD_TO_DUMP status=1 INTERESTED Event=33 ALL_STUBS_STARTED status=1 INTERESTEDCONTROLLER WAITING Event=02 ALL_TASK_SHUTDOWN status=1 INTERESTED Event=11 CMD_TO_CONT status=1 INTERESTED Event=14 CMDH_FAILED status=1 INTERESTED Event=16 DUMP_FAILED status=1 INTERESTED Event=17 CONDENSE_FAILED status=1 INTERESTED Event=20 CMDH_ENDED status=1 INTERESTED Event=22 DUMP_ENDED status=1 INTERESTED Event=23 CONDENSE_ENDED status=1 INTERESTED Event=27 CMDH_INIT_COMPLETE status=1 INTERESTED Event=29 DUMP_INIT_COMPLETE status=1 INTERESTED Event=30 CONDENSE_INIT_COMPLETE status=1 INTERESTED Event=35 CHKPT_COND_DONE status=1 INTERESTED Event=37 CONDENSING_COMPLETE status=1 INTERESTED**************************************************

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd displaystatus” na página 103

Comando FILESWITCHFecha os arquivos condensados abertos, caso contenham dados e alterna para um novo conjunto dearquivos condensados para o Condensador do PowerExchange. Se os arquivos condensados atuais nãotiverem dados, a alternância de arquivos não ocorre.

Você pode emitir um comando pwxcmd fileswitch de um sistema Linux, UNIX ou Windows para o processo doCondensador do PowerExchange que está sendo executado em um sistema remoto i5/OS ou z/OS.


¨ No sistema i5/OS, use a seguinte sintaxe:SNDPWXCMD CMDHDLRLIB(condlib) DTLCMD(FILESWITCH)


¨ Em um sistema z/OS, use a seguinte sintaxe:F job_name,FILESWITCH

A variável job_name é o nome do trabalho do Condensador para o qual deseja alternar para um novoconjunto de arquivos condensados.

Notas de UsoVocê pode usar esse comando para disponibilizar os dados alterados nos arquivos condensados atuais paraextração, antes da próxima alternância de arquivos. Por exemplo, você deseja extrair os dados alterados acada hora dos arquivos condensados no z/OS. Defina os parâmetros FILE_SWITCH_CRIT eFILE_SWITCH_VAL no arquivos de configuração CAPTPARM, de tal modo que a alternância de arquivoocorra a cada um milhão de atualizações de registro. Em seguida, inclua o comando FILESWITCH comoparte do trabalho em lote para realizar uma alternância de arquivo automática a cada hora, antes daexecução do processo de extração.

Nota: Se você realiza o processamento de condensação total e parcial em um único trabalho doCondensador, o PowerExchange utiliza conjuntos separados de arquivos condensados para as operações decondensação parcial e total. Se você emitir o comando FILESWITCH, uma alternância de arquivos ocorrepara ambos os conjuntos de arquivos condensados.

Comando FILESWITCH 49

Exemplo de SaídaO comando FILESWITCH produziu o seguinte exemplo de saída no z/OS:

Command=FILESWITCHPWX-06461 Command Handler: New File Switch requested. CONDENSE request generated.PWX-06422 Condense: Received FILESWITCH request.PWX-06419 Condense: Doing file switch. Records=14 Reason=FILESWITCH request Cdcts=3 CPU: TotMs=1042022 Diff=1042022PWX-06418 Condense: Closed file condense_file_namePWX-06136 Checkpoint taken to file=checkpoint_file_name time=08/10/10 11:47:14PWX-06420 Condense: Checkpoint done. Sequence=0000001DC19D000000000000001DC19D00000000 Logger=C5C4D4D340400000001DB53400000000PWX-06417 Condense: Start to Condense because CONDENSE Command Received

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd fileswitch ” na página 104

Comando SHUTCONDInterrompe o Condensador do PowerExchange após a conclusão do ciclo de condensação final.

O PowerExchange inicia um ciclo final de condensação, espera que ele seja concluído e, em seguida, desligao Condensador do PowerExchange. Durante o desligamento, o Condensador do PowerExchange fechaqualquer arquivo condensado, grava os dados ao arquivo do CDCT, faz um ponto de verificação final quecontém os tokens de reinicialização mais recentes e, em seguida, desliga.

Você pode emitir um comando pwxcmd shutcond de um sistema Linux, UNIX ou Windows para o processo doCondensador do PowerExchange que está sendo executado em um sistema remoto i5/OS ou z/OS.


¨ No sistema i5/OS, use a seguinte sintaxe:SNDPWXCMD CMDHDLRLIB(condlib) DTLCMD(SHUTCOND)

A variável condlib é o nome da biblioteca que contém os arquivos condensados. Você especificou essabiblioteca no parâmetro COND_DIR do membro de configuração CAPTPARM.

¨ No sistema z/OS, use a seguinte sintaxe:F job_name,SHUTCOND

A variável job_name é o nome do trabalho do Condensador que você deseja interromper.

Exemplo de SaídaO comando SHUTCOND produz o seguinte exemplo de saída:

Command=SHUTCONDPWX-06467 Command Handler: Setting Condense to shut down on running out of data.PWX-06416 Condense: Shutting down because Single Condense run completedPWX-06136 Checkpoint taken to file=checkpoint_file_namePWX-06420 Condense: Checkpoint done. Sequence=token_value Logger=token_valuePWX-06404 Condense: Deleting file condense_file1_name.PWX-06453 Command Handler: shutting down.PWX-06495 Dump: task got an event event_num=2.PWX-06454 Command Handler: has stopped.PWX-06491 Dump: ending.PWX-06110 Unloaded module 1 (COMMAND_HANDLER).PWX-06060 Controller: subtask Command Handler ended.PWX-06110 Unloaded module 4 (DUMP).PWX-06060 Controller: subtask Dump ended.PWX-06404 Condense: Deleting file condense_file2_name.PWX-06414 Condense: Closing down CAPIPWX-06401 Condense: Ending successfully.PWX-06110 Unloaded module 3 (CONDENSE).


PWX-06060 Controller: subtask Condense ended.PWX-06107 Controller: All subtasks shut down.PWX-06065 Controller: Condensing ended. Last checkpoint time 08/11/06 22:19:00.

PWX-06039 Controller: Ending.

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd shutcond ” na página 105

Comando SHUTDOWNInterrompe o Condensador do PowerExchange. O comando transfere um evento de desligamento para oCondensador do PowerExchange. Quando o comando reconhece o Condensador do PowerExchange, asubtarefa Condensador solicita que todas as subtarefas sejam fechadas, fecha qualquer arquivo condensadoaberto, grava os dados para os registros de conjunto de dados do CDCT e obtém um ponto de verificaçãofinal que contém os tokens de reinicialização mais recentes. Após o desligamento de todas as subtarefas docondensador, o Condensador do PowerExchange é desligado.

Nota: O PowerExchange não processa o comando SHUTDOWN até a conclusão das operações de leitura docondensador e o término do período de espera que você especificou no parâmetro NO_DATA_WAIT2 domembro CAPTPARM.

Você pode emitir um comando pwxcmd shutcond de um sistema Linux, UNIX ou Windows para o processo doCondensador do PowerExchange que está sendo executado em um sistema remoto i5/OS ou z/OS.


¨ No sistema i5/OS, use a seguinte sintaxe:SNDPWXCMD CMDHDLRLIB(condlib) DTLCMD(SHUTDOWN)


¨ No sistema z/OS, use a seguinte sintaxe:F job_name,SHUTDOWN

A variável job_name é o nome do trabalho do Condensador que você deseja interromper.

Exemplo de SaídaO comando SHUTDOWN produz o seguinte exemplo de saída:

Command=SHUTDOWNPWX-06463 Command Handler: Close Condense request is now queued.PWX-06464 Command Handler: Shutdown will occur shortly.PWX-06105 Controller: Executing command Setting STOPTASK to CAPI.PWX-06453 Command Handler: shutting down.PWX-06454 Command Handler: has stopped.PWX-06416 Condense: Shutting down because SHUTDOWN event receivedPWX-06060 Controller: subtask Command Handler ended.PWX-06110 Unloaded module 1 (COMMAND_HANDLER).PWX-06495 Dump: task got an event event_num=2.PWX-06491 Dump: ending.PWX-06060 Controller: subtask Dump ended.PWX-06110 Unloaded module 4 (DUMP).PWX-06136 Checkpoint taken to file=EDMUSR.PWX.V860.D.CHKPTV1 time=08/10/09 18:16:05PWX-06420 Condense: Checkpoint done.PWX-06416 Condense: Shutting down because SHUTDOWN event receivedPWX-06060 Controller: subtask Command Handler ended.PWX-06110 Unloaded module 1 (COMMAND_HANDLER).PWX-06495 Dump: task got an event event_num=2.PWX-06491 Dump: ending.PWX-06060 Controller: subtask Dump ended.PWX-06110 Unloaded module 4 (DUMP).PWX-06136 Checkpoint taken to file=checkpoint_file_name time=08/10/09 18:16:05PWX-06420 Condense: Checkpoint done. Sequence=token_value Logger=token_value

Comando SHUTDOWN 51

PWX-06414 Condense: Closing down CAPIPWX-06401 Condense: Ending successfully.PWX-06060 Controller: subtask Condense ended.PWX-06107 Controller: All subtasks shut down.PWX-06065 Controller: Condensing ended. Last checkpoint time 08/10/09 18:16:05.PWX-06110 Unloaded module 3 (CONDENSE).PWX-06039 Controller: Ending.

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd shutdown” na página 105



Comandos do Ouvinte doPowerExchange


¨ Introdução aos Comandos do Ouvinte do PowerExchange, 53

¨ Inicializando o Ouvinte do PowerExchange, 54

¨ Serviço do Ouvinte do PowerExchange no Windows, 56

¨ Comandos CLOSE e CLOSE FORCE, 57

¨ Comandos DISPLAY ACTIVE e LISTTASK, 59

¨ Comando DTLLSTSI, 60

¨ Comando STOPTASK, 62

Introdução aos Comandos do Ouvinte doPowerExchange

Use os comandos do Ouvinte do PowerExchange para concluir as seguintes tarefas:

¨ Exibir informações sobre todas as tarefas do Ouvinte do PowerExchange ativas.

¨ Gerenciar o serviço do Ouvinte do PowerExchange em um sistema Windows.

¨ Interromper uma tarefa individual do Ouvinte do PowerExchange.

¨ Interromper uma tarefa inicializada ou um trabalho do Ouvinte do PowerExchange.

Todos os comandos do Ouvinte do PowerExchange, exceto DTLLSTSI, estão disponíveis em todos ossistemas operacionais. O DTLLSTSI está disponível no Windows. O modo de emissão dos comandos variaconforme o sistema operacional.

Em um sistema z/OS, use o comando MODIFY (F) do z/OS para emitir os comandos do Ouvinte doPowerExchange. Inclua o nome da tarefa inicializada ou nome do trabalho em lote do Ouvinte doPowerExchange, seguido por uma vírgula (,). Você pode informar os comandos do console do operador doMVS ou de uma interface como a SDSF. Da SDSF, coloque uma barra (/) antes de MODIFY ou F, conformemostrado a seguir:

/F job_name,CLOSE

Em um sistema i5/OS, você geralmente usa o SNDLSTCMD para emitir comandos do Ouvinte doPowerExchange em modo de primeiro plano. Você pode informá-los da interface i5/OS ou incorporá-los emREXX EXEC startlst.

Em um sistema Linux, UNIX ou Windows, execute o programa dtllst para iniciar o trabalho do Ouvinte doPowerExchange do prompt de comando. No Windows, você pode executar o Ouvinte do PowerExchangecomo um serviço do Windows.

Você também pode informar os comandos LISTTASK e STOPTASK do Ouvinte do PowerExchange noNavegador do PowerExchange. Na caixa de diálogo Teste de linha de banco de dados, selecione

53

TASK_CNTL na lista Tipo de DB. Como opção, na caixa Aplicativo, informe o nome do aplicativo para ocomando.

Como alternativa, use o programa pwxcmd para emitir os comandos do Ouvinte do PowerExchange de umsistema Linux, UNIX ou Windows para um Ouvinte do PowerExchange que está sendo executado emqualquer sistema.


¨ “Comando DTLLSTSI” na página 60

Inicializando o Ouvinte do PowerExchangeO método de inicialização do Ouvinte do PowerExchange varia conforme o sistema operacional:

Você pode inicializar o Ouvinte do PowerExchange das seguintes maneiras:

¨ No i5/OS, use o comando SBMJOB para executar o programa DTLLST.

¨ No Linux ou UNIX, use um dos seguintes métodos:

- Execute o programa dtllst do prompt de comandos.

- Execute o script startlst enviado com o PowerExchange. O script startlst exclui o arquivo the detail.log einicializa o Ouvinte do PowerExchange.

¨ No z/OS, use um dos seguintes métodos:

- Emita o comando START (S) padrão do MVS para executar o Ouvinte do PowerExchange como umatarefa inicializada.

- Submeta a JCL no membro STARTLST da biblioteca RUNLIB. Você pode incluir a JCL como parte de umtrabalho em lotes.

¨ No Windows, use um dos seguintes métodos:

- Inicialize e gerencie o serviço do Ouvinte do PowerExchange através do menu Iniciar.

- Inicialize e gerencie o serviço do Ouvinte do PowerExchange através do programa dtllstsi.

- Inicialize manualmente o Ouvinte do PowerExchange chamando o programa dtllst com a opção deinicialização do prompt de comando. Sua licença de produto deve permitir esse modo de operação.

No Linux, UNIX, Windows e i5/OS, você pode inclui os parâmetros opcionais CONFIG e LICENSE no dtllstpara especificar os arquivos de chave de licença e a configuração alternativa que deseja usar, em vez dosarquivos originais de chave de licença e de configuração DBMOVER. Normalmente,você define arquivosalternativos em uma localização ou com o nome de arquivo diferente dos arquivos originais. Essa práticaevita que os seus arquivos alternativos personalizados sejam substituídos quando você efetuar o upgrade oureinstalar o produto. Se você também especifica arquivos de chave de licença alternativos nas variáveis deambiente PWX_CONFIG e PWX_LICENSE, os arquivos identificados nos parâmetros CONFIG e LICENSEsubstituem os identificados nas variáveis de ambiente.

Nota: Você não pode usar o programa pwxcmd para inicializar o Ouvinte do PowerExchange.

Sintaxe no i5/OSNo i5/OS, use o comando SBMJOB para chamar o programa DTLLST da linha de comandos.

SBMJOB CMD(CALL PGM(dtllib/DTLLST) PARM(‘[CONFIG=library/file(myconfig_member)] [LICENSE=library/file(mylicense_key_member)] node1’) JOB(job_name) JOBD(datalib/DTLLIST) PRTDEV(*JOBD) OUTQ(*JOBD) CURLIB(*CRTDFT) INLLIBL(*JOBD)

Onde:

¨ dtllib é o nome da biblioteca do software do PowerExchange que você informou na instalação.

¨ node1 é o nome do nó do Ouvinte do PowerExchange que foi especificado na instrução LISTENER domembro de configuração datalib/CFG(DBMOVER).

54 Capítulo 13: Comandos do Ouvinte do PowerExchange

¨ job_name é o nome da tarefa inicializada ou do trabalho do Ouvinte do PowerExchange.

¨ datalib é o nome especificado pelo usuário para a biblioteca de dados do PowerExchange informada nainstalação.

Você pode incluir o comando no programa REXX EXEC startlst ou executá-lo da linha de comando do i5/OS.

Se você incluir o programa DTLLST no startlst, use o seguinte comando para chamar o startlst:

STRREXPRC SRCMBR(startlst) SRCFILE(datalib/rexx) PARM('node1')

Sintaxe no Linux e UNIXNo Linux ou UNIX, use uma das seguintes construções de sintaxe, dependendo do modo de execução doOuvinte do PowerExchange que você deseja usar:

¨ Para executar o Ouvinte do PowerExchange em modo de primeiro plano, use a seguinte sintaxe:dtllst node1 [config=directory/myconfig_file] [license=directory/mylicense_key_file]

¨ Para executar o Ouvinte do PowerExchange em modo de segundo plano, adicione um E comercial (&) nofinal:

dtllst node1 [config=directory/myconfig_file] [license=directory/mylicense_key_file] &¨ Para executar de modo permanente o Ouvinte do PowerExchange, mesmo se a sessão ou o usuário tenha

sido desconectado, adicione o prefixo nohup:nohup dtllst node1 [config=directory/myconfig_file] [license=directory/mylicense_key_file] &

A variável node1 é o nome do nó do Ouvinte do PowerExchange especificado na instrução LISTENER do seuarquivo dbmover.cfg padrão ou de substituição.

Você pode incluir o comando no script startlst ou executá-lo do prompt de comando.

Sintaxe no WindowsNo Windows, use a seguinte sintaxe para inicializar manualmente o Ouvinte do PowerExchange da janelaPrompt de Comando:

dtllst node1 [config=directory\myconfig_file] [license=directory\mylicense_key_file]

A variável node1 é o nome do nó do Ouvinte do PowerExchange especificado na instrução LISTENER do seuarquivo dbmover.cfg padrão ou de substituição.

Sintaxe no z/OSNo z/OS, use o comando padrão START (S) do MVS:

S task_name

A variável task_name é o nome da tarefa inicializada do PowerExchange. Esse comando inicializa atask_name especificada de uma biblioteca PROCLIB do sistema.

Como alternativa, para inicializar um trabalho em lotes do PowerExchange, submeta a JCL no membroSTARTLST de RUNLIB.

Descrições de ParâmetrosAo informar o dtllst, você pode incluir os seguintes parâmetros opcionais:

CONFIG

No Linux, UNIX ou Windows, especifica o caminho e o nome de arquivo completo para qualquer arquivode configuração dbmover.cfg que você criou e deseja usar, em vez do arquivo padrão install_directory/dbmover.cfg. Esse arquivo de configuração alternativo tem precedência em relação a qualquer arquivode configuração alternativo que você especificou na variável de ambiente PWX_CONFIG.

No i5/OS, especifica o nome do membro, nome de arquivo e biblioteca para o membro de configuraçãoalternativo que você deseja usar, em vez do membro padrão datalib/CFG(DBMOVER).

LICENSE

No Linux, UNIX ou Windows, especifica o caminho e o nome de arquivo completo para qualquer arquivode chave de licença que você criou e deseja usar, em vez do arquivo padrão license.key. Esse arquivode chave de licença alternativo tem precedência em relação a qualquer arquivo de chave de licençaalternativo que você especificou na variável de ambiente PWX_LICENSE.

Inicializando o Ouvinte do PowerExchange 55

No i5/OS, especifica o nome do membro, nome do arquivo e biblioteca para o membro de chave delicença alternativo.

Nota: Nos parâmetros CONFIG e LICENSE, o caminho completo é necessário apenas se o membro notreside em uma localização padrão.

Notas de UsoApós a inicialização do Ouvinte do PowerExchange, a seguinte mensagem indica que o Ouvinte doPowerExchange está pronto para comunicação:

PWX00607 - “Listener node” VRM “n.n.n Build Vnnn” started.

No i5/OS, Linux, UNIX e Windows, as seguintes mensagens adicionais são exibidas para identificação doarquivo license.key e do arquivo de configuração dbmover.cfg usados pelo Ouvinte do PowerExchange:

PWX-00595 Using “config” “override_config_file”PWX-00595 Using “license” “override_license_key_file”

Se você definiu as variáveis de ambiente PWX_CONFIG e PWX_LICENSE ou especificou os parâmetrosconfig e license no comando para substituição dos arquivos de licença e configuração, as seguintesmensagens também são exibidas para alertá-lo sobre a ação de substituição:

PWX-00369 The default “config” filename has been overridden.PWX-00369 The default “license” filename has been overridden.

TÓPICOS RELACIONADOS:¨ “Serviço do Ouvinte do PowerExchange no Windows” na página 56

¨ “Comando DTLLSTSI” na página 60

Serviço do Ouvinte do PowerExchange no WindowsNo Windows, você pode executar o Ouvinte do PowerExchange como um serviço do Windows. Você podeinicializar, testar e interromper o serviço do Ouvinte do PowerExchange do menu Iniciar do Windows.

Além disso, você pode usar o comando dtllstsi para inicializar um Ouvinte do PowerExchange de um promptde comando. Como alternativa, se você não deseja executar o Ouvinte do PowerExchange como um serviço,use o comando dtllst.

Por padrão, as seguintes instruções no arquivo de configuração dbmover.cfg definem o Ouvinte doPowerExchange no Windows:

LISTENER=(node1,TCPIP,2480,262144,262144,262144,262144)

Inicializando o Serviço do Ouvinte do PowerExchange no WindowsVocê pode inicializar o serviço do Ouvinte do PowerExchange do menu Iniciar do Windows.

Para inicializar o serviço do Ouvinte do PowerExchange:

u Do menu Iniciar do Windows, clique em Iniciar> Todos osprogramas> Informatica > PowerExchange > v.r.m > Iniciar o Ouvinte do PowerExchange.

A variável v.r.m representa a versão, liberação e nível de modificação do PowerExchange.

Após a ativação do serviço do Ouvinte do PowerExchange, um ícone aparece na área de notificação, àextrema direita da barra de tarefas. Se esse ícone não aparecer, consulte o arquivo detail.log doPowerExchange localizado no seguinte diretório:

C:\windows\system32

Testando o Serviço do Ouvinte do PowerExchange no WindowsVocê pode testar a conexão com o serviço do Ouvinte do PowerExchange do menu Iniciar do Windows.


Para testar o serviço do Ouvinte do PowerExchange:

u Do menu Iniciar do Windows, clique em Iniciar> Todos osprogramas> Informatica > PowerExchange > v.r.m > PING Ouvinte do PowerExchange.

A variável v.r.m representa a versão, a liberação e o nível de modificação do PowerExchange.

Se a conexão estiver ativa, a seguinte informação é exibida:

This does a PowerExchange "ping" to the node "node1"

C:\Informatica\PowerExchangev.r.m>dtlrexe loc=node1 prog=pingPWX-00750 DTLREXE Input LOC=node1, PROG=PING, PARMS=<null>, UID=<>.PWX-00755 DTLREXE Command OK!

C:\Informatica\PowerExchangev.r.m>pausePress any key to continue . . .

Interrompendo o Serviço do Ouvinte do PowerExchange noWindows

Você pode interromper o serviço do Ouvinte do PowerExchange do menu Iniciar do Windows.

Para interromper o serviço do Ouvinte do PowerExchange:

u Do menu Iniciar do Windows, clique em Iniciar> Todos osprogramas> Informatica > PowerExchange > v.r.m > Interromper o Ouvinte do PowerExchange.

A variável v.r.m representa a versão, a liberação e o nível de modificação do PowerExchange.

Comandos CLOSE e CLOSE FORCEInterrompe o trabalho ou a tarefa do Ouvinte do PowerExchange, após a conclusão das seguintes subtarefas:

¨ Subtarefas de movimentação de dados em massa

¨ Subtarefas do CDC, que interrompe a próxima confirmação de uma unidade de trabalho (UOW)

¨ Subtarefas do Ouvinte do PowerExchange

Em caso de subtarefas de execução prolongada no Ouvinte do PowerExchange, use a opção CLOSE FORCEpara forçar o cancelamento de todas as subtarefas do usuário e interromper o Ouvinte do PowerExchange. OOuvinte do PowerExchange espera 30 segundos para que as tarefas em execução sejam concluídas e, emseguida, interrompe qualquer tarefa que continue a ser executada, antes de desligar.

Como alternativa, emita os comandos pwxcmd close e closeforce de um sistema Linux, UNIX ou Windowspara um Ouvinte do PowerExchange que está sendo executado em qualquer sistema.

Sintaxe no i5/OSNo i5/OS, use a seguinte sintaxe de comando:

SNDLSTCMD datalib CLOSE [CLOSEOPT(FORCE)]

A variável datalib é o nome especificado pelo usuário para a biblioteca de dados do PowerExchange quevocê informou na instalação.

Como alternativa, emita os comandos pwxcmd close e closeforce de um sistema Linux, UNIX ou Windowspara um Ouvinte do PowerExchange que está sendo executado em um sistema i5/OS.

Sintaxe no Linux e UNIXSe o Ouvinte do PowerExchange estiver sendo executado em modo de primeiro plano, pressione C e, emseguida, Enter para realizar um desligamento controlado. Pressione Ctrl + C para realizar um desligamento

Comandos CLOSE e CLOSE FORCE 57

forçado. Entretanto, em vez de pressionar Ctrl + C para interromper o processo do Ouvinte doPowerExchange, emita um dos seguintes comandos no prompt:

¨ Se o Ouvinte do PowerExchange estiver sendo executado em modo de primeiro plano e você desejarealizar uma operação CLOSE, emita o seguinte comando:

C¨ Se o Ouvinte do PowerExchange estiver sendo executado em modo de primeiro plano e você deseja

realizar uma operação CLOSE FORCE, emita o seguinte comando:C F

¨ Se o Ouvinte do PowerExchange estiver sendo executado em modo de segundo plano, use os comandospadrão do sistema operacional Linux ou UNIX. Localize a Identificação de processo do Agente de Log doPowerExchange e, em seguida, emita o comando “kill” para aquele processo. Esse desligamentocontrolado é parecido com uma operação CLOSE.

- Para listar as Identificações de processo, digite o seguinte comando no prompt:ps -ef | grep dtllst

- Para interromper o processo do Ouvinte do PowerExchange emitindo um comando CLOSE, digite oseguinte comando:

kill process_ID- Para interromper o processo do Ouvinte do PowerExchange emitindo um comando CLOSE FORCE,

digite o seguinte comando:Kill process_ID

- Se o processo do Ouvinte do PowerExchange não responder a um comando CLOSE FORCE, realize umdesligamento normal e interrompa o processo ao emitir o seguinte comando:

kill -9 process_IDComo alternativa, emita os comandos pwcmd close e closeforce de um sistema Linux, UNIX ou Windows paraum Ouvinte do PowerExchange que está sendo executado em um sistema Linux ou UNIX.

Sintaxe no WindowsNo Windows, digite os seguintes comandos na janela de prompt de comando, na qual você está executandode modo interativo o programa dtllst do Ouvinte do PowerExchange.

¨ Para realizar uma operação CLOSE, digite um dos seguintes comandos:{CLOSE|C}

¨ Para realizar uma operação CLOSE FORCE, digite um dos seguintes comandos:{CLOSE FORCE|CF}

Se o processo do Ouvinte do PowerExchange não responder a um comando CLOSE FORCE, você podepressionar Ctrl + C. Ao pressionar Ctrl + C pela primeira vez, um comando CLOSE é enviado ao serviço doOuvinte do PowerExchange. Ao pressionar Ctrl + C pela segunda vez, o PowerExchange envia um comandoCLOSE FORCE para o serviço do Ouvinte do PowerExchange.

Como alternativa, emita os comandos pwxcmd close e closeforce de um sistema Linux, UNIX ou Windowspara um Ouvinte do PowerExchange que está sendo executado em qualquer sistema Windows.

Sintaxe no z/OSNo z/OS, use a seguinte sintaxe de comando:

F job_name,CLOSE [FORCE]

A variável job_name é o nome da tarefa inicializada ou do trabalho do Ouvinte do PowerExchange.

Como alternativa, emita os comandos pwxcmd close e closeforce de um sistema Linux, UNIX ou Windowspara um Ouvinte do PowerExchange que está sendo executado em um sistema z/OS.


¨ O comando CLOSE realiza um desligamento controlado e gera as seguintes mensagens:PWX-00618 Standard Close in progress.PWX-00619 All tasks closed.PWX-00623 Listener shutdown complete.


¨ Quando você especifica o parâmetro FORCE, o PowerExchange conclui o seguinte procedimento:

1. Verifica se qualquer subtarefa do Ouvinte do PowerExchange está ativa.

2. Se houver subtarefas ativas, realiza uma pesquisa do número de subtarefas ativas a cada segundo,durante 30 segundos.

3. Neste período, o PowerExchange finaliza qualquer subtarefa que estiver esperando pela entrada derede TCP/IP e emite a seguinte mensagem:

PWX-00653 Operator close met while waiting for TCPIP input4. Cancela qualquer subtarefa ativa remanescente.

5. Interrompe o Ouvinte do PowerExchange.

¨ Em um sistema z/OS, o comando CLOSE FORCE tem o mesmo efeito que o comando STOP (P). Prefere-se os comandos CLOSE FORCE e STOP do z/OS ao comando CANCEL (C) do z/OS . O comandoCLOSE FORCE ou STOP do z/OS espera 30 segundos pela conclusão das subtarefas ativas. Emseguida, o PowerExchange cancela todas as tarefas subativas e interrompe a tarefa inicializada ou otrabalho do Ouvinte do PowerExchange.

O comando CANCEL interrompe o Ouvinte do PowerExchange sem antes cancelar as tarefas subativas.Nesse caso, a porta do Ouvinte do PowerExchange permanece indisponível até que o TCP/IP conclua oprocesso de limpeza. Se você inicializou um trabalho do Ouvinte do PowerExchange, antes de concluir alimpeza, uma mensagem de erro indica que a porta está sendo usada.

TÓPICOS RELACIONADOS:¨ “Comando STOPTASK” na página 62

¨ “Comando pwxcmd close” na página 100

¨ “Comando pwxcmd closeforce” na página 100

Comandos DISPLAY ACTIVE e LISTTASKExibe informações sobre cada tarefa ativa do Ouvinte do PowerExchange, incluindo o endereço TCP/IP,número de porta, nome do aplicativo, tipo de acesso e status. Os comandos LISTTASK e DISPLAY ACTIVEproduzem resultados equivalentes. Entretanto, a disponibilidade deles varia de acordo com o sistemaoperacional:

¨ No i5/OS, emita o comando DISPLAY ACTIVE.

¨ No z/OS, emita o comando LISTTASK ou DISPLAY ACTIVE.

¨ No Linux, UNIX e Windows, emita o comando DISPLAY ACTIVE.

Como alternativa, emita o comando pwxcmd listtask de um sistema Linux, UNIX ou Windows para um Ouvintedo PowerExchange que está sendo executado no sistema remoto ou local. Além disso, do Navegador doPowerExchange no Windows, você pode informar o comando LISTTASK na caixa de diálogo Teste da Linhado Banco de Dados.

SintaxeA sintaxe varia conforme o sistema operacional.

A seguinte sintaxe visa informar o comando na linha de comando.

¨ No i5/OS, use a seguinte sintaxe de comando:SNDLSTCMD datalib DISPLAY DISPLAYOPT(ACTIVE)

A variável datalib é o nome especificado pelo usuário para a biblioteca de dados do PowerExchangeinformada na instalação.

Como alternativa, em um sistema Linux, UNIX ou Windows, você pode emitir um comando pwxcmd listtaskda linha de comando, um arquivo em lotes ou o script para o Ouvinte do PowerExchange que está sendoexecutado no sistema i5/OS.

Comandos DISPLAY ACTIVE e LISTTASK 59

¨ No Linux, UNIX e Windows, se o Ouvinte do PowerExchange estiver sendo executado em modo deprimeiro plano, informe um dos seguintes comandos:

DISPLAY ACTIVEou

DNo Windows, se você deseja emitir o comando do Navegador do PowerExchange, informe o comandoLISTTASK na caixa de diálogo Teste da Linha do Banco de Dados. Selecione TASK_CNTL na lista Tipode DB e selecione Listar Tarefas na caixa de diálogo Buscar. Acaixa Instrução SQL exibe listtask.

Como alternativa, em um sistema Linux, UNIX ou Windows, você pode emitir um comando pwxcmd listtaskda linha de comando, um arquivo em lotes ou o script para o Ouvinte do PowerExchange que está sendoexecutado no sistema Linux, UNIX ou Windows.

¨ No z/OS, use a seguinte sintaxe de comandoF job_name,{DISPLAY ACTIVE|D A}

ouF job_name,LISTTASK

A variável job_name é o nome da tarefa inicializada ou do trabalho do Ouvinte do PowerExchange.

Como alternativa, em um sistema Linux, UNIX ou Windows, você pode emitir um comando pwxcmd listtaskda linha de comando, um arquivo em lotes ou o script para o Ouvinte do PowerExchange que está sendoexecutado no sistema z/OS.

Exemplo de SaídaO comando produz a seguinte mensagem de saída em um sistema z/OS:

PWX-00712 taskid=1, partner=255.255.255.255, port=7634, name=app1, am=CAPXRT, status=PWX-00713 1 active tasksPWX-00709 0 Dormant TCBs

A mensagem PWX-00712 é emitida para cada tarefa ativa.

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd listtask” na página 101

Comando DTLLSTSIControla o Ouvinte do PowerExchange que você executa como um serviço do Windows. Use o programadtllstsi para executar as seguintes tarefas:

¨ Criar ou excluir um serviço do Ouvinte do PowerExchange.

¨ Interromper ou inicializar um serviço do Ouvinte do PowerExchange.

¨ Consultar um serviço do Ouvinte do PowerExchange para determinar o seu status.

¨ Exibir as informações de ajuda sobre a sintaxe do dtllstsi.

Sugestão: Você também pode inicializar, testar e interromper o serviço do Ouvinte do PowerExchange domenu Iniciar do Windows.

Se você não deseja executar o Ouvinte do PowerExchange como um serviço do Windows, pode inicializá-lomanualmente.

SintaxeNo Windows, use a seguinte sintaxe de comando:

dtllstsi function "service_name" ["path\dtllstnt.exe"] [parms] [-u "user_id/password"] [-q]

Descrições de ParâmetrosVocê pode incluir os seguintes parâmetros no comando:


function

Obrigatório. A função a ser realizada. As opções são:

¨ add. Cria um novo serviço do Ouvinte do PowerExchange.

¨ delete. Exclui um serviço existente do Ouvinte do PowerExchange.

¨ start. Inicializa o serviço do Ouvinte do PowerExchange.

¨ stop. Interrompe um serviço do Ouvinte do PowerExchange.

¨ query. Exibe a mensagem PWX-00541 ou PWX-00542, que indica se um serviço especificado doOuvinte do PowerExchange está sendo executado ou foi interrompido.

¨ help. Exibe a sintaxe do dtllstsi e explica resumidamente cada parâmetro.

"service_name"

Obrigatório. Nome definido pelo usuário para um serviço do Ouvinte do PowerExchange.

"path\dtllstnt.exe"

Opcional, somente para a função add. Caminho completo para o arquivo executável do serviço para oOuvinte do PowerExchange.

parms

Opcional, somente para a função add. Nomes do nó do Ouvinte do PowerExchange das instruçõesLISTENER no arquivo dbmover.cfg. Se você definir várias instruções LISTENER no dbmover.cfg, podeinicializar vários serviços do Ouvinte do PowerExchange sob um único serviço do Windows.

-u "user_id/password"

Opcional, somente para a função adicionar. Identificação do usuário e senha a serem solicitadas para aexecução do serviço do Ouvinte do PowerExchange.

-q

Opcional. Anula a exibição dos prompts e mensagens do console.

Exemplos¨ Adicionando um Serviço. Para adicionar um novo serviço denominado PowerExchange_Listener1 para o

qual você solicitou uma senha e Identificação do usuário e anulou a saída de mensagens, informe aseguinte instrução:

dtllstsi add "PowerExchange_Listener1" "C:\Informatica\PowerExchange\dtllstnt.exe" node1 -u "joe/mypassword" -q

¨ Excluindo um Serviço. Para remover o serviço denominado PowerExchange_Listener1 do sistema oWindows, informe a seguinte instrução:

dtllstsi delete "PowerExchange_Listener1"¨ Inicializando um Serviço. Para inicializar o serviço do PowerExchange_Listener1, que você adicionou

previamente, informe a seguinte instrução:dtllstsi start "PowerExchange_Listener1"

Nota: Você também pode inicializar um serviço do Ouvinte do PowerExchange ao clicar emIniciar> Programas > Informatica PowerExchange > Iniciar o Ouvinte do PowerExchange.

¨ Interrompendo um Serviço. Para interromper o serviço PowerExchange_Listener1 durante a execução,informe a seguinte instrução:

dtllstsi stop "PowerExchange_Listener1"¨ Consultando um Serviço. Para determinar se o serviço PowerExchange_Listener1 está sendo

executado, informe a seguinte instrução:dtllstsi query "PowerExchange_Listener1"

Se o serviço PowerExchange_Listener1 não estiver sendo executado, a seguinte mensagem é emitida:PWX00542 Service "PowerExchange_Listener" STOPPED.

Comando DTLLSTSI 61

TÓPICOS RELACIONADOS:¨ “Inicializando o Ouvinte do PowerExchange” na página 54

¨ “Inicializando o Serviço do Ouvinte do PowerExchange no Windows” na página 56

Comando STOPTASKInterrompe uma tarefa individual do Ouvinte do PowerExchange com base no nome do aplicativo que vocêespecificar.

Sugestão: Para determinar o nome da tarefa ativa, emita o comando DISPLAY ACTIVE ou LISTTASK. Nasaída do comando, procure a mensagem PWX-00712 para a tarefa e anote o valor do nome. Você deveinformar esse valor no comando STOPTASK.

Durante a extração de dados alterados, o comando STOPTASK espera para interromper a tarefa até que oUOW final seja encontrado ou o limite de confirmação seja alcançado. Para obter as informações sobre ocontrole do processamento de confirmação, consulte Interfaces do PowerExchange para o PowerCenter.

Como alternativa, você pode emitir um comando pwxcmd stoptask de um sistema Linux, UNIX ou Windowspara um Ouvinte do PowerExchange que está sendo executado em qualquer sistema. Além disso, noNavegador do PowerExchange no Windows, você pode informar o comando STOPTASK na caixa de diálogoTeste da Linha do Banco de Dados.

Sintaxe no i5/OSNo i5/OS, use a seguinte sintaxe de comando:

SNDLSTCMD datalib STOPTASK STOPTASK(application_name)

Onde:

¨ datalib é o nome especificado pelo usuário para a biblioteca de dados do PowerExchange informada nainstalação.

¨ application_name é o nome para o processo de extração ativo que você deseja interromper. Esse nomeestá incluído na mensagem PWX-00712 da saída de comando DISPLAY ACTIVE.

Como alternativa, você pode emitir um comando pwxcmd stoptask de um sistema Linux, UNIX ou Windowspara um Ouvinte do PowerExchange que está sendo executado em um sistema i5/OS.

Sintaxe no Linux, UNIX e WindowsNo Linux, UNIX ou Windows, use a seguinte sintaxe de comando:

STOPTASK APPLID=application_name

ou

S application_name

O application_name é o nome para o processo de extração ativo que você deseja interromper. Esse nomeestá incluído na mensagem PWX-00712 da saída de comando D (DISPLAY ACTIVE).

No Windows, se você deseja emitir o comando do Navegador do PowerExchange, informe o comandoSTOPTASK na caixa de diálogo Teste da Linha do Banco de Dados. Selecione TASK_CNTL na lista Tipode DB e selecione Interromper Tarefas na caixa de diálogo Buscar. A caixa Instrução SQL exibe stoptasktaskid=. Informe uma Identificação da tarefa.

Como alternativa, você pode emitir um comando pwxcmd stoptask de um sistema Linux, UNIX ou Windowspara um Ouvinte do PowerExchange que está sendo executado no sistema Linux, UNIX ou Windows.

Sintaxe no z/OSNo z/OS, use a seguinte sintaxe de comando:

F job_name,STOPTASK APPL=application_name|TASKID=task_id


Onde:

¨ job_name é o nome da tarefa inicializada ou do trabalho do Ouvinte do PowerExchange.

¨ application_name é o nome para o processo de extração ativo que você deseja interromper. Esse nomeestá incluído na mensagem PWX-00712 da saída de comando LISTTASK.

¨ task_id é o identificador numérico para a tarefa do Ouvinte do PowerExchange que você desejainterromper. Essa Identificação está incluída na mensagem PWX-00712 da saída de comando LISTTASK.

Como alternativa, você pode emitir um comando pwxcmd stoptask de um sistema Linux, UNIX ou Windowspara um Ouvinte do PowerExchange que está sendo executado em um sistema z/OS.

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd stoptask” na página 102

¨ “Serviço do Ouvinte do PowerExchange no Windows” na página 56

Comando STOPTASK 63


Comandos do Agente de Log doPowerExchange para MVS


¨ Introdução ao Agente de Log do PowerExchange para os Comandos do MVS, 64

¨ Inicializando o Agente de Log do PowerExchange para MVS, 66

¨ Comando DEFINE_LOG, 66

¨ Comando DELETE_LOG, 69

¨ Comando DISPLAY OBJECT=CONNECTION, 70

¨ Comando DISPLAY OBJECT=LOG, 71

¨ Comando PRINT, 72

¨ Comando RESOLVE_INDOUBT, 73

¨ Comando STOP, 74

¨ Comandos de Mesclagem Pós-Log, 75

Introdução ao Agente de Log do PowerExchangepara os Comandos do MVS

Use os comandos do Agente de Log do PowerExchange para gerenciar os seus conjuntos de dados de log,UOWs e conexões. Esses comandos pertencem a qualquer instalação do PowerExchange que utiliza oAgente de Log do PowerExchange para MVS.

Com os comandos do Agente de Log do PowerExchange, você pode executar as seguintes tarefas:

¨ Exibir informações sobre os conjuntos de dados de log do Agente de Log do PowerExchange, UOWs,conexões do leitor e do gravador.

¨ Resolver UOWs suspeitos registrados nos registros de log.

¨ Interromper o Ouvinte do PowerExchange.

¨ Imprimir o conteúdo do log ativo do Agente de Log do PowerExchange para um conjunto de dadosSYSOUT.

¨ Definir novos conjuntos de dados de log do Agente de Log do PowerExchange.

¨ Excluir os registros de log do Agente de Log do PowerExchange do conjunto de dados de reinicialização.

Se você estiver capturando alterações de várias imagens do MVS em um ambiente sysplex e usando váriosAgentes de Log do PowerExchange, pode utilizar os comandos de Mesclagem Pós-Log para controlar comoas alterações são mescladas em um único fluxo.

64

TÓPICOS RELACIONADOS:¨ “Comandos de Mesclagem Pós-Log” na página 75

Métodos para Emitir os Comandos do Agente de Log doPowerExchange

Emita os comandos básicos do Agente de Log do PowerExchange em uma das seguintes maneiras:

¨ Use o comando MODIFY (F) do MVS para emitir os comandos de modo interativo do console do operadordo MVS ou de uma interface como a SDSF. O Agente de Log do PowerExchange deve estar em execuçãoquando você emitir o comando MODIFY.

¨ Inclua os comandos como parte dos trabalhos do utilitário em lotes para alteração da configuração doAgente de Log do PowerExchange ou gerenciamento dos conjuntos de dados de reinicialização e de log.O Agente de Log do PowerExchange Logger não deve estar sendo executado junto com esses trabalhos.As alterações tornam-se efetivas quando você reinicializa o Agente de Log do PowerExchange.

A seguinte tabela resume os métodos disponíveis para emissão de cada comando do Agente de Log doPowerExchange:

Comando Com o comando MODIFY do MVS Em um trabalho emlotes

DEFINE_LOG X

DELETE_LOG X X

DISPLAY OBJECT X X

PRINT X X

RESOLVE_INDOUBT X

STOP X

Regras de Sintaxe e Diretrizes para os Comandos do Agente deLog do PowerExchange

As seguintes regras e diretrizes de sintaxe se aplicam aos comandos básicos do Agente de Log doPowerExchange:

¨ Não use o mesmo parâmetro mais do que uma vez em um comando do Agente de Log do PowerExchange.

¨ Para trabalhos em lotes, inclua Agente de Log do PowerExchange cartões de controle sob a instruçãoSYSIN DD. Se forem especificados vários parâmetros, adicione uma vírgula (,) após cada um, exceto noúltimo parâmetro anterior a END, como:

DEFINE_LOGDSNAME=PWX.MYLOGS.SECLOG.DS03,COPY=SECLOGEND

¨ Você pode incluir vários comandos do Agente de Log do PowerExchange em um trabalho de alteração emlotes para realizar uma tarefa como a definição de um conjunto de dados de log.

¨ Se você usar o comando MODIFY (F) do MVS para emitir os comandos do Agente de Log doPowerExchange, você deve incluir o nome do procedimento do Agente de Log do PowerExchange seguidopor uma vírgula (,). Na sintaxe, esse nome é indicado pela variável proc_name. Se você usar o SDSF,coloque uma barra (/) no início, como:

/F proc_name,COMMAND¨ Outras convenções de sintaxe, como o uso de colchetes [ ] e chaves { }, são aplicadas aos comandos do

Agente de Log do PowerExchange.

Introdução ao Agente de Log do PowerExchange para os Comandos do MVS 65

TÓPICOS RELACIONADOS:¨ “Convenções de Sintaxe dos Comandos do PowerExchange ” na página 2

Inicializando o Agente de Log do PowerExchangepara MVS

No começo, use o comando START (S) do MVS para inicializar ou reinicializar a tarefa do Agente de Log doPowerExchange. Talvez você necessite reinicializar o Agente de Log do PowerExchange se ele forinterrompido, por exemplo, em resposta ao comando STOP.

Inicialize o Agente de Log do PowerExchange após você inicializar o Agente do PowerExchange, mas antesde inicializar qualquer outro espaço de endereço do componente do CDC do PowerExchange.


{START|S} proc_name

A variável proc_name é o nome do procedimento do Agente de Log do PowerExchange.

Comando DEFINE_LOGAdiciona as definições do log do Agente de Log do PowerExchange ao conjunto de dados de reinicialização.Você pode adicionar as definições para os seguintes tipos de conjuntos de dados de log:

¨ Definições do log ativo adicional

¨ Definições do log ativo de substituição

¨ Definições de log do arquivo morto de substituição

Nota: A instalação do PowerExchange cria definições para, no mínimo, três conjuntos de dados do log ativo.Você pode criar conjuntos de dados de log ativo adicionais, com no máximo 31 logs ativos.

Inclua as instruções de controle DEFINE_LOG em trabalhos em lotes que contêm as tarefas de manutençãode logs. O PowerExchange inclui uma JCL de amostra para adição de definições de conjunto de dados de logativo no membro #ADDLOGS da biblioteca SAMPLIB.

SintaxePara definir os logs ativos do Agente de Log do PowerExchange, use a seguinte sintaxe para as instruçõesde controle:

DEFINE_LOGDSN=data_set_name,COPY={PRILOG|SECLOG},[STARTRBA=X’start_rba’,ENDRBA=X’end_rba’]END

Para definir os logs do arquivo morto do Agente de Log do PowerExchange, use a seguinte sintaxe para asinstruções de controle:

DEFINE_LOGDSN=data_set_name,[STARTRBA=X’start_rba’,ENDRBA=X’end_rba’,][TODSTATIME=X’start_time’,TODENDTIME=X’end_time’,]{VOL1=archivelog1_volser|VOL2=archivelog2_volser}END

Use as seguintes regras de sintaxe:

¨ Se você especificar STARTRBA, também deve especificar ENDRBA.

66 Capítulo 14: Comandos do Agente de Log do PowerExchange para MVS

¨ Se você especificar TODSTATIME, também deve especificar TODENDTIME.

¨ Para logs do arquivo morto, você deve especificar VOLUME1 ou VOLUME2. Não especifique ambas.

Descrições de ParâmetrosVocê pode especificar os seguintes parâmetros para DEFINE_LOG:

COPY

Indica se define o conjunto de dados para os logs ativos primários ou secundários. Informe uma dasseguintes opções:

¨ PRILOG. Define um conjunto de dados de log primário.

¨ SECLOG. Define um conjunto de dados de log secundário, que atua como uma cópia de backup.

Esse parâmetro é exigido para logs ativos.

{DSN|DSNAME|LOG_DSNAME}

Especifica um nome completo do conjunto de dados de log. O tamanho máximo é de 44 caracteres.

END

Indica o fim da instrução de controle DEFINE_LOG para um conjunto de dados de log.

ENDRBA

Especifica o RBA do fim do conjunto de dados de log de substituição nomeado pelo parâmetro DSNAME.Um conjunto de dados de log de substituição é o que substitui um arquivo de log previamente existente.Informe esse valor de RBA em formato hexadecimal, iniciando com a letra “X” e, em seguida, adicioneexatamente 12 dígitos hexadecimais entre aspas simples, por exemplo, X'0000004552FF'. Se você nãosabe qual é esse valor de RBA, pode obtê-lo consultando as mensagens geradas, quando o conjunto dedados de log foi originalmente criado, ou executando o comando DISPLAY OBJECT=LOG do Agente deLog do PowerExchange.

Esse parâmetro é necessário apenas para os conjuntos de dados de log do arquivo morto ou ativo desubstituição. Não use o parâmetro se você estiver definindo um novo conjunto de dados de log ativo.

Você também deve especificar o parâmetro STARTRBA. O valor STARTRBA deve ser menor do que ovalor ENDRBA.

STARTRBA

Especifica o RBA do início do conjunto de dados de log de substituição nomeado pelo parâmetroDSNAME. Um conjunto de dados de log de substituição é o que substitui um arquivo de log previamenteexistente. Informe esse valor de RBA em formato hexadecimal, iniciando com a letra “X” e, em seguida,adicione exatamente 12 dígitos hexadecimais entre aspas simples, por exemplo, X'000000422108'. Sevocê não sabe qual é esse valor de RBA, pode obtê-lo consultando as mensagens geradas, quando oconjunto de dados de log foi originalmente criado, ou executando o comando DISPLAY OBJECT=LOG doAgente de Log do PowerExchange.

Esse parâmetro é necessário apenas para os conjuntos de dados do log do arquivo morto ou ativo desubstituição em um ambiente que não seja de Mesclagem Pós-Log. Não use o parâmetro se você estiverdefinindo um novo conjunto de dados de log ativo.

Você também deve especificar o parâmetro ENDRBA. O valor ENDRBA deve ser maior do que o valorSTARTRBA.

TODENDTIME

Para um ambiente de Mesclagem Pós-Log, especifica o carimbo de data/hora do fim do conjunto dedados de log do arquivo morto de substituição nomeado pelo parâmetro DSNAME. Um conjunto dedados de log do arquivo morto de substituição é o que substitui um arquivo de log previamente existente.Informe esse valor de carimbo de data/hora em formato hexadecimal, iniciando com a letra “X” e, emseguida, adicione exatamente 16 dígitos hexadecimais entre aspas simples, por exemplo,X'BDCO5246A8723542'. Se você não sabe qual é esse valor de carimbo de data/hora, pode obtê-loconsultando as mensagens geradas, quando o conjunto de dados de log foi originalmente criado, ouexecutando o comando DISPLAY OBJECT=LOG do Agente de Log do PowerExchange.

Comando DEFINE_LOG 67

Esse parâmetro é necessário apenas para os conjuntos de dados do log do arquivo morto desubstituição em um ambiente de Mesclagem Pós-Log. Não use o parâmetro se você estiver definindo umnovo conjunto de dados de log ou se você não usar a função de Mesclagem Pós-Log.

Você também deve especificar o parâmetro TODSTATIME. O valor TODSTATIME deve ser menor doque o valor TODENDTIME.

TODSTATIME

Para um ambiente de Mesclagem Pós-Log, especifica o carimbo de data/hora do início do conjunto dedados de log do arquivo morto de substituição nomeado pelo parâmetro DSNAME. Um conjunto dedados de log do arquivo morto de substituição é o que substitui um arquivo de log do arquivo mortopreviamente existente. Informe esse valor em formato hexadecimal, iniciando com a letra “X” e, emseguida, adicione exatamente 16 dígitos hexadecimais entre aspas simples, por exemplo,X'BDCO4135624371A8'. Se você não sabe qual é esse valor de carimbo de data/hora, pode obtê-loconsultando as mensagens geradas, quando o conjunto de dados de log do arquivo morto foioriginalmente criado, ou executando o comando DISPLAY OBJECT=LOG do Agente de Log doPowerExchange.

Esse parâmetro é necessário apenas para os conjuntos de dados do log do arquivo morto desubstituição em um ambiente de Mesclagem Pós-Log. Não use o parâmetro se estiver definindo um novoconjunto de dados de log ou se não usar a função de Mesclagem Pós-Log.

Você também deve especificar o parâmetro TODENDTIME. O valor TODENDTIME deve ser maior doque o valor TODSTATIME.

{VOL1|VOLUME1|COPYVOL1}

Para logs do arquivo morto apenas, especifica o número de série do volume, também denominadovolser, em que está localizado o conjunto de dados de log do arquivo morto. Use esse parâmetro apenaspara um conjunto de dados de log do arquivo morto primário.

{VOL2|VOLUME2|COPYVOL2}

Para logs do arquivo morto apenas, especifica o número de série do volume, também denominadovolser, em que está localizado o conjunto de dados de log do arquivo morto. Use esse parâmetro apenaspara um conjunto de dados de log do arquivo morto secundário.

ExemploO comando e as instruções de controle seguintes definem o conjunto de dados de log do arquivo mortoprimário, denominado ARCHLOG1.PWXL.LG1.D2007331.T1536523, em um ambiente que não seja deMesclagem´Pós-Log:

DEFINE_LOGDSN=PWXUSR1.ARCHLOG1.PWXL.LG1.D2007331.T1536523,VOL1=DSK38F,STARTRBA=X'000000168000',ENDRBA=X'0000002CFFFF'END

A saída resultante é:

L O G S T A R TPWXEDM172502I EDM Logger BATCH initialization in-progress product level V2.4.05 08/31/2006PWXEDM172638I EDM Logger system timestamp for ERDS = 2008.107 15:11:09.49DEFINE_LOG DSNAME=PWXUSR1.ARCHLOG1.PWXL.LG1.D2007331.T1536523, VOL1=DSK38F, STARTRBA=X'000000168000',ENDRBA=X'0000002CFFFF' END PWXEDM172572I EDM Logger input commands accepted execution startedPWXEDM172506I EDM Logger BATCH Shutdown in progressPWXEDM172508I EDM Logger #### TASK EDMLIPC0 COMPLETE RC=00PWXEDM172508I EDM Logger #### TASK EDMLCKP0 COMPLETE RC=00PWXEDM172508I EDM Logger #### TASK EDMLRLM0 COMPLETE RC=00PWXEDM172508I EDM Logger #### TASK EDMLLLG0 COMPLETE RC=00PWXEDM172509I EDM Logger BATCH shutdown completeL O G E N D


Comando DELETE_LOGExclui todas as informações sobre um determinado conjunto de dados de log do Agente de Log doPowerExchange do conjunto de dados de reinicialização de emergência (ERDS). Execute esse comandoperiodicamente para excluir as informações sobre conjuntos de dados de log obsoletos do arquivo morto.

Emita esse comando usando o comando MODIFY (F) do MVS ou adicionando-o a trabalhos em lotes queincluem tarefas de manutenção de log.

SintaxePara emitir o comando com o MODIFY do MVS, use a seguinte sintaxe:

F proc_name,DELETE_LOG DSN=data_set_name


Para emitir o comando em modo de lotes, adicione as seguintes instruções de controle a um trabalho emlotes:

DELETE_LOGDSN=data_set_nameEND

Descrições de ParâmetrosVocê pode especificar os seguintes parâmetros para DELETE_LOG:

{DSN|DSNAME|LOG_DSNAME}

Especifica o nome completo do conjunto de dados de log cujas informações você deseja remover doERDS. O tamanho máximo é de 44 caracteres.

END

Indica o fim da instrução de controle DELETE_LOG para um conjunto de dados de log em um trabalhoem lotes. Necessário apenas para as instruções de controle em lotes.

Notas de Uso¨ Se você usar o comando MODIFY do MVS para executar o comando DELETE_LOG no modo interativo, o

Agente de Log do PowerExchange poderá continuar em execução.

¨ Se você executar o comando DELETE_LOG como parte de um trabalho em lotes, pare o Agente de Logdo PowerExchange antes da execução do trabalho em lotes. Pare também qualquer ECCR que estiver emexecução nas fontes de dados cujas alterações são registradas pelo Agente de Log do PowerExchange.

ExemploExecute o seguinte comando no modo em lotes para excluir o conjunto de dados de log do arquivo mortodenominado PWXUSR1.ARCHLOG1.PWXL.LG1.D2007331.T1536523:

DELETE_LOGDSNAME=PWXUSR1.ARCHLOG1.PWXL.LG1.D2007331.T1536523END


L O G S T A R TPWXEDM172502I EDM Logger BATCH initialization in-progress product level V2.4.05 08/31/2006PWXEDM172638I EDM Logger system timestamp for ERDS = 2008.107 15:11:09.49DELETE_LOG DSNAME=PWXUSR1.ARCHLOG1.PWXL.LG1.D2007331.T1536523 END PWXEDM172572I EDM Logger input commands accepted execution startedPWXEDM172506I EDM Logger BATCH Shutdown in progressPWXEDM172508I EDM Logger #### TASK EDMLIPC0 COMPLETE RC=00PWXEDM172508I EDM Logger #### TASK EDMLCKP0 COMPLETE RC=00PWXEDM172508I EDM Logger #### TASK EDMLRLM0 COMPLETE RC=00PWXEDM172508I EDM Logger #### TASK EDMLLLG0 COMPLETE RC=00PWXEDM172509I EDM Logger BATCH shutdown completeL O G E N D

Comando DELETE_LOG 69

Comando DISPLAY OBJECT=CONNECTIONExibe as informações sobre as conexões do leitor do Agente de Log do PowerExchange, conexões dogravador ou todas as conexões de UOW.


MODIFY proc_name,DISPLAY OBJECT=CONNECTION,[{TYPE=READER|WRITER|UOW}],[CONID={*|pattern}]


F proc_name,DIS OB={CON|CONN},[TYPE={READER|WRITER|UOW}],CONID=[{*|pattern}]


Para emitir o comando em modo de lote, adicione as seguintes instruções de controle a um trabalho em lotes:

DISPLAY OBJECT=CONNECTION,[TYPE={READER|WRITER|UOW}],[CONID={*|pattern}]END

Sugestão: Se você informar apenas DISPLAY, o PowerExchange trata esse comando como se você tivesseinformado-o com a palavra-chave OBJECT=CONNECTION.

Descrições de ParâmetrosVocê pode especificar os seguintes parâmetros para DISPLAY OBJECT=CONNECTION:

TYPE

Define o tipo de conexões para exibição das informações. Informe uma das seguintes opções:

¨ READER. Exibe as informações sobre as conexões do leitor do log.

¨ WRITER. Exibe as informações sobre as conexões do gravador do log.

¨ UOW. Exibe as informações sobre as conexões do UOW.

Esse parâmetro é opcional. Se você não desejar incluí-lo, o PowerExchange exibe as informações paratodos os tipos de conexões.

Se você também especificou o parâmetro CONID, são exibidas apenas as conexões que correspondemaos critérios da Identificação de conexão em CONID.

CONID

Especifica as Identificações das conexões do Agente de Log do PowerExchange para exibição deinformações. Você pode informar as Identificações de conexão das seguintes maneiras:

¨ Para selecionar uma única conexão do Agente de Log do PowerExchange, informe uma Identificaçãoespecífica de conexão.

¨ Para selecionar todas as Identificações de conexão do Agente de Log do PowerExchange, informeapenas o caractere curinga asterisco (*).

¨ Para selecionar um subconjunto de Identificações de conexão, informe um padrão de caracterecuringa. Um padrão de caractere curinga é composto pela primeira parte da Identificação de conexão,seguida pelo caractere curinga asterisco (*), tal como PWX*.

O padrão é o caractere curinga asterisco (*).

ExemploO seguinte comando exibe as informações sobre todas as conexões do gravador de log ativo do PWXLLOG5do Agente de Log do PowerExchange:

F PWXLLOG5,DIS OB=CON,TYPE=U


PWXEDM172679I EDM Logger UOW CONNECTION report follows: *ECCR UOW Type Logger UOWid Status *


PWXDBM01 0000A924C03400000000 UOW PWXL00000B18D9580000 in-flight PW9DBM01 0000CD94CD5C00000000 UOW PWXL00000D1CF9230000 in-flight

TÓPICOS RELACIONADOS:¨ “Comando DISPLAY OBJECT=LOG” na página 71

Comando DISPLAY OBJECT=LOGExibe as informações sobre os conjuntos de dados de log ativo, os conjuntos de dados de log do arquivomorto ou ambos os tipos de conjuntos de dados de log do Agente de Log do PowerExchange.


MODIFY proc_name,DISPLAY OBJECT=LOG,[TYPE={ALL|ACTIVE|ARCHIVE}],[DSN={*|pattern}]

Como alternativa, você pode especificar a seguinte sintaxe:

F proc_name,DIS OB=LOG,[TYPE={ALL|ACT|ARC}],[DSN={*|pattern}]



DISPLAYOBJECT=LOG,[TYPE={ALL|ACTIVE|ARCHIVE}],[DSN={*|pattern}]END

Descrições de ParâmetrosVocê pode especificar os seguintes parâmetros para DISPLAY OBJECT=LOG:

TYPE

Define o tipo de conjuntos de dados de log para exibição das informações. Informe uma das seguintesopções:

¨ ALL. Exibe as informações sobre todos os logs do arquivo morto e ativos que correspondem ao valorDSNAME especificado.

¨ ACTive. Exibe as informações sobre todos os logs ativos que correspondem ao valor DSNAMEespecificado.

¨ ARChive. Exibe as informações sobre todos os logs do arquivo morto que correspondem ao valorDSNAME especificado.

Sugestão: As letras em maiúscula nos nomes das opções indicam a forma abreviada do nome quevocê pode informar.

O padrão é ACTive.

{DSN|DSNAME}={*|pattern}

Especifica os nomes para os conjuntos de dados do Agente de Log do PowerExchange para a exibiçãode informações. Você pode informar os nomes dos conjuntos de dados das seguintes maneiras:

¨ Para selecionar um único conjunto de dados de log do Agente de Log do PowerExchange, informe onome completo do conjunto de dados.

¨ Para selecionar todos os conjuntos de dados de log do Agente de Log do PowerExchange, informeapenas o caractere curinga asterisco (*);.

¨ Para selecionar um subconjunto de conjuntos de dados de log, informe um padrão de caracterecuringa. Um padrão de caractere curinga é composto pela primeira parte do nome do conjunto dedados, seguida pelo caractere curinga asterisco (*), tal como PWXUSR1.PWXT.PWXL.SECA.

O padrão é o caractere curinga asterisco (*).

Comando DISPLAY OBJECT=LOG 71

ExemploO seguinte comando exibe as informações sobre todos os conjuntos de dados de log ativo do Agente de Logdo PowerExchange PWXLLOG5:

F PWXLLOG5,DIS OB=LOG,TYPE=ACT,DSN=*


PWXEDM172679I EDM Logger LOG ACTIVE report follows: *Start RBA End RBA Log Dsname Status 0000093A8000 00000C4DFFFF PWXUSR1.PWXT.PWXL.PRILOG.DS01 REUS,IN-USE 00000C4E0000 00000F617FFF PWXUSR1.PWXT.PWXL.PRILOG.DS02 REUS 000006270000 0000093A7FFF PWXUSR1.PWXT.PWXL.PRILOG.DS03 REUS 0000093A8000 00000C4DFFFF PWXUSR1.PWXT.PWXL.SECLOG.DS01 REUS,IN-USE 00000C4E0000 00000F617FFF PWXUSR1.PWXT.PWXL.SECLOG.DS02 REUS 000006270000 0000093A7FFF PWXUSR1.PWXT.PWXL.SECLOG.DS03 REUS

TÓPICOS RELACIONADOS:¨ “Comando DISPLAY OBJECT=CONNECTION” na página 70

Comando PRINTImprime os registros ativos e de logs do arquivo morto do Agente de Log do PowerExchange em formatohexadecimal para um conjunto de dados SYSOUT. O conjunto de dados SYSOUT é alocado dinamicamentesempre que você executar esse comando. Dependendo dos parâmetros que você define, pode imprimir osseguintes conjuntos de registro:

¨ Os 50 registros de log inicializados do RBA inicial que você especificar

¨ Todos os registros de log até o RBA final que você especificar

¨ Todos os registros de log entre os RBAs inicial e final que você especificar

Normalmente, você usa o comando PRINT seguindo somente as instruções do Suporte Global aos Clientesda Informatica para fins de solução de problemas. O comando pode produzir grande quantidade de saídas.


F proc_name,PRINT {STARBA=x'rba_number',ENDRBA=x'rba_number'}



PRINT {STARBA=x'rba_number',ENDRBA=x'rba_number'}END

Você deve especificar STARBA, ENDRBA ou ambos. Se você especificar ambos os parâmetros, inclua umavírgula entre eles.

Descrições de ParâmetrosVocê deve especificar apenas um dos seguintes parâmetros para indicar o intervalo de registros de log aserem impressos. Se você especificar ambos os parâmetros, são impressos os registros de log entre osRBAs inicial e final.

{ENDRBA|STOPRBA|STORBA}

Especifica o RBA que indica o final do intervalo de registros de log a serem impressos. Informe essevalor de RBA em formato hexadecimal, iniciando com a letra “X” e, em seguida, adicionando exatamente12 dígitos hexadecimais entre aspas simples, por exemplo, X'0000004552FF'. Se você não sabe qual éesse valor RBA, pode obtê-lo consultando as mensagens geradas quando os registros de log foramcriados ou executando o comando DISPLAY OBJECT=LOG do Agente de Log do PowerExchange.


Se você também não informou um valor STARBA, são impressos todos os registros de log até a posiçãoENDRBA.

Se você informou os valores STARBA e ENDRBA, o valor ENDRBA deve ser maior do que o valorSTARBA.

{STARBA|STARTRBA|LOGRBA}

Especifica o RBA que indica o início do intervalo de registros de log a serem impressos. Informe essevalor de RBA em formato hexadecimal, iniciando com a letra “X” e, em seguida, adicionando exatamente12 dígitos hexadecimais entre aspas simples, por exemplo, X'000000422108'. Se você não sabe qual éesse valor RBA, pode obtê-lo consultando as mensagens geradas quando os registros de log foramcriados ou executando o comando DISPLAY OBJECT=LOG do Agente de Log do PowerExchange.

Se você também não informou um valor ENDRBA, são impressos os 50 registros de log da posiçãoENDRBA.

Se você informou os valores STARBA e ENDRBA, o valor STARBA deve ser menor do que o valorENDRBA.

ExemploOs seguintes comandos imprimem os registros de log do Agente de Log do PowerExchange especificadosentre o RBA inicial e RBA final:

F PWXLOGR1,PRINT STARBA=x'000000422108',ENDRBA=x'0000004552FF'}

TÓPICOS RELACIONADOS:¨ “Comando DISPLAY OBJECT=LOG” na página 71

Comando RESOLVE_INDOUBTForça o Agente de Log do PowerExchange a confirmar os UOWs abertos como alterações válidas oudescartá-los.

Por exemplo, pressuponha que um ECCR foi finalizado de modo anormal e deixou um UOW suspeito.Normalmente, quando você realiza uma inicialização a quente do ECCR, qualquer UOW suspeito é resolvido.Entretanto, você não pode reinicializar o ECCR ou, ao efetuar uma inicialização a quente, a resolução normaldo status de suspeito não ocorre. Nesse caso, você pode resolver um UOW suspeito emitindo o comandoRESOLVE_INDOUBT.


MODIFY proc_name,RESOLVE_INDOUBT ECCR=eccr_id,UOW=X’uow_id’,ACTION={COMMIT|ABORT}


F proc_name,RI E=eccr_id,U=X’uow_id’,A={C|A}


Descrições de ParâmetrosOs seguintes parâmetros são necessários:

ECCR=eccr_id

Especifica o identificador do ECCR que capturou os UOWs suspeitos que você deseja confirmar oudescartar. Se você não sabe qual é o identificador do ECCR, emita o comando DISPLAYOBJECT=CONNECTION TYPE=UOW para exibir a saída que inclui esse identificador de ECCR.

Comando RESOLVE_INDOUBT 73

UOW=X’uow_id’

Selecione um UOW suspeito nos registros de log que você deseja confirmar ou descartar. Informe oidentificador do UOW atribuído ao ECCR em formato hexadecimal, iniciando com a letra “X” e, emseguida, adicionando o identificador de 20 caracteres entre aspas simples. Se você não conhece esseidentificador, emita o comando DISPLAY OBJECT=CONNECTION TYPE=UOW e procure o identificador“UOW” na saída.

ACTION={COMMIT|ABORT}

Indica se haverá confirmação ou descarte dos registros de log que contêm os UOWs suspeitos. Informeuma das seguintes opções:

¨ COMMIT. Confirma as alterações.

¨ ABORT. Descarta as alterações.

ExemploO comando DISPLAY OBJECT=CONNECTION,TYPE=UOW produziu o seguinte relatório, indicando que háum UOW suspeito para o PWXLOGR1 do Agente de Log do PowerExchange:

PWXEDM172679I EDM Logger UOW CONNECTION report follows: *ECCR UOW Type Logger UOWid Status * CC9PWX01 0000AD94CD5C00000000 UOW PWXL00000B1CF9230000 in-doubt

Para confirmar esse UOW suspeito, você emite o seguinte comando RESOLVE_INDOUBT com oidentificador do ECCR e os valores de UOW atribuídos ao ECCR do relatório:

F PWXLOGR1,RESOLVE_INDOUBT E=CC9PWX01,U=X'0000AD94CD5C00000000',A=C

TÓPICOS RELACIONADOS:¨ “Comando DISPLAY OBJECT=CONNECTION” na página 70

Comando STOPInterrompe um Agente de Log do PowerExchange ativo. Use o comando STOP do PowerExchange emitidocom o MODIFY (F) do MVS ou use o comando STOP (P) padrão do MVS.

Antes de você emitir um comando STOP, verifique se todas as conexões do leitor de log e do ECCR para oAgente de Log do PowerExchange foram terminadas. O Agente de Log do PowerExchange não pode serinicializado até que todas as conexões vinculadas ao leitor e ao gravador sejam concluídas ou canceladas.Se você emitir o comando STOP quando as conexões do leitor e do gravador ainda estiverem ativas, oAgente de Log do PowerExchange espera que elas sejam terminadas antes de ser interrompido.

SintaxePara emitir o comando CLOSE do PowerExchange, use a seguinte sintaxe:

F proc_name,STOP

Para emitir o comando STOP (P) do MVS, use a seguinte sintaxe:

P proc_name



¨ Se você emitir o comando STOP quando o Agente de Log do PowerExchange ainda tiver conexões ativasdo leitor de log ou do ECCR, o Agente de Log do PowerExchange espera que elas sejam terminadasantes de ser interrompido. Além disso, o PowerExchange emite a seguinte mensagem para cada tarefaincomum do leitor de log ou do ECCR:

PWXEDM172596E EDM Logger waiting for [reader|ECCR] Task (job_name)


¨ Após a conclusão do comando STOP do PowerExchange, o Agente de Log do PowerExchange não aceitacomandos adicionais.

¨ Em vez do comando STOP do PowerExchange, você pode usar o comando STOP (P) do MVS. Antes deexecutar o comando STOP do MVS, verifique se não há tarefas incomuns do leitor de log ou do ECCRvinculadas ao Agente de Log do PowerExchange.

¨ Se você não puder terminar todas as tarefas incomuns do leitor de log e do ECCR, pode usar o comandoCANCEL do MVS para terminar o Agente de Log do PowerExchange.

Comandos de Mesclagem Pós-LogEm um ambiente de Mesclagem Pós-Log, o PowerExchange utiliza o Log Read API para ler os dadosalterados dos logs ativos e de arquivo de cada Agente de Log do PowerExchange em cada imagem do MVSno sysplex. Em seguida, o PowerExchange mescla os dados de alteração, em ordem cronológica, em umúnico fluxo de dados para o processamento de extração. Você pode utilizar os comandos de Mesclagem Pós-Log para gerenciar o processamento de mesclagem das seguintes maneiras:

¨ Exibir o status dos processos de leitura de log.

¨ Interromper a tarefa de Mesclagem Pós-Log inicializada.

¨ Produzir informações de rastreamento.

Para emitir os comandos de Mesclagem Pós-Log, use o comando MODIFY (F) padrão do MVS. Você deveincluir o nome do trabalho ou da tarefa inicializada da Mesclagem Pós-Log, seguido por uma vírgula (,). Nasintaxe de comando, esse nome é indicado pela variável task_name.

Comandos DISPLAY e STATUSExibe informações sobre os processos de leitura de log conectados com a tarefa inicializada de MesclagemPós-Log através do Log Read API. Essas informações incluem o Agente de Log do PowerExchange para oqual as alterações estão sendo mescladas e a localização de leitura atual em cada conjunto de dados de log.

Nota: Os comandos DISPLAY e STATUS têm função equivalente.


F task_name,{DISPLAY|DIS}

ou

F task_name,{STATUS|STAT}

A variável task_name é o nome do trabalho em lotes ou da tarefa inicializada de Mesclagem Pós-Log.

Comandos QUIT e STOPInterrompe a tarefa de Mesclagem Pós-Log inicializada. Se a tarefa de Mesclagem Pós-Log tiver processosde leitura de log ativos em execução, eles são finalizados de modo anormal.

Nota: Os comandos QUIT e STOP têm função equivalente.


F task_name,{QUIT|STOP}


Comandos de Mesclagem Pós-Log 75

Comandos TRACEE, TRACEL e TRACESControla a produção das informações de rastreamento para a tarefa inicializada da Mesclagem Pós-Log. Asinformações de rastreamento são utilizadas principalmente para diagnóstico de problemas. Use essecomando somente se instruído pelo Suporte Global a Clientes da Informatica.

Os comandos de rastreamento a seguir estão disponíveis:

¨ TRACEE. Desabilita o rastreamento da tarefa inicializada de Mesclagem Pós-Log.

¨ TRACEL. Ativa o rastreamento de forma longa, que produz todas as informações de rastreamento.

¨ TRACES. Ativa o rastreamento de forma curta que produz, no máximo, 32 bytes de informações para cadarastreamento.


F task_name,{TRACEE|TRACEL|TRACES}




Comandos do Agente de Log doPowerExchange para Linux, UNIXe Windows


¨ Introdução aos Comandos do Agente de Log do PowerExchange para Linux, UNIX e Windows, 77

¨ Inicializando o Agente de Log do PowerExchange para Linux, UNIX e Windows, 78

¨ Comando CONDENSE, 81

¨ Comando DISPLAY ALL, 82

¨ Comando DISPLAY CHECKPOINTS, 83

¨ Comando DISPLAY CPU, 83

¨ Comando DISPLAY EVENTS, 84

¨ Comando DISPLAY MEMORY, 84

¨ Comando DISPLAY RECORDS, 85

¨ Comando DISPLAY STATUS, 86

¨ Comando FILESWITCH, 87

¨ Comando SHUTCOND, 88


Introdução aos Comandos do Agente de Log doPowerExchange para Linux, UNIX e Windows

Use os comandos do Agente de Log do PowerExchange para Linux, UNIX e Windows para controlar ouinterromper um processo ou exibir informações sobre o processamento do Agente de Log do PowerExchange.

Com esses comandos, você pode realizar as seguintes tarefas:

¨ Exibir as seguintes informações:

- Informações de status para as subtarefas Manipulador de Comandos e Gravador do Agente de Log doPowerExchange

- Número de sequência e carimbo de data/hora do arquivo de ponto de verificação mais recente

- Contagens dos registros de alteração processados

- Uso de memória e CPU do Agente de Log do PowerExchange

¨ Interromper um processo do Agente de Log do PowerExchange.

¨ Alternar de modo manual por um novo conjunto de arquivos de log.

77

¨ Fazer com que a subtarefa Gravador continue a leitura dos dados de origem durante um intervalo deespera.

Você deve emitir os comandos para um processo ativo do Agente de Log do PowerExchange que está sendoexecutado no Linux, UNIX ou Windows.

Esses tópicos abordam a emissão de comandos para um processo do Agente de Log do PowerExchange queestá sendo executado em modo de primeiro plano. Eles descrevem a finalidade, sintaxe e uso de cadacomando e incluem exemplos de saída, quando apropriado.

Como alternativa, use o programa pwxcmd para enviar comandos a um processo do Agente de Log doPowerExchange que está sendo executado em modo de primeiro ou segundo plano no mesmo sistema ou emum sistema diferente. Você deve usar o programa pwxcmd para emitir os comandos, se executar o processodo Agente de Log do PowerExchange em modo de segundo plano. Você pode emitir o comando pwxcmd dalinha de comando, um arquivo de lote ou um roteiro.


Inicializando o Agente de Log do PowerExchangepara Linux, UNIX e Windows

Para Inicializar o Agente de Log do PowerExchange para Linux, UNIX ou Windows, execute o programapwxccl. Esse programa está no diretório de instalação do PowerExchange.

Antes de você inicializar o pwxccl, conclua as etapas de configuração do Agente de Log do PowerExchangedescritas no Guia do CDC do PowerExchange para Linux, UNIX e Windows.

Nota: Você não pode usar o programa pwxcmd para inicializar o pwxccl.

SintaxeA sintaxe para a execução do pwxccl varia conforme o sistema operacional.

Em um sistema Linux ou UNIX, use uma das seguintes alternativas de sintaxe para inicializar o Agente deLog do PowerExchange da linha de comando:

¨ Para executar o Agente de Log do PowerExchange em modo de primeiro plano, use a seguinte sintaxe:pwxccl [coldstart=Y|N] [config=directory/myconfig_file] [cs=directory/mycondense_config_file] [license=directory/mylicense_key_file]

¨ Para executar o Agente de Log do PowerExchange em modo de segundo plano, adicione um E comercial(&) no final da instrução, conforme mostrado na seguinte sintaxe:

pwxccl [coldstart=Y|N] [config=directory/myconfig_file] [cs=directory/mycondense_config_file] [license=directory/mylicense_key_file] &

¨ Para executar o Agente de Log do PowerExchange em modo contínuo e de segundo plano, mesmo sehouver desconexão da sessão ou do usuário, adicione o prefixo nohup, conforme mostrado na seguintesintaxe:

nohup pwxccl [coldstart=Y|N] [config=directory/myconfig_file] [cs=directory/mycondense_config_file] [license=directory/mylicense_key_file] &

Em um sistema Windows, use a seguinte sintaxe para inicializar o Agente de Log do PowerExchange, emmodo de primeiro plano, da linha de comando:

pwxccl [coldstart=Y|N] [config=directory\myconfig_file] [cs=directory\mycondense_config_file] [license=directory\mylicense_key_file]

Para inicializar o Agente de Log do PowerExchange como uma tarefa em segundo plano em um sistemaWindows, você tem várias opções. Você pode criar um arquivo .bat que execute o pwxccl e, em seguida,executar o arquivo .bat em uma janela minimizada ou de um arquivo de script. Para obter mais informaçõessobre a execução de programas em uma janela minimizada, consulte a documentação do Microsoft Windows.

78 Capítulo 15: Comandos do Agente de Log do PowerExchange para Linux, UNIX e Windows

Descrições de ParâmetrosNa instrução pwxccl, você pode especificar um ou mais dos seguintes parâmetros opcionais:

COLDSTART

Indica se a inicialização do Agente de Log do PowerExchange será a quente ou a frio. Informe um dosseguintes valores:Y

Inicialize a frio o Agente de Log do PowerExchange. Você deve especificar COLDSTART=Y pararealizar uma inicialização a frio. A ausência de arquivos de ponto de verificação não ativa umainicialização a frio. Se você especificar Y e houver arquivos de ponto de verificação, o Agente deLog do PowerExchange os ignora. Se o arquivo do CDCT contiver registros, o Agente de Log doPowerExchange os exclui.

N

Inicializar a quente o Agente de Log do PowerExchange do ponto de reinicialização indicado noúltimo arquivo de ponto de verificação. Se não houver arquivo de ponto de verificação no diretórioCHKPT_BASENAME, o Agente de Log do PowerExchange é finalizado com uma mensagem de erroPWX-33227. O padrão é N.

CONFIG

Especifica o nome do arquivo e o caminho completo para um arquivo de configuração DBMOVER quesubstitui o arquivo dbmover.cfg padrão no diretório de instalação. Os arquivos de substituição devem tero caminho ou o nome de arquivo diferente dos arquivos padrão. O arquivo de substituição temprecedência sobre qualquer arquivo de configuração de substituição que você pode especificar com avariável de ambiente PWX_CONFIG.

CS

Especifica o nome do arquivo e o caminho completo do arquivo de configuração do Agente de Log doPowerExchange. Use esse parâmetro para especificar um arquivo de configuração do Agente de Log doPowerExchange que substitui o arquivo pwxccl.cfg padrão no diretório de instalação. Os arquivos desubstituição devem ter o caminho ou o nome de arquivo diferente dos arquivos padrão.

LICENSE

Especifica o nome do arquivo e o caminho completo para um arquivo de chave de licença que substitui oarquivo license.key padrão no diretório de instalação. Os arquivos de substituição devem ter o caminhoou o nome de arquivo diferente dos arquivos padrão. O arquivo de substituição tem precedência sobrequalquer arquivo de chave de licença de substituição que você especifica com a variável de ambientePWX_LICENSE.

Nota: Nos parâmetros CONFIG, CS e LICENSE, o caminho completo é necessário somente se o arquivo nãoestiver em uma localização padrão.

Notas de UsoDurante a inicialização, o Agente de Log do PowerExchange realiza o processamento:

1. Lê o arquivo de configuração pwxccl.cfg e exibe as definições do parâmetro em uma série de mensagensPWX-15799.

Nota: Se o Agente de Log do PowerExchange não localizar o pwxccl.cfg, ele procura pelo dtlca.cfg.

2. Exibe o nome da instrução CAPI_CONNECTION selecionada na mensagem PWX-21605.

3. Carrega os registros de captura de um arquivo CCT que corresponda ao banco de dados especificado noparâmetro DBID do arquivo pwxccl.cfg e que especifique Parte da opção Condensador. Quaisquerregistros não aplicáveis são ignorados.

4. Se você usar um arquivo de definição de grupo, o Arquivo de Log do PowerExchange exibe asdeclarações no arquivo.Um arquivo de definição de grupo define os grupos de registros de captura e tabelas para os quais oAgente de Log do PowerExchange cria conjuntos separados de arquivos de log.

Inicializando o Agente de Log do PowerExchange para Linux, UNIX e Windows 79

5. A tarefa Controlador inicia a subtarefa Manipulador de Comandos e, em seguida, a subtarefa Gravador.O Agente de Log do PowerExchange emite uma série de mensagens de inicialização do Manipulador deComandos e Gravador. Se você especificou COLDSTART=Y na instrução de inicialização e PROMPT=Yno arquivo de configuração dbmover.cfg, o Agente de Log do PowerExchange solicita que você confirmeuma inicialização a frio ao informar Y.

Quando a inicialização do Gravador estiver concluída, a seguinte mensagem é exibida:PWX-06111 Controller: All tasks initialization complete.PWX-06455 Command Handler: received CAPTURE_STARTUP_COMPLETE event.

6. O Gravador exclui quaisquer registros de CDCT expirados e os arquivos de log do PowerExchangeassociados a eles e, em seguida, faz um ponto de verificação.Se você informou VERBOSE=Y no arquivo pwxccl.cfg file, o Agente de Log do PowerExchange emitemensagens detalhadas sobre esse processamento, tais como os arquivos de log e registros de CDCTque foram excluídos, tokens de reinicialização e sequência, que foram registrados no ponto deverificação, e uso de CPU.

7. O Gravador inicia o processamento dos dados de origem.

Após a conclusão da inicialização, você pode emitir os comandos do Agente de Log do PowerExchange, paradeterminar o status do processamento do Agente de Log do PowerExchange, iniciar manualmente umaalternância de arquivo ou leitura do Gravador de dados de origem ou desligar o Agente de Log doPowerExchange.

Exemplo de SaídaDurante o processamento de inicialização a frio, o PowerExchange grava as seguintes mensagens para a telada linha de comando e o arquivo de log de mensagem do PowerExchange:

C:\Informatica\PowerExchange9.0.0>pwxccl coldstart=yPWX-33314 TIMEOUTS configuration parameter is deprecatedPWX-00607 PWXCCL VRM 9.0.0 Build V900_B10 started.PWX-06036 Controller: Started 09/11/06 15:38:41.PWX-33250 pwxccl started as a foreground process. pid="4500". coldstart="Y"

PWX-15799 ##PWXCCL <C:\Informatica\PowerExchange9.0.0\pwxccl.cfg> PARM INPUT FILE: START>>> .PWX-15799 DBID=NORT000.PWX-15799 DB_TYPE=MSS.PWX-15799 EXT_CAPT_MASK=C:\Informatica\PowerExchange9.0.0\capture\condenseO.PWX-15799 CHKPT_NUM=3.PWX-15799 CHKPT_BASENAME=C:\Informatica\PowerExchange9.0.0\capture\condenseO.chkpt.PWX-15799 COND_CDCT_RET_P=50.PWX-15799 CONDENSENAME=msssvc.PWX-15799 COLL_END_LOG=0.PWX-15799 NO_DATA_WAIT=5.PWX-15799 NO_DATA_WAIT2=60.PWX-15799 FILE_SWITCH_VAL=20.PWX-15799 FILE_SWITCH_CRIT=M.PWX-15799 CAPT_IMAGE=BA.PWX-15799 SIGNALLING=N.PWX-15799 VERBOSE=Y.PWX-15799 ##PWXCCL <C:\Informatica\PowerExchange9.0.0\pwxccl.cfg> PARM INPUT FILE: END(COMPLETE).

PWX-21605 Connection selected vpmsql found from covr< > tag< > type< MSS> int< FALSE> method< SRC_DFLT for TYPE>.

PWX-25802 Process pwxccl pid 4500 locked file C:\Informatica\PowerExchange9.0.0\CDCT_instance_NORT000_lockfile.lckPWX-25802 Process pwxccl pid 4500 locked file C:\Informatica\PowerExchange9.0.0\capture\condenseO.chkpt_checkpoint_lockfile.lckPWX-25802 Process pwxccl pid 4500 locked file C:\Informatica\PowerExchange9.0.0\capture\condenseO_loggerfiles_lockfile.lck

PWX-33261 Loaded "customer.1". Table "dbo.Customers". Tag "MSSNORT000customer1"PWX-33261 Loaded "employee.1". Table "dbo.Employees". Tag "MSSNORT000employee1"PWX-33262 Discarded "orderdet". Creator "dbo". Condense option "None"PWX-33261 Loaded "orders.1". Table "dbo.Orders". Tag "MSSNORT000orders1"PWX-33261 Loaded "products.2". Table "dbo.Products". Tag "MSSNORT000products1"PWX-33262 Discarded "region". Creator "dbo". Condense option "None"PWX-33263 4 registrations loaded

PWX-06112 Controller: Starting the capture subtasks.

PWX-06076 Starting Subtask program PWXCCLH.PWX-06450 Command Handler: Starting.PWX-32503 Command Handler initialization complete, listening on port 6988 .


PWX-26002 Command handler is waiting for the writer to initialize before accepting commandsPWX-06076 Starting Subtask program PWXCCLW.PWX-06400 Condense: Starting. Instance=NORT000.PWX-33232 No tokens specified. Cold start at the current data stream file positionPWX-33236 Type Y to confirm the cold start position or N to terminate the CCL loggerPWX-33238 Cold start accepted

PWX-09964 CAPI i/f: Current PowerExchange Logger log files position: Sequence=07D9000B0006000F0022003B111B45C00000000100000035000000630004FFFFFFFF Restart=07000000434158313730313031PWX-09950 CAPI i/f: Connect OK. Sources = 4PWX-25229 Started initialization of the CDCT Retention ArrayPWX-25230 Retention array initialized. Files 1. CDCTs read 2. Allocated 300000. Memory 1500236PWX-25211 Rolling back 2 CDCT recordsPWX-06455 Command Handler: received CAPTURE_STARTUP_COMPLETE event.PWX-06111 Controller: All tasks initialization complete.PWX-26003 Command handler is accepting commandsPWX-25204 Deleted expired file "C:\Informatica\PowerExchange9.0.0\capture\condenseO.CND.CP091106.T1532001"PWX-25221 Deleted 2 expired CDCT records and 1 filesPWX-06420 Condense: Checkpoint done. Sequence=07D9000B0006000F0022003B111B45C00000000100000035000000630004FFFFFFFF PowerExchange Logger=07000000434158313730313031PWX-06136 Checkpoint taken to file=0 time=09/11/06 15:38:44PWX-33279 CPU total 390625. This file total 390625. CAPI Reads 0. Writing file 0. Other 390625

PWX-33274 CPU Total 406250. CAPI Read 0. Writing 0. File switching 0. Other 406250PWX-33271 Writer starts reading source data. First processing cycle since initializationPWX-09957 CAPI i/f: Read times out after 60 secondsPWX-09967 CAPI i/f: End of log for time 09/11/06 15:38:44 reached

Nota: As mensagens de inicialização a quente são similares às mensagens de inicialização a frio com asseguintes exceções:

¨ Você não precisa responder a um prompt de confirmação para continuar com o processamento deinicialização.

¨ A mensagem PWX-06413 relata o token de sequência e inicialização mais alto encontrado noprocessamento de reinicialização.

Comando CONDENSEQuando o Agente de Log do PowerExchange para Linux, UNIX e Windows estiver sendo executado em modocontínuo, o comando CONDENSE inicializa um outro ciclo de log, antes do término do período de esperapara inicialização de outro ciclo.

O período de espera é especificado no parâmetro NO_DATA_WAIT do arquivo de configuração pwxccl.cfg.

A mensagem de saída desse comando é exibida na tela e gravada no log de mensagem do PowerExchange.

SintaxeUse a seguinte sintaxe para emitir o comando da linha de comandos em um processo do Agente de Log doPowerExchange que está sendo executado em modo de primeiro plano:

CONDENSE

Nota: Como alternativa, use o programa pwxcmd para emitir o comando de condensação. Você deve usar opwxcmd se executar o Agente de Log do PowerExchange em modo de segundo plano.

Exemplo de SaídaO seguinte exemplo de saída do CONDENSE indica que a subtarefa Gravador está lendo ou esperando pelosdados de origem e informa a hora da próxima alternância de arquivo:

PWX-26011 Command handler received command "CONDENSE"PWX-06468 Command Handler: Condense request issued.

PWX-06415 Condense: Condense completed. Total Records=4, Data=2, UOWs =2PWX-33270 Writer is sleeping for 300 seconds. Start time 09/10/30 15:15:20

Comando CONDENSE 81

TÓPICOS RELACIONADOS:¨ “Comando DISPLAY STATUS” na página 86

¨ “Comando pwxcmd condense” na página 106

Comando DISPLAY ALLExibe todas as mensagens que podem ser produzidas por outros comandos DISPLAY do Agente de Log doPowerExchange para Linux, UNIX e Windows, organizadas por comando.

A saída é a mesma se você executou os seguintes comandos separadamente:

¨ DISPLAY CHECKPOINTS

¨ DISPLAY CPU

¨ DISPLAY EVENTS

¨ DISPLAY MEMORY

¨ DISPLAY RECORDS

¨ DISPLAY STATUS



DISPLAY ALL

Nota: Como alternativa, use o programa pwxcmd para emitir o comando displayall. Você deve usar o pwxcmdse executar o Agente de Log do PowerExchange em modo de segundo plano.

Exemplo de SaídaO seguinte exemplo de saída DISPLAY ALL mostra informações sobre o processamento do Agente de Log doPowerExchange, tempo de CPU e uso de memória, organizadas por comando:

PWX-26011 Command handler received command "DISPLAY ALL"

PWX-26010 Command "DISPLAY CHECKPOINTS" informationPWX-26041 Latest checkpoint sequence number 1. Written at "09/10/07 16:16:08"PWX-26042 Latest checkpoint data records 4. Commit records 2. Commit time "20091007160501537000"

PWX-26010 Command "DISPLAY CPU" informationPWX-26051 CPU uSecs reading source data 78125PWX-26052 CPU uSecs writing data to files 31250PWX-26053 CPU uSecs during file switches 15625PWX-26054 CPU uSecs for other processing 796875PWX-26055 CPU uSecs TOTAL 921875

PWX-26010 Command "DISPLAY EVENTS" informationPWX-26021 Controller waits on events ALL_TASK_SHUTDOWN, CMDH_ENDED, CONDENSE_ENDED,PWX-26022 Command Handler waits on events ALL_TASK_SHUTDOWN, GOT_A_COMMAND,PWX-26023 Writer waits on events ALL_TASK_SHUTDOWN, START_CONDENSING,PWX-26024 Writer is sleeping, waiting for an event or timeout

PWX-26010 Command "DISPLAY MEMORY" informationPWX-26031 Controller memory. Application 1136258. Total 1145597. Maximum 1360714

PWX-26032 Command Handler memory. Application 636244. Total 636871. Maximum 671371PWX-26033 Writer memory. Application 2326803. Total 2343567. Maximum 2410614PWX-26034 Total memory. Application 4099305. Total 4126035. Maximum 4442699

PWX-26010 Command "DISPLAY RECORDS" informationPWX-26068 Update records. File 2. Total 4PWX-26069 Commit records. File 2. Total 4PWX-26070 Total records. File 4. Total 8

PWX-26010 Command "DISPLAY STATUS" informationPWX-26086 Writer is sleeping. Time "2009-10-07 16:25:07"PWX-26101 Current file was opened at time "2009-10-07 16:16:08". Records 6


PWX-26103 Time of next file switch "2009-10-07 16:38:07"PWX-26111 CDCT Retention Array contains 1 records. First expiry time "2009-11-26 15:16:08"

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd displayall” na página 107

Comando DISPLAY CHECKPOINTSExibe a mensagem PWX-26041, que relata as informações sobre o arquivo de ponto de verificação maisrecente. As informações incluem o número de sequência do arquivo, carimbo de data/hora, número deregistros de dados e registros de confirmação, bem como o tempo de confirmação.



DISPLAY CHECKPOINTS

Nota: Como alternativa, use o programa pwxcmd para emitir o comando displaycheckpoints. Você deve usaro pwxcmd se executar o Agente de Log do PowerExchange em modo de segundo plano.

Exemplo de SaídaO seguinte exemplo de saída do DISPLAY CHECKPOINTS mostra informações sobre o arquivo de ponto deverificação mais recente:

PWX-26011 Command handler received command "DISPLAY CHECKPOINTS"PWX-26010 Command "DISPLAY CHECKPOINTS" informationPWX-26041 Latest checkpoint sequence number 1. Written at "09/10/07 16:16:08"PWX-26042 Latest checkpoint data records 4. Commit records 2. Commit time "20091007160501537000"

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd displaycheckpoints” na página 108

Comando DISPLAY CPUExibe o tempo de CPU decorrido, em microssegundos, para o processamento do Agente de Log doPowerExchange durante o ciclo de log atual, por fase de processamento. Também inclui o tempo de CPUtotal para todo o processamento do Agente de Log do PowerExchange.

Por exemplo, o tempo de CPU pode ser relatado para as seguintes fases do processo:

¨ Leitura de dados de origem

¨ Gravação de dados para os arquivos de log do Agente de Log do PowerExchange

¨ Execução de alternâncias de arquivo

¨ Realização de "outros processamentos", como inicialização e processamento de comandos peloManipulador de Comandos



DISPLAY CPU

Comando DISPLAY CHECKPOINTS 83

Nota: Como alternativa, use o programa pwxcmd para emitir o comando displaycpu. Você deve usar opwxcmd se executar o Agente de Log do PowerExchange em modo de segundo plano.

Exemplo de SaídaO seguinte exemplo de saída de DISPLAY CPU mostra informações sobre o tempo de CPU decorrido paravárias fases de processamento, incluindo as alternâncias de arquivo:

PWX-26011 Command handler received command "DISPLAY CPU"PWX-26010 Command "DISPLAY CPU" informationPWX-26051 CPU uSecs reading source data 78125PWX-26052 CPU uSecs writing data to files 31250PWX-26053 CPU uSecs during file switches 15625PWX-26054 CPU uSecs for other processing 640625PWX-26055 CPU uSecs TOTAL 765625

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd displaycpu” na página 108

Comando DISPLAY EVENTSExibe eventos esperados pelas tarefas Controlador, Manipulador de Comandos e Gravador do Agente de Logdo PowerExchange. Também indica se o Gravador está processando os dados ou se está inativo esperandopor um evento ou tempo limite.



DISPLAY EVENTS

Nota: Como alternativa, use o programa pwxcmd para emitir o comando displayevents Você deve usar opwxcmd se executar o Agente de Log do PowerExchange em modo de segundo plano.

Exemplo de SaídaO seguinte exemplo de saída de DISPLAY EVENTS mostra os eventos esperados pelo Controlador,Manipulador de Comandos e Gravador e o status atual do Gravador:

PWX-26011 Command handler received command "DISPLAY EVENTS"PWX-26010 Command "DISPLAY EVENTS" informationPWX-26021 Controller waits on events ALL_TASK_SHUTDOWN, CMDH_ENDED, CONDENSE_ENDED,PWX-26022 Command Handler waits on events ALL_TASK_SHUTDOWN, GOT_A_COMMAND,PWX-26023 Writer waits on events ALL_TASK_SHUTDOWN, START_CONDENSING,PWX-26025 Writer is processing, reading source data

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd displayevents” na página 109

Comando DISPLAY MEMORYExibe o uso de memória, em bytes, para cada tarefa e subtarefa do Agente de Log do PowerExchange paraLinux, UNIX e Windows com os totais para todo o processo do Agente de Log do PowerExchange.

O uso de memória é relatado para as seguintes categorias:

¨ Aplicativo. Memória solicitada pelo aplicativo do Agente de Log do PowerExchange para uso próprio.


¨ Total. Memória total em uso pelo aplicativo do Agente de Log do PowerExchange e pelo limite máximo docabeçalho relacionado. Esse valor varia conforme a memória é alocada dinamicamente e liberada duranteo processamento do Agente de Log do PowerExchange.

¨ Máximo. A maior quantidade de memória registrada para a categoria “Total” até o ponto no tempo queesse comando é executado.



DISPLAY MEMORY

Nota: Como alternativa, use o programa pwxcmd para emitir o comando displaymemory. Você deve usar opwxcmd se executar o Agente de Log do PowerExchange em modo de segundo plano.

Exemplo de SaídaO seguinte exemplo de saída de DISPLAY MEMORY mostra o uso total da memória e o uso da memória pelatarefa do Agente de Log do PowerExchange:

PWX-26011 Command handler received command "DISPLAY MEMORY"PWX-26010 Command "DISPLAY MEMORY" informationPWX-26031 Controller memory. Application 1531327. Total 1545145. Maximum 1794550

PWX-26032 Command Handler memory. Application 645278. Total 646552. Maximum 646552PWX-26033 Writer memory. Application 3495909. Total 3514235. Maximum 3613892PWX-26034 Total memory. Application 5672514. Total 5705932. Maximum 6054994

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd displaymemory” na página 109

Comando DISPLAY RECORDSExibe as contagens de registros de alteração que o Agente de Log do PowerExchange para Linux, UNIX eWindows processou durante o ciclo de processamento atual. Se o Agente de Log do PowerExchange nãorecebeu alterações durante o ciclo atual, exibe as contagens de registro de alteração para os arquivos de logatuais do Agente de Log do PowerExchange.

As contagens de registro são mostradas para cada tipo de registro de alteração processado e para o total deregistros processados. Os tipos de registro de alteração incluem Excluir, Inserir, Atualizar e Confirmar.

A saída inclui todos ou alguns tipos das seguintes contagens, dependendo se elas são para o ciclo atual oupara os registros de log atuais:

¨ Ciclo. As contagens dos registros de alteração para o ciclo de processamento do Agente de Log doPowerExchange atual. O Agente de Log do PowerExchange redefine essas contagens para zero, quandoo intervalo de espera especificado no parâmetro NO_DATA_WAIT2 do arquivo pwxccl.cfg expirar enenhum dado de alteração tiver sido recebido.

¨ Arquivo. As contagens dos registros de alteração para o conjunto atual dos arquivos de log doPowerExchange. O Agente de Log do PowerExchange redefine essas contagens para zero quando ocorreuma alternância de arquivos.

¨ Total. Número total de registros de alteração recebido pelo Agente de Log do PowerExchange desde queele inicializou. Essas contagens não são redefinidas para zero.


Comando DISPLAY RECORDS 85


DISPLAY RECORDS

Nota: Como alternativa, use o programa pwxcmd para emitir o comando displayrecords Você deve usar opwxcmd se executar o Agente de Log do PowerExchange em modo de segundo plano.

Exemplo de SaídaO seguinte exemplo de saída do DISPLAY RECORDS mostra as contagens dos registros Atualizar, Confirmare Total que o Agente de Log do PowerExchange processou no arquivo de log atual:

PWX-26011 Command handler received command "DISPLAY RECORDS"PWX-26010 Command "DISPLAY RECORDS" informationPWX-26068 Update records. File 2. Total 2PWX-26069 Commit records. File 2. Total 2PWX-26070 Total records. File 4. Total 4

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd displayrecords” na página 110

Comando DISPLAY STATUSExibe o status da subtarefa Gravador do Agente de Log do PowerExchange.

Por exemplo, o comando pode relatar quando o Gravador estiver realizando o seguinte processamento:

¨ Inicializando

¨ Lendo ou esperando os dados de origem

¨ Gravando os dados de origem para um arquivo de log do Agente de Log do PowerExchange

¨ Inicializando um ponto de verificação

¨ Gravando informações para um arquivo de ponto de verificação

¨ Gravando registros do CDCT durante uma alternância de arquivo

¨ Concluindo a exclusão dos registros do CDCT expirados

¨ Desligamento



DISPLAY STATUS

Nota: Como alternativa, use o programa pwxcmd para emitir o comando displaystatus Você deve usar opwxcmd se executar o Agente de Log do PowerExchange em modo de segundo plano.

Exemplo de SaídaO seguinte exemplo de saída do DISPLAY STATUS indica que a subtarefa Gravador está lendo ouesperando pelos dados de origem e momento para a próxima alternância de arquivo:

PWX-26011 Command handler received command "DISPLAY STATUS"PWX-26010 Command "DISPLAY STATUS" informationPWX-26087 Writer is reading or waiting for source data. Time "2009-11-06 14:05:01"PWX-26101 Current file was opened at time "2009-11-06 13:52:57". Records 3PWX-26103 Time of next file switch "2009-11-06 14:12:59"PWX-26111 CDCT Retention Array contains 2 records. First expiry time "2009-12-26 13:42:19"


TÓPICOS RELACIONADOS:¨ “Comando pwxcmd displaystatus ” na página 111

Comando FILESWITCHFecha os arquivos abertos de log do Agente de Log do PowerExchange para Linux, UNIX e Windows, casocontenham dados e, em seguida, alterna para um novo conjunto de arquivos de log. Se os arquivos de lognão contiverem dados, a alternância de arquivos não ocorre.



FILESWITCH

Nota: Como alternativa, use o programa pwxcmd para emitir o comando fileswitch. Você deve usar opwxcmd se executar o Agente de Log do PowerExchange em modo de segundo plano.

Notas de UsoVocê pode realizar uma alternância de arquivos automática antes da próxima alternância de arquivo a fim dedisponibilizar os dados alterados para o processo de extração. Se você executar extrações em modo de lote,inclua um comando fileswitch no script e, em seguida, execute esse script, antes das extrações em lote. Paraemitir o comando fileswitch de um arquivo em lote ou script, você deve usar o programa pwxcmd.

Por exemplo, para extrair os dados alterados a cada hora dos arquivos de log do Agente de Log doPowerExchange, primeiro defina os parâmetros FILE_SWITCH_CRIT e FILE_SWITCH_VAL no arquivopwxccl.cfg, de tal modo que a alternância de arquivos não ocorra automaticamente antes da execução dasextrações. Você pode definir os parâmetros para realizar uma alternância de arquivo automática a cada 1.000.000 de atualizações de registro. Em seguida, inclua o comando pwxcmd fileswitch em um script que sejaexecutado pouco antes dos processos de extração programados.

Nota: Normalmente, você não necessita realizar as alternâncias de arquivo manualmente, se utilizar o modode extração contínuo.

Exemplo de SaídaO seguinte exemplo de saída de FILESWITCH foi gerado quando VERBOSE=Y no arquivo pwxccl.cfg:

PWX-06422 Condense: Received FILESWITCH request.

PWX-26011 Command handler received command "FILESWITCH"PWX-06461 Command Handler: New File Switch requested. CONDENSE request generated.

PWX-33283 File switch because of a FILESWITCH command. Records 9. Elapsed seconds 846PWX-06418 Condense: Closed file C:\Informatica\PowerExchange9.0.0\capture\condenseO.CND.CP091106.T1418004PWX-06420 Condense: Checkpoint done. Sequence=07D9000B0006000E00170028058B11400000000100000034000001070004FFFFFFFF PowerExchange Logger=07000000434158313730313031PWX-06136 Checkpoint taken to file=2 time=09/11/06 14:27:06PWX-33278 Total Records 6. Inserts 0. Updates 3. Deletes 0. UOWs 3. Bytes 1760PWX-33279 CPU total 27968750. This file total 375000. CAPI Reads 78125. Writing file 15625. Other 281250

Comando FILESWITCH 87

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd fileswitch ” na página 112

Comando SHUTCONDInterrompe o Agente de Log do PowerExchange para Linux, UNIX e Windows de modo controlado após iniciare concluir um ciclo de processamento final. O ciclo de processamento final habilita o Agente de Log doPowerExchange a capturar todas as alterações realizadas até o momento em que o comando é emitido.

Após a conclusão do ciclo de processamento, o Agente de Log do PowerExchange realiza as seguintesações:

¨ Fecha os arquivos de log abertos.

¨ Grava as informações para o arquivo do CDCT.

¨ Faz um ponto de verificação final para registrar os tokens de sequência e reinicialização mais recentes.

¨ Fecha o CAPI.

¨ Interrompe as subtarefas de Gravador e Manipulador de Comandos.

¨ Finaliza o programa pwxccl.

¨ Relata o uso da CPU.


Notas de UsoUse esse comando para interromper o Agente de Log do PowerExchange se um ciclo de processamento nãotiver sido recentemente executado.


SHUTCOND

Nota: Como alternativa, use o programa pwxcmd para emitir o comando shutcond. Você deve usar o pwxcmdse executar o Agente de Log do PowerExchange em modo de segundo plano.

Exemplo de SaídaO seguinte exemplo de saída do SHUTCOND indica a ordem na qual o processamento e as subtarefas doAgente de Log do PowerExchange são interrompidos:

PWX-33273 Writer starts reading source data. CONDENSE command was received

PWX-26011 Command handler received command "SHUTCOND"PWX-06467 Command Handler: Setting Condense to shut down on running out of data.

PWX-06468 Command Handler: Condense request issued.

PWX-06415 Condense: Condense completed. Total Records=2, Data=1, UOWs =1PWX-06416 Condense: Shutting down because Single Condense run completedPWX-06418 Condense: Closed file C:\Informatica\PowerExchange9.0.0\capture\condenseO.CND.CP091106.T1446008PWX-06420 Condense: Checkpoint done. Sequence=07D9000B0006000E002E0000202FBF000000000100000034000001150008FFFFFFFF PowerExchange Logger=07000000434158313730313031PWX-06136 Checkpoint taken to file=1 time=09/11/06 14:47:16PWX-33278 Total Records 2. Inserts 0. Updates 1. Deletes 0. UOWs 1. Bytes 450PWX-33279 CPU total 515625. This file total 62500. CAPI Reads 0. Writing file 0. Other 62500

PWX-33274 CPU Total 515625. CAPI Read 15625. Writing 15625. File switching 46875. Other 437500

PWX-06414 Condense: Closing down CAPIPWX-33221 CCLWTR closing after a SHUTDOWN request.PWX-06110 Unloaded module 3 (CCL WRITER).PWX-06453 Command Handler: shutting down.PWX-06060 Controller: subtask Condense ended.PWX-06454 Command Handler: has stopped.


PWX-06110 Unloaded module 1 (COMMAND_HANDLER).PWX-06060 Controller: subtask Command Handler ended.PWX-06107 Controller: All subtasks shut down.PWX-25803 Process pwxccl pid 5152 unlocked file C:\Informatica\PowerExchange9.0.0\capture\condenseO_loggerfiles_lockfile.lckPWX-25803 Process pwxccl pid 5152 unlocked file C:\Informatica\PowerExchange9.0.0\capture\condenseO.chkpt_checkpoint_lockfile.lckPWX-25803 Process pwxccl pid 5152 unlocked file C:\Informatica\PowerExchange8.6.1\CDCT_instance_NORT000_lockfile.lck

PWX-33254 pwxccl ended. return code 0PWX-33274 CPU Total 562500. CAPI Read 15625. Writing 15625. File switching 46875. Other 484375pwxccl ended. rc=0

Nota: Para esse exemplo, o arquivo pwxccl.cfg especifica VERBOSE=Y.

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd shutcond ” na página 105

Comando SHUTDOWNInterrompe o Agente de Log do PowerExchange para Linux, UNIX e Windows de modo controlado, apósfechar os arquivos de log abertos do Agente de Log do PowerExchange e gravar a posição de reinicializaçãomais recente para os arquivos de ponto de verificação.

Durante o processamento do shutdown, o Agente de Log do PowerExchange realiza estas ações:


¨ Atualiza o arquivo do CDCT


¨ Fecha o CAPI.





SintaxeA Informatica recomenda que você use o programa pwxcmd para emitir o comando shutdown, em vez deinformá-lo no prompt. Com o pwxcmd, você pode enviar o comando a um processo do Agente de Log doPowerExchange que está sendo executado em modo de primeiro e segundo planos no mesmo sistema ou emum sistema diferente.

Se você não configurou o PowerExchange para usar o pwxcmd, pode interromper o processo do Agente deLog do PowerExchange de uma das seguintes maneiras:

¨ Se o processo do Agente de Log do PowerExchange estiver sendo executado em modo de primeiro plano,informe o seguinte comando no prompt:

SHUTDOWN¨ Se o processo do Agente de Log do PowerExchange estiver sendo executado em modo de segundo plano

em um sistema operacional Linux ou UNIX, use o comando kill para interromper o Agente de Log doPowerExchange. Certifique-se de informar a Identificação de processo correta para o comando.

¨ No Windows, você pode finalizar o processo pwxccl.exe imediatamente do Gerenciador de Tarefas.

Notas de UsoUse o comando SHUTDOWN para interromper um processo do Agente de Log do PowerExchange que estásendo executado em modo contínuo.

Comando SHUTDOWN 89

Se o Agente de Log do PowerExchange estiver sendo executado em modo de lote, esse comandonormalmente não é necessário. O processo do Agente de Log do PowerExchange é desligado após o términodo período de espera que você especificou no parâmetro NO_DATA_WAIT2 do pwxccl.cfg.

Exemplo de SaídaO seguinte exemplo de saída do SHUTDOWN mostra o progresso do processamento do shutdown:

PWX-06416 Condense: Shutting down because SHUTDOWN event received

PWX-26011 Command handler received command "SHUTDOWN"PWX-06463 Command Handler: Close Condense request is now queued.PWX-06464 Command Handler: Shutdown will occur shortly.

PWX-06453 Command Handler: shutting down.PWX-06420 Condense: Checkpoint done. Sequence=07D9000B0006000E0022000A12E5094000000001000000340000010E0004FFFFFFFF PowerExchange Logger=07000000434158313730313031PWX-06136 Checkpoint taken to file=2 time=09/11/06 14:39:11PWX-33279 CPU total 28187500. This file total 46875. CAPI Reads 0. Writing file 0. Other 46875

PWX-33274 CPU Total 28203125. CAPI Read 26765625. Writing 109375. File switching 218750. Other 1109375

PWX-06414 Condense: Closing down CAPIPWX-33221 CCLWTR closing after a SHUTDOWN request.PWX-06110 Unloaded module 3 (CCL WRITER).PWX-06060 Controller: subtask Condense ended.PWX-06454 Command Handler: has stopped.PWX-06110 Unloaded module 1 (COMMAND_HANDLER).PWX-06060 Controller: subtask Command Handler ended.PWX-06107 Controller: All subtasks shut down.PWX-25803 Process pwxccl pid 3396 unlocked file C:\Informatica\PowerExchange9.0.0\capture\condenseO_loggerfiles_lockfile.lckPWX-25803 Process pwxccl pid 3396 unlocked file C:\Informatica\PowerExchange9.0.0\capture\condenseO.chkpt_checkpoint_lockfile.lckPWX-25803 Process pwxccl pid 3396 unlocked file C:\Informatica\PowerExchange8.6.1\CDCT_instance_NORT000_lockfile.lck

PWX-33254 pwxccl ended. return code 0PWX-33274 CPU Total 28265625. CAPI Read 26765625. Writing 109375. File switching 218750. Other 1171875pwxccl ended. rc=0

TÓPICOS RELACIONADOS:¨ “Comando pwxcmd shutdown ” na página 113



Comandos pwxcmdEste capítulo inclui os seguintes tópicos:

¨ Introdução aos Comandos pwxcmd, 91

¨ Sintaxe de Comando para os Comandos pwxcmd, 92

¨ Processamento de Comandos para os Comandos pwxcmd, 93

¨ Configurando os Processos do PowerExchange para Receberem os Comandos pwxcmd, 94

¨ Autorizando os Usuários a Emitirem os Comandos pwxcmd, 98

¨ Executando os Comandos pwxcmd da Linha de Comando, 98

¨ Script dos Comandos pwxcmd, 99

¨ Comandos pwxcmd para o Ouvinte do PowerExchange, 100

¨ Comandos pwxcmd para o Condensador do PowerExchange, 103

¨ Comandos pwxcmd para o Agente de Log do PowerExchange para Linux, UNIX e Windows, 106

¨ Outros Comandos pwxcmd, 114

Introdução aos Comandos pwxcmdPara emitir comandos para um processo do PowerExchange que não é gerenciado por um serviço deaplicativo do PowerExchange, você deve usar o programa pwxcmd. Para emitir comandos para um processodo PowerExchange que é gerenciado por um serviço de aplicativo do PowerExchange, use o programainfacmd pwx. Para obter mais informações sobre o programa infacmd pwx, consulte o Informatica CommandReference.

Você pode emitir os comandos pwxcmd em um sistema Linux, UNIX ou Windows de uma linha de comando,script ou trabalho em lotes para qualquer um dos seguintes processos e sistemas:

¨ Ouvinte do PowerExchange em qualquer sistema

¨ Condensador do PowerExchange em um sistema i5/OS ou z/OS

¨ Agente de Log do PowerExchange para Linux, UNIX e Windows em um sistema Linux, UNIX ou Windows

Com o pwxcmd, você pode emitir comandos iguais ao que emite da linha de comando para esses processosdo PowerExchange.

Antes de emitir os comandos pwxcmd, você deve configurar os processos do PowerExchange para recebê-los. Estas tarefas de configuração que você deve concluir dependem de qual processo do PowerExchange éo destino dos comandos pwxcmd. Para obter mais informações, consulte “Configurando os Processos doPowerExchange para Receberem os Comandos pwxcmd” na página 94.

Quando você emite os comandos pwxcmd, cada um desses comandos deve incluir o nome do serviçodefinido pelo usuário para o processo do PowerExchange de destino do comando. Além disso, se vocêhabilitar a segurança, deve especificar uma Identificação de usuário e uma senha, criptografada ou não, aoemitir um comando pwxcmd. Para obter mais informações, consulte “Sintaxe de Comando para os Comandospwxcmd” na página 92.

91

A saída dos comandos pwxcmd aparece na linha de comando ou em um arquivo para o qual você canaliza asaída no sistema Linux, UNIX ou Windows que emitiu os comandos. Para obter mais informações, consulte “Executando os Comandos pwxcmd da Linha de Comando” na página 98 e “Script dos Comandospwxcmd” na página 99.

Se você efetua o upgrade para o PowerExchange 9.0.1 em um sistema i5/OS, deve emitir um comando deupgrade para executar o Ouvinte do PowerExchange. Em seguida, você pode enviar os comandos pwxcmdpara um processo do Ouvinte do PowerExchange ou do Condensador do PowerExchange executado em umsistema i5/OS. Para obter mais informações, consulte o PowerExchange Planning Guide for Installation andMigration.

TÓPICOS RELACIONADOS:¨ “Comandos do Condensador do PowerExchange” na página 45

¨ “Comandos do Ouvinte do PowerExchange” na página 53

¨ “Comandos do Agente de Log do PowerExchange para Linux, UNIX e Windows” na página 77

¨ “Sintaxe de Comando para os Comandos pwxcmd” na página 92

¨ “Configurando os Processos do PowerExchange para Receberem os Comandos pwxcmd” na página 94

¨ “Comandos pwxcmd para o Ouvinte do PowerExchange” na página 100

¨ “Comandos pwxcmd para o Condensador do PowerExchange” na página 103

¨ “Comandos pwxcmd para o Agente de Log do PowerExchange para Linux, UNIX e Windows” na página106

Sintaxe de Comando para os Comandos pwxcmdAo informar os comandos pwxcmd, use uma sintaxe básica.

A sintaxe para o comando pwxcmd é:

pwxcmd command_name {-service|-sv} service_name [{-user|-uid|-u} user_ID {{-password |-pwd|-p} password} | {-epassword|-e} encrypted_password}] [command_options]

Parâmetros para os Comandos pwxcmdOs parâmetros são obrigatórios e opcionais para os comandos pwxcmd.

Especifique os seguintes parâmetros para os comandos pwxcmd:

command_name

Obrigatório. Comando que o pwxcmd envia para o processo do PowerExchange que executa o serviçoespecificado no parâmetro -service.

{-service|-sv} service_name

Obrigatório. Nome do serviço do processo do PowerExchange que é o destino do comando. Especifiqueo valor do nome de serviço codificado na instrução CMDNODE do arquivo de configuração DBMOVERque configura o processo do PowerExchange que é o destino do comando.

{-user|-uid|-u} user_ID

Opcional. Identificação de usuário do sistema operacional válida no sistema que é o destino do comando.Se o processo do PowerExchange de destino tiver a segurança habilitada, você deve especificar umaIdentificação de usuário válida e uma senha ou senha criptografada.

{-password|-pwd|-p} password

Opcional. Uma senha de texto simples para a Identificação de usuário que você especificou noparâmetro -user.

92 Capítulo 16: Comandos pwxcmd

Se você especificar -user, crie uma senha ou senha criptografada com o parâmetro -password ou -epassword. Se você especificar o parâmetro -password, não especifique também o parâmetro -epassword.

{-epassword|-e} encrypted_password

Opcional. Uma senha criptografada para a Identificação de usuário que você especificou no parâmetro -user.

Sugestão: Você pode criar uma senha criptografada no Navegador do PowerExchange selecionandoArquivo> Criptografar Senha.

Se você especificar -user, crie uma senha ou senha criptografada com o parâmetro -password ou -epassword. Se você especificar o parâmetro -epassword, não especifique também o parâmetro -password.

command_options

Opcional. Se obrigatório, qualquer opção válida para o comando especificado em command_name.

TÓPICOS RELACIONADOS:¨ “Comandos pwxcmd para o Ouvinte do PowerExchange” na página 100

¨ “Comandos pwxcmd para o Condensador do PowerExchange” na página 103

¨ “Comandos pwxcmd para o Agente de Log do PowerExchange para Linux, UNIX e Windows” na página106

¨ “Outros Comandos pwxcmd” na página 114

Processamento de Comandos para os Comandospwxcmd

Os manipulador de comandos pwxcmd processa os comandos pwxcmd que você emitiu para um processo doOuvinte do PowerExchange, do Condensador do PowerExchange ou do Agente de Log do PowerExchangepara Linux, UNIX e Windows.

Quando você emite um comando pwxcmd, ocorre o seguinte processamento do comando:

1. O manipulador de comandos pwxcmd determina o número de porta e endereço IP para envio docomando da instrução CMDNODE que tem o nome de serviço especificado no comando. A instruçãoCMDNODE está no arquivo de configuração DBMOVER no sistema Linux, UNIX ou Windows do qualvocê emite o comando pwxcmd.

2. O processo do PowerExchange que é o destino do comando adquire o nome de serviço da seguintemaneira:

¨ Um processo do Ouvinte do PowerExchange adquire seu nome de serviço do comando pwxcmd.

¨ Um processo do Condensador do PowerExchange adquire o seu nome de serviço da instruçãoCONDENSENAME no membro ou arquivo de configuração CAPTPARM.

¨ Um processo do Agente de Log do PowerExchange para Linux, UNIX e Windows adquire o seu nomede serviço da instrução CONDENSENAME no arquivo pwxccl.cfg.

O processo do PowerExchange escuta qualquer comando pwxcmd na porta que você especificou nainstrução SVCNODE relevante.

Se nenhuma instrução SVCNODE corresponder ao nome de serviço, o PowerExchange emitemensagens de aviso PWX-32534 e desabilita a saída do pwxcmd.

3. O manipulador de comandos pwxcmd transfere o tipo de serviço especificado na instrução CMDNODEpara o serviço de manipulação de comandos do processo do PowerExchange. O serviço recusa aconexão se o tipo de serviço estiver incorreto. Por exemplo, um serviço do Ouvinte do PowerExchangerecusa a conexão se o tipo de serviço for CONDENSE.

Processamento de Comandos para os Comandos pwxcmd 93

4. O programa pwxcmd espera 60 segundos para que o serviço de manipulação de comando emita umcódigo de retorno e indique que o comando foi concluído. Se o comando não for concluído dentro desseperíodo de tempo, o programa pwxcmd exibe uma mensagem de tempo limite.

Os códigos de retorno são os números da mensagem do PowerExchange ou um código de retorno doprocessamento do comando.

Configurando os Processos do PowerExchange paraReceberem os Comandos pwxcmd

Para enviar comandos pwxcmd a um processo do PowerExchange, configure o processo para recebercomandos pwxcmd.

Além disso, no sistema Linux, UNIX ou Windows no qual você emite comandos pwxcmd, configure umaconexão com o processo do PowerExchange.

Para configurar um processo do PowerExchange para receber comandos pwxcmd, conclua as seguintestarefas de configuração:

¨ No sistema em que o processo do PowerExchange é executado:

1. Configure o processo do PowerExchange para receber comandos pwxcmd.

Para configurar um processo do Ouvinte do PowerExchange para receber comandos pwxcmd, definauma instrução LISTENER e uma instrução SVCNODE no arquivo de configuração DBMOVER.

Para configurar um processo do Condensador do PowerExchange ou do Agente de Log doPowerExchange para Linux, UNIX e Windows, defina uma instrução CONDENSENAME e umainstrução SVCNODE. Para um processo do Condensador do PowerExchange, defina a instruçãoCONDENSENAME no arquivo de configuração ou membro CAPTPARM. Para um processo do Agentede Log do PowerExchange para Linux, UNIX e Windows, defina uma instrução CONDENSENAME noarquivo pwxccl.cfg. Para obter informações sobre a instrução CONDENSENAME , consulte o guiaCDC relativo ao sistema operacional. Para obter informações sobre as instruções LISTENER ESVCNODE , consulte o Manual de Referência do PowerExchange.

2. Como opção, configure a segurança para comandos pwxcmd. Você pode configurar oPowerExchange para verificar se o usuário tem autorização para acessá-lo ou emitir o comando.

Para configurar a segurança, defina uma instrução SECURITY no arquivo de configuração DBMOVERe execute as outras tarefas de configuração.

Para obter mais informações sobre a segurança do comando pwxcmd, consulte o Manual deReferência do PowerExchange.

3. No i5/OS, se você estiver fazendo upgrade para o PowerExchange 9.0.1, execute as seguintestarefas para habilitar a execução do Ouvinte do PowerExchange e autorizar os usuários a emitircomandos pwxcmd para um processo do PowerExchange.

Para habilitar a execução do Ouvinte do PowerExchange, emita o seguinte comando de upgrade:CHGJOBD JOBD(datalib/DTLLIST) ALWMLTTHD(*YES)

Onde datalib é o nome definido pelo usuário para a biblioteca de dados do PowerExchangeespecificada na instalação.

Além disso, verifique se o valor do sistema QMLTTHDACN está definido com um valor que permita aexecução de funções que possam não ser seguras para thread. Se o valor do sistema QMLTTHDACNestiver definido como 3, ou com o valor Do not perform the function no iSeries Navigator, oPowerExchange não será iniciado. Defina o valor do sistema QMLTTHDACN como 1 ou 2, ou com ovalor Perform the function that is not threadsafe, no Navegador iSeries.

Para criar objetos de segurança, emita o seguinte comando de upgrade:CALL PGM(dtllib/CRTDTLENVA) PARM('datalib')


Onde dtllib é o nome da biblioteca de software e datalib é o nome da biblioteca de dados doPowerExchange que você especificou na instalação. Para autorizar um usuário a emitir um comandopwxcmd específico, conceda a ele acesso ao objeto de segurança para o comando.

4. Inicie os processos do PowerExchange aos quais você deseja enviar comandos pwxcmd.

¨ No sistema Linux, UNIX ou Windows no qual você emite comandos pwxcmd, configure conexões com osprocessos do PowerExchange aos quais você deseja enviar comandos pwxcmd. Para configurar umaconexão, defina uma instrução CMDNODE no arquivo dbmover.cfg. Para obter mais informações sobre ainstrução CMDNODE, consulte o Manual de Referência do PowerExchange.

Exemplo 1: Configurando um Ouvinte do PowerExchange paraReceber os Comandos pwxcmd

Esse exemplo configura um Ouvinte do PowerExchange para receber os comandos pwxcmd.

Você emite os comandos pwxcmd de um sistema Linux, UNIX ou Windows remoto em relação ao sistema noqual o Ouvinte do PowerExchange é executado.

Você deve incluir as instruções de configuração de comando pwxcmd nos arquivos de configuraçãoDBMOVER em ambos os sistemas.

Para configurar um Ouvinte do PowerExchange para receber os comandos pwxcmd:

1. No arquivo de configuração DBMOVER no sistema em que o Ouvinte do PowerExchange é executado,inclua uma instrução SVCNODE. A instrução SVCNODE especifica a porta na qual o serviço demanipulação de comando para o Ouvinte do PowerExchange escuta os comandos pwxcmd. Porexemplo:

LISTENER=(node1,TCPIP,2480)SVCNODE=(node1,6001)

Na instrução SVCNODE:

¨ O primeiro valor de parâmetro, node1, é o nome do serviço que corresponde ao nome do nó nainstrução LISTENER.

¨ O segundo valor de parâmetro, 6001, é o número da porta TCP/IP na qual o serviço escuta oscomandos pwxcmd. O número da porta deve ser igual ao número da porta na instrução CMDNODEcorrespondente. A instrução CMDNODE está no arquivo de configuração DBMOVER no sistemaLinux, UNIX ou Windows do qual você emite comandos pwxcmd.

2. No arquivo de configuração dbmover.cfg no sistema Linux, UNIX ou Windows do qual você emitecomandos pwxcmd, inclua uma instrução CMDNODE. A instrução CMDNODE define as informações deconexão do Ouvinte do PowerExchange para o qual deseja enviar os comandos pwxcmd. Por exemplo:

CMDNODE=(listnode,LISTENER,remote_host,6001)Na instrução CMDNODE:

¨ O primeiro valor de parâmetro, listnode, é um nome de serviço. Esse nome de serviço pode serqualquer nome que você desejar Especifique esse nome de serviço ao emitir os comandos pwxcmdpara o Ouvinte do PowerExchange.

¨ O segundo valor de parâmetro, LISTENER, é o tipo de serviço para o Ouvinte do PowerExchange.

¨ O terceiro valor de parâmetro, remote_host, é o nome do host do Ouvinte do PowerExchange quedeseja contatar.

¨ O quarto valor de parâmetro, 6001, é o número da porta TCP/IP. Esse número da porta deve ser igualao número da porta na instrução SVCNODE correspondente, no arquivo de configuração DBMOVERdo sistema em que o Ouvinte do PowerExchange é executado.

3. No comando pwxcmd que você envia ao Ouvinte do PowerExchange, especifique da seguinte forma aopção -service:

pwxcmd listtask -service listnodeO nome do serviço no comando pwxcmd deve ser igual ao nome de serviço da instrução CMDNODEcorrespondente. A instrução CMDNODE está no arquivo de configuração dbmover.cfg no sistema Linux,UNIX ou Windows do qual você emite comandos pwxcmd.

Configurando os Processos do PowerExchange para Receberem os Comandos pwxcmd 95

Exemplo 2: Configurando um Processo do Condensador doPowerExchange para Receber os Comandos pwxcmd

Esse exemplo configura um processo do Condensador do PowerExchange para receber os comandospwxcmd.

Você emite os comandos pwxcmd de um sistema Linux, UNIX ou Windows remoto em relação ao sistema noqual o processo do Condensador do PowerExchange é executado.


Além disso, inclua uma instrução CONDENSENAME no membro ou arquivo de configuração CAPTPARMpara o sistema i5/OS ou z/OS em que o processo do Condensador do PowerExchange é executado. Ainstrução CONDENSENAME define um nome de serviço para o processo do Condensador doPowerExchange.

Para configurar um processo do Condensador do PowerExchange para receber os comandos pwxcmd:

1. No membro ou arquivo de configuração CAPTPARM do sistema i5/OS ou z/OS em que o processo doCondensador do PowerExchange é executado, inclua uma instrução CONDENSENAME. A instruçãoCONDENSENAME define um nome de serviço para o processo do Condensador do PowerExchange querecebe os comandos pwxcmd. Por exemplo:

CONDENSENAME=COND_NODE2. No arquivo de configuração DBMOVER, no sistema em que o Condensador do PowerExchange é

executado, inclua uma instrução SVCNODE. A instrução SVCNODE especifica a porta TCP/IP na qual oserviço manipulador de comando para o Condensador do PowerExchange escuta os comandos pwxcmd.Por exemplo:

SVCNODE=(COND_NODE,6003)Na instrução SVCNODE:

¨ O primeiro valor de parâmetro, COND_NODE, é o nome de serviço. Esse nome de serviço deve serigual ao nome de serviço na instrução CONDENSENAME correspondente. A instruçãoCONDENSENAME está no membro ou arquivo de configuração CAPTPARM, no sistema onde oprocesso do Condensador do PowerExchange é executado.

¨ O segundo valor de parâmetro, 6003, é o número da porta TCP/IP na qual o serviço escuta oscomandos pwxcmd. Esse número da porta deve ser igual ao número da porta na instruçãoCMDNODE correspondente. A instrução CMDNODE está no arquivo de configuração DBMOVER nosistema do qual você emite comandos pwxcmd.

3. No arquivo de configuração dbmover.cfg no sistema Linux, UNIX ou Windows do qual você emitecomandos pwxcmd, inclua uma instrução CMDNODE. A instrução CMDNODE especifica as informaçõesde conexão do processo do Condensador do PowerExchange para o qual deseja enviar os comandospwxcmd. Por exemplo:

CMDNODE=(cndnode,CONDENSE,remote_host,6003)Na instrução CMDNODE:

¨ O primeiro valor de parâmetro, cndnode, é um nome de serviço. Esse nome de serviço pode serqualquer nome que você desejar Especifique esse nome de serviço ao emitir os comandos pwxcmdpara o processo do Condensador do PowerExchange.

¨ O segundo valor de parâmetro, CONDENSE, é o tipo de serviço para o processo do Condensador doPowerExchange.

¨ O terceiro valor de parâmetro, remote_host, é o nome do host onde o processo do Condensador doPowerExchange é executado.

¨ O quarto valor de parâmetro, 6003, é o número da porta TCP/IP. Esse número da porta deve ser igualao número da porta na instrução SVCNODE correspondente. A instrução SVCNODE está no membroou arquivo de configuração DBMOVER, no sistema onde o processo do Condensador doPowerExchange é executado.


4. No comando pwxcmd que você envia ao Ouvinte do PowerExchange, especifique a opção -service daseguinte forma:

pwxcmd condense -service cndnodeO nome de serviço no comando pwxcmd é igual ao nome de serviço da instrução CMDNODEcorrespondente. A instrução CMDNODE está no arquivo de configuração dbmover.cfg no sistema do qualvocê emite comandos pwxcmd.

Exemplo 3: Configurando um Processo do Agente de Log doPowerExchange para Receber os Comandos pwxcmd

Esse exemplo configura um processo do Agente de Log do PowerExchange para Linux, UNIX e Windowspara receber comandos pwxcmd.

Você emite os comandos pwxcmd de um sistema Linux, UNIX ou Windows remoto em relação ao sistema noqual o processo do Agente de Log do PowerExchange é executado.


Além disso, você deve incluir uma instrução CONDENSENAME no arquivo de configuração pwxccl.cfg para osistema em que o processo do Agente de Log do PowerExchange para Linux, UNIX e Windows é executado.A instrução CONDENSENAME define um nome de serviço para o processo do Agente de Log doPowerExchange para Linux, UNIX e Windows.

Para configurar um processo do Agente de Log do PowerExchange para receber os comandos pwxcmd:

1. No arquivo de configuração pwxccl.cfg do sistema Linux, UNIX ou Windows em que o processo doAgente de Log do PowerExchange para Linux, UNIX e Windows é executado, inclua uma instruçãoCONDENSENAME. A instrução CONDENSENAME define um nome de serviço para o processo doAgente de Log do PowerExchange para Linux, UNIX e Windows que recebe os comandos pwxcmd. Porexemplo:

CONDENSENAME=COND_NODE2. No arquivo de configuração DBMOVER no sistema em que o Agente de log do PowerExchange para

Linux, UNIX e Windows é executado, inclua uma instrução SVCNODE. A instrução SVCNODE especificaa porta TCP/IP na qual o serviço manipulador de comando para o Agente de Log do do PowerExchangepara Linux, UNIX e Windows escuta os comandos pwxcmd. Por exemplo:

SVCNODE=(COND_NODE,6003)Na instrução SVCNODE:

¨ O primeiro valor de parâmetro, COND_NODE, é o nome de serviço. Esse nome de serviço deve serigual ao nome de serviço na instrução CONDENSENAME correspondente. A instruçãoCONDENSENAME está no arquivo de configuração pwxccl.cfg para o sistema em que o processo doAgente de Log do PowerExchange para Linux, UNIX e Windows é executado.

¨ O segundo valor de parâmetro, 6003, é o número da porta TCP/IP na qual o serviço escuta oscomandos pwxcmd. Esse número da porta deve ser igual ao número da porta na instruçãoCMDNODE correspondente. A instrução CMDNODE está no arquivo de configuração DBMOVER nosistema Linux, UNIX ou Windows do qual você emite comandos pwxcmd.

3. No arquivo de configuração dbmover.cfg no sistema Linux, UNIX ou Windows do qual você emitecomandos pwxcmd, inclua uma instrução CMDNODE. A instrução CMDNODE especifica as informaçõesde conexão do processo do Agente de Log do PowerExchange para Linux, UNIX e Windows para o qualdeseja enviar os comandos pwxcmd. Por exemplo:

CMDNODE=(cndnode,CONDENSE,remote_host,6003)Na instrução CMDNODE:

¨ O primeiro valor de parâmetro, cndnode, é um nome de serviço. Esse nome de serviço pode serqualquer nome que você desejar Especifique esse nome de serviço ao emitir os comandos pwxcmdpara o processo do Agente de Log do PowerExchange para Linux, UNIX e Windows.

Configurando os Processos do PowerExchange para Receberem os Comandos pwxcmd 97

¨ O segundo valor de parâmetro, CONDENSE, é o tipo de serviço para o processo do Agente de Log doPowerExchange para Linux, UNIX e Windows.

¨ O terceiro valor de parâmetro, remote_host, é o nome do host onde o processo do Agente de Log doPowerExchange para Linux, UNIX e Windows é executado.

¨ O quarto valor de parâmetro, 6003, é o número da porta TCP/IP. Esse número da porta deve ser igualao número da porta na instrução SVCNODE correspondente. A instrução SVCNODE está no arquivode configuração DBMOVER no sistema em que o processo do Agente de Log do PowerExchangepara Linux, UNIX e Windows é executado.

4. No comando pwxcmd que você envia ao processo do Agente de Log do PowerExchange para Linux,UNIX e Windows, especifique a opção -service conforme:

pwxcmd condense -service cndnodeO nome do serviço no comando pwxcmd deve ser igual ao nome de serviço da instrução CMDNODEcorrespondente. A instrução CMDNODE está no arquivo de configuração DBMOVER no sistema Linux,UNIX ou Windows do qual você emite comandos pwxcmd.

Autorizando os Usuários a Emitirem os Comandospwxcmd

Você pode habilitar a segurança para os comandos pwxcmd.

O PowerExchange oferece as seguintes opções básicas de segurança para os comandos pwxcmd:

¨ Você pode solicitar que os usuários informem uma Identificação de usuário válida do sistema operacionale uma senha para acesso ao PowerExchange, ao emitirem um comando pwxcmd.

¨ Você pode autorizar que usuários específicos emitam comandos pwxcmd específicos.

Se você habilitar a segurança para os comandos pwxcmd, os usuários devem especificar uma Identificaçãode usuário e uma senha ou senha criptografada para todos os comandos. Conforme o tipo de segurançautilizado, o PowerExchange verifica se o usuário tem autorização para acessar o PowerExchange ou emitir ocomando.

Se você não habilitar a segurança para os comandos pwxcmd, os usuários não necessitam especificar umaIdentificação de usuário e uma senha.

Para obter mais informações sobre a segurança do comando pwxcmd, consulte o Manual de Referência doPowerExchange.

Executando os Comandos pwxcmd da Linha deComando

Você pode executar os comandos pwxcmd da linha de comando em um sistema Linux, UNIX ou Windows.

Para executar os comandos pwxcmd da linha de comando:

1. Inclua o diretório que contém o pwxcmd na variável de ambiente PATH. Por padrão, esse diretório é odiretório de instalação do PowerExchange.

2. De um prompt de comando, informe o comando pwxcmd com suas opções e argumentos. Use a seguintesintaxe:

pwxcmd command_name -service service_name [-user user_ID {-password password|-epassword encrypted_password}] [command_options]


Nota: A Identificação do usuário e a senha ou as opções de senha criptografada são necessáriassomente se você habilitar a segurança do pwxcmd.

Por exemplo, você pode informar o seguinte comando no Windows:C:\Informatica\PowerExchange>pwxcmd listtask -service node1

A saída do comando pwxcmd aparece na linha de comando ou em um arquivo para o qual você canalizaa saída no sistema Linux, UNIX ou Windows em que o comandos é enviado. Por exemplo, a saída podeaparecer da seguinte forma na linha de comando no Windows:

C:\Informatica\PowerExchange>pwxcmd listtask -service node1PWX-00711 Active tasks:PWX-00713 0 active tasks

TÓPICOS RELACIONADOS:¨ “Sintaxe de Comando para os Comandos pwxcmd” na página 92

¨ “Autorizando os Usuários a Emitirem os Comandos pwxcmd” na página 98

Script dos Comandos pwxcmdVocê pode emitir os comandos pwxcmd de um sistema Linux, UNIX ou Windows através de arquivos emlotes, scripts ou outros programas.

Você pode emitir os comandos pwxcmd regularmente, como o comando pwxcmd close para interromper oOuvinte do PowerExchange. Nesse caso, você pode criar um script shell ou um arquivo em lotes para chamarum ou mais comandos pwxcmd com as suas opções e argumentos.

O seguinte exemplo de arquivo em lotes do Windows, pwxcmd_list.bat, verifica se o Ouvinte doPowerExchange está ativo e, em seguida, fecha-o.

@echo offREM -- NAME: pwxcmd_list.batREM -- DESCRIPTION: Sample pwxcmd script to display any PowerExchange Listener active taskspwxcmd listtask -sv TEST if errorlevel ==32601 goto noconnectif errorlevel ==0 goto close:closepwxcmd close -sv TEST if %errorlevel% neq 0 goto noconnectif errorlevel ==0 goto end:noconnectecho %errorlevel%echo "Could not connect to pwxcmd command handler."pausegoto end:end

Nota: Esse script não utiliza a segurança para os comandos pwxcmd.

Para que esse script funcione, você deve configurar um Ouvinte do PowerExchange para receber oscomandos pwxcmd. Por exemplo, para emitir os comandos pwxcmd do mesmo sistema em que o Ouvinte doPowerExchange é executado, você pode configurar da seguinte forma um Ouvinte do PowerExchange noarquivo dbmover.cfg:

LISTENER=(node1,TCPIP,2480)SVCNODE=(node1,6001)CMDNODE=(TEST,LISTENER,localhost,6001)

Execute o script da linha de comando. Por exemplo, no Windows, execute da seguinte forma o script:

C:\Informatica\PowerExchange>pwxcmd_list.bat

A saída dos comandos pwxcmd no script aparece na linha de comando ou em um arquivo para o qual vocêcanaliza a saída no sistema Linux, UNIX ou Windows em que os comandos são enviados. Por exemplo, asaída pode aparecer da seguinte forma na linha de comando no Windows:

C:\Informatica\PowerExchange>pwxcmd_list.batPWX-00711 Active tasks:PWX-00713 0 active tasksPWX-00726 Close

Script dos Comandos pwxcmd 99

TÓPICOS RELACIONADOS:¨ “Sintaxe de Comando para os Comandos pwxcmd” na página 92

¨ “Configurando os Processos do PowerExchange para Receberem os Comandos pwxcmd” na página 94

Comandos pwxcmd para o Ouvinte doPowerExchange

Você pode usar o programa pwxcmd para emitir os comandos close, closeforce, listtask e stoptask de umsistema Linux, UNIX ou Windows para um Ouvinte do PowerExchange que está sendo executado emqualquer sistema.

Nota: Você não pode inicializar um processo do Ouvinte do PowerExchange com o programa pwxcmd.

Comando pwxcmd closeInterrompe a tarefa ou o trabalho do Ouvinte do PowerExchange, após esperar pela conclusão de todas assubtarefas incomuns do Ouvinte do PowerExchange.

Nota: Em caso de subtarefas de execução prolongada no Ouvinte do PowerExchange, então, emita ocomando pwxcmd closeforce para forçar o cancelamento de todas as subtarefas do usuário e interromper oOuvinte do PowerExchange.

O comando de fechamento emite as seguintes mensagens:

PWX-00618 Standard Close in progress.PWX-00619 All tasks closed.PWX-00623 Listener shutdown complete.

Use a seguinte sintaxe:

pwxcmd close {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções de fechamento do pwxcmd:

Opção Argumento Description

-service-sv

service_name Obrigatório. Nome do serviço para o Ouvinte doPowerExchange.

-user-uid-u

user_ID Obrigatório se você habilita a segurança. Nome dousuário.

-password-pwd-p

password Senha.Se você especificar uma Identificação de usuário,também deve especificar uma senha em textosimples ou uma senha criptografada.

-epassword-e

encrypted_password Senha criptografada.Se você especificar uma Identificação de usuário,também deve especificar uma senha em textosimples ou uma senha criptografada.

Comando pwxcmd closeforceEm caso de subtarefas de execução prolongada no Ouvinte do PowerExchange, emita o comando closeforcepara forçar o cancelamento de todas as subtarefas do usuário e interromper o Ouvinte do PowerExchange.


Quando você emite o comando closeforce, o PowerExchange conclui o seguinte procedimento:

1. Verifique se qualquer subtarefa do Ouvinte do PowerExchange está ativa.

2. Se houver subtarefas ativas, há uma pesquisa do número de subtarefas ativas a cada segundo, durante30 segundos.

3. Neste período, o PowerExchange interrompe qualquer subtarefa que estiver esperando pela entrada derede TCP/IP e emite a seguinte mensagem:

PWX-00653 Operator close met while waiting for TCPIP input4. Cancela qualquer subtarefa ativa remanescente.

5. Interrompe o Ouvinte do PowerExchange.


pwxcmd closeforce {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd closeforce:


-service-sv

service_name Obrigatório. Nome do serviço para o Ouvintedo PowerExchange.

-user-uid-u

user_ID Obrigatório se você habilita a segurança.Nome do usuário.

-password-pwd-p

password Senha.Se você especificar uma Identificação deusuário, também deve especificar uma senhaem texto simples ou uma senha criptografada.

-epassword-e

encrypted_password Senha criptografada.Se você especificar uma Identificação deusuário, também deve especificar uma senhaem texto simples ou uma senha criptografada.

Comando pwxcmd listtaskExibe informações sobre cada tarefa ativa do Ouvinte do PowerExchange, incluindo o endereço TCP/IP,número de porta, nome do aplicativo, tipo de acesso e status.


pwxcmd listtask {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd listtask:


-service-sv


-user-uid-u


Comandos pwxcmd para o Ouvinte do PowerExchange 101


-password-pwd-p


-epassword-e


Comando pwxcmd stoptaskInterrompe uma tarefa individual do Ouvinte do PowerExchange com base na Identificação da tarefa ou nomedo aplicativo que você especificar.

Sugestão: Para determinar o nome da tarefa ativa, emita o comando listtask. Na saída do comando, procurea mensagem PWX-00712 para a tarefa e anote o valor do nome. Informe esse valor no comando stoptask.

Durante a extração de dados alterados, o comando stoptask espera para interromper a tarefa até que o UOWfinal seja encontrada ou o limite de confirmação seja alcançado.


pwxcmd stoptask {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}] {{-applicationid|-a} appname| {-taskid|-t} taskid}

A tabela a seguir descreve os argumentos e as opções do pwxcmd stoptask:

Opção Argumento Descrição

-service-sv


-user-uid-u

user_ID Obrigatório se você habilita a segurança. Nome dousuário

-password-pwd-p

password SenhaSe você especificar uma Identificação de usuário,também deve especificar uma senha em textosimples ou uma senha criptografada.

-epassword-e


-applicationid-a

appname Obrigatório se você não especificar -taskid taskid.Nome do aplicativo O nome para o processo deextração ativo que você deseja interromper. Amensagem PWX-00712 da saída de comandolisttask exibe este nome.

-taskid-t

taskid Obrigatório se você não especificar -applicationappname.Identificação da tarefa do Ouvinte doPowerExchange. O identificador numérico para atarefa do Ouvinte do PowerExchange que vocêdeseja interromper. A mensagem PWX-00712 dasaída do comando listtask exibe esta Identificação.


Comandos pwxcmd para o Condensador doPowerExchange

Você pode usar o programa pwxcmd para emitir os comandos condense, displaystatus, fileswitch, shutcond eshutdown para um Condensador do PowerExchange que está sendo executado em um sistema i5/OS ou z/OS.Nota: Você não pode inicializar um processo do Condensador do PowerExchange com o programa pwxcmd.

Comando pwxcmd condenseInicia um ciclo do condensador, antes do término do período de espera para a retomada do processamentode condensação, se você executar o Condensador do PowerExchange em modo contínuo. Especifique operíodo de espera no parâmetro NO_DATA_WAIT do membro ou arquivo de configuração CAPTPARM doCondensador do PowerExchange.


pwxcmd condense {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd condense:


-service-sv

service_name Obrigatório. Nome do serviço para o processo doCondensador do PowerExchange.

-user-uid-u


-password-pwd-p

password Senha.Se você especificar uma Identificação do usuário,também deve especificar uma senha em textosimples ou uma senha criptografada.

-epassword-e

encrypted_password Senha criptografada.Se você especificar uma Identificação do usuário,também deve especificar uma senha em textosimples ou uma senha criptografada.

Comando pwxcmd displaystatusExibe o status atual do Controlador do Condensador do PowerExchange e cada subtarefa para o trabalho outarefa inicializada do Condensador do PowerExchange.


pwxcmd displaystatus {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

Comandos pwxcmd para o Condensador do PowerExchange 103

A tabela a seguir descreve os argumentos e as opções do pwxcmd displaystatus:


-service-sv


-user-uid-u


-password-pwd-p


-epassword-e


Comando pwxcmd fileswitchFecha os arquivos condensados abertos, caso contenham dados e alternem por um novo conjunto dearquivos condensados do Condensador do PowerExchange. Se os arquivos condensados atuais não tiveremdados, a alternância de arquivos não ocorre.

Use esse comando para disponibilizar os dados alterados nos arquivos de condensação atuais para extração,antes da próxima alternância de arquivos. Por exemplo, para extrair os dados alterados a cada hora dosarquivos condensados, defina os parâmetros FILE_SWITCH_CRIT e FILE_SWITCH_VAL no arquivos deconfiguração CAPTPARM, de tal modo que a alternância de arquivo ocorra a cada um milhão de atualizaçõesde registro. Em seguida, inclua o comando fileswitch como parte do trabalho em lote para realizar umaalternância de arquivo automática a cada hora, antes da execução do processo de extração.

Nota: Se você realiza o processamento de condensação total e parcial em um único trabalho doCondensador do PowerExchange, o PowerExchange utiliza conjuntos separados de arquivos condensadospara as operações de condensação parcial e total. Quando você emite o comando fileswitch, uma alternânciade arquivos ocorre para ambos os conjuntos de arquivos condensados.


pwxcmd fileswitch {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A seguinte tabela descreve os argumentos e as opções do pwxcmd fileswitch:


-service-sv


-user-uid-u




-password-pwd-p


-epassword-e


Comando pwxcmd shutcondInterrompe o Condensador do PowerExchange após a realização do ciclo final de condensação.

O PowerExchange inicia um ciclo final de condensação, espera que ele seja concluído e, em seguida, desligao Condensador do PowerExchange. Durante o desligamento, o Condensador do PowerExchange fechaqualquer arquivo condensado, grava os dados para o arquivo do CDCT, faz um ponto de verificação final quecontém os tokens de reinicialização mais recentes e, em seguida, desliga.


pwxcmd shutcond {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd shutcond:


-service-sv


-user-uid-u


-password-pwd-p


-epassword-e


Comando pwxcmd shutdownInterrompe o Condensador do PowerExchange.

O comando shutdown transfere um evento de desligamento para o Condensador do PowerExchange. Quandoo Condensador do PowerExchange reconhece o comando, a subtarefa Condensador conclui o seguinteprocessamento:

1. Solicita o fechamento de todas as subtarefas.

2. Fecha qualquer arquivo condensado aberto.

3. Grava os dados aos registros do conjunto de dados do CDCT.

4. Obtém um último ponto de verificação que contenha os tokens de reinicialização mais recentes.

Após o desligamento de todas as subtarefas do condensador, o Condensador do PowerExchange é desligado.

Comandos pwxcmd para o Condensador do PowerExchange 105

Nota: O PowerExchange não processa o comando de desligamento até a conclusão das operações de leiturade condensação e o término do período de espera que você especificou no parâmetro NO_DATA_WAIT2 domembro CAPTPARM.


pwxcmd shutdown {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd shutdown:


-service-sv


-user-uid-u


-password-pwd-p


-epassword-e


Comandos pwxcmd para o Agente de Log doPowerExchange para Linux, UNIX e Windows

Você pode usar o programa pwxcmd para emitir os comandos condense, displaystatus, fileswitch, shutcond eshutdown para um processo do Agente de Log do PowerExchange para Linux, UNIX e Windows.

Nota: Você não pode inicializar um processo do Agente de Log do PowerExchange para Linux, UNIX eWindows com o programa pwxcmd.

Comando pwxcmd condenseQuando o Agente de Log do PowerExchange para Linux, UNIX e Windows estiver sendo executado em modocontínuo, o comando condense inicializa outro ciclo de log, antes do término do período de espera parainicialização de outro ciclo.

Especifique o período de espera no parâmetro NO_DATA_WAIT do arquivo de configuração pwxccl.cfg.


pwxcmd condense {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]


A tabela a seguir descreve os argumentos e as opções do pwxcmd condense:


-service-sv

service_name Obrigatório. Nome de serviço para um processo doAgente de Log do PowerExchange para Linux,UNIX e Windows.

-user-uid-u


-password-pwd-p

password Senha em texto simples.Se você especificar uma Identificação do usuário,deve especificar uma senha em texto simples ouuma senha criptografada.

-epassword-e

encrypted_password Senha criptografada.Se você especificar uma Identificação do usuário,deve especificar uma senha em texto simples ouuma senha criptografada..

Comando pwxcmd displayallExibe todas as mensagens que podem ser produzidas por outros comandos de exibição do Agente de Log doPowerExchange para Linux, UNIX e Windows, organizadas por comando.

A saída é a mesma se você executou os seguintes comandos pwxcmd separadamente:

¨ displaycheckpoints

¨ displaycpu

¨ displayevents

¨ displaymemory

¨ displayrecords

¨ displaystatus


pwxcmd displayall {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd displayall:


-service-sv

service_name Obrigatório. Nome de serviço para um processo doAgente de Log do PowerExchange para Linux,UNIX e Windows

-user-uid-u


Comandos pwxcmd para o Agente de Log do PowerExchange para Linux, UNIX e Windows 107


-password-pwd-p

password Senha em texto simples.Se você especificar uma Identificação de usuário,deve especificar uma senha em texto simples ouuma senha criptografada.

-epassword-e

encrypted_password Senha criptografada.Se você especificar uma Identificação de usuário,deve especificar uma senha em texto simples ouuma senha criptografada.

Comando pwxcmd displaycheckpointsExibe a mensagem PWX-26041, que relata as informações sobre o arquivo de ponto de verificação maisrecente. As informações incluem o número de sequência do arquivo, carimbo de data/hora, número deregistros de dados e registros de confirmação, bem como o tempo de confirmação.


pwxcmd displaycheckpoints {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd displaycheckpoints:


-service-sv


-user-uid-u


-password-pwd-p


-epassword-e


Comando pwxcmd displaycpuExibe o tempo de CPU gasto, em microssegundos, para o processamento do Agente de Log doPowerExchange durante o ciclo de log atual, por fase de processamento. Também inclui o tempo de CPUtotal para todo o processamento do Agente de Log do PowerExchange.

Por exemplo, o PowerExchange pode reportar o tempo de CPU para as seguintes fases de processamento:

¨ Leitura de dados de origem

¨ Gravação de dados para os arquivos de log do PowerExchange

¨ Execução de alternâncias de arquivo

¨ Realização de "outros processamentos", como inicialização e processamento de comandos peloManipulador de Comandos



pwxcmd displaycpu {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd displaycpu:


-service-sv


-user-uid-u


-password-pwd-p


-epassword-e


Comando pwxcmd displayeventsExibe eventos esperados pelas tarefas Controlador, Manipulador de Comandos e Gravador do Agente de Logdo PowerExchange. Também indica se o Gravador está processando os dados ou se está inativo esperandopor um evento ou tempo limite.


pwxcmd displayevents {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd displayevents:


-service-sv


-user-uid-u


-password-pwd-p


-epassword-e


Comando pwxcmd displaymemoryExibe o uso de memória, em bytes, para cada tarefa e subtarefa do Agente de Log do PowerExchange paraLinux, UNIX e Windows com os totais para todo o processo do Agente de Log do PowerExchange.


O PowerExchange relata o uso de memória para as seguintes categorias:

¨ Aplicativo. Memória solicitada pelo aplicativo do Agente de Log do PowerExchange para uso próprio.

¨ Total Memória total em uso pelo aplicativo do Agente de Log do PowerExchange e pelo limite máximo docabeçalho relacionado. Esse valor varia conforme a memória é alocada dinamicamente e liberada peloPowerExchange durante o processamento do Agente de Log do PowerExchange.

¨ Máximo. A maior quantidade de memória registrada para a categoria “Total” até o ponto no tempo queesse comando é executado.


pwxcmd displaymemory {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd displaymemory:

Opção Argumento Descrição

-service-sv


-user-uid-u


-password-pwd-p

password Senha em texto simples.Se você especificar uma Identificação do usuário,deve especificar uma senha em texto simples ouuma senha criptografada.

-epassword-e

encrypted_password Senha criptografada.Se você especificar uma Identificação do usuário,deve especificar uma senha em texto simples ouuma senha criptografada.

Comando pwxcmd displayrecordsExibe as contagens de registros de alteração que o Agente de Log do PowerExchange para Linux, UNIX eWindows processou durante o ciclo de processamento atual. Se o Agente de Log do PowerExchange nãorecebeu alterações no ciclo atual, exibe as contagens de registro de alteração para os arquivos de log atuaisdo Agente de Log do PowerExchange.

As contagens de registro são mostradas para cada tipo de registro de alteração processado e para o total deregistros processados. Os tipos de registro de alteração incluem Excluir, Inserir, Atualizar e Confirmar.

A saída inclui todos ou alguns tipos das seguintes contagens, dependendo se elas são para o ciclo atual oupara os registros de log atuais:

¨ Ciclo. As contagens dos registros de alteração para o ciclo de processamento do Agente de Log doPowerExchange atual. O Agente de Log do PowerExchange redefine essas contagens para zero, quandoo intervalo de espera especificado no parâmetro NO_DATA_WAIT2 do arquivo pwxccl.cfg expirar enenhum dado de alteração tiver sido recebido.

¨ Arquivo. As contagens dos registros de alteração para o conjunto atual dos arquivos de log doPowerExchange. O Agente de Log do PowerExchange redefine essas contagens para zero quando ocorreuma alternância de arquivos.

¨ Total. Número total de registros de alteração recebido pelo Agente de Log do PowerExchange desde queele inicializou. Essas contagens não são redefinidas para zero.


pwxcmd displayrecords {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]


A tabela a seguir descreve os argumentos e as opções do pwxcmd displayrecords:


-service-sv


-user-uid-u


-password-pwd-p


-epassword-e


Comando pwxcmd displaystatusExibe o status da subtarefa do Gravador do Agente de Log do PowerExchange.

Por exemplo, o comando pode relatar quando o Gravador estiver realizando o seguinte processamento:

¨ Inicializando

¨ Lendo ou esperando os dados de origem

¨ Gravando os dados de origem para um arquivo de log do Agente de Log do PowerExchange

¨ Inicializando um ponto de verificação

¨ Gravando informações para um arquivo de ponto de verificação

¨ Gravando registros do CDCT durante uma alternância de arquivo

¨ Concluindo a exclusão dos registros do CDCT expirados

¨ Desligamento


pwxcmd displaystatus {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd displaystatus:


-service-sv


-user-uid-u




-password-pwd-p

password Senha em texto simples.Se você especificar uma Identificação de usuário,também deve especificar uma senha em textosimples ou uma senha criptografada.

-epassword-e


Comando pwxcmd fileswitchFecha os arquivos abertos de log do Agente de Log do PowerExchange para Linux, UNIX e Windows e, emseguida, alterna para um novo conjunto de arquivos de log. Se os arquivos de log não tiverem qualquer dado,a alternância de arquivos não ocorre.

Você pode realizar uma alternância de arquivos automática antes da próxima alternância de arquivo a fim dedisponibilizar os dados alterados para o processo de extração. Se você executar extrações em modo deextração em lote, inclua um comando pwxcmd fileswitch no script e, em seguida, execute esse script, antesdas extrações em lotes.

Por exemplo, para extrair os dados alterados a cada hora dos arquivos de log do Agente de Log doPowerExchange, primeiro defina os parâmetros FILE_SWITCH_CRIT e FILE_SWITCH_VAL no arquivopwxccl.cfg, de tal modo que a alternância de arquivos não ocorra automaticamente antes da execução dasextrações. Por exemplo, você pode definir os parâmetros para realizar uma alternância de arquivo automáticaa cada 1.000.000 de atualizações de registro. Em seguida, inclua o comando pwxcmd fileswitch em um scriptque seja executado pouco antes dos processos de extração programados.

Nota: Normalmente, você não necessita realizar as alternâncias de arquivo manualmente, se utilizar o modode extração contínuo.


pwxcmd fileswitch {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A seguinte tabela descreve os argumentos e as opções do pwxcmd fileswitch:


-service-sv


-user-uid-u


-password-pwd-p


-epassword-e



Comando pwxcmd shutcondInterrompe o Agente de Log do PowerExchange para Linux, UNIX e Windows de modo controlado apósconcluir um ciclo de processamento final. O ciclo de processamento final habilita o Agente de Log doPowerExchange a capturar todas as alterações realizadas até o momento em que você emite o comando.

Sugestão: Use esse comando para interromper o Agente de Log do PowerExchange se um ciclo deprocessamento não tiver sido recentemente executado.

Após a conclusão do ciclo de processamento, o Agente de Log do PowerExchange realiza as seguintesações:


¨ Grava os dados para o arquivo do CDCT.


¨ Fecha o CAPI.





pwxcmd shutcond {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd shutcond:


-service-sv


-user-uid-u


-password-pwd-p


-epassword-e


Comando pwxcmd shutdownInterrompe o Agente de Log do PowerExchange para Linux, UNIX e Windows de modo controlado apósfechar os arquivos de log abertos do Agente de Log do PowerExchange e gravar a posição de reinicializaçãomais recente para os arquivos de ponto de verificação.

Durante o processamento do desligamento, o Agente de Log do PowerExchange conclui essas ações:


¨ Atualiza o arquivo do CDCT


¨ Fecha o CAPI.





Use esse comando para interromper um processo do Agente de Log do PowerExchange que está sendoexecutado em modo contínuo. A Informatica recomenda que você use o programa pwxcmd para emitir ocomando shutdown, em vez de informar o comando no prompt. Com o pwxcmd, você pode enviar o comandoa um processo do Agente de Log do PowerExchange que está sendo executado em modo de primeiro esegundo planos no mesmo sistema ou em um sistema diferente.

Se você executar o Agente de Log do PowerExchange em modo de lote, normalmente não precisa dessecomando. O processo do Agente de Log do PowerExchange é desligado após decorrido o período de esperaque você especifica no parâmetro NO_DATA_WAIT2 do pwxccl.cfg.


pwxcmd shutdown {-service|-sv} service_name [{-user|-uid|-u} user_ID] [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

A tabela a seguir descreve os argumentos e as opções do pwxcmd shutdown:


-service-sv


-user-uid-u


-password-pwd-p

password Senha em texto simples.Se você especificar uma Identificação de usuário,também deve especificar uma senha em textosimples ou uma senha criptografada.

-epassword-e


Outros Comandos pwxcmdUtilizando o programa pwxcmd, você pode emitir os comandos help e version.

Comando pwxcmd helpExibe a sintaxe para um comando. Se você omitir o nome do comando, o pwxcmd exibe a sintaxe para todosos comandos.


pwxcmd help [command]

A tabela a seguir descreve o argumento do pwxcmd help:

Argumento Description

command Nome do comando pwxcmd. Se você omitir o nome do comando, o pwxcmdexibe a sintaxe para todos os comandos.


Comando pwxcmd versionExibe a versão do PowerExchange e as informações de copyright e marca comercial da Informatica.


pwxcmd version

Outros Comandos pwxcmd 115

Í N D I C E

Aarquivos de script

comandos pwxcmd 99

Ccódigos de retorno

comandos pwxcmd 93Comando CONDENSE

Agente de Log do PowerExchange para Linux, UNIX e Windows 81Comando DISPLAY ALL 82Comando DISPLAY CHECKPOINTS 83Comando DISPLAY CPU 83Comando DISPLAY EVENTS 84Comando DISPLAY MEMORY 84Comando DISPLAY RECORDS 85Comando DISPLAY STATUS

Agente de Log do PowerExchange para Linux, UNIX e Windows 86Comando FILESWITCH

Agente de Log do PowerExchange para Linux, UNIX e Windows 87Comandos cmd_prefix, Agente

DISPLAY 37DRAIN 38LOGCLOSE 38LOGOPEN 39LOGSPIN 39REPCLOSE 40REPOPEN 40REPOSITORYDSN 40REPSTATUS 41RESUME 42SHUTDOWN 42START 43STOP 43

comandos cmd_prefix, ECCR do VSAM em lotesDISPLAY 7START 8STOP 8

Comandos de Mesclagem Pós-LogDISPLAY 75QUIT 75STATUS 75STOP 75TRACEE, TRACEL, TRACES 76

Comandos do agenteLOGSPIN 39

Comandos do AgenteDISPLAY 37DRAIN 38Inicializando o Agente do PowerExchange 37introdução 36LOGCLOSE 38LOGOPEN 39REPCLOSE 40REPOPEN 40REPOSITORYDSN 40REPSTATUS 41RESUME 42SHUTDOWN 42START 43STOP 43

Comandos do Agente de Log do PowerExchange para Linux, UNIX eWindows

CONDENSE 81DISPLAY ALL 82DISPLAY CHECKPOINTS 83DISPLAY CPU 83DISPLAY EVENTS 84DISPLAY MEMORY 84DISPLAY RECORDS 85DISPLAY STATUS 86FILESWITCH 87inicializando o Agente de Log 78introdução 77PWXCCL 78SHUTCOND 88SHUTDOWN 89

Comandos do Agente de Log do PowerExchange para MVSDEFINE_LOG 66DELETE_LOG 69DISPLAY OBJECT=CONNECTION 70DISPLAY OBJECT=LOG 71inicializando o Agente de Log do PowerExchange 66introdução 64PRINT 72regras e diretrizes 65RESOLVE_INDOUBT 73STOP, MVS 74

Comandos do Agente de Log para Linux, UNIX e WindowsCONDENSE 81DISPLAY ALL 82DISPLAY CHECKPOINTS 83DISPLAY CPU 83DISPLAY EVENTS 84DISPLAY MEMORY 84DISPLAY RECORDS 85DISPLAY STATUS 86FILESWITCH 87inicializando o Agente de Log 78introdução 77PWXCCL 78SHUTCOND 88SHUTDOWN 89

Comandos do Agente de Log para MVSDEFINE_LOG 66DELETE_LOG 69DISPLAY OBJECT=CONNECTION 70DISPLAY OBJECT=LOG 71inicializando o Agente de Log do PowerExchange 66introdução 64PRINT 72regras e diretrizes 65RESOLVE_INDOUBT 73STOP, MVS 74

Comandos do Agente do PowerExchangeDISPLAY 37DRAIN 38Inicializando o Agente do PowerExchange 37introdução 36LOGCLOSE 38LOGOPEN 39LOGSPIN 39REPCLOSE 40REPOPEN 40

116

REPOSITORYDSN 40REPSTATUS 41RESUME 42SHUTDOWN 42START 43STOP 43

Comandos do Alimentador de LogComando DEBUG do Datacom 14Comando STATUS do Datacom 15Comando TRACE do Datacom 15

Comandos do Alimentador de Log do DatacomDEBUG 14STATUS 15TRACE 15

comandos do Condensadoremitindo 47FILESWITCH 49inicializando o Condensador do PowerExchange 46interrompendo do Condensador do PowerExchange 47introdução 45SHUTCOND 50SHUTDOWN 51

Comandos do condensadorCONDENSE 48DISPLAY STATUS 48

Comandos do Condensador do PowerExchangeCONDENSE 48DISPLAY STATUS 48emitindo 47FILESWITCH 49inicializando o Condensador do PowerExchange 46interrompendo do Condensador do PowerExchange 47introdução 45SHUTCOND 50SHUTDOWN 51

Comandos do Controlador de AlteraçãoComando REFRESH do Datacom 14

Comandos do ECCRComandos do ECCR baseado em log do Adabas 3Comandos do ECCR baseado em log do IDMS 25Comandos do ECCR baseado em log do IMS 33Comandos do ECCR baseado em tabela do Datacom 16Comandos do ECCR do CICS/VSAM 9Comandos do ECCR do DB2 para z/OS 18Comandos do ECCR do VSAM em lotes 7Comandos do ECCR síncrono do Datacom 12Comandos do ECCR síncrono do IMS 28

Comandos do ECCR baseado em log do AdabasCLOSE 4DISPLAY TRACE 4inicializando o ECCR 3interrompendo o ECCR 4introdução 3STATUS 5TRACEOFF 5

Comandos do ECCR baseado em log do IDMSCLOSE 26DISPLAY TRACE 26inicializando o ECCR 25introdução 25STATUS 26TRACEOFF 27TRACEON 27

Comandos do ECCR baseado em log do IMSCLOSE 34DISPLAY TRACE 34inicializando o ECCR 33introdução 33TRACEOFF 34TRACEON 35

Comandos do ECCR baseado em tabela do Datacominicializando o ECCR 16interrompendo o ECCR 17introdução 16

Comandos do ECCR do CICS/VSAMDISPLAY 9

HELP 9INIT 10introdução 9TERM 10

Comandos do ECCR do DB2 para z/OSDISPLAY 20inicializando o ECCR 19interrompendo o ECCR 19introdução 18QUIESCE 22REFRESH 23TERM 23URID 24

Comandos do ECCR do VSAM em lotesDISPLAY 7introdução 7START 8STOP 8

Comandos do ECCR síncrono do DatacomComando DEBUG do Alimentador de Log 14Comando REFRESH do Controlador de Alteração 14Comando STATUS do Alimentador de Log 15Comando TRACE do Alimentador de Log 15Comandos do Alimentador de Log 14Comandos do Controlador de Alteração 14inicializando o ECCR 12interrompendo o Alimentador de Log 13Interrompendo o Controlador de Alteração. 13introdução 12

Comandos do ECCR síncrono do IMScomandos do subsistema externo 30DISPLAY SUBSYS 28introdução 28START SUBSYS 29STOP SUBSYS 29xEDP-ABORT 30xEDP-CONTINUE 31xEDP-STAT 31, 32

Comandos do OuvinteCLOSE 57CLOSE e CLOSE FORCE 57DISPLAY ACTIVE 59emitindo com DTLLSTSI 60inicializando o Ouvinte do PowerExchange 54introdução 53LISTTASK 59programa DTLLST 54STOPTASK 62

Comandos do Ouvinte do PowerExchangeCLOSE 57Comandos de interrupção 57DISPLAY ACTIVE 59DTLLSTSI 60introdução 53LISTTASK 59STOPTASK 62

Comandos do subsistema externo do IMS (/SSR)comandos do ECCR síncrono 30xEDP-ABORT 30xEDP-CONTINUE 31xEDP-STAT 31, 32

Comandos EDMCnos comandos do ECCR do CICS/VSAM 9

Comandos MODIFY (MVS)Comandos do Condensador do PowerExchange 47Comandos do ECCR baseado em log do Adabas 3Comandos do ECCR baseado em log do IDMS 25Comandos do ECCR baseado em log do IMS 33Comandos do ECCR do DB2 para z/OS 18Comandos do ECCR síncrono do Datacom 12

comandos pwxcmdarquivos de script 99códigos de retorno 93condense para o Agente de Log do PowerExchange 103, 106configuração para 94displaycheckpoints 108

Índice 117

displaycpu 108displayevents 109displaymemory 110displayrecords 110displaystatus 103displaystatus para o Agente de Log do PowerExchange 111exemplo 95–97fileswitch para o Agente de Log do PowerExchange 112fileswitch para o Condensador do PowerExchange 104introdução 91modo de linha de comando 98Ouvinte do PowerExchange, interrompendo 100, 101parâmetros 92shutcond para o Agente de Log do PowerExchange 113shutdown para o Agente de Log do PowerExchange 113shutdown para o Condensador do PowerExchange 105sintaxe 92Tarefa do Ouvinte do PowerExchange, interrompendo 102versão, exibindo 115

comandos SNDPWXCMD (i5/OS)Comandos do Condensador do PowerExchange 47

configurandoProcessos do PowerExchange para receberem os comandospwxcmd 94

Ddisplaystatus (pwxcmd)

visão geral 103

Eenviando

comandos pwxcmd para um processo do Agente de Log doPowerExchange para Linux, UNIX e Windows 97comandos pwxcmd para um processo do Condensador doPowerExchange 96

enviando comandos pwxcmdpara um Ouvinte do PowerExchange 95

Hhelp (pwxcmd)

descrição 114

Iinicializando

Serviço do Ouvinte do PowerExchange 56Instrução CMDNODE

Arquivo de configuração DBMOVER 94instrução CONDENSENAME

Arquivo de configuração ou membro CAPTPARM 94arquivo pwxccl.cfg 94

Instrução LISTENERArquivo de configuração DBMOVER 94

Instrução SVCNODEArquivo de configuração DBMOVER 94

Instruções DBMOVERCMDNODE 94LISTENER 94SVCNODE 94

interrompendoServiço do Ouvinte do PowerExchange 57

Llisttask (pwxcmd)

descrição 101, 105

Mmodo de linha de comando

comandos pwxcmd 98

OOuvinte do PowerExchange

enviando comandos pwxcmd para 95teste remoto 57

Pparâmetros

comandos pwxcmd 92prefixo de comando, AGENTCTL

Comandos do ECCR do VSAM em lotes 7nos comandos do Agente do PowerExchange 36

Processo do Agente de Log do PowerExchange para Linux, UNIX eWindows

enviando comandos pwxcmd para 91, 97Processo do Condensador do PowerExchange

enviando comandos pwxcmd para 91, 96Processo do Ouvinte do PowerExchange

enviando comandos pwxcmd para 91Processos do PowerExchange

Agente de Log do PowerExchange para Linux, UNIX e Windows 91Condensador do PowerExchange 91configurando para receber os comandos pwxcmd 94Ouvinte do PowerExchange 91

programa pwxcmdpara emitir os comandos pwxcmd 91

Scomandos /SSR

Comandos do subsistema externo do IMS para o ECCR síncronoaaa] 30

segurançacomandos pwxcmd, Linux, UNIX e Windows 98

Serviço do Ouvinte do PowerExchangeinicializando 56interrompendo 57

shutcond (pwxcmd)descrição 105

sintaxecomandos pwxcmd 92

SNDPWXCMDDISPLAY STATUS 48

Ttestando

serviço do Ouvinte do PowerExchange local 56teste

Ouvinte remoto do PowerExchange 57

Vversion (pwxcmd)

descrição 115

118 Índice

informatica powerexchange (versão 9.0.1) documentation...qualquer objetivo, com ou sem taxa, é...

Documents