Sumário

Search

  1. Prefácio
  2. Introdução ao PowerExchange
  3. Arquivo de Configuração DBMOVER
  4. Trabalhos Netport
  5. Logs de Mensagens do PowerExchange e Substituições de Destinos
  6. Log de estatísticas do SMF e Relatórios
  7. Segurança do PowerExchange
  8. Suporte a Secure Sockets Layer
  9. Segurança de Rede Alternativa do PowerExchange
  10. SQL Não Relacional do PowerExchange
  11. Metadados DTLDESCRIBE
  12. Globalização do PowerExchange
  13. Usando os Drivers ODBC do PowerExchange
  14. Tipos de Dados e Matriz de Conversão do PowerExchange
  15. Apêndice A: Carimbos de Data/Hora DTL__CAPXTIMESTAMP
  16. Apêndice B: Glossário do PowerExchange

Manual de Referência

Manual de Referência

Instrução CAPI_CONNECTION - CAPX

Instrução CAPI_CONNECTION - CAPX

A instrução CAPX CAPI_CONNECTION especifica um conjunto nomeado de parâmetros que a API (CAPI) de Consumo usa na extração contínua de dados alterados dos arquivos de log do Agente de Log do PowerExchange para Linux, UNIX e Windows.
Linux, UNIX e Windows
Sim para o modo de extração contínua
CAPI_CONNECTION=([DLLTRACE=
trace_id
]   ,NAME=
capi_connection_name
  [,TRACE=
trace_name
]   ,TYPE=(CAPX     ,DFLTINST=
instance_name
   [,FILEWAIT={
seconds
|
1
}] [,NOSEQVAL={
N
|Y}]    [,RSTRADV=
seconds
] [,RSTRANMODE={
N
|Y}] [,VALIDATEREGS={
N
|Y}]    ) )
DLLTRACE=
trace_id
Opcional. Nome definido pelo usuário da instrução TRACE que ativa o rastreamento de DLL interno para essa CAPI. Especifique esse parâmetro apenas sob a orientação do Suporte Global a Clientes da Informatica.
NAME=
capi_connection_name
Obrigatório. Nome exclusivo definido pelo usuário para essa instrução CAPI_CONNECTION.
O tamanho máximo é de oito caracteres alfanuméricos.
TRACE=
trace_name
Opcional. Nome definido pelo usuário da instrução TRACE que ativa o rastreamento de CAPI comum. Especifique esse parâmetro apenas sob a orientação do Suporte Global a Clientes da Informatica.
TYPE=(CAPX, ... )
Obrigatório. Tipo de instrução CAPI_CONNECTION. Para o modo de extração contínua, esse valor deve ser CAPX.
DFLTINST=
nome_da_instância
Obrigatório. Um identificador de instância de origem especificado para o grupo de registro. Esse valor deve corresponder ao valor DBID especificado no arquivo de configuração do Agente de Log do PowerExchange.
Para determinar esse valor, visualize as propriedades do grupo de registro no Navegador do PowerExchange. Dependendo do tipo de origem, insira um dos seguintes valores:
  • Para o Adabas, DB2 para i (i5/OS), DB2 for z/OS, MySQL, Oracle, PostgreSQL e VSAM, insira o nome que é exibido no campo
    Instância
    do grupo de registro no
    Inspetor de Recursos
    .
  • Para o Datacom, digite o nome do Multi-User Facility (MUF) que é exibido no campo
    Nome do MUF
    do grupo de registro no Inspetor de rRecursos.
  • Para uma origem do DB2 para Linux, UNIX ou Windows, insira o nome do banco de dados no campo
    Banco de Dados
    .
  • Para uma origem baseada em log do IDMS, insira o nome do LOGSID que é exibido no campo
    Logsid
    do grupo de registro no Inspetor de rRecursos. Esse valor também corresponde ao valor da instrução LOGSID no arquivo de configuração DBMOVER.
  • Para uma origem do IMS, insira o identificador RECON para o banco de dados no campo
    ID RECON
    .
  • Para o Microsoft SQL Server, esse valor depende de você especificar os parâmetros DISTSRV e DISTDB opcionais no arquivo de configuração do Agente de Log do PowerExchange:
    • Se você especificar os parâmetros DISTSRV e DISTDB, insira o nome DBID usado como identificador de coleta para todos os registros. Esse nome substitui o nome da instância que está associada aos registros individuais.
    • Se você não especificar os parâmetros DISTSRV e DISTDB, insira o valor que o Navegador do PowerExchange gera e exibe no
      campo
      da instância do
      Inspetor de Recursos
      para o grupo de registro. O valor gerado é formado pelos quatro primeiros caracteres do nome do banco de dados, seguidos de um número gerado, que começa em 000.
