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 TABLEetWHENEVER…NoteÀ vérifierVé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ù :
-eactive le traitement ESQL (il est obligatoire) ;-Sgénère des appels statiques à la bibliothèque d’exécution (recommandé) ;-Iindique les répertoires des copybooks : celui de la SQLCA et ceux du programme ;-iet-oindiquent 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
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
);