Utilitário Adabas - ADADEF

Visão geral funcional

As seguintes características de banco de dados são definidas com ADADEF:

• Nome do banco de dados e ID
• * Componentes de banco de dados (Associator, Data Storage, e Work)
• * tipo de dispositivo
• Tamanho
• Arquivo de sistema de checkpoint
• Codificações padrão do banco de dados
• Componentes de banco de dados

Cada componente de banco de dados (Associator, Data Storage, e Work) deve ser formatado pelo utilitário ADAFRM antes de ser definido com ADADEF. O utilitário ADADEF também pode ser usado para definir um novo dataset de Work para um banco de dados existente.

Os sistemas que usam o recurso Recovery Aid requerem um dataset de log de recuperação (RLOG), que deve primeiro ser formatado com o utilitário ADAFRM e, em seguida, definido usando o utilitário ADARAI.

Arquivo de Checkpoint

O Adabas usa o arquivo de sistema de Checkpoint para armazenar dados de checkpoint e dados de usuário fornecidos com os comandos Adabas CL e ET. É requerido e deve ser especificado usando a função ADADEF DEFINE (database).

DEFINE: Definir um Banco de dados e Arquivo de Checkpoint

O banco de dados e o arquivo de checkpoint devem ser definidos ao mesmo tempo.

Os parâmetros de banco de dados incluem os parâmetros ASSOSIZE, DATASIZE e WORKSIZE necessários e os parâmetros opcionais (não opcionais) ASSODEV através de WORKDEV mostrado no diagrama de sintaxe.

A instrução FILE = ..., CHECKPOINT, ... também é necessária para a definição do banco de dados. Os parâmetros de arquivo de checkpoint (identificada sob a instrução FILE no diagrama de sintaxe) devem ser especificados imediatamente após a instrução FILE.

ASSOSIZE/DATASIZE/WORKSIZE: Tamanho da base de dados

ASSO/DATA/WORKSIZE especifica o número de blocos ou cilindros a serem atribuídos ao Associador, Data Storage ou para Work. Um valor de bloco deve ser seguido por "B"; Caso contrário, o valor é assumido como cilindros. Se o Associador ou o Data Storage estiver contido em mais de um dataset, o tamanho de cada dataset deve ser especificado.

Se um parâmetro associado ao ASSODEV ou DATADEV especifica duas ou mais extensões, o ou parâmetro equivalente de ASSOSIZE ou DATASIZE deve especificar os tamanhos de extensão como operandos posicionais na ordem correspondente. O WORKSIZE mínima permitido é de 300 blocos.

Nota:

Se ASSOSIZE ou DATASIZE não for especificado, o função ADADEF DEFINE não será executada. Se WORKSIZE não for especificado, a função irá alocar três (3) cilindros para o dataset de Work. Porque 3 cilindros geralmente não são suficientes para iniciar o banco de dados, WORKSIZE é considerado um parâmetro necessário.

DSSIZE: Tamanho do Data Storage

DSSIZE especifica o número de blocos ou cilindros a serem atribuídos ao Checkpoint/Data Storage. Para blocos, o valor especificado deve ser seguido por "B" (por exemplo, DSSIZE=80B). O tamanho do arquivo de Checkpoint especificado com os parâmetros DSSIZE e MAXDS depende: A quantidade de dados ET a serem armazenados; O número de execuções de utilidade para as quais as informações de ponto de verificação devem ser mantidas; O número de IDs de usuário.

FILE: Parâmetro CHECKPOINT

O parâmetro FILE ... CHECKPOINT indica o número de arquivo a ser usado para o arquivo de sistema do checkpoint. Este parâmetro é necessário; O número do arquivo deve ser 255 ou inferior. A Adabas usa o arquivo de sistema de checkpoint para armazenar dados de checkpoint e dados de usuário fornecidos com os comandos Adabas CL e ET.

MAXISN: Maior ISN a ser usado

O ISN mais alto que pode ser atribuído ao arquivo. O valor especificado é usado para determinar a alocação de espaço para o address converter. Ao determinar o MAXISN, considere a importância dos dados ET e dos dados de checkpoint no seu site. A Adabas considera que os dados de ET são mais importantes do que os dados de checkpoint.

