Auxílios do VisualAge Generator


Valor de Retorno/Editor de Parâmetros

Você pode definir um valor de retorno e parâmetros para sua função no Valor de Retorno/Editor de Parâmetros.

Valor de retorno da função

Você pode definir um valor de retorno para cada função na caixa do grupo Valor de retorno da função no Valor de Retorno/Editor de Parâmetros. O valor de retorno deve ser definido de acordo com as regras do tipo.

Quando um valor de retorno é definido, todas as instruções EZERTN na função devem ter um argumento especificado. Os argumentos especificados nas instruções EZERTN devem ser compatíveis com a definição do valor de retorno. Quando um valor de retorno não é definido, as instruções EZERTN não podem especificar um argumento.

Se seu programa executar uma instrução EZERTN explícita antes do final da lógica da função, o valor de retorno será atribuído à área de dados de recepção de acordo com as regras de compatibilidade. Se seu programa não executar uma instrução EZERTN explícita antes do final da lógica da função, será executada uma instrução EZERTN explícita. Uma instrução EZERTN implícita retorna uma área de memória temporária que é inicializada com um valor padrão conforme a definição do valor de retorno.

Campos

Tipo dos Dados

Selecione o tipo do item de dados do valor de retorno no campo Tipo de Dados.

Você pode selecionar um dos seguintes tipos:

Por padrão, o campo Tipo de Dados está em branco e o tipo de dados não está definido para o item do valor de retorno.

NONE

Selecione NENHUM se desejar apagar um valor de retorno definido. value.

Bin

Selecione Bin se o item de dados for numérico e você quiser armazená-lo em formato binário.

O tipo de dados Bin pode armazenar números grandes em um número de bytes menor do que outros tipos de dados numéricos.

Char

Selecione Char se o item de dados consistir em caracteres alfabéticos, numéricos ou nacionais.

Não são suportadas casas decimais para itens de dados de caractere.

DBCS

Selecione DBCS se o item de dados consistir em caracteres de byte duplo. Dados do conjunto de caracteres de byte duplo (DBCS) são caracteres ideográficos que requerem duas posições para cada caractere.

Dados DBCS requerem terminal ou dispositivo de impressora com recurso DBCS, para que os dados de caractere de byte duplo possam ser exibidos ou impressos. Os caracteres de byte duplo são exigidos nos idiomas japonês, coreano e chinês.

Não são suportadas casas decimais para itens de dados DBCS.

O valor Comprimento representa metade do valor Bytes para dados DBCS.

Hex

Selecione Hex se o item de dados for hexadecimal (base 16).

Itens de dados hexadecimais fornecem funções básicas de processamento (mudanças de lugar, comparações e transmissão de parâmetros) para campos de bancos de dados cujo tipo de dados não é diretamente suportado pelo VisualAge Generator. Hex é abreviação de numeração hexadecimal.

Se o tipo de dados do item de dados não corresponder a nenhum outro tipo de dados, selecione Hex. Especifique um valor Bytes igual ao número de bytes que o campo usa.

O valor Comprimento representa o número de dígitos do item de dados hexadecimal e corresponde a duas vezes o valor de Bytes.

Não são suportadas casas decimais para itens de dados hexadecimais.

Os itens de dados hexadecimais não podem ser usados em expressões aritméticas.

Misto

Selecione Misto se o item de dados puder comportar tanto o conjunto de caracteres de byte simples (SBCS) quanto o de byte duplo (DBCS).

Dados mistos requerem terminal ou dispositivo de impressão com recurso DBCS, para que os dados de byte duplos possam ser exibidos ou impressos. Os caracteres de byte duplo são exigidos nos idiomas japonês, coreano e chinês.

O Comprimento especificado para um tipo misto de item de dados é o número de caracteres de byte simples que o campo pode conter. O número de Bytes para um campo misto deve ser igual ao Comprimento.

Não são suportadas casas decimais em itens de dados mistos.

Num

Selecione Num se o item de dados for numérico.

Internamente, cada dígito é representado pelo caractere que corresponde àquele dígito. Os valor dos dados é armazenado justificado à direita, preenchido à esquerda com caracteres zeros. O sinal do número é armazenado na metade esquerda do último byte (a zona).

O sinal de positivo é representado pelo valor padrão da zona para caractere numérico, que é o hexadecimal F no EBCDIC. O sinal de negativo é o hexadecimal D no EBCDIC.

Numc

Selecione Numc se o item de dados for numérico.

Internamente, cada dígito é representado pelo caractere que corresponde àquele dígito. o valor dos dados é armazenado justificado à direita, preenchido à esquerda com caracteres zeros. O sinal do número é armazenado na metade esquerda do último byte (a zona).

