Sumário

Search

  1. Prefácio
  2. Introdução aos Utilitários do PowerExchange
  3. createdatamaps - Utilitário de Criação do Mapa de Dados
  4. DTLCCADW - Utilitário Adabas PCAT
  5. DTLCUIML - Utilitário Marcador do Log do IMS
  6. DTLINFO - Utilitário de Informações de Liberação
  7. DTLREXE - Utilitário de Execução Remota
  8. DTLUAPPL - Utilitário de Token de Reinicialização
  9. DTLUCBRG - Utilitário de Registro em Lotes
  10. DTLUCDEP - Utilitário de Manutenção CDEP
  11. DTLUCSR2 - Utilitário de Registros IDMS SR2 e SR3
  12. DTLUCUDB - Utilitário do DB2 para Linux, UNIX e Windows CDC
  13. DTLULCAT e DTLULOGC - Utilitários de Catálogo de Logs IDMS
  14. DTLURDMO - Utilitário de Mapa de Dados
  15. DTLUTSK - Utilitário de Controle de Tarefa
  16. EDMLUCTR - Utilitário de Digitalização e Impressão de Log
  17. EDMUOPTS - Utilitário Service Aid
  18. EDMXLUTL - Utilitário do Marcador de Eventos
  19. HOSTENT - Utilitário Gerador de Relatórios de Endereços TCP/IP
  20. PWXCATMY - Utilitários de catálogo do MySQL
  21. PWXUCCLPRT - Utilitário de resumo de log de impressão
  22. PWXUCDCT - Utilitário do Agente de Log do PowerExchange para Linux, UNIX e Windows
  23. PWXUCREG - Utilitário de Suspensão de Registro de Captura
  24. PWXUMAP - Utilitário de lista de mapas
  25. PWXUCRGP - Utilitário de Impressão de Registros de Captura
  26. PWXUDMX - Utilitário de Memória ECSA de Hora de Atualização dos Mapas de Dados
  27. Utilitário de relatório PWXUGSK - SSL
  28. PWXUSSL - Utilitário de Relatório SSL do PowerExchange
  29. WRKJRNLCKE - Utilitário de Tabela de Bloqueio de Diário para IBM i

Parâmetros do Utilitário DTLUCBRG

Parâmetros do Utilitário DTLUCBRG

Esta seção descreve os parâmetros do utilitário DTLUCBRG.
Defina os parâmetros em um dos seguintes locais, dependendo do tipo de sistema operacional:
  • No IBM i (i5/OS), defina os parâmetros no arquivo de parâmetros que você especifica na linha de comandos.
  • No Linux, UNIX e Windows, defina os parâmetros no arquivo dtlucbrg.txt. Esse arquivo deve estar no diretório a partir do qual você executa o DTLUCBRG.
  • No z/OS, defina os parâmetros no SYSIN da JCL.
Não é necessário especificar parâmetros que tenham valores padrão.
Descrições de Parâmetros:
CONDTYPE
A opção de Condensação a ser usada para os registros de captura. As opções são:
  • Completo
    . Essa opção está disponível se você usar o PowerExchange Condense 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:
    • As fontes de dados do CDC baseadas em log do Adabas e do IDMS não são suportadas.
    • 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.
    • No i5/OS, tabelas de origem deve ter as chaves primárias ou arquivos DDS devem ser definidos com uma chave exclusiva.
  • PART
    . Essa opção está disponível se você usar o PowerExchange Condense 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.