Assim que a range ISN de dados ET no file do sistema de checkpoint estiver esgotada, o primeiro checkpoint ISN dado é eliminado aos dados ET. Esse é um processo em andamento. Assim que a MAXISN for atingido, uma nova extensão de address converter é atribuída e dada aos dados de checkpoint. Você pode excluir dados de checkpoint um a um usando a função DELCP do Adabas Online System.

Nota:

A forma como o checkpoint manipula dados está sujeita a alterações em futuras versões do Adabas.

Parâmetros opcionais

ACRABN/DSRABN/NIRABN/UIRABN: Alocação do RABN

Esses parâmetros podem ser usados para causar alocação para suas respectivas áreas para começar com o especificado RABN:

ACRABN para o address converter;
DSRABN para Data Storage;
NIRABN para o normal index;
UIRABN para o upper index;

ASSODEV/DATADEV/WORKDEV: Tipo de Device

ASSO/DATA/WORKDEV especifica o(s) tipo(s) de device a ser atribuído ao Associador, Data Storage, e Work. Esses parâmetros são necessários somente se o tipo de device a ser usado for diferente do especificado com o parâmetro ADARUN DEVICE. WORKDEV, se especificado, só pode ser um tipo de dispositivo. Se o Associador (ASSODEV) ou o Data Storage (DATADEV) deve estar contido em mais de um dataset, o tipo de device para cada dataset deve ser especificado, mesmo se ambos os extents estiverem no tipo ADARUN DEVICE. Se múltiplos extents são usados com datasets VSAM, ASSODEV e DATADEV devem refletir o tipo de device dinâmico; Ou seja, DD/xxxxR1=9999; DD xxxxR2=8888; ... DD/xxxxR5=5555. Por exemplo, ao definir DDDATAR1 e DDDATAR2, DATADEV = 9999,8888. A alocação de espaço para tipos de device especificados devem ser dada em parâmetros ASSOSIZE, DATASIZE e WORKSIZE associados nesta ou em outra instrução ADADEF no mesmo job. Se um parâmetro ASSODEV ou DATADEV especifica mais de uma extensão no mesmo ou em diferentes tipos de device (DATADEV=3380,3350, por exemplo), o parâmetro ASSOSIZE ou DATASIZE associado deve especificar os tamanhos de extensão relacionados na ordem correspondente.

ASSOPFAC / DATAPFAC: Fator de preenchimento

ASSOPFAC define a porcentagem de espaço em cada bloco RABN do Associador a ser reservado para entradas posteriores (espaço de preenchimento em inglês padding space). Este espaço é usado para extensões descritor posterior ou adições de ISN. O valor de porcentagem especificado, que pode variar 1-90, deve ser grande o suficiente para evitar a sobrecarga causada quando estouro de bloco força a divisão de um bloco de endereço existente em dois novos blocos. Se ASSOPFAC não for especificado, ADADEF assume um fator de preenchimento de 10%. DATAPFAC define a porcentagem de espaço em cada bloco RABN de Data Storage para reserva para entradas posteriores (espaço de preenchimento). Esse espaço é usado quando alterações em um registro de dados existente fazem com que ele precise de mais espaço no bloco; Um registro atualizado que não mais se encaixa no bloco existente deve ser movido para outro bloco. O valor de porcentagem especificado, que pode variar 1-90, deve ser grande o suficiente para evitar a sobrecarga causada quando estouro de bloco força a divisão de um bloco de endereço existente em dois novos blocos. Se DATAPFAC não for especificado, ADADEF assume um fator de preenchimento de 10%.

ASSOVOLUME/DATAVOLUME: Volume de Extensão

Nota:

