Paramètres de Up ! Query

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 valeurs des paramètres comportant des caractères espace doivent être mises entre caractères guillemet " ou entre caractères apostrophe ' .

Pour connaître les paramètres des pilotes de base de données relationnelles, merci de se référer aux fiches :

Paramètres d'exécution

TailleMax

TailleMax permet de définir la taille maximale des données courtes produites par des expressions Sql de type Binaire ou Caractere. La valeur par défaut est respectivement 256 octets et 256 caractères Unicode.

TailleMax=512

TailleMaxBlocSql

TailleMaxBlocSql permet de définir la taille maximale d'un source d'un bloc PlSql dynamique. La valeur par défaut est 4096 caractères Unicode.

TailleMaxBlocSql=8192

TracerPlanRequete

TracerPlanRequete permet de tracer le plan des requêtes en Up ! 5GL. La valeur par défaut est Non.

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

TracerSourceRequete=Oui

TracerSourceRequete

TracerSourceRequete permet de tracer le source des requêtes en Up ! 5GL. La valeur par défaut est Non.

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

TracerSourceRequete=Oui

Optimisation du cycle de vie des objets

TypeConservation possibleTaille par défaut
du segment
EnregistrementSqlOui.8.
IBlocSqlOui.8.
IConnexionSqlOui.2.
IOrdreSqlOui.8.
IRequeteSqlOui.8.
ResultatRequeteSqlOui.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.

ConserverObjetsEnregistrementSql=Oui
ConserverObjetsIBlocSql=Non
ConserverObjetsIConnexionSql=Oui
ConserverObjetsIOrdreSql=Non
ConserverObjetsIRequeyeSql=Oui
ConserverObjetsResultatRequeteSql=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.

TailleSegmentEnregistrementSql=16
TailleSegmentIBlocSql=16
TailleSegmentIConnexionSql=4
TailleSegmentIOrdreSql=16
TailleSegmentIRequeteSql=16
TailleSegmentResultatRequeteSql=16

Exemple de configuration d'Up ! Query

; -------------------------------------------------------------------
; Fichier : upsaps.ini
; Objet : Initialisation d'Up ! Virtual Technical Machine.
;
; Module : Up ! Application System.
; Auteur-Date : DUVAL Jean-Pierre - Novembre 2003.
; -------------------------------------------------------------------
; Observations
;
;
; -------------------------------------------------------------------

[UpsQry]
ConserverObjetsEnregistrementSql=Oui
ConserverObjetsIBlocSql=Non
ConserverObjetsIConnexionSql=Oui
ConserverObjetsIOrdreSql=Non
ConserverObjetsIRequeyeSql=Oui
ConserverObjetsResultatRequeteSql=Non
TailleMax=512
TailleMaxBlocSql=8192
TailleSegmentEnregistrementSql=16
TailleSegmentIBlocSql=16
TailleSegmentIConnexionSql=4
TailleSegmentIOrdreSql=16
TailleSegmentIRequeteSql=16
TailleSegmentResultatRequeteSql=16
TracerPlanRequete=Oui
TracerSourceRequete=Oui