instance
Especifica o valor da instância que é exibido no Navegador do PowerExchange para os grupos de registro ou extração. A tabela a seguir identifica o tipo de valor da instância por fonte de dados:
Fonte de Dados INSTÂNCIA
Adabas Valor DBID
DB2 para i5/OS Valor DBID no membro CAPTPARM do arquivo CFG
Datacom Nome MUF
DB2 para z/OS Id do Subsistema
IDMS Nome CV
IMS Identificador do sistema IMS
Microsoft SQL Server Nome do banco de dados especificado para o grupo de registro
Oracle Identificador de coleta da instrução ORACLEID no arquivo de configuração dbmover.cfg
DB2 para Linux, UNIX e Windows Nome do banco de dados especificado para o grupo de registro VSAM Nome da instância especificado para o grupo de registro
RSTTKN GENERATE
Gera tokens de reinicialização no fim atual do fluxo de mudança do aplicativo.
CAPTMETH=access_method
Especifica o método de acesso de captura:
¨ CAPXRT para modo de extração contínua ou em tempo real ¨ CAPX para modo de extração em lotes
Válido somente para Oracle, SQL Server e DB2 for Linux, UNIX e Windows CDC.
CONDTYPE=P
Especifica o tipo de condensação para o qual DTLUAPPL gera tokens de reinicialização:
¨ P para condensação parcial, que é o único tipo válido para as fontes de dados às quais esse parâmetro se aplica.
Válido somente para Oracle, SQL Server e DB2 for Linux, UNIX e Windows CDC.
JRN=library/journal
Substitui o diário especificado no registro de captura. Válido somente para DB2 for i5/OS CDC.
ORACOLL=collection_id
Substitui o identificador de coleta especificado no registro de captura. Válido somente para Oracle CDC.
ORACONN=connection
Substitui as informações de conexão do Oracle sobre um determinado ID de coleta do Oracle. Você pode usar um único conjunto de registros de captura de dados de várias instâncias do Oracle. Você pode especificar uma string de instância e/ou de conexão. Se um desses valores de parâmetro não for especificado, o PowerExchange usará o valor do outro parâmetro do arquivo de configuração. Válido somente para Oracle CDC.
ORAINST=instance
Substitui o nome da instância do Oracle com relação a um ID de coleta do Oracle específico. Você pode usar um único conjunto de registros de captura de dados para capturar dados de várias instâncias do Oracle. Válido somente para Oracle CDC.
ORASCHEMA=schema
Substitui o nome do esquema do Oracle. Válido somente para Oracle CDC.
UDBDB=database
Especifica o banco de dados de conexão quando este é diferente do banco de dados de registro. Válido somente for DB2 para Linux, UNIX e Windows CDC.
DB=library/table
Substitui a tabela especificada no registro de captura. Válido somente para DB2 for i5/OS CDC.
GENERATE
Gera tokens de reinicialização no fim atual do fluxo de mudança do registro de captura especificado.
registration_name
Especifica o nome do registro de captura. Faz distinção entre maiúsculas e minúsculas.
Executando o Utilitário DTLUAPPL no i5/OS
Use o seguinte comando para copiar os mapas de dados com base nas opções especificadas no membro padrão CFG/DTLUAPPL da biblioteca datalib atual:
SBMJOB CMD(CALL PGM(DTLLIB/DTLUAPPL)PARM('DATALIB/CFG(TKNPARMS)')) JOB(MYJOB) JOBD(DATALIB/DTLLIST) PRTDEV(*JOBD) OUTQ(*JOBD) CURLIB(DATALIB) INLLIBL(*JOBD)
Informe os parâmetros de controle do utilitário DTLUAPPL no membro CFG/TKNPARMS da biblioteca datalib.
Executando o Utilitário DTLUAPPL no Linux, UNIX e
Windows
O PowerExchange instala o DTLUAPPL no diretório base do PowerExchange. Informe as instruções de controle para o utilitário no arquivo DTLTKNP.TXT. Esse arquivo contém amostra de instruções.
A tabela a seguir descreve a sintaxe de comando para a execução do DTLUAPPL:
Comando Ação
dtluappl O DTLUAPPL presume que as instruções do utilitário estejam em dtltknp.txt e exibam a saída na janela de comando.
dtluappl > logname.txt O DTLUAPPL presume que as instruções do utilitário estejam em DTLTKNP.TXT e grava a saída em logname.txt.
dtluappl myfile.txt > logname.txt O DTLUAPPL lê as instruções do utilitário em myfile.txt e grava a saída em logname.txt.
Executando o Utilitário DTLUAPPL no z/OS
O PowerExchange oferece uma amostra da JCL do utilitário DTLUAPPL no membro DTLUAPPL da biblioteca RUNLIB. Personalize a JCL, conforme necessário, e depois submeta o trabalho.
A JCL inclui as seguintes instruções: //jobname JOB
//LIBSRCH JCLLIB ORDER=your.RUNLIB //INCS1 INCLUDE MEMBER=GENBULK //INCS3 INCLUDE MEMBER=GENCHNG //STEP1 EXEC PGM=DTLUAPPL
//STEPLIB DD DISP=SHR,DSN=&HLQ..LOADLIB // DD DISP=SHR,DSN=&HLQ..LOAD // DD DISP=SHR,DSN=&SCERUN //EDMPARMS DD DISP=SHR,DSN=&HLQEDM..&LOGGER&SUFFIX..USERLIB //SYSPRINT DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //EDMMSG DD SYSOUT=* //*** //SYSIN DD *
MOD APPL tokens DSN9 RSTTKN GENERATE ADD RSTTKN db2demo1
END APPL tokens PRINT APPL tokens /* //* //DTLAMCPR DD DSN=&HLQVS..CCT, // DISP=(SHR) //DTLCACDE DD DSN=&HLQVS..CDEP, // DISP=(SHR) //* //DTLMSG DD DSN=&HLQ..DTLMSG, // DISP=(SHR) //DTLOUT DD SYSOUT=* //DTLCFG DD DSN=&RUNLIB(DBMOVER), // DISP=(SHR) //DTLKEY DD DSN=&RUNLIB(LICENSE), // DISP=(SHR) //DTLLOG DD SYSOUT=* //DTLLOG01 DD SYSOUT=* //SYSPRINT DD SYSOUT=* As instruções da JCL são: JOB
Define o cartão de trabalho DTLUAPPL como MVS, incluindo o nome do trabalho.
EXEC PGM=DTLUAPPL
Identifica o nome do programa, DTLUAPPL, a ser chamado.
STEPLIB DD
Aponta para as bibliotecas LOADLIB e LOAD do PowerExchange e para a biblioteca de tempo de execução comum do Ambiente de Linguagem (LE).
EDMPARMS DD
Aponta para a biblioteca USERLIB, que contém as opções do módulo EDMSDIR usadas para se conectar ao Agente do PowerExchange e ao Agente de Log do PowerExchange que estão sendo usados.
SYSPRINT DD
Define um conjunto de dados SYSOUT no qual a saída do trabalho é impressa.
SYSUDUMP DD
Define um conjunto de dados SYSOUT para exibir dados que podem ser usados para diagnosticar problemas do DTLUAPPL.
EDMMSG DD
Define um conjunto de dados SYSOUT para mensagens do Agente de Log do PowerExchange, ECCRs, Agente do PowerExchange, API de Leitura de Log (LRAPI) e API de Gravação de Log (LWRAPI).
SYSIN DD
Define as instruções de controle de saída do utilitário DTLUAPPL. Você pode especificar as instruções de controle no fluxo ou apontar para um conjunto de dados no qual tenha definido as instruções de controle. O exemplo da JCL contém instruções em fluxo para adicionar um nome de aplicativo, especificar seus tokens de reinicialização e imprimir todos os nomes de aplicativos.
DTLAMCPR DD
Aponta para o conjunto de dados CCT, que contém os registros de captura.
DTLCACDE DD
Aponta para o conjunto de dados CDEP, que contém os nomes de aplicativos usados em processos de extração de dados alterados.
DTLMSG DD
Aponta para o conjunto de dados que contém as mensagens do PowerExchange.
DTLOUT DD
Define um conjunto de dados SYSOUT que contém as mensagens do utilitário DTLUAPPL.
DTLCFG DD
Aponta para o arquivo de configuração DBMOVER do PowerExchange.
DTLKEY DD
Aponta para o membro LICENSE do PowerExchange na biblioteca RUNLIB, que contém a chave de licença do PowerExchange.
DTLLOG DD
Define um conjunto de dados SYSOUT para registrar as mensagens do PowerExchange que reportam o status e os eventos de alguns processos e componentes do PowerExchange.
DTLLOG01 DD
Define um conjunto de dados SYSOUT para registrar as mensagens do PowerExchange que reportam o status e os eventos de alguns processos e componentes do PowerExchange.
Notas de Uso do Utilitário DTLUAPPL
Você pode combinar os comandos ADD/MOD e PRINT em uma única solicitação. Por exemplo: ADD APPL IMSAPP1 IMS1 rsttkn GENERATE
add rsttkn d002long sequence 00000A036E160000000000000A036BAA00000000 RESTART AAAAAAAA4040000000002BA700000000 add rsttkn d002root SEQUENCE 00000A036E160000000000000A036BBBB0000000 RESTART AAAAAAAA4040000000002BA700000000 add rsttkn d003root add rsttkn d008addr add rsttkn d008pay add rsttkn d008skil SEQUENCE 00000A036E160000000000000A036CCC00000000 RESTART AAAAAAAA4040000000002BA700000000 END IMSAPP1
PRINT APPL ALL
Exemplos do Utilitário DTLUAPPL
Os exemplos a seguir mostram como usar o utilitário DTLUAPPL para executar várias tarefas.
Gerando Tokens de Reinicialização no Nível de Aplicativo
Esse exemplo gera tokens de reinicialização para o registro de origem DB2DEMO1 usando um nome de aplicativo de tokens e, em seguida, imprime os tokens de reinicialização gerados. Ao usar o Cliente
PowerExchange do PowerCenter, os tokens de reinicialização gerados pelo DTLUAPPL podem ser adicionados ao arquivo do token especificado na conexão do aplicativo para a extração.
UID user1 EPWD CDFB2EE51CFC16C7 ADD APPL tokens DSN7 RSTTKN GENERATE ADD RSTTKN db2demo1
END APPL tokens
PRINT APPL tokens
Gerando Tokens de Reinicialização no Nível de Registro de Captura
Esse exemplo gera tokens de reinicialização para o registro de origem DB2DEMO1 usando um nome de aplicativo de tokens e, em seguida, imprime os tokens de reinicialização gerados.
Ao usar o Cliente PowerExchange do PowerCenter, os tokens de reinicialização gerados pelo DTLUAPPL podem ser adicionados ao arquivo do token especificado na conexão do aplicativo para a extração.
MOD APPL tokens DSN7
ADD RSTTKN db2demo1 GENERATE END APPL tokens
PRINT APPL tokens
Gerando Tokens de Reinicialização para Modo de Extração
Contínua
Nesse exemplo, um aplicativo existente chamado dummy é usado para gerar tokens de reinicialização para o registro rrtb001 na instância FOX920. A CAPI_CONNECTION padrão no dbmover.cfg é substituída por uma CAPX CAPI_CONNECTION chamada CAPXORA. O método de captura é CAPXRT e o tipo de condensação é P para parcial.
O DTLUAPPL usa esses parâmetros para gerar os tokens de reinicialização com o formato necessário para o modo de extração contínua do Oracle de arquivos condensados. O DTLUAPPL gera tokens de reinicialização para o modo de extração contínua quando a instrução CAPI_CONNECTION usada é TYPE=CAPX e
CAPTMETH=CAPXRT. Os tokens de reinicialização gerados são impressos. UID user01 EPWD 40ABC4B0E32FD99F CONN_OVR CAPXORA
MOD APPL dummy FOX920 RSTTKN GENERATE CAPTMETH=CAPXRT CONDTYPE=P MOD RSTTKN rrtb001
END APPL dummy PRINT APPL dummy
Adicionando um Aplicativo com Tokens de Reinicialização
Neste exemplo, um aplicativo IMSAPP1 é adicionado com os registros de captura d002long, d002root, d003root e d008addr. Os tokens de reinicialização são especificados para d002long e d002root. O registro de captura d003root é adicionado sem nenhum token de reinicialização. Os tokens de reinicialização do registro de captura d008addr são gerados por DTLUAPPL e adicionados ao arquivo CDEP.
Somente usuários ODBC precisam adicionar todos os registros de captura em um aplicativo usado para extrair dados alterados. Com as extrações do ODBC, os tokens de reinicialização são armazenados no arquivo CDEP. Ao usar o Cliente PowerExchange do PowerCenter para extrair dados alterados, adicione os novos registros de captura e seus tokens de reinicialização associados ao arquivo de token de reinicialização especificado na conexão do aplicativo para a extração.
ADD APPL IMSAPP1 IMS1 ADD RSTTKN d002long SEQUENCE 00000A036E160000000000000A036BAA00000000 RESTART AAAAAAAA4040000000002BA70000000 ADD RSTTKN d002root SEQUENCE 00000A036E160000000000000A036BBBB0000000 RESTART AAAAAAAA4040000000002BA700000000 ADD RSTTKN d003root
ADD RSTTKN d008addr GENERATE
Adicionando um Aplicativo e Gerando Tokens de Reinicialização em
uma Instância Remota
Este exemplo adiciona o aplicativo ORAAPP3 na instância remota ORACLEID do Oracle e gera tokens de reinicialização do registro de origem oraemp2 no nível de aplicativo:
ADD APPL ORAAPP3 ORACLEID RSTTKN GENERATE ORACONN=OCONN ORAINST=OINST ORACOLL=OCOLL ADD RSTTKN oraemp2
END APPL ORAAPP3
Modificando Tokens de Reinicialização em um Aplicativo
Este exemplo mostra o aplicativo MOD e as palavras-chave do token de reinicialização MOD que estão sendo usados. Os tokens de reinicialização para o registro d002long no aplicativo IMSAPP1 são alterados para os novos valores fornecidos.
MOD APPL IMSAPP1 IMS1 MOD RSTTKN d002long
SEQUENCE 000000032D4500000000000000032D4500000000 RESTART C4D6C3D34040000000032CBD00000000 END APPL IMSAPP1
Modificando um Aplicativo e Adicionando um Registro
Esse exemplo mostra como adicionar um novo registro de captura, d003long, com tokens de reinicialização ao aplicativo existente IMSAPP1. Use ADD RSTTKN ao adicionar novos registros de captura a um nome de aplicativo de extração existente. Essa ação só é necessária ao usar o ODBC para extrair dados alterados, visto que os tokens de reinicialização são armazenados no arquivo CDEP. Ao usar o Cliente PowerExchange do PowerCenter para extrair dados alterados, adicione os novos registros de captura e seus tokens de
reinicialização associados ao arquivo de token de reinicialização especificado na conexão do aplicativo para a extração.
MOD APPL IMSAPP1 IMS1 ADD RSTTKN d003long
SEQUENCE 000000032D4500000000000000032D4500000000 RESTART C4D6C3D34040000000032CBD00000000 END APPL IMSAPP1
Imprimindo um Aplicativo
O DTLUAPPL pode imprimir um aplicativo especificado ou todos os aplicativos. PRINT APPL {application_name|ALL}
Você pode imprimir mais de um aplicativo concatenando diversas instruções PRINT APPL ou usando a palavra- chave ALL.
Este exemplo gera a seguinte saída:
Application name=<DB2APPL5> Rsttkn=<2> Ainseq=<0> Preconfig=<N> FirstTkn =<>
LastTkn =<> CurrentTkn=<>
Registration name=<db2v52c.1> tag=<DB2DSN1db2v52c1>
Sequence=<000000035D5000000000000000035D5000000000> Restart =<C4D6C3D34040000000035CC800000000> Registration name=<db2tst5c.1> tag=<DB2DSN1db2tst5c1>
Sequence=<000000035D5000000000000000035D5000000000> Restart =<C4D6C3D34040000000035CC800000000>
O exemplo a seguir mostra um aplicativo que foi adicionado, mas nenhuma extração foi executada ainda. Quando dados forem extraídos, o formato mudará para o seguinte:
Application name=<DB2APPL1> Rsttkn=<1> Ainseq=<0> Preconfig=<N> FirstTkn =<C4D6C3D340400000000335D000000000> LastTkn =<C4D6C3D3404000000003453E00000000> CurrentTkn=<>
Registration name=<db2v52c.1> tag=<DB2DSN1db2v52c1> Sequence=<0000000319140000000000000003191400000000> Restart=<4D6C3D3404000000003188C00000000>
A tabela a seguir descreve o conteúdo dos campos:
Campo Descrição
Rsttkn Número de RSTTKNs que existem no aplicativo. Ainseq Campo somente para uso interno.
Preconfig Não usado no momento.
FirstTkn Token de reinicialização para a primeira execução bem-sucedida do aplicativo, se usando ODBC. LastTkn Token de reinicialização para a última execução bem-sucedida do aplicativo, se usando ODBC. CurrentTkn Token de reinicialização para a execução ativa atual ou a última execução falha do aplicativo, se
usando ODBC.
Nota: Em caso de uso do ODBC para extração, você também poderá exibir os tokens mostrados na saída
impressa, na caixa de diálogo Extrair Aplicativo do Navegador do PowerExchange.
T
ÓPICOSR
ELACIONADOS:
¨ “Instruções de Entrada de Aplicativo para o Utilitário DTLUAPPL” na página 26
CA P Í T U L O
7
DTLUCBRG - Utilitário de Registro
em Lotes
Este capítulo inclui os seguintes tópicos: ¨ Visão Geral do Utilitário DTLUCBRG, 34
¨ Sistemas Operacionais Suportados para o Utilitário DTLUCBRG , 34 ¨ Parâmetros do Utilitário DTLUCBRG, 35
¨ Processamento de Página de Código DTLUCBRG, 41 ¨ Executando o Utilitário DTLUCBRG, 42
¨ Notas de Uso do Utilitário DTLUCBRG, 45
Visão Geral do Utilitário DTLUCBRG
Muitos clientes que usam a captura de dados alterados em ambientes de produção precisam registrar centenas de tabelas de captura. Usar o Navegador do PowerExchange para criar e gerenciar grandes números de registros não é prático. O utilitário DTLUCBRG permite que você crie e gerencie registros em massa. Esse utilitário pode executar as seguintes tarefas:
¨ Adiciona registros de captura e mapas de extração. O utilitário cria registros e mapas de extração em determinadas localizações do Ouvinte do PowerExchange para um conjunto de tabelas ou mapas de dados. Você pode usar uma máscara para limitar os registros criados.
¨ Modifica registros inativos ou ativos.
¨ Executa um teste de execução para relatar o escopo dos registros antes de criá-los.
¨ Para origens do Microsoft SQL Server, altera o status de vários registros em uma operação e também exclui e recria as publicações do SQL Server. Esse recurso é útil se você precisar redefinir o status de vários registros ou se precisar recriar os registros e regenerar publicações porque fez alterações de DDL em um grande número de tabelas.
Nota: O DTLUCBRG cria todos os registros com uma versão de 1. O utilitário não pode definir o status de registro
para histórico e, em seguida, cria uma versão subsequentes do registro.
Sistemas Operacionais Suportados para o Utilitário
DTLUCBRG
O DTLUCBRG está disponível nos seguintes sistemas operacionais: ¨ i5/OS
¨ Linux ¨ UNIX ¨ Windows ¨ z/OS
Você pode criar registros em outras plataformas usando os Ouvintes do PowerExchange.
Parâmetros do Utilitário DTLUCBRG
Esta seção descreve os parâmetros DTLUCBRG.Os parâmetros são fornecidos nas seguintes localizações:
¨ No i5/OS, os parâmetros são definidos em um arquivo que você especificar na linha de comando. ¨ No Linux, UNIX e Windows, os parâmetros são definidos no arquivo dtlucbrg.txt. O diretório do qual você
executa o DTLUCBRG deve incluir esse arquivo. ¨ No z/OS, os parâmetros são definidos no SYSIN da JCL.
A tabela a seguir descreve os parâmetros DTLUCBRG. Não é necessário especificar parâmetros que tenham valores padrão.
Parâmetro Padrão Descrição
CONDTYPE Especifique a opção de condensação para usar para os registros de captura. As opções são:
- Completo. Essa opção está disponível se você usar o Condensador do
PowerExchange em i5/OS ou z/OS. O PowerExchange acumula dados alterados em arquivos condensados de chave. Como as alterações mais recentes substituem as anteriores, essa opção de condensação não mantém a consistência transacional. Além disso, as seguintes limitações se aplicam: 1) Adabas e fontes de dados CDC baseado em log IDMS não são suportados. 2) no z/OS, as fontes de dados devem ter colunas de chave. O comprimento total de todas as colunas de chave para uma origem não pode exceder 250 bytes. 3) no i5/OS, tabelas de origem deve ter as chaves primárias ou arquivos DDS deveser definidas com uma chave exclusiva. - PART. Essa opção está disponível se você usar o Condensador do
PowerExchange no i5/OS ou z/OS ou o Agente de Log do PowerExchange para Linux, UNIX ou Windows. Alterações em UOWs confirmados com sucesso são gravadas em arquivos condensados ou arquivos de log do Agente de Log do PowerExchange, em ordem cronológica baseada na hora de término do UOW. O PowerExchange grava todas as alterações para as colunas de interesse, não apenas as alterações mais recentes. Esse tipo de condensação mantém a consistência transacional.
- NENHUMA Registros de captura não são elegíveis para o processamento de
condensação total ou parcial.
Para obter mais informações, consulte Guia do Usuário do Navegador do
PowerExchange ou guias do CDC do PowerExchange.
CRGNAME Especifique um nome de registro de captura. Esse valor pode ter até 13 caracteres alfanuméricos e não pode começar com número. O PowerExchange usa esse valor como o nome de registro completo. Como o PowerExchange não anexa um número exclusivo, como no caso do CRGPREFIX, é possível usar CRGNAME para substituir registros perdidos ou danificados ou para gerar registros em seus nomes originais.
Não usar CRGNAME em qualquer uma das seguintes circunstâncias: - O parâmetro TABLE especifica uma máscara que contém o caractere curinga
asterisco (*). Para usar CRGNAME, o nome da tabela deve ser explícita especificada da mesma maneira como ao registrar a tabela.
- O parâmetro REUSECRGNAME está definido como Y.
- O parâmetro CRGPREFIX foi especificado. Você deve especificar o CRGPREFIX ou CRGNAME, mas não especificar ambos.
Parâmetro Padrão Descrição
CRGPREFIX Especifique um prefixo de um a quatro caracteres. O PowerExchange anexa um número sequencial de 4 dígitos para esse valor para formar cada nome de registro.
Como um número sequencial é anexado, cada nome de registro é exclusivo. Para substituir um registro sob o nome anterior, você deve usar o parâmetro CRGNAME, em vez do parâmetro CRGPREFIX.
O nome de registro pode ter qualquer um dos seguintes formatos:
xnnnn xxnnnn xxxnnnn xxxxnnnn
Onde:
- x. O valor atribuído por CRGPREFIX. Os caracteres permitidos para o primeiro x vão de a a z. Os caracteres subsequentes permitidos vão de a a z e de 0 a 9.
- nnnn. Um número sequencial que começa com 0001.