Como Fornecer um Argumento em uma Função

Tipos de Argumentos

Os argumentos a seguir são aceitáveis para uma função:

Constante numérica, como 6 ou 15.
Constante de data, como 022802.
Data em formato alfanumérico, numérico, de data ou AnV.
Literal alfanumérico, como STEVENS ou NEW YORK NY. Um literal deve vir entre aspas simples.
Número em formato alfanumérico.
Nome do campo, como FIRST_NAME ou HIRE_DATE. Um campo pode ser um campo de fonte de dados ou temporário. O nome do campo pode ter até 66 caracteres ou um nome de campo qualificado, truncamento único ou alias.
Expressão, como expressão numérica, de data ou alfanumérica. Uma expressão pode utilizar operadores aritméticos e o sinal de concatenação (|). Por exemplo, as expressões a seguir são válidos:
```
CURR_SAL * 1.03
```
e
```
FN || LN
```
Variável do Dialogue Manager, como &CODE e &DDNAME.
Formato do valor de saída entre aspas simples.
Outra função.
Rótulo ou outra referência de linha ou coluna (como R ou E) ou o nome de outro cálculo RECAP quando a função é chamada em um comando FML RECAP.

Formatos de Argumento

Dependendo da função, um argumento pode estar em formato alfanumérico, numérico ou de data. Se um argumento for fornecido no formato incorreto, um erro ocorrerá ou a função não irá exibir os dados corretos. Encontre abaixo os tipos de formatos de argumento:

Argumento alfanumérico. Um argumento alfanumérico é armazenado internamente como um caractere por byte. Um argumento alfanumérico pode ser um literal, campo alfanumérico, um número ou data armazenado no formato alfanumérico, uma expressão alfanumérica ou o formato de um campo alfanumérico. Um número literal se encontra entre aspas simples, exceto quando especificado nos sistemas operacionais que suportam os comandos RUN do Dialogue Manager (por exemplo, -MVS RUN).
Argumento numérico. Um argumento numérico é armazenado internamente como número binário ou compactado. Um argumento numérico inclui os formatos inteiro (I), ponto flutuante de precisão simples (F), ponto flutuante de precisão dupla (D) e decimal compactado (P). Um argumento numérico pode ser uma constante, campo ou expressão numérica ou o formato de um campo numérico.
Todos os argumentos são convertidos do formato de ponto flutuante com precisão dupla quando utilizados com uma função, mas os resultados são exibidos no formato especificado para o campo de saída.

Observação: Quando CDN ON, os argumentos numéricos devem ser delimitados por uma vírgula seguida de um espaço.
Argumento de data. Uma argumento de data que pode estar em formato alfanumérico, numérico ou de data. A lista de argumentos para a função individual irá especificar qual tipo de formato a função aceita. Um argumento de data pode ser uma data no formato alfanumérico, numérico ou de data; um campo de data ou expressão; o formato de um campo de data.
Se você fornece um argumento com um ano com dois dígitos, a função atribui um século com base nas definições de parâmetro DATEEFNS, YRTHRESH e DEFCENT.

Comprimento de Argumentos

Um argumento é passado para uma função por referência, o que significa que o local de memória do argumento é passado. Nenhum indício do comprimento do argumento é fornecido.

É necessário fornecer o comprimento do argumento para strings alfanuméricas. Algumas funções necessitam de um comprimento para os argumentos de entrada e saida (por exemplo, SUBSTR), enquanto outras utilizam um comprimento para ambos os argumentos (por exemplo, UPCASE).

Certifique-se de que todos os comprimentos estão corretos. O fornecimento de um comprimento incorreto pode causar resultados incorretos:

Se o comprimento especificado for menor do que o comprimento real, um subconjunto da string será utilizado. Por exemplo, passar o argumento 'ABCDEF' e especificar um comprimento de 3 faz com que a função processe uma string de 'ABC'.
Se o comprimento especificado for muito longo, tudo o que estiver na memória até este comprimento será incluído. Por exemplo, passar um argumento de 'ABC' e especificar um comprimento de 6 faz com que a função processe uma string que começa com 'ABC' e possui mais três caracteres nas próximas três posições da memória. Dependendo da utilização da memória, so três caracteres extra podem ser qualquer um.

