Immissione di un argomento in una funzione

Tipi di Argomento

I seguenti sono argomenti accettabili per una funzione:

Costante numerica, come 6 o 15.
Costante data, come 022802.
Data in formato alfanumerico, numerico, data o AnV.
Valore letterale alfanumerico, come STEVENS o NEW YORK NY. Un valore letterale deve essere racchiuso in virgolette singole.
Numero in formato alfanumerico.
Nome campo, come FIRST_NAME o HIRE_DATE. Un campo è in grado di essere un campo origine dati o un campo temporaneo. Un nome campo è in grado di essere lungo fino a 66 caratteri, o anche un nome campo qualificato, un troncamento univoco o un alias.
Espressione, come una espressione numerica, data o alfanumerica. Una espressione è in grado di usare operatori aritmetici e il simbolo di concatenazione (|). Per esempio, le seguenti sono espressioni valide:
```
CURR_SAL * 1.03
```
e
```
FN || LN
```
Variabile Dialogue Manager, come &CODE o &DDNAME.
Formato del valore di emissione racchiuso tra virgolette singole.
Altra funzione.
Etichetta o altro riferimento di colonna o riga (come R o E), o il nome di un altro calcolo RECAP, quando si chiama la funzione in un comando FML RECAP.

Formati Argomento

A seconda della funzione, un argomento è in grado di essere in formato data, alfanumerico o numerico. Se si fornisce un argomento nel formato sbagliato, si causerà un errore o la funzione non restituirà dati corretti. I seguenti sono tipi di blocchi di contenuto:

Argomento alfanumerico. Un argomento alfanumerico viene memorizzato internamente, un carattere per byte. Un argomento alfanumerico è in grado di essere un valore letterale, un campo alfanumerico, un numero o una data memorizzati in formato alfanumerico, una espressione alfanumerica o il formato di un campo alfanumerico. Un valore letterale è racchiuso tra virgolette singole, tranne quando specificato nei sistemi operativi che supportano i comandi RUN di Dialogue Manager (per esempio, -MVS RUN).
Argomento numerico. Un argomento numerico viene memorizzato internamente come un numero binario o compresso. Un argomento numerico include formati interi (I), virgola-mobile precisione-singola (F), virgola-mobile precisione-doppia (D) e decimale compresso (P). Un argomento numerico è in grado di essere una costante, un campo o una espressione numerica, o il formato di un campo numerico.
Tutti gli argomenti numerici sono convertiti nel formato virgola-mobile precisione-doppia, quando usati con una funzione, ma i risultati sono restituiti nel formato specificato per il campo d'emissione.

Nota: Con CDN ON, gli argomenti numerici devono essere delimitati da una virgola seguita da uno spazio.
Argomento data. Un argomento data è in grado di essere o in formato alfanumerico, numerico o data. L'elenco di argomenti per la funzione individuale specificheranno il tipo di formato accettato dalla funzione. Un argomento data è in grado di essere in formato data, alfanumerico o numerico; un campo data o espressione; o il formato di un campo data.
Se si fornisce un argomento con un anno a due cifre, la funzione assegna un secolo in base alle impostazioni dei parametri DATEFNS, YRTHRESH e DEFCENT.

Lunghezza Argomenti

Si inoltra un argomento ad una funzione per riferimento, ovvero si inoltra la posizione della memoria dell'argomento. Non è stata indicata nessuna lunghezza dell'argomento.

È necessario fornire la lunghezza dell'argomento per stringhe alfanumeriche. Alcune funzioni richiedono una lunghezza per gli argomenti di immissione e emissione (per esempio, SUBSTR) e altre usano una lunghezza per entrambi gli argomenti (per esempio, UPCASE).

Assicurarsi la correttezza di tutte le lunghezze. L'immissione di una lunghezza scorretta potrebbe causare risultati scorretti:

Se la lunghezza specificata è più corta della lunghezza effettiva, si usa un subset della stringa. Per esempio, inoltrando l'argomento 'ABCDF' e specificando una lunghezza di 3, porta la funzione ad elaborare un stringa di 'ABC'.
Se la lunghezza specificata è troppo lunga, si include tutto ciò presente in memoria fino a quella lunghezza. Per esempio, inoltrando un argomento di 'ABC' e specificando una lunghezza di 6, porta la funzione ad elaborare una stringa che inizia con 'ABC', oltre ai tre caratteri nelle tre posizioni successive della memoria. A seconda dell'uso della memoria, i tre caratteri extra possono essere qualsiasi cosa.

Alcune routine del sistema operativo sono molto sensibili a lunghezze scorrette specificate e le leggono in aree di memoria formattate in modo scorretto.

Numero dell'ordine degli argomenti

Il numero di argomenti richiesti varia a seconda di ogni funzione. Le funzioni fornite da Information Builders potrebbero richiedere fino a sei argomenti. Le subroutine scritte da utenti potrebbero richiedere fino a 200 argomenti, incluso l'argomento di emissione. Se una funzione richiede più di 200 argomenti, è necessario usare due o più chiamate per inoltrare gli argomenti alla funzione.

Gli argomenti devono essere specificati nell'ordine visualizzato nella sintassi di ogni funzione. L'ordine richiesto varia a seconda della funzione.

Verifica dei parametri della funzione

Come:

L'impostazione USERFCHK controlla il livello di verifica applicato agli argomenti DEFINE FUNCTION e agli argomenti funzione forniti da Information Builders. Non influenza la verifica del numero di parametri, il numero corretto deve essere sempre fornito.

