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. Globalização do PowerExchange
  12. Usando os Drivers ODBC do PowerExchange
  13. Tipos de Dados e Matriz de Conversão do PowerExchange
  14. Carimbos de Data/Hora DTL__CAPXTIMESTAMP
  15. Glossário do PowerExchange

Manual de Referência

Manual de Referência

Instrução CAPI_CONNECTION - AS4J

Instrução CAPI_CONNECTION - AS4J

A instrução AS4J CAPI_CONNECTION especifica um conjunto denominado de parâmetros que a API (CAPI) de Consumo usa para conectar-se com o fluxo de mudança e controlar o processamento do CDC para fontes CDC do DB2 para i (i5/OS).
IBM i (antigo i5/OS)
DB2 para i
CAPI_CONNECTION - UOWC, AS400EVENTMSGQ, AS400USRJRNCODE
Sim para o CDC do DB2 para i
CAPI_CONNECTION=([DLLTRACE=
trace_id
]   ,NAME=
capi_connection_name
  [,TRACE=
trace_name
]   ,TYPE=(AS4J      [,ALWCLRPFM={
N
|Y}] [,ALWLIBRFSH={
N
|Y}] [,ALWNONRENT={
N
|Y}]     [,ALWPARTIAL={
N
|Y}]     [,AS4JRNEXIT={
N
|Y}]     [,EOF={
N
|Y}]     ,INST=
instance_name
    ,JOURNAL=
library/journal_name
   [,LIBASUSER={
N
|Y|M|P}]     [,NOCCUOWSZ=
uow_size
]     [,POLWAIT={
seconds
|
10
}]     [,STOPIT=({
CONT
|TERM} ,
number_exceptions
|
5
)] [,UOWRSTANY={
Y
|N}] ) )
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=(AS4J, ... )
Obrigatório. Tipo de instrução CAPI_CONNECTION. Nas origens DB2 para i5/OS, esse valor deve ser AS4J.
ALWCLRPFM= {
N
|Y}
Opcional. Controla se o processamento do CDC do DB2 para i é interrompido ou continua quando o PowerExchange encontra alterações resultantes de um comando Clear Physical File Member (CLRPFM) do i5/OS ou uma instrução SQL TRUNCATE emitida em relação a uma tabela do DB2 registrada para captura de dados alterados. O PowerExchange não pode capturar as exclusões resultantes de um comando CLRPFM ou uma instrução TRUNCATE.
O IBM i versão 7.2 apresentou compatibilidade com as operações SQL TRUNCATE nas tabelas do i5/OS. Se você tiver uma versão anterior do IBM i, esse parâmetro pertencerá somente aos comandos do CLRPFM.
Insira uma das seguintes opções:
  • N
    . O processamento do CDC do PowerExchange será interrompido quando o PowerExchange detectar alterações causadas por um comando CLRPFM ou uma instrução TRUNCATE.
  • Y
    . O PowerExchange ignora o comando CLRPFM ou a instrução TRUNCATE e continua o processamento do CDC. A integridade de dados do destino do CDC pode ser danificada. Se você também especificar a instrução AS400EVENTMSGQ no arquivo de configuração DBMOVER, o PowerExchange emitirá a mensagem DTL3002 para a fila de mensagens especificada quando ele encontrar uma entrada de diário para um comando CLRPFM ou uma instrução TRUNCATE.
    Se você definir esse parâmetro como Y, a integridade de dados dos destinos do CDC poderá ser danificada. Especifique esse parâmetro apenas sob a orientação do Suporte Global a Clientes da Informatica.
    Se você também especificar uma fila de mensagens no parâmetro AS400EVENTMSGQ do arquivo DBMOVER, o PowerExchange gravará a mensagem DTL3002 na fila caso encontre uma entrada de diário para um comando CLRPFM ou uma instrução TRUNCATE.
O padrão é N.
ALWLIBRFSH={
N
|Y}
Opcional. Controla se você pode atualizar a lista de interesse do CDC após adicionar ou excluir bibliotecas do com instâncias da mesma tabela de origem do DB2, sem interromper e reiniciar sessões do CDC em tempo real. Esse parâmetro é útil na seguinte situação: 1) você tem instâncias da mesma tabela de origem do DB2 (ou arquivo) em várias bibliotecas, 2) as instâncias da tabela são lançadas no mesmo diário e 3) você adiciona ou exclui diariamente bibliotecas que contêm uma instância da tabela. As opções são:
  • N
    . Desabilita o processamento de atualização da lista de interesse do CDC para adições ou exclusões de biblioteca. Se você adicionar bibliotecas, o PowerExchange não iniciará a captura de dados alterados para essas bibliotecas até que você interrompa e reinicie a sessão do CDC. Nesse caso, algumas alterações poderão ser perdidas. Se você excluir bibliotecas, a sessão do CDC será encerrada de forma anormal.
  • Y
    . Permite que você use o comando SNDPWXJRNE para atualizar a lista de interesse do CDC para adições e exclusões da biblioteca. O comando envia entradas do diário para solicitações de adicionar biblioteca e excluir biblioteca para o diário, usando os códigos de tipo de entrada de diário padrão do PowerExchange ou os códigos exclusivos que você define na instrução AS400USRJRNCODE. No PowerCenter, você deve especificar o caractere curinga asterisco (*) para o nome da biblioteca na propriedade de sessão
    Substituição de Arquivo/Biblioteca
    para a sessão em tempo real.
    Se você também especificar uma fila de mensagens no parâmetro AS400EVENTMSGQ do arquivo DBMOVER, o PowerExchange gravará na fila a mensagem DTL3003I para um evento *ADDLIB (adicionar biblioteca) e a mensagem DTL3004I para um evento *DLTLIB (excluir biblioteca).