CREATEBICI
Controla se o utilitário DTLUCBRG gera uma coluna de pré-imagem, uma coluna de indicador de alteração, ou ambas, para colunas de dados em mapas de extração. Este parâmetro aplica-se a todos os mapas de extração criados pelo utilitário. Se você especificar várias tabelas usando uma máscara de nome de tabela, as palavras-chave CREATEBICI serão aplicadas a todas as tabelas que correspondem à máscara. Consulte Notas de Uso do Utilitário DTLUCBRG para obter mais informações sobre limitações relacionadas a este parâmetro.
A sintaxe do parâmetro CREATEBICI é:
CREATEBICI=(COLUMNS={PKFK|ALL|FILE}, MAXCOLS={
number_of_columns
|
500
}, EXTINFO={BI|CI|
BICI
}, INPUT_FN=
input_file_name
, OUTPUT_FN=
output_file_name
, ERROR_FN=
error_file_name
)
O parâmetro CREATEBICI contém as seguintes palavras-chave:
  • COLUMNS
    As colunas no mapa de extração para as quais o utilitário gera colunas de pré-imagem, colunas de indicador de alteração ou ambos os tipos de colunas, conforme indicado pela palavra-chave EXTINFO. As opções são:
    • PKFK
      . Gera colunas de pré-imagem e de indicador de alteração para colunas de chave primária e de chave estrangeira.
    • ALL
      . Gera colunas de pré-imagem e de indicador de alteração para todas as colunas selecionadas no mapa de extração.
    • FILE
      Gera colunas de pré-imagem e de indicador de alteração para colunas definidas no esquema de tabela no arquivo de entrada do utilitário.
    Nenhum padrão é especificado.
    Se você estiver gerando colunas de pré-imagem ou de indicador de alteração e a palavra-chave COLUMNS identificar colunas definidas pelo usuário com expressões que chamam funções do PowerExchange, verifique se as funções oferecem suporte ao armazenamento em buffer do BI. Se uma função não oferecer suporte ao armazenamento em buffer do BI, o PowerExchange não gerará colunas de BI ou CI para o campo. Para obter mais informações, consulte Funções de expressão-campo que suportam o processamento do CREATEBICI.
  • MAXCOLS
    . Opcional. O número máximo de colunas para as quais o utilitário gera colunas de pré-imagem e de indicador de alteração no mapa de extração. Os valores válidos vão de 10 a 32000. O padrão é 500.
    Como você define essa palavra-chave depende da configuração COLUMNS. Siga estas diretrizes:
    • Se COLUMNS=FILE, o valor de MAXCOLS deve ser igual ou maior que o número de entradas no arquivo de entrada.
    • Se COLUMNS=ALL, o valor de MAXCOLS deve ser igual ou maior que o maior número de colunas em uma tabela registrada.
    • Se COLUMNS=PKFK, o valor de MAXCOLS deve ser igual ou maior que o número de chaves primárias e estrangeiras na maior tabela registrada.
  • EXTINFO
    . Opcional. O tipo ou tipos de colunas de metadados para gerar nos mapas de extração. As opções são:
    • BI
      . Colunas de pré-imagem.
    • CI
      . Colunas de indicador de alteração.
    • BICI
      . Tanto colunas de pré-imagem e de indicador de alteração.
    O padrão é BICI.
    Em alguns casos, a coluna de pré-imagem ou de indicador de alteração não pode ser criada. Por exemplo, o utilitário não pode criar uma coluna de pré-imagem para colunas LOB do DB2 for z/OS em mapas de extração. Se você tentar criar uma coluna de pré-imagem para as colunas LOB do DB2 for z/OS, a solicitação será ignorada e uma mensagem de aviso será gravada no arquivo de saída.
  • INPUT_FN
    . No i5/OS, Linux, Unix e Windows, o nome do arquivo de entrada que contém os nomes de coluna para as colunas de pré-imagem e de indicador de alteração. No z/OS, digite
    S
    ou
    N
    . Se você digitar
    S
    , o utilitário usará um conjunto de dados particionado padrão estendido (PDSE) que foi pré-alocado com um DSNTYPE de LIBRARY e um comprimento de registro de 255 bytes. Você pode usar essa palavra-chave somente se a palavra-chave COLUMNS estiver definida como
    FILE
    .
  • OUTPUT_FN
    . No i5/OS, Linux, Unix e Windows, o nome do arquivo de saída que contém informações de log sobre as colunas de pré-imagem e de indicador de alteração criadas nos mapas de extração. No z/OS, digite
    S
    ou
    N
    . Se você digitar
    S
    , o utilitário usará um conjunto de dados particionado padrão estendido (PDSE) que foi pré-alocado com um DSNTYPE de LIBRARY e um comprimento de registro de 255 bytes.
  • ERROR_FN
    . No i5/OS, Linux, Unix e Windows, o nome do arquivo que lista as colunas para as quais as colunas de pré-imagem e de indicador de alteração não foram geradas nos mapas de extração. No z/OS, digite
    S
    ou
    N
    . Se você digitar
    S
    , o utilitário usará um conjunto de dados particionado padrão estendido (PDSE) que foi pré-alocado com um DSNTYPE de LIBRARY e um comprimento de registro de 255 bytes.
