Este utilitário produz o relatório de status de banco de dados, que fornece informações sobre o layout físico atual e conteúdo lógico de um banco de dados ou uma fita save (se o parâmetro SAVETAPE é especificado).
As informações prestadas no relatório de status de banco de dados inclui:
Você também pode produzir um documento XML contendo o relatório de status de banco de dados em formato XML. Este documento XML é estruturado como definida por um esquema XML arquivo de definição (adabas.xsd) fornecido no forum da comunidade on-line de discussão para Adabas. Uma folha de estilo (adabas.xsl) também está prevista a sua utilização no mesmo local. Você pode transferir esses arquivos XML do Fórum Adabas para qualquer sistema (provavelmente Windows ou Unix) usando ferramentas automatizadas ou programas gravados pelo usuário na linguagem de programação de sua escolha (Natural, Java,. Net, C, Perl ou Python). Além disso, a página de código da saída de XML pode ser controlado.
Report Syntax
Clique Aqui
As informações prestadas no relatório de status de banco de dados inclui:
- Nome do banco, número, data/hora de criação, o status do arquivo e número de registro atual.
- Quantidades (em cilindros e blocos) e as alocações do Associator, Data Storage e Work espaços usados atualmente, e também os espaços alocados não usados.
- Informações de RABN do Associator e Data Storage incluindo o tipo de dispositivo, número disco (volser), o número do arquivo (se necessário) e uso (AC, NI/UI, Armazenamento de Dados, DSST.
- Alterna a quantidades de blocos e locais do RABN (a partir de uma gravação da fita).
- por file, um resumo do ISN, extent, padding factor, used/unused Associator e Data Storage space, e opções do file;
- Informações do PPT.
- informações detalhadas (opcionalmente por arquivo) que inclui todas as informações de resumo, além configurações MINISN/MAXISN, configurações MUPEX, informações detalhadas do espaço, criação e data de uso/hora do último acesso, a field definition table (FDT) do contéudo e informações gerais sobre os arquivos e informações do checkpoint.
- informações sobre campos excluídos logicamente nos arquivos de banco de dados.
Você também pode produzir um documento XML contendo o relatório de status de banco de dados em formato XML. Este documento XML é estruturado como definida por um esquema XML arquivo de definição (adabas.xsd) fornecido no forum da comunidade on-line de discussão para Adabas. Uma folha de estilo (adabas.xsl) também está prevista a sua utilização no mesmo local. Você pode transferir esses arquivos XML do Fórum Adabas para qualquer sistema (provavelmente Windows ou Unix) usando ferramentas automatizadas ou programas gravados pelo usuário na linguagem de programação de sua escolha (Natural, Java,. Net, C, Perl ou Python). Além disso, a página de código da saída de XML pode ser controlado.
Report Syntax
Parâmetros Opcionais
ADAREP pode ser especificado apenas para obter um relatório de status de banco de dados. Opcionalmente, você pode personalizar o relatório de valores de parâmetro acrescentado.
ACODE: Identify Code Page for XML UTF-8 Output
Use o parâmetro ACODE somente se a opção utf8 é especificado no parâmetro OUTPUT. Este parâmetro identifica a página de código para que o nome do banco de dados, nomes de arquivos e nomes de ponto de verificação deve ser convertido. Esse parâmetro é especificado em três partes, em uma ordem específica, e com cada uma das partes separadas por uma vírgula dos outros:
ACODE=’database-name-codepage,file-name-codepage,checkpoint-name-codepage’
CPEXLIST: Imprimir lista do Checkpoint em formato Extendido
CPLIST : Imprimir lista do Checkpoint em formato Normal
Esses parâmetros são usados para imprimir a lista checkpoint list normal (CPLIST) ou formato (CPEXLIST) estendido. Ou CPEXLIST ou CPLIST deve ser especificado para exibir informações do checkpoint. CPEXLIST acrescenta as seguintes informações com as informações CPLIST normal, dependendo da origem do ponto de verificação:
* (utilitário ou Adabas Online System/Basic Services) nome da função;
* Os dados Checkpoint específicos.
Se o relatório CPEXLIST está a ser exibido, OFFSET também pode ser especificado para uma exibição mais legível. Os parâmetros FROMDATE, TODATE, FROMSESSION, e TOSESSION podem ser usado para indicar o intervalo dos pontos a serem impressos.
FILE or NOFILE: File Information to be Displayed or Suppressed
FILE define a lista de arquivos para que as informações de status que deverá ser impressa ou apresentada. Se este parâmetro for omitido, as informações de status para todos os arquivos serão incluídos.
Se NOFILE for especificado, a impressão de todos os arquivos e informações de descrição do campo é não aparecerá no relatório.
FROMDATE/ TODATE: Start/ End Checkpoint Dates for Report
Quando CPLIST ou CPEXLIST for especificado, de início específica e/ou datas de término de informação de ponto de verificação pode ser especificado. Exemplos de especificação de data válida YYYYMMDD são:
Se o FROMDATE não for especificado, o relatório começa com as primeiras informações de verificação do sistema (ou com o primeiro lugar na sessão FROMSESSION, se mais tarde); TODATE se não for especificado, o relatório continua até o checkpoint mais recente (ou termina com o último, na sessão TOSESSION).
FROMSESSION/ TOSESSION: Start/ End Session for Report
Especifique um início/ou número da sessão final. Sessões antes FROMSESSION / ou depois da sessão TOSESSION números não estão incluídos nas informações do relatório. Se o FROMSESSION não for especificado, o relatório começa com as primeiras informações de verificação do sistema (ou com a primeira na data FromDate, se mais tarde); TOSESSION se não for especificado, o relatório continua até o último ponto de verificação (ou acaba com o última na data ToDate, se mais cedo).
LAYOUT: Format Output for Printing
LAYOUT=1 especifica que o Contents of Database (conteúdo do banco de dados) a tabela deve ser impressa em uma único 120 - formato de caracteres da coluna. Normalmente, o Contents of Database (conteúdo do banco de dados) e o File Space Allocations das informações são apresentados em duas seções separadas do relatório. No entanto, quando LAYOUT=1 é especificado, são fundidos na sessão Contents of Database. Além disso, o fator de preenchimento é adicionado também.
LIMCOUNT or NOCOUNT: Counting of Number of Records Loaded
ADAREP lê o address converter para determinar o valor de registros carregados de um arquivo. Para arquivos muito grandes, isso pode resultar em uma grande quantidade de atividade de E/S. Se LIMCOUNT for especificado, ADAREP verifica o valor para TOPISN para o arquivo. Se TOPISN é maior do que 1000 "não contam"aparece em registros carregados.
Se NOCOUNT for especificado, nenhum valor é impresso para registros carregados para qualquer arquivo. Se nem LIMCOUNT nem NOCOUNT são especificados, ADAREP compila o valor exato de registros carregados para cada arquivo.
NOFDT: Suppress Printing of Field Definitions
A impressão da tabela de definição de campo (FDT) tera informações para cada arquivo deverá ser omitido. O FDT dos arquivos do Adabas Checkpoint e Security não são impressos pelo ADAREP.
NOLGLIST, NOPHLIST, or NOSTD: Suppress Database Layout Printing
Se NOLGLIST for especificado a informação do layout lógico de banco de dados deve ser omitido. Se NOPHLIST for especificado as informações de layout físico do banco de dados é omitido. Especificando NOSTD suprime todas as informações de layout de banco de dados, e é equivalente a especificar NOLGLIST e NOPHLIST.
NOPPT: Suppress PPT Information
Especifique o parâmetro NOPPT se você não quiser PPT informações incluídas no relatório.
NOUSERABEND: Termination without Abend
Quando for encontrado um erro enquanto a função do ADAREP estiver sendo executado, o programa imprime uma mensagem de erro e termina com o user abend 34 (com um dump) ou o user abend 35 (sem dump). Quando NOUSERABEND é especificado, ele deve ser especificado como o primeiro parâmetro (antes de todos os outros parâmetros) para a função de utilidade.
Se NOUSERABEND for especificado o utilitário não abend depois de imprimir a mensagem de erro. Em vez disso, a mensagem de "utility TERMINATED DUE TO ERROR CONDITION" é exibida e o utilitário termina com o condition code 20.
OFFSET: Defines Extended Report Line Alignment
O parâmetro OFFSET alinha o início da informação estendida com o fim das informações do ponto de verificação normal para a impressão em uma única linha. O padrão é 63. Para exibir informações estendidas OFFSET deve ser reduzida ou a porção alargada não pode ser mostrada dentro de 80 colunas.
OUTPUT: Create XML Report
Este parâmetro opcional deve ser usado quando você quer criar uma versão XML do relatório do banco de dados para além do normal. O formato do relatório XML pode ser convertido para EBCDIC ou UTF-8:
ADAREP pode ser especificado apenas para obter um relatório de status de banco de dados. Opcionalmente, você pode personalizar o relatório de valores de parâmetro acrescentado.
ACODE: Identify Code Page for XML UTF-8 Output
Use o parâmetro ACODE somente se a opção utf8 é especificado no parâmetro OUTPUT. Este parâmetro identifica a página de código para que o nome do banco de dados, nomes de arquivos e nomes de ponto de verificação deve ser convertido. Esse parâmetro é especificado em três partes, em uma ordem específica, e com cada uma das partes separadas por uma vírgula dos outros:
ACODE=’database-name-codepage,file-name-codepage,checkpoint-name-codepage’
CPEXLIST: Imprimir lista do Checkpoint em formato Extendido
CPLIST : Imprimir lista do Checkpoint em formato Normal
Esses parâmetros são usados para imprimir a lista checkpoint list normal (CPLIST) ou formato (CPEXLIST) estendido. Ou CPEXLIST ou CPLIST deve ser especificado para exibir informações do checkpoint. CPEXLIST acrescenta as seguintes informações com as informações CPLIST normal, dependendo da origem do ponto de verificação:
* (utilitário ou Adabas Online System/Basic Services) nome da função;
* Os dados Checkpoint específicos.
Se o relatório CPEXLIST está a ser exibido, OFFSET também pode ser especificado para uma exibição mais legível. Os parâmetros FROMDATE, TODATE, FROMSESSION, e TOSESSION podem ser usado para indicar o intervalo dos pontos a serem impressos.
FILE or NOFILE: File Information to be Displayed or Suppressed
FILE define a lista de arquivos para que as informações de status que deverá ser impressa ou apresentada. Se este parâmetro for omitido, as informações de status para todos os arquivos serão incluídos.
Se NOFILE for especificado, a impressão de todos os arquivos e informações de descrição do campo é não aparecerá no relatório.
FROMDATE/ TODATE: Start/ End Checkpoint Dates for Report
Quando CPLIST ou CPEXLIST for especificado, de início específica e/ou datas de término de informação de ponto de verificação pode ser especificado. Exemplos de especificação de data válida YYYYMMDD são:
ADAREP FROMDATE=19960101,TODATE=19960228 January 1-February 28, 1996
ADAREP FROMDATE=19951111 November 11, 1995 to checkpoint file end
ADAREP TODATE=19951223 From checkpoint file begin to (and including)
December 23, 1995Se o FROMDATE não for especificado, o relatório começa com as primeiras informações de verificação do sistema (ou com o primeiro lugar na sessão FROMSESSION, se mais tarde); TODATE se não for especificado, o relatório continua até o checkpoint mais recente (ou termina com o último, na sessão TOSESSION).
FROMSESSION/ TOSESSION: Start/ End Session for Report
Especifique um início/ou número da sessão final. Sessões antes FROMSESSION / ou depois da sessão TOSESSION números não estão incluídos nas informações do relatório. Se o FROMSESSION não for especificado, o relatório começa com as primeiras informações de verificação do sistema (ou com a primeira na data FromDate, se mais tarde); TOSESSION se não for especificado, o relatório continua até o último ponto de verificação (ou acaba com o última na data ToDate, se mais cedo).
LAYOUT: Format Output for Printing
LAYOUT=1 especifica que o Contents of Database (conteúdo do banco de dados) a tabela deve ser impressa em uma único 120 - formato de caracteres da coluna. Normalmente, o Contents of Database (conteúdo do banco de dados) e o File Space Allocations das informações são apresentados em duas seções separadas do relatório. No entanto, quando LAYOUT=1 é especificado, são fundidos na sessão Contents of Database. Além disso, o fator de preenchimento é adicionado também.
LIMCOUNT or NOCOUNT: Counting of Number of Records Loaded
ADAREP lê o address converter para determinar o valor de registros carregados de um arquivo. Para arquivos muito grandes, isso pode resultar em uma grande quantidade de atividade de E/S. Se LIMCOUNT for especificado, ADAREP verifica o valor para TOPISN para o arquivo. Se TOPISN é maior do que 1000 "não contam"aparece em registros carregados.
Se NOCOUNT for especificado, nenhum valor é impresso para registros carregados para qualquer arquivo. Se nem LIMCOUNT nem NOCOUNT são especificados, ADAREP compila o valor exato de registros carregados para cada arquivo.
NOFDT: Suppress Printing of Field Definitions
A impressão da tabela de definição de campo (FDT) tera informações para cada arquivo deverá ser omitido. O FDT dos arquivos do Adabas Checkpoint e Security não são impressos pelo ADAREP.
NOLGLIST, NOPHLIST, or NOSTD: Suppress Database Layout Printing
Se NOLGLIST for especificado a informação do layout lógico de banco de dados deve ser omitido. Se NOPHLIST for especificado as informações de layout físico do banco de dados é omitido. Especificando NOSTD suprime todas as informações de layout de banco de dados, e é equivalente a especificar NOLGLIST e NOPHLIST.
NOPPT: Suppress PPT Information
Especifique o parâmetro NOPPT se você não quiser PPT informações incluídas no relatório.
NOUSERABEND: Termination without Abend
Quando for encontrado um erro enquanto a função do ADAREP estiver sendo executado, o programa imprime uma mensagem de erro e termina com o user abend 34 (com um dump) ou o user abend 35 (sem dump). Quando NOUSERABEND é especificado, ele deve ser especificado como o primeiro parâmetro (antes de todos os outros parâmetros) para a função de utilidade.
Se NOUSERABEND for especificado o utilitário não abend depois de imprimir a mensagem de erro. Em vez disso, a mensagem de "utility TERMINATED DUE TO ERROR CONDITION" é exibida e o utilitário termina com o condition code 20.
OFFSET: Defines Extended Report Line Alignment
O parâmetro OFFSET alinha o início da informação estendida com o fim das informações do ponto de verificação normal para a impressão em uma única linha. O padrão é 63. Para exibir informações estendidas OFFSET deve ser reduzida ou a porção alargada não pode ser mostrada dentro de 80 colunas.
OUTPUT: Create XML Report
Este parâmetro opcional deve ser usado quando você quer criar uma versão XML do relatório do banco de dados para além do normal. O formato do relatório XML pode ser convertido para EBCDIC ou UTF-8:
| If you specify: | The XML report format will be: |
|---|---|
OUTPUT='XML' | EBCDIC |
OUTPUT='XML,UTF8' | Converted to UTF-8 (including all tags). When UTF-8 format is requested, you may also use the ACODE parameter to specify the specific code page to which the database base name, file names, and checkpoint names should be converted. |
Quando o parâmetro OUTPUT é especificado, demonstrações adicionais DD (DDXMLR1 e, opcionalmente, DDXMLR2) deve ser especificado no job do ADAREP. DDXMLR1 é obrigatória e identifica o conjunto de dados que a versão XML do relatório do banco de dados de base devem ser escritos. DDXMLR2 é usado para armazenar a versão XML de qualquer informação no relatório de verificação, pelo que é necessário somente se a informação de ponto de verificação é necessária para o relatório através de parâmetros CPLIST ou CPEXLIST. Os data sets especificados por estas declarações DD devem ter sidos criados com os parametros RECFM=VB, LRECL=512.
Os documentos XML resultante coincidem exatamente com os dados apresentados no relatório periódico, incluindo qualquer filtragem feito para o relatório (por exemplo, se NOFDT ou NOPPT são solicitados).
Uma vez que o documento XML é criado, ele pode ser transferido para uma máquina Windows ou UNIX e você pode usar seu próprio código ou outros instrumentos para transformá-la.
PLOGNUM: Protection Log Number
PLOGNUM especifica o número de registo de núcleo de proteção utilizados durante o ADASAV na operação SAVE. O número de registo de proteção do núcleo é fornecido na fita, para especificar um valor para o parâmetro PLOGNUM substitui a informação sobre a fita.
SAVETAPE: Print Save Tape Report
Se SAVETAPE for especificado, o relatório é impresso a partir de uma fita de SAVE. O objetivo da fita é salvar o relatório para determinar que o SAVE fita contém.
CPLIST/CPEXLIST não pode ser especificado com SAVETAPE. NOCOUNT deve ser especificado com SAVETAPE porque o ADAREP não contar o número de registros em um arquivo em uma fita salvar. Se CPLIST/CPEXLIST ou especificar o NOCOUNT o ADAREP imprime uma mensagem de alerta, alterações essas opções internamente, e continua o processamento.
SYN1/SYN4: Beginning Block Number
Os parametros de SYN1 e SYN4 são mutuamente exclusivos e especificar o número do bloco que contém o SYN1 ou SYN4 do checkpoint em que a operação de SAVE começou. Esses números são fornecidos bloco na fita, conforme apropriado, para especificar um valor para os parâmetros SYN1 ou SYN4 substitui a informação sobre a fita.
EXEMPLOS DE ADAREP
Exemplo 1 - Todas as informações do banco de dados, arquivo e de campo a serão impressos. Dados do Checkpoint não saira nesta listagem.
ADAREP REPORT
Exemplo 2 - Banco de dados e informações sobre os arquivos serão impressas. Dados do Checkpoint e definições de campo para cada arquivo não sairão no relatório.
ADAREP REPORT NOFDT
Exemplo 3 - Uma lista do Checkpoint (formato estendido), deverá ser impresso para todos os as informações do Checkpoint realizadas entre 01 de julho de 1998 e 15 de julho de 1998. Nenhuma outra informação está a ser impresso.
ADAREP CPEXLIST,FROMDATE=19980701,TODATE=19980715
ADAREP NOSTD,NOFILE
Exemplo 4 - Todo o banco, arquivo e informações dos campos dos arquivos serão impressos no relatório partir de uma fita do backup (SAVE). NOCOUNT é necessária porque ADAREP não contar o número de registros em um arquivo em uma fita save.
ADAREP REPORT SAVETAPE,NOCOUNT
Exemplo 5 - Todo o banco, arquivos, e dados do Checkpoint em formato extendidos serão impressos no relatório ADAREP e uma versão CML do relatório será produzido.
ADAREP CPEXLIST,OUTPUT='XML'
Exemplo 6 - Todo o banco, arquivos, informações de campo e dados do Checkpoint serão impressos no relatório ADAREP e uma versão XML do relatório será produzido e convertido para UTF-8.
ADAREP CPLIST,OUTPUT='XML,UTF8'
Exemplo 7 - Todo o banco, arquivos, e informações dos campos serão impresso no relatório ADAREP e uma versão XML do relatório será elaborado e convertidos para UTF-8. A página de código 37 serão utilizados para UTF-8 conversão de nomes de arquivo.
ADAREP REPORT OUTPUT='XML,UTF8',ACODE=',37'
Os documentos XML resultante coincidem exatamente com os dados apresentados no relatório periódico, incluindo qualquer filtragem feito para o relatório (por exemplo, se NOFDT ou NOPPT são solicitados).
Uma vez que o documento XML é criado, ele pode ser transferido para uma máquina Windows ou UNIX e você pode usar seu próprio código ou outros instrumentos para transformá-la.
PLOGNUM: Protection Log Number
PLOGNUM especifica o número de registo de núcleo de proteção utilizados durante o ADASAV na operação SAVE. O número de registo de proteção do núcleo é fornecido na fita, para especificar um valor para o parâmetro PLOGNUM substitui a informação sobre a fita.
SAVETAPE: Print Save Tape Report
Se SAVETAPE for especificado, o relatório é impresso a partir de uma fita de SAVE. O objetivo da fita é salvar o relatório para determinar que o SAVE fita contém.
CPLIST/CPEXLIST não pode ser especificado com SAVETAPE. NOCOUNT deve ser especificado com SAVETAPE porque o ADAREP não contar o número de registros em um arquivo em uma fita salvar. Se CPLIST/CPEXLIST ou especificar o NOCOUNT o ADAREP imprime uma mensagem de alerta, alterações essas opções internamente, e continua o processamento.
SYN1/SYN4: Beginning Block Number
Os parametros de SYN1 e SYN4 são mutuamente exclusivos e especificar o número do bloco que contém o SYN1 ou SYN4 do checkpoint em que a operação de SAVE começou. Esses números são fornecidos bloco na fita, conforme apropriado, para especificar um valor para os parâmetros SYN1 ou SYN4 substitui a informação sobre a fita.
EXEMPLOS DE ADAREP
Exemplo 1 - Todas as informações do banco de dados, arquivo e de campo a serão impressos. Dados do Checkpoint não saira nesta listagem.
ADAREP REPORT
Exemplo 2 - Banco de dados e informações sobre os arquivos serão impressas. Dados do Checkpoint e definições de campo para cada arquivo não sairão no relatório.
ADAREP REPORT NOFDT
Exemplo 3 - Uma lista do Checkpoint (formato estendido), deverá ser impresso para todos os as informações do Checkpoint realizadas entre 01 de julho de 1998 e 15 de julho de 1998. Nenhuma outra informação está a ser impresso.
ADAREP CPEXLIST,FROMDATE=19980701,TODATE=19980715
ADAREP NOSTD,NOFILE
Exemplo 4 - Todo o banco, arquivo e informações dos campos dos arquivos serão impressos no relatório partir de uma fita do backup (SAVE). NOCOUNT é necessária porque ADAREP não contar o número de registros em um arquivo em uma fita save.
ADAREP REPORT SAVETAPE,NOCOUNT
Exemplo 5 - Todo o banco, arquivos, e dados do Checkpoint em formato extendidos serão impressos no relatório ADAREP e uma versão CML do relatório será produzido.
ADAREP CPEXLIST,OUTPUT='XML'
Exemplo 6 - Todo o banco, arquivos, informações de campo e dados do Checkpoint serão impressos no relatório ADAREP e uma versão XML do relatório será produzido e convertido para UTF-8.
ADAREP CPLIST,OUTPUT='XML,UTF8'
Exemplo 7 - Todo o banco, arquivos, e informações dos campos serão impresso no relatório ADAREP e uma versão XML do relatório será elaborado e convertidos para UTF-8. A página de código 37 serão utilizados para UTF-8 conversão de nomes de arquivo.
ADAREP REPORT OUTPUT='XML,UTF8',ACODE=',37'
Clique Aqui
gostaria de saber se nao existe um argumento que me mostrasse no UNUSED STORAGE o resumo de cilindros nao usados por tipo de DD-NAME, pois quando se tem inumeros itens para cada DD-names fica trabalhoso e repetitivo ficar calculando numero de cilindros nao utilizados? Obrigado!
ResponderEliminarUma saída fácil para este problema é você criar um programa em Natural que lê o ADAREP a parte que você quer e mostre do jeito que você quer, eu mesmo queria monitorar o espaço (total/disponível) dos files e do banco depois de muito pesquisar como faria isso tive uma ajuda de uma colega que conhece muito natural e conseguimos criar um programa Natural que lê do ADAREP somente as informações que eu queria, conseguimos gravar em um file Adabas este monitoramento. O Adarep não dá para fazer este resumo que você quer.
ResponderEliminar