O padrão é N.
ALWNONRENT={
N
|Y}
Opcional. Controla se o PowerExchange gera uma próxima entrada do diário de receptor (NR) quando o i5/OS não fornece uma no destinatário do diário. O PowerExchange exige uma entrada de NR para alternar para o próximo destinatário do diário na cadeia quando o atual fica cheio. No entanto, o i5/OS pode não fornecer uma entrada de NR em determinadas condições, como quando um alto nível de atividade de transação estiver ocorrendo no momento em que for necessário alternar um destinatário do diário. Se o i5/OS não fornecer uma entrada de NR, o processamento do PowerExchange CDC será encerrado, a menos que você ative o PowerExchange para gerar uma entrada de NR. As opções são:
  • N
    . Não gera uma entrada de NR. Se o sistema i não fornecer uma entrada de NR, o processamento do CDC será encerrado de forma anormal.
  • Y
    . Gera uma entrada de NR para que o processamento do CDC possa continuar quando o sistema i não fornecer uma entrada de NR. A entrada de NR gerada é somente para uso interno do PowerExchange e não é gravada no destinatário do diário vigente.
O padrão é N.
ALWPARTIAL={
N
|Y}
Opcional. Controla se o PowerExchange processa os destinatários do diário em status parcial.
Insira uma das seguintes opções:
  • N
    . O PowerExchange fará com que o processamento falhe se um destinatário do diário estiver no status parcial.
  • Y
    . O PowerExchange processa os destinatários do diário em status parcial.
O padrão é N.
Se você especificar Y para esse parâmetro, poderá comprometer a integridade dos dados alterados que estão sendo extraídos, visto que alterações obrigatórias poderão estar indisponíveis. Especifique esse parâmetro apenas sob a orientação do Suporte Global a Clientes da Informatica.
AS4JRNEXIT={
N
|Y}
Opcional. Controla se o PowerExchange usa um programa de saída instalado no ponto de saída Excluir Destinatário do Diário, QIBM_QJO_DLT_JRNRCV, para evitar a exclusão dos destinatários do diário que estão sendo processados para o CDC.
Insira uma das seguintes opções:
  • N
    . O PowerExchange não bloqueia os destinatários do diário que ele está processando.
  • Y
    . O PowerExchange bloqueia todo destinatário do diário que ele está processando para que o destinatário não possa ser excluído do sistema i O PowerExchange registra os destinatários do diário que ele está processando em um arquivo de bloqueio chamado PWXJRNLCKP na biblioteca CONDLIB. Quando o PowerExchange alterna para o próximo destinatário do diário na cadeia, ele remove do arquivo de bloqueio o registro do destinatário do diário anterior.
    Se você também especificar uma fila de mensagens no parâmetro AS400EVENTMSGQ do arquivo DBMOVER, o PowerExchange gravará a mensagem DTL3001 na fila especificada para cada destinatário do diário que uma extração de dados alterados processa com êxito.
O padrão é N.
EOF={
N
|Y}
Opcional. Controla se o PowerExchange interrompe as extrações de dados alterados quando o fim do arquivo (EOL) é atingido.
Como esse parâmetro afeta todos os usuários da instrução AS4J CAPI_CONNECTION, a Informatica recomenda que você use um dos seguintes métodos alternativos para interromper extrações de dados alterados no EOL:
  • Nas sessões do CDC que usam o modo de extração em tempo real, especifique 0 para o atributo
    Tempo Inativo
    da conexão do aplicativo PWX DB2i5OS CDC em Tempo Real.
  • No Condensador do PowerExchange, especifique 1 para a instrução COLL_END_LOG no membro de configuração CAPTPARM.
  • Nas sessões do CDC que usam conexões ODBC, especifique 0 para o parâmetro WAITTIME na fonte de dados ODBC.
Se você usar o parâmetro EOF, digite uma das seguintes opções:
  • N
    . O PowerExchange não interrompe extrações de dados alterados quando o EOL é atingido.
  • Y
    . O PowerExchange interrompe extrações de dados alterados quando o EOL é atingido.
