FIXER PARAMETRE BASE

4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant

version 2004.5 (Modifiée)


FIXER PARAMETRE BASE ({table; }sélecteur; valeur)

ParamètreTypeDescription
tableTableTable à paramétrer ou
Table par défaut si ce paramètre est omis
sélecteurEntier longCode du paramètre de la base à modifier
valeurEntier long | AlphaValeur du paramètre

Description

La commande FIXER PARAMETRE BASE permet de modifier divers paramètres internes de la base de données 4D.

sélecteur désigne le paramètre à modifier. 4e Dimension vous propose des constantes prédéfinies, placées dans le thème "Paramètres de la base". Le tableau suivant liste chaque constante et décrit sa portée (son aire d'action) :

Constante sélecteurValeurPortée
Ratio de tri séq1Table et process courants
Optimisation accès séq2Table et process courants
Ratio valeurs distinctes séq3Table et process courants
Compression index4Application 4D (*)
Ratio chercher dans sélec séq5Table et process courants
Minimum process Web64e Dimension, 4D Server (*)
Maximum process Web74e Dimension, 4D Server (*)
Mode conversion Web8Process courant
Taille cache données9Application 4D (*) (**)
Appels système 4e Dimension10Application 4D (*)
Appels système 4D Server11Application 4D (*)
Appels système 4D Client12Application 4D (*)
Timeout 4D Server13Application 4D sauf si valeur négative (***)
Timeout 4D Client14Application 4D sauf si valeur négative (***)
Numéro du port154e Dimension, 4D Server (*)
Adresse IP d'écoute164e Dimension, 4D Server (*)
Jeu de caractères174e Dimension, 4D Server (*)
Process Web simultanés maxi184e Dimension, 4D Server (*)
Client Minimum process Web19Tous postes 4D Client (*)
Client Maximum process Web20Tous postes 4D Client (*)
Client Taille max requêtes Web21Tous postes 4D Client (*)
Client Numéro de port22Tous postes 4D Client (*)
Client Adresse IP d'écoute23Tous postes 4D Client (*)
Client Jeu de caractères24Tous postes 4D Client (*)
Client Proc Web simultanés maxi25Tous postes 4D Client (*)
Mode écriture cache26Application 4D (*)
Taille maximum requêtes Web274e Dimension, 4D Server (*)
Enreg requêtes 4D Server284D Server, 4D Client (*)
Enreg requêtes Web294e Dimension, 4D Server (*)
Client Enreg requêtes Web30Tous postes 4D Client (*)
Numéro automatique table31Application 4D
Précision affichage réels32Application 4D
TCP_NODELAY33Application 4D (*)
Enreg événements debogage34Application 4D (*)
Numéro du port client serveur35Base de données (*)
Signature WEDD36Base de données (*)
Inversion des objets37Base de données (*)
Numéro de port HTTPS394e Dimension, 4D Server (*)
Client Numéro de port HTTPS40Tous postes 4D Client (*)

(*) Dans ce cas, le paramètre table est ignoré s'il est passé.

(**) Ce sélecteur ne peut être utilisé qu'en lecture (voir commande Lire parametre base).

(***) Si le paramètre valeur est négatif, le paramétrage est local au process courant et réinitialisé à la requête suivante.

valeur désigne la valeur du paramètre. La valeur à passer dépend du paramètre que l'on souhaite modifier. Voici les valeurs possibles pour chaque sélecteur :

Sélecteur = 1 (Ratio de tri séq)

Valeurs possibles : 0 -> 100 000

Description : Ratio d'enregistrements sélectionnés (par rapport au nombre total d'enregistrements) au-dessous duquel les tris sont effectués en mode séquentiel. Ce ratio doit être exprimé sur 100 000. La valeur par défaut est 9 000 (soit 9 %).

Sélecteur = 2 (Optimisation accès séq)

Valeurs possibles : 0 ou 1 (0 = non optimisé, 1 = optimisé)

Description : Mode d'optimisation pour les accès séquentiels (tris, recherches, SELECTION VERS TABLEAU). Par défaut, la valeur est 1 (mode optimisé). En mode optimisé, 4D tente de lire depuis le disque plusieurs enregistrements en une fois. Ce mode est particulièrement intéressant lorsque la taille du cache est faible.

