Instrução EPWD
A instrução EPWD especifica a senha criptografada associada ao ID de usuário especificado com a instrução USER.
Use a seguinte sintaxe: EPWD encrypted_password;
Você pode usar o comando Arquivo > Criptografar no Navegador do PowerExchange para obter uma senha criptografada.
A instrução EPWD ou PWD é obrigatória.
Instrução OUTPUT
A instrução OUTPUT especifica uma pasta de destino alternativa ou um conjunto de dados para os mapas ou registros de saída do destino padrão especificado no arquivo de configuração DBMOVER.
Use a seguinte sintaxe: OUTPUT folder_name; Essa instrução é opcional.
CUIDADO: Não use a instrução OUTPUT com a instrução REG_COPY se você usar também a instrução
CREATEXMAPS.
Instrução PWD
A instrução PWD especifica a senha associada ao ID de usuário especificado com a instrução USER. Use a seguinte sintaxe:
PWD password;
A instrução PWD ou EPWD é obrigatória.
Instrução REPLACE
A instrução REPLACE faz com que todos os mapas ou registros existentes no destino-alvo sejam substituídos pelos copiados. Você pode usar essa instrução para alterar atributos de mapa ou de registro, copiando de e para o mesmo local. Para se assegurar de não perder acidentalmente as informações de mapa ou registro existentes, use essa instrução com cuidado.
A instrução REPLACE não tem operandos. Essa instrução é opcional.
Instrução SOURCE
A instrução SOURCE especifica o nó de origem que é especificado no arquivo de configuração DBMOVER para mapas e registros.
Use a seguinte sintaxe: SOURCE source_node;
Essa instrução é opcional. O valor padrão é local.
Instrução TARGET
A instrução TARGET especifica o nó de destino (conforme especificado no arquivo de configuração DBMOVER) no qual copiar mapas e registros.
Use a seguinte sintaxe: TARGET target_node;
Essa instrução é opcional. O valor padrão é local. Você pode especificar o mesmo nome de nó nas instruções SOURCE e TARGET.
CUIDADO: Em sistemas z/OS, sempre inclua a instrução TARGET e especifique um nó de destino, de forma que
o Ouvinte do PowerExchange grave nos arquivos de destino. Se você usar o padrão local, poderá ocorrer contenção de arquivo intermitente, porque o trabalho DTLURDMO pode tentar gravar no arquivo quando o Ouvinte do PowerExchange já tem o arquivo no modo de gravação. Se o Ouvinte do PowerExchange sempre grava nos arquivos de destino, nenhuma contenção pode ocorrer.
Instrução TARGETEPWD
A instrução TARGETEPWD especifica a senha criptografada associada ao ID de usuário especificado com a instrução TARGETUSER.
Use a seguinte sintaxe:
TARGETEPWD encrypted_password;
Você pode usar o comando Arquivo > Criptografar no Navegador do PowerExchange para obter uma senha criptografada.
Se o arquivo de definição DTLURDMO incluir a instrução TARGETUSER, mas não incluir a instrução TARGETEPWD ou a instrução TARGETPWD, EPWD ou PWD especificarão a senha no sistema de destino.
Instrução TARGETPWD
A instrução TARGETPWD especifica a senha associada ao ID de usuário especificado com a instrução TARGETUSER.
Use a seguinte sintaxe: TARGETPWD password;
Se o arquivo de definição DTLURDMO incluir a instrução TARGETUSER, mas não incluir a instrução TARGETEPWD ou a instrução TARGETPWD, EPWD ou PWD especificarão a senha no sistema de destino.
Instrução TARGETUSER
A instrução TARGETUSER especifica o ID do usuário para acesso a mapas e registros no sistema de destino. Use a seguinte sintaxe:
TARGETUSER user_ID;
Essa instrução é opcional. Se ela não for especificada, a instrução USER especificará o ID do usuário nos sistemas de origem e de destino.
Instrução USER
A instrução USER especifica o ID do usuário para acesso a mapas e registros no sistema de origem. Se o arquivo de definição DTLURDMO não incluir uma instrução TARGETUSER, a instrução USER também especificará o ID do usuário no sistema de destino.
Use a seguinte sintaxe: USER user_ID;
Essa instrução é obrigatória.
Instrução VALIDATE
A instrução VALIDATE instrui DTLURDMO a ser executado no modo de teste, sem gravar no destino os mapas ou registros copiados. Usado em conjunto com a instrução DETAIL, VALIDATE permite que cenários de cópia sejam modelados sem confirmar qualquer alteração.
A instrução VALIDATE não tem operandos. Essa instrução é opcional.
Instrução DM_COPY
A instrução DM_COPY copia os mapas de dados da fonte para o sistema de destino. Essa instrução não tem operandos, mas pode ser acompanhada por outras instruções que filtram os objetos selecionados, os renomeiam ou alteram seus atributos.
A tabela a seguir resume as instruções opcionais que podem acompanhar a instrução DM_COPY:
Instrução Opcional Parâmetros
[EXCLUDE] [AM=access_method] [MAP=map_name] [SCHEMA=schema_name] [MODIFY] AM=access_method [DB2INSTANCE=db2_instance] [DB2TABLE=db2_table_name] [DBD=dbd_name] [DBID=database_ID] [DBNAME=database_name] [DDSNODENAME=ddsnode_name] [DICTNAME=dictionary_name] [FILEID=file_ID] [FN=file_name] [IMSID=ims_ID] [IMSTYPE=imstype] [MUFNAME=muf_name] [PCB=pcb_name] [PCBNUM=pcb_number] [PROGNAME=program_name] [PSB=psb_name] [SUBSCHEMA=subschema_name] [RENAME] [DBD=(old_dbd_name,new_dbd_name)] [MAP=(old_map_name,new_map_name)] [SCHEMA=(old_schema_name,new_schema_name)] [TABLE=(old_table_name,new_table_name)] [SELECT] [AM=access_method] [MAP=map_name] [SCHEMA=schema_name]
Instrução DM_COPY EXCLUDE
A instrução EXCLUDE especifica critérios de filtro para mapas de dados a serem excluídos explicitamente do processo de cópia. Você pode especificar várias instruções EXCLUDE para cada instrução DM_COPY. A instrução EXCLUDE é opcional. Por padrão, nenhum item é excluído.
A instrução EXCLUDE tem os seguintes parâmetros:
AM=access_method
Especifica o método de acesso dos mapas de dados a serem excluídos.
MAP=map_name
Especifica um nome de mapa a ser excluído.
SCHEMA=schema_name
Especifica um nome de esquema a ser excluído.
Os parâmetros da instrução EXCLUDE são os mesmos da instrução SELECT.
T
ÓPICOSR
ELACIONADOS:
¨ “Instrução DM_COPY SELECT” na página 77
Instrução DM_COPY MODIFY
A instrução MODIFY modifica os atributos dos mapas de dados copiados. A instrução MODIFY tem os seguintes parâmetros:
AM=access_method
Especifica o método de acesso ao qual a instrução MODIFY se aplica.
O método de acesso determina quais dos demais parâmetros MODIFY estão disponíveis, conforme mostrado na tabela a seguir:
Método de Acesso Parâmetros Disponíveis
ADABAS DBID, FILEID
CISAM FN
DB2 DB2TABLE, DB2INSTANCE
DB2UDB DB2TABLE, DB2INSTANCE
DB2UNLD FN, DB2TABLE, DB2INSTANCE
DCOM DBID, DBNAME, MUFNAME
DL1 DBD, IMSID, IMSTYPE, PCBNUM
ESDS FN
IDMS SUBSCHEMA, DBNAME, PROGNAME, DICTNAME, DDSNODENAME
IMS Nenhum
KSDS FN
MSSQL Nenhum
ODBA DBD, IMSID, IMSTYPE, PSB, PCB
Oracle Nenhum
RRDS FN
SEQ FN
DB2TABLE=db2_schema.db2_table_name
Modifica o esquema DB2 ou o nome da tabela mapeada pelo mapa de dados. Por exemplo: DB2TABLE=DSN8910.EMP
DB2INSTANCE=db2_instance
Modifica o nome ou o ID de subsistema do banco de dados DB2 dos dados mapeados pelo mapa de dados. Por exemplo:
DB2INSTANCE=sample
DBD=dbd_name
Modifica o nome do DBD dos dados mapeados pelo mapa de dados. Por exemplo: DBD=PROD001
O parâmetro DBD da instrução DM_COPY MODIFY ficou obsoleto, mas aceita retrocompatibilidade. Em vez disso, use a instrução DM_COPY RENAME com o parâmetro DBD para renomear um DBD em um mapa de dados.
DBID=database_ID
Especifica um novo ID de banco de dados a ser usado ao ler o banco de dados.
DBNAME=database_name
Especifica um novo nome de banco de dados a ser usado ao ler o banco de dados.
DDSNODENAME=ddsnode_name
Especifica um novo nome do DDSNODE a ser usado ao ler o banco de dados IDMS.
DICTNAME=dictionary_name
Especifica um novo nome de dicionário a ser usado ao ler o banco de dados IDMS.
FILEID=file_ID
Especifica um novo ID do arquivo do ADABAS para os dados mapeados pelo mapa de dados.
FN=filename
Especifica um novo nome para o arquivo de dados associado ao mapa de dados. O nome do arquivo deve ser válido no sistema de destino. Os exemplos a seguir especificam um novo nome de arquivo de dados para z/OS, VSAM e Windows, respectivamente:
FN='DATA01.SEQ.FILE' FN='SYS01.KSDS.DATA.FILE' FN=c:\myfolder\myfile.txt
IMSID=ims_ID
Especifica um novo ID do sistema IMS para os dados mapeados pelo mapa de dados. Por exemplo: IMSID=IMS7
IMSTYPE=ims_type
Especifica um novo tipo de IMS para os dados mapeados pelo mapa de dados. Especifique um dos seguintes valores: ¨ DEDB ¨ GSAM ¨ HDAM ¨ HIDAM ¨ HSAM ¨ HISAM ¨ MSDB ¨ PHDAM ¨ PHIDAM ¨ PSINDEX ¨ SHISAM MUFNAME=muf_name
Especifica um novo nome do MUF a ser usado ao ler o banco de dados Datacom.
PCB=pcb_name
Especifica um novo nome do PCB para os dados mapeados pelo mapa de dados. Por exemplo: PCB=PCB020
PCBNUM=pcb_number
Especifica um novo número de PCB para os dados mapeados pelo mapa de dados.
PROGNAME=program_name
Especifica um novo nome de programa a ser usado ao ler o banco de dados IDMS.
PSB=psb_name
Especifica um novo PSB para os dados mapeados pelo mapa de dados. Por exemplo: PSB=DTL003
SUBSCHEMA=subschema_name
Especifica um novo nome de subesquema a ser usado ao ler o banco de dados IDMS.
Instrução DM_COPY RENAME
A instrução RENAME especifica quais elementos do nome do mapa de dados são renomeados no sistema de destino. Para cada parâmetro, o primeiro operando representa um ou mais itens sendo renomeados, enquanto o segundo representa o novo nome. Por exemplo:
MAP=(map01,map02)
O primeiro operando pode ser qualquer um dos seguintes: ¨ O nome completo do item sendo renomeado
¨ Um nome parcial com um caractere curinga (*) ¨ Um caractere curinga (*) somente
Em cada caso, todos os itens correspondentes ao nome ou padrão especificado são renomeados para o valor do segundo operando.
DBD=(old_dbd_name,new_dbd_name)
Para o DL1 do IMS ou mapas de dados do ODBA, renomeie os DBDs no mapa de dados que corresponde ao nome ou padrão no primeiro operando para o nome especificado.
No exemplo a seguir, todos os DBDs chamados dbd01 são renomeados para dbd02: DBD=(dbd01,dbd02)
MAP=(old_map_name,new_map_name)
Renomeia para o nome especificado os mapas de dados que correspondem ao nome ou padrão do primeiro operando.
No exemplo a seguir, todos os mapas de dados denominados map01 são renomeados para map02: MAP=(map01,map02)
No exemplo a seguir, todos os mapas de dados são renomeados para newmap: MAP=(*,newmap)
No exemplo a seguir, todos nomes de mapas de dados que terminam com tmp são renomeados para
fixed:
MAP=(*tmp,fixed)
SCHEMA=(old_schema_name,new_schema_name)
Renomeia para o nome especificado os esquemas que correspondem ao nome ou padrão do primeiro operando.
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 para o nome especificado as tabelas que correspondem ao nome ou padrão do primeiro operando.
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 renomeados para fixed: TABLE=(*01,fixed)
Instrução DM_COPY SELECT
A instrução SELECT especifica os critérios de filtro para os mapas de dados a serem copiados. Você pode especificar várias instruções SELECT para cada instrução DM_COPY.
A instrução SELECT tem os seguintes parâmetros:
AM=access_method
Especifica o método de acesso do mapa de dados. access_method tem um dos seguintes valores:
Método de Acesso Fonte de dados
ADABAS Adabas
CISAM C-ISAM
DB2 DB2 para z/OS
DB2UDB DB2 para Linux, UNIX e Windows
DB2UNLD Descarregamento do DB2
DCOM Datacom
DL1 Lote DL/1 para IMS
ESDS VSAM ESDS
IDMS IDMS
IMS IMS
KSDS VSAM KSDS
MSSQL Microsoft SQL Server
ODBA IMS ODBA
Oracle Oracle
RRDS VSAM RRDS
SEQ Conjunto de dados sequenciais
MAP=map_name
Especifica um nome de mapa a ser selecionado, dentre os seguintes: ¨ O nome completo de um mapa de dados
¨ Um nome parcial com um caractere curinga (*) ¨ Um caractere curinga (*) somente
O exemplo a seguir especifica o mapa denominado sample: MAP=sample
O exemplo a seguir especifica os mapas que começam com sam: MAP=sam*
O exemplo a seguir especifica todos os mapas de dados: MAP=*
O padrão é *.
SCHEMA=schema_name
Especifica um nome de esquema a ser selecionado, que é um dos seguintes: ¨ O nome completo de um esquema de mapa de dados
¨ Um nome parcial com um caractere curinga (*) ¨ Um caractere curinga (*) somente
O exemplo a seguir especifica o esquema db2map: SCHEMA=db2map
O exemplo a seguir especifica os esquemas que começam com prod: SCHEMA=prod*
O exemplo a seguir especifica todos os esquemas: SCHEMA=*
O padrão é *.
Instrução REG_COPY
Use a instrução REG_COPY para copiar um registro de captura. Essa instrução não tem operandos, mas pode ser acompanhada por outras instruções que filtram os objetos selecionados, os renomeiam, alteram seus atributos, ou permitem funções opcionais.
A tabela a seguir resume as instruções opcionais que podem acompanhar a instrução REG_COPY:
Instrução Opcional Parâmetros
[CHECKXREF] Nenhum [CREATEXMAPS] [LOC={SOURCE|TARGET} [OUTPUT=alternative_pathname/data_set] [EXCLUDE] [DBID=database_instance] [DBTYPE=database_type] [REG_NAME=registration_name] [KEEPREGTAG] Nenhum [MODIFY] [CONDENSE={FULL|PART|NONE}] [DBID=database_ID] [DBNAME=database_name] [FILEID=file_ID] [FN=file_name] [MSOPTS=(DBSERVER=db_server,DBNAME=database_name)] [MUFNAME=muf_name] [NEW_DBID=database_instance] [SUBSCHEMA=subschema_name] [RELATED] BULK [RENAME] [BULKMAP=(old_map_name,new_map_name)] [BULKSCHEMA=(old_schema_name,new_schema_name)] [BULKTABLE=(old_table_name,new_table_name)] [DBD=(old_dbd_name,new_dbd_name] [IMSMAP=(old_map_name,new_map_name)] [IMSSCHEMA=(old_schema_name, new_schema_name)]
Instrução Opcional Parâmetros [REG_NAME=old_registration_name,new_registration_name)] [SCHEMA=(old_schema_name,new_schema_name)] [TABLE=(old_table_name,new_table_name)] [SELECT] [DBID=database_instance] [DBTYPE=database_type] [REG_NAME=registration_name] Observações:
¨ Não use a instrução OUTPUT com a instrução REG_COPY se você usar também a instrução CREATEXMAPS.
¨ Para usar o REG_COPY para copiar registros para um conjunto de dados CCT alternativo e criar mapas de extração, você deve conectar ao destino usando um Ouvinte do PowerExchange, em vez de usar o padrão de local na instrução TARGET.
¨ Se você incluir qualquer uma das seguintes instruções ou combinações de instruções e opções após a instrução REG_COPY, o DTLURDMO lerá o mapa de dados de IMS do sistema de destino:
-RENAME IMSSCHEMA -RENAME IMSMAP -CHECKXREF
¨ Se você copiar um registro que foi suspenso com o utilitário PWXUCREG, ocorre o seguinte processamento:
-Se o status de registro atual é Suspenso, o status será redefinido para Ativo.
-Os registros de data/hora de ativação e suspensão que definem a janela de suspensão são limpos.
Instrução REG_COPY CHECKXREF
Para origens de dados do IMS, a instrução CHECKXREF força o utilitário DTLURDMO a carregar o mapa de dados correspondente no sistema de destino e a atualizar o registro com a organização do banco de dados do DBD especificado no mapa de dados.
A instrução não tem parâmetros.
Se você precisar alterar o DBD para especificar uma organização de banco de dados diferente, você pode alterar o registro incluindo as instruções a seguir no fluxo de entrada:
REPLACE REG_COPY;
Parâmetros SELECT; CHECKXREF;
Ao processar essas instruções, o DTLURDMO carrega o mapa de dados no sistema de destino e no DBD, e atualiza o registro.
Instrução REG_COPY CREATEXMAPS
A instrução CREATEXMAPS cria um mapeamento de extração no sistema de destino. Use a seguinte sintaxe:
CREATEXMAPS
[LOC={SOURCE|TARGET}]
[OUTPUT=alternative_pathname|data_set] ;
A instrução REG_COPY tem os seguintes parâmetros opcionais:
LOC={SOURCE|TARGET}
Especifica se o mapa de dados usado para criar o mapeamento de extração será carregado na origem ou no destino local. O padrão é SOURCE.
OUTPUT=alternative_pathname|data_set
O mapeamento de extração é gravado no local alternativo. Essa função é análoga à especificada pela instrução OUTPUT.
Instrução REG_COPY EXCLUDE
A instrução EXCLUDE especifica critérios de filtro para registros a serem excluídos explicitamente do processo de cópia. Você pode especificar várias instruções EXCLUDE para cada instrução REG_COPY.
A instrução EXCLUDE é opcional. Por padrão, nenhum item é excluído. A instrução EXCLUDE tem os seguintes parâmetros:
REG_NAME=registration_name
Especifica um nome de registro a ser selecionado. Esse é o nome que foi especificado na criação do registro.
DBID=database_instance
Especifica a instância de banco de dados do registro. Por exemplo, dependendo da origem, a instância de banco de dados poderá representar o ID do subsistema ou o nome do banco de dados.
DBTYPE=database_type
Especifica o tipo de dados que está sendo capturado.
Os parâmetros da instrução EXCLUDE são os mesmos da instrução SELECT.
T
ÓPICOSR
ELACIONADOS:
¨ “Instrução REG_COPY SELECT” na página 84
Instrução REG_COPY KEEPREGTAG
A instrução KEEPREGTAG mantém a marca de registro original do registro que está sendo copiado ao gerar o mapa de extração. Essa instrução é válida apenas com a instrução CREATEXMAPS.
Não use a instrução KEEPREGTAG com as seguintes instruções REG_COPY: ¨ CHECKXREF ¨ MODIFY MUF_NAME ¨ MODIFY NEW_DBID ¨ RENAME DBD ¨ RENAME IMSMAP ¨ RENAME IMSSCHEMA ¨ RENAME REG_NAME
Essas instruções podem fazer com que uma marca de registro diferente seja gerada para o registro copiado e o mapa de extração.
Instrução REG_COPY MODIFY
A instrução MODIFY modifica os atributos especificados dos registros copiados. A instrução MODIFY tem os seguintes parâmetros:
CONDENSE={FULL|PART|NONE}
Especifica opções de condensação para os dados capturados no sistema de destino.
DBID=database_ID
Para os bancos de dados Adabas e Datacom, especifica um novo identificador de banco de dados.
DBNAME=database_name
Para bancos de dados IDMS, especifica um novo nome de banco de dados para o registro.
FN=file_name
Especifica o nome de arquivo associado ao registro. Por exemplo: FN=NEW.KSDS.FILE001
MSSOPTS=(DBSERVER=db_server,DBNAME=database_name)
Especifica as opções do SQL Server para o registro.
¨ db_server representa o novo ID do servidor de banco de dados para o registro. ¨ database_name representa o novo nome do banco de dados para o registro.
MUFNAME=muf_name
Para bancos de dados Datacom, especifica um novo nome MUF para o registro. Use esse parâmetro para especificar uma nova instância de banco de dados para o registro da mesma maneira que você pode usar o parâmetro NEW_DBID para outros tipos de banco de dados.
NEW_DBID=database_ID
Especifica uma nova instância de banco de dados para o registro. Dependendo da fonte de dados, o ID do banco de dados pode ser um ID de subsistema ou um nome de banco de dados.
SUBSCHEMA=subschema_name
Para bancos de dados IDMS, especifica um novo subesquema para o registro.
Instrução REG_COPY RELATED BULK
A instrução RELATED BULK mescla o mapa de extração em um mapa de dados em massa existente no sistema de destino.
Essa instrução só é válida em conjunto com a instrução CREATEXMAPS para registros do DB2 para z/OS ou DB2 para Linux, UNIX e Windows.
Use a seguinte sintaxe: RELATED BULK;
O nome do mapa de dados em massa que o DTLURDMO procura no sistema de destino depende de o mapa de extração original ter sido ou não mesclado em um mapa de dados no sistema de origem:
¨ Se o mapa de extração original associado ao registro no sistema de origem tiver sido mesclado em um mapa de dados em massa, o DTLURDMO usará o mesmo mapa de dados e o nome de tabela ao mesclar o mapa de extração gerado no sistema de destino.
¨ Se um mapa de dados em massa não tiver sido mesclado no mapa de extração original do sistema de origem, ou um mapa de extração não existir, um nome de mapa de dados em massa no formato a seguir será gerado para a mesclagem:
table_name.registration_name_table_name
Se o DTLURDMO não encontrar o mapa de dados em massa no sistema de destino, ele reportará o erro e continuará.
Você pode usar a instrução RENAME para modificar o nome do mapa de extração gerado ou o nome do mapa de dados em massa a ser mesclado nele.
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 mapa 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 cada parâmetro RENAME, o primeiro operando representa um ou mais itens sendo renomeados, enquanto