SQLConnect()

La fonction SQLConnect() s'utilise dans un QuickScript InTouch pour se connecter à une base de données spécifiée par l'argument ConnectString.

SQLConnect() renvoie une valeur à l’argument ConnectionID, utilisé comme paramètre dans toutes les fonctions SQL suivantes. Une liste de liens doit avoir été définie dans le dossier de l'application avant d'utiliser la fonction SQLConnect dans un script.

Catégorie

SQL

Syntaxe

[codeRetour=]SQLConnect(idConnexion, "chaîneConnexion");

Arguments

ConnectionID

Nom d'une variable mémoire de type entier, renseignée avec le numéro d'identifiant attribué par la fonction SQLConnect() à chaque connexion avec la base de données.

ConnectString

Chaîne qui identifie la base de données et toute autre information utilisée pour la connexion, dans la fonction SQLConnect().

Remarques

Vous devez avoir une liste de liens (un fichier SQL.DEF) dans le dossier d'applications. Sans cette liste, la fonction ne fonctionnera pas.

Si SQLTrace=1 figure sous la section [InTouch ] du fichier win.ini, chaque appel réussi à SQLConnect enregistrera dans Log Viewer les informations de version, du fournisseur ADO et du système de base de données à chaque exécution réussie.

Exemples

Cet exemple établit une connexion au gestionnaire IBM OS/2 et à la base de données EXEMPLE :

[ResultCode=]SQLConnect(ConnectionID,"DSN=OS2DM;
DB=SAMPLE");

Cette fonction renvoie une valeur dans la variable ConnectionID, utilisée comme paramètre dans toutes les fonctions SQL suivantes.

"DSN=data source name[;attribute=value
[;attribute=value]...] »