CAPI_CONNECTION=([DLLTRACE=
trace_id]
                 ,NAME=
capi_connection_name
                [,TRACE=
trace_name]
                 ,TYPE=(UDB
                      [,AGEOUTPERIOD=
minutes]
                      [,CCATALOG={
capture_catalog|
creator.DTLCCATALOG}]
                      [,DBCONN=
database_name]
                      [,EPWD=
encryted_password]
                      [,LARGEOPS=
number_of_operations]
                      [,LIMITRESCAN={Y|
N}]
                      [,LOGBUFSIZE=[
kilobytes][,
kilobytes]]
                      [,MEMCACHE={
cache_size|
1024}]
                      [,MONITORINT={
minutes|
5}]
                      [,PASSWORD=
password]
                      [,RSTRADV=
seconds]
                      [,SPACEPRI={
AUTO|MAX|NONE|
nn}]
                      [,THREADING={
AUTO|MAX|NONE|
nn}]
                      [,UDBSCHEMA=
schema]
                      [,UPDINT={
seconds|
600}]
                      [,UPDREC={
records|
1000}]
                      [,USERID=
user_id]
                  )
) 

DLLTRACE=

trace_id

Opcional. Um nome definido pelo usuário para a 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. Um 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. Um nome definido pelo usuário para a 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=(UDB, ... )

Obrigatório. O tipo de instrução CAPI_CONNECTION. Nas origens do Db2 for Linux, UNIX e Windows, esse valor deve ser UDB.

AGEOUTPERIOD=

minutos

O número de minutos que deve decorrer antes de uma UOW pendente que não possua registros de alteração de interesse do CDC será removida do cálculo do ponto de reinicialização do CDC. A idade é calculada como a diferença entre a hora de início do UOW pendente e a hora atual.

Use esse parâmetro para impedir falhas do CDC que poderão ocorrer se você desligar e depois reiniciar o processamento de captura enquanto a transação estiver pendente. Após a reinicialização, o log de transações do Db2 em que o UOW pendente iniciado pode não estar disponível, fazendo com que o processo de leitura do Db2 PowerExchange falhe.

Os valores válidos variam de 60 e 43200. Nenhum valor padrão é especificado.

CCATALOG={

capture_catalog

|

creator

.DTLCCATALOG

}

Opcional. O nome da tabela do catálogo de captura do PowerExchange no formato

autor

.

nome_da_tabela

.

O padrão é

creator

.DTLCCATALOG, onde

creator

é a identificação do usuário utilizada para conexão com o banco de dados.

DBCONN=

database_name

Opcional. O nome do banco de dados substituto ao qual você deseja conectar para extração de dados em vez de o banco de dados que está especificado para o grupo de registro. O banco de dados substituto deve conter tabelas e colunas idênticas às do banco de dados original. Os nomes de marca de registro e mapa de extração incluem o nome do banco de dados original.

EPWD=

encryted_password

Opcional. Uma senha criptografada que é usada com a ID de usuário no parâmetro USERID para acesso ao banco de dados.

Se você especificar esse parâmetro, especifique também o parâmetro USERID. No entanto, não especifique também o parâmetro PASSWORD.

Você pode criar senhas criptografadas no Navegador do PowerExchange.

LARGEOPS=

número de operações

Opcional. Substitui o valor padrão que o PowerExchange usa para identificar as transações como transações grandes para fins de relatório. Digite o número de operações de DML (inserções, atualizações e exclusões), em milhares, que uma transação deve conter para ser considerada uma transação grande.

O PowerExchange emite mensagens de status para transações grandes que cumpram esses critérios. Se o PowerExchange emitir mensagens em excesso, pode-se aumentar esse valor para limitar o número de mensagens.

Os valores válidos são de 1 a 2147483 (1.000 a 2.147.483.000 de operações). O valor padrão é metade do valor arredondado do parâmetro MEMCACHE para o milhar mais próximo. Com base no valor padrão 1024 KB de MEMCACHE, o valor padrão de LARGEOPS é de 1000 (1.000.000 de operações).

Se uma transação comprometida abrange várias partições em um banco de dados Db2, o PowerExchange reporta o número de operações SQL e tamanho de transação em todas as partições.

LIMITRESCAN={Y|

N

}

Opcional. Quando o processamento de captura de alterações do PowerExchange encontra um registro compactado para uma tabela de origem no log Db2, controla se o PowerExchange verifica o log em busca de registros de tabelas propagáveis até um limite definido internamente ou continua a varredura até que o buffer esteja cheio ou até o fim do log (EOL). Use este parâmetro para evitar a verificação excessiva do log, o que pode resultar em tempos limite de captura do PowerExchange e desempenho degradado.

