A tabela a seguir mostra os parâmetros disponíveis para codificação em um arquivo de 80 bytes, que você especifica como entrada no cartão SYSIN DD. Consulte a amostra de JCL.
Palavra-chave Parâmetro Descrição
ADD_INSTANCE Adicione uma instância LOGSID ao catálogo. Cada LOGSID usado requer a adição de uma instância ao catálogo de logs.
INSTANCE_IDENTIFIER Valor LOGSID.
VERSION Número de versão da entrada.
ADD_ENTRY Adiciona um log específico ao catálogo de logs.
BLOCK_SIZE Tamanho do bloco do log. Obrigatório se os logs forem enviados para outra plataforma. ENTRY_NUMBER Número sequencial, que deverá ser
incrementado em 1 para cada novo log adicionado ao catálogo.
FILE_TYPE - C. Log ou Diário de Serviço Central ou Compartilhado.
- L. Log ou Diário de Serviço em Modo Local ou Não Compartilhado. FIRST_RECORD_SEQUENCE_NUMBER Número de sequência do primeiro registro
no bloco.
FIRST_RECORD_TIME_STAMP Carimbo de data/hora do primeiro registro no bloco.
IDMS_VERSION Número de versão do IDMS. Especificado como número inteiro.
INSTANCE_IDENTIFIER Valor LOGSID
LAST_RECORD_IDENTIFIER ID do último registro no bloco, ou zeros, no caso de um registro diferente de dados. LAST_RECORD_OFFSET Deslocamento do último deslocamento
válido no bloco.
LOG_DATA_TYPE IDL para dados do log do MVS IDMS. LOG_FILE_NAME Nome do arquivo de log do IDMS. MEDIA_CONTENT - AI. Contém somente Pós-imagens.
- BI. Contém somente Pré-imagens. - BA. Contém Pré e Pós-imagens.
MEDIA_TYPE - D. Disco.
- T. Fita.
NUMBER_OF_BLOCKS Número de blocos no log.
SERVICE Nome CV ou nome do trabalho em Modo
Local.
STATUS - A. Ativo.
- S. Ignorar. - T. Concluir.
ENTRY_TYPE - 1. Entrada de arquivo.
- 2. Reservado para uso futuro.
Palavra-chave Parâmetro Descrição
VERSION Número de versão da entrada.
UPDATE_ENTRY Os parâmetros válidos são aqueles listados anteriormente para ADD_ENTRY.
Atualiza uma entrada de log. A entrada é identificada pelo valor de
INSTANCE_IDENTIFIER e ENTRY_NUMBER.
DELETE_ENTRY INSTANCE_IDENTIFIER Exclui o log mais antigo para o INSTANCE_IDENTIFIER especificado. REPORT_INSTANCE INSTANCE_IDENTIFIER Lista as entradas no catálogo para o
INSTANCE_IDENTIFIER especificado. EXPORT_INSTANCE INSTANCE_IDENTIFIER Usado para exportar para um arquivo todas
as informações de um
INSTANCE_IDENTIFIER especificado.
Nota: Os comandos de palavra-chave são separados por ponto-e-vírgula (;) e os parâmetros por vírgula (,).
A seguinte amostra de entrada adiciona duas instâncias (LOGSIDs), adiciona entradas (arquivos de log), exclui uma entrada, bem como reporta a instância LOGSIDA, a exporta para um arquivo (dtlulgce.txt) e finalmente a exclui:
ADD_INSTANCE INSTANCE_IDENTIFIER=LOGSIDA, VERSION=224;
ADD_ENTRY INSTANCE_IDENTIFIER=LOGSIDA, ENTRY_NUMBER=777, VERSION=0, ENTRY_TYPE=1, STATUS=A, LOG_DATA_TYPE=IDL, IDMS_VERSION=15, FILE_TYPE=C, MEDIA_TYPE=D, MEDIA_CONTENT=BI, SERVICE=IDMSE150, LOG_FILE_NAME=XXXXXXXXXXXXXXXXXXXXXXXXXXXX, BLOCK_SIZE=29000, NUMBER_OF_BLOCKS=445,
LAST_RECORD_OFFSET=1119, LAST_RECORD_IDENTIFIER=3, FIRST_RECORD_SEQUENCE_NUMBER=4, FIRST_RECORD_TIME_STAMP="05/03/03 10:55:01";
ADD_ENTRY INSTANCE_IDENTIFIER=LOGSIDA, ENTRY_NUMBER=778, VERSION=0, ENTRY_TYPE=1, STATUS=A, LOG_DATA_TYPE=IDL, IDMS_VERSION=15, FILE_TYPE=C, MEDIA_TYPE=D, MEDIA_CONTENT=BI, SERVICE=IDMSE150, LOG_FILE_NAME=MMMMMMMMMMMMMMMMMMMMMMMMMM, BLOCK_SIZE=29000, NUMBER_OF_BLOCKS=445,
LAST_RECORD_OFFSET=1119, LAST_RECORD_IDENTIFIER=3, FIRST_RECORD_SEQUENCE_NUMBER=4, FIRST_RECORD_TIME_STAMP="05/03/03 12:55:01";
ADD_ENTRY INSTANCE_IDENTIFIER=LOGSIDA, ENTRY_NUMBER=779, VERSION=0, ENTRY_TYPE=1, STATUS=A, LOG_DATA_TYPE=IDL, IDMS_VERSION=15, FILE_TYPE=C, MEDIA_TYPE=D, MEDIA_CONTENT=BI, SERVICE=IDMSE150, LOG_FILE_NAME=ZZZZZZZZZZZZZZZZZZCCCCCCCCCCCC, BLOCK_SIZE=29000, NUMBER_OF_BLOCKS=333,
LAST_RECORD_OFFSET=1119, LAST_RECORD_IDENTIFIER=3, FIRST_RECORD_SEQUENCE_NUMBER=4, FIRST_RECORD_TIME_STAMP="05/03/03 14:55:01";
ADD_INSTANCE INSTANCE_IDENTIFIER=ABCDE, VERSION=0;
ADD_ENTRY INSTANCE_IDENTIFIER=ABCDE, ENTRY_NUMBER=1, VERSION=0, ENTRY_TYPE=1, STATUS=A,
LOG_DATA_TYPE=IDL, IDMS_VERSION=15, FILE_TYPE=C, MEDIA_TYPE=D, MEDIA_CONTENT=BI, SERVICE=IDMSE15P, LOG_FILE_NAME=BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB, BLOCK_SIZE=29000, NUMBER_OF_BLOCKS=444,
LAST_RECORD_OFFSET=1112, LAST_RECORD_IDENTIFIER=2, FIRST_RECORD_SEQUENCE_NUMBER=3, FIRST_RECORD_TIME_STAMP="05/04/03 08:55:01";
ADD_ENTRY INSTANCE_IDENTIFIER=ABCDE, ENTRY_NUMBER=2, VERSION=0, ENTRY_TYPE=1, STATUS=A,
LOG_DATA_TYPE=IDL, IDMS_VERSION=15, FILE_TYPE=C, MEDIA_TYPE=D, MEDIA_CONTENT=BI, SERVICE=IDMSE15P, LOG_FILE_NAME=CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC, BLOCK_SIZE=29000, NUMBER_OF_BLOCKS=445,
LAST_RECORD_OFFSET=1119, LAST_RECORD_IDENTIFIER=3, FIRST_RECORD_SEQUENCE_NUMBER=4, FIRST_RECORD_TIME_STAMP="05/04/03 10:55:01";
UPDATE_ENTRY INSTANCE_IDENTIFIER=LOGSIDA, ENTRY_NUMBER=779, VERSION=0, ENTRY_TYPE=1, STATUS=A, LOG_DATA_TYPE=IDL, IDMS_VERSION=15, FILE_TYPE=C, MEDIA_TYPE=D, MEDIA_CONTENT=BI, SERVICE=DTLXXXXX, LOG_FILE_NAME=AAAAAAAAAAAAAAKKKKKKKKKKKKKKK, BLOCK_SIZE=29000, NUMBER_OF_BLOCKS=111,
LAST_RECORD_OFFSET=1119, LAST_RECORD_IDENTIFIER=3, FIRST_RECORD_SEQUENCE_NUMBER=4, FIRST_RECORD_TIME_STAMP="05/04/03 12:55:01";
DELETE_ENTRY INSTANCE_IDENTIFIER=LOGSIDA; REPORT_INSTANCE INSTANCE_IDENTIFIER=LOGSIDA; EXPORT_INSTANCE INSTANCE_IDENTIFIER=LOGSIDA; DELETE_INSTANCE INSTANCE_IDENTIFIER=LOGSIDA;
Diretrizes para Adicionar Logs ao Catálogo com os
Utilitários DTLULCAT e DTLULOGC
Tome cuidado com a ordem na qual os logs são adicionados ao catálogo. Devem ser desenvolvidos procedimentos operacionais para a execução de DTLULCAT e DTLULOGC para garantir que os logs sejam adicionados na sequência correta.
O método preferencial de operação visa que DTLULCAT e DTLULOGC sejam incluídos no trabalho do log de arquivo morto (executado em conjunto usando a JCL DTLULCAU) submetido por um WTOEXIT que intercepta uma mensagem gravada no operador. As etapas a seguir precisam ser incluídas nesse trabalho:
1. O diário ativo será descarregado em um log de arquivo morto.
2. O log do arquivo morto deverá ser gravado em um arquivo, usando um programa utilitário como o IEBGENER, que pode ser mantido como um nome de conjunto de dados exclusivo (um GDG é a estrutura de conjunto de dados ideal). Essa cópia do log deverá ser mantida até que todas as alterações tenham sido capturadas pelo PowerExchange. Esse arquivo será adicionado ao Catálogo de Logs do PowerExchange pelas etapas a seguir.
3. Execute DTLULCAT para gerar instruções de entrada para DTLULOGC. 4. Execute DTLULOGC para atualizar o Catálogo de Logs do PowerExchange.
Quando as Versões Centrais forem colocadas off-line para execução em Modo Local, verifique se os logs em Modo Local foram adicionados antes de qualquer novo log de Versão Central. Se um banco de dados, anteriormente colocado off-line, for subsequentemente recolocado on-line e o log em Modo Local não for adicionado imediatamente, depois se um log posterior for adicionado ao catálogo e for feita uma tentativa subsequente de adicionar o log em Modo Local, isso falhará.
A regra usada para verificar essas adições de log é:
¨ Um diário em modo local não deverá ser adicionado ao catálogo se o último carimbo de data/hora disponível no diário for posterior ao carimbo de data/hora do diário em modo CV adicionado anteriormente.
¨ Se forem adicionados logs na sequência incorreta, espera-se ver mensagens semelhantes às seguintes: 51007 162240 MVS 1 PWX-19862 IDMS CATLG FILE: Add Entry Failure - Timestamp not greater than previous for key XYLOGSID000000000000000000001AIDL15CDBAIDMSE150DTLUSR.IDMS.D15SP0.OFF.J4
CA P Í T U L O
1 2
DTLURDMO - Utilitário de Mapa de
Dados
Este capítulo inclui os seguintes tópicos: ¨ Visão Geral do Utilitário DTLURDMO, 68
¨ Sistemas Operacionais Suportados para o Utilitário DTLURDMO, 68 ¨ Visão Geral das Instruções de Controle do Utilitário DTLURDMO, 69 ¨ Sintaxe das Instruções de Controle do Utilitário DTLURDMO, 69 ¨ Instruções de Controle e Parâmetros do Utilitário DTLURDMO , 70 ¨ Executando o Utilitário DTLURDMO no i5/OS, 90
¨ Executando o Utilitário DTLURDMO no Linux, UNIX e Windows, 90 ¨ Executando o Utilitário DTLURDMO no z/OS, 90
¨ Exemplos do Utilitário DTLURDMO, 91 ¨ Escopo de Operandos, 95
Visão Geral do Utilitário DTLURDMO
Use o utilitário DTLURDMO para copiar os seguintes tipos de definições de um ambiente ou local para outro: ¨ Mapas de dados do PowerExchange
¨ Registros de captura do PowerExchange ¨ Mapas de extração do PowerExchange
Ao realizar uma cópia, você pode opcionalmente alterar alguns atributos do novo registro de captura, mapa de dados ou mapa de extração, como o nome de esquema ou de tabela.
Sistemas Operacionais Suportados para o Utilitário
DTLURDMO
Você pode executar o utilitário DTLURDMO nas seguintes plataformas: ¨ i5/OS
¨ Linux, UNIX e Windows ¨ MVS
Visão Geral das Instruções de Controle do Utilitário
DTLURDMO
A seguir, os tipos de instruções de controle DTLURDMO:
¨ As instruções globais controlam a execução geral de programas ou oferecem informações básicas, como nome de usuário ou senha. As instruções globais permanecem ativas durante toda a execução do DTLURDMO. Você pode incluí-las apenas uma vez no arquivo ou no fluxo de entrada.
¨ As instruções de cópia especificam o tipo de cópia a ser feita: -DM_COPY copia mapas de dados.
-REG_COPY copia registros de captura e, opcionalmente, mapas de extração. -XM_COPY copia mapas de extração.
As instruções de cópia não têm operandos, mas podem ser seguidas por instruções opcionais. Somente um único tipo de instrução de cópia pode aparecer no arquivo ou fluxo de entrada, mas pode aparecer várias vezes.
¨ Instruções opcionais acompanham uma instrução de cópia e são válidas apenas no escopo da execução da instrução de cópia. As instruções opcionais tornam-se inativas quando o PowerExchange encontra uma instrução de cópia subsequente. As instruções opcionais filtram os objetos selecionados, os renomeiam, alteram seus atributos e definem funções opcionais para a cópia.
Sintaxe das Instruções de Controle do Utilitário
DTLURDMO
O arquivo de definição DTLURDMO inclui as seguintes instruções de controle: [OUTPUT folder_name;]
USER user_ID;
[PWD password|EPWD encrypted_password]; [TARGETUSER target_user_ID;]
[TARGETPWD password|TARGETEPWD encrypted_password;] SOURCE source_node; TARGET target_node; [REPLACE;] [DETAIL;] [VALIDATE;] [DM_COPY; [DM_COPY_optional_statements;]] [REG_COPY; [REG_COPY_optional_statements;]] [XM_COPY; [XM_COPY_optional_statements;]]
Na sintaxe, as instruções ou os parâmetros colocados entre colchetes ([]) são opcionais. Aplicam-se as seguintes regras e diretrizes:
¨ Todas as instruções de controle devem terminar com ponto-e-vírgula (;). ¨ As instruções e os parâmetros não diferenciam maiúsculas de minúsculas.
¨ Os operandos de comparação, como aqueles usados para filtrar objetos, diferenciam maiúsculas de minúsculas.
¨ Os operandos usados para renomear ou modificar atributos de objetos diferenciam maiúsculas de minúsculas.
¨ Os parâmetros colocados entre parênteses e separados por vírgula devem ser especificados nesse formato.
¨ Especifique exatamente uma instrução PWD ou EPWD.
¨ Especifique exatamente um tipo de instrução de cópia: DM_COPY, REG_COPY ou XM_COPY. Você pode especificar essa instrução uma ou diversas vezes.
¨ Instruções opcionais acompanham uma instrução de cópia e são válidas apenas no escopo da execução da instrução de cópia.
Nota: Antes de usar um arquivo de definição DTLURDMO, usado com uma liberação anterior do produto,
verifique se sua sintaxe está consistente com a descrita neste tópico.
T
ÓPICOSR
ELACIONADOS:
¨ “Instruções de Controle e Parâmetros do Utilitário DTLURDMO ” na página 70
Instruções de Controle e Parâmetros do Utilitário
DTLURDMO
Esta seção descreve as instruções de controle e seus parâmetros. A seção é organizada da seguinte forma: ¨ Instruções globais
¨ Instrução DM_COPY ¨ Instrução REG_COPY ¨ Instrução XM_COPY
A discussão de cada instrução de cópia inclui uma descrição de suas instruções opcionais e seus parâmetros.
Instruções Globais
As instruções globais permanecem ativas durante toda a execução do DTLURDMO. Você pode incluí-las apenas uma vez no arquivo ou fluxo de entrada.
As seguintes instruções DTLURDMO são globais: ¨ DETAIL ¨ EPWD ¨ OUTPUT ¨ PWD ¨ REPLACE ¨ SOURCE ¨ TARGET ¨ TARGETEPWD ¨ TARGETPWD ¨ TARGETUSER ¨ USER ¨ VALIDATE
Instrução DETAIL
A instrução DETAIL faz com que DTLURDMO imprima um relatório detalhado contendo informações sobre o processo de cópia que incluem todas as alterações e renomeações que foram feitas.
A instrução DETAIL não tem operandos. Essa instrução é opcional.