O sinal de positivo é representado pelo dígito hexadecimal C para EBCDIC. O sinal de negativo é o hexadecimal D do EBCDIC.

Selecione Numc quando an application criar registros para serem processados por outros produtos que usam a convenção C para sinal de positivo.

Itens de dados Numc equivalem a itens de dados Num, só que o dígito hexadecimal C representa sinal de positivo.

Pacf

Selecione Pacf se o item de dados for um decimal compactado.

Itens de dados Pacf são dados decimais compactados. Os dados decimais compactados possuem 2 dígitos em cada byte com o sinal na metade direita do último byte.

Internamente, o valor dos dados é armazenado justificado à direita, preenchido à esquerda com caracteres zeros. O sinal de positivo é representado pelo dígito hexadecimal F. O sinal de negativo é o hexadecimal D. B é aceito como sinal de negativo em dados criados por outros produtos.

Pack

Selecione Pack se o item de dados for um decimal compactado e você quiser um sinal interno positivo de C.

Itens de dados Pack são dados decimais compactados. Os dados decimais compactados possuem 2 dígitos em cada byte com o sinal na metade direita do último byte.

Internamente, o valor dos dados é armazenado justificado à direita, preenchido à esquerda com caracteres zeros. O sinal de positivo é representado pelo dígito hexadecimal C; o de negativo por um D. B é aceito como sinal de negativo em dados criados por outros produtos.

Unicode

Selecione Unicode se quiser armazenar os itens de dados no formato Unicode.

Unicode é um padrão de codificação de caracteres de 16 bits (2 bytes) estabelecido pelo Unicode Consortium. Consulte Suporte Unicode na estrutura de navegação do auxílio online para obter mais informações.

Comprimento

Digite o número de caracteres ou dígitos separados em uma estrutura de dados para o item do valor de retorno no campo Comprimento.

Por padrão, o campo Comprimento está em branco e nenhum caractere ou dígito foi separado em uma estrutura de dados para o item do valor de retorno.

Decimais

Digite o número de posições para reservar o direito de uma vírgula decimal implícita no campo Decimais.

O número de casas decimais tem que ser menor ou igual ao tamanho do item.

O tamanho do itens tem que incluir espaço para as casas decimais. O número máximo de casas decimais é 18 ou o tamanho do item se ele for menor que 18. O ponto decimal não é armazenado com os dados.

Decimais estarão disponíveis somente quando você selecionar um tipo de dados que seja numérico.

Por padrão, o campo Decimais do Item está em branco e nenhuma posição à direita da vírgula decimal implícita está reservada para o item do valor de retorno.

Descrição

Digite uma descrição de 1 a 30 caracteres no campo Descrição para documentar o valor de retorno.

As descrições de tipo podem ser feitas em caracteres maiúsculos, minúsculos ou mistos.

Por padrão, o campo Descrição está em branco e nenhum texto está definido para documentar o valor de retorno.

Parâmetros da função

Você pode definir um registro ou item como parâmetro na caixa do grupo Parâmetros da Função no Valor de Retorno/Editor de Parâmetros. Não é possível especificar um EZEword como parâmetro da função.

Por padrão, a caixa do grupo Parâmetros da função está em branco e nenhuma entrada de parâmetro foi definida. Após selecionar Inserir Antes ou Inserir Depois aparecerá uma entrada padrão na linha. Esta entrada padrão é documentada para cada campo da caixa de grupo Parâmetros da função.

Campos

Nome

Digite o nome do registro ou item da memória de trabalho no campo Nome. O nome especifica um registro ou item que é recebido como um parâmetro da função.

Você deve nomear um registro da memória de trabalho no campo Nome se estiver definindo um parâmetro do registro.

Por padrão, o campo Nome está em branco e um nome não está definido para o parâmetro.

Tipo

Selecione o tipo de parâmetro no campo Tipo.

Você pode selecionar um dos seguintes tipos:

O argumento da função deve corresponder ao tipo de parâmetro se você definir um mapa ou tipo de item SQL. Você deve especificar um item do mapa para o argumento da função se o parâmetro estiver definido como um tipo Item do Mapa. Você deve especificar um item SQL para o argumento da função se o parâmetro estiver definido como um tipo Item SQL.

Se desejar que outra função refira-se a um registro, item, item do mapa ou item do SQL nomeado como parâmetros, você deverá passá-los para essa função como um argumento.

Nota:Se você selecionar Registro no campo Tipo, poderá definir somente os seguintes campos na linha de parâmetros:
  • Name
  • Tipo
  • Descrição
Você deve especificar um tipo de registro para definir uma matriz como um parâmetro. A matriz deve fazer parte do registro especificado.

Por padrão, Item está selecionado no campo Tipo e o tipo do parâmetro está definido como um Item.

Tipo de Item

Selecione o tipo do item de dados no campo Tipo de Item.