Algumas rotinas de sistemas operacionais são muito sensíveis a comprimentos especificados de forma errônea e os leem nas áreas de memória formatada de maneira incorreta.

Argumentos de Número e Ordem

O número de argumentos necessário varia de acordo com cada função. Função fornecidas pela Information Builders podem precisar de até seis argumentos. As subrotinas gravadas por usuários podem necessitar de um máximo de 200 argumentos, incluindo o argumento de saída. Se uma função necessitar de mais de 200 argumentos, será necessário utilizar duas ou mais chamadas para passar os argumentos para a função.

Argumentos deve ser especificados na ordem exibida na sintaxe de cada função. A ordem obrigatória varia de acordo com a função.

Como Verificar Parâmetros de Funções

Como:

A configuração USERFCHK controla o nível de verificação aplicado em argumentos DEFINE FUNCTION e argumentos de função fornecidos pela Information Builders. Não afeta a verificação do número de parâmetros. O número correto deve semper ser fornecido.

O Maintain não suporta USERFCHK.

Funções normalmente esperam que parâmetros sejam de um tipo específico ou que tenham um comprimento que depende do valor de outro parâmetro. É possível, em algumas situações, aplicar estas regras através do truncamento do comprimento de um parâmetro e, portnato, impedir a geração de um erro na hora da execução.

O nível de verificação e possível conversão para um formato válido desempenhado depende da função específica. As duas situações a seguir podem ser normalmente convertidas de forma satisfatória:

Se um parâmetro numérico especificar um tamanho máximo para um parâmetro alfanumérico, mas a string alfanumérica fornecida for maior que o tamanho especificado, a string será truncada.
Se um parâmetro fornecido como um literal numérico especificar um valor maior que o tamanho máximo para um parâmetro, ele poderá ser reduzido para o valor adequado.

Topo da página

Sintaxe: Como Habilitar a Verificação de Parâmetro

A verificação de parâmetro pode ser habilitada pelo DEFINE FUNCTIONs e as funções fornecidas pela Information Builders. Se o seu site possuir uma função gravada no local com o mesmo nome que uma função fornecida pela Information Builders, a definição USERFNS determina qual função será utilizada.

SET USERFNS= {SYSTEM|LOCAL}

onde:

SYSTEM: Dá prioridade a funções fornecidas pela Information Builders. SYSTEM é o valor padrão. Esta definição é obrigatória para habilitar a verificação de parâmetro.
LOCAL: Dá preferência para funções gravadas localmente. A verificação de parâmetros não é desempenhada com esta definição em vigor.

Observação: Quando USERFNS for definido como LOCAL, as funções DT exibirão apenas uma data de seis dígitos.

Topo da página

Sintaxe: Como Controlar a Verificação de Parâmetro de Função

Emita o comando a seguir no FOCPARM, FOCPROF, na linha de comando, em um FOCEXEC ou em um comando ON TABLE. Observe que a definição USERFNS=SYSTEM deve estar em vigor.

SET USERFCHK = setting

onde:

configuração

Podem ser um dos seguintes:

ON é o valor padrão. Verifica parâmetros em solicitações, mas não verifica-os para funções utilizadas nos DEFINEs do Arquivo Master. Se um parâmetro possuir um comprimento incorreto, será feita uma tentativa para corrigir o problema. Se um problema não puder ser corrigido, uma mensagem de erro será gerada e a avaliação da expressão afetada será interrompida.
Já que não há verificação nos parâmetros de funções especificadas em um Arquivo Master, nenhum erro é relatado para estas funções até que o campo DEFINE seja utilizado em uma solicitação subsequente, quando, se houver um problema, a seguinte mensagem será gerada:
```
(FOC003) THE FIELDNAME IS NOT RECOGNIZED
```
OFF não verifica parâmetros, exceto nos casos a seguir:
- Se um parâmetro longo demais substituir a área da memória na qual o código computacional estiver armazenado, o tamanho será automaticamente reduzido sem a emissão de uma mensagem.
- Se um parâmetro alfanumérico for curto demais, ele será preenchido com espaços em branco para corrigir o comprimento.
Observação: A definição OFF será removida em um release futuro.
FULL é o mesmo que ON, mas também verifica os parâmetros para funções utilizadas em DEFINEs de Arquivos Master.
ALERT verifica parâmetros em uma solicitação sem impedir a execução quando um problema é detectado. Não verifica parâmetros para funções utilizadas nos DEFINEs do Arquivo Master. Se um parâmetro possuir um comprimento incorreto e uma tentativa for feita para consertar o problema no plano de fundo, este problema será corrigido sem mensagens. Se um problema como este não puder ser corrigido, uma mensagem de aviso será gerada. A execução continua como se a definição fosse OFF, mas os resultados pode estar incorretos.
Comunicado:
- Se um parâmetro fornecido for de um tipo incorreto, a verificação irá falhar e o processamento será interrompido.
- Erros encontrados durante o processamento de subrotinas, exceto quando fatais no sistema, são comunicados à rotina chamante através do retorno de um parâmetro de retorno inalterado, que é o último parâmetro na chamada da subrotina. Isto sempre é comunicado como espaços para saídas alfanuméricas.

