Durante o andamento normal do processamento de log do IDMS, o Catálogo de Logs será atualizado usando a combinação de DTLULCAT e DTLULOGC para adicionar o próximo log disponível. Você poderá precisar alterar detalhes de entradas de log ou remover logs do catálogo. Para fazer isso, será executado DTLULOGC (DTLULOGC JCL in RUNLIB) de forma independente com entrada codificada manualmente.
O utilitário permite ao usuário:
Atualizar uma entrada de log
Exportar uma entrada para outro conjunto de dados para descarregamento
A tabela a seguir mostra as palavras-chave e 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.
Adicione uma instância LOGSID ao catálogo. Cada LOGSID usado requer a adição de uma instância ao catálogo de logs.
A tabela a seguir mostra os parâmetros disponíveis para a palavra-chave ADD_INSTANCE:
INSTANCE_IDENTIFIER
| Valor LOGSID
|
VERSION
| Número de versão da entrada
|
Adiciona um log específico ao catálogo de logs.
A tabela a seguir mostra os parâmetros disponíveis para a palavra-chave ADD_ENTRY:
| Tamanho do bloco do log. Obrigatório se os logs forem enviados para outra plataforma.
|
| Número sequencial, que deverá ser incrementado em 1 para cada novo log adicionado ao catálogo.
|
| 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.
|
| Carimbo de data/hora do primeiro registro no bloco.
|
| Número de versão do IDMS. Especificado como número inteiro.
|
|
| ID do último registro no bloco, ou zeros, no caso de um registro diferente de dados.
|
| Deslocamento do último deslocamento válido no bloco.
|
| IDL para dados do log do MVS IDMS.
|
| Nome do arquivo de log do IDMS.
|
| AI. Contém somente Pós-imagens.
BI. Contém somente Pré-imagens.
BA. Contém Pré e Pós-imagens.
|
|
|
| Nome CV ou nome do trabalho em Modo Local.
|
|
| 2. Reservado para uso futuro.
|
| Número de versão da entrada.
|
Atualiza uma entrada de log. A entrada é identificada pelo valor de INSTANCE_IDENTIFIER e ENTRY_NUMBER.
Os parâmetros válidos são aqueles listados para ADD_ENTRY.
DELETE_ENTRY INSTANCE_IDENTIFIER=
instance_identifier
Exclui o log mais antigo do INSTANCE_IDENTIFIER especificado.
REPORT_INSTANCE INSTANCE_IDENTIFIER=
instance_identifier
Lista as entradas no catálogo para o INSTANCE_IDENTIFIER especificado.
EXPORT_INSTANCE INSTANCE_IDENTIFIER=
instance_identifier
Usado para exportar todas as informações de um INSTANCE_IDENTIFIER especificado para um arquivo.
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;