Você pode selecionar um dos seguintes tipos:

Por padrão, Char está selecionado no campo Tipo de Item e o tipo de item está definido como Char.

Bin

Selecione Bin se o item de dados for numérico e você quiser armazená-lo em formato binário.

O tipo de dados Bin pode armazenar números grandes em um número de bytes menor do que outros tipos de dados numéricos.

Char

Selecione Char se o item de dados consistir em caracteres alfabéticos, numéricos ou nacionais.

Não são suportadas casas decimais para itens de dados de caractere.

DBCS

Selecione DBCS se o item de dados consistir em caracteres de byte duplo. Dados do conjunto de caracteres de byte duplo (DBCS) são caracteres ideográficos que requerem duas posições para cada caractere.

Dados DBCS requerem terminal ou dispositivo de impressora com recurso DBCS, para que os dados de caractere de byte duplo possam ser exibidos ou impressos. Os caracteres de byte duplo são exigidos nos idiomas japonês, coreano e chinês.

Não são suportadas casas decimais para itens de dados DBCS.

O valor Comprimento representa metade do valor Bytes para dados DBCS.

Hex

Selecione Hex se o item de dados for hexadecimal (base 16).

Itens de dados hexadecimais fornecem funções básicas de processamento (mudanças de lugar, comparações e transmissão de parâmetros) para campos de bancos de dados cujo tipo de dados não é diretamente suportado pelo VisualAge Generator. Hex é abreviação de numeração hexadecimal.

Se o tipo de dados do item de dados não corresponder a nenhum outro tipo de dados, selecione Hex. Especifique um valor Bytes igual ao número de bytes que o campo usa.

O valor Comprimento representa o número de dígitos do item de dados hexadecimal e corresponde a duas vezes o valor de Bytes.

Não são suportadas casas decimais para itens de dados hexadecimais.

Os itens de dados hexadecimais não podem ser usados em expressões aritméticas.

Misto

Selecione Misto se o item de dados puder comportar tanto o conjunto de caracteres de byte simples (SBCS) quanto o de byte duplo (DBCS).

Dados mistos requerem terminal ou dispositivo de impressão com recurso DBCS, para que os dados de byte duplos possam ser exibidos ou impressos. Os caracteres de byte duplo são exigidos nos idiomas japonês, coreano e chinês.

O Comprimento especificado para um tipo misto de item de dados é o número de caracteres de byte simples que o campo pode conter. O número de Bytes para um campo misto deve ser igual ao Comprimento.

Não são suportadas casas decimais em itens de dados mistos.

Num

Selecione Num se o item de dados for numérico.

Internamente, cada dígito é representado pelo caractere que corresponde àquele dígito. Os valor dos dados é armazenado justificado à direita, preenchido à esquerda com caracteres zeros. O sinal do número é armazenado na metade esquerda do último byte (a zona).

O sinal de positivo é representado pelo valor padrão da zona para caractere numérico, que é o hexadecimal F no EBCDIC. O sinal de negativo é o hexadecimal D no EBCDIC.

Numc

Selecione Numc se o item de dados for numérico.

Internamente, cada dígito é representado pelo caractere que corresponde àquele dígito. o valor dos dados é armazenado justificado à direita, preenchido à esquerda com caracteres zeros. O sinal do número é armazenado na metade esquerda do último byte (a zona).

O sinal de positivo é representado pelo dígito hexadecimal C para EBCDIC. O sinal de negativo é o hexadecimal D do EBCDIC.

Selecione Numc quando an application criar registros para serem processados por outros produtos que usam a convenção C para sinal de positivo.

Itens de dados Numc equivalem a itens de dados Num, só que o dígito hexadecimal C representa sinal de positivo.

Pacf

Selecione Pacf se o item de dados for um decimal compactado.

Itens de dados Pacf são dados decimais compactados. Os dados decimais compactados possuem 2 dígitos em cada byte com o sinal na metade direita do último byte.

Internamente, o valor dos dados é armazenado justificado à direita, preenchido à esquerda com caracteres zeros. O sinal de positivo é representado pelo dígito hexadecimal F. O sinal de negativo é o hexadecimal D. B é aceito como sinal de negativo em dados criados por outros produtos.

Pack

Selecione Pack se o item de dados for um decimal compactado e você quiser um sinal interno positivo de C.

Itens de dados Pack são dados decimais compactados. Os dados decimais compactados possuem 2 dígitos em cada byte com o sinal na metade direita do último byte.

Internamente, o valor dos dados é armazenado justificado à direita, preenchido à esquerda com caracteres zeros. O sinal de positivo é representado pelo dígito hexadecimal C; o de negativo por um D. B é aceito como sinal de negativo em dados criados por outros produtos.

Unicode

