A função INVERT cria descritores, subdescritores, superdescritores, hyperdescritores, phonetic descriptors (descritores fonética) ou collation descriptors (descritores de agrupamento) para campos existentes em um arquivo. Vários descritores podem ser criadas em um único executar INVERT ADAINV, mas apenas para um único arquivo.
Sobre os parametros
FILE: Número do Arquivo
Você especifica o número do file que vai ser criado o campo
SORTSIZE: Sort Size
Na SORTSIZE você especifica o espaço disponível para o data set do SORT ou o data set R1/2 (SORTR2 não é suportado sob o z/VSE). O valor pode ser em cilindros (um valor numérico) ou blocos (um valor numérico seguido de um "B"). Se os blocos forem especificados, eles devem ser equivalentes a um número total de cilindros. O parâmetro SORTSIZE deve ser especificado.
TEMPSIZE: Temporary Storage Size
No TEMPSIZE você define o espaço disponível para os dat set temp. O valor pode ser em cilindros (um valor numérico) ou blocos (um valor numérico seguido de um "B"). Este parâmetro deve ser especificado.
Parâmetros opcionais e subparâmetros
CODE: Cipher Code
Se o arquivo especificado com o parâmetro FILE é cifrada, um código cifrado adequado deve ser fornecido usando o parâmetro code.
FIELD/COLDE/HYPDE/PHONDE/SUBDE/SUPDE: Define Descriptor(s)
Estes parâmetros podem ser usados para definir os vários tipos de descritores. Você deve especificar pelo menos uma definição de descritor para o arquivo especificado, você pode especificar mais de um assunto ou tipo de descritor.
Use o parâmetro FIELD para definir um ou mais campos de descritores, utilize o parâmetro COLDE para um descritor de agrupamento; HYPDE parâmetro para uma hyperdescriptor; PHONDE para um descritor fonético; SUBDE de subdescritor e SUPDE de superdescriptor.
Se fornecido, a especificação do FIELD deve vir antes de qualquer descritor agrupamento, hiper, super-, sub-, ou especificação descritor fonético.
FIELD especifica um campo existente (ou campos) a ser feito o inverted. O campo pode ser um campo elementar ou de valor múltiplo e pode estar contido dentro de um grupo de periódicos (a menos que o campo está definido com a opção FI).
Se o descritor deve ser único, especificar "UQ" após o nome do campo. Se a singularidade do descritor deve ser determinado com o índice (número de ocorrências) excluídos, especificar "XI" também.
Nota: Para Adabas expanded files (arquivos Adabas expandido), ADAINV só pode detectar violações descritor exclusivo dentro do arquivo componente especificado. Se existe um valor idêntico para um descritor único em um dos arquivos de outro componente, ADAINV não pode detectá-lo. Você deve, portanto, garantir que os valores originais descritor permanecem únicas em todo um arquivo expandido.
Apesar de vários campos possam ser especificados para o invert usando o parâmetro de FIELD, apenas um collation descriptor (descritor agrupamento), hiper-, sub-, super-descritor, ou fonética é definido por instância do seu parâmetro. Várias instâncias dos parâmetros permitidos por execução de ADAINV.
No invert um sub superfield ou, um SUBDE respectiva ou parâmetro SUPDE deve especificar os campos de mesmo pai que foram especificadas quando o campo foi criado, caso contrário, ocorre um erro. Iniciando valores finais são tomadas a partir das definições do campo original.
Se um campo pai com a opção for especificada NU, sem as entradas são feitas na lista invertida para os registros que contêm um valor nulo para o campo. Para super- e hyperdescritores, isso é verdade, independentemente da presença ou ausência de valores para outros elementos do descritor.
Se um campo de mãe não é inicializado e logicamente cai após o final do registro físico, a entrada da lista invertida para que o registro não é gerado por razões de performance. Para gerar a entrada de lista invertida neste caso, é necessário descarregar a curto, descompactar, e recarregar o arquivo, ou usar um programa de aplicação para inicializar o campo para cada registro do arquivo.
Para obter informações detalhadas sobre a sintaxe descritor individual, valores subparâmetro e codificação, lido Field Definition Statements à descrição do utilitário ADACMP.
LPB: Prefetch Buffer Size
LPB especifica o tamanho, em bytes, do buffer interno do prefetch. O valor máximo é 32.760 bytes. O padrão depende do parâmetro ADARUN LU; ADAINV também pode reduzir o valor LPB especificado se o valor de LU é muito pequeno.
LWP: Work Pool Size
LWP especifica o tamanho do Work Pool Size a ser usado para classificar o valor do descritor. O valor pode ser especificado em bytes ou kilobytes seguido por um "K". Se nenhum valor for especificado, o padrão é 1048576 bytes (ou 1024K), entretando para encurtar o ADAINV do tempo de execução de arquivos com descritores muito longo ou um número invulgarmente elevado de descritores, LWP para definir um valor superior. Para evitar problemas com o conjunto de dados de classificação, um valor menor LWP deve ser especificado quando a definição de descritores de arquivos relativamente pequenos.
O tamanho mínimo dO work pool depende do tipo de dispositivo do data set de Sort;
Sobre os parametros
FILE: Número do Arquivo
Você especifica o número do file que vai ser criado o campo
SORTSIZE: Sort Size
Na SORTSIZE você especifica o espaço disponível para o data set do SORT ou o data set R1/2 (SORTR2 não é suportado sob o z/VSE). O valor pode ser em cilindros (um valor numérico) ou blocos (um valor numérico seguido de um "B"). Se os blocos forem especificados, eles devem ser equivalentes a um número total de cilindros. O parâmetro SORTSIZE deve ser especificado.
TEMPSIZE: Temporary Storage Size
No TEMPSIZE você define o espaço disponível para os dat set temp. O valor pode ser em cilindros (um valor numérico) ou blocos (um valor numérico seguido de um "B"). Este parâmetro deve ser especificado.
Parâmetros opcionais e subparâmetros
CODE: Cipher Code
Se o arquivo especificado com o parâmetro FILE é cifrada, um código cifrado adequado deve ser fornecido usando o parâmetro code.
FIELD/COLDE/HYPDE/PHONDE/SUBDE/SUPDE: Define Descriptor(s)
Estes parâmetros podem ser usados para definir os vários tipos de descritores. Você deve especificar pelo menos uma definição de descritor para o arquivo especificado, você pode especificar mais de um assunto ou tipo de descritor.
Use o parâmetro FIELD para definir um ou mais campos de descritores, utilize o parâmetro COLDE para um descritor de agrupamento; HYPDE parâmetro para uma hyperdescriptor; PHONDE para um descritor fonético; SUBDE de subdescritor e SUPDE de superdescriptor.
Se fornecido, a especificação do FIELD deve vir antes de qualquer descritor agrupamento, hiper, super-, sub-, ou especificação descritor fonético.
FIELD especifica um campo existente (ou campos) a ser feito o inverted. O campo pode ser um campo elementar ou de valor múltiplo e pode estar contido dentro de um grupo de periódicos (a menos que o campo está definido com a opção FI).
Se o descritor deve ser único, especificar "UQ" após o nome do campo. Se a singularidade do descritor deve ser determinado com o índice (número de ocorrências) excluídos, especificar "XI" também.
Nota: Para Adabas expanded files (arquivos Adabas expandido), ADAINV só pode detectar violações descritor exclusivo dentro do arquivo componente especificado. Se existe um valor idêntico para um descritor único em um dos arquivos de outro componente, ADAINV não pode detectá-lo. Você deve, portanto, garantir que os valores originais descritor permanecem únicas em todo um arquivo expandido.
Apesar de vários campos possam ser especificados para o invert usando o parâmetro de FIELD, apenas um collation descriptor (descritor agrupamento), hiper-, sub-, super-descritor, ou fonética é definido por instância do seu parâmetro. Várias instâncias dos parâmetros permitidos por execução de ADAINV.
No invert um sub superfield ou, um SUBDE respectiva ou parâmetro SUPDE deve especificar os campos de mesmo pai que foram especificadas quando o campo foi criado, caso contrário, ocorre um erro. Iniciando valores finais são tomadas a partir das definições do campo original.
Se um campo pai com a opção for especificada NU, sem as entradas são feitas na lista invertida para os registros que contêm um valor nulo para o campo. Para super- e hyperdescritores, isso é verdade, independentemente da presença ou ausência de valores para outros elementos do descritor.
Se um campo de mãe não é inicializado e logicamente cai após o final do registro físico, a entrada da lista invertida para que o registro não é gerado por razões de performance. Para gerar a entrada de lista invertida neste caso, é necessário descarregar a curto, descompactar, e recarregar o arquivo, ou usar um programa de aplicação para inicializar o campo para cada registro do arquivo.
Para obter informações detalhadas sobre a sintaxe descritor individual, valores subparâmetro e codificação, lido Field Definition Statements à descrição do utilitário ADACMP.
LPB: Prefetch Buffer Size
LPB especifica o tamanho, em bytes, do buffer interno do prefetch. O valor máximo é 32.760 bytes. O padrão depende do parâmetro ADARUN LU; ADAINV também pode reduzir o valor LPB especificado se o valor de LU é muito pequeno.
LWP: Work Pool Size
LWP especifica o tamanho do Work Pool Size a ser usado para classificar o valor do descritor. O valor pode ser especificado em bytes ou kilobytes seguido por um "K". Se nenhum valor for especificado, o padrão é 1048576 bytes (ou 1024K), entretando para encurtar o ADAINV do tempo de execução de arquivos com descritores muito longo ou um número invulgarmente elevado de descritores, LWP para definir um valor superior. Para evitar problemas com o conjunto de dados de classificação, um valor menor LWP deve ser especificado quando a definição de descritores de arquivos relativamente pequenos.
O tamanho mínimo dO work pool depende do tipo de dispositivo do data set de Sort;
| Sort Device | Minimum LWP | Minimum LWP |
|---|---|---|
| Bytes | Kilobytes | |
| 2000 | 106496 | 104K |
| 2314 | 090112 | 88K |
| 3375 | 131072 | 128K |
| 3380 | 139264 | 136K |
| 3390 | 159744 | 156K |
NOUSERABEND: Termination without Abend
Quando for encontrado um erro enquanto a função está sendo executado, o programa imprime uma mensagem de erro e termina com o user abend 34 (com um dump) ou com um user abend 35 (sem um dump). Quando NOUSERABEND é especificado, ele deve ser especificado como o primeiro parâmetro (antes de todos os outros parâmetros) para a função do utilitário.
Se NOUSERABEND for especificado, o utilitário não abenda depois de imprimir a mensagem de erro. Em vez disso, a mensagem "TERMINATED DUE TO ERROR CONDITION" é exibida e o utilitário termina com o código de condição de 20.
PASSWORD: File Password
Se o arquivo especificado o arquivo é protegido segurança, a senha do arquivo deve ser fornecido com este parâmetro.
SORTDEV: Sort Device Type
ADAINV usa a area do data set de SORT é para definir e para classificar os valores do descritor. O parâmetro SORTDEV indica o tipo de dispositivo a ser utilizado para classificar os dados definidoS. Este parâmetro é necessário somente se o tipo de dispositivo a ser utilizado é diferente do especificado com o parâmetro ADARUN DEVICE.
TEMPDEV: Temporary Storage Device Type
O ADAINV usa os data set da area de TEMP para armazenar dados intermediários. O parâmetro tempdev indica o tipo de dispositivo a ser usado para este conjunto de dados. Este parâmetro é necessário somente se o tipo de dispositivo a ser utilizado é diferente do especificado com o parâmetro ADARUN DEVICE.
TEST: Test Syntax
O parâmetro de TEST verifica a sintaxe da operação sem realmente executar a operação. Apenas a sintaxe dos parâmetros especificados podem ser testados, não a validade dos valores e variáveis.
Alocação de espaço para a função de INVERT
Os valores para o campo do invertid e os ISNs dos registros contendo os valores são gravados na lista invertida (normal e upper indexes).
Se quer a extensão do índice normal ou superior lógico é esgotado durante a execução doADAINV, o ADAINV aloca uma extensão adicional. O tamanho da extensão alocada é igual a 25 por cento do tamanho total atual de todas as extensões do índice normal atualmente alocada para o arquivo.
Se não houver espaço suficiente, não está disponível para a nova extensão, ou se o número máximo de extensões alocadas foi atingido, ADAINV termina com uma mensagem de erro.
Exemplos
Alguns exemplos para se utilizar o ADAINV
Exemplo 1 - O file 3 o campo AR vai ser um campo descritor
ADAINV INVERT
FILE=3,FIELD='AR',TEMPSIZE=10,SORTSIZE=5
Exemplo 2 - Subdescritor SA está a ser criado usando o campo AA (posições 1-4) no arquivo 5 como o campo pai.
ADAINV INVERT FILE=5,SUBDE='SA=AA(1,4)'
ADAINV TEMPSIZE=6,SORTSIZE=3
Exemplo 3 - Superdescriptor SB está a ser criado usando campos AA (posições 1-4) e AB (posição 1) no arquivo 6.
ADAINV INVERT FILE=6,SUPDE='SB=AA(1,4),AB(1,1)'
ADAINV TEMPSIZE=5,SORTSIZE=3
Exemplo 4 - Um descritor fonético XX é criado usando o campo AA como o campo de origem.
ADAINV INVERT FILE=1,PHONDE='XX(AA)'
ADAINV TEMPSIZE=5,SORTSIZE=3
Exemplo 5 - Descritor Agrupamento (Collation descriptor) CDX = 01 chamado Y1 é criado usando AA como o campo de origem.
ADAINV INVERT FILE=6,COLDE='1,Y1=AA'
ADAINV TEMPSIZE=5,SORTSIZE=4
Clique Aqui
0 comentários:
Enviar um comentário