O tamanho máximo é de oito caracteres alfanuméricos.
FILEWAIT={
seconds
|
1
}
Opcional. O número de segundos que o PowerExchange aguarda antes de verificar se há novos arquivos de log do Agente de Log do PowerExchange.
Para a variável
seconds
, digite um número de 1 a 86400. O padrão é 1.
NOSEQVAL={
N
|Y}
Opcional. Se você receber a mensagem de erro PWX-36944 depois de iniciar uma sessão do CDC, o token de sequência que o PWXPC passou para o PowerExchange será anterior ao token de sequência que é gravado no arquivo CDCT do Agente de Log do PowerExchange. Se você quiser que a sessão continue e puder tolerar alguma perda de dados, poderá definir esse parâmetro como Y. O Leitor de Logs começará a extrair os dados mais recentes disponíveis nos arquivos de log. Com o valor padrão de N, a sessão falha.
RSTRADV=
seconds
Opcional. O intervalo de tempo, em segundos, que o PowerExchange aguarda antes de antecipar os tokens de reinicialização e de sequência para uma fonte de dados registrada durante os períodos nos quais os UOWs não contêm alterações de interesse do CDC de uma fonte de dados. Quando o intervalo de espera termina, o PowerExchange retorna o próximo "UOW vazio" confirmado, que inclui apenas informações atualizadas de reinicialização.
Para a variável
seconds
, digite um número de 0 a 86400. Nenhum valor padrão é especificado. Um valor 0 faz com que o PowerExchange retorne um UOW vazio após cada UOW processado. Consequentemente, um valor 0 pode diminuir o desempenho.
O PowerExchange zera o intervalo de espera quando um dos seguintes eventos ocorre:
  • O PowerExchange conclui o processamento de um UOW que inclui alterações de interesse do CDC.
  • O PowerExchange retorna um "UOW vazio" porque o intervalo de espera RSTRADV terminou sem o recebimento de quaisquer novas alterações de interesse do CDC.
Por exemplo, se você especificar 5, o PowerExchange aguardará cinco segundos após a conclusão do processamento do último UOW ou após o término do intervalo RSTRADV anterior. Em seguida, o PowerExchange retornará o próximo "UOW vazio" confirmado que inclui informações atualizadas de reinicialização e zera o intervalo de espera.
Se você especificar o parâmetro RSTRADV com qualquer valor válido, o PowerExchange sempre antecipará os tokens de reinicialização e de sequência quando o Leitor de Log atingir o fim de um arquivo de log do Agente de Log, mesmo se o intervalo RSTRADV não terminar. Esse comportamento garantirá que os tokens de reinicialização e de sequência sejam antecipados, mesmo quando o tempo de execução da sessão do CDC for menor do que o intervalo RSTRADV. Essa situação provavelmente ocorrerá se você tiver tabelas de origem que tenham um baixo nível de atividade de atualização.
Se você não especificar RSTRADV, o PowerExchange não antecipará os tokens de reinicialização e sequência para uma fonte registrada, durante os períodos em que ele não receber alterações de interesse. Nesse caso, quando o PowerExchange é inicializado a quente, ele lê todas as alterações, mesmo àquelas que não são de interesse do CDC, do ponto de reinicialização.
Nas origens DB2 para i5/OS, a Informatica recomenda que você use esse parâmetro se os registros de alterações lidos pelo PowerExchange dos destinatários do diário do i5/OS forem criados sob controle de confirmação. Se os registros de alterações forem criados sem controle de confirmação, não especifique esse parâmetro.
RSTRANMODE={
N
|Y}
Opcional. Se você estiver migrando do modo de extração em tempo real para o modo de extração contínua nas sessões do CDC que não tenham usado anteriormente o Agente de Log do PowerExchange para Linux, UNIX e Windows, defina esse parâmetro como Y. Essa definição permite que o PowerExchange converta as informações de token de reinicialização no formato que o Agente de Log do PowerExchange exige, quando as sessões do CDC são executadas. Mantenha a definição Y até que o PowerExchange conclua a conversão dos tokens de reinicialização para todas as tabelas de origem registradas e todas as sessões do CDC que usam essa CAPX CAPI_CONNECTION. Em seguida, defina esse parâmetro como N ou exclua-o. O padrão é N.
VALIDATEREGS={
N
|Y}
Opcional. Controla se a extração de dados do Agente de Log do PowerExchange para Linux, UNIX e Windows do PowerExchange termina ou continua se detectar uma entrada de origem na lista de interesses do CDC para a qual o Agente de Log do PowerExchange
não
está capturando dados alterados. Nessa situação, o processo de extração emite a mensagem PWX-36947, como mensagem de erro ou mensagem informativa.
As opções são:
  • Y
    . O processo de extração do Agente de Log do PowerExchange emite a mensagem PWX-36947 como uma mensagem de erro e, em seguida, termina.
  • N
    . O processo de extração do Agente de Log do PowerExchange emite a mensagem PWX-36947 como uma mensagem informativa e continua o processamento.
O padrão é N.