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.
A tabela a seguir descreve os parâmetros DTLUCBRG:
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.
Se o nome da tabela contiver caracteres não permitidos, uma mensagem de erro será gerada, informando ao usuário que a tabela será ignorada, mas o processamento continua. Nenhum registro é gerado para o nome da tabela mostrado na mensagem.
Você deve especificar o CRGPREFIX ou CRGNAME, mas não especificar ambos.
DBTYPE - Especifica o mnemônico com três caracteres para o tipo de fonte de dados:
- ADA. Adabas. - AS4. DB2 para i5/OS. - DB2. DB2 para z/OS. - DCM. Datacom.
- IDL. IDMS baseado em log. - IMS. IMS.
- MSS. Microsoft SQL Server. - ORA. Oracle.
- UDB. DB2 para Linux, UNIX e Windows. - VSM. VSAM.
Nota: Use o DB2 somente para DB2 no z/OS. Use AS4 ou UDB para DB2
em outras plataformas.
EPWD - Determina uma senha criptografada para o ID de usuário especificado. 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 contenha caracteres inválidos, como aspas duplas, aspas simples ou símbolos monetários.
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.
Parâmetro Padrão Descrição
INSTANCE - Especifica a instância de origem para seus registros. O tipo de valor depende do tipo de fonte de dados 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 DB2 para valor da instância 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 Condensador do PowerExchange, 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 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. Este identificador de instância é 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, certifique-se de que o identificador de instância corresponda 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.
Sugestão: 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 ORA, digite o ID de coleta definida 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 UDB, digite o DB2 para nome do banco de dados Linux, UNIX e
Windows.
Parâmetro Padrão Descrição
LOCATION - Obrigatório. Especifica 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.
Aviso: 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 Valor de LOCATION
Especifique a localização do arquivo de registro (CCT).
LOCATION_DM Valor de LOCATION
Especifique a localização do arquivo DATAMAP.
LOCATION_XDM Valor de LOCATION
Especifique a localização dos mapas de extração.
NOTIFYCHANGES Y para fontes de dados suportadas
Disponível para origens DB2 e Oracle. Se NOTIFYCHANGES=Y, qualquer mudança no esquema para a tabela faz com que o CDC do
PowerExchange falhe e registre uma mensagem de erro.
Para uma origem DB2 para 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:
- Se um registro de mudança para uma tabela registrada para captura contiver uma coluna que você não registrou para captura
- Se um registro de mudança não contiver uma coluna que você registrou para captura
Para o CDC do Oracle, se uma definição para uma tabela for alterada de forma compatível com o registro de captura do PowerExchange, o CDC do Oracle continuará a capturar mudanças 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 sem uma mudança no registro de captura, o CDC do Oracle continuará a capturar mudanças para a tabela até encontrar o primeiro registro de mudança que contém dados não numéricos para a coluna. Quando o CDC do Oracle encontra um registro de mudança contendo dados não numéricos para a coluna, ele falha e registra uma mensagem de erro.
Para fontes de dados diferentes de DB2 e Oracle, esse parâmetro será ignorado e assume o padrão N.
Parâmetro Padrão Descrição
OUTPUT No z/OS
SYSPRINT, no Win STDOUT
Especifique a localização e o nome do arquivo de relatório do DTLUCBRG.
No Windows, o formato é: 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.
PWD - Especifica 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:
’ - ; # \ , . / ! % & * ( ) _ + { } : @ | < > ?
Nota: 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 "Instrução SECURITY" no Manual de Referência do PowerExchange.
Nota: 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 N Indica 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.
REPLACEACTIVE N Indica 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.
Parâmetro Padrão Descrição
REUSECRGNAME N Especifique uma das opções a seguir:
- Y. Para registros existentes, manter o nome atual.
- N. Renomeie os registros existentes usando o CRGPREFIX e o formato de número sequencial.
RPTCOLS Y Especifique uma das opções a seguir:
- N. Reporte somente os nomes de tabela que foram registrados durante a execução.
- Y. Reporte nos nomes de tabelas e colunas que foram registrados durante a execução.
STATUS - Especifique uma das opções a seguir: - A. Crie registros em um estado ativo.
- I. Crie registros em um estado inativo. 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 - Especifique uma máscara que restringe os registros a serem criados. Para tabelas relacionais, essa máscara é especificada no seguinte formato:
OWNER.TABLE
Se a fonte de dados não for relacional, esse mapa se relacionará à estrutura de mapa de dados e é especificado no seguinte formato: SCHEMA.MAPNAME
Você pode usar um caractere curinga asterisco (*) em qualquer parte do nome para especificar um grupo de tabelas, por exemplo:
OWNAB.T*
Nesse caso, todas as tabelas que têm o proprietário e um esquema que começa com a letra "T" serão registradas para captura de alterações. Para IMS, você também pode especificar um terceiro parâmetro para um nome de tabela. Use esse parâmetro quando várias tabelas são definidas em um mapa de dados, mas não todas as tabelas precisam ser registradas. Você pode incluir o caractere curinga asterisco (*) para criar um nome de máscara de tabela. Use o seguinte formato para esse parâmetro:
SCHEMA.MAPNAME.TABLENAME
Para fontes de dados não relacionais diferentes do IMS, o mesmo tipo de máscara está disponível para refinar a seleção, mas o formato é um pouco diferente:
Parâmetro Padrão Descrição
TESTRUN Y Especifique uma das opções a seguir:
- Y. Execute o utilitário e reportar os registros a serem atualizados ou adicionados. Nenhum registro será afetado por essa execução. - N. Execute o utilitário e adicionar/atualizar os registros.
UID - Especifica um ID de usuário que permite acessar a 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, mas não ambos.
Nota: Não é necessário especificar parâmetros que tenham valores padrão.