Selecione Unicode se quiser armazenar os itens de dados no formato Unicode.

Unicode é um padrão de codificação de caracteres de 16 bits (2 bytes) estabelecido pelo Unicode Consortium. Consulte Suporte Unicode na estrutura de navegação do auxílio online para obter mais informações.

ANYCHAR

Selecione ANYCHAR se:

Selecione Char em vez de ANYCHAR se desejar solicitar uma correspondência exata entre um argumento e o parâmetro.

O tipo de item ANYCHAR é válido para parâmetros do item de mapa.

ANYDBCS

Selecione ANYDBCS se:

Selecione DBCS em vez de ANYDBCS se desejar solicitar uma correspondência exata entre um argumento e o parâmetro.

O tipo de item ANYDBCS é válido para parâmetros do item de mapa.

ANYHEX

Selecione ANYHEX se:

Selecione Hex em vez de ANYHEX se desejar solicitar uma correspondência exata entre um argumento e o parâmetro.

ANYMIXED

Selecione ANYMIXED se:

Selecione Misto em vez de ANYMIXED se desejar solicitar uma correspondência exata entre um argumento e o parâmetro.

O tipo de item ANYMIXED é válido para parâmetros do item de mapa.

ANYNUMERIC

Selecione ANYNUMERIC se:

Selecione Bin, Num, Numc, Pacf ou Pack em vez de ANYNUMERIC se desejar solicitar uma correspondência exata entre um argumento e o parâmetro.

O tipo de item ANYNUMERIC é válido para parâmetros do item de mapa.

ANYUNICODE

Selecione ANYUNICODE se:

Selecione UNICODE em vez de ANYUNICODE se desejar solicitar uma correspondência exata entre um argumento e o parâmetro.

Tamanho do Item

Digite o número de caracteres ou dígitos separados para o item do valor Tamanho do Item.

Nota:Ao especificar um valor paraBytes do Item, o valor Tamanho do Item é calculado automaticamente a partir do valor dos bytes.

Por padrão, 3 é exibido no campo Tamanho do Item e três caracteres ou dígitos são separados para o item.

Bytes do Item

Digite o número de bytes necessários para armazenar o item de dados internamente no campo Bytes do Item.

Nota:Ao especificar um valor para Tamanho do Item, o valor Bytes do Item é calculado automaticamente a partir do valor do tamanho.

Por padrão, 3 é exibido no campo Bytes do Item e três bytes são definidos para armazenar o item de dados internamente.

Decimais do Item

Digite o número de posições para reservar o direito de uma vírgula decimal implícita no campo Decimais do Item.

O número de casas decimais tem que ser menor ou igual ao tamanho do item.

O tamanho do itens tem que incluir espaço para as casas decimais. O número máximo de casas decimais é 18 ou o tamanho do item se ele for menor que 18. O ponto decimal não é armazenado com os dados.

Decimais do Item estarão disponíveis somente quando você selecionar um tipo de dados que seja numérico.

Por padrão, zero é exibido no campo Decimais do Item e nenhuma posição à direita de uma vírgula decimal implícita é reservada.

Utilização do Item

Selecione o valor no campo Utilização do Item que especificar onde a definição item está localizada:

Você pode especificar uma definição de item Não-compartilhado e restringir o uso para a função. Você pode especificar uma definição de item Compartilhado e tornar a definição disponível fora da função.

Você pode criar um item de dados separado na caixa de grupo Parâmetros da função definindo um item com um nome exclusivo e um valor de uso Compartilhado. Você pode redefinir a Utilização do Item como Não-compartilhado. Isto cria um cópia da definição compartilhada que está disponível somente para a função.

Por padrão, Não-compartilhado está selecionado no campo Utilização do item e a definição está disponível somente para a função.

Descrição

Digite uma descrição de 1 a 30 caracteres no campo Descrição para documentar o parâmetro. Se estiver definindo um item de dados compartilhado, a descrição se aplicará ao parâmetro e não ao item de dados.

As descrições de tipo podem ser feitas em caracteres maiúsculos, minúsculos ou mistos.

Por padrão, o campo Descrição está em branco e nenhum texto está definido para documentar o parâmetro.

Botões de comando

Selecione Inserir Antes para inserir uma entrada do parâmetro na lista acima da entrada selecionada.

Selecione Inserir Depois para inserir uma entrada do parâmetro na lista abaixo da entrada selecionada.

Selecione Excluir para excluir a entrada do parâmetro selecionada.

Botões de comando

Selecione OK para aceitar os valores e fechar a janela.

Selecione Cancelar para fechar a janela sem aceitar os valores.

Selecione Auxílio para exibir o auxílio para o Valor de Retorno/Editor de Parâmetros.


[ Início da Página | Página Anterior | Próxima Página | Índice ]