Os valores para ASSOVOLUME e DATAVOLUME deve ser colocado entre apóstrofos ( ' ). ASSOVOLUME especifica o volume no qual o espaço Associator do arquivo (ou seja, as extensões AC, NI e UI) deve ser alocado. DATAVOLUME especifica o volume no qual o espaço de Data Storage do arquivo (extents DS) são alocados.
Se o número de blocos solicitado não puder ser encontrado no volume especificado, o ADADEF tentará novamente a alocação sem ter em conta o valor do parâmetro ASSOVOLUME ou DATAVOLUME.
Se ACRABN, UIRABN ou NIRABN for especificado, o ADADEF ignora o valor ASSOVOLUME quando atribuir o tipo de extensão correspondente. Se DSRABN for especificado, DATAVOLUME será ignorado para o arquivo relacionado.
Se ASSOVOLUME e/ou DATAVOLUME não forem especificados, o espaço do Associator e/ou Data Storage do arquivo, respectivamente, será alocado de acordo com as regras de alocação padrão do ADADEF.

DBIDENT: Identificador de banco de dados

DBIDENT especifica o número de identificação a ser atribuído ao banco de dados. Um valor no intervalo 1-65535 pode ser especificado. Se esse parâmetro for omitido, o valor especificado com o parâmetro ADARUN DBID será usado.
Se vários bancos de dados forem estabelecidos, o parâmetro DBIDENT é necessário para identificar exclusivamente cada banco de dados.

DBNAME: Nome do banco de dados

DBNAME é o nome a ser atribuído ao banco de dados. Esse nome aparece no título do Database Status Report produzido pelo utilitário ADAREP. Um máximo de 16 caracteres pode ser especificado. Coloque o nome entre aspas simples se o nome incluir quaisquer caracteres especiais que não sejam traços ou se o nome contiver espaços em branco incorporados. Se este parâmetro for omitido, um valor padrão de "GENERAL-DATABASE" será atribuído.

DSDEV: Tipo de device para o Data Storage

DSDEV especifica o tipo de device a ser usado para Data Storage do arquivo de checkpoint. Não há valor padrão; Se DSDEV não for especificado, um tipo de device arbitrário é usado.

DSREUSE: Armazenamento Reusage

DSREUSE indica se o espaço que fica disponível no arquivo de checkpoint deve ser reutilizado. O padrão é YES.

FACODE: codificação para campos alfanuméricos

O parâmetro FACODE especifica a codificação padrão para campos alfanuméricos para todos os arquivos no banco de dados. A codificação deve ser derivada da codificação EBCDIC; Ou seja, X'40 'é o caractere de espaço. As codificações de conjunto de caracteres de duplo byte de tipo modal ou "shift" (DBCS) são suportadas; As codificações de tipo fixo DBCS (somente DBCS) não são suportadas. A chave de codificação padrão é 37. O propósito da configuração do banco de dados é servir como um padrão ao carregar arquivos. Uma vez carregado, a codificação de um arquivo é armazenada em seu FCB. Você pode alterar a codificação padrão definida neste parâmetro usando a função ADADEF MODIFY. Alterar a configuração de todo o banco de dados não afeta os arquivos já carregados.

FWCODE: Encoding for Wide-Character Fields

O parâmetro FWCODE especifica a codificação padrão para campos de formato de caracteres largos (W) para todos os arquivos no banco de dados. A codificação padrão é 4095; Ou seja, Unicode. O parâmetro FWCODE pode ser usado para definir uma codificação de caracteres largos que define o superconjunto de pontos de código de todas as codificações de usuário. Por exemplo, o Unicode abrange cerca de 50.000 pontos de código em oposição a Host-DBCS e Shift-JIS com cerca de 10.000 pontos de código cada. O propósito da configuração do banco de dados é servir como um padrão ao carregar arquivos. Uma vez carregado, a codificação de um arquivo é armazenada em sua FCB. Você pode alterar a codificação padrão definida neste parâmetro usando a função ADADEF MODIFY. Alterar a configuração de todo o banco de dados não afeta os arquivos já carregados.

ISNSIZE: ISN de 3 ou 4 bytes

ISNSIZE indica se os ISNs no arquivo têm 3 ou 4 bytes de comprimento. O padrão é 3 bytes.

MAXDS/MAXNI/MAXUI: Alocação Máxima Secundária

MAXDS/NI/UI especificam o número máximo de blocos por extensão secundária para o Data Storage, o normal index, e o upper index, respectivamente. O valor especificado deve ser seguido por "B" para blocos (por exemplo, MAXDS=8000B) e não pode ser superior a 65535B.

MAXFILES: Maior número de arquivos

MAXFILES especifica o número máximo de arquivos que podem ser carregados no banco de dados. O valor mínimo para este parâmetro é 3. O valor mais alto permitido é 5000 ou um menos que o tamanho de bloco ASSOR1, o que for menor. Por exemplo, 2003 é o valor MAXFILES mais alto para um banco de dados cujo ASSOR1 é armazenado em um 3380 DASD. O valor especificado determina o número de blocos de controle de arquivo e tabelas de definição de campo a serem alocados quando o banco de dados está sendo estabelecido. Cada bloco de controle de arquivo requer um bloco Associator e cada tabela de definição de campo requer quatro blocos Associator. Se este parâmetro for omitido, um valor de 255 é atribuído. Uma vez estabelecida a base de dados, o valor para MAXFILES só pode ser alterado executando o utilitário ADAORD com as funções REORASSO ou REORDB.

NAME: Nome do File de Checkpoint

NAME especifica o nome para o arquivo de checkpoint que está sendo definido. Esse nome aparece no Database Status Report produzido pelo utilitário ADAREP. O número máximo de caracteres permitido é 16. O nome de arquivo padrão é CHECKPOINT.

NISIZE: Tamanho Normal Index

NISIZE especifica o número de blocos ou cilindros a serem atribuídos ao Normal Index. Para blocos, o valor especificado deve ser seguido de "B" (por exemplo, NISIZE=80B).

NOUSERABEND: Terminação sem Abend

Quando um erro é encontrado enquanto a função está sendo executada, o utilitário imprime uma mensagem de erro e termina com o usuário abend 34 (com um dump) ou o usuário abend 35 (sem um dump). Se NOUSERABEND é especificado, o utilitário não da erro (abend) depois de imprimir a mensagem de erro. Em vez disso, é exibida a mensagem "utility TERMINATED DUE TO ERROR CONDITION" e o utilitário termina com o código de condição 20.

OVERWRITE: Sobrescrever Banco de Dados Existente

Especifique OVERWRITE para sobrescrever em cima de um banco de dados existente. OVERWRITE não pode ser especificado ao criar um banco de dados com dataset recém-formatados.

RABNSIZE: RABN de 3 ou 4 bytes

RABNSIZE especifica o comprimento de RABNs no banco de dados. Especifique 3 para RABN de 24 bits ou 4 para RABN de 31 bits. O padrão é 3.

UACODE: codificação de usuário para campos alfanuméricos

O parâmetro UACODE especifica a codificação padrão para campos alfanuméricos para usuários ASCII. A codificação deve ser derivada da codificação ASCII; Ou seja, X'20' é o caractere de espaço. As codificações para conjuntos de caracteres de bytes múltiplos são suportadas. A codificação padrão é 437. O valor UACODE não é armazenado no arquivo a ser carregado. Você pode substituir a codificação padrão definida neste parâmetro para uma sessão de usuário usando o comando OP. Você pode alterá-lo geralmente usando a função ADADEF MODIFY.

UES: Suporte de Codificação Universal

Configurando o parâmetro UES ativa o suporte de codificação universal para o banco de dados. Qualquer parâmetro xxCODE válido (FACODE, FWCODE, UACODE, UWCODE) implicitamente define UES=YES. Para desativar UES, você deve definir explicitamente UES=NO. Você pode alterar a configuração padrão desse parâmetro geralmente usando a função ADADEF MODIFY.

UISIZE: Tamanho do Upper Index

UISIZE especifica o número de blocos ou cilindros a serem atribuídos ao Upper Index. Para blocos, o valor especificado deve ser seguido por "B" (por exemplo, UISIZE = 80B).

UWCODE: codificação de usuário para campos de caracteres largos

O parâmetro UWCODE especifica a codificação de usuário para campos de formato de wide-character (W). Se o parâmetro não for especificado, o valor padrão é o valor atual de FWCODE. O propósito da configuração do banco de dados é servir como um padrão ao carregar arquivos. Uma vez carregado, a codificação de um arquivo é armazenada em seu FCB. Você pode substituir a codificação padrão definida neste parâmetro para uma sessão de usuário usando o comando OP. Você pode alterar a configuração padrão geralmente usando a função ADADEF MODIFY. Alterar a configuração de todo o banco de dados não afeta os arquivos já carregados.

Exemplos

Exemplo 1: Os tamanhos Associator, Data Storage e Work são iguais a 200, 600 e 50 cilindros, respectivamente. O identificador numérico para o banco de dados é 1 e o nome do banco de dados é DATABASE-1. O número máximo de arquivos (e o número de arquivo mais alto) que pode ser carregado no banco de dados é 150. O arquivo 1 deve ser reservado para o arquivo de checkpoint do Adabas. O nome do primeiro arquivo de sistema deve ser DB1-CHECKPOINT. O tamanho de armazenamento de dados para este arquivo deve ser 2 cilindros; O normal index esta no tamanho 50 blocos; O tamanho do upper index é de 10 blocos; E o MAXISN deve ser 5000.

ADADEF DEFINE
ADADEF  ASSOSIZE=200,DATASIZE=600,WORKSIZE=50
ADADEF  DBIDENT=1,DBNAME=DATABASE-1
ADADEF  MAXFILES=150
ADADEF  FILE=1,CHECKPOINT
ADADEF  NAME='DB1-CHECKPOINT',MAXISN=5000
ADADEF  DSSIZE=2,NISIZE=50B,UISIZE=10B

Exemplo 2: O Associador deve ser contido em um tipo de dispositivo 3380, e ocupa 100 cilindros. O Data Storage esta em dois datasets: o primeiro dataset é 200 cilindros contidos no primeiro tipo de device DATADEV (3380) e o segundo conjunto de dados é 300 cilindros contidos no segundo tipo de dispositivo DATADEV (3390). O espaço de Work é de 25 cilindros no dispositivo WORKDEV (3380).

O identificador numérico para o banco de dados é 2 e o nome do banco de dados é DATABASE_2. Um máximo de 255 arquivos pode ser carregado no banco de dados. Um arquivo de ponto de verificação Adabas é carregado durante esta etapa.

ADADEF DEFINE
ADADEF  ASSODEV=3380,DATADEV=3380,3390,WORKDEV=3380
ADADEF  ASSOSIZE=100,DATASIZE=200,300,WORKSIZE=25
ADADEF  DBIDENT=2,DBNAME='DATABASE_2'
ADADEF  MAXFILES=255
ADADEF  FILE=255,CHECKPOINT,MAXISN=5000
ADADEF  DSSIZE=3,NISIZE=100B,UISIZE=20B

ADADEF MODIFY - Alterar Codificações

A função MODIFY é usada para modificar codificações definidas usando ADADEF DEFINE. É necessário especificar pelo menos um dos parâmetros de codificação opcionais.

Alterar os parâmetros FACODE, FWCODE ou UWCODE não afeta arquivos já carregados desde que a codificação real de seus campos é armazenada no FCB. O propósito da configuração do banco de dados é servir como um padrão ao carregar arquivos.

ADADEF MODIFY [FACODE ={alpha-EBCDIC-key | current-setting}]
              [FWCODE ={wide-key | current-setting}]
              [NOUSEABEND]
              [UACODE ={ alpha-ASCII-key | current-setting}]]
              [UES = {YES | NO}]
              [UWCODE = {wide-key | current-setting}]