O padrão é N.
INST=
instance_name
Obrigatório. Nome definido pelo usuário para a instância de origem. Esse nome deve corresponder ao especificado na propriedade
Identificador de Coleta
do grupo de registro.
Se você estiver executando o Condensador do PowerExchange, esse nome também deverá corresponder ao especificado no parâmetro DBID do membro CAPTPARM.
JOURNAL=
library
/
journal_name
Obrigatório. O nome da biblioteca e o nome do diário que contém dados alterados para tabelas registradas e cujos dados alterados o PowerExchange extrai.
Você pode substituir essa especificação do diário usando um dos seguintes métodos:
  • Nas sessões do CDC de extração em tempo real, use o
    Nome do Diário
    na conexão do aplicativo PWX CDC.
  • No Condensador do PowerExchange, use a instrução JRNL do membro de configuração CAPTPARM.
  • Em testes de linha do banco de dados CAPXRT, use a propriedade
    Diário/Biblioteca do AS400
    na caixa de diálogo
    Parâmetros Avançados CAPXRT
    do Navegador do PowerExchange.
  • Nas sessões do CDC de extração em tempo real que usam conexões ODBC, utilize o parâmetro DTLJRNL para a fonte de dados ODBC.
LIBASUSER={
N
|Y|M|P}
Opcional. Controla o tipo de valor que o PowerExchange grava no campo DTL__CAPXUSER de cada registro de alteração.
As opções são:
  • N
    . Grava o ID do usuário que fez a alteração.
  • Y
    . Grava o nome da biblioteca e o nome do arquivo onde a alteração foi feita.
    Se você definir o parâmetro ALWLIBRFSH como Y, a Informatica recomenda que você especifique LIBASUSER=Y. Essa configuração permite identificar as bibliotecas que contêm as instâncias de tabela para as quais as alterações são extraídas.
  • M
    . Grava o nome da biblioteca, o nome do arquivo e o nome do membro de dados do arquivo onde a alteração foi feita.
  • P
    . Grava o nome do programa que fez a alteração.
O padrão é N.
NOCCUOWSZ=
uow_size
Opcional. O tamanho, em número de registros, do UOW que o PowerExchange cria ao ler registros de alteração dos destinatários do diário do que foram criados sem controle de confirmação.
Para a variável
uow_size
, digite um número de 1 a 50000.
Se você não especificar o controle de confirmação ao fazer alterações nas tabelas do DB2 para i, o PowerExchange criará um UOW para cada registro de alteração. Use esse parâmetro para aumentar o tamanho dos UOWs que o PowerExchange cria. O PowerExchange e o PowerCenter processam UOWs maiores com mais eficiência. Os UOWs maiores também reduzem a atividade de confirmação nos destinos dos dados alterados.
Como esse parâmetro afeta todos os usuários dessa instrução CAPI_CONNECTION, a Informatica recomenda que você use o atributo
Mínimo de Linhas por confirmação
na conexão do aplicativo PWX DB2i5OS CDC em Tempo Real para especificar valores de tamanho de UOW para as sessões do CDC.
O PowerExchange ignora esse parâmetro para registros de alteração criados com controle de confirmação.
POLWAIT={
seconds
|
10
}
Opcional. O número de segundos que o PowerExchange aguarda depois de atingir o fim de um destinatário do diário, antes de verificar se há dados alterados nesse destinatário.
Para a variável
seconds
, digite um número de 0 a 10. O padrão é 10.
STOPIT=({
CONT
|TERM},
number_exceptions
|
5
)
Opcional. Controla se uma sessão de extração é interrompida depois de encontrar exceções ao processar dados alterados do diário. Uma exceção pode ser uma das seguintes:
  • Uma alteração de pós-imagem sem uma alteração de pré-imagem
  • Uma tentativa de excluir um registro que não tem dados
Para o primeiro parâmetro posicional, digite uma das seguintes opções:
  • CONT
    . A sessão de extração continua em execução após o número especificado de exceções.
  • TERM
    . A sessão de extração é finalizada após o número especificado de exceções.
O padrão é CONT.
Para o segundo parâmetro posicional,
number_exceptions
, digite o número de exceções após o qual o PowerExchange toma a medida definida no primeiro parâmetro posicional da instrução. O valor 0 indica que a extração continua em execução, mas não reporta nenhuma exceção. Os valores válidos vão de 0 a 255. O padrão é 5.
UOWRSTANY={
Y
|N}
Esse parâmetro é obsoleto. Y é o valor padrão. Em inicializações a frio de sessões de extração do PowerExchange, eles ignoram todos os UOW parciais para os quais o ponto de inicialização UOW esteja em um destinatário de diário anterior. As sessões começar a ler os dados alterados no próximo UOW no destinatário do diário.
Se esse parâmetro for omitido, o comportamento padrão é o mesmo de quando Y for especificado. Inserindo N, o PowerExchange ignora o valor N e usa Y.