Topo da página

Exemplo: Como Verificar Parâmetros com Erros Corrigíveis

A solicitação a seguir utiliza SUBSTR para extrair a substring que inicia na posição 6 e termina na posição 14 do campo TITLE. O quinto argumento especifica um comprimento de substring (500) que é muito longo (não deve ultrapassar 9).

SET USERFCHK = ON
TABLE FILE MOVIES
PRINT TITLE
COMPUTE
  NEWTITLE/A9  = SUBSTR(39, TITLE, 6  ,14, 500, NEWTITLE);
WHERE CATEGORY EQ 'CHILDREN'
END

Quando a solicitação é executada com USERFCHK=ON ou OFF, o comprimento incorreto é corrigido e a solicitação continua o processamento:

TITLE                                    NEWTITLE
-----                                    --------
SMURFS, THE                              S, THE
SHAGGY DOG, THE                          Y DOG, TH
SCOOBY-DOO-A DOG IN THE RUFF             Y-DOO-A D
ALICE IN WONDERLAND                       IN WONDE
SESAME STREET-BEDTIME STORIES AND SONGS  E STREET-
ROMPER ROOM-ASK MISS MOLLY               R ROOM-AS
SLEEPING BEAUTY                          ING BEAUT
BAMBI

Topo da página

Exemplo: Como Verificar Parâmetros com Erros Incorrigíveis

A solicitação a seguir possui um tipo incorreto de dados no último argumento para SUBSTR. Este parâmetro deve especificar um campo ou formato alfanumérico para a substring extraída:

SET USERFCHK = ON
TABLE FILE MOVIES
PRINT TITLE
COMPUTE
  NEWTITLE/F9  = SUBSTR(39, TITLE, 6  ,14, 500, 'F9');
WHERE CATEGORY EQ 'CHILDREN'
END

Quando a solicitação é executada com USERFCHK=ON, uma mensagem é produzida e a solicitação é interrompida:

ERROR AT OR NEAR LINE      5  IN PROCEDURE USERFC3 FOCEXEC
(FOC279) NUMERIC ARGUMENTS IN PLACE WHERE ALPHA ARE CALLED FOR
(FOC009) INCOMPLETE REQUEST STATEMENT
UNKNOWN FOCUS COMMAND  WHERE
 BYPASSING TO END OF COMMAND

Quando a solicitação é executada com USERFCHK=OFF, a verificação não é desempenhada e não se produz mensagens. A solicitação executa e produz resultados incorretos. Em alguns ambientes, este tipo de erro pode causar a interrupção anormal do aplicativo:

DIRECTOR          TITLE                                   NEWTITLE
--------          -----                                   --------
                  SMURFS, THE                            *********
BARTON C.         SHAGGY DOG, THE                        *********
                  SCOOBY-DOO-A DOG IN THE RUFF           *********
GEROMINI          ALICE IN WONDERLAND                            1
                  SESAME STREET-BEDTIME STORIES AND SONGS  -265774
                  ROMPER ROOM-ASK MISS MOLLY             *********
DISNEY W.         SLEEPING BEAUTY                        *********
DISNEY W.         BAMBI                                          0