USERFCHK non è supportato da Maintain.

Le funzioni, di solito, prevedono dei parametri di tipo specifico o di lunghezza a seconda del valore di un altro parametro. È possibile, in alcune situazioni, imporre queste regole troncando la lunghezza di un parametro e, quindi, evitando di generare un errore nel run time.

Il livello di verifica e di possibile conversione di un formato valido dipende dalla funzione specifica. Le seguenti due situazioni possono, di solito, essere convertite in modo soddisfacente:

Se un parametro numerico specifica una dimensione massima di un parametro alfanumerico, ma la stringa alfanumerica fornita è superiore alla dimensione specificata, è possibile troncare la stringa.
Se un parametro fornito come valore letterale numerico specifica un valore superiore alla dimensione massima per un parametro, è possibile ridurlo al valore appropriato.

Inizio pagina

Sintassi: Come abilitare la verifica dei parametri

È possibile abilitare la verifica dei parametri solo per DEFINE FUNCTION e funzioni fornite da Information Builders. Se il proprio sito presenta una funzione scritta a livello locale con lo stesso nome di una funzione fornita da Information Builders, l'impostazione USERFNS determina quale funzione usare.

SET USERFNS= {SYSTEM|LOCAL}

dove:

SYSTEM: Concede la precedenza a funzioni fornite da Information Builders. SYSTEM è il valore predefinito. Questa impostazione è richiesta per poter abilitare la verifica dei parametri.
LOCAL: Concede la precedenza a funzioni scritte localmente. La verifica dei parametri non viene eseguita con questa impostazione in vigore.

Nota: Quando USERFNS è impostato su LOCAL, le funzioni DT visualizzano solo una data a sei cifre.

Inizio pagina

Sintassi: Come controllare la verifica dei parametri della funzione

Emettere il seguente comando in FOCPARM, FOCPROF, sulla linea di comando, in un FOCEXEC, o in un comando ON TABLE. Notare che l'impostazione USERFNS=SYSTEM deve essere in vigore.

SET USERFCHK = setting

dove:

impostazione

Può essere una delle seguenti:

ON - È il valore predefinito. Verifica i parametri in richiesta, ma non verifica i parametri per funzioni usate in file principali DEFINE. Se un parametro ha una lunghezza scorretta, si tenta di risolvere il problema. Se non è possibile risolvere il problema, si genera un messaggio di errore e si determina la valutazione dell'espressione influenzata.
Poiché i parametri non sono verificati per funzioni specificate in un file principale, non si riportano errori per quelle funzioni fino all'uso del campo DEFINE in una richiesta successiva quando, se avviene un errore, si genera il seguente messaggio:
```
(FOC003) THE FIELDNAME IS NOT RECOGNIZED
```
OFF non verifica i parametri, tranne nei seguenti casi:
- Se il parametro troppo lungo sovrascriverebbe l'area della memoria in cui si trova il codice computazionale, la dimensione viene automaticamente diminuita senza emettere un messaggio.
- Se un parametro alfanumerico è troppo corto, si riempie con spazi fino al raggiungimento della lunghezza corretta.
Nota: L'impostazione OFF verrà deprecata in release future.
FULL è lo stesso di ON, ma verifica inoltre parametri per funzioni utilizzate nel file principale DEFINE.
ALERT verifica i parametri in una richiesta senza interrompere l'esecuzione quando si rileva un problema. Non verifica i parametri per le funzioni usate in file principali DEFINE. Se un parametro ha una lunghezza scorretta e si tenta di risolvere il problema dietro alle scene, il problema si corregge senza messaggi. Se non è possibile correggere il problema, si genera un messaggio di avvertenza. L'esecuzione continua come se l'impostazione fosse OFF, ma il risultato potrebbe essere scorretto.
Nota:
- Se il parametro fornito è scorretto, la verifica riporta degli errori e l'elaborazione finisce.
- Gli errori incontrati durante l'elaborazione della subroutine, tranne se fatale al livello di sistema, vengono comunicati alla routine in chiamata, tramite la restituzione di un parametro di ritorno non modificato, ovvero l'ultimo parametro della chiamata della subroutine. Tale procedura si comunica sempre con emissioni alfanumeriche.

Inizio pagina

Esempio: Verifica parametri con errori correggibili

La seguente richiesta usa SUBSTR per estrarre la sottostringa che inizia nella posizione 6 e finisce nella posizione 14 del campo TITLE. Il quinto argomento specifica la lunghezza di una sottostringa (500) troppo lunga (non dovrebbe essere superiore a 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 si esegue una richiesta con USERFCHK=ON o OFF, la lunghezza scorretta viene corretta e la richiesta continua l'elaborazione:

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

Inizio pagina

Esempio: Verifica parametri con errori non correggibili

La seguente richiesta ha un tipo di dati scorretti nell'ultimo argomento in SUBSTR. Questo parametro dovrebbe specificare un campo o formato alfanumerico per la sottostringa estratta:

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

Quando si esegue la richiesta con USERFCHK=ON, si crea un messaggio e la richiesta viene interrotta:

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 si esegue la richiesta con USERFCHK=OFF, non si esegue nessuna verifica e non si crea nessun messaggio. La richiesta esegue e produce risultati scorretti. In alcuni ambienti, questo tipo di errore potrebbe causare l'interruzione abnormale dell'applicazione:

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