Migrer depuis Pro*COBOL
Ce chapitre explique comment précompiler et exécuter avec GixSQL des programmes écrits pour Oracle Pro*COBOL, sur une base de données Oracle ou sur PostgreSQL.
Réglages recommandés
| Réglage | Où | Pourquoi |
|---|---|---|
-N 2 |
gixpp | éléments VARYING avec une longueur sur 2 octets (PIC S9(4) COMP), comme Pro*COBOL |
--no-rec-code 1403 |
gixpp | SQLCODE de la condition « aucun enregistrement », comme Oracle, pour WHENEVER NOT FOUND |
GIXSQL_NOREC_CODE=1403 |
environnement | la même chose, à l’exécution |
GIXSQL_AUTOCOMMIT=off |
environnement | les transactions sont explicites avec Pro*COBOL ; sur PostgreSQL, les curseurs nécessitent une transaction |
--code-end-col 512 |
gixpp | sources précompilés par procob avec format=terminal ireclen=512, avec du code après la colonne 72 |
Une compilation typique est :
$ gixpp -e -S -N 2 --no-rec-code 1403 --code-end-col 512 \
-I /opt/gixsql/share/gixsql/copy -I copy -E ".,cpy,CPY" \
-i prog.pco -o prog.cob
$ cobc -x prog.cob -L /opt/gixsql/lib -lgixsql
$ export GIXSQL_NOREC_CODE=1403 GIXSQL_AUTOCOMMIT=off
$ export DATASRC=oracle://dbserver:1521/ORCLPDB1
$ ./prog
Connexion
Les programmes Pro*COBOL se connectent avec CONNECT :USR IDENTIFIED BY :PWD, éventuellement USING :DB-STRING avec un alias SQL*Net. Avec GixSQL, l’opérande de USING est une chaîne de connexion GixSQL (Chaînes de connexion), et non un alias Oracle.
Comportement de CONNECT ... IDENTIFIED BY sans USING (le mode 4 de la grammaire est « unsupported »).
COMMIT WORK RELEASE et ROLLBACK WORK RELEASE terminent la transaction et ferment la connexion.
Exécution sur PostgreSQL
Les programmes écrits pour Oracle peuvent s’exécuter sur PostgreSQL, à condition que leur SQL soit compatible. L’extension orafce fournit de nombreuses fonctions Oracle (NVL, DECODE, TO_DATE…). Son schéma oracle doit précéder pg_catalog dans le chemin de recherche, afin que oracle.to_date soit utilisée à la place de la fonction to_date de PostgreSQL :
pgsql://dbserver/db?default_schema=myschema,oracle,pg_catalog,public
Différences SQL courantes : ROWNUM, jointures externes (+), SYSDATE, chaînes vides et NULL, DUAL, séquences (seq.NEXTVAL).
Comparaison des fonctionnalités
Le tableau suit les chapitres du Pro*COBOL Programmer’s Guide.
| Fonctionnalité Pro*COBOL | GixSQL |
|---|---|
| Section de déclaration | acceptée, non obligatoire |
EXEC SQL INCLUDE |
pris en charge |
Précompilation conditionnelle (EXEC ORACLE IFDEF) |
non prise en charge |
CONNECT ... IDENTIFIED BY, AT |
pris en charge |
CONNECT :USR-PWD (user/password dans un seul élément) |
non pris en charge |
COMMIT, ROLLBACK, SAVEPOINT, RELEASE |
pris en charge |
SET TRANSACTION, LOCK TABLE |
transmis à la base de données |
| Variables hôtes, variables indicatrices | prises en charge |
Variables VARCHAR / VARYING (longueur sur 2 octets) |
prises en charge avec -N 2 |
Équivalence de types de données (EXEC SQL VAR) |
partielle : voir Variables hôtes et types de données |
EXEC SQL TYPE |
non pris en charge |
ROWID universel |
lu sous forme de chaînes de caractères (Oracle) |
SELECT INTO, INSERT, UPDATE, DELETE |
pris en charge |
Curseurs, WHERE CURRENT OF |
pris en charge |
Curseurs défilants (FETCH PRIOR, ABSOLUTE…) |
non pris en charge |
Blocs PL/SQL embarqués (EXEC SQL EXECUTE BEGIN ... END; END-EXEC) |
non pris en charge |
| Tables hôtes (tableaux) | non prises en charge |
| SQLCA | prise en charge |
| ORACA | non prise en charge |
WHENEVER (SQLERROR, SQLWARNING, NOT FOUND) |
pris en charge |
WHENEVER ... DO, STOP |
non pris en charge |
| SQL dynamique, méthodes 1, 2, 3 | pris en charge |
| SQL dynamique méthode 4 (SQLDA), SQL dynamique ANSI (descripteurs) | non pris en charge |
| Contextes d’exécution, multithreading | non pris en charge |
| Instructions LOB | non prises en charge |
| Options du précompilateur | voir la correspondance ci-dessous |
Chaque ligne « non pris en charge » ci-dessus, en particulier SET TRANSACTION, EXEC SQL TYPE, les curseurs défilants, WHENEVER ... DO, et la transmission générique des instructions inconnues.
Options du précompilateur
Option de procob |
Équivalent gixpp |
|---|---|
INAME, ONAME |
-i, -o |
INCLUDE |
-I |
FORMAT=TERMINAL, IRECLEN |
--code-end-col |
MODE=ANSI (SQLCODE 100 sur « aucun enregistrement ») |
par défaut |
MODE=ORACLE (SQLCODE 1403) |
--no-rec-code 1403 |
PICX=VARCHAR2 |
-P varchar |
PICX=CHARF |
-P charf (par défaut) |
VARCHAR=YES |
les groupes de niveau 49 sont toujours reconnus |
SQLCHECK, USERID |
pas d’équivalent : aucune vérification sémantique |
RELEASE_CURSOR, HOLD_CURSOR, MAXOPENCURSORS |
pas d’équivalent |
Vérifier MODE et PICX par rapport à la documentation de Pro*COBOL.