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).

NoteÀ vérifier

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
NoteÀ compléter

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 -LEN et -ARR peuvent ê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.

NoteÀ vérifier

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.

NoteÀ vérifier

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.