FACODE: codificação para campos alfanuméricos

O parâmetro FACODE especifica a codificação padrão para campos alfanuméricos para todos os arquivos no banco de dados. A codificação deve ser derivada da codificação EBCDIC; Ou seja, X'40' é o caractere de espaço. modal ou "shift" definidos (DBCS) tipos de caracteres de duplo byte são suportadas; Tipo fixo DBCS (apenas DBCS-tipo) codificações de tipo não são suportados. A chave de codificação padrão é a configuração atual. O propósito da configuração do banco de dados é servir como um padrão ao carregar arquivos. Uma vez carregado, a codificação de um arquivo é armazenada em sua FCB. Alterar a configuração de todo o banco de dados não afeta os arquivos já carregados.

FWCODE: codificação para campos Wide-Character

O parâmetro FWCODE especifica a codificação padrão para campos de formato de Wide-Character (W) para todos os arquivos no banco de dados. A codificação padrão é a configuração atual. O parâmetro FWCODE pode ser usado para definir uma codificação de Wide-Character que define o superconjunto de pontos de código de todas as codificações de usuário. Por exemplo, o Unicode abrange cerca de 50.000 pontos de código em oposição a Host-DBCS e Shift-JIS com cerca de 10.000 pontos de código cada. O propósito da configuração do banco de dados é servir como um padrão ao carregar arquivos. Uma vez carregado, a codificação de um arquivo é armazenada em sua FCB. Alterar a configuração de todo o banco de dados não afeta os arquivos já carregados.