Sélecteur = 3 (Ratio valeurs distinctes séq)

Valeurs possibles : 0 -> 100 000

Description : Ratio d'enregistrements sélectionnés (par rapport au nombre total d'enregistrements) au-dessous duquel la commande VALEURS DISTINCTES sera exécutée en mode séquentiel. Ce ratio doit être exprimé sur 100 000.

Sélecteur = 4 (Compression index)

Valeurs possibles : 0 ou 1 (0 = non, 1 = oui)

Description : Activation ou non de la compression des pages d'index. Par défaut, la valeur est 1 (les index sont compressés si nécessaire).

Les pages d'index peuvent, dans des bases contenant beaucoup d'index et d'enregistrements, consommer beaucoup de place dans la mémoire cache de 4D. Lorsque le cache est plein et que 4D a besoin de place supplémentaire, les données se trouvant dans le cache ne sont plus directement déchargées : avant d'effectuer cette opération, le programme va contrôler s'il peut gagner de la place en compactant des pages d'index. Cette alternative permet d'éviter le rechargement ultérieur des données.

Sélecteur = 5 (Ratio chercher dans sélec séq)

Valeurs possibles : 0 -> 100 000

Description : Ratio d'enregistrements sélectionnés (par rapport au nombre total d'enregistrements) au-dessous duquel la commande CHERCHER DANS SELECTION sera exécutée en mode séquentiel. Ce ratio doit être exprimé sur 100 000.

Sélecteur = 6 (Minimum process Web)

Valeurs possibles : 0 -> 32 767

Description : Nombre minimum de process Web à maintenir en mode sans contexte avec 4e Dimension et 4D Server. Par défaut, la valeur est 0 (cf. ci-dessous).

Sélecteur = 7 (Maximum process Web)

Valeurs possibles : 0 -> 32 767

Description : Nombre maximum de process Web à maintenir en mode sans contexte avec 4e Dimension et 4D Server. Par défaut, la valeur est 10.

Afin que le serveur Web soit réactif, en mode sans contexte, 4D maintient endormis les process Web pendant 5 secondes, et les réutilise pour traiter les éventuelles requêtes HTTP suivantes. En termes de performances, ce principe est en effet plus avantageux que la création d'un nouveau process à chaque requête. Une fois un process Web réutilisé, il est à nouveau endormi pour 5 secondes, sauf si le nombre maximum de process Web est dépassé (auquel cas il est tué). Si aucune requête n'a été attribuée à un process Web durant les 5 secondes, il est tué, sauf si un nombre minimum de process Web a été fixé et est atteint (auquel cas il est à nouveau endormi).

Ces paramètres vous permettent d'ajuster le fonctionnement de votre serveur Web en fonction du nombre de requêtes, de la mémoire disponible, etc.

Sélecteur = 8 (Mode conversion Web)

Valeurs possibles : 0, 1, 2 ou 3

0 (mode par défaut) = Conversion au format HTML 4.0 si le browser le permet. Sinon, format HTML 3.2 + usage de tableaux.

1 = Conversion au format HTML 2.0 (mode 6.0.x),

2 = Conversion au format HTML 3.2 (mode 6.5),

3 = Conversion au format HTML 4.0 + CSS-P (depuis version 6.5.2).

Description : Mode de conversion des formulaires 4D pour le Web avec 4e Dimension et 4D Server.

Par défaut, le serveur Web 4D utilise les feuilles de style en cascade (CSS1) pour générer des pages HTML dont l'apparence est très proche de celle des formulaires obtenus dans 4e Dimension.

Dans le cas des bases créées avec des versions de 4D antérieures à la 6.7, ce fonctionnement peut perturber la conversion correcte des formulaires. Vous pouvez donc modifier le mode de conversion des formulaires.

Ce mode n'est utilisé que pour le process (contexte Web) dans lequel la commande FIXER PARAMETRE BASE est appelée. Elle peut être placée dans la Méthode base Sur connexion Web pour assurer la conversion des formulaires de la base, ou juste avant l'appel d'un formulaire particulier. Hors du mode contextuel ou d'un process Web, la commande est sans effet.

