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.

NoteÀ vérifier

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

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
NoteÀ vérifier

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
NoteÀ vérifier

Vérifier MODE et PICX par rapport à la documentation de Pro*COBOL.