Se CREATEBICI e RPTCOLS=Y forem especificados, o utilitário adicionará colunas de pré-imagem e de indicador de alteração ao relatório de saída com o valor
Y
ou
N
em cada uma dessas colunas.
CRGNAME
Um nome de registro de captura definido pelo usuário. Esse nome pode ter até 13 caracteres alfanuméricos para origens no Linux, UNIX e Windows e até 10 caracteres alfanuméricos para origens no IBM i e z/OS. O nome não pode começar com um 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.
CRGPREFIX
Um prefixo de um a quatro caracteres de comprimento para o nome de registro. O utilitário acrescenta um número sequencial de 4 dígitos a este prefixo para formar um nome de registro exclusivo.
O nome de registro pode ter qualquer um dos seguintes formatos:
xnnnn
xxnnnn
xxxnnnn
xxxxnnnn
Onde:
  • x...
    é o valor de prefixo que você insere. O primeiro valor
    x
    deve ser uma letra de a até z. Os valores
    x
    subsequentes podem incluir as letras de a até z ou os inteiros de 0 a 9.
  • nnnn
    é um número sequencial que o utilitário gera, a partir de 0001.
Se o utilitário tentar criar um registro para uma tabela que tenha um nome de tabela contendo caracteres inválidos, o utilitário emitirá uma mensagem de erro e continuará processando sem criar o registro para a tabela.
Para substituir um registro sob o nome anterior, você deve usar o parâmetro CRGNAME, em vez do parâmetro CRGPREFIX.
Não especifique CRGPREFIX ou CRGNAME ao mesmo tempo.
DBTYPE
Um mnemônico de três caracteres que indica o tipo de fonte de dados. As opções são:
  • ADA
    para Adabas
  • AS4
    para DB2 for i (i5/OS)
  • DB2
    para DB2 para z/OS
  • DCM
    para Datacom
  • HAN
    para SAP HANA
  • IDL
    para IDMS baseado em log
  • IMS
    para IMS
  • MSS
    para Microsoft SQL Server
  • MYS
    para o MySQL
  • ORA
    para Oracle
  • PGS
    para PostgreSQL
  • UDB
    para DB2 for Linux, UNIX e Windows
  • VSM
    para VSAM