Note : La fonction Lire parametre base admet un sélecteur supplémentaire, Taille cache données (9). Ce paramètre ne peut pas être utilisé avec la commande FIXER PARAMETRE BASE. Pour plus d'informations, reportez-vous à la description de la fonction Lire parametre base.

Sélecteur = 10 (Appels système 4e Dimension)

Sélecteur = 11 (Appels système 4D Server)

Sélecteur = 12 (Appels système 4D Client)

Valeurs possibles : pour ces trois sélecteurs, le paramètre valeur est de la forme hexadécimale 0x00aabbcc dans laquelle :

aa = nombre minimum de ticks par appel au système (de 0 à 100 inclus)

bb = nombre maximum de ticks par appel au système (de 0 à 100 inclus)

cc = nombre de ticks entre deux appels au système (de 0 à 20 inclus).

Si une des valeurs est hors de son intervalle, 4D la fixe à son maximum.

Vous pouvez également passer dans valeur une des trois valeurs suivantes, correspondant à un ensemble de réglages standard :

valeur = -1 : priorité maximum allouée à 4D,

valeur = -2 : priorité moyenne allouée à 4D,

valeur = -3 : priorité minimum allouée à 4D.

Description : Ce sélecteur vous permet de fixer dynamiquement les réglages des appels système de 4D. En fonction du Sélecteur, le gestionnaire d'appels système sera défini pour :

- 4e Dimension (monoposte) lorsque la commande est appelée depuis 4e Dimension, ainsi qu'à 4D Tools (sélecteur=10).

- 4D Server lorsque la commande est appelée depuis 4D Server (sélecteur=11).

- 4D Client lorsque la commande est appelée depuis 4D Client (sélecteur=12).

Reportez-vous à l'exemple (1).

Note : Le fonctionnement du sélecteur 12 (Appels système 4D Client) diffère suivant que la commande FIXER PARAMETRE BASE est exécutée sur le poste serveur ou sur un poste client :

- si la commande est exécutée sur le poste serveur, la nouvelle valeur sera appliquée à tous les postes clients se connectant ultérieurement.

- si la commande est exécutée sur un poste client, la nouvelle valeur est appliquée immédiatement au poste client ainsi qu'à tous les postes clients se connectant par la suite au serveur.

Vous pouvez utiliser ce fonctionnement pour mettre en place une gestion dynamique et individualisée de la priorité pour chaque poste client. Le principe consiste à exécuter la commande une première fois sur le poste client à configurer puis une seconde fois sur le poste serveur avec la valeur par défaut, qui sera alors utilisée pour les postes client se connectant par la suite.

Ce fonctionnement est effectif dans 4e Dimension à partir des versions 6.8.6, 2003.3 et 2004.

Sélecteur = 13 (Timeout 4D Server)

Description : Ce paramètre permet de modifier la valeur du délai avant déconnexion (timeout) accordé par 4D Server aux postes clients.

Par défaut, la valeur du délai avant déconnexion utilisée par 4D Server est définie dans la page "Client-Serveur/Configuration" de la boîte de dialogue des Préférences, sur le poste serveur.

Le sélecteur Timeout 4D Server vous permet de fixer, à l'aide du paramètre valeur, un nouveau timeout, exprimé en minutes. Cette possibilité permet en particulier d'augmenter la valeur du timeout avant l'exécution sur le poste client d'une opération bloquante et de longue durée, risquant d'entraîner une déconnexion ; par exemple, l'impression d'un grand nombre de pages.

Vous disposez en outre de deux possibilités :

- effectuer une modification globale et permanente : la nouvelle valeur s'applique à tous les process et est stockée dans les préférences de l'application (équivaut à une modification de la valeur dans la boîte de dialogue des Préférences). Pour cela, passez une valeur positive dans le paramètre valeur.