Y
. Limita a verificação de registros de log do PowerExchange para captura de alterações. Essa opção é recomendada para evitar possíveis tempos limite e falhas de captura do PowerExchange.
N
. Permite que a verificação de registros de log do PowerExchange continue até que o buffer esteja cheio ou até o fim do log (EOL). Nesse caso, o processamento de captura do PowerExchange pode terminar de forma anormal com um erro de tempo limite. É mais provável que esse problema ocorra quando as tabelas de origem tiverem uma atividade de alteração de volume baixa.

O padrão é N.

LOGBUFSIZE=[

kilobytes_normal

][,

kilobytes_filtered

]

Opcional. Os tamanhos de buffer, em kilobytes, que o processo de captura do PowerExchange usa para ler registros de log Db2 no modo de leitura normal e no modo de leitura filtrada. No modo de

leitura filtrada

, o PowerExchange verifica registros compactados de tabelas propagáveis. Você pode especificar um tamanho de buffer para um dos modos de leitura de log ou para ambos.

Para o primeiro tamanho do buffer de leitura normal, se você digitar 0 ou não especificar um valor, o valor de 128 KB será usado por padrão. Para o segundo tamanho do buffer de leitura filtrada, se você digitar 0 ou não especificar um valor, o primeiro tamanho do buffer de leitura normal será usado por padrão para operações de leitura filtrada.

Se você definir a variável de ambiente capdl_bufsize do PowerExchange na direção do Suporte Global a Clientes da Informatica, o valor da variável de ambiente substituirá os tamanhos de buffer no parâmetro LOGBUFSIZE.

MEMCACHE={

cache_size

|

1024

}

Opcional. O tamanho máximo do cache de memória, em quilobytes, que o PowerExchange pode alocar para reconstruir UOWs concluídos.

Digite um número de 0 a 2147483647. O padrão é 1024 KB. Se você inserir 0, o tamanho do cache de memória será limitado somente pela memória disponível no sistema. A Informatica recomenda que você insira 0.

Para cada sessão de extração, o PowerExchange mantém todas as alterações de cada UOW pendente no cache de memória até que ele processe o registro end-UOW. O PowerExchange aloca o cache de memória incrementalmente até o limite que esse parâmetro especifica. Se o cache de memória for muito pequeno para manter todas as alterações de UOWs pendentes, o PowerExchange eliminará as alterações em um UOW para arquivos sequenciais, chamados arquivos spill UOW, no disco.

Cada arquivo spill UOW contém dados de alteração de um UOW. Um UOW poderá exigir vários arquivos spill UOW para manter todas as alterações desse UOW. Se o fluxo de mudança contiver vários UOWs grandes e o cache de memória for insuficiente, o PowerExchange poderá criar inúmeros arquivos spill UOW.

O PowerExchange processará o fluxo de mudança de modo mais eficiente se ele não precisar usar arquivos spill UOW. Um grande número de arquivos spill UOW pode diminuir o desempenho de extração e causar falta de espaço em disco.

Se o fluxo de mudança contiver UOWs pequenos, o valor padrão poderá ser suficiente. Entretanto, o valor padrão geralmente é muito pequeno para eliminar arquivos spill UOW.

A localização em que o PowerExchange aloca os arquivos spill UOW varia conforme o sistema operacional da seguinte forma:

No Linux e UNIX, o PowerExchange usa o diretório atual por padrão. Para usar um diretório diferente, você deve especificar a variável de ambiente TMPDIR.
O PowerExchange nomeia os arquivos spill UOW usando o prefixo "dtlq" e a função tempnam do sistema operacional.
Os arquivos spill UOW são arquivos temporários que são excluídos quando fechados pelo PowerExchange. Esses arquivos não são visíveis no diretório enquanto estão abertos.
No Windows, o PowerExchange usa o diretório atual por padrão para arquivos spill UOW. Para usar um diretório diferente, especifique a variável de ambiente TMP.
O PowerExchange nomeia os arquivos spill UOW usando o prefixo "dtlq" e a função _tempnam do Windows.

O PowerExchange aloca o tamanho do cache para cada operação de extração. Se você usar uma grande valor de MEMCACHE e executar muitas sessões de extração simultâneas, poderão ocorrer restrições de memória.

MONITORINT=

minutos

Opcional. Período em minutos no qual o PowerExchange verifica a atividade de transação para transações pendentes e transações grandes. Transação pendente longa é a que permanece ativa por dois intervalos de monitoramento e transação grande é a que atende aos critérios de LARGEOPS. Quando o período termina, o PowerExchange emite mensagens que identificam as transações grandes e pendentes longas e informa sua atividade de processamento. O PowerExchange também emite mensagens que identificam a posição atual no fluxo de mudança. Os valores válidos vão de 0 a 720. O valor 0 desativa o monitoramento. O padrão é 5.

