Concepts du précompilateur

SQL embarqué dans un programme COBOL

Une instruction SQL embarquée commence par EXEC SQL et se termine par END-EXEC, suivi d’un point lorsque l’instruction termine une phrase COBOL :

           EXEC SQL
               UPDATE EMP SET SAL = SAL * 1.1 WHERE DEPTNO = :DEPT-NO
           END-EXEC.

À l’intérieur de l’instruction, les données COBOL, appelées variables hôtes, sont préfixées par deux-points (:DEPT-NO). Le précompilateur transmet leur adresse, leur type et leur taille à la bibliothèque d’exécution, qui convertit leur contenu depuis et vers les types de la base de données (voir Variables hôtes et types de données).

Les instructions SQL embarquées peuvent apparaître :

  • dans la DATA DIVISION : INCLUDE, BEGIN/END DECLARE SECTION, DECLARE ... CURSOR, VAR, DECLARE TABLE et WHENEVER…

    NoteÀ vérifier

    Vérifier où chaque instruction est acceptée par gixpp.

  • dans la PROCEDURE DIVISION : toutes les instructions exécutables.

La section de déclaration

Pro*COBOL et la norme SQL exigent que les variables hôtes soient déclarées entre BEGIN DECLARE SECTION et END DECLARE SECTION :

           EXEC SQL BEGIN DECLARE SECTION END-EXEC.
       01  EMP-NAME    PIC X(20).
       01  SALARY      PIC S9(7)V99 COMP-3.
           EXEC SQL END DECLARE SECTION END-EXEC.

GixSQL accepte ces instructions, mais ne les exige pas : toute donnée de la WORKING-STORAGE, LOCAL-STORAGE ou LINKAGE SECTION peut être utilisée comme variable hôte.

Inclusion de fichiers

EXEC SQL INCLUDE name END-EXEC inclut un copybook, comme une instruction COBOL COPY, mais le fichier inclus est également traité par le précompilateur. Elle sert surtout pour la SQLCA :

           EXEC SQL INCLUDE SQLCA END-EXEC.

Les copybooks sont recherchés dans les répertoires indiqués avec -I / --copypath, avec les extensions indiquées avec -E / --esql-copy-exts. Les instructions COBOL COPY ne sont traitées par le précompilateur qu’avec -p / --esql-preprocess-copy (voir Le précompilateur gixpp).

Précompilation, compilation et édition de liens

La séquence complète pour construire un programme prog.pco est :

$ gixpp -e -S -I /opt/gixsql/share/gixsql/copy -I . \
        -i prog.pco -o prog.cob
$ cobc -x prog.cob -L /opt/gixsql/lib -lgixsql

où :

  • -e active le traitement ESQL (il est obligatoire) ;
  • -S génère des appels statiques à la bibliothèque d’exécution (recommandé) ;
  • -I indique les répertoires des copybooks : celui de la SQLCA et ceux du programme ;
  • -i et -o indiquent les fichiers d’entrée et de sortie.

Un premier programme

Le programme suivant se connecte à une base de données dont la chaîne de connexion se trouve dans la variable d’environnement DATASRC, compte les lignes d’une table et affiche le résultat.

       IDENTIFICATION DIVISION.
       PROGRAM-ID. FIRST.
       DATA DIVISION.
       WORKING-STORAGE SECTION.
       01  DATASRC  PIC X(64).
       01  DBUSR    PIC X(64).
       01  DBPWD    PIC X(64).
       01  NB-ROWS  PIC 9(6) VALUE 0.
           EXEC SQL INCLUDE SQLCA END-EXEC.
       PROCEDURE DIVISION.
           ACCEPT DATASRC FROM ENVIRONMENT "DATASRC".
           ACCEPT DBUSR   FROM ENVIRONMENT "DATASRC_USR".
           ACCEPT DBPWD   FROM ENVIRONMENT "DATASRC_PWD".

           EXEC SQL
               CONNECT TO :DATASRC USER :DBUSR USING :DBPWD
           END-EXEC.
           IF SQLCODE NOT = 0
               DISPLAY "CONNECT failed: " SQLCODE " " SQLERRMC
               STOP RUN
           END-IF.

           EXEC SQL
               SELECT COUNT(*) INTO :NB-ROWS FROM EMP
           END-EXEC.
           DISPLAY "EMP contains " NB-ROWS " rows".

           EXEC SQL CONNECT RESET END-EXEC.
           STOP RUN.

Pour le construire et l’exécuter sur une base PostgreSQL :

$ gixpp -e -S -I /opt/gixsql/share/gixsql/copy -i first.pco -o first.cob
$ cobc -x first.cob -L /opt/gixsql/lib -lgixsql
$ export LD_LIBRARY_PATH=/opt/gixsql/lib
$ export DATASRC=pgsql://localhost:5432/demo
$ export DATASRC_USR=demo DATASRC_PWD=secret
$ ./first
EMP contains 000014 rows
NoteÀ vérifier

Exécuter cet exemple sur les bases de test et coller la sortie réelle.

Tables d’exemple

Les exemples de ce manuel utilisent les tables classiques DEPT et EMP :

CREATE TABLE DEPT (
  DEPTNO  NUMERIC(2) PRIMARY KEY,
  DNAME   VARCHAR(14),
  LOC     VARCHAR(13)
);
CREATE TABLE EMP (
  EMPNO    NUMERIC(4) PRIMARY KEY,
  ENAME    VARCHAR(10),
  JOB      VARCHAR(9),
  MGR      NUMERIC(4),
  HIREDATE DATE,
  SAL      NUMERIC(7,2),
  COMM     NUMERIC(7,2),
  DEPTNO   NUMERIC(2) REFERENCES DEPT
);