- effectuer une modification restreinte et temporaire : la nouvelle valeur ne s'applique qu'au process appelant (les autres process conservant la valeur d'origine), et est abandonnée dès que le serveur reçoit un signe d'activité du poste client — par exemple, dès que l'opération est terminée. Cette possibilité est utile pour gérer les opérations longues initiées par des plug-ins. Pour cela, passez une valeur négative dans le paramètre valeur.

Pour définir une connexion "Ouverte en permanence", passez 0 dans valeur.

Reportez-vous à l'exemple (2).

Sélecteur = 14 (Timeout 4D Client)

Description : Ce paramètre permet de modifier la valeur du délai avant déconnexion (timeout) accordé par le poste 4D Client au poste 4D Server.

Par défaut, la valeur du délai avant déconnexion utilisée par 4D Client est définie dans la page "Client-Serveur/Configuration" de la boîte de dialogue des Préférences, sur le poste client.

Pour plus d'informations sur le fonctionnement de ce sélecteur, reportez-vous ci-dessus à la description du sélecteur Timeout 4D Server (13).

Le sélecteur Timeout 4D Client est à utiliser dans des cas très spécifiques.

Sélecteur = 15 (Numéro du port)

Description : Ce paramètre permet de modifier par programmation le numéro du port TCP utilisé par le serveur Web 4D avec 4e Dimension et 4D Server. Par défaut, la valeur est 80.

Le numéro de port TCP est défini dans la page "Web/Configuration" de la boîte de dialogue des Préférences. Vous pouvez utiliser les constantes du thème "Numéros de port TCP" pour le paramètre valeur.

Le sélecteur Numéro du port est utile dans le cadre de serveurs Web 4D compilés et fusionnés avec 4D Runtime (pas d'accès au mode Structure). Pour plus d'informations sur le numéro de port TCP, reportez-vous à la section Paramétrages du serveur Web.

Sélecteur = 16 (Adresse IP d'écoute)

Description : Ce paramètre permet d'indiquer par programmation l'adresse IP sur laquelle le serveur Web doit recevoir les requêtes HTTP avec 4e Dimension et 4D Server. Par défaut, aucune adresse particulière n'est spécifiée (valeur = 0). Ce paramètre est défini dans les Préférences de la base.

Le sélecteur Adresse IP d'écoute est utile dans le cadre de serveurs Web 4D compilés et fusionnés avec 4D Runtime (pas d'accès au mode Structure).

Passez dans le paramètre valeur l'adresse IP sous forme hexadécimale. Ainsi, pour désigner une adresse du type "a.b.c.d", le code sera de la forme :

   C_ENTIER LONG($addr)
   $addr:=($a<<24)|($b<<16)|($c<<8)|$d
   FIXER PARAMETRE BASE(Adresse IP d'écoute;$addr)

Reportez-vous également à l'exemple (3). Pour plus d'informations sur la désignation de l'adresse IP, reportez-vous à la section Paramétrages du Serveur Web.

Sélecteur = 17 (Jeu de caractères)

Valeurs :

0 : Occidental
1 : Japonais
2 : Chinois
3 : Coréen
4 : Défini par l'utilisateur
5 : Réservé
6 : Europe Centrale
7 : Cyrillique
8 : Arabe
9 : Grec
10 : Hébreu
11 : Turc
12 : Nordique

Description : Ce paramètre permet d'indiquer par programmation le jeu de caractères que le serveur Web 4D (avec 4e Dimension et 4D Server) doit utiliser pour communiquer avec les navigateurs Web qui se connectent à la base. La valeur par défaut dépend de la langue du système d'exploitation.

Ce paramètre est défini dans les Préférences de la base. Le sélecteur Jeu de caractères est utile dans le cadre de serveurs Web 4D compilés et fusionnés avec 4D Runtime (pas d'accès au mode Structure).

Sélecteur = 18 (Process Web simultanés maxi)

Valeurs : Vous pouvez passer toute valeur incluse entre 10 et 32 000. La valeur par défaut est 32 000.

Description : Ce paramètre permet de définir la limite strictement supérieure du nombre de process Web de tout type (contextuels, non contextuels ou appartenant à la réserve de process — cf. à ce sujet le sélecteur 7, Maximum process Web) acceptés par le serveur Web avec 4e Dimension et 4D Server. Lorsque ce nombre limite (moins un) est atteint, 4D ne crée plus de nouveau process et retourne le message "Serveur non disponible" (statut HTTP 503 - Service Unavailable) à toute nouvelle requête.

Ce paramètre permet de prévenir la saturation du serveur Web 4D pouvant se produire lors d'un envoi massif de requêtes ou d'une demande excessive de création de contextes. Il peut également être défini dans la boîte de dialogue des Préférences (cf. section Paramétrages du serveur Web).

En théorie, le nombre maximum de process Web est le résultat de la division Mémoire disponible / Taille de la pile d'un process Web. Une autre solution consiste à visualiser les informations sur les process Web affichées dans l'Exporateur d'exécution : le nombre courant de process Web et le nombre maximum atteint depuis le démarrage du serveur Web sont indiqués.

Note : Si vous passez une valeur inférieure à la limite supérieure de la "réserve" de process (sélecteur 7), cette limite est réduite à la valeur du sélecteur 18. Si nécessaire, la limite inférieure de la réserve (sélecteur 6) est également ajustée.

Sélecteur = 19 (Client Minimum process Web)

Sélecteur = 20 (Client Maximum process Web)

Sélecteur = 21 (Client Taille max requêtes Web)

Sélecteur = 22 (Client Numéro de port)

Sélecteur = 23 (Client Adresse IP d'écoute)

Sélecteur = 24 (Client Jeu de caractères)

Sélecteur = 25 (Client Process Web simultanés maxi)

Valeurs possibles : Identiques à celles des sélecteurs 4e Dimension ou 4D Server correspondants (cf. sélecteurs 6 à 8, 15 à 18 et 27).

Description : Ces sélecteurs permettent de spécifier les paramètres de fonctionnement des postes 4D Client utilisés en tant que serveurs Web.

Les valeurs définies via ces sélecteurs sont appliquées à tous les postes 4D Client utilisés comme serveurs Web. Si vous souhaitez définir des valeurs pour certains postes 4D Client uniquement, utilisez la boîte de dialogue des Préférences de 4D Client.

Sélecteur = 26 (Mode écriture cache)

Valeurs possibles : 0 ou 1 (0 = désactivation, 1 = activation).

Description : Activation ou non du mode optimisé d'écriture du cache. Par défaut, la valeur est 1 (mode activé).

Le mode optimisé d'écriture du cache, actif par défaut dans 4e Dimension à compter de la version 2003, accélère sensiblement les applications 4D, notamment sous Mac OS.

Sélecteur = 27 (Taille maximum requêtes Web)

Valeurs possibles : 500 000 à 2 147 483 648.

Description : Taille maximale (en octets) des requêtes HTTP entrantes (POST) que le serveur Web est autorisé à traiter. Par défaut, la valeur est 2 000 000, c'est-à-dire un peu moins de 2 Mo.

La valeur maximale (2 147 483 648) signifie en pratique qu'aucune limite n'est fixée.

Ce paramétrage permet d'empêcher la saturation du serveur Web à cause de requêtes entrantes de trop grande taille. Lorsqu'une requête atteint la limite, le serveur Web de 4D la refuse.

Sélecteur = 28 (Enreg requêtes 4D Server)

Valeurs possibles : 0 ou de 1 à N (0 = ne pas enregistrer, 1 à N = numéro séquentiel, accolé au nom du fichier).

Description : Démarrage ou arrêt de l'enregistrement des requêtes standard reçues par 4D Server (hors requêtes Web). Par défaut, la valeur est 0 (pas d'enregistrement de requêtes).

4D Server vous permet d'enregistrer dans un fichier d'historique chaque requête reçue par le poste serveur. Lorsque ce mécanisme est activé, le fichier d'historique est créé à côté du fichier de structure de la base. Son nom est "4DRequestsLogN", où N est le numéro séquentiel de l'historique. Une fois que le fichier atteint une taille de 10 Mo, il est refermé et un nouveau fichier est généré, avec un numéro séquentiel incrémenté. Si un fichier du même nom existe déjà, il est directement remplacé. Vous pouvez définir le numéro de départ de la séquence à l'aide du paramètre valeur.

Ce fichier texte stocke dans un format tabulé simple diverses informations concernant chaque requête : heure, numéro de process, utilisateur, taille de la requête, durée de traitement, etc. Ces informations sont particulièrement utiles en phase de mise au point de l'application ou à des fins statistiques. Elles peuvent être importées par exemple dans un logiciel tableur afin d'être traitées.

Note : Il est possible d'activer ou d'inactiver manuellement l'enregistrement des requêtes via le raccourci Ctrl+Alt+L sous Windows ou Commande+Option+L sous Mac OS.

Sélecteur = 29 (Enreg requêtes Web)

Valeurs possibles : 0 ou 1 (0 = ne pas enregistrer, 1 = enregistrer).

Description : Démarrage ou arrêt de l'enregistrement des requêtes Web reçues par le serveur Web de 4e Dimension ou de 4D Server. Par défaut, la valeur est 0 (pas d'enregistrement des requêtes).

L'historique des requêtes Web est stocké sous la forme d'un fichier texte nommé "logweb.txt" automatiquement placé à côté du fichier de structure de la base. Ce fichier est au format CLF (Common LogFile Format) ou format NCSA, reconnu par la plupart des outils d'analyse des sites Web. L'activation de ce fichier peut également être définie dans la page "Web/Avancé" des Préférences de 4e Dimension.

Sélecteur = 30 (Client Enreg requêtes Web)

Valeurs possibles : 0 ou 1 (0 = ne pas enregistrer, 1 = enregistrer).

Description : Démarrage ou arrêt de l'enregistrement des requêtes Web reçues par les serveurs Web de tous les postes clients. Par défaut, la valeur est 0 (pas d'enregistrement des requêtes).

Le fonctionnement de ce sélecteur est identique à celui du sélecteur 29 ; il s'applique toutefois à tous les postes 4D Client utilisés en tant que serveurs Web. Si vous souhaitez définir des valeurs pour certains postes clients uniquement, utilisez la boîte de dialogue des Préférences de 4D Client.

Sélecteur = 31 (Numéro automatique table)

Valeurs possibles : Toute valeur de type entier long.

Description : Ce sélecteur permet de modifier ou de lire le numéro unique courant des enregistrements de la table passée en paramètre. "Numéro courant" signifie "dernier numéro utilisé" : si vous modifiez cette valeur à l'aide de FIXER PARAMETRE BASE, le prochain enregistrement sera créé avec comme numéro la valeur passée + 1 (ce nouveau numéro est, lui, retourné par la commande Numerotation automatique).

Par défaut, le numéro unique est défini par 4e Dimension et correspond à l'ordre de création des enregistrements.

Pour des informations supplémentaires, reportez-vous à la documentation de la commande Numerotation automatique.

Sélecteur = 32 (Précision affichage réels)

Valeurs possibles : Toute valeur de type entier long positif.

Description : Ce sélecteur permet de modifier ou de lire le nombre de chiffres non significatifs tronqués à partir de la droite par l'algorithme d'affichage des réels à l'écran. Cette valeur est définie pour l'application et la session courantes.

Par défaut, la valeur de cette option est 4. La valeur 0 indique que la valeur par défaut est utilisée et que le paramètre n'a pas été modifié durant la session.

Pour des raisons historiques, 4e Dimension travaille avec des nombres réels stockés sur 10 octets et les convertit sur 8 octets lors de leur traitement (cf. section Affichage des nombres réels). Ce principe est entièrement transparent et n'affecte pas les calculs, toutefois certains résultats peuvent ne pas donner à l'affichage le résultat escompté. Par exemple, l'opération 4,1-4,09 affiche comme résultat 0,009999999999999780000, mais la recherche de 0,01 retrouve la bonne valeur.

Voici comment 4D procède pour afficher un réel : prenons par exemple la valeur 8,97499999999996158 obtenue par un calcul (la valeur 8,975 étant normalement le résultat attendu). L'algorithme permettant d'arrondir au plus juste enlève par défaut les 4 derniers chiffres (6158) puis vérifie si le dernier chiffre restant est un 0 ou un 9. Si c'est 0, l'algorithme remonte jusqu'au premier 0 et supprime tous les 0. Si la valeur est 9, l'algorithme remonte jusqu'au premier 9 et arrondit la partie décimale à la valeur supérieure. Dans notre exemple, la valeur 8,974999999999996158 se transforme donc en 8,975.

Il peut arriver que certains résultats finissent par 5 chiffres non significatifs, comme par exemple 8,9749999999999986158. Dans ce cas, l'algorithme ne pourra pas arrondir correctement la valeur car il trouvera 8 comme valeur et ne fera alors rien.

Vous pouvez souhaiter que l'algorithme de précision tronque plus ou moins de chiffres en fonction des spécificités de votre base. Dans ce cas, passez une valeur personnalisée. Hormis pour le zéro (choix de la valeur interne de 4D), cette valeur indiquera le nombre de chiffres tronqués par l'algorithme de précision.

Rappelons que ce paramétrage n'influe que sur l'affichage des numériques, non sur leur traitement interne.

Sélecteur = 33 (TCP_NODELAY)

Valeurs possibles : 0 ou 1 (0 = inactiver, 1 = activer)

Description : Activation ou inactivation de l'option réseau TCP_NODELAY. Cette option, interne au protocole TCP/IP, contrôle un mécanisme d'optimisation des communications réseau. Elle peut être fixée séparément pour le poste serveur et les postes clients. Par défaut, la valeur est 1 (option activée) sur tous les postes (serveur et clients).

Dans des cas spécifiques, en particulier dans le cadre de connexions client/serveur par ADSL ou par réseau privé virtuel (VPN), la désactivation de cette option peut améliorer sensiblement les performances de l'application. Cette opération doit être effectuée avec précaution et doit s'accompagner de tests de charge dans différentes configurations client/serveur.

Lorsque vous modifiez cette valeur, il est nécessaire de redémarrer l'application afin que la nouvelle valeur soit prise en compte.

Sélecteur = 34 (Enreg événements debogage)

Valeurs possibles : 0, 1 ou 2 (0 = ne pas enregistrer, 1 = enregistrer, 2 = enregistrer en mode détaillé)

Description : Démarrage ou arrêt de l'enregistrement séquentiel des événements de programmation de 4D, destiné au débogage de l'application. Par défaut, la valeur est 0 (pas d'enregistrement des événements).

Lorsque ce mode est activé, diverses informations sont enregistrées, notamment :

- pour chaque événement, le nombre de millisecondes depuis la création du fichier et le numéro de process ([n])

- l'exécution de chaque commande 4D (cmd) et chaque appel de plug-in (plugInName) ; le niveau de la pile est indiqué dans ce cas (n) ,

- chaque appel de méthode projet (meth), de méthode objet (obj) et de méthode formulaire (form).

- lorsque le mode détaillé est activé (valeur = 2), des informations supplémentaires relatives aux plug-ins sont enregistrées : événements dans les zones de plug-ins (EventCode) et appels de 4D par les plug-ins (externCall).

Les événements sont stockés dans un fichier nommé "4DDebugLog.txt" automatiquement placé à côté du fichier de structure de la base. Chaque événement est systématiquement inscrit dans le fichier avant son exécution, ce qui garantit sa présence dans le fichier même lorsque l'application quitte inopinément. A noter que le fichier est effacé et réécrit à chaque lancement de l'application.

L'option peut être activée dans tout type d'application 4D (4e Dimension monoposte, 4D Server, 4D Client, 4D Runtime), en interprété ou en compilé.

Note : Cette option est proposée uniquement à des fins de débogage, elle ne doit pas être utilisée en production car elle peut entraîner une dégradation des performances de l'application ainsi que la saturation du disque dur.

Sélecteur = 35 (Numéro du port client serveur)

Valeurs possibles : 0 à 65535

Description : Ce paramètre permet de modifier par programmation le numéro de port TCP sur lequel 4D Server publie la base de données (à destination des postes 4D Client). Par défaut, la valeur est 19813.

La personnalisation de cette valeur permet d'utiliser plusieurs applications 4D client-serveur sur la même machine avec le protocole TCP ; dans ce cas, vous devez spécifier un numéro de port différent pour chaque application.

La valeur est stockée dans le fichier de structure de la base. Elle peut être définie avec 4e Dimension monoposte mais n'est prise en compte qu'en configuration client-serveur.

Lorsque vous modifiez cette valeur, il est nécessaire de redémarrer le poste serveur afin que la nouvelle valeur soit prise en compte.

Sélecteur = 36 (Signature WEDD)

Valeurs possibles : Chaîne de 1 à 255 caractères.

Description : Ce paramètre permet de modifier la signature WEDD de la base de données ouverte (fichier de structure et fichier de données). Par défaut, cette signature est vide (le paramètre n'est pas défini). A noter que la signature tient compte de la casse des caractères.

La signature WEDD permet d'associer un fichier de structure à un fichier de données. Un fichier de structure contenant une signature WEDD ne pourra être ouvert qu'avec un fichier de données contenant la même signature WEDD et inversement. Pour plus d'informations sur la signature WEDD, reportez-vous au manuel Mode Structure.

La définition de cette valeur par programmation facilite la diffusion de mises à jour d'applications comportant une signature personnalisée.

Note : Lorsque vous utilisez ce sélecteur avec la commande Lire parametre base, la chaîne définie comme signature WEDD est retournée dans le paramètre facultatif valeurAlpha et la commande retourne 0.

Sélecteur = 37 (Inversion des objets)

Valeurs possibles : 0, 1 ou 2 (0 = mode désactivé, 1 = mode automatique, 2 = mode activé).

Description : Configuration du mode "inversion des objets". Ce mode permet d'inverser en mode Menus créés les formulaires, objets, menus, etc. lorsque la base est affichée sous Windows dans une langue de droite à gauche. Ce mode peut également être configuré dans la page Base de données/Script Manager des Préférences de l'application.

- La valeur 0 indique que le mode n'est jamais activé, quelle que soit la configuration du système (correspond à la valeur Non dans les Préférences).

- La valeur 1 indique que le mode est activé ou non en fonction de la configuration du système (correspond à la valeur Automatique dans les Préférences).

- La valeur 2 indique que le mode est activé, quelle que soit la configuration du système (correspond à la valeur Oui dans les Préférences).

Pour plus d'informations, reportez-vous au manuel Mode Structure de 4D.

Sélecteur = 39 (Numéro de port HTTPS)

Valeurs possibles : 0 à 65535

Description : Ce sélecteur permet de modifier par programmation le numéro du port TCP utilisé par le serveur Web de 4e Dimension et de 4D Server pour les connexions sécurisées via SSL (protocole HTTPS). Le numéro de port HTTPS est défini dans la page "Web/Configuration" de la boîte de dialogue des Préférences. Pour plus d'informations, reportez-vous à la section Paramétrages du serveur Web.

Par défaut, la valeur est 443 (valeur standard). Vous pouvez utiliser les constantes du thème "Numéros de port TCP" pour le paramètre valeur.

Sélecteur = 40 (Client Numéro de port HTTPS)

Valeurs possibles : 0 à 65535

Description : Ce paramètre permet de modifier par programmation le numéro du port TCP utilisé par les serveurs Web des postes clients pour les connexions sécurisées via SSL (protocole HTTPS). Par défaut, la valeur est 443 (valeur standard).

Le fonctionnement de ce sélecteur est identique à celui du sélecteur 39 ; il s'applique toutefois à tous les postes 4D Client utilisés en tant que serveurs Web. Si vous souhaitez modifier la valeur de certains postes clients uniquement, utilisez la boîte de dialogue des Préférences de 4D Client.

Exemples

(1) Cette méthode permet de définir les valeurs du minuteur des appels système si l'application courante est 4e Dimension monoposte :

   C_ENTIER LONG($ticksbtwcalls;$maxticks;$minticks;$lparams)
   Si (Type application=4e Dimension) ` Si nous sommes en 4D monoposte
      $ticksbtwcalls:=12
      $maxticks:=20
      $minticks:=7
      $lparams:=($minticks<<16) | ($maxticks<<8) | $ticksbtwcalls
      FIXER PARAMETRE BASE(Appels système 4e Dimension;$lparams)
   Fin de si

(2) L'instruction suivante permet d'anticiper un éventuel problème de timeout :

      `Augmentation du timeout à 3 heures pour le process courant
   FIXER PARAMETRE BASE(Timeout 4D Server;-60*3)
      `Exécution d'une opération longue hors du contrôle de 4D
   ...
   WR MAILING (LaZone;3;0)
   ...

(3) L'adresse IP 192.193.194.195 sera fixée avec l'instruction suivante :

   FIXER PARAMETRE BASE(Adresse IP d'écoute;0xC0C1C2C3)

Référence

CHERCHER DANS SELECTION, Lire parametre base, VALEURS DISTINCTES.


4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant