La source Middleware (SRC = " Middleware") permet la lecture de données dans toute base de données accessible via le Middleware Hardis (programme de service AWSCDF).
Ceci comprend :
les bases de données AS/400,
les bases SQL micro accessibles par un Driver SQL API (DB2, Oracle, SQL Server, ODBC),
les bases de données SQL accessibles via un pilote JDBC (Middleware JAVA).
Les paramètres reconnus pour la source sont les suivants :
Paramètres en entrée (DATA_SRC)
Nom paramètre |
Type |
Obligatoire |
Description |
SERVER |
chaîne |
Oui |
Nom d'hôte ou adresse IP du serveur (le démon Middleware doit être installé sur le serveur, ainsi que le programme de service AWSCDF et les Drivers SQL requis). |
PORT |
chaîne |
Oui |
Port de connexion du démon Middleware (numéro ou nom de service). |
MID_CONNECT |
chaîne |
Oui |
Chaîne de connexion au Middleware Hardis sous la forme "user.password". L'utilisateur spécifié doit être enregistré sur le serveur. |
SERVER_TYPE |
entier |
Non |
Type du serveur (AS/400, Windows ou Java). - 0 : serveur AS/400, - 1 : serveur Windows, - 2 : serveur Java. |
FILE |
chaîne |
Oui |
Nom du fichier AS/400 / fichier BTrieve / table SQL dont les données doivent être exportées. |
SELECT |
chaîne |
Non |
Clause de sélection optionnelle des données du fichier (bases SQL ou AS/400). Sur une base SQL, la clause est la partie droite d'une clause WHERE (select * from table where clause). Sur une base AS/400, la clause est transformé en commande OPENQRYF. Cette commande de sélection n'est pas autorisée sur les fichiers BTrieve. |
TRM_LENGTH |
entier |
Non |
Taille maximum (en Ko) estimée des trames Middleware générées. |
Paramètre AS/400 |
|||
LIB |
chaîne |
Oui |
Bibliothèque contenant le fichier. |
Paramètres Windows |
|||
DBM |
chaîne |
Oui |
Type (alias) du gestionnaire de bases de données : - DB2 : pilote API pour DB2 UDB, - Oracle : pilote API pour Oracle (8.0 et >), - SQL Server : pilote API pour SQL Server, - ODBC : pilote API pour ODBC, - BTrieve : bases de données Btrieve. Les valeurs Oracle7 et Oracle8 sont reconnues pour compatibilité avec les scripts existants. |
DATABASE DB |
chaîne |
Oui (*) |
Nom ou URL d'accès de la base de données contenant les données à transférer. |
DB_CONNECT |
chaîne |
Non (*) |
Chaîne de connexion à la base de données sous la forme "user.password". Si ce paramètre n'est pas spécifié, une connexion système sera tentée. |
SCHEMA |
chaîne |
Non (*) |
Schéma propriétaire de la table. La valeur par défaut (implicite) est le nom de l'utilisateur connecté (paramètre DB_CONNECT ou connexion système du programme AWSCDF). |
FILEDIR |
chaîne |
Oui (**) |
Répertoire contenant les fichiers BTrieve sur le serveur. |
Paramètres Java |
|||
DRIVER |
chaîne |
Oui |
Nom du driver JDBC (par exemple : com.ibm.db2.jcc.DB2Driver). |
URL |
chaîne |
Oui |
URL JDBC pour la connexion à la base de données (par exemple : jdbc:db2:TESTBD). La syntaxe de cette URL dépend du driver JDBC utilisé. |
DB_CONNECT |
chaîne |
Non |
Chaîne de connexion à la base de données sous la forme "user.password". |
SCHEMA |
chaîne |
Non |
Schéma propriétaire de la table. La valeur par défaut (implicite) est le nom de l'utilisateur connecté (paramètre DB_CONNECT ou connexion système du programme AWSCDF). |
Notes :
(*) |
Pour une base SQL |
(**) |
Pour une base BTrieve |
Paramètres en sortie (DATA_DEST)
Nom paramètre |
Type |
Obligatoire |
Description |
SERVER |
chaîne |
Oui |
Nom d'hôte ou adresse IP du serveur (le démon Middleware doit être installé sur le serveur, ainsi que le programme de service AWSCDF et les Drivers SQL requis). |
PORT |
chaîne |
Oui |
Port de connexion du démon Middleware (numéro ou nom de service). |
MID_CONNECT |
chaîne |
Oui |
Chaîne de connexion au Middleware Hardis sous la forme "user.password". L'utilisateur spécifié doit être enregistré sur le serveur. |
SERVER_TYPE |
entier |
Non |
Type du serveur (AS/400, Windows ou Java). - 0 : serveur AS/400, - 1 : serveur Windows, - 2 : serveur Java. |
FILE |
chaîne |
Oui |
Nom du fichier AS/400 (table SQL) dans lequel les données doivent être insérées. |
MODE |
chaîne |
Non |
Mode d'insertion des données : - INSERT : les données sont insérées dans la table (défaut). - REPLACE : les données viennent remplacer les données de la table. Une clause de suppression peut alors être spécifiée (DELETE) ; sinon, toutes les données originelles de la table sont supprimées. - UPDATE : les données sont mises à jour ou ajoutées en fonction de la clé primaire de la table. Si la table ne possède pas de clé ou si la clé comprend toutes les colonnes, les données sont ajoutées. (Ce mode n'est pas géré pour AS/400). |
DELETE |
chaîne |
Non |
Clause de suppression optionnelle des données du fichier (bases SQL ou AS/400). Sur une base SQL sur AS/400, la clause est la partie droite d'une clause WHERE (delete * from table where clause). Cette clause ne sera analysée que si le mode d'insertion est remplacement (MODE="REPLACE"). Cette commande n'est pas autorisée pour les fichiers BTrieve. |
TRM_LENGTH |
entier |
Non |
Taille maximum (en Ko) estimée des trames Middleware générées. Dans le cas où la destination est une base SQL micro, la validation des modifications (COMMIT) se fait à la fin du traitement des données de la trame. |
Paramètre AS/400 |
|||
LIB |
chaîne |
Oui |
Bibliothèque contenant le fichier. |
Paramètres Windows |
|||
DBM |
chaîne |
Oui |
Type (alias) du gestionnaire de bases de données : - DB2 : pilote API pour DB2 UDB, - Oracle : pilote API pour Oracle (8.0 et >), - SQL Server : pilote API pour SQL Server, - ODBC : pilote API pour ODBC. Les valeurs Oracle7 et Oracle8 sont reconnues pour compatibilité avec les scripts existants. |
DATABASE DB |
chaîne |
Oui* |
Nom ou URL d'accès de la base de données contenant les données à transférer. |
DB_CONNECT |
chaîne |
Non* |
Chaîne de connexion à la base de données sous la forme "user.password". Si ce paramètre n'est pas spécifié, une connexion système sera tentée. |
SCHEMA |
chaîne |
Non* |
Schéma propriétaire de la table. La valeur par défaut (implicite) est le nom de l'utilisateur connecté (paramètre DB_CONNECT ou connexion système du programme AWSCDF). |
FILEDIR |
chaîne |
Oui** |
Répertoire contenant les fichiers BTrieve sur le serveur. |
Paramètres Java |
|||
DRIVER |
chaîne |
Oui |
Nom du driver JDBC (par exemple : com.ibm.db2.jcc.DB2Driver). |
URL |
chaîne |
Oui |
URL JDBC pour la connexion à la base de données (par exemple : jdbc:db2:TESTBD) . La syntaxe de cette URL dépend du driver JDBC utilisé. |
DB_CONNECT |
chaîne |
Non |
Chaîne de connexion à la base de données sous la forme "user.password". |
SCHEMA |
chaîne |
Non |
Schéma propriétaire de la table. La valeur par défaut (implicite) est le nom de l'utilisateur connecté (paramètre DB_CONNECT ou connexion système du programme AWSCDF). |
Notes :
(*) |
Pour une base SQL |
(**) |
Pour une base BTrieve |
Spécificités de la version Java :
La source Middleware est 100% compatible avec la version Windows de l'outil. Les données ANSI sont transmises dans la page de code ANSI configurée (Cp1252 ou override par -DansiCharset).