Use o
DB2
somente para DB2 no z/OS. Use
AS4
ou
UDB
para produtos DB2 em outras plataformas.
EPWD
Uma senha criptografada para o ID do usuário especificado pelo UID.
Se o utilitário acessar um local no i5/OS ou no z/OS, insira um código de acesso criptografado do PowerExchange em vez de uma senha criptografada. Não criptografe um código de acesso que tenha caracteres inválidos, como aspas duplas, aspas simples ou símbolos de moeda.
Você pode criar uma senha ou código de acesso criptografado no Navegador do PowerExchange selecionando
Arquivo
Criptografar Senha
.
Use EPWD em vez de PWD se não tiver permissão para armazenar senhas em um formato legível.
EXCLUDE_COL
Um nome de coluna ou padrão de nome para excluir colunas dos registros de captura que você está criando para tabelas de origem. Para definir um padrão de nome que pode identificar várias colunas, inclua o curinga asterisco (*) em qualquer lugar dentro do nome, por exemplo, tx*custid. Esse valor é comparado aos nomes das colunas de uma maneira que não diferencia maiúsculas de minúsculas.
Você pode repetir esse parâmetro várias vezes para especificar vários valores de nome. Se você especificar o parâmetro EXCLUDE_COL, não defina também o parâmetro INCLUDE_COL. Esses parâmetros são mutuamente exclusivos.
EXCLUDE_TYPE
Um tipo de dados de coluna a ser usado para excluir colunas dos registros de captura que você está criando para tabelas de origem. Todas as colunas que possuem o tipo de dados especificado serão excluídas dos registros. Você pode querer usar esse parâmetro para excluir tipos de dados aos quais o PowerExchange não oferece suporte ou para atender a determinados requisitos específicos do site.
Esse valor é comparado com os tipos de data da coluna de uma maneira que não diferencia maiúsculas de minúsculas. Por exemplo, os valores
clob
e
CLOB
teriam o mesmo resultado. Você pode repetir esse parâmetro várias vezes para especificar vários tipos de dados.
INCLUDE_COL
Um nome de coluna ou padrão de nome para incluir colunas nos registros de captura que você está criando para tabelas de origem. Para definir um padrão de nome que pode identificar várias colunas, inclua o curinga asterisco (*) em qualquer lugar dentro do nome, por exemplo, tx*custid. Esse valor é comparado aos nomes das colunas de uma maneira que não diferencia maiúsculas de minúsculas.
Você pode repetir esse parâmetro várias vezes para especificar vários valores de nome. Se você especificar o parâmetro INCLUDE_COL, não defina também o parâmetro EXCLUDE_COL. Esses parâmetros são mutuamente exclusivos.
INSTÂNCIA
A instância de origem para seus registros. O tipo de valor depende do tipo de banco de dados de origem especificado no parâmetro DBTYPE.
Com base na opção DBTYPE, digite um dos seguintes valores:
  • Para
    ADA
    , digite um nome do Adabas Nucleus.
  • Para
    AS4
    , digite um valor de instância do DB2 for i (i5/OS) que corresponda ao valor de parâmetro INST na instrução AS4J CAPI CONNECTION no membro DBMOVER do arquivo
    dtllib
    /CFG. Se você usar o PowerExchange Condense, esse valor da instância também deve corresponder ao valor do parâmetro DBID no membro CAPTPARM.
  • Para
    DB2
    , digite um ID do subsistema do DB2 (SSID).
  • Para
    DCM
    , digite um nome Datacom Multi-User Facility (MUF).
  • Para
    IDL
    , digite um CDC baseado em log IDMS valor da instância que corresponde ao parâmetro
    registration_logsid
    na instrução LOGSID no membro de configuração DBMOVER.
  • Para
    HAN
    , insira o nome do servidor SAP HANA especificado no parâmetro HANOPTS DBSERVER. O tamanho máximo é de sete caracteres. Esse identificador é incorporado aos nomes dos mapas de extração criados pelo utilitário. Se você usar o Agente de Log do PowerExchange para Linux, UNIX e Windows, verifique se o identificador de instância corresponde ao valor do parâmetro DBID no arquivo de configuração do Agente de Log. Se você não inserir esse valor de instância, o PowerExchange gerará um identificador de instância exclusivo composto de todo ou parte do nome do banco de dados, seguido por um número de três dígitos.
  • Para
    IMS
    , digite um ID de subsistema IMS que corresponde ao valor de parâmetro
    ims_ssid
    na instrução IMSID no membro de configuração DBMOVER.
  • Para
    MSS
    , você pode digitar um identificador de instância exclusivo definido pelo usuário para a combinação de servidor de banco de dados e de nome do banco de dados do SQL Server definida nos parâmetros MSSOPTS DBSERVER e DBNAME. O tamanho máximo é de sete caracteres. Esse identificador é incorporado aos nomes dos mapas de extração criados pelo utilitário. Se você usar o Agente de Log do PowerExchange para Linux, UNIX e Windows, verifique se o identificador de instância corresponde ao valor do parâmetro DBID no arquivo de configuração do Agente de Log. Se você não inserir esse valor de instância, o PowerExchange gerará um identificador de instância composto de toda a ou parte da publicação, do nome do banco de dados, seguido por um número de três dígitos se um número for necessário para tornar o identificador exclusivo.
    Esse parâmetro INSTANCE é útil em cenários de migração. Se você precisar implantar a captura de alterações de um ambiente para outro, como do teste para a produção, e você
    não
    definir um identificador de instância, o PowerExchange usará o identificador de instância gerado no novo ambiente. O identificador de instância gerado pode ser diferente daquele no ambiente de origem original. Para evitar a necessidade de atualizar os nomes do mapa de extração em fluxos de trabalho do PowerCenter e editar o valor do parâmetro DBID para o Agente de Log do PowerExchange, insira um identificador de instância no parâmetro INSTANCE que corresponde ao identificador de instância no ambiente original ao criar registros para o novo ambiente.
    Nesse cenário de migração, certifique-se de que os arquivos de configuração dbmover.cfg no ambiente original e no novo ambiente especifiquem caminhos exclusivos nas instruções CAP_PATH e CAPT_XTRA.
  • Para
    MYS
    , insira um identificador de instância exclusivo, definido pelo usuário, para o servidor de banco de dados MySQL. O tamanho máximo é de sete caracteres. Esse identificador é usado para identificar um conjunto de registros para tabelas no banco de dados no servidor MySQL. Esse identificador também é incorporado aos nomes dos mapas de extração criados pelo utilitário. Se você usar o Agente de Log do PowerExchange para Linux, UNIX e Windows, verifique se esse identificador de instância corresponde ao valor do parâmetro DBID no arquivo de configuração do Agente de Log.
  • Para
    ORA
    , digite o ID de coleção definido pelo usuário para a instância Oracle que corresponde ao parâmetro
    collection_ID
    na instrução ORACLEID no membro de configuração DBMOVER do PowerExchange.
  • Para
    PGS
    , digite um identificador de instância exclusivo definido pelo usuário para a combinação de servidor de banco de dados e de nome do banco de dados do PostgreSQL definida nos parâmetros PGSOPTS DBSERVER e DBNAME. O tamanho máximo é de sete caracteres. Esse identificador é incorporado aos nomes dos mapas de extração criados pelo utilitário. Se você usar o Agente de Log do PowerExchange para Linux, UNIX e Windows, verifique se o identificador de instância corresponde ao valor do parâmetro DBID no arquivo de configuração do Agente de Log. Se você não inserir esse valor de instância, o PowerExchange gerará um identificador de instância exclusivo composto de todo ou parte do nome do banco de dados, seguido por um número de três dígitos.
  • Para
    UDB
    , digite um nome de banco de dados DB2 for Linux, UNIX e Windows.
  • Para
    VSM
    , digite um identificador de coleta do VSAM.