PASSWORD=

password

Opcional. Uma senha de texto não criptografado usada com a ID de usuário no parâmetro USERID para acesso ao banco de dados.

Se você especificar esse parâmetro, especifique também o parâmetro USERID. No entanto, não especifique também o parâmetro EPWD.

RSTRADV=

seconds

O intervalo de tempo, em segundos, que o PowerExchange aguarda antes de antecipar os tokens de reinicialização e sequência para uma fonte de dados registrada, durante os períodos em que os UOWs não incluem alterações de interesse da 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.

Digite um número de 0 a 86400. Nenhum padrão é especificado.

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.
O PowerExchange retorna um UOW vazio porque o intervalo de espera terminou sem que o PowerExchange recebesse nenhuma alteração de interesse.

Por exemplo, se você especificar 5, o PowerExchange aguardará cinco segundos depois de concluir o processamento do último UOW ou após o término do intervalo de espera anterior. Em seguida, o PowerExchange retorna o próximo UOW vazio confirmado que inclui informações atualizadas de reinicialização e zera o intervalo de espera.

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. Quando o PowerExchange for inicializado a quente, ele lerá todas as alterações, incluindo aquelas que não são de interesse do CDC, do ponto de reinicialização.

Um valor 0 pode diminuir o desempenho. Além dos UOWs que contêm alterações das origens registradas de interesse, o PowerExchange retorna um UOW vazio para cada UOW que não contém alterações das origens registradas de interesse.

SPACEPRI={

primary_space

|

2147483647

}

Opcional. A quantidade de espaço em disco, em bytes, que o PowerExchange usa para alocar arquivos spill UOW como arquivos temporários.

Digite um número de 1 a 2147483647. O padrão é 2147483647 bytes.

THREADING={

AUTO

|MAX|NONE|

nn

}

Opcional. Controla o número de segmentos que o CAPI UDB usa para capturar dados de alteração de um banco de dados Db2. Use este parâmetro para melhorar o desempenho do processamento de captura. Se você tiver um banco de dados particionado, poderá usar um máximo de um segmento para cada nó de partição de banco de dados mais dois segmentos adicionais para processamento de CAPI e de mesclagem.

Os valores válidos são:

AUTO
. Use até nove segmentos.
MAX
. Use um segmento para cada partição de banco de dados, mais dois segmentos adicionais para processamento de mesclagem e CAPI. O número máximo de segmentos é 99.
NONE
. Não use vários segmentos para o processamento de captura.
nn
. Um número especificado pelo usuário de segmentos. Os valores válidos vão de 1 a 99. Para um banco de dados particionado, se você inserir um valor que excede a soma do (
número_de_partições_de_banco_dados
+ 2), o CAPI não usará os segmentos em excesso.

O padrão é AUTO.

UDBSCHEMA=

schema

Opcional. Um nome de esquema que, em registros de captura, substitui o nome do esquema.

UPDINT={

seconds

|

600

}

Opcional. O tempo mínimo em segundos que o PowerExchange aguarda depois de encontrar um virtual time stamp (VTS) nos registros de log do Db2 para uma partição, antes de gravar uma entrada de posicionamento na tabela de catálogo de captura do PowerExchange. A entrada de posicionamento, que contém um log sequence number (LSN) e VTS, indica a localização nos logs do Db2.

Digite um número de 1 a 2147483647. O padrão é 600 segundos.

O número mínimo de registros especificado no parâmetro UPDREC também deverá ser atingido antes que o PowerExchange possa gravar entradas de posicionamento na tabela de catálogo de captura.

UPDREC={

records

|

1000

}

Opcional. O número mínimo de registros de log do Db2 que o PowerExchange deve ler em uma partição a fim de poder gravar uma entrada de posicionamento na tabela de catálogo de captura do PowerExchange. A entrada de posicionamento contém um LSN e VTS e indica uma localização nos logs do Db2.

Digite um número de 1 a 2147483647. O padrão é 1000 registros.

O período mínimo de espera especificado no parâmetro UPDINT também deverá ser atingido antes que o PowerExchange possa gravar entradas de posicionamento na tabela de catálogo de captura.

USERID=

user_id

Opcional. Uma ID de usuário do banco de dados que tem a autoridade SYSADM ou DBADM.

Se você especificar esse parâmetro, especifique também o parâmetro PASSWORD ou EPWD.