Variables hôtes et types de données
Variables hôtes
Une variable hôte est une donnée COBOL utilisée dans une instruction SQL, préfixée par deux-points. C’est une variable d’entrée lorsque sa valeur est envoyée à la base de données (clauses WHERE, VALUES, SET), et une variable de sortie lorsqu’elle reçoit une valeur de la base de données (clauses INTO).
EXEC SQL
SELECT ENAME, SAL INTO :EMP-NAME, :SALARY
FROM EMP WHERE EMPNO = :EMP-NUMBER
END-EXEC.
Les noms des variables hôtes ne sont pas sensibles à la casse et peuvent être qualifiés par leur groupe, comme en COBOL (:EMPNO OF EMP-REC).
Qualification (OF/IN) et utilisation d’une donnée de groupe comme liste de variables hôtes (INTO :EMP-REC).
Conversion des types de données
La bibliothèque d’exécution convertit les données COBOL depuis et vers les types de la base de données, selon la PICTURE et l’USAGE de la variable hôte :
| Déclaration COBOL | Envoyée à la base de données comme |
|---|---|
PIC X(n) |
chaîne de caractères (voir Chaînes de caractères de longueur fixe) |
PIC 9(n), PIC S9(n)V9(m) (DISPLAY) |
nombre |
PIC S9(n)V9(m) COMP-3 |
nombre |
PIC S9(n) COMP, COMP-5, BINARY |
entier |
COMP-1, COMP-2 |
virgule flottante |
PIC N(n) |
chaîne nationale |
Compléter ce tableau à partir de CobolVarType (runtime/libgixsql/SqlVar.h) et documenter la conversion des dates.
Chaînes de caractères de longueur fixe
L’option du précompilateur -P / --picx-as choisit comment les données PIC X sont envoyées à la base de données :
char(par défaut),charf- comme des chaînes de longueur fixe, espaces de fin compris ;
varchar- comme des chaînes de longueur variable, espaces de fin supprimés.
Cette option ne s’applique pas aux données VARYING, dont la longueur est toujours donnée par leur champ de longueur.
Chaînes de longueur variable : VARYING
Une donnée VARYING possède une partie longueur et une partie données :
01 ENAME PIC X(20) VARYING.
Le précompilateur la remplace par un groupe de deux données de niveau 49 :
01 ENAME.
49 ENAME-LEN PIC 9(8) COMP-5.
49 ENAME-ARR PIC X(20).
En sortie, la bibliothèque d’exécution affecte à ENAME-LEN la longueur de la valeur ; en entrée, seuls les ENAME-LEN premiers caractères sont envoyés.
- Les suffixes
-LENet-ARRpeuvent être modifiés avec-Y/--varying(par exemple--varying=LEN,TEXT). - Le champ de longueur fait 4 octets par défaut. Pro*COBOL utilise une longueur sur 2 octets (
PIC S9(4) COMP) : utilisez-N 2/--varying-length-size 2. Le code généré indique à la bibliothèque d’exécution la taille des champs de longueur.
Les données de groupe contenant des données de niveau 49 écrites à la main sont également reconnues comme des chaînes de longueur variable, comme dans Pro*COBOL. Leur champ de longueur doit avoir la taille donnée par -N.
Détection des groupes de niveau 49 écrits à la main, et PIC X(n) VARYING par rapport à USAGE VARRAW.
SQL TYPE IS
La clause SQL TYPE IS déclare une variable hôte avec un type SQL :
01 BUFFER SQL TYPE IS VARBINARY(100).
01 STMT SQL TYPE IS VARCHAR(500).
VARCHAR et VARBINARY génèrent un groupe VARYING comme ci-dessus.
EXEC SQL VAR
L’instruction VAR donne un type SQL à une donnée existante (datatype equivalencing, dans la terminologie de Pro*COBOL) :
01 VARD PIC X(120).
01 NUM3 COMP-2.
...
EXEC SQL VAR VARD IS VARCHAR(120) END-EXEC.
EXEC SQL VAR NUM3 IS FLOAT END-EXEC.
Les types supportés sont CHAR, CHARF, VARCHAR, VARCHAR2 (identique à VARCHAR), VARBINARY, INTEGER, FLOAT, DECIMAL et LONG RAW.
Variables indicatrices
Une variable indicatrice est associée à une variable hôte pour gérer les valeurs NULL. Elle doit être déclarée PIC S9(4) COMP, et s’écrit juste après la variable hôte, éventuellement précédée de INDICATOR :
01 COMM PIC S9(5)V99 COMP-3.
01 COMM-IND PIC S9(4) COMP.
...
EXEC SQL
SELECT COMM INTO :COMM:COMM-IND
FROM EMP WHERE EMPNO = :EMP-NUMBER
END-EXEC.
IF COMM-IND = -1
DISPLAY "No commission"
END-IF.
| Valeur | En sortie (SELECT, FETCH) |
En entrée (INSERT, UPDATE) |
|---|---|---|
-1 |
la colonne est NULL |
NULL est envoyé, la variable hôte est ignorée |
0 |
la valeur a été stockée | la variable hôte est envoyée |
La troncature (valeurs positives de l’indicateur) n’est pas signalée.
Mot-clé INDICATOR, tables d’indicateurs pour les données de groupe.
Tables hôtes (tableaux)
GixSQL ne supporte pas les tables hôtes : une variable hôte ne peut pas être une table (OCCURS) permettant de lire ou d’insérer plusieurs lignes en une seule instruction. Utilisez plutôt un curseur et une boucle. Voir Comparaison des fonctionnalités.