LOCATION
Obrigatório. Um nome de nó que aponta para a localização do Ouvinte do PowerExchange que gerencia os registros de captura e os mapas de extração.
Se os registros, os mapas de dados e a fonte de dados residirem no mesmo sistema, você poderá especificar LOCATION=LOCAL. Nesse caso, não defina outros parâmetros LOCATION_
xxx
.
Não especifique LOCATION=LOCAL se você adicionar ou modificar os registros de captura VSAM, IMS síncrono ou DB2 para z/OS. Caso contrário, o Agente do PowerExchange falhará ao detectar os registros novos ou atualizados, e o ECCR não poderá recuperar as alterações de registro durante uma operação de reinicialização ou de atualização. Em vez disso, especifique o valor LOCATION do Ouvinte do PowerExchange que gerencia os registros e está conectado ao Agente do PowerExchange. Em seguida, as informações de registro atualizadas estarão disponíveis para o processamento do ECCR.
LOCATION_CRG
A localização do arquivo de registros de captura (CCT). O valor padrão é o valor do parâmetro LOCATION.
LOCATION_DM
A localização do arquivo de mapas de dados (DATAMAPS). O valor padrão é o valor do parâmetro LOCATION.
LOCATION_XDM
A localização do arquivo de mapas de extração (CAMAPS ou DTLCAMAP). O valor padrão é o valor do parâmetro LOCATION.
NOTIFYCHANGES
Para origens DB2 e Oracle, se você especificar NOTIFYCHANGES=Y, qualquer alteração no esquema da tabela fará com que o CDC do PowerExchange falhe e registre uma mensagem de erro.
Para uma origem do DB2 for z/OS, o ECCR do DB2 termina de forma anormal depois de ler o primeiro registro de mudança para a tabela depois da mudança do esquema.
Para uma origem Oracle, o CDC do Oracle falha e registra uma mensagem de erro nas seguintes situações:
  • Um registro de alteração para uma tabela registrada contém uma coluna que não está registrada para captura de alterações.
  • Um registro de alteração não contém nenhuma coluna registrada para captura de alterações.