NOUSERABEND: Término sem Abend

Quando um erro é encontrado durante a execução da função, o utilitário imprime uma mensagem de erro e termina com o user abend 34 (com um dump) ou user abend 35 (sem um dump). Se NOUSERABEND é especificado, o utilitário não abenda depois de imprimir a mensagem de erro. Em vez disso, é exibida a mensagem "utility TERMINATED DUE TO ERROR CONDITION" e o utilitário termina com o código de condição 20.

UACODE: codificação de usuário para campos alfanuméricos

O parâmetro UACODE especifica a codificação padrão para campos alfa para usuários ASCII. A codificação deve ser derivada da codificação ASCII; Ou seja, X'20' é o caractere de espaço. As codificações para conjuntos de caracteres de bytes múltiplos são suportadas. A codificação padrão é a configuração atual. A configuração UACODE não é armazenada no arquivo carregado. Você pode substituir esta codificação para uma sessão de usuário com o comando OP.

UES: Suporte de Codificação Universal

O parâmetro UES pode ser usado para habilitar ou desabilitar o suporte de codificação universal para um banco de dados existente. A desativação só é possível se nenhum arquivo for carregado com campos de formato de Wide-Character (W). Qualquer parâmetro xxCODE válido (FACODE, FWCODE, UACODE, UWCODE) implicitamente define UES=YES. Para desativar UES, você deve definir explicitamente UES=NO.

