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. EDMXLUTL - Utilitário do Marcador de Eventos
  18. HOSTENT - Utilitário Gerador de Relatórios de Endereços TCP/IP
  19. PWXCATMY - Utilitários de catálogo do MySQL
  20. PWXUCCLPRT - Utilitário de resumo de log de impressão
  21. PWXUCDCT - Utilitário do Agente de Log do PowerExchange para Linux, UNIX e Windows
  22. PWXUCREG - Utilitário de Suspensão de Registro de Captura
  23. PWXUCRGP - Utilitário de Impressão de Registros de Captura
  24. PWXUDMX - Utilitário de Memória ECSA de Hora de Atualização dos Mapas de Dados
  25. PWXUGSK - Utilitário de Relatório SSL do z/OS
  26. PWXUMAP - Utilitário de lista de mapas
  27. PWXUSSL - Utilitário de Relatório SSL do PowerExchange

Instrução REG_COPY RENAME

Instrução REG_COPY RENAME

A instrução RENAME renomeia elementos do registro de captura copiado no sistema de destino ou identifica um mapa de dados em massa existente no sistema de destino que está nomeado de forma diferente do padrão.
  • Para os parâmetros DBD, IMSMAP, IMSSCHEMA, REG_NAME, SCHEMA e TABLE, a instrução RENAME especifica o novo nome do elemento de registro no sistema de destino.
  • Para os parâmetros BULKSCHEMA, BULKMAP e BULKTABLE, a instrução RENAME identifica o mapa de dados em massa no sistema de destino a ser mesclado no mapeamento de extração recém-gerado. Use esses parâmetros se o mapa de dados em massa no sistema de destino estiver nomeado de forma diferente do padrão.
    Esses parâmetros estão disponíveis somente nos sistemas DB2 para z/OS ou DB2 para Linux, UNIX e Windows.
Para a maioria dos parâmetros RENAME, o primeiro operando representa um ou mais itens que estão sendo renomeados, enquanto o segundo representa o novo nome. O primeiro operando pode ser qualquer um dos seguintes:
  • O nome completo de um item
  • Um nome parcial com um caractere curinga (*)
  • Um caractere curinga (*) somente