Para o CDC do Oracle, se uma definição de tabela for alterada de forma compatível com o registro de captura do PowerExchange, o CDC do Oracle continuará a capturar alterações para essa tabela. Por exemplo, se o tamanho de uma coluna de caracteres diminuir, mas o registro de captura não refletir essa mudança, o CDC do Oracle continuará a capturar mudanças para a tabela.
De modo inverso, se o tipo de dados de uma coluna for alterado de numérico para caractere e o registro de captura não for atualizado para refletir essa alteração, o CDC do Oracle continuará a capturar alterações para a tabela até encontrar o primeiro registro de alterações que contém dados não numéricos para a coluna. O Oracle CDC, então, falha e registra uma mensagem de erro.
Para origens do DB2 e Oracle, o padrão é
Y
. Para outras origens de dados, o padrão é
N
, o que faz com que esse parâmetro seja ignorado.
OUTPUT
A localização e o nome do arquivo do relatório gerado pelo DTLUCBRG. Por exemplo:
OUTPUT=c:\pwx\outfile.txt
Se o caminho incluir nomes com espaços, coloque o caminho entre aspas.
No z/OS, o relatório é direcionado à saída SYSPRINT DD por padrão. No Windows, o relatório é direcionado para STDOUT por padrão.
PWD
Uma senha com texto não criptografado para o ID de usuário especificado. Para acessar um local no i5/OS ou no z/OS, insira um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/OS pode ter 9 a 31 caracteres. Um código de acesso do z/OS pode ter 9 a 128 caracteres. Um código de acesso pode conter os seguintes caracteres:
  • Letras em maiúsculas e minúsculas
  • Os números de 0 a 9
  • Espaços
  • Os seguintes caracteres especiais:
    ’ - ; # \ , . / ! % & * ( ) _ + { } : @ | < > ?
    O primeiro caractere é um apóstrofo.