UWCODE: codificação de usuário para campos de Wide-Character

O parâmetro UWCODE especifica a codificação de usuário para campos de formato de caracteres largos (W). Se o parâmetro não for especificado, o valor padrão é a configuração atual. O propósito da configuração do banco de dados é servir como um padrão ao carregar arquivos. Uma vez carregado, a codificação de um arquivo é armazenada em sua FCB. Alterar a configuração de todo o banco de dados não afeta os arquivos já carregados. Você pode substituir a codificação padrão para uma sessão de usuário com o comando OP.

Exemplos

Exemplo 1: Desativar suporte a codificação universal para um banco de dados existente. A base de dados não contém ficheiros com formato largo (W).

ADADEF MODIFY UES=NO

Exemplo 2: Altere a codificação padrão para campos de formato de caracteres largos (W) para todos os arquivos no banco de dados da configuração atual para a página de código 835 (host duplo chinês tradicional, incluindo 6204 caracteres definidos pelo usuário).

ADADEF MODIFY FWCODE=835

Arquivos já carregados não são afetados por esta alteração desde a codificação real de seus campos é armazenada no FCB. O propósito da configuração do banco de dados é servir como um padrão ao carregar arquivos.

ADADEF NEWWORK - Definindo uma Arquivo de Work

Os seguintes parâmetros são usados para definição do dataset de Work:

ADADEF NEWWORK WORKSIZE=tamanho 
              [NOUSEABEND]
              [WORKDEV= {device-tipo-lista | ADARUN-device}]

Observações:

1 - O núcleo Adabas não deve estar ativo durante esta função, e a Work antiga deve ser especificado no JCL/JCS. 2 - A função ADADEF NEWWORK não pode ser executada se existir um autorestart pendente.

WORKSIZE: tamanho do dataset de Work

O número de blocos ou cilindros a serem atribuídos ao dataset de Work.

Parâmetros opcionais

NOUSERABEND: Término sem Abend

Quando um erro é encontrado durante a execução da função, o utilitário imprime uma mensagem de erro e termina com o user abend 34 (com um dump) ou user abend 35 (sem um dump). Se NOUSERABEND é especificado, o utilitário não abenda depois de imprimir a mensagem de erro. Em vez disso, é exibida a mensagem "utility TERMINATED DUE TO ERROR CONDITION" e o utilitário termina com o código de condição 20.

WORKDEV: Tipo de device

O tipo de dispositivo a ser atribuído ao novo dataset de Work. Este parâmetro é necessário somente se o tipo de device a ser usado for diferente do especificado pelo parâmetro ADARUN DEVICE.

Exemplo

Um novo dataset de Work é definido com um tamanho de 50 cilindros. O tipo de device é obtido a partir do parâmetro ADARUN DEVICE.

ADADEF NEWWORK
ADADEF WORKSIZE=50

Categories: Adabas, Adabas 7.4.4