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.
Nota: 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
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)
Tópicos Relacionados:
• “Instrução REG_COPY RELATED BULK” na página 157