Paramètres de Up ! Microsoft Sql Server

Tous les programmes en technologie Up ! Virtual Technical Machine possèdent les paramètres énumérés ci-après. Certains paramètres font référence à des fichiers ou à des chemins d'accès. En ce cas, il est possible d'employer des variables environnement dans l'expression des chemins d'accès. Exemple :

Tmp=${UPS_HOME}/demo/tmp/${UPS_USER}

D'autre part, le séparateur de répertoire est le caractère division / et les noms de fichiers ou de répertoires peuvent utiliser les partitions montées automatiquement par Up ! System.

Les paramètres sont lus successivement dans :

Les variables environnement.
Le fichier d'initialisation.
${UPS_HOME}/ini/${UPS_LANGUAGE}/upsaps.ini en mode mono-utilisateur ou ${UPS_HOME}/ini/${UPS_USER}/upsaps.ini en mode multi-utilisateur. Si le programme comporte un profil d'exécution particulier, les paramètres sont lus dans ce profil au lieu de upsaps.ini.
La section est UpsMss.
Le fichier de paramètres.
S'il existe.
La ligne de commande.
Il s'agit soit de :
- La ligne de commande stricto sensu.
- La valeur de la variable environnement QUERY_STRING.
  En ce cas, le programme s'exécute automatiquement et obligatoirement en mode batch en respectant la norme Common Gateway Interface (CGI).
Les paramètres peuvent être préfixés par UpsMss.

Les valeurs des paramètres comportant des caractères espace doivent être mises entre caractères guillemet " ou entre caractères apostrophe ' .

Paramètres d'exécution

Connexion

Connexion permet de spécifier une connexion par défaut sous la forme ${NomUtilisateur}/${MotDePasse}@${NomServeurDeDonnees}/${NomBaseDeDonnees}. Il n'y a pas de valeur par défaut.

Cette connexion est utilisée pour :

Pré établir une ou plusieurs connexions physiques avec Sql Server de Microsoft si le poule de connexions est activé.
Compléter les paramètres du constructeur du type ConnexionSqlServer.

Connexion=scott/tiger@sqlserver_nt

NbConnexionsMax

NbConnexionsMax précise le nombre maximal de connexions physiques vers Sql Server de Microsoft en attente d'usage par construction du type ConnexionSqlServer. La valeur par défaut est 0.

Quand ce paramètre est utilisé, il y a un poule de connexions par triplet (NomUtilisateur, NomServeurDeDonnees, NomBaseDeDonnees).

NbConnexionsMax=4

NbConnexionsMin

NbConnexionsMin précise le nombre minimal de connexions physiques vers Sql Server de Microsoft en attente d'usage par construction du type ConnexionSqlServer établies au lancement du module. La valeur par défaut est 0.

Quand ce paramètre est utilisé, le poule de connexions est initialisé avec la valeur du paramètre Connexion.

NbConnexionsMin=2

SynchroniserTransactions

SynchroniserTransactions spécifie que les connexions du poule sont synchronisées du point de vue de la validation ou l'invalidation des transactions. Par défaut, elles ne sont pas synchronisées.

SynchroniserTransactions=Oui

TailleMaxOrdreSql

TailleMaxOrdreSql précise la taille maximale d'un ordre Pl/Sql en nombre de caractères. Par défaut, la limite est 4096.

TailleMaxOrdreSql=8192

TempsDeGarde

TempsDeGarde précise le délai maximal en secondes du temps de connexion ou d'exécution des requêtes Sql pour Sql Server de Microsoft. Par défaut, il n'y a pas de limite.

TempsDeGarde=30

TracerSqlServer

TracerSqlServer permet de tracer les ordres Pl/Sql exécutés par le programme. La valeur par défaut est Non.

Cette trace est inscrite dans le fichier ${UPS_HOME}/log/${UPS_LANGUAGE}/${UPS_APPLICATION}-upsmss-${UPS_SESSION}.log en mode mono-utilisateur ou dans le fichier ${UPS_HOME}/log/${UPS_USER}/${UPS_APPLICATION}-upsmss-${UPS_SESSION}.log en mode multi-utilisateur.

TracerSqlServer=Oui

Optimisation du cycle de vie des objets

Type	Conservation possible	Taille par défaut du segment
BlocSqlServer	Oui.	8.
ConnexionSqlServer	Oui.	2.
OrdreSqlServer	Oui.	8.
RequeteSqlServer	Oui.	8.

ConserverObjets, quand le paramètre est possible, spécifie qu'au plus TailleSegment objets du type sont conservés pré-construits en anté-mémoire au lieu d'être détruits.

Quand un nouvel objet du type est demandé, il est prélevé de l'anté-moire s'il en existe un pré-construit. Cela évite de réaliser des enchaînements de destruction / libération / ... / allocation / création d'objets de ce type trop fréquents.

Par défaut, les objets ne sont pas conservés en anté-mémoire.

ConserverObjetsBlocSqlServer=Oui ConserverObjetsConnexionSqlServer=Non ConserverObjetsOrdreSqlServer=Oui ConserverObjetsRequeteSqlServer=Non

TailleSegment spécifie la taille d'un segment de mémoire dédié à un objet du type concerné en spécifiant le nombre d'objets de ce dernier par segment de mémoire. Ce nombre ne peut excéder la capacité du ramasse-miettes définie par TailleBloc*NbBlocs.

La valeur est 0 signifie que le type n'a pas ses propres buffers et que les objets du type sont alloués dans le tas commun.

TailleSegmentBlocSqlServer=16 TailleSegmentConnexionSqlServer=4 TailleSegmentOrdreSqlServer=16 TailleSegmentRequeteSqlServer=16

Exemple de configuration d'Up ! Microsoft Sql Server


; ------------------------------------------------------------------- 

; Fichier    : upsaps.ini                                             

; Objet      : Initialisation d'Up ! Virtual Technical Machine.        
   
;                                                                     

; Module      : Up ! Application System.                              

; Auteur-Date : DUVAL Jean-Pierre - Novembre 2003.                    

; ------------------------------------------------------------------- 

;                          Observations

;                                                                      

;                                                                      

; ------------------------------------------------------------------- 



[UpsMss]

Connexion=scott/tiger@sqlserver_nt

ConserverObjetsBlocSqlServer=Oui

ConserverObjetsConnexionSqlServer=Non

ConserverObjetsOrdreSqlServer=Oui

ConserverObjetsRequeteSqlServer=Non

NbConnexionsMin=2

NbConnexionsMax=4

SynchroniserTransactions=Oui

TailleMaxOrdreSql=8192

TailleSegmentBlocSqlServer=16

TailleSegmentConnexionSqlServer=4

TailleSegmentOrdreSqlServer=16

TailleSegmentRequeteSqlServer=16

TempsDeGarde=30

TracerSqlServer=Oui