Códigos de acesso não podem incluir aspas simples ('), aspas duplas (") ou símbolos monetários.
Se um código de acesso contiver espaços, você deverá colocá-lo entre aspas duplas ("), por exemplo,
"Este é um código de acesso"
. Se um código de acesso contiver caracteres especiais, você deverá colocá-lo entre três caracteres de aspas duplas ("""), por exemplo,
"""Este código de acesso contém caracteres especiais ! % & *."""
. Se um código de acesso tiver apenas caracteres alfanuméricos sem espaços, insira-o sem delimitadores.
Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte a "Instrução SECURITY" no
Manual de Referência do PowerExchange
.
No z/OS, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação.
Não especifique também EPWD.
REPLACE
Se os registros inativos existentes devem ser substituídos. As opções são:
  • Y
    . Substitua os registros inativos que correspondem à máscara especificada no parâmetro de tabela.
  • N
    . Não substitua os registros existentes. Adicione registros para tabelas que correspondem à máscara e que ainda não existem.
O padrão é
N
.
REPLACEACTIVE
Se os registros ativos existentes devem ser substituídos. As opções são:
  • Y
    . Substitua os registros ativos que correspondem à máscara especificada no parâmetro TABLE. Para que ocorra essa sunstituição, o parâmetro REPLACE também deve ser definido como Y.
  • N
    . Não substitua os registros ativos.
O padrão é
N
.
REUSECRGNAME
Se o DTLUCBRG mantém os nomes atuais dos registros de captura existentes ou os renomeia. As opções são:
  • Y
    . Mantém os nomes atuais dos registros existentes.
  • N
    . Renomeie os registros existentes usando o CRGPREFIX e o formato de número sequencial.
O padrão é
N
.
RPTCOLS
Se os registros de captura existentes devem ser renomeados ou se seus nomes atuais devem ser mantidos. As opções são:
  • Y
    . Mantém os nomes atuais dos registros existentes.
  • N
    . Renomeie os registros existentes usando o CRGPREFIX e o formato de número sequencial.
O padrão é
Y
.
STATUS
O status a ser definido para os registros de captura criados pelo utilitário DTLUCBRG. As opções são:
  • A
    . Cria registros com o status de Ativo.
  • I
    . Cria registros com o status de Inativo. Posteriormente, você precisará ativar os registros para torná-los elegíveis para captura de alterações.
Para origens do Microsoft SQL Server, se você especificar UPDATESTATUS=Y no parâmetro MSSOPTS, esse parâmetro STATUS redefinirá o status de todos os registros que correspondem aos critérios de filtro especificados.
TABLE
Uma máscara que restringe as tabelas de origem para as quais o utilitário DTLUCBRG criará registros de captura.
  • Para tabelas de bancos de dados relacionais, a máscara pode ser especificada no seguinte formato:
    owner_or_schema
    .
    tablename
    Dentro dessa máscara, o nome do esquema e o nome da tabela podem ter até 128 caracteres.
  • Para origens não relacionais, a máscara inclui o nome do mapa de dados e pode ser especificada no seguinte formato:
    schema
    .
    mapname
    Opcionalmente, é possível definir um valor de parâmetro TABLE no formato NRDB ou NRDB2 que inclua um nome de tabela para estreitar a seleção de tabelas quando várias tabelas são definidas em um mapa de dados, mas nem todas precisam ser registradas.
    O exemplo a seguir mostra o formato NRDB de três camadas, que usa ponto (.) separadores entre o nome do esquema, o nome do mapa e o nome da tabela:
    SCHEMA
    .
    mapname
    .
    tablename
    O exemplo a seguir mostra o formato NRDB2 de duas camadas, que usa um separador de sublinhado (_) entre o nome do mapa e o nome da tabela:
    SCHEMA
    .
    mapname
    _
    tablename
Para representar um ou mais caracteres em qualquer parte do valor do parâmetro, use o curinga asterisco (*). Por exemplo, a máscara a seguir corresponde a todas as tabelas relacionais cujo proprietário é "OWNAB" e cujo nome de tabela que inicia com "T":
OWNAB.T*
O exemplo a seguir mostra um valor de parâmetro no formato NRDB2 que contém uma máscara curinga no nome do mapa e na tabela. O valor do parâmetro corresponde aos nomes do mapa que começam com "M" e aos nomes da tabela que começam com "T".
SCHEMA1.M*_T*
O exemplo a seguir mostra as mesmas máscaras no formato NRDB:
SCHEMA1.M*.T*
TESTRUN
Se deve realizar uma execução de teste do utilitário DTLUCBRG. As opções são:
  • Y
    . Realiza uma execução de teste para determinar os registros de captura a serem atualizados ou adicionados. A execução de teste na verdade não atualiza nem adiciona nenhum registro.
  • N
    . Não realiza uma execução de teste. Quando você executar o utilitário, ele atualizará ou adicionará registros de captura.
O padrão é
Y
.
UID
Um ID do usuário que permite o acesso à origem. O requisito desse parâmetro depende das fontes de dados que estão sendo registradas e do valor da instrução SECURITY no arquivo de configuração DBMOVER do PowerExchange.
Para uma origem em um sistema Linux, UNIX ou Windows com suporte, se você tiver ativado a autenticação de usuário LDAP do PowerExchange e, se aplicável, desativado a autenticação de passagem relacional, a ID de usuário será o nome de usuário da empresa. Para obter mais informações, consulte o
Manual de Referência do PowerExchange
.
Se você especificar um ID de usuário, especifique também um valor PWD ou EPWD.