A instrução RENAME tem os seguintes parâmetros:
BULKMAP=(
old_map_name
,
new_map_name
)
Especifica um novo nome de mapa a ser usado ao localizar o mapa de dados em massa no sistema de destino para mesclagem no mapeamento de extração copiado. O parâmetro BULKMAP da instrução RENAME só é válido em conjunto com a instrução RELATED BULK.
No exemplo a seguir, todos os mapas denominados
capture1
são renomeados para
capture2
:
BULKMAP=(capture1,capture2)
No exemplo a seguir, todos os mapas são renomeados para
newmap
:
BULKMAP=(*,newmap)
No exemplo a seguir, todos os nomes de mapas que terminam com
01
são renomeados para fixed:
BULKMAP=(*01,fixed)
BULKSCHEMA=(
old_schema_name
,
new_schema_name
)
Especifica um novo nome de esquema a ser usado ao localizar o mapa de dados em massa no sistema de destino para mesclagem no mapeamento de extração copiado. O parâmetro BULKSCHEMA da instrução RENAME só é válido em conjunto com a instrução RELATED BULK.
No exemplo a seguir, todos os esquemas em massa denominados
test
são renomeados para
prod
:
BULKSCHEMA=(test,prod)
No exemplo a seguir, todos os esquemas em massa são renomeados para
newprod:
BULKSCHEMA=(*,newprod)
No exemplo a seguir, todos os esquemas que terminam com
tmp
são renomeados para
fixed
:
BULKSCHEMA=(*tmp,fixed)
BULKTABLE=(
old_table_name
,
new_table_name
)
Especifica um novo nome de tabela a ser usado ao localizar o mapa de dados em massa no sistema de destino para mesclagem no mapeamento de extração copiado. O parâmetro BULKTABLE da instrução RENAME só é válido em conjunto com a instrução RELATED BULK.
Nesse exemplo, todos os nomes de tabela
testtab01
são renomeadas para
prodtab01
:
BULKTABLE=(testtab01t,prodtab01)
Nesse exemplo, todas as tabelas são renomeadas para
newtable
:
BULKTABLE=(*,newtable)
Nesse exemplo, todas as tabelas que terminam com
01
são renomeadas para
fixed
:
BULKTABLE=(*01,fixed)
DBD=(
old_dbd_name,new_dbd_name
)
Para origens de dados do IMS, especifica um novo nome DBD para o registro de captura. DTLURDMO carrega o DBD correspondente no sistema de destino e atualiza o registro com a organização do banco de dados.
O DBD especificado em uma instrução RENAME tem precedência sobre o nome do DBD derivado de um mapa especificado por IMSSCHEMA ou IMSMAP.
IDMS_PAGEGROUP_RADIX=(
old_page_group
,
new_page_group
,
old_radix
,
new_radix
)
Para fontes de dados do IDMS, altera o valor de grupo de páginas ou de base. Esse parâmetro permite que registros e mapeamentos de extração sejam migrados para ambientes com valores diferentes para as configurações de banco de dados de grupo de páginas e de base.
Para
old_page_group
e
new_page_group
, especifique um valor de 0 a 32767.
Para
old_radix
e
new_radix
, especifique um valor de 2 a 12.
Você pode criar um mapa de extração no sistema de destino com valores renomeados de grupo de páginas e de base usando as instruções REG_COPY, CREATEXMAPS LOC=TARGET e RENAME IDMS_PAGEGROUP_RADIX. Antes de emitir essas instruções, você deve copiar o mapa de dados para a plataforma de destino usando a instrução DM_COPY. Se o mapa de dados não estiver correto na plataforma de destino, os resultados das instruções REG_COPY e instruções opcionais acompanhantes serão imprevisíveis.
IMSMAP=(
old_map_name,new_map_name
)
Renomeia mapas de dados do IMS que correspondem ao nome ou padrão no antigo nome do mapa de dados para o novo nome do mapa de dados. O utilitário carrega o mapa de dados especificado no sistema de destino e atualiza o registro com a organização do banco de dados usando o DBD denominado no mapa de dados.
No exemplo a seguir, todos os esquemas denominados
test
são renomeados para
prod
:
IMSMAP=(test,prod)
IMSSCHEMA=(
old_schema_name,new_schema_name
)
Renomeia os esquemas do IMS que correspondem ao nome ou ao padrão do nome de esquema antigo. O utilitário carrega o mapa de dados especificado no sistema de destino e usa o DBD denominado no mapa de dados para atualizar as informações de organização do banco de dados organização no registro.
O novo nome de esquema deve corresponder ao nome de esquema de um mapa de dados em massa existente no sistema de destino.
No exemplo a seguir, todos os esquemas denominados
test
são renomeados para
prod
:
IMSSCHEMA=(test,prod)
NRDB_DM_TABLE=(
old_map_name
,
new_map_name
,
old_table_name
,
new_table_name
)
Para fontes de dados do IDMS, identifica os novos e antigos mapas de dados e nomes de tabela. Esse parâmetro permite que o registro se vincule a um mapa de dados que possui uma nova identidade no novo ambiente.
NRDB_DM_TABLE somente será necessária se o mapa de dados contiver informações necessárias para extrações do CDC. Especificamente, ele é necessário para propagar alterações no valor do grupo de páginas ou de base para o mapeamento de extração.
As seguintes regras se aplicam:
  • Use o seguinte formato para
    old_map_name
    e
    new_map_name
    :
    schema_name
    .
    data_map_name
    schema_name
    e/ou
    data_map_name
    podem ser formados, total ou parcialmente, por curingas, como nos exemplos a seguir:
    *.test_map
    test_schema.*
    test*.*
  • Se você omitir
    old_map_name
    e
    new_map_name
    , inclua vírgulas como espaços reservados, da seguinte maneira:
    NRDB_DM_TABLE=(,,
    old_table_name
    ,
    new_table_name
    )
  • É possível omitir
    old_table_name
    e
    new_table_name
    . Se você os incluir, especifique o nome completo da tabela, sem curingas.
REG_NAME=(
old_registration_name
,
new_registration_name
)
Renomeia o registro. Como o nome de registro é usado para criar a marca de registro, essa opção substitui a opção KEEPREGTAG.
SCHEMA=
old_schema_name,new_schema_name
Renomeia os esquemas que correspondem ao nome ou padrão do nome de esquema antigo para o novo.
No exemplo a seguir, todos os esquemas denominados
test
são renomeados para
prod
:
SCHEMA=(test,prod)
No exemplo a seguir, todos os esquemas são renomeados para
newprod
:
SCHEMA=(*,newprod)
No exemplo a seguir, todos os esquemas que terminam com
tmp
são renomeados para
fixed
:
SCHEMA=(*tmp,fixed)
TABLE=
old_table_name,old_table_name
Renomeia as tabelas que correspondem ao nome ou padrão do nome de tabela antigo para o novo.
No exemplo a seguir, todas as tabelas denominadas
testtab01
são renomeadas para
prodtab01
:
TABLE=(testtab01,prodtab01)
No exemplo a seguir, todas as tabelas são renomeadas para
newtable
:
TABLE=(*,newtable)
No exemplo a seguir, todas as tabelas que terminam com
01
são renomeadas para
fixed
:
TABLE=(*01,fixed)